probe-rs-tools 0.32.0

A collection of on chip debugging tools to communicate with microchips.
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

use std::path::PathBuf;

use time::UtcOffset;

use crate::FormatOptions;
use crate::cmd::run::{MonitoringOptions, NormalRunOptions};
use crate::rpc::client::RpcClient;
use crate::rpc::functions::monitor::MonitorMode;
use crate::rpc::utils::run_loop::VectorCatchConfig;
use crate::util::cli::{self, FileMetadata, parse_metadata, rtt_client};
use crate::util::common_options::ProbeOptions;

#[derive(clap::Parser)]
#[group(skip)]
pub struct Cmd {
    /// Options only used when in normal run mode
    #[clap(flatten)]
    pub(crate) run_options: NormalRunOptions,

    #[clap(flatten)]
    pub(crate) probe_options: ProbeOptions,

    /// The path to the ELF file used to locate the RTT control block and decode defmt frames.
    /// The target is not flashed or reset.
    #[clap(index = 1)]
    pub(crate) path: Option<PathBuf>,

    #[clap(flatten)]
    pub(crate) format_options: FormatOptions,

    #[clap(flatten)]
    pub(crate) monitor_options: MonitoringOptions,
}

impl Cmd {
    pub async fn run(self, client: RpcClient, utc_offset: UtcOffset) -> anyhow::Result<()> {
        let (file_meta, elf_meta) = match &self.path {
            Some(path) => parse_metadata(path).await?,
            None => (FileMetadata::default(), None),
        };

        let session = cli::attach_probe(&client, self.probe_options, elf_meta, true).await?;

        let rtt_client = rtt_client(
            &session,
            &file_meta,
            &self.monitor_options,
            Some(utc_offset),
        )
        .await?;

        cli::monitor(
            &session,
            MonitorMode::AttachToRunning,
            self.path.as_deref(),
            &self.monitor_options,
            Some(rtt_client),
            VectorCatchConfig {
                catch_hardfault: !self.run_options.no_catch_hardfault,
                catch_reset: !self.run_options.no_catch_reset,
                catch_svc: !self.run_options.no_catch_svc,
                catch_hlt: !self.run_options.no_catch_hlt,
            },
        )
        .await?;

        Ok(())
    }
}