➜ ~ uname -a Linux minisforum 6.12.74+deb13+1-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.12.74-2 (2026-03-08) x86_64 GNU/Linux ➜ ~ gcc --version gcc (Debian 14.2.0-19) 14.2.0 Copyright (C) 2024 Free Software Foundation, Inc. This is free software; see the sourcefor copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
➜ ~ riscv64-unknown-elf-gcc --version riscv64-unknown-elf-gcc (g5115c7e447f) 15.2.0 Copyright (C) 2025 Free Software Foundation, Inc. This is free software; see the sourcefor copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
➜ ~ riscv64-unknown-linux-gnu-gcc --version riscv64-unknown-linux-gnu-gcc (g5115c7e447f) 15.2.0 Copyright (C) 2025 Free Software Foundation, Inc. This is free software; see the sourcefor copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
]]><div class="tag-plugin colorful note" color="cyan"><div class="body"><p>RISC-V 工具链的官方仓库 README 文档中的操作说明已经比较详细了，本文主要是记录指定的 GCC 版本来构建工具链的方法。</Milk-V Duo S 点灯https://curiositynotes.dev/posts/40a001bb/2026-03-22T13:47:20.000Z2026-05-20T14:08:16.436Z最近想找个 RISC-V 小板子玩一玩，搜寻一番发现大多都是搭载了多核异构 SoC 的嵌入式开发板，入手了一块 Milk-V Duo S 开发板。
其实 SpacemiT K1 的开发板更具吸引力，但是价格小贵
板子的基本使用方法官方文档中写的比较详细，我这里主要记录一下使用 SDK 自行构建 SD 卡镜像遇到的一些问题；以及 Linux 启动后，如何扩展根分区和增加可用内存。
报错信息（linux/cvi_type.h: No such file or directory）：
1 2 3 4 5 6 7 8 9
ake[2]: Entering directory '/home/ronnie/code/duo-buildroot-sdk-v2/cvi_mpi/modules/sys' ov_ov5647/ov5647_cmos.c:8:10: fatal error: linux/cvi_type.h: No such file or directory 8 | #include <linux/cvi_type.h> | ^~~~~~~~~~~~~~~~~~ compilation terminated. gcore_gc2083/gc2083_cmos.c:7:10: fatal error: linux/cvi_type.h: No such file or directory 7 | #include <linux/cvi_type.h> | ^~~~~~~~~~~~~~~~~~ compilation terminated.
编译报错1
这个问题有些奇怪，原本想改为单线程编译看下到底哪里出了问题，结果单线程编译反而能正常生成镜像，猜测应该是脚本编排的流程存在一些问题，导致并行编译时某些依赖文件尚未就绪。后来发现 issues#20 中也有人提到了这个现象。具体的修改位置在 build/envsetup_milkv.sh 文件中的 make all -j$(nproc)，改为 make all -j1 即可。
问题 2
报错信息（undefined reference to `pcm_read’）：
1 2 3 4 5 6
Run build_pqtool_server() function [riscv64-unknown-linux-musl-g++] cvi_streamer.o [riscv64-unknown-linux-musl-g++] main.o [riscv64-unknown-linux-musl-gcc] stream_porting.o /home/ronnie/code/duo-buildroot-sdk-v2/host-tools/gcc/riscv64-linux-musl-x86_64/bin/../lib/gcc/riscv64-unknown-linux-musl/10.2.0/../../../../riscv64-unknown-linux-musl/bin/ld: /home/ronnie/code/duo-buildroot-sdk-v2/cvi_mpi/lib/libcvi_audio.so: undefined reference to `pcm_read' /home/ronnie/code/duo-buildroot-sdk-v2/host-tools/gcc/riscv64-linux-musl-x86_64/bin/../lib/gcc/riscv64-unknown-linux-musl/10.2.0/../../../../riscv64-unknown-linux-musl/bin/ld: /home/ronnie/code/duo-buildroot-sdk-v2/cvi_mpi/lib/libcvi_audio.so: undefined reference to `pcm_open'
### 以下命令在 fdisk 交互界面中输入 p # 打印分区表，确认根分区的 Start 值 d # 删除分区 3 # 选择删除第 3 个分区 (根分区)
n # 新建分区 p # 主分区 (primary) 3 # 分区号 3 266241 # 起始扇区：必须与原来一致 <回车> # 结束扇区：直接回车使用默认最大值（占用所有剩余空间）
n # 保持分区类型 <回车> # 默认 ext4
w # 写入分区表并退出 ### fdisk 交互界面退出，回到 shell
# 扩展文件系统 resize2fs /dev/mmcblk0p3 # 查看扩展结果 df -hT
设置过程图示：
用fdisk扩容根分区
注意图中只展示了扩容分区的步骤，后续仍需要使用 resize2fs 命令扩展文件系统。
3 释放 ION 内存
Duo S 开发板上 Linux 成功启动后，发现内存只有 316M 可用（板载内存 512M），搜索了一下发现 SDK 中预留了一部分内存（170M）用作 ION 内存，用于 Multimedia buffer，应该是给 SoC 内部的多媒体处理模块用的。我对这部分功能不感兴趣，尝试修改配置将这部分内存释放出来。
在 SDK 中搜索到 build/boards/cv181x/sg2000_milkv_duos_musl_riscv64_sd/memmap.py 文件中定义了各部分内存的分配，直接将 ION 部分设置为 0，修改如下：
error: Bind to port 53156 on 192.168.50.219 faild: Cannot assign requested address. error: Bind to port 53156 on 192.168.70.219 faild: Cannot assign requested address.
SSH 启动失败
不过开机之后手动启动 SSH 是没有任何报错的：
手动启动 SSH 正常
经过排查启动失败的原因应该是 sshd 服务启动时间在 wg0 接口（WireGuard）启动之前，而我之前修改了 sshd 设置，从默认绑定的任意 IP（0.0.0.0）到具体的 IP（192.168.50.219，192.168.70.219），而此时还没有192.168.70.219这个 IP，导致了 sshd 启动失败。并且这种情况 sshd 退出的状态码是255，而sshd.service中使用参数RestartPreventExitStatus=255禁止在遇到这种状态码时自动重启。最终就导致了 sshd 绑定 IP 时遇到了未知的 IP 而异常退出，并且不再尝试重启。
network.target indicates that the network management stack has been started. Ordering after it has little meaning during start-up: whether any network interfaces are already configured when it is reached is not defined.
下载机只会在局域网（192.168.50.0/24）中与 NAS 和其他主机互传文件，所以这里只设置（192.168.50.0/24），此外使用 smbpasswd 命令修改密码时需要监听 localhost/127.0.0.1，127.0.0.1 也应当添加到接口列表。这里不能监听 lo 接口，因为 lo 接口包括 IPv6 的回环地址 ::1。
1 2 3 4
# 添加到 /etc/samba/smb.conf [global] 部分 bind interfaces only = yes # interfaces = lo 192.168.50.0/24 interfaces = 127.0.0.1 192.168.50.0/24
For file service it causes smbd(8) to bind only to the interface list given in the interfaces parameter. This restricts the networks that smbd will serve, to packets coming in on those interfaces. Note that you should not use this parameter for machines that are serving PPP or other intermittent or non-broadcast network interfaces as it will not cope with non-permanent interfaces.
在 Simple stateful firewall 中有过说明，设置不同的拒绝原因模仿了 Linux 的默认行为，同时明确告知对方通信被禁止而不是等待超时（DROP），有助于调试时清楚的知道连接请求失败的原因。
当然也可以全部改为 DROP，不明确拒绝，不回应直到请求发送方超时，隐藏本机开放的端口信息。
为什么没有开放 WireGuard 端口（WireGuard 使用 UDP）？
WireGuard 的确会监听接口配置文件中 [Interface] 部分中指定的端口，但是对于一个没有公网 IP 的 WireGuard 节点来说，其他节点是无法直接连接这个节点的，[Interface] 部分中的端口甚至可以不设置，接口启动时会监听一个随机端口，用于和中转服务器通信。
本机的 WireGuard 接口作为“客户端”，需要主动向暴露固定监听端口的服务端发送心跳包维持 WireGuard 隧道连接，所有的连接的 NEW 状态数据包都是本机主动发出，属于出站数据，不受到限制（OUTPUT ACCEPT）。服务器回应的数据包会被视为 ESTABLISHED 状态数据包直接被接收。
类似的，一般主机发出 DNS 请求（UDP:53，备用 TCP:53）时是 DNS 客户端，也完全不需要单独设置 DNS 请求的响应返回本机时的入站规则，对本机请求的回应入站时的状态是 ESTABLISHED，不会被阻止。（如果本机作为 DNS 服务器，才需要设置目标端口 53 的入站规则）。
#!/bin/bash # 指定保存备份文件的目录 BACKUP_DIR="$HOME/qbittorrent_backup" # 确保备份目录存在，不存在则创建 if [ ! -d "$BACKUP_DIR" ]; then mkdir -p "$BACKUP_DIR" fi # 需要备份的qBittorrent设置和数据目录 QBT_DATA_DIR="$HOME/.local/share/qBittorrent/BT_backup" QBT_CONFIG_DIR="$HOME/.config/qBittorrent" # 检查目录是否存在 if [ ! -d "$QBT_DATA_DIR" ] || [ ! -d "$QBT_CONFIG_DIR" ]; then echo"qBittorrent data or config directory does not exist." exit 1 fi # 获取当前时间戳 TIMESTAMP=$(date +%Y%m%d%H%M%S) # 备份，备份文件名添加备份时的时间戳 echo"Starting backup of qBittorrent settings and data..." tar -czf "$BACKUP_DIR/qbittorrent_data_${TIMESTAMP}.tar.gz" -C "$QBT_DATA_DIR" . tar -czf "$BACKUP_DIR/qbittorrent_config_${TIMESTAMP}.tar.gz" -C "$QBT_CONFIG_DIR" . echo"Backup completed successfully."
7 配置 SMB 共享
开始提到我还有一台 OpenWRT 软路由在使用中，给我的一些其他设备提供了一个局域网环境，主要是给一些不能直接连接校园网 WiFi 的物联网设备提供网络，也可以让其他局域网主机连接 NAS。这台下载机同样需要接入到路由器的局域网中，因为我需要用 Windows 主机查看下载的内容，也需要将值得收藏的资源传输到 NAS 中保存。
# 原配置文件中为yes，这里改为no； # 这个配置会影响后面创建文件和目录的权限设置，修改为no即可 obey pam restrictions = no
# 原配置文件中为yes，这里改为no； # 该配置允许共享在没有身份验证的情况下被访问，通常用于让网络中的任何人都能访问某些公开的资源，不需要输入用户名和密码 usershare allow guests = no
# 以下两条配置为新增配置，放在[global]部分最后即可 # 设置SMB协议版本不低于SMB3，设置前确保所有客户端都支持SMB3 server min protocol=SMB3 # 安全模式设置为user，要求连接的客户端提供有效的用户名和密码，实际上这是默认的安全模式，不设置这一条也可以 security=user
如果客户端挂载时出现连接问题，可以考虑删除server min protocol=SMB3试一下，我在用 NAS 挂载下载机的 SMB 共享时，NAS 上的 SMB 客户端就不支持 SMB3 协议。
然后处理[homes]、[printers]和[print$]，如果没有明确的理由需要使用这些功能，建议全部注释掉以关闭 home 目录的共享和打印机共享。我这里全部注释。
Libraries have been installed in: /usr/local/lib/../lib64
If you ever happen to want to link against installed libraries in a given directory, LIBDIR, you must either use libtool, and specify the full pathname of the library, or use the '-LLIBDIR' flag during linking and do at least one of the following: - add LIBDIR to the 'LD_LIBRARY_PATH' environment variable during execution - add LIBDIR to the 'LD_RUN_PATH' environment variable during linking - use the '-Wl,-rpath -Wl,LIBDIR' linker flag - have your system administrator add LIBDIR to '/etc/ld.so.conf'
See any operating system documentation about shared libraries for more information, such as the ld(1) and ld.so(8) manual pages.
测试确保控制程序auto_fan功能正常后，按照 Linux 系统中文件的组织习惯将其复制到/usr/bin目录。
1
sudocp auto_fan /usr/bin
3 设置控制程序自动启动
在树莓派中设置程序自动启动和一般 Linux 系统中的方法类似，如使用定时任务crontab的@reboot，将运行程序的命令写入rc.local等，这里使用systemd自定义系统服务的方法来实现自动启动控制程序。
3.1 创建系统服务
systemctl 的服务配置文件存放在目录/usr/lib/systemd中，有系统 system 和用户 user 之分，需要开机不登录就能运行的程序，存放在系统服务中即/usr/lib/systemd/system目录下。风扇控制程序应当创建为系统服务，在/usr/lib/systemd/system目录新建一个auto_fan.service配置文件，需要使用sudo，内容如下：
在初次创建 MySQL 数据库时，需要导入 waline.sql 创建初始的表结构，应当按照先后顺序分别创建 MySQL 容器和 Waline 容器。
如果想使用一个 docker-compose.yml 来管理两个容器，可以提前启动一个临时的数据库容器初始化表结构，然后删除这个临时容器，在 docker-compose.yml 中依次以相同配置启动 MySQL 容器和 Waline 容器，通过设置 depends_on 来规定启动顺序，但是 MySQL 初始化时间可能较长，可能会出现错误，参考 (No connections until MySQL init completes)，还可以使用 wait-for-it.sh 工具来让 Waline 容器等待 MySQL 容器（通过检查端口是否可用）就绪。
其他设置保持默认即可，这里使用在线安装 PlatformIO Core（由 IDE 插件自动安装），不需要指定customPATH；PIO Home 在浏览器中的使用体验要好于在 VSCode 中直接打开，这里禁止 PIO Home 在 VSCode 中自动打开，需要使用时在终端中运行pio home，在弹出的浏览器中使用 PIO Home 功能。
2.3 打开 PlatformIO IDE 插件
打开 PlatformIO IDE 插件，开始自动下载安装相关内容，此步骤耗时较长，代理配置正确且速度良好的情况下，大约需要 1~3 分钟。安装成功后提示重新加载或重启 VSCode。
新版本的 PlatformIO 不建议使用全局方式安装库，并且直接在 IDE 中删除了安装到全局库的功能。在 PIO Home 中搜索到需要的库，只能添加到当前的项目中，库文件存储路径位于.pio\libdeps\<env-name>目录中。
搜索需要的第三方库
将库添加到项目中
将库直接存放于项目目录中，虽然有利于项目之间保持隔离，也可以放心的对第三方库进行修改。但是对于不需要修改的库，每次新建项目都需要重新安装或者复制文件，或者在想要更新所有项目中的某个库时，便显得比较麻烦。目前 PIO Core（CLI）还保留着安装全局库的命令，全局安装的路径为globallib-dir，默认位置在core_dir/lib，已被标记为DEPRECATED。全局安装库的命令为：
1
pio lib -g install "bblanchon/ArduinoJson@^6.21.3"
Full Clean：删除编译产生的文件和库文件，删除后库文件会重新下载，如果对第三方库进行了修改，要慎用此功能。
5 一些问题与解决方法
1.编译出现CreateProcess: No such file or directory错误
在某次 Windows10 的安装中，安装后编译出现错误：
1 2
xtensa-esp32s3-elf-gcc: error: CreateProcess: No such file or directory *** [.pio\build\esp32-s3-devkitc-1\FrameworkArduino\esp32-hal-rgb-led.c.o] Error 1
反复点击编译，编译能够逐渐进行，出现类似的几次错误（每次在不同的文件上出现找不到文件）后能够编译完成，并且正确的下载到开发板上运行。尝试重新安装 VSCode，重新安装 PlatformIO IDE 插件，禁用除 PlatformIO IDE 和 C/C++ 插件以外的所有插件，重新安装 PlatformIO Core，重新下载开发平台工具包，修改 Core 目录（包括不同分区），修改项目目录（包括不同分区），以及搜索到的有关于命令长度超出 Windows 限制的相关 issues 中提及的方法，均不能修复这一问题。以相同步骤在相同版本的 Windows10 的虚拟机中再次安装，一切运行正常。此问题尚未找到原因，也未解决。
ssh -T git@user_aaa.github.com # "Hi user_aaa! You've successfully authenticated, but GitHub does not provide shell access." ssh -T git@user_bbb.github.com # "Hi user_bbb! You've successfully authenticated, but GitHub does not provide shell access." # 连接出现问题时，使用 -v 参数进入调试模式，显示详细的连接过程 ssh -v git@user_bbb.github.com
