Krolyxon
Commit b37b005

Branches

Refs →

budctlcratesbudctl-coresrcstatus.rs

118 lines · 3.3 KB · Rust

Raw Blame History Download
1//! What a session reports, in device-neutral terms. Front ends print these, and `--json`
2//! serializes them as they are.
3
4use serde::{Serialize, Serializer};
5
6/// Bumped whenever the JSON shape changes incompatibly.
7pub const JSON_SCHEMA: u32 = 1;
8
9#[derive(Debug, Default, Serialize)]
10pub struct Status {
11 pub battery: Battery,
12 pub noise_control: Option<NoiseControl>,
13 /// Name of the current EQ preset.
14 pub eq: Option<String>,
15 pub bass_level: Option<i8>,
16 /// On/off settings, serialized as `{"game": false, …}`.
17 #[serde(serialize_with = "switches_as_map")]
18 pub switches: Vec<Switch>,
19 /// Audio codec of the link the buds report.
20 pub codec: Option<String>,
21 pub firmware: Option<String>,
22 /// Reads that failed. The rest of the status is still valid.
23 pub warnings: Vec<String>,
24}
25
26#[derive(Debug, Default, Clone, Copy, PartialEq, Eq, Serialize)]
27pub struct Battery {
28 pub left: Option<Charge>,
29 pub right: Option<Charge>,
30 pub case: Option<Charge>,
31}
32
33#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize)]
34pub struct Charge {
35 /// Percent.
36 pub level: u8,
37 pub charging: bool,
38}
39
40#[derive(Debug, Clone, PartialEq, Eq, Serialize)]
41pub struct NoiseControl {
42 /// `off`, `transparency` or `anc`, or `unknown (…)` for a value the device module cannot name.
43 pub mode: String,
44 /// The noise-cancelling level, when the device reports one.
45 pub level: Option<String>,
46}
47
48/// A noise-control mode to set.
49#[derive(Debug, Clone, Copy, PartialEq, Eq)]
50pub enum NoiseMode {
51 Off,
52 Transparency,
53 Anc(AncLevel),
54}
55
56/// How strongly noise cancelling works.
57#[derive(Debug, Clone, Copy, PartialEq, Eq)]
58pub enum AncLevel {
59 Light,
60 Medium,
61 Deep,
62}
63
64impl AncLevel {
65 /// The name [`NoiseControl::level`] uses for it.
66 pub fn name(self) -> &'static str {
67 match self {
68 AncLevel::Light => "light",
69 AncLevel::Medium => "medium",
70 AncLevel::Deep => "deep",
71 }
72 }
73}
74
75impl NoiseMode {
76 /// The name [`NoiseControl::mode`] uses for it.
77 pub fn name(self) -> &'static str {
78 match self {
79 NoiseMode::Off => "off",
80 NoiseMode::Transparency => "transparency",
81 NoiseMode::Anc(_) => "anc",
82 }
83 }
84}
85
86#[derive(Debug, Clone, PartialEq, Eq, Serialize)]
87pub struct Switch {
88 /// Stable name used on the command line and in JSON (`game`, `dual`…).
89 pub key: &'static str,
90 /// Human name (`Game mode`).
91 pub label: &'static str,
92 pub on: bool,
93}
94
95#[derive(Debug, Default, Serialize)]
96pub struct TouchControls {
97 pub gestures: Vec<Gesture>,
98 /// Noise-control modes a hold steps through, when the device has that setting.
99 pub hold_cycle: Option<Vec<String>>,
100 pub warnings: Vec<String>,
101}
102
103#[derive(Debug, Clone, PartialEq, Eq, Serialize)]
104pub struct Gesture {
105 /// `left`, `right` or `both`.
106 pub side: String,
107 /// `double-tap`, `triple-tap`, `hold`…
108 pub gesture: String,
109 /// `play-pause`, `next`, `none`…
110 pub action: String,
111 /// Raw button group, for entries outside the main gestures (calls). `None` for the main group.
112 #[serde(skip_serializing_if = "Option::is_none")]
113 pub group: Option<u8>,
114}
115
116fn switches_as_map<S: Serializer>(switches: &[Switch], serializer: S) -> Result<S::Ok, S::Error> {
117 serializer.collect_map(switches.iter().map(|s| (s.key, s.on)))
118}