进迭社区双周报（2026年3月）

beautiful_doggie · 2026 年4 月 7 日 07:19

进迭社区双周报

一. 开发者常见问题

1. 已解决问题

问题类型
硬件相关
软件与系统
开发与工具链
AI 与模型
文档与资料

硬件相关

【问题】SpacemiT K1 (Ky X1) get TLB entries
I’m trying to run proprietary Operating System on OrangePi RV2. I flash all TLB entries via sfence.vma x0, x0. After that I allocate some numbers of virtual address (VA) range without TLB flush, because these VA is not used before, I catched exception that allocated VAs not allocated, but it is not true. If I set TLB flush before the access the allocated VA, all works fine. Why? How can I read TLB entries on SpacemiT K1 (Ky X1) for ensures that TLB contain correct mapping?
【回答】RISC-V specification confirmed, that CPU can fill TLB speculatively. So, after update PTE sfence.vma always should be executed
Untitled :: RISC-V Ratified Specifications Library.

【问题】是否能提供下musecard板卡的硬件驱动寄存器手册，支持开发。例如网卡驱动的，这个网卡应该是自研的ip核吧
【回答】SpacemiT
可以在这个用户手册下查找相关模块，例如网卡的寄存器说明在16.3 节

【问题】how to switch root user in the cloud? it is annoying to install anything.
【回答】Enter the command sudo su, the password is bianbu.

【问题】MUSE Pi PRO 开机按F2无法进入UEFI
【回答】需要刷uefi启动的镜像，你现在用的是uboot启动的镜像吗？
这是uefi启动的镜像链接：Index of /image/k1/version/bianbu-computer-uefi/v1.3
以 *.img.zip 结尾，可以用balenaEtcher写入sdcard，或者解压后用dd命令写入sdcard。
自定义镜像以 .zip 结尾，可以用Titan Flasher刷机，或者解压后用fastboot刷机。

【问题】为什么扫phy扫不到设备，是没有内置phy芯片吗？用这些代码去读的，从0到31号的phy扫描出来的data1和data2全部都是0，MII-PHY-ID1-REG是第2号寄存器，MII-PHY-ID2-REG是3号寄存器
【回答】gmac的phy芯片用的是瑞昱的RTL8211F，正常情况下是可以直接使用的。我注意到这个接口有前缀synop，是不是混用了synopsis gmac控制器访问phy reg的方法，MUSE Card的gmac控制器并非synopsis的，访问phy reg的方法参考文件k1x_emac.c中的注意k1 gmac是自研IP，和市面上gmac都存在一定差异。比如看你反馈的图片有一个轮询GB位的操作，K1就没有这个bit位。如果使用的是K1自带的GMAC，建议严格按照K1 GMAC驱动文件来重新编写。

【问题】请问e4000000是定时器地址吗？我在fdt打印中看见clint打印是e4000000，但是读的值全是全f，请问是有问题吗，我想通过实现定时器驱动进行任务调度。
【回答】Hi 0XE4000000是定时器得基地址(Clint)，对应内核里面得驱动为drivers/clocksource/timer-clint.c，但是我们没有使用这个驱动，因此相当于dts节点里面得clint节点是无效得，我们使用得是drivers/clocksource/timer-riscv.c；通过直接读CSR_TIME寄存器得方式来实现调度定时器得功能；如果要实现调度定时器得功能，请参考drivers/clocksource/timer-riscv.c

【问题】I download the pcb file, however, I couldn’t open the file with any PCB viewer like Altium 365 viewer online or import it to KiCAD. What software could I use to open/review the PCB file? Is there any change to have a gerber file or any other format I could open/import with KiCAD or online viewer?
【回答】the PCB layout files have been made in PADS. (.pcb file)
you can use PADS to open the PCB file or convert it to AD

软件与系统

【问题】在orangepi RV2板子上启动bianbu linux失败，很好奇RV2能否使用bianbu linux，于是尝试将bianbu 3.0.1 linux镜像写入MicroSD卡，同时把RV2板子的dts文件放到bianbu linux源码目录重新编译出dtb放入了MicroSD卡。最后把MicroSD插入RV2上电，卡在fdt那里了，大家有知道还需要修改哪里吗？
【回答】终于启动成功了，调整了u-boot的启动脚本。后续需要把这些固化下来，现在每次都是手动在串口终端手动修改u-boot脚本才能启动。

【问题】bianbu-minimal怎么连wifi
【回答】apt install -y spacemit-modules-usrload wpasupplicant然后编辑网络配置文件/etc/netplan/01-netcfg.yaml

【问题】请问OrangePi RV2可以运行Bianbu OS吗？
【回答】bianbu os没有默认支持orangepirv2，你可以试试将bianbu os的dts换成rv2的，自己跑一下试试

【问题】请问K3的A100核心现在有办法调用吗
【回答】ps看下当前bash的pid 然后echo $pid > /proc/set_ai_thread直接把bash绑过去，后面这个bash启动的程序就都是a100了

【问题】所以K3的ONNXRuntime EP是还没有放出来吗
【回答】放出来了，sudo apt update就可以安装了

【问题】BianbuClound download model，这个网站，下载模型，但是网络不可达
【回答】可以本地下载，再ssh传上去

【问题】K1 TCM驱动崩溃，K1的TCM对单次申请的空间大小是否有尺寸要求？当我先申请32KB并释放，再申请512KB空间时，会稳定触发一个Oops。假如我先申请的是64KB或128KB，则不会产生这个问题。
【回答】出错的直接原因是alloc的size非tcm的block size，k1的tcm block size是128KB，建议使用aimm_tcm_malloc，如果确实有需求要申请其他的size，可以更改下驱动drivers/misc/tcm.c

【问题】Am I correct in understanding that RVA23 is not compatible with RVA22, and therefore operating systems like Ubuntu 25.10 and 26.04 for RISCV64 only support the RVA23 profile? Does this mean that operating systems like Bianbu 2.2.1 and earlier, which support the RVA22 profile, should no longer receive software updates to the latest versions?
【回答】We will continue to enhance the competitiveness of the K1 product. Our current plan is to provide long-term maintenance for the Bianbu system based on Ubuntu 24.04. We will release system updates when customers encounter issues, when upstream updates become available, or when new features are introduced. Code compliant with RVA22 can run on the K3 platform, which supports RVA23; however, Ubuntu 26.04 (built for RVA23) cannot run on the K1 platform, which only supports RVA22.
If there isn’t significant customer demand, the K3 will only support Ubuntu 26.04 and later versions, while the K1 will be maintained long-term based on Ubuntu 24.04.

【问题】Documentation for Bianbu Star has disappeared.
【回答】Since Bianbu 2.3, Bianbu Star is now maintained as part of the Bianbu LXQt product line. To avoid confusion for developers, we have removed all Bianbu Star documentation. If you still need to use firmware prior to Bianbu 2.3, we can send you the documentation, but we recommend using the latest Bianbu LXQt image.
bianbu-star-docs/en at main · spacemit-com/bianbu-star-docs · GitHub

【问题】K1 pi pro烧写OpenHarmony后是否支持pcie和USB？在现有文档中，没有找到对应的鸿蒙下的驱动
【回答】支持usb，不支持pcie
SpacemiT

【问题】请问pypi包vllm-0.11.0.post3+spacemit.0.cpu 的源代码在何处查看
【回答】暂未开源，过段时间后才会对外开放源码

【问题】在WSL上对bianbu-linux6.6内核代码进行交叉编译后得到了.deb包，然后copy到K1开发版上进行内核的更新。bianbu-esos (= 0.0.10)应该怎么升级？
【回答】I encountered a similar issue when upgrading the kernel from version 6.6.63 to version 6.6.77. I can assure you that if bianbu-esos requires an update, your kernel isn’t built correctly.

【问题】欧拉官网源码还没有支持muse pipro?
【回答】rvck/arch/riscv/boot/dts/spacemit at rvck-6.6 · RVCK-Project/rvck · GitHub

开发与工具链

【问题】我在macbook 上刚安装的 OpenClaw 2026.2.21-2，版本用的是 Node.js v25.6.0，你们这里指定必须是node.js v20 版本，有啥特殊原因吗？
【回答】目前对 Node.js 版本有特定要求

【问题】K3 有没有可能只使用 A100 核心？把 X100 设置为 linux kernel 不可见，这样完整使用 VLEN 1024 的 AI 核心，跑 HPC 等向量密集型运算。在转交给kernel的 DTB 中，把 X100 核心去掉，只留下 8个 A100 cpu，可行否？
【回答】从SoC硬件架构角度及软件角度，技术上是可行的

【问题】spacemit K1全面支持rvv1.0吗？例如vrgather指令，我这边显示非法指令。如果不支持的话，那么spacemiT K3支持不？
【回答】K1支持的。

root@K1:~# gcc -march=rv64gcv -o vrgather_test vrgather_test.c
root@K1:~# objdump -d vrgather_test | grep "vrgather\.v"
     930:       32008157                vrgather.vv     v2,v0,v1
     ae8:       3206c0d7                vrgather.vx     v1,v0,a3
     c96:       320130d7                vrgather.vi     v1,v0,2
root@K1:~# ./vrgather_test
=== RVV 1.0 vrgather 指令测试 ===
[vrgather.vv]  PASS
[vrgather.vx]  PASS
[vrgather.vi]  PASS
[vrgatherei16] PASS
结果: 4 / 4 通过

【问题】请问spacemit维护的gcc和llvm分支，能在通用代码中检测到矩阵相乘然后自动生成IME扩展指令进行优化吗？
【回答】不能，目前是要靠手写的

【问题】K1 云开发板是否支持手写 RVV intrinsics 指令
【回答】支持的，这个主要看编译器版本，gcc-13和gcc-14的intrinsic支持我记得是有点区别，建议用gcc-14

【问题】询问一下你用的是什么系统，gcc版本是多少，我尝试汇编写vslideup指令报错，我的是Bianbu 2.1.2，gcc试过13和14都不行
【回答】gcc应该13和14都能支持的

【问题】I’d still like to understand the requirements for creating deb packages, what information is required (licenses, vendors, etc.), and how to properly build packages for bianbu 2.2.1?
【回答】For comprehensive knowledge about Debian packaging, please refer to the official Debian Maintainer Guide (Debian New Maintainers' Guide). This documentation covers essential topics including debian/control, debian/rules, debian/changelog, and the complete build workflow.
The significant size difference you observed (1.01 GB vs 529 KB) strongly suggests the official package uses split packaging and debug symbol stripping, whereas your fpm-built package likely bundles everything monolithically with full debug info.
You can try to reduce the number of compilation threads by using dpkg-buildpackage -us -uc -b -j4.

【问题】I built the gcc-15.2.0 deb package for Bianbu 2.2.1 and Debian. The gcc-15.2.0 deb package I built weighs 1.01 GB, which is a bit confusing. Meanwhile, gcc-14_14.2.0-19_riscv64.deb from the repository is only 529,260 bytes. Perhaps I did something wrong during the compilation process.
【回答】Could you provide the specific error information?

AI 与模型

【问题】想问一下如果我想测大概2-3B大小的qwen vl模型，有哪里可以下载模型和模型的视觉投影器呢？在K3上面
【回答】sudo apt install llama-server

【问题】Qwen2.5-VL-3B 想问一下有这个模型的K3官方版本吗？或者 Qwen3-VL-2B / 4B
【回答】https://huggingface.co/unsloth/Qwen2.5-VL-3B-Instruct-GGUF/tree/main 这里4bit量化的都可以

【问题】K3支持qwen3-asr和funasr-nano-2512吗？官方有qwen3-asr和funasr-nano-2512的测试数据吗？性能怎么样？
【回答】我用 biabucloud k3 测了 funasr-nano-2512，你想知道什么性能数据？

【问题】SmolVLM模型下载链接失效，这两个链接现在在哪里可以下载
【回答】https://archive.spacemit.com/spacemit-ai/model_zoo/vlm/mmproj-SmolVLM-256M-Instruct-Q8_0.gguf
https://archive.spacemit.com/spacemit-ai/model_zoo/vlm/SmolVLM-256M-Instruct-f16.gguf

【问题】pip install spacemit_ort 报错，应该换成什么镜像啊
【回答】看你的目录结构有D盘，好像是在x86上安装软件，请确保相关操作是在K1 MUSE Pi Pro上进行，可以使用我们的镜像（https://archive.spacemit.com/image/k1/version/bianbu-computer/v2.1.7/bianbu-computer-s1_v2.1.7.zip）；另外可以找向你提供这个文档的销售同事寻求一对一的支持

【问题】使用Python包管理器pip安装python版本onnxruntime，运行pip install --index-url https://git.spacemit.com/api/v4/projects/33/packages/pypi/simple spacemit-ort --break-system-packages 出现报错：ERROR: Could not find a version that satisfies the requirement spacemit_ort
【回答】该教程是基于MUSE Pi Pro Bianbu 2.1.x版本制作，python版本为3.12；如果只是下载该python包，python为3.11/3.12都可以；如果需要使用该教程，请确保你的python版本是3.12且烧录的是我们对外的Bianbu 2.1.x镜像

文档与资料

【问题】你们K3的资料什么时候会放上去，现在硬件资料还是空的
【回答】K3完整的参考设计及SDK资料将在5月份开始逐步释放，因为K3平台还在紧张的验证和调试优化过程，我们会在硬件验证完第一时间释放参考资料，生态硬件Pico-ITX计划四月底启动销售，也可以期待下

【问题】官方 k1 的最小核心板有没有卖的
【回答】https://item.taobao.com/item.htm?id=912348619378

【问题】载板是怎样的，有没有资料
【回答】B1资料

【问题】k1 现在 armbian 的版本号是多少？
【回答】https://www.armbian.com/muse-pi-pro/

2. 未解决问题

【问题】https://learn.spacemit.com/auth 学习套件怎么还有秘钥呢

【问题】飞书和openclaw交流信息多了，飞书就会报下面这个错误，需要手动停openclaw清理缓存才能解决，请问有一劳永逸的方法吗？
HTTP 400: <400> InternalError.Algo.InvalidParameter: Range of input length should be [1, 983616]

【问题】K3 Pico-ITX jtag 如何使用，另外在哪里购买？

【问题】发现系统启动后，只要在图形界面登陆进系统，就出现2个进程占用/dev/tcm，这两个进程kill之后，又会自动启动，请问如何彻底关闭呢

【问题】我想要通过手写汇编手动的控制数据的读写，把scratchpad作为一个手动控制的快于cache的空间，来提升load/store的速度，我该怎么做

【问题】K1,我好像也遇到了这样的问题，我在bianbu下手写汇编，使用了vslideup指令，结果报非法指令错误，我查询了标准确认指令写的没问题，这个指令不是rvv1.0标准里的吗？芯片上也明确写了支持rvv1.0标准所有指令。

【问题】下载OpenHarmony-v5.0.0-Release时，提示stdout: [session-1c4860be] Auth error: You hasn’t joined this enterprise!

【问题】K1 MUSE Pi Pro烧写OpenHarmony后测试外接USB摄像头一直黑屏

【问题】It’s strange that the model running on these boards, despite using spacemit-ollama-toolkits, doesn’t know about Spacemit and the X60 and X100 cores they’re developing, nor about processors based on the X60, K1, and M1 cores.

【问题】ov5647无法采集图片

二. 优秀案例

【案例】K3 Chip & Board–Product Brief & 芯片及生态硬件介绍
K3的大CPU和大算力能够应付多种端侧AI（Agent）需求，K3大卖！

【案例】Official Armbian OS support We’re pleased to announce that Armbian now provides official (and Platinum) support for the MusePi Pro.

【案例】BianbuCloud安装iFlow CLI终端AI助手 iFlow CLI 是一款终端AI助手，可以分析代码、执行编程任务、处理文件操作。iFlow CLI的安装指南中的脚本在RV系统上运行会出错，探索出了适用于BianbuCloud的安装脚本，供大家参考。

【案例】[论文] SpacemiT K3: A RVA23 RISC-V AI CPU with 60 TOPS AI Compute
K3 论文先导版发布，详细介绍了 X100、A100 以及整个 K3 的设计思想，论文持续更新中。感谢 RISC-V 开放生态，K3 中使用了大量 RISC-V 社区开源资源。

【案例】K1 IME GEMM的Roofline Model
社区开发者创建项目，使用 Roofline Model 测量 K1 上 IME 加速 GEMM 的效率，并开源至 Gitee，持续更新优化结果。

【案例】Release Plan for K3 Reference Design and SDK
K3 平台完整参考设计及 SDK 将于 2026 年 5 月起逐步释放，生态硬件 K3 Pico-ITX 和 K3 CoM260 Kit 计划 4 月 30 日开始全球销售。

【案例】K3 系列硬件使用指南（K3 Pico-ITX）
K3 Pico-ITX 用户使用指南发布，涵盖产品简介、硬件描述、接口说明、产品规格、安装操作系统及快速上手等完整内容。