Ever wanted to make a twitter sign? Of course you have. I do too, so I made one! My goal was to have minimal hardware so that the sign can easily be mounted anywhere, so I used a Linksprite WiFi DiamondBack Arduino to connect wirelessly to the Internet and control the sign.
But first, how to get the Arduino talking to the sign? The sign communicates with a standard serial cable (DE-9 RS232) which the Arduino SoftwareSerial library can talk to pretty easily. What data does it need, though? Sending straight ASCII characters to it didn’t do anything, so some digging was necessary.
Fortunately, it comes with a Windows application for programming the sign, and HeatSync Labs has a Logic Analyzer. So, I loaded up the program on a laptop with a serial port and carefully stripped the serial cable’s wires bare without breaking them. I also installed Salae Logic on the computer and hooked the analyzer’s leads up to the bare wires. Finally, I programmed the sign to display a sample message.
Turns out, this sign definitely doesn’t read plain ASCII text! The logic analyzer didn’t find anything readable aside from the first few characters of the message (likely the message’s “title”, i.e. part of its advanced programming and not the actual message itself.) I finally parsed all the raw sniffed binary into CSV and a LibreOffice spreadsheet, and colored each cell, to visualize the binary content of my test messages. I was pretty cross-eyed by this point and heading nowhere fast.
But wait, even though the first few images are illegible, I kept sending test messages and eventually landed upon a single period (4×4 dot) and then two periods (two 4×4 dots separated by a 2×2 space). The last two columns in this image show an inverted dot, and then finally a message containing an inverted dot followed by a positive dot. Finally! It looks like the dots are being written to the screen in binary, with a lot of header information. Looking at the info closely, it seems that the binary is laid out horizontally; a whole row is written out, then the second row, etc. This is why it’s illegible for all but the most basic of messages.
So we figured out what it’s doing, but we’ve still got to send stuff via Arduino and figure out how to generate our own messages on the fly.
First step, I copied the sniffed binary in hex form to an Arduino SoftwareSerial program, and used Logic to compare the Arduino outputs and sign replies to the stuff I’d sniffed earlier. Looked good, with a few tweaks! I just wired the Arduino pins 2, 3, and GND straight into the end of the serial cable.
Here came the tough part. Any time I made the slightest change to the code, I’d receive different responses from the sign (presumably error messages.) There must be some error checking routine, because I could change the ORDER of certain bytes in the message data, but I couldn’t change their content (value.) It took a lot of trial and error, but I finally realized there had to be a checksum, and while exasperatedly explaining it to people on IRC it hit me: 0x2 is “packet start”, 0x3 is “packet end”, 0x0 is null or padding, and the byte right before the “packet end” is the checksum. It should’ve hit me earlier, but I ignored the amazing coincidence that the difference between the checksums and the sum of all the bytes in the packet (except start, end, and checksum) was always divisible by 32 and 64…
Anyway, turns out the sign’s checksum is calculated by an 8-bit accumulator, or mathematically it’s the result of the sum of all the data bytes in the packet, modulo 256.
With this knowledge, I’m able to construct a data packet for the sign in the Arduino. Every packet is 0x2, 0x0, [data], 0x0, [checksum], 0x3. Everything else is simply a matter of getting the message to send and outputting the appropriate dot pattern in binary. I used a webserver to connect to twitter and prepare the message, along with a binary 8×8 dot matrix font on the Arduino, but this is all secondary to establishing communication.
Arduino sketch files for this specific sign are available on Github.
8 thoughts on “Sniffing RS232 to Control an LED Sign with Arduino”
Did you connect this to the Arduino with the serial cable? I’ve got a sign I’m getting ready to use for something similar…
Hey there! If you look at the second photo you can see I stuck wires into the serial cable and the arduino. Later, I built a serial shield for the arduino with a ribbon cable, headers, and male DB9 connector to make it more stable.
Mr. Bradley how can I please connect Alpha Vision 020 6415 EZ95 Red LED Sign Module 128 x 32 or a similar module to an Arduino or Raspberry pi for a scrolling message sign?
Hi there! I have no idea! What kind of interface does it have for controlling the message? This blog post is about hacking into an rs232 interface, but every sign is going to be slightly different. Do you have a hackerspace near you? http://www.hackerspaces.org
First of all, thank you for your prompt reply. The main reason I have contacted you is because of the post below and my lack of knowledge. I was also wondering if it would be less expensive to build a matrix with the minimum size of 16 in. x 36+ in. please. There is a hackerspace around me and I will reach out to them when my schedule permits. Thank you again.
Again, no idea. This blog post is intended to help you experiment on your own, every sign and project is going to be slightly different.
Where can I purchase the sign you are using. Thanks in advance.
I don’t know, it’s probably not being manufactured anymore (and anyway it died a few months after posting this blog.) It was a 16×72 LED sign, though. I would imagine newer signs might be programmable in a more easy way than having to sniff RS232.