Page 1
AT32 Work Bench User Manual Introduction This user manual gives an overview of AT32 Work Bench. The AT32 Work Bench can generate initialization C code and corresponding IDE project through MCU graphical configuration, so as to reduce the development workload, time and cost.
Contents Introduction ......................5 Environmental requirements ..................5 Installation ......................6 Set up AT32 Work Bench on Windows ..............6 Set up AT32 Work Bench on Linux ................6 Getting started ....................... 7 Project configuration ..................... 8 Menu bar and toolbar ....................8 4.1.1...
Page 3
AT32 Work Bench User Manual List of tables Table 1. Peripheral status ........................9 Table 2. Status of mode and parameters................... 11 Table 3. Status of pins ........................14 Table 4. Document revision history ....................26 2024.03.05 Ver 1.04...
Page 4
AT32 Work Bench User Manual List of figures Figure 1. dpkg command in Linux ....................... 6 Figure 2. Graphical installation ......................6 Figure 3. Getting started page ......................7 Figure 4. Project configuration ......................8 Figure 5. Menu bar and toolbar ......................8 Figure 6.
AT32 Work Bench User Manual Introduction Environmental requirements Software Windows Windows 7 and above is required. Linux Ubuntu or Fedora that supports AMD x86_64. Hardware At least 2GB RAM. At least 4GB hard drive space. 2024.03.05 Ver 1.04...
Figure 2. Graphical installation After the installation is complete, click the "All Programs" button at the bottom of the left taskbar, find and click on the "AT32 Work Bench" in the program list to start AT32 Work Bench. 2024.03.05 Ver 1.04...
AT32 Work Bench User Manual Getting started The getting started page is the first window that opens when AT32 Work Bench is started. It includes three options, i.e., “Start a New Design”, “Open an Existing Design” and “Recent Designs”. ...
AT32 Work Bench User Manual Project configuration After a new project is created or a saved file is loaded, the project configuration page opens. It contains a menu bar, a toolbar, and the following set of views: Pin out configuration ...
Open manual Open the user manual. New version download Download the new version online. Go to Artery home page Open browser to visit the official website of Artery. Version View the current version. Toolbar 4.1.2 : Select English as the display language.
Configuration” window opens. Users can select peripheral mode and the corresponding MCU pins in the “Mode”. For AT32 MCUs, same pins can be used for different peripherals and multiple features; therefore, once the mode is selected, the optimum pin layout will be configured automatically.
AT32 Work Bench User Manual Figure 8. Mode error prompt Examples of status of mode and parameters: Table 2. Status of mode and parameters Status Icon Description Configurable Condition not satisfied Configure other parameters as prompted. Configure the Select “Inverting input selection corresponding mode (Input[-])”.
AT32 Work Bench User Manual Figure 10. GPIO settings This window displays configurable GPIOs, for example, GPIOs for “USART1_TX” and “USART1_RX” in Figure 10. For details about GPIO settings, refer to Section 4.2.4. DMA settings Figure 11. DMA settings This window allows users to add configurable DMA requests for the current peripheral, for example, the corresponding DMA channels and DMA requests for “USART1_TX”...
AT32 Work Bench User Manual This window displays configurable interrupts for the current peripheral. When the corresponding DMA channel is enabled, the corresponding DMA channel interrupt can be configured, for example, the “USART1_IRQ” and “DAMA1_Channel3_2_IRQ” in Figure 12. The “preemption priority” and “sub priority” are configured in the “NVIC Mode and configuration”...
AT32 Work Bench User Manual Table 3. Status of pins Status Icon Description Pin not in use Users can configure signals for this pin. Pin in use A valid signal is configured, and it has a corresponding peripheral mode. Pin no mode A signal is configured, but it has no corresponding peripheral mode.
AT32 Work Bench User Manual Figure 15. Custom label GPIO mode and configuration 4.2.4 Click on “GPIO” under “Peripherals” to open the GPIO Mode and Configuration window. Users can also configure GPIO for specific peripherals in a dedicated window for GPIO configuration.
AT32 Work Bench User Manual DMA mode and configuration 4.2.5 Click on “DMA” under “Peripherals” to open the DMA Mode and Configuration window to configure available general-purpose DMA controller. DMA interface supports data transfer between memory and peripherals and memory-to-memory data transfer when CPU is running.
AT32 Work Bench User Manual Memory data alignment Configure memory data bit width (byte: 8-bit, half-word: 16-bit, word: 32-bit). NVIC mode and configuration 4.2.6 Click on “NVIC” under “Peripherals” to open the NVIC Mode and Configuration window. Click on the “Show” drop-down box to select to display all interrupts, available interrupts and enabled interrupts.
Page 18
AT32 Work Bench User Manual only one priority0, 4: 16 priorities (0-15). 2. Click on an interrupt in the “NVIC Interrupt Table” to configure: Enabled: tick/untick to enable/disable this interrupt. Preemption priority: Select a preemption priority. It defines the ability of one interrupt to interrupt another.
AT32 Work Bench User Manual Clock configuration Users can configure the clock path and parameters in the Clock Configuration window, and use drop-down menus and input boxes to modify the actual clock tree configuration to meet application requirements. As shown in Figure 19, the Clock Configuration window mainly includes four blocks.
AT32 Work Bench User Manual Code view Click on the “Code View” to generate code automatically. Code files are listed in the left, and the corresponding code is shown in the right window. main.c: main source file, which is used to call peripheral initialization functions.
AT32 Work Bench User Manual Generate code Click on the “Generate code” in the menu bar or the icon in the toolbar, and then the “Project Manager” window pops up. Project manager 4.5.1 Figure 21. Project manager Users can configure required parameters as follows: ...
AT32 Work Bench User Manual Finally, click on “OK” to generate user code and project of the selected IDE automatically. The generated project file structure is shown in Figure 22. Figure 22. Project file directory The file directory contains the “libraries” and “middleware” folders copied from the firmware package, as well as the generated project folder “Project”.
Keep user code when re-generating 4.5.2 The AT32 Work Bench generated C code allows users to add custom code. The custom code needs to be inserted into the software-defined location and can be reserved for the next generation of C code. The software-defined location is as follows: /* add user code begin …...
AT32 Work Bench User Manual Package manager Click on “File” – “Package Manager”, and the Package Manager window pops up, as shown below. Figure 24. Package Manager window Package installation location Select and confirm the package installation path. The software scans for the installed package at this location each time it starts up.
Page 25
AT32 Work Bench User Manual Remove Tick the installed package and then remove it. 2024.03.05 Ver 1.04...
AT32 Work Bench User Manual Revision history Table 4. Document revision history Date Version Revision note 2024/03/05 V1.04 Updated some descriptions. 2024/01/26 V1.03 Added Section 4.6 “Package manager”. 2023/11/28 V1.02 Updated some figures. 2023/09/08 V1.01 Updated some descriptions. 2023/05/09 V1.00 Initial release.
Page 27
No license, express or implied, to any intellectual property right is granted by ARTERY herein regardless of the existence of any previous representation in any forms. If any part of this document involves third party’s products or services, it does NOT imply that ARTERY authorizes the use of the third party’s products or services, or permits any of the intellectual property, or guarantees any uses of the third...
Need help?
Do you have a question about the AT32 and is the answer not in the manual?
Questions and answers