chapa 0.5.0

Bitfield structs, batteries included!
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

use chapa::{bitfield, BitEnum};

/// A simple LSB-0 register with a bool and integer field.
#[bitfield(u8, order = lsb0)]
#[derive(Copy, Clone, Debug, PartialEq)]
pub struct StatusReg {
    #[bits(0)]
    enabled: bool,
    #[bits(1..=3)]
    mode: u8,
    #[bits(4..=7, readonly)]
    _reserved: u8,
}

#[test]
fn debug_lsb0_struct() {
    let r = StatusReg::zeroed().with_enabled(true).with_mode(5);
    let s = format!("{:?}", r);
    assert_eq!(s, "StatusReg { enabled: true, mode: 5, reserved: 0 }");
}

#[derive(Debug, PartialEq, Clone, Copy, BitEnum)]
pub enum Mode {
    Off = 0,
    On = 1,
    Turbo = 2,
    #[fallback]
    Reserved = 3,
}

/// Bitfield with an enum field.
#[bitfield(u8, order = lsb0)]
#[derive(Copy, Clone, Debug, PartialEq)]
pub struct CtrlReg {
    #[bits(0..=1)]
    mode: Mode,
    #[bits(2)]
    active: bool,
}

#[test]
fn debug_enum_field() {
    let r = CtrlReg::zeroed().with_mode(Mode::On).with_active(true);
    let s = format!("{:?}", r);
    // Mode::On Debug output is "On"
    assert!(s.contains("On"));
    assert!(s.contains("active: true"));
}

/// Bitfield where Debug is in the derive list, macro should replace it with
/// the bitfield-aware impl.
#[bitfield(u8, order = lsb0)]
#[derive(Copy, Clone, Debug, PartialEq)]
pub struct FlagsReg {
    #[bits(0)]
    flag_a: bool,
    #[bits(1)]
    flag_b: bool,
}

#[test]
fn debug_with_derive_debug_in_attrs() {
    let r = FlagsReg::zeroed().with_flag_a(true);
    let s = format!("{:?}", r);
    assert_eq!(s, "FlagsReg { flag_a: true, flag_b: false }");
}