Arch Linux 下 sipeed longan-nano 2 rv-link
序 – 起因
某天在群里看到有人发 sipeed2022_spring_competition 的活动宣传图，如下：
矽速2022春季AIoT挑战赛~~矽速(Sipeed)2022春季AIoT挑战赛，万元大奖等你来拿 ～~
赛题信息：https://github.com/sipeed/sipeed2022_spring_competition
转发比赛信息到1000人以上相关技术QQ群,500人专业微信群，或专业论坛，
即可到矽速官方店领取 BL702 JTAG+UART 调试小板一块～
（截图给客服，仅限第一次转发到该群有效, sipeed.taobao.com）
重点是可以白嫖一块 BL702 JTAG+UART 调试小板 ，对于电子行业的用户来说这是无法拒绝的诱惑；而且还是调试工具。
于是白嫖了这块 Sipeed RV debugger plus JTAG+UART BL702 调试器(有需要的朋友，也可以去白嫖)，在他们官方的店铺看到了 Sipeed Longan Nano RISC-V GD32VF103CBT6 单片机 带壳开发板，没忍住，于是就有这篇 linux 下制作 rv-link 的调试器的文章。
准备–初步了解
sipeed 官网关于Longan nano开发板的相关信息、 RV-LINK 介绍信息和 PIO 插件信息。如下：
| 资源 | 连接 | 详情 |
|---|---|---|
| Longan nano wiki | https://wiki.sipeed.com/hardware/zh/longan/Nano/Longan_nano.html | Longan Nano是基于兆易创新(GigaDevice)的GD32VF103CBT6(RISC-V架构)芯片设计的极简开发板。开发板将芯片所有IO引出，设计小巧精致，板载Type-C、LCD、SD卡、JTAG等接口，方便广大学生、工程师、极客爱好者们接触学习最新一代的 RISC-V处理器。 |
| GD32VF103CBT6 ，基于芯来科技.的Bumblebee内核 | http://dl.sipeed.com/LONGAN/Nano/DOC/ | 支持 RV32IMAC 指令集及ECLIC 快速中断功能。内核功耗仅传统 Cortex-M3 的1/3. |
| Longan nano 开发工具 | https://dl.sipeed.com/LONGAN/Nano/Tools/ | 注：Windows 平台 |
| Longan nano 相关手册 | https://dl.sipeed.com/shareURL/LONGAN/Nano/DOC | 有中英文版本 |
| Longan nano 引脚图和规格书 | https://dl.sipeed.com/shareURL/LONGAN/Nano/Spec | 相关引脚信息 |
| HDK 屏幕资料 | https://dl.sipeed.com/shareURL/LONGAN/Nano/HDK | 0.96 inch 80*160 IPS LCD |
| Blink 闪灯程序 | https://wiki.sipeed.com/soft/longan/zh/get_started/blink.html | 在 vscode 使用 pio 插件开发，使用 jlink/sipeed-rv-debugger 工具调试，使用 gd32-dfu （仅供 windows）上位机下载调试，使用 zadig 替换驱动信息。 |
| RV-LINK 原始仓库（几年没更新了） | https://gitee.com/zoomdy/RV-LINK | 用 RISC-V 开发板实现的 RISC-V 仿真器。与其它仿真器不同的是：RV-LINK 通过 USB 串口直接与 GDB 交互，不需要 OpenOCD 之类的中介。 |
| rv-link 第三方仓库（进行了大量功能新增和优化） | https://github.com/michahoiting/rv-link | This project aims to improve the original RV-LINK firmware with the following features: Support for a newly designed hardware board with specific features, called RVL-Probe Support for JTAG over SPI + DMA; Additional diagnostics of the JTAG interface; Support for a second USB to serial adapter; A CAN bus logger; Easy updating of the RV-Link firmware; Support of running RV-Link on other host platforms (e.g. Linux PC+FT323 / Raspberry Pi); Additional mon commands; Additional NVM configurable items. |
| vscode 的 pio(PlatformIO) 插件 | https://platformio.org/platformio-ide | 打开 VSCode -> 点击左侧扩展 -> 搜索 PlatformIO -> 点击安装插件 -> 等待安装完成 -> 重启 VSCODE |
| gd32-dfu-utils | https://github.com/riscv-mcu/gd32-dfu-utils | Dfu-utils GD32 fork. Dfu-util - Device Firmware Upgrade Utilities |
| gd32-dfu-utils AUR 包 | https://aur.archlinux.org/packages/gd32-dfu-utils | AUR 的 gd32-dfu-utils 包，做了处理避免和 dfu-utils 包冲突 |
| rv-link-udev-git AUR 包 | https://aur.archlinux.org/packages/rv-link-udev-git | AUR 的 rv-link 的 udev 文件（驱动文件） |
| RV-Debugger-BL702 | https://github.com/sipeed/RV-Debugger-BL702 | RV-Debugger-BL702 源码，RV-Debugger-BL702 is an opensource project that implement a JTAG+UART debugger with BL702C-A0. |
| python-bflb-mcu-tool | https://aur.archlinux.org/packages/python-bflb-mcu-tool | BOUFFALOLAB MCU TOOL |
| python-bflb-iot-tool | https://aur.archlinux.org/packages/python-bflb-iot-tool | BOUFFALOLAB IOT TOOL |
| python-bflb-crypto-plus | https://aur.archlinux.org/packages/python-bflb-crypto-plus | PyCryptoPlus is an extension to the Python Crypto module (www.pycrypto.org). |
| Bouffalo Lab Dev Cube For Ubuntu | https://dev.bouffalolab.com/media/upload/download/BouffaloLabDevCube-1.6.8-linux-x86.tar.gz | Dev Cube是博流提供的芯片集成开发工具，包含IOT程序下载、MCU程序下载和RF性能测试三大功能。工具提供程序固件启动时的时钟，电源，Flash参数等配置，并可根据用户需求对程序进行加密和签名，生成应用程序启动信息文件。工具还可烧写用户资源文件，分区表文件以及 EFUSE配置文件等。工具可对Flash进行擦、改、写 |
| bflb-mcu-tool | https://pypi.org/project/bflb-mcu-tool | BOUFFALOLAB MCU TOOL |
根据上面相关信息，大致有点了解后，应该知道如何安装 git 、 vscode 和 pio 插件 。以下默认已经安装。
编译 RV-LINK – 踩踩坑
- RV-LINK 原始仓库进行编译
- 克隆
RV-LINK源码
git clone https://gitee.com/zoomdy/RV-LINK.git
- 运行
vscode，左侧找到pio，单击后，选择打开本地工程，选择上面RV-LINK所在位置 - 左下角单击
编译图标[✔]，不出意外的话会有如下报错：
KeyError: "Invalid board option 'build.ldscript'":
File "~/.platformio/penv/lib/site-packages/platformio/builder/main.py", line 179:
env.SConscript(item, exports="env")
File "~/.platformio/packages/tool-scons/scons-local-4.3.0/SCons/Script/SConscript.py", line 597:
return _SConscript(self.fs, *files, **subst_kw)
File "~/.platformio/packages/tool-scons/scons-local-4.3.0/SCons/Script/SConscript.py", line 285:
exec(compile(scriptdata, scriptname, 'exec'), call_stack[-1].globals)
File "~/RV-LINK-master/RV-LINK-master/build.py", line 65:
LDSCRIPT_PATH = join(PROJ_DIR, "src", "link", "gd32vf103c-start", "RISCV", "gcc", board.get("build.ldscript"))
File "~/.platformio/penv/lib/site-packages/platformio/platform/board.py", line 46:
raise KeyError("Invalid board option '%s'" % path)
原因是 build.ldscript 参数发生变化，需要在工程目录下 plateformio.ini 进行如下修改：
; PlatformIO Project Configuration File
;
; Build options: build flags, source filter, extra scripting
; Upload options: custom port, speed and extra flags
; Library options: dependencies, extra library storages
;
; Please visit documentation for the other options and examples
; http://docs.platformio.org/page/projectconf.html
[env:sipeed-longan-nano]
; platform = gd32v
platform = https://github.com/sipeed/platform-gd32v.git
;framework = gd32vf103-sdk
board = sipeed-longan-nano
monitor_speed = 115200
upload_protocol = dfu
debug_tool = sipeed-rv-debugger
board_build.ldscript = GD32VF103xB.lds
build_flags =
-DGD32VF103C_START
-DUSE_STDPERIPH_DRIVER
-DUSE_USB_FS
-DLINK_LONGAN_NANO
-DTARGET_GD32VF103
-DAPP_GDB_SERVER
-DRVL_ASSERT_EN
-MMD
extra_scripts =
pre:build.py
src_filter =
+<*>-<.git/>-<.svn/>-<example/>-<examples/>-<test/>-<tests/>
-<app/riscv-prober>
-<app/test-usb-serial/>
-<link/gd32vf103c-start/rvl-link.c>
-<link/gd32vf103c-start/rvl-button.c>
-<link/gd32vf103c-start/rvl-led.c>
-<link/gd32vf103c-start/rvl-jtag.c>
-<link/gd32vf103c-start/gd32vf103c_start.c>
-<link/gd32vf103c-start/rvl-jtag-inline.h>
-<link/rvl-link-stub.c>
-<link/gd32vf103c-start/RISCV/gcc/>
+<link/gd32vf103c-start/RISCV/gcc/init.c>
+<link/gd32vf103c-start/RISCV/gcc/handlers.c>
+<link/gd32vf103c-start/RISCV/gcc/entry.S>
+<link/gd32vf103c-start/RISCV/gcc/start.S>
-<link/gd32vf103c-start/RISCV/stubs>
+<link/gd32vf103c-start/RISCV/stubs/sbrk.c>
-<link/gd32vf103c-start/GD32VF103_standard_peripheral/>
+<link/gd32vf103c-start/GD32VF103_standard_peripheral/system_gd32vf103.c>
+<link/gd32vf103c-start/GD32VF103_standard_peripheral/Source/gd32vf103_gpio.c>
+<link/gd32vf103c-start/GD32VF103_standard_peripheral/Source/gd32vf103_rcu.c>
+<link/gd32vf103c-start/GD32VF103_standard_peripheral/Source/gd32vf103_timer.c>
+<link/gd32vf103c-start/GD32VF103_standard_peripheral/Source/gd32vf103_eclic.c>
+<link/gd32vf103c-start/GD32VF103_standard_peripheral/Source/gd32vf103_exti.c>
+<link/gd32vf103c-start/GD32VF103_standard_peripheral/Source/gd32vf103_pmu.c>
- 再此编译即可生成固件。
- 由于此
RV-LINK停更两年以上，可以选择自己二次开发或使用第三方开发的其他RV-LINK
rv-link第三方仓库编译
- 克隆
rv-link源码
git clone https://github.com/michahoiting/rv-link.git
- 运行
vscode，左侧找到pio，单击后，选择打开本地工程，选择上面RV-LINK所在位置 - 左下角单击
编译图标[✔]，不出意外的话编译通过
烧录固件 – gd32-dfu-utils
- 发现 linux 没有 gd32 的 dfu 刷固件工具，于是打包了 gd32-dfu-utils 来给 arch 系用户使用，打包的
PKGBUILD文件内容如下
# Maintainer: taotieren <admin@taotieren.com>
pkgname=gd32-dfu-utils
pkgver=0.9
pkgrel=2
epoch=
pkgdesc="Dfu-utils GD32 fork. Dfu-util - Device Firmware Upgrade Utilities"
arch=('x86_64')
url="https://github.com/riscv-mcu/gd32-dfu-utils"
license=('GPLv2')
groups=()
depends=('libusb')
makedepends=()
checkdepends=()
optdepends=(
'python: dfuse-pack tool support'
'python-intelhex: Intel HEX file format support'
)
provides=("GD32-dfu-util")
conflicts=()
replaces=()
backup=()
options=('!strip')
install=
changelog=
source=("${pkgname}-${pkgver}.tar.gz::${url}/archive/refs/tags/v${pkgver}.tar.gz")
noextract=()
sha256sums=('6312461aab3650b0be8648a7afb9bbf2e63328defe80b25b6c2c85973b39f8f5')
#validpgpkeys=()
build() {
cd "${srcdir}/${pkgname}-${pkgver}"
./autogen.sh
./configure --prefix=/usr
make
}
package() {
cd $pkgname-$pkgver
make DESTDIR="$pkgdir" install
install -Dm755 dfuse-pack.py "$pkgdir"/usr/bin/dfuse-pack
install -Dm644 doc/40-dfuse.rules "$pkgdir"/usr/lib/udev/rules.d/40-gd32-dfuse.rules
cd "$pkgdir"/usr/bin/
for var in *; do mv "$var" "gd32-${var}"; done
rm -rf "$pkgdir"/usr/share
}
-
for var in *; do mv "$var" "gd32-${var}"; done将dfu的工具重命名成gb32-开头，避免和dfu工具冲突，正常来说需要打patch暂时还没写，后续和gd32-dfu-utils维护者沟通下，是他那边修改还是我这边打包的时候打patch -
已经上传到 AUR 仓库 gd32-dfu-utils
- 命令行刷机操作
- 准备操作
- 按住 BOOT0 按钮，然后按下 RESET 按钮，释放 RESET 按钮，最后释放 BOOT0 按钮，进入 DFU 模式
# 通过 lsusb 或者 GD32 的 PID:VID 信息
❯ lsusb |grep GD
Bus 003 Device 052: ID 28e9:0189 GDMicroelectronics GD32 DFU Bootloader (Longan Nano)
# 命令行刷写固件，用法和 dfu 一致，其他 dfu 用户可以看 dfu 的帮助文档或其他用户的分享
❯ gd32-dfu-util -d 28e9:0189 -a 0 --dfuse-address 0x08000000:leave -D rvlink_fw_sipeed-longan-nano.hex
dfu-util 0.9
Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc.
Copyright 2010-2016 Tormod Volden and Stefan Schmidt
This program is Free Software and has ABSOLUTELY NO WARRANTY
Please report bugs to http://sourceforge.net/p/dfu-util/tickets/
gd32-dfu-util: Invalid DFU suffix signature
gd32-dfu-util: A valid DFU suffix will be required in a future dfu-util release!!!
Opening DFU capable USB device...
ID 28e9:0189
Run-time device DFU version 011a
Claiming USB DFU Interface...
Setting Alternate Setting #0 ...
Determining device status: state = dfuIDLE, status = 0
dfuIDLE, continuing
DFU mode device DFU version 011a
Device returned transfer size 2048
GD32 flash memory access detected
Device model: GD32VF103CB
Memory segment (0x08000000 - 0801ffff)(rew)
Erase size 1024, page count 128
Downloading to address = 0x08000000, size = 141046
gd32-dfu-util: Last page at 0x080226f5 is not writeable
# 通过 lsusb 确认刷入的固件是否别识别
❯ lsusb |grep GD
Bus 003 Device 053: ID 28e9:018a GDMicroelectronics Longan Nano
- 其他的可能的坑
- 可能会踩的坑 Ubuntu 等需要将
$USER加到 串口组(uucp) 里面（新版本一般是uucp，旧版本可能是其他的，使用ls -lsh /dev/ttyUSB*查看设备所在组。如果在 Linux 下调试时遇到串口不通或者提示没权限，把用户加入串口设备组里面，后重启电脑试试。示例：
# 查看 串口设备组
❯ ls -lash /dev/ttyS0 0 crwxrwxrwx 1 root uucp 4, 64 Feb 15 19:09 /dev/ttyS0
❯ sudo gpasswd -a `whoami` uucp
[sudo] taotieren 的密码：
正在将用户“taotieren”加入到“uucp”组中
❯ groups `whoami`
wheel uucp vboxusers taotieren
❯ reboot
# 如果添加 uucp 后还是不能使用，尝试安装 uucp 软件包，以 Arch 为例，其他 Linux 根据设备组确认
❯ yay -Syu uucp
固件烧录 – RV-Debugger-BL702
Bouffalo Lab Dev Cube我这边在 Arch 下运行有一些坑（内置的软件版本过低，和 Arch 最新的包不兼容），无法运行。- 在 Bouffalo 官网找到 bflb-mcu-tool 的 python 源码包，编写
PKGBUILD进行打包操作
# Maintainer: taotieren <admin@taotieren.com>
pkgname=python-bflb-mcu-tool
_name=${pkgname#python-}
pkgver=1.6.8
pkgrel=1
epoch=
pkgdesc="BOUFFALOLAB MCU TOOL"
arch=('any')
url="https://pypi.org/project/bflb-mcu-tool"
license=('unkown')
groups=()
depends=('python' )
makedepends=('python-build' 'python-installer' 'python-wheel')
checkdepends=()
optdepends=()
provides=()
conflicts=()
replaces=()
backup=()
options=('!strip')
install=
changelog=
source=("${_name}-${pkgver}.tar.gz::https://files.pythonhosted.org/packages/a5/57/ab4a45ca3e7736c415f28502db6d897256332521025a52872b534d288207/$_name-$pkgver.tar.gz")
noextract=()
sha256sums=('675f24619aded8f1313bde5c0cb2da5100e519c7ec5234b3b2481b66e5aa8bcc')
#validpgpkeys=()
build() {
cd "${srcdir}/${_name}-${pkgver}"
python -m build --wheel --no-isolation
}
package() {
cd "${srcdir}/${_name}-${pkgver}"
python -m installer --destdir="${pkgdir}" dist/*.whl
}
-
上传到 AUR 仓库：python-bflb-mcu-tool
-
安装 python-bflb-mcu-tool
yay -S python-bflb-mcu-tool -
博流还有其他 python 包，也一并打包了，需要的话可以自行安装。
# BOUFFALOLAB IOT TOOL yay -S python-bflb-iot-tool # PyCryptoPlus is an extension to the Python Crypto module (www.pycrypto.org). yay -S python-bflb-crypto-plus
- bflb-mcu-tool 固件烧录操作
# Windows:
# 设备管理器确认 bl702 实际串口号
.\bflb_mcu_tool.exe --chipname=bl702 --port=COM9 --xtal=32M --firmware="main.bin"
# Linux:
# lsusb 获取 bl702 的 usb 信息，确认 bl702 实际串口号
# 通过软件包安装后可以直接使用 bflb_mcu_tool ，如果是手动编译或者其他方式，自己设置运行路径即可。
# 建议参考前面的 AUR 中 python 编译和打包的操作，先将其打包成 whl 包，再用 python 安装 whl 包
bflb_mcu_tool --chipname=bl702 --port=ttyUSB1 --xtal=32M --firmware="main.bin"
安装驱动 – rv-link-udev
- 安装
rv-link里面的99-rvlink-jtag.rules
# 手动安装 99-rvlink-jtag.rules 到系统的 /etc/udev/rules.d/99-rvlink-jtag.rules
# 如果打包的话安装至 /usr/lib/udev/rules.d/99-rvlink-jtag.rules
sudo install -Dm0644 "rv-link/drivers/udev/rules.d/99-rvlink-jtag.rules" "/usr/lib/udev/rules.d/99-rvlink-jtag.rules"
sudo install -Dm0644 "rv-link/drivers/udev/rules.d/99-rvlink-jtag.rules" "/etc/udev/rules.d/99-rvlink-jtag.rules"
- 将
99-rvlink-jtag.rules打包到 AUR 仓库，编写相应的PKGBUILD
# Maintainer: taotieren <admin@taotieren.com>
pkgname=rv-link-udev-git
pkgver=0.2.1.r95.g04f3781
pkgrel=1
pkgdesc="A JTAG emulator/debugger for RISC-V micro-controllers that runs on a RISC-V development board (Sipeed Longan Nano for example)."
arch=('any')
url="https://github.com/michahoiting/rv-link"
license=('MulanPSL')
provides=(${pkgname%-git})
conflicts=()
#replaces=(${pkgname})
depends=('libusb')
makedepends=('git')
backup=()
options=('!strip')
#install=${pkgname}.install
source=("${pkgname%-git}::git+${url}.git")
sha256sums=('SKIP')
pkgver() {
cd "${srcdir}/${pkgname%-git}"
git describe --long --tags | sed 's/^v//g' | sed 's/\([^-]*-g\)/r\1/;s/-/./g'
}
package() {
install -Dm0644 "${srcdir}/${pkgname%-git}/drivers/udev/rules.d/99-rvlink-jtag.rules" "${pkgdir}/usr/lib/udev/rules.d/99-rvlink-jtag.rules"
}
-
上传至 AUR 仓库：rv-link-udev-git
-
通过 AUR 工具安装
99-rvlink-jtag.rulesyay -Syu rv-link-udev-git
总结 – 填坑至始
-
完成 Sipeed
Longan NanoRISC-V GD32VF103CBT6rv-link固件的编译rv-link固件的烧录rv-link驱动文件安装
-
完成 Sipeed
RV-Debugger-BL702bflb-mcu-tool的python打包bflb-mcu-tool烧录固件
-
剩下的就是填坑之路。
本文来自博客园，作者：饕餮人，转载请注明原文链接：https://www.cnblogs.com/taotieren/p/18458846
