The kit: clockworkPi uConsole Kit RPI-CM4 Lite
- Recent minimal debian-based OS image
- Recent kernel package
- FS encryption (LUKS, preferable root, opportunistic home)
Current low-hanging-fruit approach implies installing old kernel package into new OS image, which may lead to inconsistencies
wget -c https://downloads.raspberrypi.org/raspios_lite_arm64/images/raspios_lite_arm64-2024-03-15/2024-03-15-raspios-bookworm-arm64-lite.img.xz
unxz -k 2024-03-15-raspios-bookworm-arm64-lite.img.xz # don't remove original archive
mv 2024-03-15-raspios-bookworm-arm64-lite.img uc-bookworm-arm64-lite.img
sudo losetup --show -f -P uc-bullseye-arm64-lite.img # assume /dev/loop0 below, parsed outpu in script
sudo mount /dev/loop0p2 /mnt/
sudo mount /dev/loop0p1 /mnt/boot/
sudo mount --bind /dev /mnt/dev/
sudo mount --bind /sys /mnt/sys/
sudo mount --bind /dev/pts /mnt/dev/pts/
sudo chroot /mnt # you are root in chroot after that, no sudo is needed
touch /boot/cmdline.txt # inc case it's missing, kernel package install breaks without it
curl -s https://raw.githubusercontent.com/clockworkpi/apt/main/debian/KEY.gpg > /etc/apt/trusted.gpg.d/clockworkpi.asc
echo "deb https://raw.githubusercontent.com/clockworkpi/apt/main/debian/ stable main" > /etc/apt/sources.list.d/clockworkpi.list
apt update
apt install -y uconsole-kernel-cm4-rpi
apt autoremove -y
apt clean
# cleanup
exit
sudo rm -f /mnt/root/.bash_history
sudo umount -R /mnt # recursive
sudo losetup -D /dev/loop0 # assume loop0 above, parse output in script
# burn sd card, assume /dev/sdb (BE SURE)
sudo dd if=uc-bookworm-arm64-lite.img of=/dev/sdb status=progress bs=4M && sync
See here for the .deb repack of the famous kernel by @yatli
Kernel patch for 6.6.y, courtesy of clockwork pi team, yatli and community (see here for the start). Most recent one is maintained by @ak-rex here, to generete patch you can do:
git clone https://github.com/ak-rex/ClockworkPi-linux --branch rpi-6.6.y --single-branch uc-rpi-6.6.y
cd uc-rpi-6.6.y
git remote add upstream https://github.com/raspberrypi/linux.git --track rpi-6.6.y
git remote -v
git fetch upstream
git merge upstream/rpi-6.6.y -m "Merge upstream"
git diff upstream/rpi-6.6.y > ../0001-clockwork.patch
- uConsole Notes by @selfawaresoup
- uConsole CM4 OS by @Snoozer-94
- My Clockwork uConsole Config Files by @krim404
- Kali linux image for uConsole cm4 by @clockworkpi
- μPico - RP2040 powered expansion card for GPIO
- μHub - USB Hub Expansion Card
- 3D printed front cover
- Screen Protector (6K PRO) - (ali)
- 2x M4 Lanyard Screw D Ring (ali)
- M4 4mm black hexagon flat head screws (ali), or Ultra thin Super Low, or Silver
- Micro SD Card Adapter Extender (ali)
- EVQWJN007 Blackberry trackball (ali)
- https://forum.clockworkpi.com/t/show-us-your-customised-uconsole/13732/15 - magnet wrench holder
- https://forum.clockworkpi.com/t/show-us-your-customised-uconsole/13732/33 - black anodized back cover
- https://forum.clockworkpi.com/t/uconsole-r01-poor-wifi-reception/13797 - wifi antenna polarisation changer
- https://forum.clockworkpi.com/t/uconsole-crashes-when-connecting-flipper-zero/13814/6 - power-toggle usb cable for flipper zero (and other stuff attemting to charge from uc)
- https://forum.clockworkpi.com/t/battery-level-indicator/13059/3 - battery controller calibration
- https://forum.clockworkpi.com/t/guide-encrypted-root-partition-on-uconsole/11724 - encrypted root partition on uConsole
- https://forum.clockworkpi.com/t/encrypting-home-folder-using-luks-cm4/11289 - encrypting /home folder using LUKS - CM4
- https://forum.clockworkpi.com/t/free-usb-for-uconsole/13071 - free USB for UConsole
- https://forum.clockworkpi.com/t/cm4-uconsole-defaults-to-pcb-antenna-resulting-in-poor-wifi-reception/10477 - on dtparam=ant2
- https://forum.clockworkpi.com/t/replacement-wifi-antenna/10576 - replacement wifi antenna discussion
- https://forum.clockworkpi.com/t/uconsole-mods-usb-rj45-networking-and-more/13440 - USB, RJ45 mods
- https://forum.clockworkpi.com/t/archlinux-arm-for-uconsole-cm4-living-documentation/12804 - ArchLinux by yatli
- https://forum.clockworkpi.com/t/uconsole-mods-rf-toolbox-edition/14022 - on RTC module