有人预言,RISC-V或将是继Intel和Arm之后的第三大主流处理器体系。欢迎访问全球首家只专注于RISC-V单片机行业应用的中文网站
您需要 登录 才可以下载或查看，没有帐号？立即注册
x
本帖最后由 魏定国 于 2022-11-6 10:54 编辑
序 — 起因
某天在群里看到有人发 sipeed2022_spring_competition 的活动宣传图，如下：
重点是可以白嫖一块 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 | | Longan Nano是基于兆易创新(GigaDevice)的GD32VF103CBT6(RISC-V架构)芯片设计的极简开发板。开发板将芯片所有IO引出，设计小巧精致，板载Type-C、LCD、SD卡、JTAG等接口，方便广大学生、工程师、极客爱好者们接触学习最新一代的 RISC-V处理器。 | GD32VF103CBT6 ，基于芯来科技.的Bumblebee内核 | | 支持 RV32IMAC 指令集及ECLIC 快速中断功能。内核功耗仅传统 Cortex-M3 的1/3. | Longan nano 开发工具 | | 注：Windows 平台 | Longan nano 相关手册 | | 有中英文版本 | Longan nano 引脚图和规格书 | | 相关引脚信息 | HDK 屏幕资料 | | 0.96 inch 80*160 IPS LCD | Blink 闪灯程序 | | 在 vscode 使用 pio 插件开发，使用 jlink/sipeed-rv-debugger 工具调试，使用 gd32-dfu （仅供 windows）上位机下载调试，使用 zadig 替换驱动信息。 | RV-LINK 原始仓库（几年没更新了） | | 用 RISC-V 开发板实现的 RISC-V 仿真器。与其它仿真器不同的是：RV-LINK 通过 USB 串口直接与 GDB 交互，不需要 OpenOCD 之类的中介。 | 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) 插件 | | 打开 VSCode -> 点击左侧扩展 -> 搜索 PlatformIO -> 点击安装插件 -> 等待安装完成 -> 重启 VSCODE | gd32-dfu-utils | | Dfu-utils GD32 fork. Dfu-util - Device Firmware Upgrade Utilities | gd32-dfu-utils AUR 包 | | AUR 的 gd32-dfu-utils 包，做了处理避免和 dfu-utils 包冲突 | rv-link-udev-git AUR 包 | | AUR 的 rv-link 的 udev 文件（驱动文件） | 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 | | BOUFFALOLAB MCU TOOL | python-bflb-iot-tool | | BOUFFALOLAB IOT TOOL | python-bflb-crypto-plus | | | Bouffalo Lab Dev Cube For Ubuntu | | Dev Cube是博流提供的芯片集成开发工具，包含IOT程序下载、MCU程序下载和RF性能测试三大功能。工具提供程序固件启动时的时钟，电源，Flash参数等配置，并可根据用户需求对程序进行加密和签名，生成应用程序启动信息文件。工具还可烧写用户资源文件，分区表文件以及 EFUSE配置文件等。工具可对Flash进行擦、改、写 | 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/>----
- -
- -
- -
- -
- -
- -
- -
- -
- -
- -
- +
- +
- +
- +
- -
- +
- -
- +
- +
- +
- +
- +
- +
- +
再此编译即可生成固件。 由于此 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
- 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
命令行刷机操作 准备操作
按住 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
- 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
- }
安装 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
- 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 工具安装 99-rvlink-jtag.rules - yay -Syu rv-link-udev-git
总结 — 填坑至始
完成 Sipeed Longan Nano RISC-V GD32VF103CBT6 rv-link 固件的编译 rv-link 固件的烧录 rv-link 驱动文件安装 完成 Sipeed RV-Debugger-BL702
bflb-mcu-tool 的 python 打包 bflb-mcu-tool 烧录固件
剩下的就是填坑之路。 完
| 
/2 
发表于 2022-11-6 10:54:37
