跳转至

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”导入工程 cds_import.png

第三步:配置编译工程*

    • 配置目标app和board

右键点击”apus_sdk”工程项,点击”Options for project”项,或者点击”Options for project”图标 cds_option.png

点击”C/C++ Build” -> “Build Variables”,分别编辑”app”和”board”的Value值,指定目标app和board,完成后点击下方”Apply and Close” cds_properties.png

    • 开始编译

右键点击”apus_sdk”工程项,点击”Build Project”,或者点击”Build Project”图标,开始编译; 同样的方式可用于rebuild,clean操作; 编译结果存放在工程output目录,apus.bin 是flash固件

image-20240313111953899

第四步:固件下载*

APUS 支持 串口USB 烧录两种方式

烧录下载工具:http://yun.nationalchip.com:10000/l/IF2mba

解压后打开NCDownloader.exe

  • 串口烧录如下图配置

注意

Chip Type”选择”apus”,点击”Bin File”栏按钮选择flash固件

1

  • USB烧录如下图配置

注意

按住boot键点击restart 后提示设备驱动加载异常,随即按说明安装驱动即可。

如果使用USB烧录,windows上需要安装对应的USB驱动,安装方式请参考里面的readme.txt usb驱动下载:windows_usb_driver.zip

屏幕截图 2024-03-13 110735

  • 点击”Start”,按住板子boot键,再按下reset键,进入下载流程工具右侧会有log信息,之后松开boot键

  • 在uart比较繁忙时,也可先按住boot,按下reset键后,再点击”Start”,再松开boot键

  • 正常下载完成,会打印”Operation Successful”,按reset键重启板子

2

注意

烧录工具详细使用细节请阅读:工具下载

第五步: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= board=例如:make app=keypad_sample board=dev_v1

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,进入在线调试