Two DPUs, Two PHYs, One Ceiling: SpacemiT’s K3 Gets a Mainline Display Path
Until this weekend, the SpacemiT K3 was a fast RISC-V SoC with no display output in mainline Linux. Boards booted to a serial console, and everything that drew pixels came from a vendor tree. On 21 November 2026, Cody Kang posted version 3 of the K3 display series: 17 patches, 40 files, +7,680 / −3 lines, containing a brand-new DRM driver, a brand-new PHY driver and three new devicetree bindings. It is the largest single platform-enablement series to land on linux-riscv this month, and the first one that gives the K3 a plausible path from console to DisplayPort.
None of it is merged. The series is state New on patchwork and was rebased onto v7.4-rc1 two days ago. But v2 already shipped in a shipping distribution kernel — more on that below — which is why this one is worth reading carefully rather than skimming the subject line.
Three blocks, four nodes, two outputs
The display path is three blocks deep, and the cover letter draws it in one line:
Saturn DPU -> Innosilicon DP/eDP controller -> Innosilicon DP PHY
The devicetree patch turns that into four nodes. The K3 has two independent Saturn DPU instances, and each is wired to its own output controller — DPU0 to an eDP controller, DPU1 to a DisplayPort controller:
| Node | Address / IRQ | Clocks and resets | Wired to |
|---|---|---|---|
dpu0 (spacemit,k3-saturn-dpu) | 0xc0340000, span 0x54000IRQ 90 online / 89 offline | LCD_PXCLK, LCD_MCLK, DPU_ACLK, DSI_ESC, LCD_DSC — 5 clocks, 5 resets, all from syscon_apmu | port@0 → edp0_in |
dpu1 (spacemit,k3-saturn-dpu) | 0xc0440000, span 0x54000IRQ 139 online / 138 offline | DSI4LN2_* variants of the same five | port@0 → dp1_in |
edp0 (spacemit,k3-inno-dp) | 0xcac84000, 0x4000IRQ 132 | EDP0_PXCLK + pll from its PHY child | port@1 left open for the board |
dp1 (spacemit,k3-inno-dp) | 0xcac88000, 0x4000IRQ 140 | EDP1_PXCLK + pll from its PHY child | port@1 left open for the board |
Two details in that table are worth pausing on. First, every DPU carries a DSI escape clock and a DSC clock — the silicon clearly has MIPI DSI and display stream compression legs — but this series does not implement either, so they are named and unused. Second, the PHY does not just receive a clock, it produces one: each PHY child is a #clock-cells = <0> provider whose PLL output feeds back into the APMU as a pixel-clock mux parent. The devicetree patch states the consequence bluntly: on DP and eDP, the PHY PLL is the pixel clock, and the DPU’s own pixel clock is left at whatever rate it happens to have.
What a Saturn DPU actually contains
The register model patch is the most interesting read in the series because it describes the whole IP block on purpose — "including blocks the driver does not touch" — and keeps every block’s full word count as its extent. The result is a fairly complete X-ray of the display controller:
| Block | Registers | What it gives you |
|---|---|---|
Composer (CMP0–2) | 146 words each, base 0x18000 / 0x30000 / 0x48000 | 16 layers (layer00–layer15) with per-layer rectangle, solid fill RGBA, blend mode, colour key, layer alpha |
RDMA (0–3) | 60 words per path, base 0x1000 / 0x2000 / 0xa000 / 0xb000 | 4 read paths, 2 layers each; 3 base addresses per layer (YUV multi-plane), stride, bounding box, rotation |
| Command-list engine | 128 words, base 0x500 | Per-channel ring that the hardware replays on CFG_RDY |
Timing generator (TMG0) | 30 words, base 0x51000+0x200 | 14-bit h_active/v_active; output encodings RGB121212 / RGB101010 / RGB888 / RGB666 / RGB565 |
Display MMU + TBU0–7 | MMU 23 + 21 words, TBUs from 0x1100 | Scanout buffers go through address translation, not physical addresses |
Both K3 DPU instances are strapped as COMPOSER1, a detail the header comments spell out because it decides which register set, scene-control block and CFG_RDY bits are live. Register programming is batched, not written live: the driver builds per-module register lists in memory and the command-list engine replays them when the driver raises config-ready. Batching has a cost that shows up in the code — each channel gets two 4 KiB lists used alternately, because "the engine may still re-read the list of the previous commit until the next CFG_RDY has been consumed."
There is also a hardware quirk that shaped the whole register layer: some DPU configuration registers are write-only. A read-modify-write would corrupt neighbouring fields, so byte- and halfword-aligned fields are written at their native width instead. That is the kind of constraint you only learn from a manual or from a week of debugging, and it is documented in the commit message rather than buried.
The display MMU, and why the page table needs padding
Scanout does not use physical addresses. Each plane owns a TBU and a page table built once per GEM object, which means the table can be reused by every commit that scans the same buffer. The numbers are small and specific:
- 26-bit PFN, 4 KiB pages, so
tbu_sizeis a 16-bit page count — at most 65,535 pages, roughly 256 MiB per buffer. - 1 GiB of virtual address space per TBU, starting at
0x10000000and stepping by0x40000000. - Every advertised format is single-planar, so only bank 0 of the three-entry
ttb_pa[]/tbu_va[]arrays is used. - The table is over-fetched by the silicon past its last entry — 60 entries of padding, and the further right the
src_xcrops, the worse it gets (MAX_SRC_Xis 4,096). The comment is refreshingly direct: "The silicon over-fetches past the last entry; pad it to avoid a DDR fault."
That padding is the sort of thing that produces an unexplained bus fault once every few weeks on a customer board. Seeing it written down in a driver is worth more than any benchmark number in the series.
The ceiling: 5.4 Gbps, one plane, RGB only
The bridge driver is 2,186 lines, the largest file in the series, and its limit list reads like a specification of what the K3 cannot do yet. Source-side link rates enumerate 1.62 / 2.70 / 5.40 / 8.10 Gbps — but 8.1 Gbps is not usable, because the PHY’s MPLL has no configuration for it. The cover letter says it plainly: link rates are capped at HBR2.
| Property | Supported | Note |
|---|---|---|
| Link rate | 1.62 / 2.70 / 5.40 Gbps | 8.10 Gbps enum exists, no PHY config → HBR2 ceiling (21.6 Gbps at 4 lanes) |
| Lanes | 1 / 2 / 4 | Training walks a bandwidth-ordered table, narrowing on failure |
| Video format | RGB 8bpc only | MSA encoding hard-coded to RGB_8BIT |
| Max mode | 3,840 × 2,160 | K3 user manual ch.12: each DPU output tops out there; v3 rejects larger modes outright |
| Planes | One primary per CRTC | Linear RGB scanout; no scaling, rotation, YUV or writeback |
| Not implemented | DSI, DSC, DP audio | Audio registers are defined in the header but never programmed |
| AUX transfers | 16 bytes per message | Timeout polling, hardware AUX reset up to 3 retries, clears stale reply events first |
The bridge does not program any PLL itself. Link rate goes through the generic PHY framework, pixel clock through the clock the PHY registers, and the driver only touches the two PLL power-down bits on shutdown or reset. If the sink’s DPCD cannot be read, it falls back to assumed-safe values — DP 1.4, 5.40 Gbps, 2 lanes, enhanced framing — and if training fails it narrows the link so that mode_valid() stops offering modes the link cannot carry.
HPD at all; it polls, and re-reads the live level whenever the interrupt path does fire. Two related workarounds are in the diff: AUX transfers fail fast with -ENXIO when HPD is low instead of burning a 200 ms timeout, and the debounce window stretches to 1,000 ms because a Type-C PD virtual HPD can take seconds to come back after the transmitter powers down.
v3 is mostly a deletion
The version history is the part worth stealing for your own driver work. v1 (25 July) and v2 (9 August) built the thing; v3 spent most of its effort removing abstraction that Thomas Zimmermann did not want in a DRM driver.
| Version | Date | Shape | What changed |
|---|---|---|---|
| v1 | 25 Jul 2026 | 17 patches | First full stack: DPU, DP/eDP bridge, PHY, three bindings, DT nodes |
| v2 | 9 Aug 2026 | 17 patches | Unbind keeps the online IRQ alive until teardown commits drain; bridge teardown moves to devres; five reset lines behind one bulk pair; port@1 made required (Rob Herring); EDID via the AUX I2C adapter |
| v3 | 21 Nov 2026 | 17 patches, 40 files, +7,680 / −3 | Tracepoints, hardware callback tables and the constant-fill path deleted; one command list per channel instead of grouping/sorting/chaining; commit events through vblank armed by CFG_RDY; runtime PM; prepare_fb builds the MMU table once per GEM and waits on fences; write-combining scanout; drm_dev_enter() wrapped around hardware access only; no gamma table; rebased onto v7.4-rc1 with atomic_create_state replacing .reset |
Two review credits are worth naming because they changed behaviour rather than style: Icenowy Zheng asked for the 3,840×2,160 rejection and for bounding framebuffers by what the RDMA registers can address, and Guodong Xu pushed the eDP mode list onto the panel and stopped the driver from advertising a gamma table the hardware does not have. Guodong Xu is also added as a maintainer in this version; Cody Kang is listed with a vsit.ai address.
An AI reviewer, in the changelog
One line in the cover letter will interest anyone who tracks how kernel review is changing: "Sashiko AI review contributed total review comments: 51 items, which I accepted: 19 items." A 37% acceptance rate from an automated reviewer, disclosed in the cover letter next to the human credits — that is a new column in the ledger, and this series is one of the first places it appears as a matter of routine.
What was actually tested
v3 repeated the full v1 test matrix on both boards, in built-in and modular configurations, plus the module load/unload rounds from v2, page-flip and DPMS rounds, and unloading the modules while a client is running:
- Pico-ITX — an eDP panel and an external DisplayPort monitor.
- CoM260-IFX — DisplayPort only, no eDP.
Two honest caveats sit in the same paragraph. The eDP panel devicetree enablement is not part of this series; a separate series will follow showing how eDP is verified. And testing the series at all requires a SpacemiT u-boot carrying display support — the referenced branch is spacemit-com/uboot-for-k3-display-verify, tree k3-br-v1.0.y — because the bootloader has to have set the pipeline up for the kernel to take over. Probe stops the bootloader’s pipeline explicitly now, instead of waiting for the first modeset.
Claim versus reality
| Claim you will read elsewhere | What this series supports |
|---|---|
| “K3 drives dual 4K@60” | The hardware has two DPU instances, each capped at 3,840×2,160. This series enables DP on both boards and tested eDP + DP on one board — it does not claim a simultaneous dual-4K test, and eDP panel enablement ships separately |
| “K3 display is supported in mainline” | State New, based on v7.4-rc1, not applied. Two of the three drivers are new subsystems that need maintainer sign-off |
| “Full DisplayPort” | HBR2 only (5.4 Gbps × 4 lanes = 21.6 Gbps), RGB 8bpc only, no audio, no DSC, no DSI |
| “Hardware compositing” | The composer has 16 layers and four RDMA paths, but the driver exposes one primary plane per CRTC. The rest of the silicon is described in the register map and left idle |
| “Just update your kernel” | You need a matching u-boot with display support. A kernel-only update will give you the drivers and a dark screen |
Sources
- [v3,00/17] drm/spacemit: add SpacemiT K3 display support — Cody Kang, 21 Nov 2026 (patchwork series 1217963) — lore.kernel.org/r/20261121-k3-display-v3-0-ec419e8e96b8@gmail.com
- v3 cover letter: changes in v3, test matrix, limits, u-boot branch, Ubuntu 26.10 note — lore.kernel.org/all/20261121-k3-display-v3-0
- [v3,07/17] Saturn DPU register model: 16 composer layers, 4 RDMA paths, block map, OUTFMT — lore.kernel.org/all/...k3-display-v3-7
- [v3,08/17] Saturn DPU core types, cmdlist and display MMU: 26-bit PFN, 1 GiB per TBU, over-fetch pad — lore.kernel.org/all/...k3-display-v3-8
- [v3,12/17] Innosilicon DP/eDP controller bridge: HBR2 cap, 1/2/4 lanes, DPCD fallback, HPD gating — lore.kernel.org/all/...k3-display-v3-12
- [v3,14/17] riscv: dts: spacemit: k3: add display nodes — lore.kernel.org/all/...k3-display-v3-14
- v2 series, 9 Aug 2026 (Ubuntu 26.10 source package linux-riscv 7.2.0-5.5.2) — launchpad.net/ubuntu/+source/linux-riscv
- SpacemiT u-boot branch with display support — github.com/spacemit-com/uboot-for-k3-display-verify
- K3 hardware documentation — spacemit.com/community/document
2026 年 11 月 21 日,Cody Kang 提交了进迭时空 K3 显示支持的第 3 版:17 个补丁、40 个文件、+7,680/−3 行,含一个全新 DRM 驱动、一个全新 PHY 驱动和三个新设备树绑定。在此之前,K3 在主线 Linux 里没有任何显示输出 — 板子只能停在串口,任何像素都得靠厂商树。这是本月 linux-riscv 上最大的一笔平台使能,也是 K3 第一次有从控制台走到 DisplayPort 的可行路径。但它还没合并:状态 New,基于 v7.4-rc1。
硬件结构:链路三级串联 — Saturn DPU → Innosilicon DP/eDP 控制器 → Innosilicon DP PHY。K3 有两个独立 DPU 实例:dpu0 在 0xc0340000(IRQ 90/89)接 edp0@0xcac84000(IRQ 132),dpu1 在 0xc0440000(IRQ 139/138)接 dp1@0xcac88000(IRQ 140)。每个 DPU 五路时钟五路复位全来自 APMU;两个输出各带一个 PHY 子节点,PHY 不只是收时钟,它自己产生像素时钟(#clock-cells=<0>),PLL 输出回灌 APMU 当 mux 父时钟 — 在 DP/eDP 上 PHY PLL 就是像素时钟。注意 DPU 里还挂着 DSI 转义时钟和 DSC 时钟,硬件有这两条腿,本系列都没实现。
DPU 内部:composer 三个槽(K3 两个实例都接成 COMPOSER1)共 16 个图层,每层有区域、纯色填充、混合模式、colorkey;4 条 RDMA 路径、每条 2 层,每层 3 个基址(YUV 多平面);时序发生器有效区 14 位,输出编码 RGB121212/101010/888/666/565。寄存器编程是批处理的:驱动在内存里拼寄存器列表,硬件命令列表引擎在 CFG_RDY 时重放,因此每通道要两条 4 KiB 列表交替用 — 引擎在下一次 CFG_RDY 被消费前可能还在重读上一份。另有一条硬约束:部分寄存器是只写的,读改写会破坏相邻字段,所以字节/半字对齐字段按原生宽度写。
显示 MMU:扫描不走物理地址,每个 GEM 对象建一次页表可被所有 commit 复用;26 位 PFN + 4 KiB 页 → tbu_size 是 16 位页数,单缓冲上限 65,535 页 ≈ 256 MiB;每个 TBU 独占 1 GiB 虚拟地址窗口(基址 0x10000000,步长 0x40000000)。硅片会越界预取页表末尾,需补 60 项填充,src_x 越大越严重 — 注释原话“避免 DDR 故障”。
天花板:链路速率枚举到 8.10 Gbps 但不可用(PHY MPLL 没有该配置),实际上限 HBR2 5.40 Gbps,1/2/4 lane,最高 21.6 Gbps;视频格式只有 RGB 8bpc;单 CRTC 仅一个 primary plane,线性扫描,无缩放/旋转/YUV/writeback;不支持 DSI、DSC、DP 音频;模式上限 3,840×2,160(K3 手册第 12 章)。控制器本身不配 PLL:链路速率走 generic PHY,像素时钟走 PHY 注册的时钟,驱动只碰两个 PLL power-down 位。DPCD 读不到时回落到 DP 1.4 / 5.4 Gbps / 2 lane 的安全假定;训练失败则收窄链路让 mode_valid() 不再报带宽不够的模式。
HPD 陷阱:这块硅的 HPD 中断被 DP 像素时钟门控,而像素时钟来自 PHY PLL — 没人插线时它正好是关的。所以外部 DP 口不声明 HPD,改用轮询,中断真来时也重读实时电平;另有两处补丁:HPD 低时 AUX 直接 -ENXIO 快速失败而不是干等 200 ms,去抖窗口拉到 1000 ms(Type-C PD 虚拟 HPD 在发射端断电后要几秒才回来)。
v3 主要是在删代码:v1(7-25)、v2(8-09)把东西搭起来,v3 按 Thomas Zimmermann 的意见删掉 tracepoint、硬件回调表和 constant-fill 路径,改成每通道一条命令列表、commit 事件走 vblank(CFG_RDY 触发)、DPU 走 runtime PM、prepare_fb 按 GEM 建一次 MMU 表并等 fence、扫描缓冲 write-combining、只在硬件访问外包 drm_dev_enter()、不再声称有 gamma 表。Icenowy Zheng 要求拒绝 >3840×2160 并按 RDMA 寄存器可寻址范围约束 framebuffer;Guodong Xu 把 eDP 模式来源推给 panel 并新增为 maintainer。封面信还有一行值得记:Sashiko AI 评审提了 51 条,采纳 19 条。
测过的:Pico-ITX(eDP 面板 + 外接 DP 显示器)与 CoM260-IFX(只有 DP);v3 在两块板上重跑完整测试矩阵,含 built-in/modular、模块加载卸载、page-flip、DPMS,以及客户端运行中卸载模块。两条诚实注脚:eDP 面板的设备树使能不在本系列(另发),以及需要带显示支持的 SpacemiT u-boot(spacemit-com/uboot-for-k3-display-verify),只更内核会得到驱动和黑屏。另外 v2 已经进了 Ubuntu 26.10 的 RISC-V 内核(linux-riscv 7.2.0-5.5.2),Sarah Emery 从那里回归了两处修复。
诚实点:状态 New 未合并;“双 4K@60”是硬件能力(两个 DPU 各 3840×2160 封顶),本系列在两块板上使能的是 DP,eDP 与同时双输出都没有测试声明;composer 有 16 层但驱动只暴露 1 个 plane;今天要出货 K3 产品,显示仍应走厂商 BSP。
21 ноября 2026 года Cody Kang отправил третью версию серии поддержки дисплея для SpacemiT K3: 17 патчей, 40 файлов, +7,680/−3 строк — новый DRM-драйвер, новый драйвер PHY и три новых биндинга. До этого у K3 в mainline не было никакого вывода изображения: платы останавливались на последовательной консоли. Серия ещё не принята (состояние New, база v7.4-rc1), но именно она впервые даёт K3 путь от консоли до DisplayPort.
Аппаратная цепочка: Saturn DPU → контроллер Innosilicon DP/eDP → PHY Innosilicon DP. В K3 два независимых экземпляра DPU: dpu0 по адресу 0xc0340000 (IRQ 90/89) подключён к edp0@0xcac84000 (IRQ 132), dpu1 по 0xc0440000 (IRQ 139/138) — к dp1@0xcac88000 (IRQ 140). У каждого DPU пять тактов и пять сбросов от APMU. PHY не только принимает такт, но и сам его выдаёт: PLL-выход возвращается в APMU как родитель мультиплексора пиксельного такта — на DP и eDP PLL PHY и есть пиксельный такт. В DPU также висят такты DSI escape и DSC: кремний это умеет, серия — нет.
Внутри DPU: три композера (оба экземпляра K3 распаяны как COMPOSER1), 16 слоёв, 4 пути RDMA по 2 слоя, по три базовых адреса на слой, формирователь таймингов с 14-битным активным полем и кодировками RGB121212/101010/888/666/565. Регистры пишутся пакетами: драйвер собирает списки в памяти, движок команд воспроизводит их по CFG_RDY, поэтому на канал нужны два буфера по 4 КиБ поочерёдно. Часть регистров только для записи — чтение-изменение-запись испортит соседние поля, поэтому поля пишутся своей исходной шириной.
Дисплейный MMU: скан не по физическим адресам; таблица строится один раз на GEM-объект и переиспользуется. 26-битный PFN и страницы 4 КиБ дают предел 65,535 страниц ≈ 256 МиБ на буфер; каждому TBU отведён 1 ГиБ виртуального пространства. Кремний перечитывает таблицу за её концом — нужен запас в 60 записей — иначе,«чтобы избежать сбоя DDR».
Потолок: 8,10 Гбит/с в перечислении есть, но недоступно (у MPLL PHY нет такой конфигурации), реальный предел — HBR2 5,40 Гбит/с, 1/2/4 линии, максимум 21,6 Гбит/с; формат только RGB 8 бит; одна primary-плоскость на CRTC, линейный скан без масштабирования, поворота, YUV и writeback; нет DSI, DSC и DP-аудио; режим не выше 3,840×2,160 (глава 12 руководства K3). При недоступном DPCD берутся безопасные значения DP 1.4 / 5,4 Гбит/с / 2 линии, а при неудачном трейнинге линия сужается.
Ловушка HPD: прерывание горячего подключения стробируется пиксельным тактом DP, а тот идёт от PLL PHY. Поэтому внешний DP-разъём не объявляет HPD и опрашивается; AUX при низком HPD сразу возвращает -ENXIO; дребезг ждётся до 1000 мс из-за виртуального HPD в Type-C PD.
v3 в основном удаляет: v1 (25.07) и v2 (09.08) строили стек, v3 по замечаниям Thomas Zimmermann убрал tracepoint’ы, таблицы обратных вызовов и constant-fill, оставил один список команд на канал, перевёл события commit на vblank (по CFG_RDY), добавил runtime PM, prepare_fb с MMU-таблицей на GEM, write-combining для скана, drm_dev_enter() только вокруг доступа к железу и перестал объявлять гамма-таблицу. Icenowy Zheng потребовал отклонять режимы выше 3840×2160, Guodong Xu — брать режимы eDP у панели; он же добавлен мейнтейнером. В письме есть строка на будущее: ИИ-ревью Sashiko дало 51 замечание, принято 19.
Что проверено: Pico-ITX (панель eDP + внешний DP-монитор) и CoM260-IFX (только DP); полная матрица v1, включая built-in/modular, загрузку-выгрузку модулей, page-flip и DPMS. Две оговорки: включение панели eDP в серию не входит, и нужен u-boot SpacemiT с поддержкой дисплея — одно ядро даст драйверы и чёрный экран. При этом v2 уже входит в ядро Ubuntu 26.10 для RISC-V (linux-riscv 7.2.0-5.5.2).
Честно: серия не принята; «два 4K@60» — это возможность кремния (каждый DPU до 3,840×2,160), а серия включает DP на двух платах и не заявляет одновременный вывод; композер имеет 16 слоёв, драйвер отдаёт одну плоскость. Для продукта на K3 сегодня дисплей — через BSP вендора.
El 21 de noviembre de 2026 Cody Kang envió la versión 3 de la serie de soporte de pantalla para el SpacemiT K3: 17 parches, 40 archivos, +7,680/−3 líneas, con un driver DRM nuevo, un driver PHY nuevo y tres bindings nuevos. Hasta ahora el K3 no tenía salida de vídeo en mainline: las placas se quedaban en consola serie. La serie no está fusionada (estado New, base v7.4-rc1), pero es la primera que abre un camino real desde la consola hasta DisplayPort.
Cadena de hardware: Saturn DPU → controlador Innosilicon DP/eDP → PHY Innosilicon DP. El K3 tiene dos instancias DPU independientes: dpu0 en 0xc0340000 (IRQ 90/89) conectado a edp0@0xcac84000 (IRQ 132) y dpu1 en 0xc0440000 (IRQ 139/138) a dp1@0xcac88000 (IRQ 140). Cada DPU lleva cinco relojes y cinco resets del APMU. El PHY no solo recibe reloj: lo genera, y su PLL vuelve al APMU como padre del mux de píxel — en DP y eDP la PLL del PHY es el reloj de píxeles. También hay relojes de escape DSI y de DSC: el silicio los tiene, la serie no los usa.
Dentro del DPU: tres compositores (ambas instancias del K3 cableadas como COMPOSER1), 16 capas, 4 rutas RDMA de 2 capas, tres direcciones base por capa, generador de timings con campo activo de 14 bits y codificaciones RGB121212/101010/888/666/565. Los registros se programan por lotes: el driver arma listas en memoria y el motor de listas las reproduce con CFG_RDY, por eso cada canal usa dos búferes de 4 KiB alternos. Algunos registros son solo de escritura: leer-modificar-escribir corrompe campos vecinos, así que se escriben con su ancho nativo.
MMU de display: el escaneo pasa por traducción de direcciones; la tabla se construye una vez por objeto GEM. Con PFN de 26 bits y páginas de 4 KiB el límite es 65.535 páginas ≈ 256 MiB por búfer, y cada TBU recibe 1 GiB de espacio virtual. El silicio prefetch-ea más allá del final de la tabla: hacen falta 60 entradas de relleno para «evitar un fallo de DDR».
Techo: 8,10 Gbps aparece en la enumeración pero no es usable (la MPLL del PHY no lo configura); el límite real es HBR2 5,40 Gbps, 1/2/4 lanes, máximo 21,6 Gbps; formato solo RGB 8bpc; una sola capa primary por CRTC, escaneo lineal sin escalado, rotación, YUV ni writeback; sin DSI, DSC ni audio DP; modo máximo 3.840×2.160 (capítulo 12 del manual del K3). Si no se lee el DPCD se asumen DP 1.4 / 5,4 Gbps / 2 lanes; si falla el entrenamiento, el enlace se estrecha.
Trampa del HPD: la interrupción de conexión en caliente está condicionada por el reloj de píxeles de DP. Por eso el conector externo no anuncia HPD y se sondea; el AUX falla rápido con -ENXIO si HPD está bajo; y el antirrebote llega a 1000 ms por el HPD virtual de Type-C PD.
La v3 sobre todo borra: la v1 (25-07) y la v2 (09-08) construyeron el stack; la v3, siguiendo a Thomas Zimmermann, eliminó tracepoints, tablas de callbacks y la ruta constant-fill, dejó una lista de comandos por canal, llevó los eventos de commit a vblank (disparado por CFG_RDY), añadió runtime PM, prepare_fb con tabla MMU por GEM, write-combining para el escaneo, drm_dev_enter() solo alrededor del acceso al hardware, y dejó de anunciar tabla gamma. Icenowy Zheng pidió rechazar modos por encima de 3840×2160; Guodong Xu aportó que la panel entregue los modos eDP y pasó a maintainer. Dato nuevo: la revisión con IA Sashiko aportó 51 comentarios, se aceptaron 19.
Probado: Pico-ITX (panel eDP + monitor DP externo) y CoM260-IFX (solo DP), repitiendo la matriz completa con built-in/modular, carga y descarga de módulos, page-flip y DPMS. Dos avisos: el habilitado del panel eDP no está en esta serie, y hace falta un u-boot de SpacemiT con soporte de pantalla — solo el kernel da drivers y pantalla negra. Además, la v2 ya viaja en el kernel RISC-V de Ubuntu 26.10 (linux-riscv 7.2.0-5.5.2).
Honradez: estado New sin fusionar; el «doble 4K@60» es capacidad del silicio (cada DPU hasta 3.840×2.160), la serie habilita DP en dos placas y no declara prueba simultánea; el compositor tiene 16 capas y el driver expone una. Para un producto K3 hoy, pantalla por BSP del fabricante.
Le 21 novembre 2026, Cody Kang a envoyé la version 3 de la série d’affichage pour le SpacemiT K3 : 17 correctifs, 40 fichiers, +7,680/−3 lignes, avec un pilote DRM neuf, un pilote PHY neuf et trois nouveaux bindings. Jusqu’ici le K3 n’avait aucune sortie vidéo en mainline : les cartes s’arrêtaient à la console série. La série n’est pas fusionnée (état New, base v7.4-rc1), mais c’est la première à ouvrir un chemin de la console au DisplayPort.
Chaîne matérielle : Saturn DPU → contrôleur Innosilicon DP/eDP → PHY Innosilicon DP. Le K3 a deux instances DPU indépendantes : dpu0 à 0xc0340000 (IRQ 90/89) vers edp0@0xcac84000 (IRQ 132), et dpu1 à 0xc0440000 (IRQ 139/138) vers dp1@0xcac88000 (IRQ 140). Chaque DPU porte cinq horloges et cinq resets venus de l’APMU. Le PHY ne reçoit pas seulement l’horloge : il en produit une, et sa PLL revient dans l’APMU comme parent du mux pixel — en DP et eDP, la PLL du PHY est l’horloge pixel. Les horloges DSI escape et DSC existent aussi dans le DPU : le silicium les a, la série non.
Dans le DPU : trois compositeurs (les deux instances K3 câblées en COMPOSER1), 16 couches, 4 chemins RDMA de 2 couches, trois adresses de base par couche, générateur de timings à champ actif 14 bits et codages RGB121212/101010/888/666/565. Les registres sont programmés par lots : le pilote construit des listes en mémoire, le moteur de listes les rejoue sur CFG_RDY, d’où deux tampons de 4 Kio par canal en alternance. Certains registres sont écriture seule : une lecture-modification-écriture corromprait les champs voisins, ils sont donc écrits à leur largeur native.
MMU d’affichage : le scan passe par une traduction d’adresses, table construite une fois par objet GEM. PFN de 26 bits et pages de 4 Kio plafonnent à 65 535 pages ≈ 256 Mio par tampon ; chaque TBU dispose de 1 Gio d’espace virtuel. Le silicium lit au-delà de la fin de la table : 60 entrées de remplissage évitent un défaut DDR.
Plafond : 8,10 Gbit/s figure dans l’énumération mais n’est pas utilisable (la MPLL du PHY ne le configure pas) ; la limite est HBR2 5,40 Gbit/s, 1/2/4 lanes, 21,6 Gbit/s au maximum ; format RGB 8 bits seulement ; un seul plan primary par CRTC, scan linéaire sans mise à l’échelle, rotation, YUV ni writeback ; ni DSI, ni DSC, ni audio DP ; mode maximal 3 840×2 160 (chapitre 12 du manuel K3). Sans DPCD lisible, le pilote suppose DP 1.4 / 5,4 Gbit/s / 2 lanes ; en cas d’échec d’entraînement, le lien est réduit.
Piège HPD : l’interruption de branchement à chaud est conditionnée par l’horloge pixel DP. Le connecteur externe n’annonce donc pas HPD et se sonde ; l’AUX échoue vite en -ENXIO si HPD est bas ; l’anti-rebond monte à 1000 ms à cause du HPD virtuel du Type-C PD.
La v3 supprime surtout : la v1 (25-07) et la v2 (09-08) ont construit la pile ; la v3, suivant Thomas Zimmermann, retire tracepoints, tables de callbacks et chemin constant-fill, garde une liste de commandes par canal, fait passer les événements de commit par vblank (armé sur CFG_RDY), ajoute le runtime PM, prepare_fb avec table MMU par GEM, le write-combining pour le scan, drm_dev_enter() autour du seul accès matériel, et cesse d’annoncer une table gamma. Icenowy Zheng exige le rejet des modes au-delà de 3840×2160 ; Guodong Xu fait fournir les modes eDP par la dalle et devient mainteneur. Détail nouveau : la revue IA Sashiko a produit 51 remarques, 19 acceptées.
Testé : Pico-ITX (dalle eDP + moniteur DP externe) et CoM260-IFX (DP seul), avec la matrice complète v1, modules intégrés et modulaires, chargement/déchargement, page-flip et DPMS. Deux réserves : l’activation de la dalle eDP n’est pas dans la série, et il faut un u-boot SpacemiT avec support affichage — le noyau seul donne les pilotes et un écran noir. La v2 est déjà dans le noyau RISC-V d’Ubuntu 26.10 (linux-riscv 7.2.0-5.5.2).
Honnêteté : état New non fusionné ; le «double 4K@60» est une capacité du silicium (chaque DPU jusqu’à 3 840×2 160), la série active le DP sur deux cartes et ne revendique pas de test simultané ; le compositeur a 16 couches, le pilote en expose une. Pour un produit K3 aujourd’hui : affichage via BSP constructeur.
Am 21. November 2026 hat Cody Kang Version 3 der Display-Serie für den SpacemiT K3 geschickt: 17 Patches, 40 Dateien, +7,680/−3 Zeilen — ein neuer DRM-Treiber, ein neuer PHY-Treiber, drei neue Bindings. Bisher hatte der K3 in Mainline keine Videoausgabe: Boards blieben an der seriellen Konsole. Die Serie ist nicht gemergt (Status New, Basis v7.4-rc1), aber sie ist der erste realistische Weg von der Konsole zum DisplayPort.
Hardware-Kette: Saturn DPU → Innosilicon DP/eDP-Controller → Innosilicon DP-PHY. Der K3 hat zwei unabhängige DPU-Instanzen: dpu0 bei 0xc0340000 (IRQ 90/89) zu edp0@0xcac84000 (IRQ 132) und dpu1 bei 0xc0440000 (IRQ 139/138) zu dp1@0xcac88000 (IRQ 140). Jede DPU hat fünf Takte und fünf Resets vom APMU. Der PHY empfängt den Takt nicht nur, er erzeugt ihn: Seine PLL geht als Eltern-Takt des Pixel-Mux zurück in den APMU — bei DP und eDP ist die PHY-PLL der Pixeltakt. DSI-Escape- und DSC-Takte hängen ebenfalls an der DPU: der Silizium kann es, die Serie nicht.
In der DPU: drei Composer (beide K3-Instanzen als COMPOSER1 verdrahtet), 16 Layer, 4 RDMA-Pfade mit je 2 Layern, drei Basisadressen pro Layer, Timing-Generator mit 14-Bit-Aktivbereich und Codierungen RGB121212/101010/888/666/565. Register werden gebündelt programmiert: Der Treiber baut Listen im Speicher, die Command-List-Engine spielt sie bei CFG_RDY ab — daher zwei 4-KiB-Listen pro Kanal im Wechsel. Manche Register sind nur schreibbar: Read-Modify-Write zerstört Nachbarfelder, also wird in der nativen Breite geschrieben.
Display-MMU: Scanout läuft über Adressübersetzung, Tabelle einmal pro GEM-Objekt. 26-Bit-PFN und 4-KiB-Seiten begrenzen auf 65.535 Seiten ≈ 256 MiB pro Puffer; jeder TBU bekommt 1 GiB virtuellen Raum. Das Silizium liest über das Tabellenende hinaus — 60 Einträge Polsterung verhindern einen DDR-Fehler.
Decke: 8,10 Gbit/s steht in der Aufzählung, ist aber nicht nutzbar (die PHY-MPLL kennt keine Konfiguration); real gilt HBR2 5,40 Gbit/s, 1/2/4 Lanes, maximal 21,6 Gbit/s; Format nur RGB 8 bpc; eine Primary-Plane pro CRTC, linearer Scan ohne Skalierung, Rotation, YUV oder Writeback; kein DSI, DSC oder DP-Audio; maximal 3.840×2.160 (K3-Handbuch Kap. 12). Ohne lesbares DPCD werden DP 1.4 / 5,4 Gbit/s / 2 Lanes angenommen; scheitert das Training, wird die Verbindung verschmälert.
HPD-Falle: Der Hot-Plug-Interrupt ist vom DP-Pixeltakt getaktet. Der externe Anschluss meldet daher kein HPD, sondern wird gepollt; AUX scheitert bei niedrigem HPD sofort mit -ENXIO; das Entprellen reicht bis 1000 ms wegen des virtuellen Type-C-PD-HPD.
v3 löscht vor allem: v1 (25.07.) und v2 (09.08.) bauten den Stack; v3 entfernt auf Wunsch von Thomas Zimmermann Tracepoints, Callback-Tabellen und den Constant-Fill-Pfad, lässt eine Command-List pro Kanal, führt Commit-Events über Vblank (CFG_RDY), Runtime-PM, prepare_fb mit MMU-Tabelle pro GEM, Write-Combining für den Scan und drm_dev_enter() nur um Hardware-Zugriffe ein und wirbt nicht mehr mit Gamma-Tabelle. Icenowy Zheng verlangte das Ablehnen von Modi über 3840×2160, Guodong Xu die Modusliste vom eDP-Panel und wurde Maintainer. Neu im Begleittext: die Sashiko-KI-Review lieferte 51 Kommentare, 19 angenommen.
Getestet: Pico-ITX (eDP-Panel + externer DP-Monitor) und CoM260-IFX (nur DP), mit voller v1-Matrix, Built-in und Modular, Modul-Laden/-Entladen, Page-Flip und DPMS. Zwei Einschränkungen: Die eDP-Panel-Aktivierung ist nicht Teil der Serie, und es braucht einen SpacemiT-u-boot mit Display-Support — nur der Kernel liefert Treiber und einen schwarzen Schirm. v2 steckt bereits im RISC-V-Kernel von Ubuntu 26.10 (linux-riscv 7.2.0-5.5.2).
Ehrlichkeit: Status New, nicht gemergt; „zwei 4K@60“ ist Silizium-Potenzial (je DPU bis 3.840×2.160), die Serie aktiviert DP auf zwei Boards und behauptet keinen Parallelbetrieb; der Composer hat 16 Layer, der Treiber bietet eine. Für ein K3-Produkt heute: Display über Hersteller-BSP.
در ۲۱ نوامبر ۲۰۲۶ Cody Kang نسخهٔ سوم مجموعهٔ پشتیبانی نمایشگر برای SpacemiT K3 را فرستاد: ۱۷ وصله، ۴۰ فایل، +۷٬۶۸۰/−۳ خط — یک درایور DRM تازه، یک درایور PHY تازه و سه بایندینگ جدید. تا پیش از این K3 در mainline هیچ خروجی تصویری نداشت و بردها روی کنسول سریال میماندند. مجموعه ادغام نشده (وضعیت New، پایهٔ v7.4-rc1)، اما نخستین مسیر واقعی از کنسول تا DisplayPort است.
زنجیرهٔ سختافزار: Saturn DPU → کنترلر Innosilicon DP/eDP → PHY Innosilicon DP. K3 دو نمونهٔ مستقل DPU دارد: dpu0 در 0xc0340000 (IRQ 90/89) به edp0@0xcac84000 (IRQ 132) و dpu1 در 0xc0440000 (IRQ 139/138) به dp1@0xcac88000 (IRQ 140). هر DPU پنج ساعت و پنج ریست از APMU دارد. PHY فقط ساعت نمیگیرد، ساعت میسازد و PLL آن بهعنوان والد مالتیپلکسر پیکسل به APMU برمیگردد — در DP و eDP PLL همان ساعت پیکسل است. ساعتهای DSI escape و DSC هم در DPU هست: سیلیکون توانش را دارد، مجموعه نه.
درون DPU: سه composer (هر دو نمونهٔ K3 بهصورت COMPOSER1 سیمکشی شدهاند)، ۱۶ لایه، ۴ مسیر RDMA با ۲ لایه، سه آدرس پایه برای هر لایه، مولد تایمینگ با میدان فعال ۱۴ بیتی و کدگذاریهای RGB121212/101010/888/666/565. ثباتها دستهای برنامهریزی میشوند: درایور فهرستها را در حافظه میسازد و موتور فرمان آنها را در CFG_RDY بازپخش میکند، از اینرو دو بافر ۴ کیبیبایتی برای هر کانال بهتناوب. برخی ثباتها فقط نوشتنیاند: خواندن-تغییر-نوشتن میدانهای مجاور را خراب میکند، پس با عرض اصلی نوشته میشوند.
MMU نمایشگر: اسکن از راه ترجمهٔ آدرس است و جدول یکبار برای هر شیء GEM ساخته میشود. PFN ۲۶ بیتی و صفحهٔ ۴ کیبیبایت سقف را ۶۵٬۵۳۵ صفحه ≈ ۲۵۶ میبیبایت میکند؛ هر TBU ۱ گیبیبایت فضای مجازی دارد. سیلیکون از انتهای جدول فراتر میخواند و ۶۰ ورودی پرکننده لازم است تا «خطای DDR» رخ ندهد.
سقف: ۸٫۱۰ گیگابیت بر ثانیه در شمارش هست ولی قابل استفاده نیست (MPLL چنین تنظیمی ندارد)؛ حد واقعی HBR2 یعنی ۵٫۴۰ گیگابیت، ۱/۲/۴ خط، حداکثر ۲۱٫۶ گیگابیت؛ قالب تنها RGB ۸ بیتی؛ یک صفحهٔ primary برای هر CRTC، اسکن خطی بدون مقیاس، چرخش، YUV یا writeback؛ بدون DSI، DSC و صدای DP؛ حداکثر حالت ۳۸۴۰×۲۱۶۰ (فصل ۱۲ کتاب K3). اگر DPCD خوانده نشود، DP 1.4 / ۵٫۴ گیگابیت / ۲ خط فرض میشود و در صورت شکست آموزش، پیوند باریکتر میشود.
تلهٔ HPD: وقفهٔ اتصال گرم با ساعت پیکسل DP گیت میشود. پس درگاه بیرونی HPD اعلام نمیکند و پیمایش میشود؛ AUX با HPD پایین فوراً -ENXIO میدهد؛ و ضدلرزش تا ۱۰۰۰ میلیثانیه میرسد بهخاطر HPD مجازی Type-C PD.
نسخهٔ سوم بیشتر حذف میکند: نسخهٔ اول (۲۵ ژوئیه) و دوم (۹ اوت) بنا را ساختند؛ سوم به خواست Thomas Zimmermann تریسپوینتها، جدولهای callback و مسیر constant-fill را برداشت، یک فهرست فرمان برای هر کانال گذاشت، رویدادهای commit را به vblank (با CFG_RDY) برد، runtime PM و prepare_fb با جدول MMU برای هر GEM و write-combining اسکن افزود، drm_dev_enter() را فقط گرد دسترسی سختافزاری گذاشت و دیگر جدول گاما اعلام نمیکند. Icenowy Zheng رد حالتهای بالاتر از ۳۸۴۰×۲۱۶۰ را خواست و Guodong Xu آوردن حالتهای eDP از پنل و مقام maintainer را. نکتهٔ تازه: بازبینی هوش مصنوعی Sashiko ۵۱ نظر داد، ۱۹ پذیرفته شد.
آزمودهشده: Pico-ITX (پنل eDP + مانیتور DP بیرونی) و CoM260-IFX (فقط DP)، با تکرار کل ماتریس نسخهٔ اول، built-in و modular، بارگذاری و برداشتن ماژول، page-flip و DPMS. دو هشدار: فعالسازی پنل eDP در این مجموعه نیست و به u-boot ساخت SpacemiT با پشتیبانی نمایشگر نیاز است — تنها بهروزرسانی هسته درایور میدهد و صفحهٔ سیاه. ضمناً نسخهٔ دوم از قبل در هستهٔ RISC-V اوبونتو ۲۶٫۱۰ هست (linux-riscv 7.2.0-5.5.2).
صداقت: وضعیت New و ادغامنشده؛ «دو ۴K@۶۰» توان سیلیکون است (هر DPU تا ۳۸۴۰×۲۱۶۰)، مجموعه DP را روی دو برد فعال میکند و آزمون همزمان را ادعا نمیکند؛ composer شانزده لایه دارد و درایور یکی میدهد. برای محصول K3 امروز، نمایشگر از راه BSP سازنده.