RASCSI/python/ctrlboard
2023-12-18 00:41:51 -08:00
..
resources
service-infra Launch python client services only after network-online target (#1197) 2023-07-31 12:12:53 -07:00
src Control Board: Use Pillow 10 API for getting text size 2023-12-18 00:41:51 -08:00
__init__.py
README.md Rebrand project to PiSCSI (#1016) 2022-12-05 09:58:23 -08:00
requirements.txt Freeze Python requirements for the Control Board client 2023-12-16 01:32:32 -08:00
start.sh Rebrand project to PiSCSI (#1016) 2022-12-05 09:58:23 -08:00

PiSCSI Control Board UI

Run as standalone script for development / troubleshooting

# Make a virtual env named venv
$ python3 -m venv venv
# Use that virtual env in this shell
$ source venv/bin/activate
# Install requirements
$ pip3 install -r requirements.txt
$ python3 src/main.py

Parameters

The script parameters can be shown with

python src/main.py --help

or

start.sh --help

Example:

$ python3 src/main.py --rotation=0 --transitions=0

Run the start.sh script standalone

The start.sh script can also be run standalone, and will handle the venv creation/updating for you. It takes the same command line parameters in the following format:

$ ./start.sh --rotation=0 --transitions=0

I2C baudrate and transitions

The available bandwidth for the display through I2C is limited. The I2C baudrate is automatically adjusted in easy_install.sh and start.sh to maximize the possible baudrate, however, depending on the Raspberry Pi model in use, we found that for some models enabling the transitions does not work very well. As a result, we have implemented a model detection for the raspberry pi model and enable transitions only for the following pi models:

  • Raspberry Pi 4 models
  • Raspberry Pi 3 models
  • Raspberry Pi Zero 2 models

The model detection can be overriden by adding a --transitions parameter to start.sh.

Credits

DejaVuSansMono-Bold.ttf

splash_start_*.bmp, splash_stop_*.bmp

  • Drawn by Daniel Markstedt
  • Distributed under BSD 3-Clause by permission from author (see LICENSE for full text)