flipdot
A Rust library for interacting with Luminator flip-dot and LED signs over RS-485.
Provides a way to connect to a sign, define messages spanning one or more pages, send those pages to the sign, then switch between them. No special graphics or text functionality is provided; you are responsible for setting the pixels on the pages yourself.
Tested with a MAX3000 90 × 7 side sign. Should work with any flip-dot or LED sign that uses the 7-pin circular connector, but no guarantees.
Intended only for hobbyist and educational purposes. Not affiliated with Luminator in any way.
Usage
Here's a full example of connecting to a sign over serial, sending pages, and showing them:
use RefCell;
use Rc;
use ;
// Set up bus. Because the bus can be shared among
// multiple signs, it must be wrapped in an Rc<RefCell>.
let port = open?;
let bus = try_new?;
let bus = new;
// Create a sign with the appropriate address and type.
let sign = new;
// First, the configuration data must be sent to the sign.
sign.configure?;
// Next, we can create some pages, turn on pixels, and send them to the sign.
let mut page1 = sign.create_page;
page1.set_pixel;
let mut page2 = sign.create_page;
page2.set_pixel;
// We only need to explicitly flip pages if PageFlipStyle::Manual is returned,
// otherwise the sign will automatically show and flip pages.
if sign.send_pages? == Manual
Sub-crates
In addition to the high-level API of Sign
, several lower-level components are provided
that can be combined for more specialized use-cases.
flipdot-core
(re-exported ascore
) contains the basic types describing the protocol, and is useful if you want to implement a customSignBus
or otherwise operate at the level of the raw protocol.flipdot-serial
(re-exported asserial
) contains functions for configuring the serial port, as well as the implementation ofSerialSignBus
.flipdot-testing
contains tools not directly related to communicating with signs, but useful for testing and debugging.
License
Distributed under the MIT license.