riscv-etrace 0.6.2

Decoder and tracer for RISC-V efficient instruction tracing
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

// Copyright (C) 2025 FZI Forschungszentrum Informatik
// SPDX-License-Identifier: Apache-2.0
//! Tets related to RISC-V Encapsulation packets
use super::*;

#[test]
fn encap_stop() {
    let mut decoder = Builder::new().decoder(b"\x00\x00\x00\x00");
    for _ in 0..4 {
        assert_eq!(
            decoder.decode_encap_packet(),
            Ok(encap::Packet::NullIdle { flow: 0 }),
        );
    }
    assert_eq!(decoder.bytes_left(), 0, "Not at end of buffer");
    assert_eq!(
        decoder.decode_encap_packet(),
        Err(Error::InsufficientData(NonZeroUsize::MIN)),
    );
}

// sync::Context packet; timestamp: 8D; srcId: 31h, header: extend:1, flow: 10,
// length: 01001 -> 1100 | 1001 = C9 9 bytes payload
//
// $ Note
//
// To decode encap packet with timestamp & srcId, harte_index_width and
// timestamp_width need to be defined otherwise assumed as 0
bitstream_test!(
    normal_support,
    b"\xC9\x31\x8D\x73\x00\x00\x00\x00\x19\x41\x00\x08",
    encap::Packet::from(
        encap::Normal::new(
            2,
            0x31,
            payload::Payload::InstructionTrace(
                sync::Start {
                    branch: true,
                    ctx: sync::Context {
                        privilege: types::Privilege::Machine,
                        time: None,
                        context: 0,
                    },
                    address: 536937572
                }
                .into()
            )
        )
        .with_timestamp(0x8D)
    ),
    params(&PARAMS_32),
    timestamp_width(1),
    hart_index_width(8)
);

bitstream_test!(
    normal_support_small_srcid,
    b"\xCA\xD3\x38\x07\x00\x00\x00\x90\x11\x04\x80\x00",
    encap::Packet::from(
        encap::Normal::new(
            2,
            3,
            payload::Payload::InstructionTrace(
                sync::Start {
                    branch: true,
                    ctx: sync::Context {
                        privilege: types::Privilege::Machine,
                        time: None,
                        context: 0,
                    },
                    address: 536937572
                }
                .into()
            )
        )
        .with_timestamp(0x8D)
    ),
    params(&PARAMS_32),
    timestamp_width(1),
    hart_index_width(4)
);

// header reverse: 0010 | 0000, srdId: 0001 | 0000;
bitstream_test!(
    null_idle,
    b"\x20",
    encap::Packet::<payload::Payload>::NullIdle { flow: 1 },
    params(&PARAMS_32),
    hart_index_width(8)
);

// header reverse: 1110 | 0000; timestamp: 0001 | 1001
bitstream_test!(
    null_align,
    b"\xE0",
    encap::Packet::<payload::Payload>::NullAlign { flow: 3 },
    params(&PARAMS_32),
    timestamp_width(1)
);