probe-rs 0.9.0

A collection of on chip debugging tools to communicate with microchips.
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
92
93
94
95
96
97
98
99
100
101

use probe_rs::debug::{ColumnType, DebugInfo, SourceLocation};
use std::path::{Path, PathBuf};

const TEST_DATA: [(u64, u64, ColumnType); 8] = [
    // Target address, line, column
    (0x920, 11, ColumnType::LeftEdge),
    (0x922, 13, ColumnType::Column(21)),
    (0x92e, 13, ColumnType::Column(11)),
    (0x938, 27, ColumnType::Column(4)),
    (0x93a, 14, ColumnType::Column(19)),
    (0x956, 20, ColumnType::Column(12)),
    (0x962, 21, ColumnType::Column(12)),
    (0x96a, 22, ColumnType::Column(12)),
];

#[test]
fn breakpoint_location_absolute() {
    let di = DebugInfo::from_file("tests/gpio_hal_blinky").unwrap();

    // Here we test with an absolute path, i.e. the combination of compilation directory
    // and relative path to the actual source file.
    let path = Path::new("/home/dominik/Coding/microbit/examples/gpio_hal_blinky.rs");

    for (addr, line, col) in TEST_DATA.iter() {
        let col = if let ColumnType::Column(c) = col {
            Some(*c)
        } else {
            None
        };

        assert_eq!(
            Some(*addr),
            di.get_breakpoint_location(&path, *line, col)
                .expect("Failed to find breakpoint location."),
            "Addresses do not match for data path={:?}, line={:?}, col={:?}",
            &path,
            line,
            col,
        );
    }
}

#[test]
fn breakpoint_location_inexact() {
    // test getting breakpoint location for an inexact location,
    // i.e. no exact entry exists for line 13 and column 14.
    let test_data = [(0x92e, 13, ColumnType::Column(14))];

    let di = DebugInfo::from_file("tests/gpio_hal_blinky").unwrap();

    let path = Path::new("/home/dominik/Coding/microbit/examples/gpio_hal_blinky.rs");

    for (addr, line, col) in test_data.iter() {
        let col = if let ColumnType::Column(c) = col {
            Some(*c)
        } else {
            None
        };

        assert_eq!(
            Some(*addr),
            di.get_breakpoint_location(&path, *line, col)
                .expect("Failed to find breakpoint location."),
            "Addresses do not match for data path={:?}, line={:?}, col={:?}",
            &path,
            line,
            col,
        );
    }
}

#[test]
fn source_location() {
    let di = DebugInfo::from_file("tests/gpio_hal_blinky").unwrap();

    let file = "gpio_hal_blinky.rs";

    for (addr, line, col) in TEST_DATA.iter() {
        assert_eq!(
            Some(SourceLocation {
                line: Some(*line),
                column: Some(*col),
                directory: Some(PathBuf::from("examples")),
                file: Some(file.to_owned()),
            }),
            di.get_source_location(*addr)
        );
    }
}

#[test]
fn find_non_existing_unit_by_path() {
    let unit_path = Path::new("/home/dominik/Coding/microbit/non_existing.rs");

    let debug_info = DebugInfo::from_file("tests/gpio_hal_blinky").unwrap();

    assert!(debug_info
        .get_breakpoint_location(&unit_path, 14, None)
        .unwrap()
        .is_none());
}