g/PrawnOS-nonfree
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Update README, include build and install instructions

Browse Source
This commit is contained in:
SolidHal 2018-09-08 16:07:35 +00:00 committed by GitHub
parent 5965d0e6cc
commit 33de917759
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 41 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

57
README.md
View File

@ -30,31 +30,55 @@ These packages are required:
``` ```
### Build ### Build
Clone this git repo.
Run 'BuildPrawnOS.sh' either with sudo or as root. Note that building the kernel as root is ill-advised Build the `PrawnOS-...-.img` by running `sudo make image`
but I haven't ran into any issues.
Currently split between 'buildKernel.sh' and 'buildDebianFs.sh' This has only been tested on a Debian stretch VM, and borrows some components from the host system to setup apt/debootstrap during the build process so I would recommend using a Debian Stretch VM to avoid any issues.
Run the kernel one then the fs one.
### Install ### 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. Write the 2GB image to a flash drive. Make sure to replace $USB_DEVICE with the desired target flash drive
``` ```
sudo dd if=PrawnOs-Alpha-c201-libre-2GB.img of=/dev/$USB_DEVICE bs=50M sudo dd if=PrawnOs-*-c201-libre-2GB.img of=/dev/$USB_DEVICE bs=50M
``` ```
Now on the C201, login as root. The password is blank. Now on the C201, login as root. The password is blank.
Write the 15GB image to the internal storage If you would like to install it to the internal emmc storage run:
For me this was /dev/mmcblk2 but it may be /dev/mmcblk1 for you depending on what device it assigns to sdcards WARNING! THIS WILL ERASE YOUR INTERNAL EMMC STORAGE (your chrome OS install or other linux install and all of the associated user data) MAke sure to back up any data you would like to keep before running this.
WIP
Reboot. Run /Install.sh which will install lxqt, wicd, and some device configurations. This will reboot one last time when done.
``` ```
/Install.sh cd /
./InstallToInternal.sh
``` ```
You should now be greeted by a login screen. The device will then reboot, and should boot to the internal storage by default. If it doesn't, turn off the device and remove the flash drive before turning it on again.
Now login as root again and run:
```
cd /InstallResources
./InstallPackages.sh
```
Which installs the lxqt desktop enviroment, wicd, sound, trackpad, and Xorg configurations as well as prompts you to make a new user that automatically gets sudo priviledges.
When finished, it will reboot once again placing you at a login screen.
If you just want a basic enviroment without xfce upu can skip running InstallPackages.sh but I recommend installing wicd-curses for wifi configuration. Since the package is doenloaded but not installed by the build process, you can do that by running:
```
apt install wicd-curses
```
Congratulations! YOur computer is now a Prawn! https://sprorgnsm.bandcamp.com/track/the-prawn-song
### Make options, developer tools
(ALl of these should be ran as root or with sudo to avoid issues)
The makefile automates many processes that make debuggung the kernel or the filesystem easier.
TO begin with:
`make kernel_config` cross compiles `make menuconfig` Cross compiling is required for any of the linux kernel make options that edit the kernel config, as the linux kernel build system makes assumptions that change depending on what platform it is targeting.
`make kernel` builds just the kernel
`make filesystem` builds the filesystem and kernel into a PrawnOS.img
`make kernel_inject` Injects a newly built kernel into a previously build PrawnOS.img located in the root of the checkout
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 ### GPU Support
@ -82,3 +106,4 @@ Because of this started as a fork of devsus, much of this repos history can be f
PrawnOS is free and unencumbered software released under the terms of the GNU PrawnOS 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 General Public License, version 2; see COPYING for the license text. For a list
of its authors and contributors, see AUTHORS. of its authors and contributors, see AUTHORS.