#testing-debugging #bus #luminator #flip-dot

flipdot-testing

Tools for testing and debugging Luminator sign communications

4 releases (2 breaking)

new 0.8.0 Mar 5, 2025
0.7.1 Mar 4, 2024
0.7.0 Mar 2, 2024
0.6.0 Mar 3, 2021

#360 in Testing

Download history 5/week @ 2024-12-08 1/week @ 2024-12-15 3/week @ 2025-02-23 153/week @ 2025-03-02

156 downloads per month
Used in 2 crates

MIT license

150KB
2K SLoC

flipdot-testing

Tools for testing and debugging Luminator sign communications.

For the basic task of sign communication, you likely want to use the high-level API in the flipdot crate instead.

This crate isn't directly related to controlling a real sign, but provides some helpful diagnostic tools. VirtualSignBus is a general-purpose mock implementation of one or more signs attached to the bus, and Odk allows connecting a real ODK over serial to a SignBus.

Intended only for hobbyist and educational purposes. Not affiliated with Luminator in any way.

Usage

use flipdot_testing::{Address, Odk, VirtualSign, VirtualSignBus};

// Populate bus with signs from addresses 2 to 126
// (which seems to be the possible range for actual signs).
let signs = (2..127).map(Address).map(|addr| VirtualSign::new(addr, PageFlipStyle::Manual));
let bus = VirtualSignBus::new(signs);

// Hook up ODK to virtual bus.
let port = serial::open("COM3")?;
let mut odk = Odk::try_new(port, bus)?;
loop {
    // ODK communications are forwarded to/from the virtual bus.
    odk.process_message()?;
}

License

Distributed under the MIT license.

Dependencies

~2.7–4.5MB
~79K SLoC