2018-06-28 15:55:55 +02:00
# Librean
2018-06-21 17:53:22 +02:00
2018-06-21 21:05:05 +02:00
A build system for making blobless debian and mainline kernel for the Asus c201 Chromebook
Build a mainline kernel and Debian filesystem with:
No blobs, anywhere.
Support for Aetheros AR271 usb wifi dongles through the open source firmware
Minimal toolset intended as a based, including tools to setup a wifi connection
Sources from only main, not contrib or non-free which keeps Debian libre
TODO: basic graphical desktop like xfce
### why
Combined with libreboot,an AR271 wifi dongle, and a libre OS (like Debian, the one built by this) the asus c201 is a fully libre machine with no blobs, or microcode.
### Dependencies
2018-06-28 16:15:46 +02:00
Librean has been tested on Debian 9 Stretch (in a vm)
2018-06-21 21:05:05 +02:00
These packages are required:
```
apt install --no-install-recommends --no-install-suggests \
parted cgpt \
git gawk device-tree-compiler vboot-kernel-utils gcc-arm-none-eabi \
2018-06-28 16:15:46 +02:00
u-boot-tools \
2018-06-21 21:05:05 +02:00
gcc make libc-dev wget g++ cmake \
binfmt-support qemu-user-static debootstrap \
2018-06-22 15:23:01 +02:00
lzip libssl-dev libncurses-dev flex bison
2018-06-21 21:05:05 +02:00
```
2018-06-28 16:15:46 +02:00
### Build
2018-06-21 21:05:05 +02:00
Currently split between 'buildKernel.sh' and 'buildDebianFs.sh'
2018-06-28 16:15:46 +02:00
Run the kernel one then the fs one.
### Install
Write the 2GB image to a flash drive, which contains the full 15GB (acutally 14.7GB) to write to the internal storage. We can do this since the 15GB image is a sparse file.
```
sudo dd if=debian-stretch-c201-libre-2GB.img of=/dev/$USB_DEVICE bs=50M
```
Now on the C201, login as root. The password is blank.
Write the 15GB image to the internal storage
For me this was /dev/mmcblk2 but it may be /dev/mmcblk1 for you depending on what device it assigns to sdcards
```
dd if=/debian-stretch-c201-libre-2GB.img of=/dev/$DEVICE bs=50M
```
Reboot. Run /Install.sh which will install xfce, wicd, and some device configurations. This will reboot one last time when done.
```
/Install.sh
```
You should now be greeted by the xfce login screen.
If you just want a basic enviroment without xfce upu can skip running Install.sh but I recommend installing wicd-curses for wifi configuration.
2018-06-21 21:05:05 +02:00
### GPU Support
2018-06-21 17:53:22 +02:00
Watch this link for gpu support:
https://gitlab.freedesktop.org/panfrost
2018-06-28 16:15:46 +02:00
and this one for progress updates:
https://rosenzweig.io/blog/gpu-feed.xml
2018-06-21 17:53:22 +02:00
2018-06-21 21:05:05 +02:00
### Build the wifi dongle into the laptop
2018-06-28 16:15:46 +02:00
Check out the instructions here: https://github.com/SolidHal/AsusC201-usb-wifi-from-webcam
### Troubleshooting
The pulse audio mixer will only run if you are logged in as a non root account. This is an issue (feature?) of pulse audio
2018-06-21 21:05:05 +02:00
### Credits and Legal Information
2018-06-28 16:15:46 +02:00
Thanks to dimkr for his great devsus scripts, from which Librean took much inspiration
2018-06-21 21:05:05 +02:00
https://github.com/dimkr/devsus
2018-06-21 21:16:21 +02:00
Because of this started as a fork of devsus, much of this repos history can be found at https://github.com/SolidHal/devsus/tree/hybrid_debian
2018-06-28 16:15:46 +02:00
Librean is free and unencumbered software released under the terms of the GNU
2018-06-21 21:05:05 +02:00
General Public License, version 2; see COPYING for the license text. For a list
of its authors and contributors, see AUTHORS.