blackbox-rs 0.1.0

Embassy-based board support crate for the Blackbox board (STM32H743XI): clocks, SDRAM, LTDC display, LEDs, buttons, encoders, GT9147 touch and CS42528 audio.
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

//! 13 active-low buttons with board pull-ups (README §buttons).

use embassy_stm32::gpio::{AnyPin, Input, Pull};
use embassy_stm32::Peri;

/// Number of buttons.
pub const COUNT: usize = 13;

/// A named button. Discriminant = position in the pin order passed to [`Buttons::new`].
#[derive(Clone, Copy, PartialEq, Eq, defmt::Format)]
pub enum Button {
    Pads,
    Keys,
    Seqs,
    Song,
    Fx,
    Mix,
    Pset,
    Tools,
    Rec,
    Stop,
    Play,
    Back,
    Info,
}

impl Button {
    /// Every button, in pin order.
    pub const ALL: [Button; COUNT] = [
        Button::Pads,
        Button::Keys,
        Button::Seqs,
        Button::Song,
        Button::Fx,
        Button::Mix,
        Button::Pset,
        Button::Tools,
        Button::Rec,
        Button::Stop,
        Button::Play,
        Button::Back,
        Button::Info,
    ];

    pub const fn index(self) -> usize {
        self as usize
    }

    pub const fn label(self) -> &'static str {
        match self {
            Button::Pads => "PADS",
            Button::Keys => "KEYS",
            Button::Seqs => "SEQS",
            Button::Song => "SONG",
            Button::Fx => "FX",
            Button::Mix => "MIX",
            Button::Pset => "PSET",
            Button::Tools => "TOOLS",
            Button::Rec => "REC",
            Button::Stop => "STOP",
            Button::Play => "PLAY",
            Button::Back => "BACK",
            Button::Info => "INFO",
        }
    }
}

/// The board's button bank. Construct via [`crate::init`].
pub struct Buttons {
    inp: [Input<'static>; COUNT],
}

impl Buttons {
    /// Pins in [`Button::ALL`] order; pass already-degraded [`AnyPin`]s. Board has pull-ups.
    pub fn new(pins: [Peri<'static, AnyPin>; COUNT]) -> Self {
        Self {
            inp: pins.map(|p| Input::new(p, Pull::None)),
        }
    }

    /// Is this button currently pressed (active-low → pin low)?
    pub fn is_pressed(&self, b: Button) -> bool {
        self.inp[b.index()].is_low()
    }

    /// Pressed state of every button, indexed by [`Button::index`].
    pub fn pressed(&self) -> [bool; COUNT] {
        core::array::from_fn(|i| self.inp[i].is_low())
    }
}