A set of python scripts to display replica near real-time UK railway station departure data on SSD13xx style screens. Uses the publicly available Transport API.
NOW WITH BACKPORTED CHANGES!
To run this code, you will need Python 3.6+
To install the latest version of Python (3.7 at time of writing) on Raspbian, go here.
You will likely need to set up an alias so that when you type Python you get the latest installed version, a handy guide on how to do this on Raspbin is here. If you used the above guide to install the latest Python your path to the executable will be /usr/local/bin/python3.x
If you're using Raspbian Lite, you'll also need to install:
libopenjp2-7with:$ sudo apt-get install libopenjp2-7
Clone this repo
Install dependencies
$ pip3 install -r requirements.txtIf you installed Python using the above guide you will need to use pip3 instead of pip to install the requirements, if not or if your pip is aliased to python 3.6+ you can just use pip
Sign up for the Transport API, and generate an app ID and API key (note the free tier has 1000 request a day).
Copy config.sample.json to config.json and complete.
{
"journey": {
"departureStation": "",
"destinationStation": null,
"stationAbbr": {
"International": "Intl."
},
"outOfHoursName": "Hogwarts"
},
"refreshTime": 180,
"transportApi": {
"appId": "",
"apiKey": "",
"operatingHours": "0-23"
}
}refreshTime - how frequently it asks for new data from the transport api, there will be two api calls each time this time elapses, be aware the free tier has 1000 calls a day.
departureStation - the short code for the starting station
destinationStation - the optional short code for the destination station
stationAbbr - a list of words and their abbreviations that can be used to shorten station names, useful for small displays.
outOfHoursName - the station name to display when out of hours.
appId - your transport api application ID
apiKey - your transport api key
operating hours - the range of hours you wish the display to actively request train times, be aware the free tier API has a limit of 1000 calls a day.
There is an example run.sh script in the root directory that will start the application and attempt to talk to a SSD1322 display via SPI. You will need to adjust this to suit your own requirements
For example
Change the --display flag to alter the output mechanism (a list of options can be found in this README: https://github.com/rm-hull/luma.examples). Use capture to save to images, and pygame to run a visual emulator.
Pass --interface spi if you are using SPI to communicate with your screen. Otherwise, the default of i2c should suffice.
$ python ./src/main.py --display ssd1322 --width 256 --height 64 --interface spi
Click here for a video demo of the display running in a 3D printed case. https://youtu.be/rQiCBnV9Zi4
I have designed a 3D printed case in OpenSCAD, it should fit a SSD1322 module (specifically this one https://www.aliexpress.com/item/32921021149.html?spm=a2g0s.9042311.0.0.27424c4dnjcngM) and a standard Raspberry Pi Zero W. The files can be found in the 3d-printed-case folder.
A big thanks to Chris Hutchinson who originally built this code! He can be found on GitHub at https://github.com/chrishutchinson/
The fonts used were painstakingly put together by DanielHartUK and can be found on GitHub at https://github.com/DanielHartUK/Dot-Matrix-Typeface - A huge thanks for making that resource available!
This has been backported from the Balena version (https://github.com/balenalabs/uk-train-departure-display) that forked from this repo, I wanted to remove the deployment side of it / docker etc.