u/och95

RPI CM5 support with stock raspberry pi os

RPI CM5 support with stock raspberry pi os

Hello everybody!

Recently got a uConsole with a CM5 board. While looking into available OS options, it turned out that neither ClockworkPi's nor stock Pi OS supports the device out of the box — so I decided to make a small project based on the stock image + DKMS for the drivers that aren't included. And here it is.

The idea is to keep the kernel stock and updatable, with hardware support living in out-of-tree DKMS modules + device-tree overlays instead of a custom kernel. Nothing here is tied to Raspberry Pi OS specifically — it builds against the stock Raspberry Pi kernel, so the same approach should work on other Pi distros (Ubuntu, Debian, etc.). I've tested it on Raspberry Pi OS (Trixie); on other distros the installer would need small tweaks, since it currently assumes apt and RPi OS package/paths.

How to use it:

  1. Flash the latest Raspberry Pi OS with the Imager tool (set hostname, user/password and Wi-Fi in the Imager settings)
  2. SSH into the device
  3. Copy the project over (scp -r) and run ./install.sh

After a reboot you get a fully working device: display, backlight, keyboard/trackball, audio (with headphone auto-mute), volume control, battery reporting, and the power button.

Project: https://github.com/yota9/uconsole-cm5

Hopefully someone finds it useful :)

github.com
u/och95 — 1 day ago