Skip to content

Latest commit

 

History

History
72 lines (61 loc) · 4.29 KB

README.md

File metadata and controls

72 lines (61 loc) · 4.29 KB
Raw

Logo

Thanks @LoganMD for the logo

Cadmium, A Linux distro installer for some RISC laptops

Hardware support:

  • (FW) entries are meant to indicate that firmware(that is included in Cadmium) is needed for piece of hardware to work correctly.
  • "Y" means "Is known to work as of last time it was tested"
  • "N" means "Is known to not work as of last time it was tested"
  • "?" means "Not tested/Unknown"
  • "P" means "Partial/Incomplete support, refer to notes"
  • "N/A" means "Missing hardware"
Feature RK3288 MT8173 MT8183 SC7180 X1 Elite
Display Y Y Y Y Y
OpenGL Y N 3.1 Y 4.6
Vulkan N N N Y 1.3.211
Video decode ? ? ? ? N
USB Host Y Y Y Y Y
USB Device N N N N ?
KVM Y Y Y Y N
CPUFreq Y Y Y Y Y
Commercial name Codename SOC Pen input Internal Installation WiFi Bluetooth Audio Notes
Asus Chromebook C100PA veyron-minnie RK3288 N/A ? ? ? ?
Samsung Chromebook Plus gru-kevin RK3399 ? ? ? ? ?
Lenovo Chromebook S330 elm-hana MT8173 N/A ? ? ? ?
Lenovo Chromebook Duet kukui-krane MT8183 ? Y Y ? Y
Acer Chromebook Spin 513 trogdor-lazor SC7180 ? ? ? ? ?
Lenovo Yoga Slim 7x N/A X1 Elite N/A? Dual-boot with Windows Y N N EFI booting

Official discord server is at https://discord.gg/ZZbwyvKCmV

Installation

  • Make sure that you have developer mode unlocked

  • Enable booting from usb, by running enable_dev_usb_boot in ChromeOS root shell accessible when you log in as root after pressing ctrl + alt + refresh.

  • Reboot Once you have this out, continue with instructions:

  • Edit ./config to reflect your board

  • ./build-all /dev/sdX On a Linux machine(ChromeOS doesn't count(except in linux chroot)). For Debian rootfs, binfmt and debootstrap are needed to work correctly.

  • When build-all is ran like ./build-all <file> <size>, it builds Cadmium to with size of (8G should be fine)

  • Enable developer mode

  • Plug pendrive into your laptop.

  • Boot from USB

  • After running ./install after connecting to internet, Cadmium will be installed on internal emmc memory

  • To update kernel on eMMC memory run: ./install-kernel from pendrive

OR

  • Enable developer mode(instructions are in the wiki for krane)
  • Download and uncompress cadmium-<device>.tar.gz to your pendrive
  • Boot from USB
  • Run ./install

Binary drivers are unsupported in Cadmium and never will be

Dependencies on build machine, Debian is recommended

  • Recent Linux distribution
  • A working LLVM toolchain
  • Build dependencies for kernel compilation
  • debootstrap when Debian rootfs is used
  • qemu-user-static when build machine can't run binaries for the target machine, with binfmt support
  • For Chromebook machines running stock boot firmware: vboot-utils u-boot-tools (vbutil_kernel or futility, cgpt and mkimage)
  • For EFI machines: ukify, usually provided in systemd-boot or related package
  • bc to calculate number of threads to be used for compilation
  • curl to download the kernel
  • bsdtar for writing the archive file (from the libarchive-tools .deb package)
  • f2fs-tools for creating the filesystem used by Cadmium
  • parted to prepare gpt table to be modified by cgpt