hd44780-controller 0.1.0-alpha.2

HD44780 LCD controller with async/sync support for embedded-hal
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

use core::marker::PhantomData;

use crate::{command, device::*};

use super::config::{InitialConfig, RuntimeConfig};

pub mod state {
    pub struct Empty;
    pub struct Uninit;
    pub struct Init;
}

#[derive(Copy, Clone, Debug, Eq, PartialEq)]
pub enum Error {
    CommandError,
    OutOfBounds,
}

impl From<command::Error> for Error {
    fn from(_value: command::Error) -> Self {
        Error::CommandError
    }
}

#[allow(unused)]
pub struct Controller<D, S = state::Empty> {
    pub(super) device: D,
    pub(super) initial_config: InitialConfig,
    pub(super) runtime_config: RuntimeConfig,
    pub(super) _state: PhantomData<S>,
}

impl<D> Controller<D, state::Empty> {
    pub fn new<Dev: Device>(
        device: Dev,
        initial_config: InitialConfig,
        runtime_config: RuntimeConfig,
    ) -> Controller<Dev, state::Uninit> {
        Controller {
            device,
            initial_config,
            runtime_config,
            _state: PhantomData,
        }
    }

    #[cfg(feature = "async")]
    #[cfg_attr(docsrs, doc(cfg(feature = "async")))]
    pub fn new_async<Dev: AsyncDevice>(
        device: Dev,
        initial_config: InitialConfig,
        runtime_config: RuntimeConfig,
    ) -> Controller<Dev, state::Uninit> {
        Controller {
            device,
            initial_config,
            runtime_config,
            _state: PhantomData,
        }
    }
}

#[cfg(feature = "fmt")]
#[cfg_attr(docsrs, doc(cfg(feature = "fmt")))]
#[macro_export]
macro_rules! lcd_write {
    ($lcd:expr, $($arg:tt)*) => {
        $lcd.write_fmt::<128>(format_args!($($arg)*))
    };

    ($lcd:expr, charset = $charset:expr, $($arg:tt)*) => {
        $lcd.write_fmt_with_charset::<128>(format_args!($($arg)*), $charset)
    };
}

#[cfg(feature = "fmt")]
#[cfg_attr(docsrs, doc(cfg(feature = "fmt")))]
#[macro_export]
macro_rules! lcd_println {
    ($lcd:expr, line = $line:expr, $($arg:tt)*) => {
        $lcd.write_line_fmt::<128>($line, format_args!($($arg)*))
    };

    ($lcd:expr, line = $line:expr, charset = $charset:expr, $($arg:tt)*) => {
        $lcd.write_line_fmt_with_charset::<128>(format_args!($($arg)*), $charset)
    };
}