bmputil 1.1.0

Black Magic Probe companion utility
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

// SPDX-License-Identifier: MIT OR Apache-2.0
// SPDX-FileCopyrightText: 2022-2025 1BitSquared <info@1bitsquared.com>
// SPDX-FileContributor: Written by Mikaela Szekely <mikaela.szekely@qyriad.me>
// SPDX-FileContributor: Written by Piotr Esden-Tempski <piotr@esden.net>
// SPDX-FileContributor: Modified by Rachel Mant <git@dragonmux.network>

#![allow(clippy::tabs_in_doc_comments)]

use clap::ValueEnum;
use clap::builder::PossibleValue;

use crate::firmware_type::FirmwareType;

pub mod bmp;
mod bmp_matcher;
pub mod docs_viewer;
pub mod error;
mod firmware_file;
pub mod firmware_selector;
pub mod firmware_type;
pub mod flasher;
pub mod metadata;
pub mod probe_identity;
pub mod serial;
pub mod switcher;
pub mod usb;
#[cfg(windows)]
pub mod windows;

pub trait BmpParams
{
	fn index(&self) -> Option<usize>;
	fn serial_number(&self) -> Option<&str>;
}

pub trait FlashParams
{
	fn allow_dangerous_options(&self) -> AllowDangerous;
	fn override_firmware_type(&self) -> Option<FirmwareType>;
}

#[derive(Clone, Copy)]
pub enum AllowDangerous
{
	Never,
	Really,
}

impl ValueEnum for AllowDangerous
{
	fn value_variants<'a>() -> &'a [Self]
	{
		&[Self::Never, Self::Really]
	}

	fn to_possible_value(&self) -> Option<PossibleValue>
	{
		match self {
			Self::Never => Some("never".into()),
			Self::Really => Some("really".into()),
		}
	}
}