aboutsummaryrefslogtreecommitdiff
path: root/tests/macros.rs
blob: 8ff36ac2e9471cb87cb286215b427eb5a9a4f5d5 (plain)
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
//! Test the read, write, modify macros.

use ral_registers as ral;

struct DummyRegisterBlock {
    register: ral::RWRegister<u32>,
}

mod register {
    #![allow(non_upper_case_globals, non_snake_case)] // Macro conventions.

    pub mod field_foo {
        pub const offset: u32 = 10;
        pub const mask: u32 = 0x7 << offset;
        pub mod RW {}
        pub mod W {}
        pub mod R {}
    }
}

fn zeroed_register_block() -> DummyRegisterBlock {
    use core::mem::MaybeUninit;
    let register_block = MaybeUninit::zeroed();
    // Safety: 0 is a safe bitpattern
    unsafe { register_block.assume_init() }
}

#[test]
fn register_read() {
    let register_block = zeroed_register_block();
    register_block.register.write(0b111 << 10);
    assert_eq!(
        0x7,
        ral::read_reg!(self, &register_block, register, field_foo)
    );
}

#[test]
fn register_write() {
    let register_block = zeroed_register_block();
    ral::write_reg!(self, &register_block, register, field_foo: 5);
    assert_eq!(5 << 10, register_block.register.read());
}

#[test]
fn register_modify() {
    let register_block = zeroed_register_block();
    register_block.register.write(1 << 10);
    ral::modify_reg!(self, &register_block, register, field_foo: 6);
    assert_eq!(6 << 10, register_block.register.read());
}

/// Demonstrates that a local variable, 'mask'
/// doesn't affect the macro's behavior.
///
/// This is the same test as register_modify(), but
/// with the number '6' in a variable called 'mask'.
#[deny(warnings)] // Promotes "unused variable: mask" into an error. Should no longer happen.
#[test]
fn register_unused_mask_modify() {
    let register_block = zeroed_register_block();
    register_block.register.write(1 << 10);
    let mask = 6;
    ral::modify_reg!(self, &register_block, register, field_foo: mask);
    assert_eq!(6 << 10, register_block.register.read());
}

/// Same test as above, but with a variable called
/// 'offset' instead of 'mask'.
#[deny(warnings)]
#[test]
fn register_unused_offset_modify() {
    let register_block = zeroed_register_block();
    register_block.register.write(1 << 10);
    let offset = 6;
    ral::modify_reg!(self, &register_block, register, field_foo: offset);
    assert_eq!(6 << 10, register_block.register.read());
}

/// Same as above test, but using the 'write' macro
/// instead of 'modify'.
#[deny(warnings)]
#[test]
fn register_unused_mask_write() {
    let register_block = zeroed_register_block();
    register_block.register.write(1 << 10);
    let mask = 6;
    ral::write_reg!(self, &register_block, register, field_foo: mask);
    assert_eq!(6 << 10, register_block.register.read());
}

/// Same test as above, but with a variable called
/// 'offset' instead of 'mask'.
#[deny(warnings)]
#[test]
fn register_unused_offset_write() {
    let register_block = zeroed_register_block();
    register_block.register.write(1 << 10);
    let offset = 6;
    ral::write_reg!(self, &register_block, register, field_foo: offset);
    assert_eq!(6 << 10, register_block.register.read());
}