830X开发环境搭建*
1. SDK获取*
Apus SDK
是托管在 GtiLab
私有仓库上,请阅读 注册 GitLab 账号 并将 GitLab
账号给我们的销售经理,由我司项目经理对该账号进行代码释放。
1.1 下载代码*
- 进入GitLab项目,如图复制项目的 git 地址。
- 获取代码:
$ git clone git@gitlab.com:nationalchip/apus-sdk.git
2. 搭建开发环境*
2.1 Windows下环境搭建*
第一步:安装T-HEAD CDS IDE*
下载IDE后双击安装即可
然后工具链手动更新下:
-
下载 Xuantie-900-gcc-elf-newlib-mingw-V2.10.2-20240904: http://yun.nationalchip.com:10000/l/U11qX1
-
更新CDS工具链: 解压工具链压缩包 "Xuantie-900-gcc-elf-newlib-mingw-V2.10.2-20240904.tar.gz",并将目录名 “Xuantie-900-gcc-elf-newlib-mingw-V2.10.2” 修改为 “riscv64-elf-tools”,然后替换原来的 “CDS安装目录\MinGW\riscv64-elf-tools”
第二步:打开工程*
- 点击“File” -> “Open projects From File System...”
- 在向导界面点击”Directory...”,选择apus工程目录
- 点击界面下方的”Finish”导入工程
第三步:配置编译工程*
-
- 配置目标app和board
右键点击”apus_sdk”工程项,点击”Options for project”项,或者点击”Options for project”图标
点击”C/C++ Build” -> “Build Variables”,分别编辑”app”和”board”的Value值,指定目标app和board,完成后点击下方”Apply and Close”
-
- 开始编译
右键点击”apus_sdk”工程项,点击”Build Project”,或者点击”Build Project”图标,开始编译; 同样的方式可用于rebuild,clean操作; 编译结果存放在工程output目录,apus.bin 是flash固件
第四步:固件下载*
APUS 支持 串口 和 USB 烧录两种方式
烧录下载工具:http://yun.nationalchip.com:10000/l/IF2mba
解压后打开NCDownloader.exe
- 串口烧录如下图配置
注意
Chip Type”选择”apus”,点击”Bin File”栏按钮选择flash固件
- USB烧录如下图配置
注意
按住boot键点击restart 后提示设备驱动加载异常,随即按说明安装驱动即可。
如果使用USB烧录,windows上需要安装对应的USB驱动,安装方式请参考里面的readme.txt usb驱动下载:windows_usb_driver.zip
-
点击”Start”,按住板子boot键,再按下reset键,进入下载流程工具右侧会有log信息,之后松开boot键
-
在uart比较繁忙时,也可先按住boot,按下reset键后,再点击”Start”,再松开boot键
-
正常下载完成,会打印”Operation Successful”,按reset键重启板子
注意
烧录工具详细使用细节请阅读:工具下载
第五步:GDB调试*
如果需要使用JTAG仿真器,进行GDB调试,可以参考下面的步骤。
如图所示,仿真器通过JTAG管脚连接开发板,另外一端通过USB连接PC电脑。
当你安装完成windows的编译环境后,会附带安装一个 T-Head DebugServer 工具,或者你也可以独立安装 T-Head-DebugServer-windows-V5.16.6-20221102-1510.zip:http://yun.nationalchip.com:10000/l/vFlneE
使用细节可以参考该PDF:
建议点击T-Head Debugger Server User Guide (ZH-CN)新建窗口打开。
先把ICE连接上,开发板上电,让电脑可以正确识别。然后确保开发板里面跑的固件没有复用修改过JTAG的管脚(如果不确定,可以通过NCDownloader.exe工具,把开发板里的固件擦除掉)。然后打开 T-Head DebugServer,连接成功的话,会显示如下图片:
在windows命令行下,执行 riscv64-unknown-elf-gdb.exe apus.elf riscv64-unknown-elf-gdb.exe 在路径 C-Sky\CDS\MinGW\riscv64-elf-tools\bin 里
并根据提示,连接GDB Server,例如: target remote 192.168.50.181:1025
然后就可以使用标准的GDB命令,进行调试了
注意:因为代码会通过 XIP执行,不要使用ICE加载固件来执行。请先把要调试的固件烧录进去,再通过GDB调试
2.2 Linux下环境搭建*
ubuntu 64位主流版本
第一步:设置你的Ubuntu环境*
设置Ubuntu环境
1.获取Apus SDK。由国芯人员释放
第二步:搭建编译环境*
1.工具链安装。
工具链下载地址:http://yun.nationalchip.com:10000/l/3FjmDz
sudo tar zxvf Xuantie-900-gcc-elf-newlib-x86_64-V2.10.2-20240904.tar.gz -C /opt/
2.设置系统环境变量
gedit $HOME/.bashrc
在末尾添加
export PATH=$PATH:/opt/Xuantie-900-gcc-elf-newlib-x86_64-V2.10.2/bin
保存退出
第三步:编译SDK*
make app=
cd apus
编译指定app和板级
make app=ble_remote_control board=gx8301a_rc_demo
第四步:下载固件*
- 使用bootx工具进行flash下载, 下载命令:
sudo ./tools/bootx/bootx -m auto -t s -d /dev/ttyUSB0 -r 1000000 -c "download 0 output/apus.bin"`
-
根据实际情况选择-d指向的uart设备
-
执行下载命令,按住boot键,再按reset键,进入下载流程会有打印信息,之后松开boot键
-
在uart比较繁忙时,也可先按住boot,按下reset键后,执行下载命令,再松开boot
-
下载完成后,按reset键启动
第五步:GDB调试*
如果需要使用JTAG仿真器,进行GDB调试,可以参考下面的步骤。
如图所示,仿真器通过JTAG管脚连接开发板,另外一端通过USB连接PC电脑。
- 下载DebugServerConsole: http://yun.nationalchip.com:10000/l/SFOWXh,并解压
- 安装DebugServerConsole:
sudo ./T-Head-DebugServer-linux-x86_64-V5.16.6-20221102.sh -i
,按照提示完成安装 - 在命令行执行:
DebugServerConsole
, 启动调试服务 - 在apus工程目录执行:
riscv64-unknown-elf-gdb output/apus.elf
,进入在线调试