搭建环境

获取工具链

我们已为开发者准备好工具链:

平台 提取码
MacOSX 9h4n
Ubuntu patn
Windows 2hyp

推荐使用 MacOSX 或 Ubuntu 平台,因为 Windows 平台的工具链运行有些慢。

配置工具链

首先,将工具链解压到磁盘上,然后,设置几个环境变量:

MacOSX / Ubuntu

假设解压路径为: /home/creator/mados-tools

export MADOS_TOOLS_VER=7.4.0  
export MADOS_TOOLS_HOME=/home/creator/mados-tools/tools/arm-none-eabi-$MADOS_TOOLS_VER  
export MADOS_TOOLS_BIN=$MADOS_TOOLS_HOME/bin  
export PATH=$MADOS_TOOLS_BIN:$PATH
1
2
3
4

将以上内容加入到用户配置文件末尾

平台 用户配置文件
MacOSX ~/.bash_profile
Ubuntu ~/.bashrc

执行以下命令:

source ~/.bash_profile # MacOSX
1
source ~/.bashrc       # Ubuntu
1

如果使用zsh作为终端,用户配置文件为.zprofile。

Windows

假设解压路径为: D:\DreamOn\MSYS2,设置用户环境变量:

# MADOS_TOOLS_VER   
  7.4.0
# MADOS_TOOLS_HOME  
  D:\DreamOn\MSYS2\home\zandz\mados-tools\tools\arm-none-eabi-7.4.0
# MADOS_TOOLS_BIN  
  D:\DreamOn\MSYS2\usr\bin;  
  D:\DreamOn\MSYS2\mingw64\bin;  
  D:\DreamOn\MSYS2\home\zandz\mados-tools\tools\openocd-0.10.0\bin-x64;  
  %MADOS_TOOLS_HOME%\bin;  
1
2
3
4
5
6
7
8
9

再将 %MADOS_TOOLS_BIN% 加入 PATH 中即可。

安装调试工具

推荐使用 OpenOCD 作为在线调试工具

MacOSX

brew install openocd
1

Ubuntu

sudo apt-get install openocd
1

Windows

# Windows 版工具链已包含 OpenOCD ,无需另行安装。
1

安装代码编辑器

推荐使用Visual Studio Code作代码编辑工具。

  • 设置环境变量后,需重启VSCode,以使其加载新环境变量。
  • Windows平台可能需以管理员身份运行VSCode,以使其可调用工具链。

安装 VSCode 扩展

扩展名 扩展标识符 发布者名称
AutoLaunch philfontaine.autolaunch philfontaine
C/C++ ms-vscode.cpptools Microsoft
Lua sumneko.lua sumneko
ARM dan-c-underwood.arm dan-c-underwood
Cortex-Debug marus25.cortex-debug marus25

MadOS支持Lua脚本语言,详见后续章节。

验证

GCC

执行

arm-none-eabi-gcc -v
1

输出版本信息

gcc version 7.4.0 (GNU Tools for MadOS [ARM][20190331][gcc-7.4.0][Newlib])
1

GDB

执行

arm-none-eabi-gdb -v
1

输出版本信息

GNU gdb (GDB) 8.2.1
1

OpenOCD

执行

openocd -v
1

输出版本信息

Open On-Chip Debugger 0.10.0
1