trace-recorder-parser 0.19.0

A Rust library to parse Percepio's TraceRecorder data
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

use crate::streaming::Error;
use crate::time::{Frequency, Timestamp};
use crate::types::{Endianness, TimerCounter};
use byteordered::ByteOrdered;
use std::io::Read;

#[derive(Clone, Eq, PartialEq, Ord, PartialOrd, Hash, Debug)]
pub struct TimestampInfo {
    pub timer_type: TimerCounter,
    pub timer_frequency: Frequency,
    pub timer_period: u32,
    pub timer_wraparounds: u32,
    pub os_tick_rate_hz: Frequency,
    pub latest_timestamp: Timestamp,
    pub os_tick_count: u32,
}

impl TimestampInfo {
    pub(crate) fn read<R: Read>(
        r: &mut R,
        endianness: Endianness,
        format_version: u16,
    ) -> Result<Self, Error> {
        let mut r = ByteOrdered::new(r, byteordered::Endianness::from(endianness));

        let hwtc_type = r.read_u32()?;
        let timer_type =
            TimerCounter::from_hwtc_type(hwtc_type).ok_or(Error::InvalidTimerCounter(hwtc_type))?;

        let timer_frequency;
        let timer_period;

        if format_version == 10 || format_version == 12 {
            // NOTE: we assume TRC_BASE_TYPE and TRC_UNSIGNED_BASE_TYPE are 32-bit
            timer_frequency = Frequency(r.read_u32()?);
            timer_period = r.read_u32()?;
        } else {
            // v13+
            timer_period = r.read_u32()?;
            // NOTE: we assume TRC_BASE_TYPE and TRC_UNSIGNED_BASE_TYPE are 32-bit
            timer_frequency = Frequency(r.read_u32()?);
        }

        let timer_wraparounds = r.read_u32()?;
        let os_tick_rate_hz = Frequency(r.read_u32()?);
        let latest_timestamp = Timestamp(r.read_u32()?.into());
        let os_tick_count = r.read_u32()?;

        Ok(TimestampInfo {
            timer_type,
            timer_frequency,
            timer_period,
            timer_wraparounds,
            os_tick_rate_hz,
            latest_timestamp,
            os_tick_count,
        })
    }
}