Artery ICP Programmer User Manual
Artery ICP Programmer User Manual
UM0002
Introduction
This user manual gives an overview of Artery ICP Programmer. ICP Programmer acts as a graphic
interface application designed to facilitate the use of Artery MCU. AT-Link or J-Link simulator is required
to operate Artery MCU device.
Contents
1 Introduction ............................................................................................................ 7
2 Installation .............................................................................................................. 8
List of tables
Table 1. Document revision history.................................................................................................... 44
List of figures
Figure 1. Main window ......................................................................................................................... 9
Figure 2. Menu bar............................................................................................................................. 10
Figure 3. J-Link settings..................................................................................................................... 11
Figure 4. AT-Link settings .................................................................................................................. 12
Figure 5. Offline config settings ......................................................................................................... 14
Figure 6. Project file settings ............................................................................................................. 17
Figure 7. Offline download window .................................................................................................... 18
Figure 8. AT-Link firmware upgrade ................................................................................................... 19
Figure 9. AT-Link firmware manual upgrade ...................................................................................... 19
Figure 10. MCU resource download .................................................................................................. 20
Figure 11. MCU download link ........................................................................................................... 20
Figure 12. Make encryption file ......................................................................................................... 21
Figure 13. Select simulator ................................................................................................................ 21
Figure 14. Before connecting............................................................................................................. 21
Figure 15. Successful connecting ...................................................................................................... 22
Figure 16. Before connecting............................................................................................................. 22
Figure 17. Successful connecting ...................................................................................................... 22
Figure 18. SPIM settings ................................................................................................................... 22
Figure 19. SPIM select ...................................................................................................................... 23
Figure 20. SPIM name ....................................................................................................................... 23
Figure 21. SPIM auto detect failed .................................................................................................... 24
Figure 22. Memory read settings ....................................................................................................... 24
Figure 23. 8-bit data ........................................................................................................................... 24
Figure 24. 16-bit data ......................................................................................................................... 25
Figure 25. 32-bit data ......................................................................................................................... 25
Figure 26. File info ............................................................................................................................. 25
Figure 27. File info data ..................................................................................................................... 26
Figure 28. Right click menu ............................................................................................................... 26
Figure 29. Sector erase ..................................................................................................................... 27
Figure 30. Block erase ....................................................................................................................... 27
Figure 31. BLE module sector erase ................................................................................................. 28
Figure 32. BLE module debug ........................................................................................................... 29
Figure 33. BLE Register Contorl ........................................................................................................ 30
Figure 34. BLE Flash Contorl ............................................................................................................ 30
2022.08.11 5 Rev 2.04
ICP Programmer Manual
Figure 35. User system data config ................................................................................................... 31
Figure 36. Erase and program protection bytes ................................................................................ 33
Figure 37. User data .......................................................................................................................... 35
Figure 38. SPIM encryption key config .............................................................................................. 35
Figure 39. QSPI encryption key config .............................................................................................. 35
Figure 40. Online download config .................................................................................................... 36
Figure 41. Bluetooth module download options ................................................................................ 38
Figure 42. Write software serial number............................................................................................ 39
Figure 43. User system data file selection ........................................................................................ 39
Figure 44. CRC function config ......................................................................................................... 40
Figure 45. Flash CRC ........................................................................................................................ 40
Figure 46. SPIM encryption range config .......................................................................................... 42
Figure 47. SPIM encryption key config .............................................................................................. 42
1 Introduction
1.1 Environmental requirements
Software requirements
Windows 7 and above is required.
Software version below 3.0.02, .Net framework 4.0 is required.
Software version 3.0.02 and above, .Net framework 4.6 is required.
There is no need to install a driver when using the AT-Link simulator.
A driver is required when using the J-Link simulator. J-Link V6.20C and above is used. The version
below J-Link V6.20C will not work with this software.
Hardware requirements
AT-Link simulator
J-Link simulator
PC/AT compatible, Pentium or higher CPU
XVGA (1024 * 768) color display.
At least 512M RAM
At least 20 M disk space
1.2 Glossary
ICP:
ICP (in-circuit programming). It allows users to update the Flash of MCU through software without
the need of removing the MCU from the target PCB.
AT-Link simulator:
AT-Link is a simulator developed by Artery to support the simulation of the kernel chip.
J-Link simulator:
J-Link is a simulator developed by SEGGER to support the simulation of the kernel chip.
2 Installation
Software installation
No need to install software, just run the executable program "[Link]" directly.
Hardware installation
Step 1: connect the AT-Link/ J-Link simulator to the USB interface of PC.
Step 2: connect the AT-Link/ J-Link simulator to the ICE interface of the target development board.
3 Function overview
This section gives an overview of tool operations. The main interface is shown in Figure 1:
“File” menu
― Save file as: save the data in the "File Info" as a file in the format of *.bin/ *.hex/*.srec/*.s19.
― Save flash data as: save the memory data in the "Flash Info" as a file in the format of
*.bin/*.hex/*.srec /*.s19.
― Make encryption file: encrypt the bin file as a benc file, hex file as a henc file, srec and s19 file
as a senc file.(encrypted files are suited to AT-Link)
― Exit: exit the software.
Target” menu:
― Mass erase: erase the whole main flash. When SPIM is selected, the whole SPIM will also be
erased (AT32F403/F413/F403A/F407). When the boot memory is in AP mode, the boot
memory is also erased (AT32F415/F421/F425/WB415/L021).
― Erase main flash: erase the whole main flash.
― Erase SPIM: erase the whole SPIM.
― Erase boot memory: erase the boot memory (AT32F415/F421/F425/WB415/L021 AP mode)
― Erase sector: users select the sector to erase.
― User system data: User system data settings, including access protection and erase and
program protection, etc.
― Access protection:
For AT32F403/F413/F403A/F407/F435/F437, enable / disable access protection.
For AT32F415/F421/F425/WB415/L021, enable access protection, high level access protection
(access protection and user system data erase protection) and disable access protection.
(AT32F425/L021 high level access protection is irreversible. Once enabled, it will never be
unlocked, with its debugging interface permanently disabled. Please use with caution.)
― sLib status: the user can check the current status (enabled or disabled) of sLib, and disable
sLib (AT32F413/F415/F403A/F407/F421/F435/F437/F425/WB415/L021).
― Boot memory AP mode: the boot memory is set in AP mode. The boot memory cannot be
restored after being set as AP mode. (AT32F415/F421/F425/WB415/L021)
― Download: set download options and download files to flash.
― Flash CRC: calculate the CRC value for the selected sectors in flash.
“Language” menu:
― English
― Chinese (Simplified)
“Help” menu:
― User manual: open the user manual of this software.
― AT-Link firmware manual upgrade: the user needs to manually select the file to upgrade AT-
Link firmware.
― AT-Link firmware online upgrade: automatic online upgrade AT-Link firmware. The computer
must be connected to the Internet.
― ICP new version download: automatically detect whether there is a new version of ICP
software, if so, download it. The computer must be connected to the Internet.
― Artery MCU resources download: provide links to download Artery MCU resources. The
computer must be connected to the Internet.
― Version: check the software version.
― J-Link path: if J-Link driver is installed, the software will automatically obtain the installation
path. The user can also select it manually.
― Reset type: software reset or hardware reset. It is effective when using J-Link to operate the
device.
― OK: make the setting take effect and close the dialog box.
Number of area
This represents the number of codes stored offline, supporting 1/2/4/8/16, and the maximum
capacity corresponding to each code is 16/8/4/2/1 MB, respectively. Offline download also supports
downloading multi-section code files (up to 5) at a time. Multi-section code files will occupy multiple
storage areas.
Note: modifying this option will clear all offline stored project data.
SWD speed
Configure the SWD transmission speed for non-IDE operation, and
100kHz/500kHz/1MHz/2MHz/5MHz are available for selection.
Auto detect
SWD speed will be automatically detected.
Reset mode
It contains software system reset and hardware NRST pin reset, which are mainly used for reset
after the target board download is completed or some operations that need to be reset, such as
FAP, EPP operations.
Buzzer
Buzzer enable option. When this function is disabled, all other operations are silent except for
power-on initialization.
Encryption key
Support the combination configuration of 6-24 bytes of letters or numbers, which is customized by
AT-Link users. The initial default value is a 24-byte AT-Link serial number.
Note: modifying this option will clear all existing offline project data.
Offline project
It displays the currently stored offline projects.
Select from the drop-down menu to view the configuration parameters of project.
Delete/Create
Delete the selected project in the drop-down menu or create a new one.
Project name
Customize the project name when creating a new project, supporting up to 16 bytes length.
Device
When creating a new project, it allows the user to only download the target MCU of a specific
model of certain series. However, if AT32F413-Universal is selected, it means that all the MCUs of
AT32F413 series are allowed to download.
Add/Delete
When creating a new project, add and delete the code file to be downloaded. The format can be
bin/hex/srec/s19/benc/henc/senc. Multi -section code file configuration is supported. The address of
multi-section code files cannot be on the same Flash sector. The maximum length of file name is 32
bytes.
Erase option
Configure as required. Support various erase operations before download.
Download interface
Select SWD or ISP interface when downloading the project offline.
Download times
If this option checked, the total number of downloads will be limited in the range of 1-4000000.
Both success and failure are included in the total [Link] the total number is exceeded, no more
downloads are allowed.
Encryption transmit
The download process works with the Hex Encryption function of Artery MCU to implement
encryption transmit to ensure the security of data during the transmission.
Verify
Verify whether the data is correct after download, and a hardware verify method will be used during
encryption transmit to ensure data security.
Open project:
Open an existing project file in * .atcp format and load its configuration into the software for viewing.
Download interface
Only displays the interface of the activated project, and this cannot be changed. If it is an ISP
interface, the baud rate and boot mode can be changed according to the target board circuit.
Total downloads
Set the total number of downloads.
Successful downloads
Displays the number of successful downloads of the activated project.
Start download
Start a single offline download, and the corresponding message will pop up according to the
download progress. If failed, error message will be displayed.
Encryption key
It is the encryption key for making encryption files, 6 to 24 bit letters or numbers.
Original file
It means the original file that needs to be encrypted. Support in the format of*.bin, *.hex, *.srec and
*.s19.
Encryption file
It means the encrypted file in the format of * .benc/* .henc/* .senc.
Successful connection------- the device is correctly identified at this time. (As shown in Figure
15)
After successful connection, AT-Link related information will be displayed, including AT-Link part
number, firmware version, AT-Link AIN; and MCU related information, including MCU part number,
Flash size, [Link] click on "Disconnect", you can disconnect from the device
Successful connection ------- the device is correctly identified at this time, (As show in Figure
17)
After successful connection, MCU related information will be displayed, including MCU part
number, Flash size, etc. If click on "Disconnect", you can disconnect from the device.
Checked “SPIM”
SPIM operation is allowed.
Uncheck “SPIM”
SPIM operation is not allowed.
FLASH_DA
Set the encryption range when downloading files to the SPIM, and the encryption range is
Type
Users can select the SPIM type through "Select" button.
Click on the "Select" button, a dialog box pops up. (As shown in Figure 19)
Auto detect: it will automatically detect whether the SPIM meets the requirements of this software
Operation (Auto detect will overwrite some data of SPIM, please use it with caution)
If Auto detect is successful, a dialog box will pop up. (As shown in Figure 20)
If auto detect failed, a failure dialog box will pop up. (As shown in Figure 21)
― SPIM size: select the SPIM size, except for the default type.
― Delete: delete the selected SPIM in the list, except for the default type.
― OK: SPIM selected.
― Cancel: cancel.
3.9 Memory read settings
This function is used to read the content of flash memory. (As shown in Figure 22)
Data bits:
8-bit: read and display flash data in 8-bit mode. At the same time, the files are displayed in 8-bit
mode.
16-bit: read and display flash data in 16-bit mode. At the same time, the files are displayed in 16-bit
mode.
32-bit: read and display flash data in 32-bit mode. At the same time, the files are displayed in 32-bit
mode.
Once selected, the “Read” operation will be performed automatically.
Add
Add files to the download list and display the file data in the “file info “list. It can support up to 5
[Link] the file is successfully opened, the file content is automatically displayed in the "File
Info”. (As shown in Figure 27)
Delete
Delete the selected files in the file list.
― Display: displays the content of the selected file in the "File Info" list.
― Read memory of file size: read the data of the selected file from the memory.
― Verify memory of file size: read and select the data from the files for verification.
― Flash CRC Verify: CRC check between the selected file and the corresponding memory data.
(AT32F403 does not support)
Erase SPIM
Erase the whole SPIM.
Erase blocks
User selects blocks to erase. "Target" - "Erase blocks". (As shown in Figure 30)
Erase sectors
Users can select the sectors to be erased by going to “BLE module” – “Erase sectors”, as shown
below:
Work Space
Select a work space from Main code space, NVR space and RDN space.
Work Mode
Select one of Normal and Mbist modes
Control
Enable or disable Ex_Vread0, Ex_Vread1, Ex_Prepgm and Retry_En
Flash Status
It indicates the status of Flash CRC check. This can be used to check whether the downloaded file
is correct or not.
Ram Status
It indicates the status of Ram check.
Flash Control
This option is used to control the Main code space, NVR space and RDN space in the Flash
memory of BLE module.
Chip Erase: Erase the Main code space, NVR space and RDN space of BLE module.
Sector Erase: Erase the sector where the “Addr(Hex)” is.
Block Erase: Erase the block where the “Value(Hex)” is.
AT32F415/F421/F425/WB415/L021:
Access protection: FAP----0xFF.
High level access protection: FAP----0xCC. (Access protection and user system data erase
protection) (AT32F425/L021 high level access protection is irreversible. Once enabled, it will never be
unlocked, with its debugging interface permanently disabled. Please use with caution. )
Disabled: FAP----0xA5.
When access protection is enabled, neither flash nor the user system data will be readable. The
operation can only be performed after the access protection is disabled.
When access protection is disabled, both the main flash and the user system data will be erased.
nDEPSLP_RST:
Unchecked—Reset occurs when entering Deep Sleep mode.
Checked—No reset occurs when entering Deep Sleep mode.
nSTDBY_RST:
Unchecked—Reset occurs when entering Standby mode.
Checked—No reset occurs when entering Standby mode.
BTOPT: (AT32F403/F413/F403A/F407/F435/F437)
Unchecked—when the device is set to boot from flash memory bank 1 or bank 2, if bank 2 has no
startup program, boots from bank 1, otherwise, bank 2.
Checked—when the device is set to boot from flash memory (default value), it starts from bank 1.
nBOOT1: (AT32F421/F425/L021)
Boot mode is determined together with BOOT0, and when BOOT0 = 1,
Unchecked----SRAM is selected as boot space.
Checked---Boot memory is selected as boot space.
nWDT_DEPSLP:
Unchecked----WDT stop count when entering Deep Sleep mode.
Checked---WDT does not stop count when entering Deep Sleep mode.
nWDT_STDBY:
Unchecked---- WDT stop count when entering Standby mode.
Checked--- WDT does not stop count when entering Standby mode.
nRAM_PRT_CHK: ( AT32L021)
Unchecked---- Enable odd check of RAM.
Checked--- Disable odd check of RAM.
EOPB0(SRAM)
AT32F403/F403A/F407: (AT32F403CBT6 not support)
224 KB SRAM—SRAM 224 KB.
96 KB SRAM—SRAM 96 KB.
AT32F435/F437:
Flash size 256K and below:
512 KB SRAM—SRAM 512 KB.
448 KB SRAM—SRAM 448 KB.
384 KB SRAM—SRAM 384 KB.
Flash size 1024K and above:
512 KB SRAM—SRAM 512 KB.
448 KB SRAM—SRAM 448 KB.
384 KB SRAM—SRAM 384 KB.
320 KB SRAM—SRAM 320 KB.
256 KB SRAM—SRAM 256 KB.
192 KB SRAM—SRAM 192 KB.
128 KB SRAM—SRAM 128 KB.
EPP0:
AT32F403/F413/F403A/F407: controls the erase and program protection of sectors in the range of
Flash 1K-32K.
AT32F415/WB415: controls the erase and program protection of Sector0-Sector15.
AT32F421: controls the erase and program protection of Sector0-Sector31.
AT32F435/F437: controls the erase and program protection of sectors in the range of Flash 1K-
32K. Each bit protects 4K bytes sectors.
AT32F425: controls the erase and program protection of Sector0-Sector31.
AT32L021: controls the erase and program protection of Sector0-Sector31.
EPP1:
AT32F403/F413/F403A/F407: controls the erase and program protection of sectors in the range of
Flash 33K-64K.
2022.08.11 33 Rev 2.04
ICP Programmer Manual
AT32F415/WB415: controls the erase and program protection of Sector16-Sector31.
AT32F421: controls the erase and program protection of Sector32-Sector63.
AT32F435/F437: controls the erase and program protection of sectors in the range of Flash 33K-
64K. Each bit protects 4K bytes sectors.
AT32F425: controls the erase and program protection of Sector32-Sector63.
AT32L021: controls the erase and program protection of Sector32-Sector63.
EPP2:
AT32F403/F413/F403A/F407: controls the erase and program protection of sectors in the range of
Flash 65K-96K.
AT32F415/WB415: controls the erase and program protection of Sector32-Sector47.
AT32F435/F437: controls the erase and program protection of sectors in the range of Flash 65K-
96K. Each bit protects 4K bytes sectors.
EPP3:
AT32F403/F413/F403A/F407:
Bit 0-6 controls the erase and program protection of sectors in the range of 97K-124K;
Bit 7 controls the erase and program protection of all Sectors after Flash 124K, including SPIM.
AT32F415/WB415:
Bits 0-6 control the erase and program protection of Sector48-Sector61;
Bit 7 controls the erase and program protection of all subsequent sectors, including boot memory
(boot memory in AP mode).
AT32F421: Bit 7 controls the boot memory area (boot memory in AP mode)
AT32F435/F437: controls the erase and program protection of sectors in the range of Flash 97K-
128K. Each bit protects 4K bytes sectors.
AT32F425: Bit 7 controls the boot memory area (boot memory in AP mode)
AT32L021: Bit 7 controls the boot memory area (boot memory in AP mode)
EPP4:
AT32F435/F437: controls the erase and program protection of sectors in the range of Flash 129K-
1152K. Each bit protects 128K bytes sectors.
EPP5:
AT32F435/F437: controls the erase and program protection of sectors in the range of Flash 1153K-
2176K. Each bit protects 128K bytes sectors.
EPP6:
AT32F435/F437: controls the erase and program protection of sectors in the range of Flash 2177K-
3200K. Each bit protects 128K bytes sectors.
EPP7:
AT32F435/F437: Bit 0-6 controls the erase and program protection of sectors in the range of Flash
3201K-4032K. Each bit protects 128K bytes sectors.
User data
Clear: Reset all user data to 0xFF, which is not saved to the device
Load file:Load the user data file into the table for display
Save to file:Save the user data in the table to the file.
Apply to device
Save the settings of the user system data to the device.
Save to file
Save the user system data settings to file.
1) sLib Setting
(AT32F403 not support sLib function)
sLib status
Displays the current sLib status, disable or enable.
Enable password
It refers to the password when the sLib is enabled.
Disable password
It is the password when the sLib is disabled.
Start sector
AT32F413/F415/F403A/F407/WB415:
The start position of sLib area. The instruction area is the area from "Start sector" to "DATA start
sector" (excluding DATA start sector). Once sLib is enabled, the data in this area cannot be
erased, written or read.
AT32F421/F435/F437/F425/L021:
The start position of sLib area. The area from “Start sector” to “INSTR start sector” (not including
“INSTR start sector”) is a mixed instruction and data (read only area). Once sLib is enabled, the
data in this area cannot be erased, written, but can be read.
AT32F421/F435/F437/F425/L021:
The start sector of sLib instruction area. The instruction area is from "INSTR start sector" to "End
sector" (including "End sector"). After sLib is enabled, the data in this area cannot be erased,
written or read. When it is set to "none", it is no instruction area.
End sector
The end position of the sLib area.
Disable sLib
Disable sLib. Users need to enter the password that last enabled. When sLib is successfully
disabled, the whole chip will be erased.
2) Extra options
(For "Mass erase for Main Flash", " Mass erase for SPIM", " Mass erase for Main Flash and SPIM",
and “Mass erase for Main Flash and Boot memory", these four options will be selected
automatically based on the download files)
Bluetooth module
This can be set as Figure 41:
Enable sLib
Enable the sLib function when download. It is necessary to enter sLib password, start sector, DATA
start sector/ INSTR start sector, and end sector.
Verify
2022.08.11 38 Rev 2.04
ICP Programmer Manual
After the download is completed, the corresponding data in the memory is read and then verified to
determine whether the download is [Link] this option is unchecked, no verify is performed
after download, so it is impossible to determine whether the downloaded content is correct.
― Write address: the address where the serial number is programmed into the memory.
― Current SN: the serial number of the current programming.
― Increase step: this is the amount added to the next serial number after each serial number is
programmed.
: Select the user system data file. BIN and HEX formats are supported.
Method 1:
Select the file to be checked, right click, and select "File CRC verify" in the right-click menu.
Method 2:
Select the file to be verified and click "File CRC verify" button directly.
When need to read the encrypted data of the SPIM, users also need to configure the SPIM
FLASH_DA and encryption key. Based on the SPIM FLASH_DA and encryption key, MCU uses the
MCU's internal algorithm to decrypt the encrypted data and restore it to the correct original data.
When downloading files to SPIM, the following steps can be set to encrypt the downloaded
content. (AT32F403/F413/F403A/F407)
Step 1: set the FLASH_DA of the SPIM. (As shown in Figure 46)
Step 2: set the SPIM encryption key through the "user system data" page. (As shown in Figure 47)
4 Revision history
Table 1. Document revision history
Date Revision Changes
2022.08.11 V2.04 1. Modified some pictures.
2022.07.15 V2.03 1. Support for AT32L021.
2022.01.26 V2.02 1. Support for AT32WB415.
2021.11.26 V2.01 1. Support for AT32F425.
2. Support for AT32F403AVGW.
2021.10.13 V2.00 1. Initial release. Support for
AT32F403/F413/F415/F421/F403A/F407/F435/F437.
Artery’s products and services are provided “AS IS” and Artery provides no warranties express, implied or statutory, including, without
limitation, any implied warranties of merchantability, satisfactory quality, non-infringement, or fitness for a particular purpose with respect to
the Artery’s products and services.
Notwithstanding anything to the contrary, purchasers acquires no right, title or interest in any Artery’s products and services or any
intellectual property rights embodied therein. In no event shall Artery’s products and services provided be construed as (a) granting
purchasers, expressly or by implication, estoppel or otherwise, a license to use third party’s products and services; or (b) licensing the third
parties’ intellectual property rights; or (c) warranting the third party’s products and services and its intellectual property rights.
Purchasers hereby agrees that Artery’s products are not authorized for use as, and purchasers shall not integrate, promote, sell or
otherwise transfer any Artery’s product to any customer or end user for use as critical components in (a) any medical, life saving or life
support device or system, or (b) any safety device or system in any automotive application and mechanism (including but not limited to
automotive brake or airbag systems), or (c) any nuclear facilities, or (d) any air traffic control device, application or system, or (e) any
weapons device, application or system, or (f) any other device, application or system where it is reasonably foreseeable that failure of the
Artery’s products as used in such device, application or system would lead to death, bodily injury or catastrophic property damage.