{"id":36,"date":"2013-07-31T15:53:15","date_gmt":"2013-07-31T15:53:15","guid":{"rendered":"http:\/\/blog.soton.ac.uk\/pi\/?page_id=36"},"modified":"2013-08-23T15:08:45","modified_gmt":"2013-08-23T15:08:45","slug":"adafruit-rgb-lcd-display","status":"publish","type":"page","link":"https:\/\/blog.soton.ac.uk\/pi\/modules-available\/adafruit-rgb-lcd-display\/","title":{"rendered":"Adafruit RGB\/BLue&White LCD Display"},"content":{"rendered":"

1) Overview<\/h1>\n

 <\/p>\n

\n
\"1109_LRG.jpg\"<\/a><\/div>\n<\/div>\n
<\/div>\n
This Adafruit plate makes it easy to use a 16×2 Character LCD. Unfortunately, these LCDs do require quite a few digital pins, 6 to control the LCD and then perhaps another 3 to control the RGB backlight for a total of 9 pins. That’s nearly all the GPIO available on a Raspberry Pi!\u00a0<\/strong>You will either have a RGB LCD Plate or a Blue & White one. The functionality for the two is similar, the only difference is in the colours displayed. You can recognise easily that you have a RGB or Blue&White one by looking at the number of soldered pins above the screen. The RGB one has 18, while the Blue&White one has 16.<\/div>\n
\n
\u00a0 <\/a><\/div>\n<\/div>\n

This plate is perfect for when you want to build a stand-alone project with its own user interface. The 4 directional buttons plus select button allows basic control without having to attach a bulky computer.<\/p>\n

2) Usage<\/h1>\n

Plug the LCD Plate onto the Pi, using the 26-pin GPIO header such that the LCD Plate will rest above the Raspberry Pi, as shown in below:<\/p>\n

\"LCDPlate\"<\/a><\/p>\n

 <\/p>\n

The backlights will not turn on until you have the code running so don’t be alarmed if nothing lights up when you plug in the plate! If you have a ‘positive’ style LCD, you may see some squares on the first line, that’s normal.<\/div>\n
\n

Setting up your Pi for I2C<\/h1>\n

For a more basic introduction to setting up I2C on your Pi then you may wish to take a diversion to this Adafruit tutorial: \u00a0http:\/\/learn.adafruit.com\/adafruits-raspberry-pi-lesson-4-gpio-setup\/configuring-i2c<\/a><\/p>\n

Type in the command sudo nano \/etc\/modules <\/b>in order to edit “modules” file and add the following lines:<\/p>\n

 <\/p>\n

i2c-bcm2708<\/strong><\/p>\n<\/div>\n

i2c-dev<\/strong><\/div>\n
<\/div>\n
\n

to the end of the file. Then save the file and reboot the Pi (type\u00a0sudo reboot\u00a0<\/strong>in the terminal) to enable the hardware I2C driver.<\/p>\n

Before you can get started with I2C on the Pi, you’ll need to run through a couple quick steps from the console. Just enter the following commands to add SMBus support\u00a0(which includes I2C) to Python:<\/p>\n

 <\/p>\n<\/div>\n

\n
    \n
  1. sudo apt-get install python-smbus<\/strong><\/li>\n
  2. sudo apt-get install i2c-tools<\/strong><\/li>\n<\/ol>\n<\/div>\n
    i2c-tools isn’t strictly required, but it’s a useful package since you can use it to scan for any I2C or SMBus devices connected to your board. \u00a0If you know something is connected, but you don’t know it’s 7-bit I2C address, this library has a great little tool to help you find it:<\/div>\n
    <\/div>\n
    \n
    <\/div>\n
      \n
    1. sudo i2cdetect -y 0 (if you are using a version 1 Raspberry Pi)<\/strong><\/li>\n
    2. sudo i2cdetect -y 1 (if you are using a version 2 Raspberry Pi)<\/strong><\/li>\n<\/ol>\n<\/div>\n
      \n
      \"i2cdetect.gif\" <\/a><\/div>\n<\/div>\n
      This will search \/dev\/i2c-0 or \/dev\/i2c-1 for all address, and if an Adafruit LCD Plate is connected, it should show up at 0x20, <\/b>as per the figure above. Once both of these packages have been installed, you have everything you need to get started accessing I2C and SMBus devices in\u00a0Python.<\/div>\n
      \n

      Using the example Python code<\/h1>\n

      The easiest way to get the code onto your Pi is to hook up an Ethernet cable, and clone it directly using ‘git<\/strong>‘. Simply run the following commands from an appropriate location (ex. “\/home\/pi”):<\/p>\n<\/div>\n

      \n
      <\/div>\n
        \n
      1. sudo apt-get install git<\/strong><\/li>\n
      2. git clone https:\/\/github.com\/adafruit\/Adafruit-Raspberry-Pi-Python-Code.git<\/strong><\/li>\n
      3. cd Adafruit-Raspberry-Pi-Python-Code<\/strong><\/li>\n
      4. cd Adafruit_CharLCDPlate<\/strong><\/li>\n<\/ol>\n<\/div>\n
        You will also need to install RPi.GPIO, the python library for Pi that allows easy GPIO access. On Raspbian, just run:<\/div>\n
        <\/div>\n
        sudo apt-get install python-dev<\/strong><\/div>\n
        sudo apt-get install python-rpi.gpio<\/strong><\/div>\n
        <\/div>\n
        \n

        Testing the Library<\/h1>\n

        Once the code has been downloaded to\u00a0an appropriate folder, and you have your LCD Plate properly connected, you can start with the basic demo display, which is run by simply executing the library file:<\/p>\n<\/div>\n

        \n
        <\/div>\n
          \n
        1. sudo python Adafruit_CharLCDPlate.py<\/strong><\/li>\n<\/ol>\n<\/div>\n
          If you have a rev 2 (512MB) Pi, or if you’re not getting anything displaying, it might be due to the I2C bus number change in the Pi hardware. Edit Adafruit_CharLCD.py using a command like “nano Adafruit_CharLCD.py<\/strong>” and change the line:<\/div>\n
          <\/div>\n
          lcd = Adafruit_CharLCDPlate(busnum = 0)<\/strong><\/div>\n
          to<\/div>\n
          lcd = Adafruit_CharLCDPlate(busnum = 1)<\/strong><\/div>\n
          <\/div>\n
          \n

          Adjusting Contrast<\/h1>\n

          The plate uses a character LCD with an external yellow contrast potentiometer. The first time you use it, adjust the potentiometer in the bottom right (with a screwdriver or something similar) until you see the text clearly. If you don’t upload code to the Pi, some boxes may appear instead, or you may see nothing at all.<\/p>\n<\/div>\n

          Using the library code<\/h1>\n

          Interfacing with the python example code is fairly easy! Inside the Adafruit_CharLCDPlate folder you’ll find a testLCD.py<\/b> python script. The script does a few things, at the top it imports all the sub-modules. You’ll need to have the Adafruit_I2C.py<\/b>, Adafruit_MCP230xx.py<\/b> and Adafruit_CharLCDPlate.py<\/b> python files to be in the same directory so be sure to copy them to your final destination.<\/p>\n

          Next it initializes the plate with lcd = Adafruit_CharLCDPlate()<\/b> – this creates the lcd object and starts communicating with the plate to set up the LCD and buttons. After initialization, you can clear the display with lcd.clear() <\/b>and write text with lcd.message(“text goes here”)<\/b> don’t forget that its only 16 characters per line, and it does not automatically wrap lines. To insert a newline use the special ‘\\n’ character such as shown in the command: lcd.message(“Adafruit RGB LCD\\nPlate w\/Keypad!”). <\/b>Next you can set the backlight with lcd.backlight(lcd.COLORNAME)<\/b> where\u00a0COLORNAME<\/b> is RED, YELLOW, GREEN, TEAL, BLUE, VIOLET for RGB LCD’s or for monochrome LCDs, just use ON and OFF.<\/p>\n

          Finally, you can ask the plate which buttons are pressed with buttonPressed(lcd.BUTTONNAME)<\/b> where BUTTONNAME is LEFT RIGHT UP DOWN <\/b>or SELECT<\/b>. This is not an interrupt-driven library so you can’t have an interrupt go off when a button in pressed, instead you’ll have to query the button in a loop.<\/p>\n

          That’s it! If you want to make detailed messages, use the python string formatting commands to create a string<\/a> and then write that string with message()<\/b><\/p>\n

          http:\/\/learn.adafruit.com\/adafruit-16×2-character-lcd-plus-keypad-for-raspberry-pi\/usage<\/a><\/p>\n

           <\/p>\n

          3) Connectivity test<\/b><\/p>\n

          Here is a python script which can test the internet connectivity on your raspberry pi and display whether there is internet connection, by pinging google. It also displays the Pi`s IP Address on the screen.<\/p>\n

          The code has been adapted from James Wooley`s “Raspberry PI Pentesting Dropbox Slypi” described here: http:\/\/www.youtube.com\/watch?v=XkT__rRgLc8 and which can be found here “https:\/\/github.com\/Xtrato\/Slypi<\/a><\/p>\n

          To test your internet connection, simply copy and paste the following code into a new python script and save the script in the folder “Adafruit_CharLCDPlate” from the previous chapter. You can do this by the following steps:<\/p>\n

          a) Navigate to the directory Adafruit-Raspberry-Pi-Python-Code\/Adafruit_CharLCDPlate.\u00a0<\/strong>If you are in \/home,\u00a0 type:<\/p>\n

            \n
          1. cd Adafruit-Raspberry-Pi-Python-Code<\/strong><\/li>\n
          2. cd Adafruit_CharLCDPlate<\/strong><\/li>\n<\/ol>\n

            If you did the previous example, you should already be located in this directory<\/p>\n

            b) Open a new python script by typing nano ConnectivityTest.py <\/strong>(instead of “ConnectivityTest” you can give it any name). A blank file will open in the terminal. Copy and paste the code into this blank file and then save it and close using the\u00a0Ctrl+x\u00a0<\/strong>command.<\/p>\n

            c) Type sudo python ConnectivityTest.py <\/strong>in the terminal. The LCD should show “Connectivity Test” written on the screen. Press “Select” and, if there is connectivity test, a green display should pop-up saying “Testing Connectivity” followed by a yellow screen which will display the IP address of the PI as well as the IP address of ? ?<\/p>\n

            d) Press Ctrl+c <\/strong>to return to the command line<\/p>\n

             <\/p>\n

            \n
            \n
            \n
            \n
            \n
            \n
            \n
            \n
            #!\/usr\/bin\/python<\/div>\n
            from socket import socket, SOCK_DGRAM, AF_INET<\/div>\n
            import string<\/div>\n
            import os<\/div>\n
            import sys<\/div>\n
            from time import sleep<\/div>\n
            from Adafruit_CharLCDPlate import Adafruit_CharLCDPlate<\/div>\n
            import subprocess<\/div>\n
            import urllib #Used to display the Public IP address.<\/div>\n
            from subprocess import PIPE<\/div>\n
            <\/div>\n
            # Initialize the LCD plate. \u00a0Should auto-detect correct I2C bus. \u00a0If not,<\/div>\n
            # pass ‘0’ for early 256 MB Model B boards or ‘1’ for all later versions<\/div>\n
            lcd = Adafruit_CharLCDPlate(busnum = 1)<\/div>\n<\/div>\n
            <\/div>\n
            def connectivityTest():<\/div>\n
            \u00a0 \u00a0 print ‘Connectivity Test’<\/div>\n
            \u00a0 \u00a0 #Pings google.com<\/div>\n
            \u00a0 \u00a0 thePing = subprocess.Popen(‘ping -c 5 google.com’, shell=True, stdout=PIPE, stderr=PIPE)<\/div>\n
            \u00a0 \u00a0 lcd.clear()<\/div>\n
            \u00a0 \u00a0 lcd.backlight(lcd.GREEN)<\/div>\n
            \u00a0 \u00a0 lcd.message(“Testing\\nConnectivity”)<\/div>\n
            \u00a0 \u00a0 pingOut, pingErr = thePing.communicate()<\/div>\n
            \u00a0 \u00a0 #If the ping fails ping 8.8.8.8<\/div>\n
            \u00a0 \u00a0 lcd.clear()<\/div>\n
            \u00a0 \u00a0 if len(pingErr) > 0:<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 lcd.backlight(lcd.RED)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 thePing = subprocess.Popen(‘ping -c 5 8.8.8.8’, shell=True, stdout=PIPE, stderr=PIPE)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 pingOut, pingErr = thePing.communicate()<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 print 1<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 #If pinging 8.8.8.8 fails display there is no internet connection<\/div>\n<\/div>\n
            <\/div>\n
            if len(pingErr) > 0:<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 lcd.message(“No Internet\\nConnection”)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 print 2<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 #If pinging 8.8.8.8 succeeds, display there is no DHCP service available for the SlyPi to use.<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 else:<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 lcd.message(“No DHCP\\n Available”)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 print 3<\/div>\n
            \u00a0 \u00a0 else:<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 privateIP = getPrivateIP()<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 publicIP = getPublicIP()<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 lcd.backlight(lcd.YELLOW)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 print privateIP<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 print publicIP<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 #Displays the public and private IP addresses on the LED screen.<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 lcd.message(privateIP + ‘\\n’ + publicIP)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 sleep(3)<\/div>\n<\/div>\n
            funtionBreak()<\/div>\n
            <\/div>\n
            def funtionBreak():<\/div>\n
            \u00a0 \u00a0 while lcd.buttonPressed(lcd.LEFT):<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 os.execl(‘slypi.py’, ”)<\/div>\n
            <\/div>\n
            def errorCheck(error, failedMessage, succeedMessage):<\/div>\n
            \u00a0 \u00a0 lcd.clear()<\/div>\n
            \u00a0 \u00a0 if ‘brctl: not found’ in error:<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 lcd.backlight(lcd.RED)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 lcd.message(“Failed\\nInstall brctl”)<\/div>\n
            \u00a0 \u00a0 elif len(error[1]) == 0:<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 lcd.backlight(lcd.GREEN)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 lcd.message(succeedMessage)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 sleep(3)<\/div>\n
            \u00a0 \u00a0 elif len(error[1]) > 0:<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 lcd.backlight(lcd.RED)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 lcd.message(failedMessage)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 sleep(2)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 os.execl(‘slypi.py’, ”)<\/div>\n
            \u00a0 \u00a0 error = 0<\/div>\n
            <\/div>\n
            def getPublicIP():<\/div>\n
            \u00a0 \u00a0 publicIPUrl = urllib.urlopen(“http:\/\/my-ip.heroku.com\/”)<\/div>\n
            \u00a0 \u00a0 return publicIPUrl.read()<\/div>\n
            <\/div>\n
            def getPrivateIP():<\/div>\n
            \u00a0 \u00a0 s = socket(AF_INET, SOCK_DGRAM)<\/div>\n
            \u00a0 \u00a0 s.connect((‘google.com’, 0))<\/div>\n
            \u00a0 \u00a0 privateIp = s.getsockname()<\/div>\n
            \u00a0 \u00a0 return privateIp[0]<\/div>\n<\/div>\n
            <\/div>\n
            \n
            #Contains all modules which can be run on the device. The key is the displayed name on the LCD and the value is the function name<\/div>\n
            modules = {‘Connectivity\\nTest’: ‘connectivityTest’}<\/div>\n
            displayText = modules.keys()<\/div>\n
            # Clears the display<\/div>\n
            lcd.clear()<\/div>\n
            # Checks if the script has been run as root.<\/div>\n
            if os.getuid() == 0:<\/div>\n
            \u00a0 \u00a0 menuOption = 0<\/div>\n
            \u00a0 \u00a0 #lcd.backlight(lcd.BLUE)<\/div>\n
            \u00a0 \u00a0 lcd.message(“SlyPi\\nPress Select”)<\/div>\n
            else:<\/div>\n
            \u00a0 \u00a0 lcd.backlight(lcd.BLUE)<\/div>\n
            \u00a0 \u00a0 lcd.message(“Be sure to\\nRun as root”)<\/div>\n
            <\/div>\n
            #The following while loop controls the LCD menu and the control using the keypad through the menu.<\/div>\n<\/div>\n
            while True:<\/div>\n
            \u00a0 \u00a0 if lcd.buttonPressed(lcd.SELECT):<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 sleep(0.5)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 lcd.clear()<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 lcd.message(displayText[menuOption])<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 while True:<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 lcd.backlight(lcd.BLUE)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 if lcd.buttonPressed(lcd.DOWN):<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 menuOption = menuOption + 1<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 if menuOption > len(modules) – 1:<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 menuOption = 0<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 lcd.clear()<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 lcd.message(displayText[menuOption])<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 sleep(0.5)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 if lcd.buttonPressed(lcd.UP):<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 menuOption = menuOption – 1<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 if menuOption < 0:<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 menuOption = len(modules) – 1<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 lcd.clear()<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 lcd.message(displayText[menuOption])<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 sleep(0.5)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 if lcd.buttonPressed(lcd.SELECT):<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 globals().get(modules[displayText[menuOption]])()<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 sleep(0.5)<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 break<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 if lcd.buttonPressed(lcd.LEFT):<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 print “left”<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 menuOption = 0<\/div>\n
            \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 break<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

            1) Overview   This Adafruit plate makes it easy to use a 16×2 Character LCD. Unfortunately, these LCDs do require quite a few digital pins, 6 to control the LCD and then perhaps another 3 to control the RGB backlight for a total of 9 pins. That’s nearly all the GPIO available on a Raspberry … <\/p>\n

            Continue reading »<\/a><\/p>\n","protected":false},"author":84718,"featured_media":0,"parent":8,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-36","page","type-page","status-publish","hentry","nodate"],"_links":{"self":[{"href":"https:\/\/blog.soton.ac.uk\/pi\/wp-json\/wp\/v2\/pages\/36","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.soton.ac.uk\/pi\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/blog.soton.ac.uk\/pi\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/blog.soton.ac.uk\/pi\/wp-json\/wp\/v2\/users\/84718"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.soton.ac.uk\/pi\/wp-json\/wp\/v2\/comments?post=36"}],"version-history":[{"count":12,"href":"https:\/\/blog.soton.ac.uk\/pi\/wp-json\/wp\/v2\/pages\/36\/revisions"}],"predecessor-version":[{"id":160,"href":"https:\/\/blog.soton.ac.uk\/pi\/wp-json\/wp\/v2\/pages\/36\/revisions\/160"}],"up":[{"embeddable":true,"href":"https:\/\/blog.soton.ac.uk\/pi\/wp-json\/wp\/v2\/pages\/8"}],"wp:attachment":[{"href":"https:\/\/blog.soton.ac.uk\/pi\/wp-json\/wp\/v2\/media?parent=36"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}