Added detailed instructions to README

This commit is contained in:
SolidHal 2018-06-28 08:15:46 -06:00 committed by GitHub
parent 71e7d3bc46
commit 370529820c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -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.