Facebook Twitter Instagram Pinterest YouTube
    Trending
    • Pi Pico W Launched
    • Add Kodi to RetroPie Menu
    • Disable Auto-login in Raspberry Pi OS
    • Raspberry Pi Cloud Storage with MEGA
    • RetroPie Temperature Monitor from Menu
    • Pi Pico Pinout and Power Pins
    • Install Arduino IDE on Raspberry Pi
    • Raspberry Pi 400 SSD Upgrade
    Facebook Twitter Instagram Pinterest YouTube RSS
    Raspberry Pi SpyRaspberry Pi Spy
    • Home
    • Categories
      • General
      • Hardware
      • Programming
      • Python
      • Software
      • Tutorials & Help
    • BerryClip
      • BerryClip Instructions
      • BerryClip Plus Instructions
      • Videos & Reviews
    • Buy
      • Buy Pi
      • Buy Pi Accessories
      • Buy Books
    • Tools
      • Ultimate Raspberry Pi Alexa Skill
      • Pi Power Estimator App
      • Pi-Lite 14×9 LED Matrix Sprite Editor
      • RPiREF Pin-out Reference App
      • Simple Ohm’s Law Calculator
      • Web Sites & Links
    • Tutorials & Help
        Featured
        November 9, 20200

        Raspberry Pi Temperature Monitoring

        Recent
        May 6, 2022

        Add Kodi to RetroPie Menu

        February 26, 2022

        Disable Auto-login in Raspberry Pi OS

        February 2, 2022

        Raspberry Pi Cloud Storage with MEGA

      1. Contact Us
      2. Site Map
      Raspberry Pi SpyRaspberry Pi Spy
      You are at:Home»Hardware»Add-ons»How To Setup The Pi-Lite LED Matrix Board
      Pi-Lite LED Matrix Board

      How To Setup The Pi-Lite LED Matrix Board

      28
      By Matt on September 24, 2013 Add-ons, Tutorials & Help

      Pi-Lite LED Matrix BoardBack in 2013 I purchased a Pi-Lite at the Cambridge Raspberry Pi Jam.This is a 14×9 matrix of red LEDs mounted on a PCB that can be attached to the Pi and controlled via the GPIO header. The 126 LEDs can be turned on individually or used to display scrolling text.

      Although there was plenty of help material available from the Openmicros.org site (no longer available) I found it a little bit confusing. Information was spread over a mixture of pages and it was easy to get lost in the more advanced detail while looking for a gentle introduction.

      So here is my simplified version. My objective was to configure the SD card, connect my Pi-Lite and get some of the example Python scripts working. Nothing fancy just a quick setup before deciding how to move onto something more complicated.

      UPDATE : This article was updated to work with the latest Raspbian release. The Openmicros.org site no longer exists but I still got my device to work and the Github libraries are still available.

      Pi-Lite LED Matrix Board

      Step 1 – Prepare SD Card and Configure Operating System

      To start the setup I always use the latest version of the Raspbian SD card image which is available from the RaspberryPi.org download page.

      Boot the Pi using this fresh SD card without the Pi-Lite attached

      Step 2  – Disable Serial Port Login

      By default the Raspbian operating system allows input and output on the serial port (header pins 8 & 10). This would interfere with the Pi-Lite which uses the serial port to receive its data so we need to disable this functionality.

      This can be done using the “raspi-config” utility either from the Pixel desktop or the command line.

      sudo raspi-config

      Then :

      • Select “Advanced Options”
      • Select “Serial”
      • Select “No” to disable the login shell over serial
      • Select “OK” when it says the serial interface has been disabled

      When you exit raspi-config decline the offer to reboot.

      Step 3 – Enable UART

      Edit the config.txt file using :

      sudo nano /boot/config.txt

      At the bottom of this file there is a line containing “enable_uart=0”. Change this to “enable_uart=1”.

      Then press “CTRL-X”, then “Y” and finally “Enter” or “Return” to save. You should be returned to the command line. Now we’ve made the configuration changes it’s time to shut-down..

      Step 4 – Shutdown and attach hardware

      Shutdown the Pi using :

      sudo halt

      Wait for the Pi to shut-down completely. Disconnect the power and attach the Pi-Lite to the GPIO header making sure the connector is correctly aligned.

      Connect the power and allow the Pi to boot.

      Step 5 – Install Minicom and Test

      To test the Pi-Lite we can install a small utility called Minicom which will allow us to send data across the serial port to the Pi-Lite. This data should be displayed on the Pi-Lite.

      To install Minicom use the following command :

      sudo apt-get install minicom

      Press “Y” when asked if you want to continue.

      Once installed you can use Minicom to send data to the Pi-Lite using the following command :

      minicom -b 9600 -o -D /dev/serial0

      Pressing keys on your keyboard should result in them appearing on the Pi-Lite!

      To exit Minicom press “CTRL-A”, then “X” and finally press “Return” to select “Yes” from the prompt.

      Step 6 – Download Example Python Scripts

      Since Ciseco are no longer in business I added the original Python example scripts to my BitBucket repository. This was so I could update the serial port reference to “/dev/serial0”. This enables them to work with all Raspberry Pi devices including the Pi 3.

      First we need to install the Python serial package :

      sudo apt-get install python-serial

      Install “git” if it isn’t already installed using :

      sudo apt-get install git

      Now we can download the examples from BitBucket :

      cd ~
      git clone https://bitbucket.org/MattHawkinsUK/rpispy-pi-lite.git

      This will download the files into a folder called “rpispy-pi-lite”.

      Step 7 – Download Official Files (optional)

      The original official files are held in a Git repository on Github.com. I’ve left this section here in case you want to look at them but you don’t need them.

      Install “git” if it isn’t already installed using :

      sudo apt-get install git

      Now create a directory which Git can use to store data we pull from Github.com :

      cd ~
      mkdir git
      cd git

      Now we can pull the examples from Github into our new directory :

      git clone git://github.com/CisecoPlc/PiLite.git

      Next we need to install the Python serial package :

      sudo apt-get install python-serial

      Typing the following command will browse to the Python examples folder :

      cd PiLite/Python_Examples/

      Typing “ls” will list the available files in this directory.

      Step 8 – Run Basic Python Example Scripts

      To find the scripts navigate to /home/pi/rpispy-pi-lite/Ciseco_Examples/

      cd ~
      cd rpispy-pi-lite
      cd Ciseco_Examples

      The following Python examples should now run without any other additional installations or tweaks :

      Pacman.py    - displays a Pacman image complete with munching mouth
      BarScroll.py - scrolls a bar graph
      BarUpDown.py - grows a set of bars then reduces the size of them
      VUSample.py  - an example VU meter

      Pi-Lite LED Matrix Board

      Run them using the following command as an example :

      python Pacman.py

      This script displays an animated Pacman symbol.

      Some scripts will end after a few seconds but you may need to use “CTRL-C” to exit the examples that run in a continuous loop.

      Step 9 – More Python Examples

      Some of the other scripts require a few more Python libraries to be installed.

      sudo apt-get install python-setuptools
      sudo easy_install pip
      sudo apt-get install python-requests
      sudo pip install arrow

      When that has finished installing you should be able to run the “PiLiteWorldTime.py” example. This should give you the time in various capital cities including London, Cairo and Paris.

      For some reason I was getting an “Error:’dict’ object is not callable” error when trying to run “PiLiteWeather.py” and “PiLiteStock.py”. To solve this I ran :

      sudo pip install requests --upgrade

      which seemed to solve the problem by re-installing the requests package.

      Here are some photos.

      Pi-Lite LED Matrix Board
      Pi-Lite LED Matrix Board
      Pi-Lite LED Matrix Board
      Pi-Lite LED Matrix Board
      Pi-Lite LED Matrix Board
      Pi-Lite LED Matrix Board

      It isn’t very easy taking photos of bright LEDs!

      Additional Information

      The official website no longer exists but here is the last available user guide :

      Pi-Lite User Guide (April 2014)

      My Pi-Lite BitBucket Repository is here : https://bitbucket.org/MattHawkinsUK/rpispy-pi-lite/

      The Ciseco Github Repository is here : https://github.com/CisecoPlc/PiLite/

      Share. Facebook Twitter Pinterest LinkedIn Tumblr Email
      Previous ArticleCambridge Raspberry Jam – September 2013
      Next Article Pi-Lite LED Matrix Board Python ‘Hello World’ Example

      Related Posts

      Add Kodi to RetroPie Menu

      Disable Auto-login in Raspberry Pi OS

      Raspberry Pi Cloud Storage with MEGA

      28 Comments

      1. Mike on September 27, 2013 11:47 am

        Very nice; all worked for me. Thanks.
        Mike

        Reply
      2. Mike on September 27, 2013 11:51 am

        Although, what I would have hoped OpenMicros would have produced is a very very simple Python example showing you how to write scrolling text to the Pi-Lite. So the Python Pi-Lite equivalent of “Hello World”.
        Mike

        Reply
        • Matt on January 16, 2017 9:41 pm

          There are more Pi-Lite examples listed here : https://www.raspberrypi-spy.co.uk/tag/pi-lite/

          Reply
      3. AndrewS on October 5, 2013 9:32 pm

        I bought a red Pi-Lite at the last CamJam too! 🙂 Haven’t got round to doing much with it yet though, been busy with other pi-projects.

        Steps 2 and 3 in your instructions above can both be automated with this script I wrote:
        https://github.com/lurch/rpi-serial-console

        Reply
      4. Anon on October 8, 2013 9:17 am

        14×9 what a strange size does it have 🙁 Most matrices are multiples of 8 (i.e. 16×8).

        Reply
      5. PiNoob on November 27, 2013 5:44 pm

        Hi!

        Thanks for your site and your guides, you rock!

        I am new to Linux and Python so I would be very grateful if you could tell me how to change the displayed times in the world clock example.

        Thanks,

        PiNoob

        Reply
        • Mike on December 12, 2013 8:50 am

          You might find the website above to be of some help.

          Reply
      6. Tony Goodhew on December 18, 2013 7:51 pm

        Thanks for making the setup so pain free. All working properly in 35 minutes – great.
        I’ll try the next post tomorrow.

        Reply
      7. Mark Routledge on January 2, 2014 12:59 am

        When I try running the example Python scripts I get erratic results. The pacman example displays lots of BBBBBBBsss !!!!(((( ????

        Anyone else got this. I am running the lastest version of Raspian, updated, upgraded and distro-upgrade.

        Suggestions?

        I tried running the ‘sudo pip install requests –upgrade’ command, it didn’t make any difference! 🙁

        Reply
      8. Paulscopes on March 20, 2014 10:19 pm

        I can’t get the minicom command to work. Any ideas?

        Reply
        • Matt on March 21, 2014 4:12 pm

          Is it giving any error messages when you run it?

          Reply
      9. Paulscopes on March 22, 2014 3:57 pm

        302 moved temporarily. Refers to mirrordirector.raspian.org lrzsz and minicom. Very frustrating!!!

        Reply
      10. lad on April 13, 2014 7:55 am

        when i tried the first steps then when i tried too reboot it all went wrong and i cant reboot. got the pi lite for my birthday yesterday and i have been wanting to use it for ages 🙁

        Reply
        • Matt on April 13, 2014 9:25 am

          Unplug the pi-lite. Rewrite your SD card with latest Raspbian image and get the Pi to boot normally. Then try the tutorial again and see how you get on.

          Reply
      11. Richard on August 19, 2014 5:43 pm

        Nice add-on for my PI, use it to display the statistics of my Solar Panel system.
        is there a maximum characters because, it stops displaying in the middle of the last s.write.
        i read a bunch of text files and display the text inside on the pi-lite. the last one does not complete. just stops, if i shorten the text in the files before, i shows some more characters. Seems like i bump into a maximum character value

        script look like:

        s.write(“descr1:\r”)
        s.write( file1)
        time.sleep(3)
        s.write(” descr2:\r”)
        s.write( file2)
        time.sleep(3)
        s.write(” descrip3:\r”)
        s.write( file3)
        time.sleep(3)
        s.write(” descrip4:\r”)
        s.write( file4)
        time.sleep(3)
        s.write(” descrip5:\r”)
        s.write( file5)
        time.sleep(30)

        Reply
        • Matt on August 19, 2014 7:06 pm

          Not sure but if you know where the file stops you can count how many characters came before.

          Reply
      12. Richard on August 19, 2014 9:46 pm

        maybe someone can test this. when is send this string, it stops after about 65 charaters.
        normal behavior ?

        mmmmmmmmm10mmmmmmmm20mmmmmmmm30mmmmmmmm40mmmmmmmm50mmmmmmmm60mmmmmmmmm70mmmmmmmm80mmmmmmmm90mmmmmmmm100mmmmmm110mmmmmmmmm120mmmmmmm130mmmmmmm140mmmmmmm150mmmmmmm160

        Reply
      13. Nadezhda on July 14, 2016 3:08 pm

        Hello,

        The inittab has been replaced and I cannot procede from there. What do I do? Please help!

        Reply
      14. Plant on November 19, 2016 11:11 am

        Hi

        I have found these instructions no longer work with Jessie, something to do with the serial tree being changed??? (I am not a programmer). I have a version of NOOBS 1.4.1 so I tried that instead and it worked fine. Maplins are still selling these but all the official links are down as the manufacture is no longer in business.

        Reply
        • karl on January 2, 2017 5:29 pm

          I have found this too and gutted as I cant get mine to do anything 🙁

          Reply
          • Matt on January 2, 2017 11:58 pm

            I’ve just updated this article and my Pi-Lite works OK now under the latest version of Raspbian.

            Reply
            • Plant on January 3, 2017 2:30 pm

              Thank you Matt, and happy new year. Now I can get scrolling!

              Reply
      15. Chris on January 8, 2017 1:27 pm

        Thanks for this guide. Hugely useful when my son and I tried out his Pi-Lite yesterday on his new Raspberry Pi 3.

        We discovered the Pi 3 addresses the GPIO header differently to previous versions.
        You must use /dev/ttyS0 rather than /dev/ttyAMA0 as described above.

        All of the sample scripts needed editing in a python editor to ‘fix’ the above issue – but after that, they all worked perfectly for us.

        Also the our GPIO header has 40 pins, rather than 26. But we found that the first 26 pins of the set are exactly equivalent to the older format.

        Reply
        • Matt on January 8, 2017 2:52 pm

          Well spotted! It seems in the newer Raspbian you can use “/dev/serial0” and it works for all Pi variants. I’m going to add the Ciseco examples to my BitBucket repository and update the serial port reference. Thanks for the feedback. Hopefully we can keep those Pi-Lites working!

          Reply
        • Dave on June 5, 2017 10:27 pm

          I just create a symlink if I need to use the example code: sudo ln -s /dev/ttyAMA0 /dev/serial0
          This negates the need to edit any of the code examples as serial0 now points to ttyAMA0. The only caveat is that /dev/ is a virtual directory, so anything you put there is lost as soon as you power down the Pi.

          Reply
      16. Dom on January 16, 2017 7:41 pm

        Thanks for this, it’s been invaluable! I was bought a Pi-Lite and had no idea how to get it working with Ciseco gone. So grateful. You may have covered this but are there any tutorials on programming my own text to scroll along the matrix – a sentence, for example?

        Reply
        • Matt on January 16, 2017 7:57 pm

          Hi Dom, give this article a try : https://www.raspberrypi-spy.co.uk/2013/09/pi-lite-led-matrix-board-python-hello-world-example/
          Also if you use this link https://www.raspberrypi-spy.co.uk/tag/pi-lite/ you’ll find my other Pi-Lite articles. I still need to test them but I’ve made some initial updates to bring them into line with the current release of Raspbian.

          Reply
      17. Tony on October 12, 2020 5:20 pm

        Hi,
        I know these boards are a little long in the tooth but picked up a load at a CPC clearance sale so finding these guides were a godsend. I did, however, find that I was getting unpredictable results. It looked a lot like there was something wrong with the baud rate getting odd characters etc. After much head-scratching and googling I found this link which solved my problem.
        https://www.abelectronics.co.uk/kb/article/1035/raspberry-pi-3–4-and-zero-w-serial-port-usage
        I thought I would post it here in case someone has a similar issue.
        I’m running on some old PI3 Model A’s

        Reply

      Leave A Reply Cancel Reply

      This site uses Akismet to reduce spam. Learn how your comment data is processed.

      Recent Posts
      June 30, 2022

      Pi Pico W Launched

      May 6, 2022

      Add Kodi to RetroPie Menu

      February 26, 2022

      Disable Auto-login in Raspberry Pi OS

      February 2, 2022

      Raspberry Pi Cloud Storage with MEGA

      January 7, 2022

      RetroPie Temperature Monitor from Menu

      Categories
      • 1-wire
      • 3D Printing
      • Add-ons
      • BBC Micro:bit
      • BerryClip
      • Books
      • Camera Module
      • Cases
      • Events
      • General
      • Hardware
      • I2C
      • Infographics
      • Interfaces
      • Minecraft
      • Model A+
      • Model B+
      • News
      • Pi Models
      • Pi Pico
      • Pi Zero
      • Power
      • Programming
      • Python
      • Raspberry Pi OS
      • Raspbian
      • RetroGaming
      • Robotics
      • Sensors
      • Software
      • SPI
      • Tutorials & Help
      Tags
      3D Printing Arduino audio battery berryclip Birthday bluetooth cambridge camera CamJam DigiMakers display games GPIO I2C interface Kickstarter LCD LED Linux media Minecraft Model A Model B motionEyeOS PCB photography photos Pi-Lite portable power python Raspberry Jam Raspberry Pi Bootcamp raspbian Retrogaming retroPie screen SD card security sensor SPI temperature ultrasonic video
      Raspberry PI Related
      • Adafruit Blog
      • Average Maker
      • Official RaspBerry Pi Site
      • Raspberry Pi Pod
      • RasPi.tv
      • RaspTut
      • Stuff About Code
      Tech Resources
      • MattsBits – Pi Resources
      • Microbit Spy
      • Technology Spy
      Archives
      About

      Unofficial site devoted to the Raspberry Pi credit card sized computer offering tutorials, guides, resources,scripts and downloads. We hope to help everyone get the most out of their Pi by providing clear, simple articles on configuring, programming and operating it.

      Popular Posts
      September 19, 2014

      Top 5 Reasons The Raspberry Pi Sucks

      July 27, 2012

      16×2 LCD Module Control Using Python

      October 20, 2013

      Analogue Sensors On The Raspberry Pi Using An MCP3008

      Recent Posts
      June 30, 2022

      Pi Pico W Launched

      May 6, 2022

      Add Kodi to RetroPie Menu

      February 26, 2022

      Disable Auto-login in Raspberry Pi OS

      Facebook Twitter Instagram Pinterest YouTube RSS

      Entries RSS | Comments RSS

      This site is not associated with the official Raspberrypi.org site or the Raspberry Pi Foundation. Raspberry Pi is a trademark of the Raspberry Pi Foundation.

      Copyright © 2022 - All Rights Reserved - Matt Hawkins

      Type above and press Enter to search. Press Esc to cancel.