1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798 |
- _
- __| | _____ _____ _ _ ___
- / _` |/ _ \ \ / / __| | | / __|
- | (_| | __/\ V /\__ \ |_| \__ \
- \__,_|\___| \_/ |___/\__,_|___/
- Overview
- ========
- Devsus is a script that builds bootable, libre Devuan (http://www.devuan.org/)
- images for the Asus C201 Chromebook, one of the few laptops able to boot and run
- without any non-free software, all the way down to the firmware level. The C201
- is supported by Libreboot (http://www.libreboot.org/).
- The images produced by Devsus contain a Linux-libre
- (http://linux-libre.fsfla.org/) longterm kernel tuned for small size, good
- performance and short boot times.
- Some features of the RK3288 SoC, including built-in WiFi support, require use of
- non-free software. Therefore, they are unsupported by Devsus. To compensate for
- that, the Devsus kernel includes support for freedom-friendly devices:
- - Firmware for Atheros AR9271 based WiFi dongles
- - Drivers for Qualcomm CSR8510 based Bluetooth dongles
- Moreover, the Devuan installation is very minimal and consists of a barebones
- Devuan base, plus crucial command-line tools, like those required to connect to
- a WiFi network.
- Dependencies
- ============
- Devsus has been tested on Devuan 2 (ASCII) on x86_64, with the following
- packages installed:
- apt install --no-install-recommends --no-install-suggests \
- parted cgpt \
- git gawk device-tree-compiler vboot-kernel-utils gcc-arm-none-eabi \
- u-boot-tools \
- gcc make libc-dev wget g++ cmake \
- binfmt-support qemu-user-static debootstrap \
- bc wget xz-utils m4
- Building
- ========
- # ./devsus.sh
- This produces two Devuan disk images:
- 1) devuan-ascii-c201-libre-16GB.img, a 16 GB image suitable for persistent
- installation; its size should be exactly the size of the internal SSD
- 2) devuan-ascii-c201-libre-2GB.img, a 2 GB image suitable for booting the
- laptop off USB
- Usage
- =====
- To produce a bootable media, write the 2 GB image to a flash drive (of at least
- 2 GB):
- # dd if=$SOMEWHERE/devuan-ascii-c201-libre-2GB.img of=/dev/$DEVICE bs=50M
- The root password is blank.
- The 2 GB image (yes, the smaller one) contains the larger, 16 GB one under /.
- This way, it is possible to boot the laptop through USB, then install Devuan
- persistently without having to download or store the large image separately.
- Persistent installation is performed using dd, too:
- # dd if=/devuan-ascii-c201-libre-16GB.img of=/dev/mmcblk0
- Modifications
- =============
- The images produced by Devsus are very close to stock Devuan:
- - APT has been configured not to install "recommended" packages by default
- - Some critical (like udev) or useful (like iw) packages have been added
- - unscd has been added, to cache DNS
- - The number of virtual consoles has been reduced from 6 to 2
- Credits and Legal Information
- =============================
- Devsus' previous kernel building procedure was based on the linux-veyron package
- of Arch Linux ARM (http://www.archlinuxarm.org/).
- Devsus' workaround for ath9k_htc instability issues has been adopted from
- PrawnOS (https://github.com/SolidHal/PrawnOS) and found by SolidHal.
- Devsus is free and unencumbered software released under the terms of the GNU
- General Public License, version 2; see COPYING for the license text. For a list
- of its authors and contributors, see AUTHORS.
- The ASCII art logo at the top was made using FIGlet (http://www.figlet.org/).
|