probe-rs 0.32.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

//! Plugin system for probe-rs.
//!
//! This module contains the interfaces necessary to define and register plugins.
//! Plugins can extend the functionality of probe-rs by adding e.g. new targets, probes, image formats.
//!
//! Plugins are registered by calling the [`register_plugin`] function.

use probe_rs_target::ChipFamily;

use crate::{flashing::ImageFormat, probe::ProbeFactory, vendor::Vendor};

/// A plugin that can extend the functionality of probe-rs.
#[derive(Clone, Default)]
pub struct Plugin<'p> {
    /// A list of vendors to register with probe-rs.
    pub vendors: &'p [&'static dyn Vendor],

    /// A list of image formats to register with probe-rs.
    pub image_formats: &'p [&'static dyn ImageFormat],

    /// A list of targets to register with probe-rs.
    pub targets: &'p [ChipFamily],

    /// A list of probe driver factories.
    pub probe_drivers: &'p [&'static dyn ProbeFactory],
}

/// Register a plugin.
pub fn register_plugin(plugin: Plugin<'_>) {
    // Implementation of plugin registration
    for vendor in plugin.vendors {
        crate::vendor::register_vendor(*vendor);
    }
    for image_format in plugin.image_formats {
        crate::flashing::register_image_format(*image_format);
    }
    for target in plugin.targets {
        crate::config::registry::add_builtin_target(target.clone());
    }
    for probe_driver in plugin.probe_drivers {
        crate::probe::register_probe_factory(*probe_driver);
    }
}