iicd/Inkycal
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

updating instructions...

Browse Source
This commit is contained in:
Ace
2020-12-05 23:30:53 +01:00
committed by GitHub
parent 245178c7a4
commit 9ca3519857
1 changed files with 32 additions and 40 deletions
Download Patch File Download Diff File Expand all files Collapse all files

54
README.md
View File

@@ -43,6 +43,25 @@ This software is in active development. To see the current development status, [
* MicroUSB cable (for power) * MicroUSB cable (for power)
* Optional, a [3D-printable case](https://github.com/aceisace/Inkycal/wiki/3D-printable-files) * Optional, a [3D-printable case](https://github.com/aceisace/Inkycal/wiki/3D-printable-files)
# Installing Inkycal
## Configuring the Raspberry Pi
1. Flash Raspberry Pi OS according to the [instructions](https://www.raspberrypi.org/software/)
2. Create a settings file for Inkycal from the [WEB-UI](https://aceisace.eu.pythonanywhere.com/inkycal-config-v2-0-0)
3. Copy the generated settings.json file to the flashed SD card.
4.
## Getting the Raspberry Pi ready
1. Flash Raspberry Pi OS according to the instructions ([instructions](https://www.raspberrypi.org/software/))
2. Create a simple text document named **ssh** in the boot directory to enable ssh.
3. Install the SD card and boot your Raspberry Pi. Connect to it over the network with ssh and login.
3. Expand the filesystem in the Terminal with **`sudo raspi-config --expand-rootfs`**
4. Enable SPI by entering **`sudo sed -i s/#dtparam=spi=on/dtparam=spi=on/ /boot/config.txt`** in the Terminal
5. Set the correct timezone with **`sudo dpkg-reconfigure tzdata`**, selecting the correct continent and then the capital of your country.
6. Reboot to apply changes
7. Optional: If you want to disable the on-board leds of the Raspberry, follow these instructions:
**[Disable on-board-led](https://www.jeffgeerling.com/blogs/jeff-geerling/controlling-pwr-act-leds-raspberry-pi)**
### Installation ### Installation
```bash ```bash
# clone the Inkycal repo # clone the Inkycal repo
@@ -55,47 +74,20 @@ cd Inkycal
pip3 install -e ./ pip3 install -e ./
``` ```
### Creating a settings file
Please visit the [Online WEB-UI](https://aceisace.eu.pythonanywhere.com/inkycal-config-v2-0-0) to create your settings.json file.
* Fill in the details and click on `generate` to create your **settings.json** file
* Copy the **settings.json** file to your raspberry pi (e.g. copy directly from computer to the SD Card, WinSCP, VNC etc.) to the `/BOOT` directory.
### Running Inkycal ### Running Inkycal
Open `Python3` and run the commands below or paste the below content in an empty file and save it as a `.py` file: Open `Python3` and run the commands below or paste the below content in an empty file and save it as a `.py` file:
```python3 ```python3
# Open Python3 and import package from inkycal import Inkycal # Import Inkycal
from inkycal import Inkycal
# tell the Inkycal class where your settings file is inky = Inkycal(render = True) # Initialise Inkycal
inky = Inkycal('/path/to/your/settings/file', render = True) inky.test() # test if Inkycal can be run correctly, running this will show a bit of info for each module
# render means rendering (showing) on the ePaper. Setting render = False will not show anything on the ePaper inky.run() # If there were no issues, you can run Inkycal nonstop
# test if Inkycal can be run correctly, running this will show a bit of info for each module
inky.test()
# If there were no issues, you can run Inkycal nonstop:
inky.run()
``` ```
## Uninstalling Inkycal ## Uninstalling Inkycal
1) `pip3 uninstall inkycal` 1) `pip3 uninstall inkycal`
2) Remove the `Inkycal` folder 2) Remove the `Inkycal` folder
# Setup
## Getting the Raspberry Pi Zero W ready
1. Flash Raspberry Pi OS according to the instructions ([instructions](https://www.raspberrypi.org/software/))
2. Create a simple text document named **ssh** in the boot directory to enable ssh.
3. Install the SD card and boot your Raspberry Pi. Connect to it over the network with ssh and login.
3. Expand the filesystem in the Terminal with **`sudo raspi-config --expand-rootfs`**
4. Enable SPI by entering **`sudo sed -i s/#dtparam=spi=on/dtparam=spi=on/ /boot/config.txt`** in the Terminal
5. Set the correct timezone with **`sudo dpkg-reconfigure tzdata`**, selecting the correct continent and then the capital of your country.
6. Reboot to apply changes
7. Optional: If you want to disable the on-board leds of the Raspberry, follow these instructions:
**[Disable on-board-led](https://www.jeffgeerling.com/blogs/jeff-geerling/controlling-pwr-act-leds-raspberry-pi)**
## Contributing ## Contributing
All sorts of contributions are most welcome and appreciated. To start contributing, please follow the [Contribution Guidelines](https://github.com/aceisace/Inkycal/blob/development/CONTRIBUTING.md). All sorts of contributions are most welcome and appreciated. To start contributing, please follow the [Contribution Guidelines](https://github.com/aceisace/Inkycal/blob/development/CONTRIBUTING.md).