matter-controller 0.5.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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

[package]
name = "matter-controller"
version = "0.5.0"
description = "High-level Matter controller API: commission, read, write, invoke, subscribe."
edition.workspace = true
rust-version.workspace = true
license.workspace = true
repository.workspace = true
homepage.workspace = true
authors.workspace = true
keywords = ["matter", "controller", "smart-home", "iot"]
categories = ["api-bindings", "network-programming"]
readme = "README.md"

[lints]
workspace = true

[features]
default = ["ota"]

# OTA provider role: `serve_ota*`, `announce_ota_provider`, and the BDX
# transfer engine. On by default; `default-features = false` sheds the
# matter-ota + matter-bdx dependencies for controllers that never serve
# firmware images.
ota = ["dep:matter-ota", "dep:matter-bdx"]

# BLE/BTP commissioning (`MatterController::commission_ble`). Pulls the
# `matter-ble` central role (btleplug + libdbus on Linux / CoreBluetooth on
# macOS), so it is opt-in. The default IP commissioning path needs none of it.
ble = ["dep:matter-ble", "matter-ble/central"]

# UNSTABLE, not covered by semver. Exposes the low-level provider-server
# building blocks (`ProviderServer`, `build_operational_service`) and
# `MatterController::serve_provider_once` — a generic CASE/IM responder for
# power users building a custom server. The supported, stable OTA path is
# `MatterController::serve_ota`, which needs none of this. May change or be
# removed in any release.
unstable-provider = []

[dependencies]
matter-codec = { path = "../matter-codec", version = "0.3.0" }
matter-cert = { path = "../matter-cert", version = "0.3.0" }
matter-crypto = { path = "../matter-crypto", version = "0.3.0" }
matter-transport = { path = "../matter-transport", version = "0.3.0" }
matter-commissioning = { path = "../matter-commissioning", version = "0.4.0", features = ["driver"] }
matter-interaction = { path = "../matter-interaction", version = "0.4.0" }
tokio = { workspace = true, features = ["rt", "rt-multi-thread", "macros", "sync", "time"] }
matter-clusters = { path = "../matter-clusters", version = "0.3.0" }
matter-ota = { path = "../matter-ota", version = "0.4.0", optional = true }
matter-bdx = { path = "../matter-bdx", version = "0.3.0", optional = true }
matter-ble = { path = "../matter-ble", version = "0.3.2", optional = true }
thiserror = { workspace = true }
tracing = { version = "0.1", default-features = false, features = ["std"] }

[dev-dependencies]
proptest = { workspace = true }
anyhow = { workspace = true }
clap = { workspace = true }
serde = { workspace = true }
serde_json = { workspace = true }
# Test-only: enables `matter_commissioning::test_support`'s canned
# `CommissionedFabric` constructor so actor.rs's unit tests can exercise a
# successful-commission completion without a full PASE/CASE handshake.
# Mirrors matter-commissioning's own dev-dependency on matter-cert's
# `test-support`. Cargo unifies this into the lib build only under
# `cargo test` (dev-dependencies never apply to a plain `cargo build`).
matter-commissioning = { path = "../matter-commissioning", version = "0.4.0", features = ["driver", "test-support"] }

[[example]]
name = "controller_quickstart"

[[example]]
name = "power"

[[example]]
name = "dump_attributes"

[[example]]
name = "fabric_management"

[[example]]
name = "d_hardware_extras"

[[example]]
name = "e3_group_multicast"

[[example]]
name = "group_acl_test"

[[example]]
name = "open_window"

[[example]]
name = "provider_server"
required-features = ["unstable-provider"]

[[example]]
name = "serve_ota"
required-features = ["ota"]

[[example]]
name = "ble_scan"
required-features = ["ble"]

[[example]]
name = "commission_ble_thread"
required-features = ["ble"]

[[example]]
name = "commission_ble_wifi"
required-features = ["ble"]