[PATCH v3 0/5] riscv: dts: starfive: Add Milk-V Mars CM (Lite) SoM

E Shattow
2025-09-05T14:41:28Z

Milk-V Mars CM and Mars CM Lite System-on-Module both are based on the
StarFive JH7110 SoC and compatible with the Raspberry Pi CM4IO Classic IO
Board carrier. Mars CM Lite is Mars CM without the eMMC storage component
on mmc0 and the mmc0 interface configured instead for SD Card use. The
optional WiFi+BT chipset is connected via SDIO on the mmc1 interface that
would otherwise be connected to an SD Card slot on the StarFive
VisionFive2 reference design.

Add the related devicetree files for both Milk-V Mars CM and Milk-V Mars
CM Lite describing the currently supported features, namely PMIC, UART,
I2C, GPIO, eMMC or SD Card, WiFi+BT, QSPI Flash, and Ethernet.

Caveat with vendor AP6256 firmware files present the firmware loading is
successful but subsequently fails IRQ wake initialization. Common GPIO
conflicts for "WiFi" optioned boards having this module:

pwmdac_pins:
- AP6256: WL_REG_ON>>WIFI_REG_ON_H_GPIO33
- AP6256: WL_HOST_WAKE>>WIFI_WAKE_HOST_H_GPIO34

i2c2_pins:
- AP6256: UART_CTS_N<<UART1_RTSn_GPIO2
- AP6256: UART_RTS_N>>UART1_CTSn_GPIO3

i2c6_pins:
- AP6256: UART_RXD<<UART_TX_GPIO16
- AP6256: UART_TXD>>UART_RX_GPIO17

Tested successfully for basic mmc0 storage, USB, and network functionality on:
- Milk-V Mars CM 8GB
- Milk-V Mars CM Lite 4GB
- Milk-V Mars CM Lite WiFi 8GB

Changes since v2:
- PATCH 3/5 delete newline at end of file
- PATCH 5/5 delete newline at end of file

Link to v2:
https://lore.kernel.org/lkml/20250831225959.531393-1-e@freeshell.de/

E Shattow (5):
riscv: dts: starfive: add common board dtsi for Milk-V Mars CM
variants
dt-bindings: riscv: starfive: add milkv,marscm-emmc
riscv: dts: starfive: add Milk-V Mars CM system-on-module
dt-bindings: riscv: starfive: add milkv,marscm-lite
riscv: dts: starfive: add Milk-V Mars CM Lite system-on-module

.../devicetree/bindings/riscv/starfive.yaml | 2 +
arch/riscv/boot/dts/starfive/Makefile | 2 +
.../dts/starfive/jh7110-milkv-marscm-emmc.dts | 12 ++
.../dts/starfive/jh7110-milkv-marscm-lite.dts | 25 +++
.../dts/starfive/jh7110-milkv-marscm.dtsi | 159 ++++++++++++++++++
5 files changed, 200 insertions(+)
create mode 100644 arch/riscv/boot/dts/starfive/jh7110-milkv-marscm-emmc.dts
create mode 100644 arch/riscv/boot/dts/starfive/jh7110-milkv-marscm-lite.dts
create mode 100644 arch/riscv/boot/dts/starfive/jh7110-milkv-marscm.dtsi

base-commit: 8181cc2f3f21657392da912eb20ee17514c87828
--
2.50.0