This repository contains all the code for interfacing with a 16x2 character I2C liquid-crystal display (LCD). This accompanies my Youtube tutorial: Raspberry Pi - Mini LCD Display Tutorial.
You can buy one of these great little I2C LCD on eBay or somewhere like the Pi Hut.
-
Install git
sudo apt install git
-
Clone the repo in your home directory
cd /home/${USER}/ git clone https://github.com/the-raspberry-pi-guy/lcd.git cd lcd/
-
Run the automatic installation script with
sudopermissionsudo ./install.sh
-
During the installation, pay attention to any messages about
pythonandpython3usage, as they inform which version you should use to interface with the LCD driver. For example:[LCD] [INFO] You may use either 'python' or 'python3' to interface with the lcd.
or alternatively,
[LCD] [INFO] Use 'python3' to interface with the lcd.
-
At the end of the installation script, you'll be prompted to reboot the RPi to apply the changes made to
/boot/config.txtand/etc/modules. -
After rebooting, try one of the demos:
./home/${USER}/lcd/demo_clock.pyor
python /home/${USER}/lcd/demo_clock.pyor
python3 /home/${USER}/lcd/demo_clock.py
A list of demonstration (demo) files that illustrate how to use the LCD driver. Demos are ordered alphabetically.
- Author: @Tomtom0201
This demo showcases the backlight control of the LCD, which is available on some hardware:
- Author: @juvus
It is possible to define in CG RAM memory up to 8 custom characters. These characters can be prompted on LCD the same way as any characters from the characters table. Codes for the custom characters are unique and as follows:
{0x00}{0x01}{0x02}{0x03}{0x04}{0x05}{0x06}{0x07}
Please, see the comments and implementation in the demo_lcd_custom_characters.py file for more details on how to use custom characters. Thanks to @Jumitti, there is also a web app you can use to generate custom characters by drawing them on a matrix.
- Author: @juvus
This is demo showcases how extended strings could be used. Extended strings can contain special placeholders of form {0xFF}, that is, a hex code of the symbol wrapped within curly brackets. Hex codes of various symbols can be found in the following characters table:
For example, the hex code of the symbol ö is 0xEF, and so this symbol could be printed on the second row of the display by using the {0xEF} placeholder, as follows:
display.lcd_display_extended_string("{0xEF}", 2)If you want to combine placeholder to write a symbol {0xFF} with the native Python placeholder {0} for inserting dome data into text, escape the non-native placeholders. Here is an example:
display.lcd_display_extended_string("Symbol:{{0xEF}} data:{0}".format(5), 2)
- Author: @Jumitti
- Repository: Jumitti/lcd_home_automation
This implementation shows how to use the LCD to display messages from temperature sensors and services such as Spotify and Trakt (see below). The implementation also features an integration with Telegram to turn the LCD backlight on/off and send a few other commands to control the host machine (e.g., get the temperature, reboot, shutdown). @Jumitti documented the project on its own Home Automation repository, so make sure to check it out if you want to learn more about it.
- Author: @Sierra007117
Display your Pi's IP address, which is useful for SSH access and more!
- Author: @Tomtom0201
This demo shows how simple strings could be displayed on the LCD. For extended usage, take a look at Extended strings demo instead.
- Author: @cgomesu
This demo uses ping and nc (netcat) to monitor the network status of hosts and services, respectively. Hosts and services can be modified by editing their respective dictionaries:
hosts = {
'Internet': '8.8.8.8',
'Firewall': '192.168.1.1',
'NAS': '192.168.1.2'
}
services = {
'Cameras': {'ip': '192.168.1.2', 'port': '8000'},
'Plex': {'ip': '192.168.1.2', 'port': '32400'}
}
- Author: @juvus
This is a demo of a graphical progress bar created with custom characters. This bar could be used, for example, for showing the current level of battery charge.
- Author: @jdarias
This is a script that shows a famous quote, a currency conversion pair of your choice and the weather of a city. It also shows the last three characters from your ip address, the date in DDMM format and the hour in HH:MM format
The script takes info from the following APIs:
-
quotable.io: Free public API that provides famous quotes from well known people. It has a public endpoint that doesn't require an API key.
-
exchangerate-api.com / free.currencyconverterapi.com: There are a lot of currency apis but these ones offer free currency exchange info. Both are used, one as main, the other as backup. Requires an API key to use.
-
openweathermap.org: Provides Weather info, forecasts, etc. Requires an API key to use.
In order to use the script, you need to get API key tokens for both exchange rate services and the weather api. Once you've done that, edit the script to put your tokens in the USER VARIABLES section.
Also set a currency exchange pair. For currency support and the currency codes you need to use, see exchangerate-api.com/docs/supported-currencies.
A city/country string is also needed to show weather info for such city. Search for your city on openweathermap.org and take note of the City,country string and put it in the script.London,gb is given as an example.
Once you are done editing a demo_*.py file or writing your own Python script, follow the instructions on this section to run the script in the background. First, however, ensure that the script (e.g., script.py) has at least permission to be executed, as follows:
sudo chmod +x script.pySimilarly, file ownership can be configured via chown. For example, to set the user ${USER} as owner of the file script.py, run the following:
sudo chown ${USER} script.pyUse the following procedure to run any LCD Python script as a (systemd) service:
-
Create a new unit file in
/lib/systemd/system/calledrpi-lcd.service:sudo nano /lib/systemd/system/rpi-lcd.service
-
Copy and paste the following in the new unit file:
(If your user is different than
pi, remember to edit theUser=entry.)[Unit] Description=RPi Python script for a 16x2 LCD [Service] Type=simple ## Edit the following according to the script permissions User=pi #Group=users ## Edit the following with the full path to the compatible Python version and your script ExecStart=/usr/bin/python /path/to/script.py Restart=always RestartSec=5 KillMode=process KillSignal=SIGINT [Install] WantedBy=multi-user.target
-
Enable the service and start it:
sudo systemctl enable rpi-lcd.service sudo systemctl start rpi-lcd.service -
Check that the LCD is displaying the correct information; otherwise, check the service status:
systemctl status rpi-lcd.service
Thank you for you interest in learning how to contribute to this repository. We welcome contributions from novices to experts alike, so do not be afraid to give it a try if you are new to git and GitHub. First, however, take a few minutes to read our CONTRIBUTING.md guide to learn how to open Issues and the various sorts of Pull Requests (PRs) that are currently accepted.
In addition, if you've never contributed to an open source project before, please take a look at the following resources:
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent