it8951 0.5.1

A IT8951 E-Paper driver
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

//! Trait to manage origin of the coordinate system

/// Origin for TopLeft corner
pub struct OriginTopLeft;
/// Origin for TopRight corner
pub struct OriginTopRight;

mod private {
    use core::ops::BitXor;
    use embedded_graphics_core::{prelude::Point, primitives::Rectangle};

    use crate::{AreaImgInfo, DevInfo};

    pub trait Sealed {
        /// Transforms the AreaImgInfo
        fn transform(area_img_info: &mut AreaImgInfo, dev_info: &DevInfo);

        /// Determines the right position in a area image buffer for a given pixel
        fn bit_and_byte_pos(
            area: &Rectangle,
            point: Point,
            nibbles_per_row: usize,
            row: usize,
            start_row: usize,
        ) -> (usize, i32);
    }

    impl Sealed for super::OriginTopLeft {
        #[inline(always)]
        fn transform(_: &mut AreaImgInfo, _: &DevInfo) {
            // NoOp
        }

        #[inline(always)]
        fn bit_and_byte_pos(
            area: &Rectangle,
            point: Point,
            nibbles_per_row: usize,
            row: usize,
            start_row: usize,
        ) -> (usize, i32) {
            let u16_pos = ((point.x - (area.top_left.x / 4 * 4)) / 2) as usize
                + nibbles_per_row * (row - start_row);

            // swap last pixel to map little endian behavior
            let byte_pos = u16_pos.bitxor(0x00001);

            // little endian layout
            // [P3, P2 | P1, P0]
            let bit_pos = (point.x % 2) * 4;

            (byte_pos, bit_pos)
        }
    }

    impl Sealed for super::OriginTopRight {
        #[inline(always)]
        fn transform(area_img_info: &mut AreaImgInfo, dev_info: &DevInfo) {
            area_img_info.area_x =
                dev_info.panel_width - area_img_info.area_x - area_img_info.area_w;
        }

        #[inline(always)]
        fn bit_and_byte_pos(
            area: &Rectangle,
            point: Point,
            nibbles_per_row: usize,
            row: usize,
            start_row: usize,
        ) -> (usize, i32) {
            let u16_pos =
                nibbles_per_row - 1 - ((point.x - (area.top_left.x / 4 * 4)) / 2) as usize
                    + nibbles_per_row * (row - start_row);

            // swap last pixel to map little endian behavior
            let byte_pos = u16_pos.bitxor(0x00001);

            // little endian layout
            // [P3, P2 | P1, P0]
            let bit_pos = ((point.x + 1) % 2) * 4;

            (byte_pos, bit_pos)
        }
    }
}

/// Origin trait to transforrm AreaImgInfo before sending to controller
pub trait Origin: private::Sealed {}

impl Origin for OriginTopLeft {}
impl Origin for OriginTopRight {}