History

Daniel Markstedt 5befff28e6 Improve token auth and oled monitor install scripts; better venv cleanup logic (#587 ) * Trigger installation of the oled monitor script after installing rascsi; break out the token auth code and clarify wordings. * Better logic for venv cleanup		2022-01-01 11:38:10 -06:00
..
.pylintrc	Refactoring of OLED screen Python script (#413 )	2021-11-02 20:20:42 -05:00
README.md	Add support for 64px OLED screen height (#448 )	2021-11-13 19:40:49 -06:00
interrupt_handler.py	Refactoring of OLED screen Python script (#413 )	2021-11-02 20:20:42 -05:00
monitor_rascsi.service	Remove special elevated privileges for the Web Interface (#536 )	2021-12-19 17:50:03 -06:00
pi_cmds.py	More helpful error message when IP does not resolve for OLED screen (#541 )	2021-12-20 08:20:22 -06:00
ractl_cmds.py	Add token authentication to Web UI and OLED monitor script (#554 )	2021-12-23 11:12:16 -06:00
rascsi_oled_monitor.py	Optimized oled script startup and shutdown (#573 )	2021-12-28 14:10:42 -06:00
requirements.txt	Make the OLED script work on Bullseye (#470 )	2021-11-14 19:48:46 -06:00
socket_cmds.py	Remove special elevated privileges for the Web Interface (#536 )	2021-12-19 17:50:03 -06:00
splash_start_32.bmp	Add support for 64px OLED screen height (#448 )	2021-11-13 19:40:49 -06:00
splash_start_64.bmp	Add support for 64px OLED screen height (#448 )	2021-11-13 19:40:49 -06:00
start.sh	Improve token auth and oled monitor install scripts; better venv cleanup logic (#587 )	2022-01-01 11:38:10 -06:00
type_writer.ttf	Use Type Writer font on the OLED screen (Author: Mandy Smith) (#377 )	2021-10-25 17:41:36 -05:00

README.md

RaSCSI OLED Screen

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 rascsi_oled_monitor.py

Parameters

The script takes two positional parameters:

'0' or '180' which decides the screen rotation
'32' or '64' which decides the vertical screen resolution in pixels

Ex.

$ python3 rascsi_oled_monitor.py 180 64

Note: Both parameters must be passed for the script to read them. Ordering is also important.

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=180 --height=64

Static analysis with pylint

It is recommended to run pylint against new code to protect against bugs and keep the code readable and maintainable. The local pylint configuration lives in .pylintrc (symlink to ../.pylintrc)

$ sudo apt install pylint3
$ pylint3 python_source_file.py

Credits

type_writer.ttf

Type Writer TrueType font by Mandy Smith
Source: https://www.dafont.com/type-writer.font
Distributed under BSD 3-Clause by permission from author (see LICENSE for full text)

splash_start_.bmp, splash_stop_.bmp

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