flipdot 0.8.0

A library for interacting with Luminator flip-dot and LED signs over RS-485
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

use std::cell::RefCell;
use std::error::Error;
use std::rc::Rc;

use flipdot::core::State;
use flipdot::{Address, PageFlipStyle, PageId, Sign, SignType};
use flipdot_testing::{VirtualSign, VirtualSignBus};

#[test]
fn sign_virtual_sign_interaction() -> Result<(), Box<dyn Error>> {
    let bus = VirtualSignBus::new(vec![
        VirtualSign::new(Address(3), PageFlipStyle::Automatic),
        VirtualSign::new(Address(6), PageFlipStyle::Manual),
    ]);
    let bus = Rc::new(RefCell::new(bus));

    let sign6 = Sign::new(bus.clone(), Address(6), SignType::HorizonFront160x16);

    // Verify both virtual signs initially have unknown type and are in the Unconfigured state.
    assert_eq!(None, bus.borrow().sign(0).sign_type());
    assert_eq!(State::Unconfigured, bus.borrow().sign(0).state());
    assert_eq!(None, bus.borrow().sign(1).sign_type());
    assert_eq!(State::Unconfigured, bus.borrow().sign(1).state());

    sign6.configure()?;

    // After configuring sign 6, the corresponding virtual sign should be in the ConfigReceived
    // state with the appropriate sign type, and the other should be unaffected.
    assert_eq!(None, bus.borrow().sign(0).sign_type());
    assert_eq!(State::Unconfigured, bus.borrow().sign(0).state());
    assert_eq!(Some(SignType::HorizonFront160x16), bus.borrow().sign(1).sign_type());
    assert_eq!(State::ConfigReceived, bus.borrow().sign(1).state());

    let mut pages = [sign6.create_page(PageId(1))];
    pages[0].set_pixel(5, 5, true);
    sign6.send_pages(&pages)?;

    // After sending pages to sign 6, the corresponding virtual sign should be in the PageLoaded
    // state with the appropriate page list, and the other should be unaffected.
    assert!(bus.borrow().sign(0).pages().is_empty());
    assert_eq!(State::Unconfigured, bus.borrow().sign(0).state());
    assert_eq!(&pages, bus.borrow().sign(1).pages());
    assert_eq!(State::PageLoaded, bus.borrow().sign(1).state());

    sign6.show_loaded_page()?;

    // After showing a page, the corresponding virtual sign should be in the PageShown
    // state, and the other should be unaffected.
    assert_eq!(State::Unconfigured, bus.borrow().sign(0).state());
    assert_eq!(State::PageShown, bus.borrow().sign(1).state());

    sign6.load_next_page()?;

    // After loading a page, the corresponding virtual sign should be in the PageLoaded
    // state, and the other should be unaffected.
    assert_eq!(State::Unconfigured, bus.borrow().sign(0).state());
    assert_eq!(State::PageLoaded, bus.borrow().sign(1).state());

    let mut pages2 = [sign6.create_page(PageId(1)), sign6.create_page(PageId(2))];
    pages2[0].set_pixel(1, 1, true);
    sign6.send_pages(&pages2)?;

    // After sending pages to sign 6, the corresponding virtual sign should be in the PageLoaded
    // state with the appropriate page list, and the other should be unaffected.
    assert!(bus.borrow().sign(0).pages().is_empty());
    assert_eq!(State::Unconfigured, bus.borrow().sign(0).state());
    assert_eq!(&pages2, bus.borrow().sign(1).pages());
    assert_eq!(State::PageLoaded, bus.borrow().sign(1).state());

    let sign3 = Sign::new(bus.clone(), Address(3), SignType::Max3000Dash30x7);
    sign3.configure()?;

    // Configuring sign 3 should not have affected sign 6.
    assert_eq!(State::ConfigReceived, bus.borrow().sign(0).state());
    assert_eq!(State::PageLoaded, bus.borrow().sign(1).state());

    let mut pages3 = [sign3.create_page(PageId(1))];
    pages3[0].set_pixel(2, 3, true);
    sign3.send_pages(&pages3)?;

    // After sending pages to sign 3, the corresponding virtual sign should be in the PageLoaded
    // state with the appropriate page list, and the other should be unaffected.
    assert_eq!(&pages3, bus.borrow().sign(0).pages());
    assert_eq!(State::ShowingPages, bus.borrow().sign(0).state());
    assert_eq!(&pages2, bus.borrow().sign(1).pages());
    assert_eq!(State::PageLoaded, bus.borrow().sign(1).state());

    sign3.show_loaded_page()?;

    // These functions should be no-ops for automatic-flip signs.
    assert_eq!(State::ShowingPages, bus.borrow().sign(0).state());
    assert_eq!(State::PageLoaded, bus.borrow().sign(1).state());

    sign3.load_next_page()?;

    // These functions should be no-ops for automatic flip signs.
    assert_eq!(State::ShowingPages, bus.borrow().sign(0).state());
    assert_eq!(State::PageLoaded, bus.borrow().sign(1).state());

    sign6.shut_down()?;

    // After shutdown, all state should be cleared from virtual sign 6, but 3 should not be affected.
    assert_eq!(1, bus.borrow().sign(0).pages().len());
    assert_eq!(State::ShowingPages, bus.borrow().sign(0).state());
    assert_eq!(Some(SignType::Max3000Dash30x7), bus.borrow().sign(0).sign_type());
    assert!(bus.borrow().sign(1).pages().is_empty());
    assert_eq!(State::Unconfigured, bus.borrow().sign(1).state());
    assert_eq!(None, bus.borrow().sign(1).sign_type());

    Ok(())
}