13
How uConsole CM4 OS image made
github-actions[bot] edited this page 2025-06-25 06:29:32 +00:00

How uConsole CM4 OS Image Is Made

This guide explains how to create an OS image for the uConsole CM4 module.


uConsole_CM4_v2.0_64bit.img.7z

Since v2.0, cm4 os image is made by pi-gen

just clone pi-gen repo, branch uconsole_arm64

run sudo ./build.sh in ubuntu linux PC

  • kernel source: 9a1e3adc9d here is kernel compiling commands:
export KERNEL=kernel8
export ARCH=arm64
export CROSS_COMPILE=aarch64-linux-gnu-

make bcm2711_defconfig

make -j4

mkdir -p ../modules
rm -rf ../modules/*

INSTALL_MOD_PATH=../modules make modules_install

mkdir -p ../firmware
rm -rf ../firmware/*
mkdir -p ../firmware/overlays

cp arch/arm64/boot/Image ../firmware/$KERNEL.img
cp arch/arm64/boot/dts/broadcom/*.dtb ../firmware
cp arch/arm64/boot/dts/overlays/*.dtb* ../firmware/overlays/
cp arch/arm64/boot/dts/overlays/README ../firmware/overlays/

KERNEL_VER=$(make kernelrelease)
cp arch/arm64/boot/Image.gz ../vmlinuz-${KERNEL_VER}

cp System.map  ../System.map-${KERNEL_VER}
cp .config  ../config-${KERNEL_VER}

mkdir -p ../linux-headers-${KERNEL_VER}

make headers_install INSTALL_HDR_PATH=../linux-headers-${KERNEL_VER}
  • In pi-gen , we added some modifcations:
  1. Pull up gpio9 at boot,so that screen will turn on right away when Power on
  2. Set default lcd backlight to 3
  3. Set default desktop to be large screen
  4. No wallpaper, only black color
  5. Fn+<> to adjust lcd backlight