Skip to content

About

A Linux kernel port for the Goke GK6323V100C-based CM311-5-ZG TV box

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

CM311-5 Linux

Give an old TV box a new life as a small Linux machine.

Linux Architecture Status License

English · 简体中文

CM311-5 Linux brings a custom Linux kernel and Debian userspace to the China Mobile CM311-5-ZG (移动高清盒子 6 Pro), based on the Goke GK6323V100C. It collects the board-specific drivers, device tree, kernel changes and tools behind the port, without distributing firmware or personal disk images.

An earlier development build has booted locally from eMMC into Debian and run the wired network at MTU 1500. The cleaned-up source in this repository builds successfully, but the resulting image has not yet been boot-tested on hardware. This is a porting project, not a ready-to-flash distribution.

Boot flow for CM311-5 Linux

Interactive diagram · Download the HTML file and open it locally.

What is here

  • Board support — device tree, kernel configuration, clock, reset and eMMC integration.
  • Wired networking — a GK6323 Ethernet driver with RX/TX ring tests and the large-frame fix from the working development build.
  • Build tools — a patch for Linux 4.9.118, an archive-verified build script and an Android boot-image wrapper matching the observed boot format.
  • Tests and notes — host-side driver and image-format tests, plus hardware and boot-chain findings.

The original project used Debian 13 with an ARMv7 (armhf) kernel and userspace. The CPU is 64-bit capable, but this repository builds a 32-bit ARM kernel. A 64-bit port has not been demonstrated.

Hardware

Item Observed on the development unit
Box CM311-5-ZG, China Mobile 6 Pro
SoC Goke GK6323V100C, quad-core Cortex-A55
Memory approximately 2 GiB
eMMC approximately 6.96 GiB usable device capacity
Wired network integrated 10/100 Ethernet
Kernel / userspace Linux 4.9.118 / Debian 13 armhf
Root filesystem ext4 on partition 19 in the tested layout

See hardware and validation notes for what was tested and what remains unknown. Device layouts may vary: never assume another box uses the same partition map.

Build

On Debian or Ubuntu, install the toolchain and build dependencies:

sudo apt-get update
sudo apt-get install build-essential bc bison flex libssl-dev libelf-dev \
  gcc-arm-linux-gnueabihf device-tree-compiler u-boot-tools \
  python3 patch xz-utils curl

Download the official source archive and build into a new output directory:

curl -fLO https://cdn.kernel.org/pub/linux/kernel/v4.x/linux-4.9.118.tar.xz
bash scripts/build-kernel.sh linux-4.9.118.tar.xz out
bash scripts/test.sh

The build checks the archive against the kernel.org SHA-256 checksum, applies the port and produces zImage, gk6323.dtb, uImage, boot.img and .config in out/. It does not write to a device. See build and boot notes for the boot layout, root filesystem prerequisites and recovery considerations.

Status and safety

Do not flash the generated image without a verified device-specific recovery path and full backups. The repository does not provide a root filesystem, bootloader firmware or an automated flashing tool. Its example device tree contains the development unit's partition layout, not a promise that another unit is identical. A wrong layout or image can make the box unbootable or destroy data.

Linux 4.9.118 is old and lacks current security fixes. A previous development driver also credited predictable values as hardware entropy; the public source removes that code, but the change has not been deployed or verified on the original box. Do not assume early-boot cryptographic randomness is safe; establish and verify a trustworthy entropy source before generating keys or exposing services.

Repository

kernel/     device tree, kernel configuration and upstream patch
drivers/    board-specific Linux drivers
tests/      host-side driver and image-format tests
scripts/    kernel build, boot-image packaging and test entry points
docs/       hardware, boot and build notes

Contributions and reproducible hardware results are welcome. Please remove device identifiers, credentials and private network details from logs before sharing them.

License

Project material is available under GPL-2.0, unless a file states otherwise. The device tree is dual-licensed GPL-2.0 OR MIT, and imported files retain their original copyright and license notices. Linux itself is obtained separately from kernel.org.

About

A Linux kernel port for the Goke GK6323V100C-based CM311-5-ZG TV box

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages