Table of Contents
Advertisement
Quick Links
AT-Link Console User Manual
UM0006
User Manual
AT-Link Console User Manual
Introduction
This user manual gives an overview of AT-Link Console. AT-Link Console is a command-line
application based on AT-Link. With the help of this software, users can configure ARTERY MCU
devices through SWD ports.
List of applicable Artery MCUs:
Part number
AT32F series
2023.08.10
1
Ver 2.08
Advertisement
Table of Contents
Subscribe to Our Youtube Channel
Related Manuals for ARTERY AT32F Series
Summary of Contents for ARTERY AT32F Series
- Page 1 AT-Link Console User Manual Introduction This user manual gives an overview of AT-Link Console. AT-Link Console is a command-line application based on AT-Link. With the help of this software, users can configure ARTERY MCU devices through SWD ports. List of applicable Artery MCUs:...
-
Page 2: Table Of Contents
AT-Link Console User Manual Contents Introduction ........................ 5 Environmental requirements..................5 Glossary ........................5 Installation ........................6 Software operation ....................7 Operating mode ......................7 3.1.1 Used in Windows ......................7 3.1.2 Used in Linux ........................ 8 Command line parameters ................... 9 AT-Link Console return codes .................. - Page 3 AT-Link Console User Manual List of tables Table 1 List of command line parameters .................... 9 Table 2 List of return codes ........................ 11 Table 3. Document revision history ....................14 2023.08.10 Ver 2.08...
- Page 4 AT-Link Console User Manual List of figures Figure- 1 Command line window ......................7 Figure- 2 Batch file processing ......................7 Figure- 3 Linux OS ..........................8 Figure- 4 Shell script file ........................8 Figure- 5 Flow chart ........................... 13 2023.08.10 Ver 2.08...
-
Page 5: Introduction
Linux OS Linux OS with x86_64 architecture, such as Ubuntu, Federa, etc. Hardware resources AT-Link debugger USB communication port. Glossary AT-Link debugger AT-Link is a debugger, released by ARTERY, for the sake of MCU development. 2023.08.10 Ver 2.08... -
Page 6: Installation
AT-Link Console User Manual Installation Hardware installation Step 1: Connect AT-Link debugger to the USB port of PC. Step 2: Connect AT-Link debugger to the ICE interface of the target evaluation board. Software installation This software doesn’t need to be installed, just run the executable program directly. 2023.08.10 Ver 2.08... -
Page 7: Software Operation
AT-Link Console User Manual Software operation Operating mode Used in Windows 3.1.1 Mode 1: Input parameters on the command line Figure- 1 Command line window Mode 2: Batch file processing (Refer to DFU_download.bat for details on common operations) Figure- 2 Batch file processing 2023.08.10 Ver 2.08... -
Page 8: Used In Linux
AT-Link Console User Manual Used in Linux 3.1.2 The executive program “ATLink_Console” and the script “ATLink_Console.sh” needs an execution permission. Command: chmod +x ATLink_Console ATLink_Console.sh Edit the script “download.sh”, add operation steps based on command line parameters shown in Section 4.2 (Seedownload.sh in the example) and give an execution permission. Command: chmod +x download.sh To execut the script download.sh in the terminal, a sudo is required, for either a serial interface or USB device needs a root user authority. -
Page 9: Command Line Parameters
AT-Link Console User Manual Command line parameters Table 1 List of command line parameters Command Sub Command Remarks Show the help. Set device, e.g AT32F403ARGT7. You must set device when the device -device access protection. -connect Establish connection. Erase flash. Erase all sectors of flash, spim(spim enabled), boot memory(AP mode --all enabled). - Page 10 AT-Link Console User Manual Command Sub Command Remarks --fn file_name Full path name (bin/hex file; the file type is recognized by its extension). Verify after download. Enable or disable protection. --efap1 Enable access protection, all options following this one will fail. Enable high level access protection, all options following this one will --efap2 fail.
-
Page 11: At-Link Console Return Codes
AT-Link Console User Manual Command Sub Command Remarks MCU debug mode, write 16-bit data addr(hex) The address of the data to be written, 32 bit address. e.g 20000000. value(hex) The value of the data to be written, 16 bit data. e.g 0011. -mem32 MCU debug mode, read 32-bit data. - Page 12 AT-Link Console User Manual Return Command Error code 0x20 Failed to enable access protection. -p --efap1 0x21 Failed to enable high level access protection. -p --efap2 0x22 Failed to disable flash access protection. -p --dfap 0x23 Failed to disable erase and program protection. -p --depp 0x24 Failed to enable erase and program protection.
-
Page 13: Flow Chart
AT-Link Console User Manual Flow chart Figure- 5 Flow chart Start When MCU acce ss protected or e rase a nd Disa ble access p rote ction or prog ram p rote cted erase and pro gram protection When a SPIM is nee ded Ena ble SPIM Era se Flash... -
Page 14: Revision History
AT-Link Console User Manual Revision history Table 3. Document revision history Date Revision Changes 2023/08/10 V2.08 Support for AT32F423VCW. Support for AT32F402/F405 srieal. 2023/07/06 V2.07 Support for AT32A403A serial. 2023/02/12 V2.06 Supports multiple platforms，inluding Windows、Linux(Ubuntu, Fedora) OS. Added AT32F423 series. 2022/08/12 V2.05 Added return codes. - Page 15 Purchasers understand and agree that purchasers are solely responsible for the selection and use of Artery’s products and services. 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.
Need help?
Do you have a question about the AT32F Series and is the answer not in the manual?
Questions and answers