AT32 Makefile

An extension to compile, debug, and flash AT32 projects. This extension is built to work in conjunction with AT32 Work Bench, and will build the project using the ARM GCC toolchain. It will automatically start up when it finds an AT32 Work Bench file (*.ATWP) or an AT32 for VSCode configuration file.

This extension also supports using cpp files; however, main.c has to be manually renamed to main.cpp for it to work.

NOTE: Your AT32 Work Bench project needs to be generated as a makefile project under "Toolchain/IDE -> Makefile".

Prerequisites

There are a few command line tools that need to be installed for this extension to work. Install them manually and set the paths in the extension settings:

• GNU Arm Embedded Toolchain (prefix arm-none-eabi-)
• Make (platform dependent, Windows, OSX: install command line developer tools)
• OpenOCD for AT32 (e.g. the Artery official build) and the Cortex-Debug extension

How to Use

Click on the AT32 icon in the activity bar and select the command you want to run. Once this is done for the first time, you can also use the shortcut Cmd/Ctrl+Shift+B to start building.

Features

• Creating a makefile and building an AT32 project.
• Adding configurations for debugging, flashing and building in the workspace.
• Ability to compile as a C++ project by adding a main.cpp file.
• Automatic configuration of IntelliSense.
• Configuration file per project.
• Searches for .c/.cpp and .h/.hpp files in your project.
• Add static libraries for compilation.
• Configuration automatically generated and stored in AT32-for-VSCode.config.yaml file.

Build Process

The build process uses the information of the AT32 Work Bench makefile and the AT32-for-VSCode.config.yaml file to search for dependencies and set flags. The makefile is optional; however, the AT32-for-VSCode.config.yaml will always be present when building. After it has gathered all the files and information it will check if the AT32 for VSCode specific makefile needs to be updated, if so it will update the makefile and run the make/build process.

Configuration

The recommended way of configuring the build (i.e., adding flags, adding files/directories) is by means of the AT32-for-VSCode.config.yaml file. The yaml file contains comments and explanations of each part of the file and should be self explanatory.

Credits & Disclaimer

AT32 Makefile is a derivative of stm32-for-vscode, which is Copyright (c) Bureau Moeilijke Dingen and licensed under the MIT License. The MIT license text and the original copyright notice are preserved in the LICENSE file. AT32 Makefile is an independent, community-maintained extension for use with AT32 projects generated by AT32 Work Bench; it is not an official product of Artery or of the stm32-for-vscode authors.