diff --git a/README.md b/README.md index 02594ac..f6e5c2a 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# debsus +# Librean A build system for making blobless debian and mainline kernel for the Asus c201 Chromebook @@ -16,39 +16,68 @@ Combined with libreboot,an AR271 wifi dongle, and a libre OS (like Debian, the o ### Dependencies -Debsus has been tested on Debian Stretch (in a vm) +Librean has been tested on Debian 9 Stretch (in a vm) 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 \ - u-boot-tools \ + u-boot-tools \ gcc make libc-dev wget g++ cmake \ binfmt-support qemu-user-static debootstrap \ lzip libssl-dev libncurses-dev flex bison ``` -### Building +### Build Currently split between 'buildKernel.sh' and 'buildDebianFs.sh' -Run the kernel one then the fs one. +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. ### GPU Support Watch this link for gpu support: https://gitlab.freedesktop.org/panfrost +and this one for progress updates: +https://rosenzweig.io/blog/gpu-feed.xml ### Build the wifi dongle into the laptop -Check out my instructions here: https://github.com/SolidHal/AsusC201-usb-wifi-from-webcam +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 ### Credits and Legal Information -Thanks to dimkr for his great devsus scripts, which debsus is based on +Thanks to dimkr for his great devsus scripts, from which Librean took much inspiration https://github.com/dimkr/devsus 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 -Debsus is free and unencumbered software released under the terms of the GNU +Librean 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. diff --git a/buildDebianFs.sh b/buildDebianFs.sh index 9ea74c6..2b9bcad 100755 --- a/buildDebianFs.sh +++ b/buildDebianFs.sh @@ -8,8 +8,8 @@ KVER=4.17.2 outmnt=$(mktemp -d -p `pwd`) inmnt=$(mktemp -d -p `pwd`) -outdev=/dev/loop4 #CHANGE BEFORE COMMIT -indev=/dev/loop5 #CHANGE BACK BEFORE COMMIT +outdev=/dev/loop4 +indev=/dev/loop5 #A hacky way to ensure the loops are properly unmounted and the temp files are properly deleted. #Without this, a reboot is required to properly clean the loop devices and ensure a clean build