View source for Building an Octoscroller Matrix Display

== Overview ==
:An "octoscroller" is simply a message display that happens to use a BeagleBoneBlack microcomputer (abbreviated BBB in this document), an 8-port "octoscroller" daughter card that plugs onto the BBB, and inexpensive RGB LED panels of the P-10 type. Powered by low-voltage DC power supplies (5vdc), these units are connected together by short ribbon cables with plug-in IDC connectors and controlled by the same marvelous Falcon Player that runs on the Raspberry Pi. The P-10 panels are particularly well suited for displaying moving text but can also display low-definition pictures and video. The budget for the project outlined here was a very affordable $200. Understand that this Wiki document is only ONE way to build a matrix display; it is not the ONLY way.

== Skills you'll need to have ==
:* Working understanding of using XLights/Nutcracker to create and save sequences.
:* Working understanding of how to use your Internet browser
:* Working understanding of basic TCP/IP networking
:* Working understanding of how to download software, unzip/install it
:* Working understanding of how to use SD Card formatting software and disk imaging software
:* Working understanding of how to use and configure Falcon Player software
:* Working understanding of basic electrical connectivity issues of low voltage electronics.
:* Working skills with common household tools.
:* A working understanding of the Linux Operating system can be very helpful

: '''Note:''' by "working" it is meant that you can actually can DO these things, not merely having heard or read about them once. This document will not teach you how to do electronics or how to configure TCP/IP networking, how to use your computer or how to format a flash drive, etc. These are expected skills that you should either have before you attempt working on this project or skills that you will need to acquire during this project.

== Materials/Components you'll need ==
:* BeagleBone Black microcomputer and suitable A/C power supply
:* Octoscroller daughter card
:* 4 P-10 RGB LED panels
:* Assorted ribbon connection cables (purchased with the panels)
:* 5amp 5vdc power supply (for the panels)
:* Angled aluminum stock
:* 3M VHB tape

== Software tools you'll need ==
:* XLights/Nutcracker
:* Falcon Player
:* Appropriate version of Linux for the Falcon Player
:* Internet browser (to connect to the BBB and control the Falcon Player)

== Sources/Places to get more information ==

:Note: Because of the dynamic nature of the Internet, some of these links may become inactive over time...

:* Panels and cables used by the author to make this project:
::http://www.aliexpress.com/item/Indoor-320-160mm-32-16pixels-3in1-SMD-1-8-scan-RGB-P10-full-color-LED-module/1615047851.html

:* Information, downloads links and more about installing Falcon Player on BeagleBone
::http://falconchristmas.com/forum/index.php/topic,2742.0.html

:* XLights/Nutcracker software downloads and information
::http://nutcracker123.com/nutcracker/releases/

:* Putty SSH Terminal. You may or may not need this telnet client, but it's very handy to have if you find you do need it.
::http://www.putty.org/

== Step-by-step Guide ==

1. Plan your matrix. Decide on where you're going to put it, what you want it to look like, whether it will be tall and narrow, short and wide, square, etc. Also determine how far it will be away from viewers because text or pictures are a little hard to read if the distance is too great and the text size too small. The author's design used four panels in horizontal orientation, creating a 50"W x 6"H sign. Planning is important because if you think you may want to increase the size of your display at a later date, you might be better off buying all the panels you may need up-front so they'll be an electrical and aesthetic match. Of course, don't ignore the budget, either. 

2. Gather the materials, equipment and the software you'll need. If you don't have any experience with the Raspberry Pi or Linux in general, buy a beginner's book and learn a little bit about it. Linux is a much different animal than Windows. You may need to use Putty at some time, although the Falcon Player is pretty complete in its ability to transfer files and organize things. Putty works at the command-line level and it gives you flexibility and control that GUI tools for Linux often don't have. 

3. Once you have all the materials you can proceed. '''Reminder: make sure nothing is powered on when you connect or disconnect any cables!''' Connecting the panels is dirt-simple as long as you understand how they relate to one another. To do that, assemble the panels in the orientation the Falcon Player requires, which is shown at the top of this photo:

[[File:Panel orientation data flow.jpg | 1000px]]

:: If you look closely at the back of the panels you'll see arrows that point to the panel tops and to the direction of the flow of data. All the panels are identical and don't take an order number until you connect them together. Notice that the BBB connects to the start but that isn't panel #1. When you view the FRONT of the display, panels count from left-to-right as 1-2-3-4. But on the back side, it's reversed. As you view the FRONT of the display, the top left corner is pixel #1 and the last pixel is on the bottom right. Therefore if you want the text to appear from the right and scroll to the left, you're actually scrolling ''backwards'', from panel 4 to panel 1. Also notice that each panel requires its own power connection/injection. Each of these panels required about .8A at 5vdc when fully on so a simple 5A power supply was sufficient. Your power requirements may differ, so be sure to provide ample current at the required voltage. It's likely that all the panels can be powered from one supply like this example, so all power connections were made common and simply connected to the power supply.

[[File:Panel orientation front.jpg | 1000px]]

::Panels are connected together with a short ribbon jumper: Notice the "output" of one goes to the "input" of the next panel, and because the cable connectors are keyed and fit only one way, it's pretty hard to make a mistake:

[[File:Panel to panel.jpg | 500px]]