tuitwall is a project that will allow you to show tweets in a led matrix.
The backend is built with PHP and uses the
twitteroauth library to manage all the authentication system with Twitter. It also serves as the configuration page, as the user can choose which tweets and from who, are shown.
The Arduino, using the ethernet shield, calls the backend that provides it with the last tweet valid, then shows it on the led matrix with a scroll effect.
- HTTP Server (e.g. Apache)
- PHP 5
- Arduino board
- Arduino Ethernet Shield
- Ethernet cable
- Sure Electronic's 32x08 Red Led 5mm Dot Matrix
- HT1632-for-Arduino library
- Arduino IDE v1.0 or newer
Note: this has been tested only with one led matrix, but it can be extended up to 4 boards (and further) with proper code.
- SERVER: server domain (including subdomain if existing, but excluding
http://and sub-folders). It is retrieved by default from PHP variable, if wrong, set it manually.
- CONSUMER_KEY & CONSUMER_SECRET: consumer application keys, get them from https://dev.twitter.com/apps.
- OAUTH_CALLBACK: location of the PHP script that will receive the OAuth callback. It should point to
- API_KEY: only devices with the same
API_KEYwill be able to get tweets through
fetch.php. Leave empty (
"") to disable the check.
- SHOW_TWEET: show current tweet at main page?
- SHOW_USER: prepend tweet owner when giving a tweet to a device through
- STREAM: show a stream from twitch.tv at the main page? Useful when doing a demo of the project.
- TWITCH_ID: ID of the stream from twitch.tv you want to show.
- DISALLOW_LOGOUT: disallow logging out to keep tweets from a specific user being shown. To log out you have to delete
auth.txtfrom the web server.
- API_KEY: same as in
- SERVER: same as in
- GET_REQUEST: shouldn't be modified.
- INTERVAL: milliseconds to wait at least between tweet requests.
- VEC_LENGTH: length of the array where the tweet will be stored.
- SPEED: milliseconds to wait at least between led matrix refreshes.
- TIMEOUT: milliseconds in which the tweet should be received.
The reason there are so many options to limit access to tweets is because Twitter only allows clients to make a limited number of requests in a given hour.
- Upload the contents of the
webfolder to a web server.
- Adapt the configuration to your needs.
- Change the
SERVERconstant (both in the Arduino sketch and
config.php) to the appropiate one.
- Change the
API_KEYto a different one. Remember to use the same in the Arduino sketch and
- Create a Twitter application and point the Callback URL to the location of
- Copy the Consumer key and Consumer secret keys to
- Change the
- Mount the Arduino and Ethernet Shield and connect to the PC.
tuitwall.inoto the Arduino.
- Connect the led matrix board to the Arduino (continue reading for schematic).
- Check that the led matrix board has its direction set to 1 (switches at the back).
- Connect the Ethernet Shield to a router through an ethernet cable.
- Reset the board.
Remember that the sketch outputs debug messages to the serial port (at 115200bps), so you can follow initialization and execution of the sketch. The Ethernet Shield relies on a DHCP enabled network, if this is not the case, please modify the code as required to give an appropiate static IP.
How to connect Arduino to Sure Electronic's led matrix using the provided IDC cable:
The hardware and web part of the project should look similar to this:
The Arduino part is mostly universal, you can change the php page it connects to to another one that returns whatever you want to appear on the led matrix. It could be the weather report, current playing song, rss feed, etc. Be creative!
Remember, what the php page returns should be plain text terminated by
chr(0). No html, just the text you want to appear.