pi_display_webthing
A web connected LCD display module
This project provides a webthing API to an I2C LCD module such as a HD44780 1602 LCD Module on the Raspberry Pi. As a webthing, the LCD can be discovered and controlled by home automation systems or custom solutions supporting the webthing API.
The pi_display_webthing exposes an http webthing endpoint which supports controlling the display via http. E.g.
# webthing has been started on host 192.168.0.23
curl http://192.168.0.23:8070/properties
{
"text": "Hello\n\rraspi",
"upper_layer_text": "Hello\n\rraspi",
"upper_layer_text_ttl": -1,
"middle_layer_text": "uploaded: 41",
"middle_layer_text_ttl": -1,
"lower_layer_text": "",
"lower_layer_text_ttl": -1
}
Here, the text Hello\n\rraspi will be displayed. The text of the middle layer uploaded: 41 will be covered by the upper layer. If the text of the upper layer will be cleaned, the displayed text is uploaded: 41. By setting the ttl of the layer, the text of the layer will be disappear after expiration of the ttl. Value -1 means that ttl is deactivated.
The text of a dedicated layer can be updated as shown below
curl -v -X PUT -d "{\"upper_layer_text\": \"Hello world\"}" http://192.168.1.101:8088/properties/upper_layer_text
The RaspberryPi/LCD hardware setup and wiring may look like HD44780 1602 LCD module. By default, Raspberry Pi OS disables I2C. Please refer Configure I2C to activate I2C and to detect the address of the LCD module.
To install pi_display_webthing you may use Docker or PIP package manager such as shown below
Docker approach
sudo docker run -p 8070:8070 --device /dev/i2c-1:/dev/i2c-1 -e i2c_expander=PCF8574 -e i2c_address=0x27 grro/pi_display_webthing:0.1.0
PIP approach
sudo pip install pi_display_webthing
After this installation you may start the webthing http endpoint inside your python code or via command line using
sudo display --command listen --port 8070 --i2c_expander PCF8574 --i2c_address 0x27
Here, the webthing API will be bind on port 8070 using a 2/16 display layout on address 0x27. Further more the port I2C port expander name has to be set. The expander name should be written on the microchip. Supported port expanders are PCF8574, MCP23008 and MCP23017
Alternatively to the listen command, you can use the register command to register and start the webthing service as systemd unit. By doing this the webthing service will be started automatically on boot. Starting the server manually using the listen command is no longer necessary.
sudo display --command register --port 8070 --i2c_expander PCF8574 --i2c_address 0x27
1 maintainer
Metadata
1 maintainer
Release files for pi-display-webthing 0.1.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| pi_display_webthing-0.1.8.tar.gz | 7.1 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pi_display_webthing-0.1.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 20.0 kB
Release files / pi_display_webthing-0.1.8.tar.gz
| Download URL | pi_display_webthing-0.1.8.tar.gz |
|---|---|
| Size | 7.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
335c930968deeeab92a0cbd3f347909ddef5d994199629cd7c54602993d508c5
|
|
BLAKE2b-256 checksum How to use checksums |
bd33d412fa64e39cd566d13bd2b5bf934a553de31aa532052b15c3f667b83196
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.0 CPython/3.9.12
|
Release files / pi_display_webthing-0.1.8-py3-none-any.whl
| Download URL | pi_display_webthing-0.1.8-py3-none-any.whl |
|---|---|
| Size | 12.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
10c0ee669ac63f0197348322cda49bef88f6af640d74f09ab01995e68ca821d0
|
|
BLAKE2b-256 checksum How to use checksums |
6ba010baafc63bdc0a114da09be060617672c2ed7e3d7f436bfd793ab0d7c10d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.0 CPython/3.9.12
|
Security for pi-display-webthing 0.1.8
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
