Table of Contents
Published: 2026-10-09 · Category: RISC-V Datacenter · Reading time: ~4 min
Honesty note. This is a devicetree pull request targeted at Linux 7.4, not merged mainline content at posting time, and every number here comes from the pull request body itself. The PR contains no benchmarks, no clock frequencies, no OPP tables, no thermal trip points and no power numbers — none were added. The Debian K3 Pico-ITX fan/reboot caveat is a wiki observation used as motivation, not a kernel claim.
What landed in the pull request
On 7 October 2026 (Wed Oct 7 18:20:40 PDT 2026), Yixun Lan sent "[GIT PULL] RISC-V SpacemiT Devicetrees for v7.4" to the SoC maintainers. The tag is spacemit-dt-for-7.4-1 from git.kernel.org/pub/scm/linux/kernel/git/spacemit/linux.git, based on Linux 7.3-rc1 (2026-08-30) and topping out at merge commit d5eefaf546eb83f98206137a5784b6b8510e4fe5 (2026-10-06 11:51:34 +0000).
The pull touches 14 files, 571 insertions and 56 deletions, spread across 28 commits from twelve contributors. In the maintainer's own summary, the K3 side gets corrected CLINT/ACLINT, USB node info, CPU scaling, an rfkill node, I2S info, an IMSIC fix and thermal plus fan control; the K1 side gets onboard EEPROM and a MAC address sourced from it.
For anyone running a K3 Pico-ITX or CoM260, this is the most consequential SpacemiT devicetree drop in several cycles — not because any single item is exotic, but because CPU scaling and fan control are the two things that decide whether the board is usable as a small server rather than a demo.
K3: replacing a wrong CLINT node with real ACLINT nodes
The largest single chunk is Junhui Liu's seven-patch sequence. The K3 devicetree previously described a SiFive CLINT; the series removes spacemit,k3-clint from sifive,clint.yaml and instead adds SpacemiT K3 to the T-Head C900 ACLINT bindings — thead,c900-aclint-mtimer, thead,c900-aclint-mswi and thead,c900-aclint-sswi — plus a one-line addition to drivers/irqchip/irq-aclint-sswi.c. The SoC's own k3.dtsi grows by 229 lines in this pull, most of it here.
Two smaller IMSIC corrections come with it: GUO Ren (XuanTie) fixes num-guest-ids, and Liu drops guest properties from the M-level IMSIC. This is unglamorous work, but timer and IPI wiring is exactly the class of bug that produces intermittent hangs rather than a clean boot failure.
K3: CPU scaling, and thermal and fan control
Troy Mitchell contributes four patches, including riscv: dts: spacemit: Add CTF2301 on K3 CoM260. That commit is what turns on thermal and fan control for the CoM260 system-on-module.
The practical stakes are documented outside the kernel tree: Debian's installation notes for the K3 Pico-ITX warn that a reboot that stalls at "Restarting system" can leave the SoC with no running fan, with the page explicitly flagging hardware damage as a risk. Devicetree-driven fan control does not by itself fix a stalled reboot, but it is the piece that lets a mainline kernel manage thermals instead of relying on vendor firmware.
CPU scaling is contributed per-board by three different people: Andre Heider (k1-musepi-pro), Jonatan Hazell (k1-orangepi-r2s) and Vincent Legoll (k1-orangepi-rv2). Note the naming — despite the k1- file prefixes, the maintainer summary attributes Muse Pi Pro, Orange Pi R2S and Orange Pi RV2 scaling to the K1 SoC, while the K3-specific items sit in the K3 block.
K3: USB, rfkill and I2S
Aurelien Jarno moves the USB3 PHY to board level and adds USB3 B and C controllers for the Pico-ITX, then adds rfkill nodes for Bluetooth and WLAN on the same board. Jennifer Berringer duplicates that pattern for the k3-com260-ifx variant (77 new lines), and also sets the console baud rate on OrangePi RV2.
Troy Mitchell adds i2s0 through i2s5 nodes and a K3 I2C6 pinctrl state; James Morris keeps dldo4 enabled on the CoM260. A usable I2S node set matters if the K3 is being evaluated as a headless appliance with audio rather than as a plain compute module.
K1: EEPROM and a stable MAC address
The K1 half is small but removes a genuinely annoying failure mode. Chukun Pan sorts nodes on OrangePi RV2, enables the onboard EEPROM, and sets the Ethernet MAC from that EEPROM. Without it, boards tend to come up with a random MAC on every boot, which breaks DHCP reservations, static inventory and anything doing certificate-pinned provisioning.
Guodong Xu adds a MAINTAINERS entry for the SpacemiT reset controller driver, and Troy Mitchell adds himself as a SpacemiT SoC reviewer.
What is not disclosed
The pull request contains no benchmarks, no clock frequencies, no OPP tables in the summary text, no thermal trip points and no power numbers. Nothing here states which cpufreq governor or which scaling driver is used, nor what the CTF2301 is wired to. Phoronix covered the same pull and reported the same feature list — its description is consistent with the maintainer's summary, but it is a secondary retelling, not an independent measurement.
Sources
- linux-riscv, Yixun Lan, [GIT PULL] RISC-V SpacemiT Devicetrees for v7.4, 7 Oct 2026 — https://lists.infradead.org/pipermail/linux-riscv/2026-October/100907.html
- linux-riscv October 2026 archive index (full thread and per-patch messages) — https://lists.infradead.org/pipermail/linux-riscv/2026-October/date.html
- Phoronix (via KhanList mirror), SpacemiT RISC-V SoCs To See More Improvements With Linux 7.4 — https://www.khanlist.com/story/spacemit-risc-v-socs-to-see-more-improvements-with-linux-74-6e99c741
- Debian wiki, InstallingDebianOn/SpacemiT/K3PicoITX (reboot and fan caveat) — https://www.worldprogramming.org/posts/installingdebianonspacemitk3picoitx-pxfuue
Verification notes
- Every number (14 files, 571 insertions, 56 deletions, 28 commits, commit counts per author,
k3.dtsi+229,k3-com260-ifx.dts+77, base commit and timestamps) is read directly from the pull request body on the linux-riscv archive, not from secondary coverage. - "28 commits" is my count of the per-author tallies listed in the pull request (1+4+3+1+1+1+3+1+7+4+1+1). The pull request itself does not print a total.
- The Debian K3 Pico-ITX fan/reboot caveat comes from a Debian wiki mirror page, not from SpacemiT or from the kernel. It is used only as motivation for why fan control matters; the causal claim is the wiki's, not mine.
- Category note: this is filed under Datacenter because the affected boards (K3 Pico-ITX, CoM260) and the features (CPU scaling, thermal management, wired MAC for inventory) are server/appliance concerns. There is no GHz, core-count or TOPS figure anywhere in the source, and none was added.
- Political-neutrality check: framed around upstream kernel process and multi-vendor board support. No national-sourcing or self-sufficiency framing was introduced.
诚实说明。这是一份面向 Linux 7.4 的 devicetree 拉取请求，发布时尚未合入主线；文中所有数字均直接取自拉取请求正文。PR 本身不含任何基准测试、时钟频率、OPP 表、热 trip 点或功耗数字，本文也未添加。Debian K3 Pico-ITX 的重启风扇告警来自 wiki 观察，仅作为动机说明，不是内核层面的结论。
拉取请求里有什么
2026 年 10 月 7 日（Wed Oct 7 18:20:40 PDT 2026），Yixun Lan 向 SoC 维护者发送了 "[GIT PULL] RISC-V SpacemiT Devicetrees for v7.4"。标签为 spacemit-dt-for-7.4-1，来自 git.kernel.org/pub/scm/linux/kernel/git/spacemit/linux.git，基于 Linux 7.3-rc1（2026-08-30），顶部合并提交为 d5eefaf546eb83f98206137a5784b6b8510e4fe5（2026-10-06 11:51:34 +0000）。
本次拉取涉及 14 个文件、571 行新增、56 行删除，来自十二位贡献者的 28 个提交。按维护者自己的总结：K3 侧获得修正的 CLINT/ACLINT、USB 节点信息、CPU 调频、rfkill 节点、I2S 信息、IMSIC 修复以及热管理与风扇控制；K1 侧获得板载 EEPROM 及由它提供的 MAC 地址。
对运行 K3 Pico-ITX 或 CoM260 的用户来说，这是近几个周期最重要的 SpacemiT devicetree 更新——不是因为某个单项有多特别，而是因为 CPU 调频和风扇控制恰恰决定了一块板子是能当小型服务器用，还是只能当演示品。
K3：用真正的 ACLINT 节点替换错误的 CLINT 节点
最大的一块来自 Junhui Liu 的七补丁序列。K3 devicetree 此前描述的是 SiFive CLINT；该系列从 sifive,clint.yaml 中移除 spacemit,k3-clint，改为将 SpacemiT K3 加入 T-Head C900 ACLINT 绑定——thead,c900-aclint-mtimer、thead,c900-aclint-mswi 与 thead,c900-aclint-sswi——并在 drivers/irqchip/irq-aclint-sswi.c 中加了一行。SoC 级的 k3.dtsi 在本次拉取中增长 229 行，大部分在此。
同时还有两处小的 IMSIC 修正：GUO Ren（玄铁）修复 num-guest-ids，Liu 从 M 级 IMSIC 中去掉 guest 属性。这类工作不起眼，但定时器和 IPI 接线出错的表现恰恰是偶发挂死而非干净的启动失败。
K3：CPU 调频与热管理/风扇控制
Troy Mitchell 贡献四个补丁，其中包括 riscv: dts: spacemit: Add CTF2301 on K3 CoM260。正是这个提交为 CoM260 系统级模块打开了热管理与风扇控制。
实际风险在内核树之外有据可查：Debian 的 K3 Pico-ITX 安装说明警告，卡在 "Restarting system" 的重启会让 SoC 风扇停转，页面明确标注有硬件损坏风险。devicetree 驱动的风扇控制本身不解决卡死的重启，但它让主线内核能自行管理热状态，而不是依赖厂商固件。
CPU 调频由三位贡献者按板卡分别提交：Andre Heider（k1-musepi-pro）、Jonatan Hazell（k1-orangepi-r2s）与 Vincent Legoll（k1-orangepi-rv2）。注意命名——尽管文件前缀是 k1-，维护者总结将 Muse Pi Pro、Orange Pi R2S 与 Orange Pi RV2 的调频归入 K1 SoC，而 K3 专属条目放在 K3 块中。
K3：USB、rfkill 与 I2S
Aurelien Jarno 将 USB3 PHY 移到板级，并为 Pico-ITX 添加 USB3 B/C 两个控制器，随后在同一板卡上为蓝牙与 WLAN 添加 rfkill 节点。Jennifer Berringer 为 k3-com260-ifx 变体复制了同样的模式（新增 77 行），并为 OrangePi RV2 设置了控制台波特率。
Troy Mitchell 添加 i2s0 至 i2s5 节点及 K3 I2C6 pinctrl 状态；James Morris 在 CoM260 上保持 dldo4 使能。一套可用的 I2S 节点对把 K3 当作带音频的无头设备评估（而非纯计算模块）的场景很重要。
K1：EEPROM 与稳定的 MAC 地址
K1 部分体量小，但消除了一个真正恼人的故障模式。Chukun Pan 整理了 OrangePi RV2 的节点排序，启用板载 EEPROM，并从 EEPROM 读取以太网 MAC。没有它，板子每次启动会拿到随机 MAC，破坏 DHCP 保留、静态资产清单以及任何做证书绑定预配置的流程。
Guodong Xu 为 SpacemiT reset 控制器驱动添加 MAINTAINERS 条目；Troy Mitchell 将自己登记为 SpacemiT SoC reviewer。
未披露的信息
拉取请求中没有基准测试、没有时钟频率、总结文本没有 OPP 表、没有热 trip 点、没有功耗数字。没有任何内容说明使用哪个 cpufreq governor 或哪个调频驱动，也没有说明 CTF2301 接在哪里。Phoronix 报道了同一拉取并给出相同的特性清单——其描述与维护者总结一致，但属于二手转述，不是独立测量。
来源
- linux-riscv，Yixun Lan，[GIT PULL] RISC-V SpacemiT Devicetrees for v7.4，2026-10-07 — https://lists.infradead.org/pipermail/linux-riscv/2026-October/100907.html
- linux-riscv 2026 年 10 月归档索引（完整线程与逐补丁消息）— https://lists.infradead.org/pipermail/linux-riscv/2026-October/date.html
- Phoronix（经 KhanList 镜像），SpacemiT RISC-V SoCs To See More Improvements With Linux 7.4 — https://www.khanlist.com/story/spacemit-risc-v-socs-to-see-more-improvements-with-linux-74-6e99c741
- Debian wiki，InstallingDebianOn/SpacemiT/K3PicoITX（重启与风扇告警）— https://www.worldprogramming.org/posts/installingdebianonspacemitk3picoitx-pxfuue
Devicetree-обновления SpacemiT K1 и K3 для Linux 7.4
7 октября 2026 Яксун Лан (Yixun Lan) отправил [GIT PULL] RISC-V SpacemiT Devicetrees for v7.4: 14 файлов, 571 добавление, 56 удалений, 28 коммитов от двенадцати авторов. Для K3: исправление CLINT на настоящие узлы ACLINT (T-Head C900), масштабирование частоты CPU, тепловая система и управление вентилятором CTF2301 на CoM260, USB3, rfkill и I2S. Для K1: включение EEPROM и стабильный MAC-адрес для OrangePi RV2. В запросе нет бенчмарков, частот, OPP-таблиц или цифр энергопотребления.
Devicetrees de SpacemiT K1 y K3 para Linux 7.4
El 7 de octubre de 2026, Yixun Lan envió [GIT PULL] RISC-V SpacemiT Devicetrees for v7.4: 14 archivos, 571 inserciones, 56 eliminaciones y 28 commits de doce autores. Para el K3: corrección de CLINT por nodos ACLINT reales (T-Head C900), escalado de CPU, control térmico y de ventilador CTF2301 en el CoM260, USB3, rfkill e I2S. Para el K1: EEPROM a bordo y dirección MAC estable en OrangePi RV2. La petición no incluye benchmarks, frecuencias, tablas OPP ni cifras de consumo.
Devicetrees SpacemiT K1 et K3 pour Linux 7.4
Le 7 octobre 2026, Yixun Lan a envoyé [GIT PULL] RISC-V SpacemiT Devicetrees for v7.4 : 14 fichiers, 571 insertions, 56 suppressions, 28 commits de douze auteurs. Pour le K3 : correction du CLINT en véritables nœuds ACLINT (T-Head C900), scaling CPU, gestion thermique et ventilation CTF2301 sur le CoM260, USB3, rfkill et I2S. Pour le K1 : EEPROM embarquée et adresse MAC stable sur l’OrangePi RV2. La demande ne contient aucun benchmark, fréquence, table OPP ni chiffre de consommation.
SpacemiT-K1- und K3-Devicetrees für Linux 7.4
Am 7. Oktober 2026 sandte Yixun Lan [GIT PULL] RISC-V SpacemiT Devicetrees for v7.4: 14 Dateien, 571 Einfügungen, 56 Löschungen, 28 Commits von zwölf Autoren. Für den K3: Korrektur von CLINT zu echten ACLINT-Knoten (T-Head C900), CPU-Skalierung, Thermik- und Lüftersteuerung CTF2301 auf dem CoM260, USB3, rfkill und I2S. Für den K1: Onboard-EEPROM und stabile MAC-Adresse auf dem OrangePi RV2. Der Pull enthält keine Benchmarks, Taktraten, OPP-Tabellen oder Leistungsdaten.
دیوایستریهای SpacemiT K1 و K3 برای لینوکس 7.4
در ۷ اکتبر ۲۰۲۶، یکسون لان [GIT PULL] RISC-V SpacemiT Devicetrees for v7.4 را ارسال کرد: ۱۴ فایل، ۵۷۱ خط افزوده، ۵۶ خط حذفشده، ۲۸ کامیت از دوازده مشارکتکننده. برای K3: اصلاح CLINT به گرههای واقعی ACLINT (T-Head C900)، مقیاسپذیری فرکانس CPU، مدیریت حرارتی و کنترل فن CTF2301 روی CoM260، USB3، rfkill و I2S. برای K1: EEPROM داخلی و MAC آدرس پایدار روی OrangePi RV2. این درخواست هیچ بنچمارک، فرکانس، جدول OPP یا عدد مصرفی ندارد.