SDK快速入门(SF52X SF56X)

1. 开发工具准备

需要安装的软件

Sifli env和SiFli SDK(从微盘下载)。
Keil V5.32或以上，armcc V6版本或以上。
Segger Jlink，V7.62版本或以上。 Jlink下载地址
代码编辑软件vscode或者source insight。
串口日志查看工具，使用sdk自带的sifliTrace或者sscom。

需要的硬件

Windows PC x1
ARM仿真器 x1

备注

仿真器的供电和HDK板有冲突，需要关闭仿真器的供电。如果出现仿真器连接不成功，可以检查一下Jlink的供电硬件跳线。下图是常见Jlink的供电跳线，需要移除。

USB type-C 线 x 2
用于链接ARM仿真器和连接USB2UART小板给HDK板子供电，抓取HDK串口的LOG数据。
USB2UART debug小板 x1 (SIFLI-Debug001-V1.1.0)。

USB2UART debug小板一览图

HDK开发板 x 1套
包含一个HDK CPU板子SF56X或者SF52X，以及屏幕子板（屏幕不同，相应的子板型号不一样）。

HDK52x 开发板接口一览图
HDK56x 开发板接口一览图
屏幕子板接口一览图

2. 开发环境配置

ENV的配置

解压env到PC上，如 D:\work\env 。
进入env目录，可以运行本目录下的 env.exe ，如果打开失败可以尝试使用 env .bat 。
关联文件夹右键ConEmu Here菜单。

添加ConEmu Here到右键菜单任意文件夹右键可打开ConEmu Here

安装Keil

双击Keil安装包，按照提示点击下一步进行安装，需要注意的是keil的安装路径必须是 C:\Keil_v5 目录。启动Keil，打开 Help->>About 窗口，如果显示的版本不是v5.32则需要卸载并安装新版Keil。

安装完Keil后将arm的路径加入Windows环境变量PATH，如： C:\Keil_v5\ARM\ARMCLANG\bin 。

安装JLink

为了使用 J-Link Device Support Kit(DSK) 方式安装思澈 Open Flashloader，请安装 JLink V7.62 或以上版本，并将JLink的路径加入Windows环境变量PATH，如：C:\Program Files (x86)\SEGGER\JLink 。

SDK中的 tools/flash/jlink_drv 是一个完整的J-Link DSK包，目录根下的 JLinkDevices.xml 用于描述设备和flash bank，各子目录中的elf文件是对应的Open Flashloader algorithm。

在当前用户目录下创建如下目录： C:\Users\\AppData\Roaming\SEGGER\JLinkDevices\SiFli

备注

AppData 是 Windows 的隐藏目录。如果资源管理器中看不到该目录，请先开启“显示隐藏的项目”，或者直接在地址栏输入上述完整路径。

然后将 tools/flash/jlink_drv 目录内容整体拷贝到该目录，拷贝完成后的结构类似如下：

SiFli/
  JLinkDevices.xml
  sf32lb52x/
  sf32lb52x_nand/
  sf32lb52x_sd/
  sf32lb55x/
  sf32lb56x/
  sf32lb58x/
  ...

备注

J-Link V7.62 起会递归扫描 JLinkDevices 目录下的所有 *.xml 文件，因此不需要再修改J-Link安装目录下的 JLinkDevices.xml 。
XML中的loader路径相对 tools/flash/jlink_drv/JLinkDevices.xml 解析，因此必须整体复制该目录，不能只单独拷贝 .elf 文件。
如果复制DSK包之前J-Link Commander、J-Flash或IDE已经打开，请在复制后重新启动这些工具。

配置系统环境变量

在系统环境变量的PATH变量中添加如图几个路径，实际路径需要本机工具与代码路径一致。添加环境变量 PATH

3. 编译工程代码

SF52X工程代码编译

以hal_example下面的sf525工程为例编译步骤如下：

进入sdk根目录 $SDK_ROOT，鼠标右键选择ConEmu Here菜单。
执行脚本 .\set_env.bat_ ，配置环境。
进入到编译目录下：cd example\hal_example\project\common
执行编译命令：scons --board=eh-lb525_v2_hcpu -j8

备注

--board=xx, 需要指定编译的board信息，可以选择目录 customer\boards 下带v2的目录名对应的board，后面再加上_hcpu ，如eh-lb525_v2_hcpu。编译结束后会在common目录下生成文件夹build_eh-lb525_v2_hcpu，存放编译生成的image等文件。 sf525工程编译成功

SF56X工程代码编译

以hal_example下面的sf561工程为例编译步骤如下：

进入sdk根目录，鼠标右键选择ConEmu Here菜单。
执行脚本 .\set_env.bat，配置环境。
进入到编译目录下：cd example\hal_example\project\common
执行编译命令：scons --board=eh-lb561_v2_hcpu -j8

备注

--board= xx, 需要指定编译的board信息，可以选择目录 customer\boards 下带v2的目录名对应的board，后面再加上_hcpu ，如eh-lb561_v2_hcpu。编译结束后会在common目录下生成文件夹build_eh-lb561_v2_hcpu，存放编译生成的image等文件。 sf561工程编译成功

4，下载烧写HDK

SF52X工程image下载烧写

sf525使用的是uart接口下载镜像，将HDK板子连接siflideubg小板，再将siflideubg小板使用typec线连接电脑，需要先确认一下CPU的日志输出的com口，比如为COM4。

串口日志工具关闭串口。
在编译目录下运行下载脚本 .\build_eh-lb525_v2_hcpu\uart_download.bat。
此时会让输入下载使用的COM口，输入4。按enter键，下载开始。

sf525下载image

SF561工程image下载烧写

sf561使用的是JLink下载镜像，将HDK板子连接siflideubg小板，将siflideubg小板使用typec线连接电脑用于串口打印日志，再将ARM仿真器通过JLink排线连接到siflideubg小板上， ARM仿真器的另一端使用typec连接到电脑。

使用J-Link Commander发送connect命令确认开发板是否能连接成功。

备注

connect时选择的Device名与工程目录下rtconfig.py中的JLINK_DEVICE保持一致，比如sf561选择SF32LB56X。选择完device后会选择interface（SWD），接下来配置传输速率，默认即可。可以看到连接成功。

sf561连接JLink

在编译目录下运行下载脚本 .\build_eh-lb561_v2_hcpu\download.bat，开始启动JLink下载。

sf561下载image