Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Maccraft123/Cadmium
https://github.com/Maccraft123/Cadmium
cadmium chromebook chromebooks chromeos debian duet kernel kevin linux mt8183
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/Maccraft123/Cadmium
- Owner: Maccraft123
- License: gpl-3.0
- Created: 2020-11-05T19:44:08.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-09-17T10:43:55.000Z (4 months ago)
- Last Synced: 2024-09-18T12:06:33.444Z (4 months ago)
- Topics: cadmium, chromebook, chromebooks, chromeos, debian, duet, kernel, kevin, linux, mt8183
- Language: Shell
- Homepage:
- Size: 107 MB
- Stars: 309
- Watchers: 16
- Forks: 63
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
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 | 4.6 | 4.6 |
| Vulkan | N | N | N | Y | Y |
| Video decode | ? | ? | ? | Y | 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 | Suspend/Resume | Notes |
| ------------------------ | -------------- | -------- | --------- | ---------------------- | ---- | --------- | ----- | -------------- | --------------------------------- |
| Asus Chromebook C100PA | veyron-minnie | RK3288 | N/A | ? | ? | ? | ? | Y | |
| Samsung Chromebook Plus | gru-kevin | RK3399 | ? | ? | ? | ? | ? | Y | Libreboot available |
| Lenovo Chromebook S330 | elm-hana | MT8173 | N/A | ? | ? | ? | ? | Y | |
| Lenovo Chromebook Duet | kukui-krane | MT8183 | ? | Y | Y | ? | Y | Y | |
| Acer Chromebook Spin 513 | trogdor-lazor | SC7180 | ? | Y | Y | ? | Y | Y | Manual audio switching required |
| Lenovo Yoga Slim 7x | N/A | X1 Elite | N/A? | Dual-boot with Windows | Y | Y | N | Only manual | 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 laptop*
- ``` ./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 ```, 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-.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
- ```rsync```