Documentation to create an RPi image from scratch

README.md

@@ -32,6 +32,7 @@ Full Version             |  Pocket Version
 - [autostart](/docs/guide/autostart.md)
 - [camera](/docs/guide/camera.md)
 - [aditional information and tips](/docs/guide/information_and_tips.md)
+- [RPi image from scratch](/docs/guide/add_on_zero2.md)
 
 A comprehensive guide on how to setup the LightningATM can be found here https://docs.lightningatm.me. Also join the Telegram group of LightningATM builders here https://t.me/lightningatm_building or contact 21isenough on Twitter (https://twitter.com/21isenough).
 

docs/guide/add_on_zero2.md

@@ -0,0 +1,122 @@
+##  Raspberry Pi image from scratch. (For example for the RPi Zero 2) 
+
+#### `Warning:` It is not recommended to use the RPi Zero 2 for the Lightning ATM. However, if you already have one, you can use this guide to get it working. 
+
+The Raspberry Pi Zero 2 is not supported in the Raspberry "Stretch" version. The tried and tested "2019-04-08-raspbian-stretch-lightningatm.gz" image does not run on the Zero 2. Accordingly, a new image must be created that supports the Zero 2. The current [Bullseye](https://en.wikipedia.org/wiki/Raspberry_Pi_OS) version (32-bit) does this. This image can be used for this, but still needs to be modified so that it can be used for the Lightning ATM.
+
+Unfortunately, the new version does not support all components directly. The Waveshare displays are direct compatible and for the PaPiRus displays you have to install the library. 
+
+This guide to creating a compatible version is only a guide. Deviations are possible and maybe even necessary. For the best result, however, it is recommended to stick to the procedure. Otherwise, troubleshooting support will be difficult. Since this is an experimental setting, any guarantee or warranty is excluded.
+
+### The individual steps:
+
+1. Creation of the raw image
+2. Write the raw image with SSH and Wifi data
+3. First start and first settings
+4. Option: Install PaPiRus display library 
+5. Carry out updates and installations
+6. Install and test the display
+7. Edit utilis.py
+8. Create and edit the config.ini
+9. Postprocessing
+
+---
+
+### 1. Creation of the raw image
+
+Find the appropriate Raspberry Pi OS (32-bit) image from the raspberrypi.org [Archive](https://downloads.raspberrypi.org/raspios_armhf/images/) and download it. You can use a newer version, but the "2022-01-28-raspios-bullseye-armhf.zip" version was tested for this tutorial. Unpack the file and write the image with [balenaEtcher](https://www.balena.io/etcher/). When done, remove the microSD.
+
+### 2. Write the raw image with SSH and Wifi data
+
+- Create an empty file named "SSH" in preparation. Make sure that the file has __no__ file extension such as ".txt". It is just called SSH and will later activate the SSH connection on the Raspberry Pi.
+- Create a "wpa_supplicant.conf" file as described in chapter [sd card and wifi](/docs/guide/sdcard_and_wifi.md). This gives the Raspberry Pi the necessary information about your Wifi.
+- Put the newly written microSD back into the computer slot and copy both files into the "boot" directory.
+- Remove the microSD. It is now ready for the Raspberry Pi Zero.
+
+### 3. First start and first settings
+
+After starting the Zero 2 and waiting a few minutes. Then you can log in as described in the [sd card and wifi](/docs/guide/sdcard_and_wifi.md) chapter.
+
+- Change the password and remember it!
+
+		$ passwd
+
+-   Activate the SPI interface for the display.
+
+		$ sudo raspi-config
+
+<img src="../pictures/add_on_zero2_SPI_1.png" width="500">
+<img src="../pictures/add_on_zero2_SPI_2.png" width="500">
+<img src="../pictures/add_on_zero2_SPI_3.png" width="500">
+<img src="../pictures/add_on_zero2_SPI_4.png" width="500">
+
+- Exit with "Finish".
+
+### 4. Option: Install PaPiRus display library 
+
+If you use a PaPiRus Display, you have to install the PaPiRus display library. If you have a Waveshare or other, you can cancel this step.
+
+	$ curl -sSL https://pisupp.ly/papiruscode | sudo bash
+
+Set it to Python 3
+
+<img src="../pictures/add_on_zero2_PaPiRus_1.png" width="500">
+
+Choose your display size
+
+<img src="../pictures/add_on_zero2_PaPiRus_2.png" width="500">
+
+
+### 5. Carry out updates and installations
+
+It's the same like described in chapter [sdcard_and_wifi](/docs/guide/sdcard_and_wifi.md). Run the following commands one by one.
+
+```
+	$ sudo apt update && sudo apt upgrade
+	$ git clone https://github.com/21isenough/LightningATM.git
+	$ cd ~/LightningATM/
+	$ pip3 install -r requirements.txt
+```
+Note: When updating, you sometimes have to confirm with `y`.
+
+### 6. Install and test the display
+
+As described in the [display](/docs/guide/display.md) chapter.
+
+### 7. Edit utilis.py (If you don't have the PaPiRus library installed)
+
+The driver for the PaPiRus display is not pre-installed. So that they do not report an error, the functions are deactivated here or you can alternatively install the PaPiRus library.
+
+#### Edit utils.py
+
+```
+	$ cd ~/LightningATM/
+	$ nano utils.py
+```
+Preassign the variable EPD_SIZE with 2.0, because the called directory for the PaPiRus display initial values are not existing.
+
+<img src="../pictures/add_on_zero2_edit_utils.png" width="600">
+
+Save and exit the editor: `CTRL+x -> y -> ENTER`.
+
+### 8. Create and edit the config.ini
+
+Start the app.py once.
+
+<img src="../pictures/add_on_zero2_edit_config.png" width="400">
+
+The program is immediately aborted with "Exiting..." because the wrong display is still stored in the basic setting. But the config.ini was created in the background and you can open and edit it as described in chapter [edit config.ini](/docs/guide/edit_config.md).
+
+### 9. Postprocessing
+
+Everything else is as usual and listed in the [README](/README.md).
+
+Look at:
+
+- [edit app.py](/docs/guide/edit_app.md)
+- [tmux monitoring](/docs/guide/tmux_monitoring.md)
+- [autostart](/docs/guide/autostart.md)
+
+---
+
+#### [information_and_tips](/docs/guide/information_and_tips.md)  ᐊ  previous | next  ᐅ  [README](/README.md)

docs/guide/information_and_tips.md

@@ -11,4 +11,4 @@
 
 ---
 
-#### [camera](/docs/guide/camera.md)  ᐊ  previous | next  ᐅ  [README](/README.md)
+#### [camera](/docs/guide/camera.md)  ᐊ  previous | next  ᐅ  [RPi image from scratch](/docs/guide/add_on_zero2.md)