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

use std::cell::RefCell;
use std::error::Error;
use std::fmt::Debug;
use std::io::{self, Read};
use std::iter;
use std::rc::Rc;

use flipdot::core::*;
use flipdot::serial::*;
use flipdot::*;
use flipdot_testing::*;

mod mock_serial_port;
use crate::mock_serial_port::{MockSerialPort, SerialFailure};

#[derive(Debug, Clone, PartialEq, Eq)]
struct ErrorReader {}

impl Read for ErrorReader {
    fn read(&mut self, _: &mut [u8]) -> io::Result<usize> {
        Err(io::Error::new(io::ErrorKind::Other, "Dummy read error"))
    }
}

#[derive(Debug, Clone, PartialEq, Eq)]
enum BusFailure {
    Error,
    WrongMessage,
}

#[derive(Debug, Clone, PartialEq, Eq)]
struct ErrorSignBus {
    failure: BusFailure,
}

impl ErrorSignBus {
    pub fn new(failure: BusFailure) -> Self {
        ErrorSignBus { failure }
    }
}

impl SignBus for ErrorSignBus {
    fn process_message<'a>(&mut self, _: Message<'_>) -> Result<Option<Message<'a>>, Box<dyn Error + Send + Sync>> {
        match self.failure {
            BusFailure::Error => Err(format!("Dummy sign bus error"))?,
            BusFailure::WrongMessage => Ok(Some(Message::Goodbye(Address(0)))),
        }
    }
}

#[test]
fn format_errors() -> Result<(), Box<dyn Error>> {
    // Core
    print_error("Too much data", Data::try_new(vec![0; 256]));
    print_error("I/O error", Frame::read(&mut ErrorReader {}));
    print_error("Bad frame data", Frame::from_bytes(b":01"));
    print_error("Wrong frame data size", Frame::from_bytes(b":01007F027E"));
    print_error("Wrong frame checksum", Frame::from_bytes(b":01007F02FF7E"));
    print_error("Wrong page data length", Page::from_bytes(90, 7, vec![1, 2, 3]));
    print_error("Wrong config data length", SignType::from_bytes(&vec![1, 2, 3]));
    print_error("Unknown config", SignType::from_bytes(&vec![0; 16]));

    // Serial
    print_error(
        "Serial config failure",
        SerialSignBus::try_new(MockSerialPort::new(vec![], SerialFailure::WriteSettings)),
    );

    // Testing
    let mut odk = Odk::try_new(
        MockSerialPort::new(vec![], SerialFailure::Read),
        ErrorSignBus::new(BusFailure::Error),
    )?;
    print_error("ODK read error", odk.process_message());

    let mut odk = Odk::try_new(
        MockSerialPort::new(b":01007F02FF7F\r\n".to_vec(), SerialFailure::None),
        ErrorSignBus::new(BusFailure::Error),
    )?;
    print_error("ODK bus error", odk.process_message());

    // Flipdot
    let bus = Rc::new(RefCell::new(ErrorSignBus::new(BusFailure::Error)));
    let sign = Sign::new(bus.clone(), Address(3), SignType::Max3000Side90x7);
    print_error("Sign bus error", sign.configure());

    let bus = Rc::new(RefCell::new(ErrorSignBus::new(BusFailure::WrongMessage)));
    let sign = Sign::new(bus.clone(), Address(3), SignType::Max3000Side90x7);
    print_error("Sign wrong message", sign.configure());

    Ok(())
}

fn print_error<V: Debug, E: Error>(title: &'static str, result: Result<V, E>) {
    println!("** {} **", title);

    let e = result.unwrap_err();
    let mut current = Some(&e as &dyn Error);
    let errors = iter::from_fn(|| {
        let ret = current;
        current = current.and_then(|err| err.source());
        ret
    });

    let headings = iter::once("Error").chain(iter::repeat("Caused by"));
    for (heading, failure) in headings.zip(errors) {
        println!("{}: {}", heading, failure);
    }
    println!();
}