Skip to content

Commit

Permalink
docs: add initial rpi install documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
electrikjesus committed Apr 19, 2024
1 parent 1fb0ebc commit e6cef50
Show file tree
Hide file tree
Showing 14 changed files with 70 additions and 2 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Installation/raspberry-pi/images/rpi-imager.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
62 changes: 62 additions & 0 deletions Installation/raspberry-pi/raspberry-pi-installation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# Bass OS 13 for the Raspberry PI 4 series based on the GloDroid project

[![GloDroid](https://img.shields.io/badge/GLODROID-PROJECT-blue)](https://github.com/GloDroid/glodroid_manifest)
[![ProjectStatus](https://img.shields.io/badge/PROJECT-STATUS-yellowgreen)](https://github.com/GloDroidCommunity/raspberry-pi/issues/1)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

## Flashing images

### Requirements

##### Raspberry Pi Imager
Download and install the official Raspberry Pi Imager from [here](https://www.raspberrypi.com/software/)

##### sdcard.img
Find the latest Bass rpi image archive sdcard images for your target use-case [here](https://sourceforge.net/projects/bliss-co-labs/files/BlissBass/Raspberry-Pi/)

### Step 1
Extract the sdcard archive using xz/7zip/Winzip/etc.

### Step 2
Launch the Raspberry Pi Imager application
![imager UI](images/rpi-imager.png)

### Step 3
Select the **CHOOSE DEVICE** button and select the **Raspberry Pi 4**
![select device](images/rpi-imager-select.png)

### Step 4
Select the **CHOOSE OS** button and scroll down to the bottom of the list, selecting **Use custom**
![custom image](images/rpi-imager-custom-image.png)

### Step 5
Click on the **CHOOSE STORAGE** button, and select your SD Card device
![storage](images/rpi-imager-storage.png)

### Step 6
Once you have all the parts selected, the Next button will be enabled:
![next](images/rpi-imager-next.png)

Clicking the **NEXT** button will ask if you want to make any custom changes. Select **NO**
![no custom](images/rpi-imager-no-custom.png)

### Step 7
The next question will be a confirmation dialog, making sure you want to erase the contents of the SDCard. Select **YES** to continue.
![erase](images/rpi-imager-erase.png)

### Step 8
The Imager will then ask for root permissions, and once provided, it will start to flash the sdcard.img onto the SDCard:
![writing](images/rpi-imager-writing.png)

Once completed, the Imager will show a **Write Successful** dialog.
![finished](images/rpi-imager-finish.png)

You can safely remove the SDCard from the PC, and plug it into the Raspberry Pi.

## Booting

After flashing the SDCard, insert it into the device and turn it on, and it will boot into the OS.

Depending on the version (application use-case), you should let the OS reach the desktop and wait while the target configurations are being set. This process will be setting up configs, apps, and permissions for the user environment, so it may take a bit.

Pressing the home button should make sure that you are set to the correct launcher UI when everthing is all set.
File renamed without changes.
File renamed without changes.
10 changes: 8 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,14 @@ icon: home

## Install Bass OS

* [Install From Bootable USB](Installation/install-from-bootable-usb.md)
* [Collecting bug reports](Installation/collecting-bug-reports.md)
### x86_64-v2 (A12, A13)

* [Install From Bootable USB](Installation/x86_64-v2/install-from-bootable-usb.md)
* [Collecting bug reports](Installation/x86_64-v2/collecting-bug-reports.md)

### Raspberry Pi (A13)

* [Raspberry Pi Installation](Installation/raspberry-pi/raspberry-pi-installation.md)

## Configuration

Expand Down

0 comments on commit e6cef50

Please sign in to comment.