matter-controller 0.1.0

High-level Matter controller API: commission, read, write, invoke, subscribe.
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
64
65
66
67
68

//! M9-F4 operator harness: announce + serve a real `.ota` over BDX to a
//! commissioned requestor (e.g. connectedhomeip's `ota-requestor-app`).
//!
//! ```text
//! cargo run -p matter-controller --example serve_ota -- \
//!     --store /tmp/matter-ota.bin --node 5 --version 2 --image /tmp/test.ota
//! ```
//!
//! See docs/runbooks/m9-f4-ota-end-to-end.md for the full live procedure
//! (generating the image with chip's ota_image_tool.py, commissioning the
//! requestor, and watching it download + apply).

#![allow(clippy::too_many_lines, clippy::doc_markdown)]

use std::path::PathBuf;
use std::sync::Arc;

use anyhow::{Context, Result};
use clap::Parser;
use matter_controller::{FileStore, MatterController};

#[derive(Parser)]
#[command(about = "M9-F4 OTA provider: announce + serve a .ota over BDX")]
struct Args {
    /// Path to a persistent controller snapshot that already holds a fabric and
    /// has commissioned the requestor.
    #[arg(long)]
    store: PathBuf,

    /// Node id of the already-commissioned requestor to announce to.
    #[arg(long)]
    node: u64,

    /// SoftwareVersion to offer (must exceed the requestor's current version and
    /// match the version baked into the `.ota` header).
    #[arg(long)]
    version: u32,

    /// Path to the Matter `.ota` image (generate with chip's ota_image_tool.py).
    #[arg(long)]
    image: PathBuf,

    /// UDP port to bind the provider socket to (0 = ephemeral).
    #[arg(long, default_value_t = 5560)]
    port: u16,
}

#[tokio::main]
async fn main() -> Result<()> {
    let args = Args::parse();
    let image = std::fs::read(&args.image).context("read .ota image")?;
    println!(
        "[ota] loaded {}-byte image; announcing to node {} + serving on port {}…",
        image.len(),
        args.node,
        args.port
    );
    let store = Arc::new(FileStore::new(&args.store));
    let controller = MatterController::open(store)
        .await
        .context("open controller")?;
    controller
        .serve_ota(args.node, image, args.version, args.port)
        .await
        .context("serve_ota")?;
    println!("[ota] done — requestor downloaded + applied the image");
    Ok(())
}