For applications where a GUI is not required such as integration with home automation or using a headless (no monitor or keyboard) Raspberry Pi, use PIXEL’s console (command line) app. It’s a Java console app and can run on the Raspberry Pi, BeagleBone Black (not fully tested), Windows PC, Mac, and Linux. The device will need a Java Run Time Engine installed (JRE 1.6 or higher).

How to Setup Raspberry Pi for PIXEL

IMPORTANT: If you are using a Raspberry Pi, omit the Pixel Port parameter (-Dioio.SerialPorts=X) in all the command lines below.

download-console-app-button

 

 

*** PIXEL: Console V2.7 (updated with new weather API as the Yahoo Weather API no longer works)***

Usage:pixelc <options>Valid options are:

GIF MODE

–gif=your_filename.gif  Send this GIF to PIXEL. IMPORTANT: You must place GIFs in the same directory as pixelc.jar

–loop=number  How many times to loop the GIF before exiting, omit this parameter to loop indefinitely

–write  Puts PIXEL into write mode, default is streaming mode

–framedelay=x  Overrides the GIF speed/frame delay where x is a whole number representing milliseconds between 1 and 1000

–superpixel  change LED matrix to SUPER PIXEL 64×64

–16×32  change LED matrix to Adafruit’s 16×32 LED matrix

–adafruit32x32  change LED matrix to Adafruit’s 32×32 LED matrix or 1/16 scan other 32×32 panels (most likely you’ll use this setting especially if you have a pixel 2.5 board)

–64×16  change LED matrix to 64×16 which is two daisy chained 32×16

–adafruit64x64  change LED matrix to Adafruit 64×64

–adafruit64x32  change LED matrix to Adafruit 64×32

–daemon  runs as a background process AND you must also add & at the end of the command line

Ex. java -jar -Dioio.SerialPorts=/dev/tty.usbmodem1421 pixelc.jar –gif=tree.gif

Ex. java -jar -Dioio.SerialPorts=/dev/tty.usbmodem1421 pixelc.jar –gif=tree.gif –daemon &

Ex. java -jar -Dioio.SerialPorts=COM14 ~/pixel/pixelc.jar –gif=~/pixel/tree.gif

Ex. java -jar -Dioio.SerialPorts=COM14 pixelc.jar –gif=tree.gif –loop=10 –framedelay=200

Ex. java -jar -Dioio.SerialPorts=COM14 pixelc.jar –gif=tree.gif –superpixel –write

SCROLLING TEXT MODE / QUICKBASE SEARCH / SERVICE NOW / TWITTER FEED

–quickbase    QuickBase mode, send some scrolling text from QuickBase

–qbuserid=<text>    QuickBase user id

–qbpassword=<text>    QuickBase password

–qbdomain=<text>    QuickBase domain

–qbdatabase=<text>    ID of the target Quickbase Database

–qbqueryfield=<number>    The field id of the field in QuickBase to query against

–qbsearchstring=”your search term”    Search string to query the QuickBase, Make sure to enclose your text in double quotes

–qbreturnfields=<number.number.number.number>    Field IDs to return in the xml data, separate with a dot like this 3.5.7.10 which returns fields with IDs 3,5,7, and 10

–qbtoken=<text>    The QuickBase application token string, get this from your QuickBase administrator

–qbrefresh=<number>   How many times to scroll result before checking QuickBase again for the latest data: Omit this for the default of 10

–snow   Service Now mode, show status of two Service Now Queues/Groups, total open, total high priority, and total exceeded SLA

–snowuserid=<text>   Service Now id for API access

–snowpassword=<text>  Service Now password for API access

–snowdomain=<text>  Service now URL ex. x.service-now.com

–snowgroup1id=<text>  GUID of the desired Service Now Queue/Group 1

–snowgroup1name=<text>  Name to display on the scrolling LED text for Service Now Queue/Group 1

–snowgroup2id=<text>  GUID of the desired Service Now Queue/Group 2

–snowgroup2name=<text>  Name to display on the scrolling LED text for Service Now Queue/Group 2

–text=”your scrolling text”  Scrolls your message.  Make sure to enclose your text in double quotes

–twitter=”your Twitter search term”    Make sure to enclose search term in double quotes. Use –text or –twitter but not both.

–filtertweets  Filter Tweets that have RT, contain http:// or @

–interval=<number>    How often in seconds to update the Twitter feed where x is a whole number between 10 and 86400 (24 hours)

–speed=<number>  How fast to scroll, default value is 6. Higher is faster.

–smooth=<number>  How smooth the scrolling text is, default value is 100. The combo of smooth=15 and speed=1 will be smooth but you’ll need a USB connection, Bluetooth will have a lag

–fontsize=<number>  Default size is 30

–loop=<number>  How many times to loop the scrolling text before exiting, omit this parameter to loop indefinitely

–color=<text>    Supported values are red, green, blue, cyan, gray, magenta, orange, pink, and yellow

–offset=<number>   Use this if your scrolling text is not centered, a postive numbers moves the text up and negative moves down, just experiment until your text is centered

–proximity  Turns on the proximity sensor for interactive applications

–debug  Displays the proximity sensor value on the console

–proximitypin=<number>   The default proximity pin is 34, use this to specific a different pin, options are 31,32,33, or 34

–proximityhigh=<number>   The upper limit threshold for the prox sensor to trigger, ie, will trigger if goes over this number

–proximityshow=<number>   Display the proximity sensor value on the LED display

–sensorloopdelay=<number>  time in milliseconds to poll the sensor, omit this parameter to use default: 500

–stock=<text>  Scrolls stock ticket upon proximity trigger, currently only one stock symbol is supported, proximity sesor must be turned on

–compliments  Scrolls a compliment message upon proximity trigger, proximity sensor must be turned on

–daemon  runs as a background process AND you must also add & at the end of the command line

Ex. java -jar -Dioio.SerialPorts=/dev/tty.usbmodem1421 pixelc.jar –twitter=”cats and dogs” –interval=30 –adafruit32x32

Ex. java -jar -Dioio.SerialPorts=COM14 pixelc.jar –twitter=”cats and dogs” –interval=30 –daemon &

Ex. java -jar -Dioio.SerialPorts=COM14 pixelc.jar –text=”hello world” –speed=10 –fontsize=36 –color=orange

Ex. java -jar -Dioio.SerialPorts=COM14 pixelc.jar –text=”hello world” –speed=10 –fontsize=36 –color=orange –loop=1

Ex. QuickBase example java -jar -Dioio.SerialPorts=/dev/tty.usbmodem1411 pixelc.jar –quickbase –smooth=15 –speed=1 –offset=-10 –color=blue –64×16 –qbuserid=Your QB User ID –qbpassword=Your QB Password –qbdomain=Your QB Domain –qbdatabase=Your QB Database ID –qbsearchstring==”Your Search Text” –qbqueryfield=QB Field ID to Search –qbtoken=Your QB Application Token

Ex. QuickBase example with stock ticker proximity interrupt java -jar pixelc.jar –quickbase –smooth=15 –speed=1 –offset=-10 –color=blue –64×16 –qbuserid=Your QB User ID –qbpassword=Your QB Password –qbdomain=Your QB Domain –qbdatabase=Your QB Database ID –qbsearchstring==”Your Search Text” –qbqueryfield=QB Field ID to Search –qbtoken=Your QB Application Token –qbrefresh=1 –stock=AAPL –proximity

Ex. Twitter Feed with proximity interrupt to display compliment messages java -jar pixelc.jar –twitter=”cats and dogs” –smooth=15 –speed=1 –offset=-10 –color=blue –64×16 –proximity –compliments

WEATHER MODE

–zip=your_united_states_zip_code Non-US users must use zmw

–zmw=your_city_zmw_coordinates Coordinates that the Wunderground Weather API uses to designate your location, find your zmw coordinates here http://api.wunderground.com/api/9af894a415d42861/conditions/geolookup/q/holland/Maastricht.json and substitute holland and Maastricht with your country and city. Then look for the zmw coordinates in the page.  The above URL for example will show 00000.1.06380 Maastricht, Holland as the zmw.

–loop=number  How many times to loop the weather GIF before exiting, omit this parameter to loop indefinitely

–forecast Displays tomorrow’s weather conditions, defaults

to current weather conditions if not specified

–apikey=your_wunderground_api_key Get this key by registering a developer account at https://www.wunderground.com. You must have your own unique API key.

Ex. java -jar -Dioio.SerialPorts=COM14 pixelc.jar –zip=95050 –loop=10 –apikey=your_key

Ex. java -jar -Dioio.SerialPorts=COM14 pixelc.jar –zip=95050 –write –apikey=your_key

Ex. java -jar pixelc.jar –zmw=00000.168.06379 –forecast –adafruit32x32 –apikey=your_key (Raspberry Pi example for a pixel 2.5 board with an Adafruit 32×32 panel or pixel guts kit)

Omitting -Dioio.SerialPorts=<Port of PIXEL> may still work

but will take longer for your computer to scan all ports to find PIXEL

<Port of PIXEL> examples:

Windows: COMX

Mac: tty.usbmodem141X where X is typically 1 or 2

Raspberry Pi: Omit -Dioio.SerialPorts=<Port of PIXEL>

Linux & BeagleBone: IOIOX or /dev/ttyACM0 where X is typically 0 or 1

See http://ledpixelart.com/raspberry-pi/ for Raspberry Pi setup instructions

PIXEL Console App Source Code, Do let us know if you add something cool

PIXEL Console Older Version 1.3

PIXEL Console Older Version 2.0

PIXEL Console Older Version 2.5

PIXEL Console Older Version 2.6

  • Sign up for the PIXEL Newsletter

    * = required field
^ Back to Top