mqtt2matter 0.0.0-stage → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +76 -0
- package/LICENSE +202 -0
- package/NOTICE +23 -0
- package/README.md +172 -2
- package/dist/app.d.ts +34 -0
- package/dist/app.js +157 -0
- package/dist/app.js.map +1 -0
- package/dist/commands/import-z2m.d.ts +20 -0
- package/dist/commands/import-z2m.js +173 -0
- package/dist/commands/import-z2m.js.map +1 -0
- package/dist/commands/install.d.ts +41 -0
- package/dist/commands/install.js +250 -0
- package/dist/commands/install.js.map +1 -0
- package/dist/commands/update.d.ts +14 -0
- package/dist/commands/update.js +109 -0
- package/dist/commands/update.js.map +1 -0
- package/dist/config/index.d.ts +2 -0
- package/dist/config/index.js +3 -0
- package/dist/config/index.js.map +1 -0
- package/dist/config/load.d.ts +57 -0
- package/dist/config/load.js +137 -0
- package/dist/config/load.js.map +1 -0
- package/dist/config/schema.d.ts +496 -0
- package/dist/config/schema.js +115 -0
- package/dist/config/schema.js.map +1 -0
- package/dist/engine/payload.d.ts +94 -0
- package/dist/engine/payload.js +515 -0
- package/dist/engine/payload.js.map +1 -0
- package/dist/engine/runtime.d.ts +79 -0
- package/dist/engine/runtime.js +438 -0
- package/dist/engine/runtime.js.map +1 -0
- package/dist/engine/template.d.ts +20 -0
- package/dist/engine/template.js +264 -0
- package/dist/engine/template.js.map +1 -0
- package/dist/engine/units.d.ts +9 -0
- package/dist/engine/units.js +42 -0
- package/dist/engine/units.js.map +1 -0
- package/dist/families/climate.d.ts +11 -0
- package/dist/families/climate.js +68 -0
- package/dist/families/climate.js.map +1 -0
- package/dist/families/color.d.ts +30 -0
- package/dist/families/color.js +152 -0
- package/dist/families/color.js.map +1 -0
- package/dist/families/cover.d.ts +17 -0
- package/dist/families/cover.js +308 -0
- package/dist/families/cover.js.map +1 -0
- package/dist/families/fan.d.ts +16 -0
- package/dist/families/fan.js +154 -0
- package/dist/families/fan.js.map +1 -0
- package/dist/families/index.d.ts +32 -0
- package/dist/families/index.js +162 -0
- package/dist/families/index.js.map +1 -0
- package/dist/families/light.d.ts +36 -0
- package/dist/families/light.js +258 -0
- package/dist/families/light.js.map +1 -0
- package/dist/families/lock.d.ts +10 -0
- package/dist/families/lock.js +31 -0
- package/dist/families/lock.js.map +1 -0
- package/dist/families/on-off.d.ts +7 -0
- package/dist/families/on-off.js +56 -0
- package/dist/families/on-off.js.map +1 -0
- package/dist/families/power-source.d.ts +12 -0
- package/dist/families/power-source.js +60 -0
- package/dist/families/power-source.js.map +1 -0
- package/dist/families/registry.d.ts +40 -0
- package/dist/families/registry.js +72 -0
- package/dist/families/registry.js.map +1 -0
- package/dist/families/rvc.d.ts +40 -0
- package/dist/families/rvc.js +83 -0
- package/dist/families/rvc.js.map +1 -0
- package/dist/families/switch.d.ts +19 -0
- package/dist/families/switch.js +94 -0
- package/dist/families/switch.js.map +1 -0
- package/dist/importers/actions.d.ts +19 -0
- package/dist/importers/actions.js +98 -0
- package/dist/importers/actions.js.map +1 -0
- package/dist/importers/ha/areas.d.ts +6 -0
- package/dist/importers/ha/areas.js +279 -0
- package/dist/importers/ha/areas.js.map +1 -0
- package/dist/importers/ha/generate.d.ts +51 -0
- package/dist/importers/ha/generate.js +1376 -0
- package/dist/importers/ha/generate.js.map +1 -0
- package/dist/importers/ha/index.d.ts +6 -0
- package/dist/importers/ha/index.js +7 -0
- package/dist/importers/ha/index.js.map +1 -0
- package/dist/importers/ha/source.d.ts +36 -0
- package/dist/importers/ha/source.js +95 -0
- package/dist/importers/ha/source.js.map +1 -0
- package/dist/importers/ha/sync.d.ts +29 -0
- package/dist/importers/ha/sync.js +132 -0
- package/dist/importers/ha/sync.js.map +1 -0
- package/dist/importers/ha/templates.d.ts +18 -0
- package/dist/importers/ha/templates.js +285 -0
- package/dist/importers/ha/templates.js.map +1 -0
- package/dist/importers/ha/types.d.ts +78 -0
- package/dist/importers/ha/types.js +479 -0
- package/dist/importers/ha/types.js.map +1 -0
- package/dist/importers/index.d.ts +5 -0
- package/dist/importers/index.js +8 -0
- package/dist/importers/index.js.map +1 -0
- package/dist/importers/patch.d.ts +50 -0
- package/dist/importers/patch.js +224 -0
- package/dist/importers/patch.js.map +1 -0
- package/dist/importers/sync.d.ts +112 -0
- package/dist/importers/sync.js +220 -0
- package/dist/importers/sync.js.map +1 -0
- package/dist/importers/twins.d.ts +10 -0
- package/dist/importers/twins.js +34 -0
- package/dist/importers/twins.js.map +1 -0
- package/dist/importers/z2m/generate.d.ts +81 -0
- package/dist/importers/z2m/generate.js +1171 -0
- package/dist/importers/z2m/generate.js.map +1 -0
- package/dist/importers/z2m/index.d.ts +5 -0
- package/dist/importers/z2m/index.js +6 -0
- package/dist/importers/z2m/index.js.map +1 -0
- package/dist/importers/z2m/source.d.ts +18 -0
- package/dist/importers/z2m/source.js +46 -0
- package/dist/importers/z2m/source.js.map +1 -0
- package/dist/importers/z2m/sync.d.ts +29 -0
- package/dist/importers/z2m/sync.js +92 -0
- package/dist/importers/z2m/sync.js.map +1 -0
- package/dist/importers/z2m/types.d.ts +72 -0
- package/dist/importers/z2m/types.js +46 -0
- package/dist/importers/z2m/types.js.map +1 -0
- package/dist/index.d.ts +5 -0
- package/dist/index.js +7 -0
- package/dist/index.js.map +1 -0
- package/dist/log.d.ts +17 -0
- package/dist/log.js +54 -0
- package/dist/log.js.map +1 -0
- package/dist/main.d.ts +2 -0
- package/dist/main.js +202 -0
- package/dist/main.js.map +1 -0
- package/dist/matter/bridge.d.ts +113 -0
- package/dist/matter/bridge.js +467 -0
- package/dist/matter/bridge.js.map +1 -0
- package/dist/matter/check.d.ts +11 -0
- package/dist/matter/check.js +116 -0
- package/dist/matter/check.js.map +1 -0
- package/dist/matter/cluster-defaults.d.ts +6 -0
- package/dist/matter/cluster-defaults.js +63 -0
- package/dist/matter/cluster-defaults.js.map +1 -0
- package/dist/matter/commissioning.d.ts +21 -0
- package/dist/matter/commissioning.js +88 -0
- package/dist/matter/commissioning.js.map +1 -0
- package/dist/matter/device-types.d.ts +44 -0
- package/dist/matter/device-types.js +230 -0
- package/dist/matter/device-types.js.map +1 -0
- package/dist/matter/ids.d.ts +31 -0
- package/dist/matter/ids.js +83 -0
- package/dist/matter/ids.js.map +1 -0
- package/dist/matter/index.d.ts +7 -0
- package/dist/matter/index.js +8 -0
- package/dist/matter/index.js.map +1 -0
- package/dist/matter/node-manager.d.ts +39 -0
- package/dist/matter/node-manager.js +161 -0
- package/dist/matter/node-manager.js.map +1 -0
- package/dist/matter/shards.d.ts +26 -0
- package/dist/matter/shards.js +93 -0
- package/dist/matter/shards.js.map +1 -0
- package/dist/model/attribute.d.ts +18 -0
- package/dist/model/attribute.js +28 -0
- package/dist/model/attribute.js.map +1 -0
- package/dist/model/catalog.d.ts +79 -0
- package/dist/model/catalog.js +223 -0
- package/dist/model/catalog.js.map +1 -0
- package/dist/model/index.d.ts +7 -0
- package/dist/model/index.js +8 -0
- package/dist/model/index.js.map +1 -0
- package/dist/model/migrate.d.ts +4 -0
- package/dist/model/migrate.js +39 -0
- package/dist/model/migrate.js.map +1 -0
- package/dist/model/options.d.ts +102 -0
- package/dist/model/options.js +88 -0
- package/dist/model/options.js.map +1 -0
- package/dist/model/presets.d.ts +37 -0
- package/dist/model/presets.js +105 -0
- package/dist/model/presets.js.map +1 -0
- package/dist/model/schema.d.ts +1747 -0
- package/dist/model/schema.js +243 -0
- package/dist/model/schema.js.map +1 -0
- package/dist/model/validate.d.ts +21 -0
- package/dist/model/validate.js +484 -0
- package/dist/model/validate.js.map +1 -0
- package/dist/mqtt/client.d.ts +38 -0
- package/dist/mqtt/client.js +94 -0
- package/dist/mqtt/client.js.map +1 -0
- package/dist/mqtt/index.d.ts +2 -0
- package/dist/mqtt/index.js +3 -0
- package/dist/mqtt/index.js.map +1 -0
- package/dist/mqtt/topic-cache.d.ts +20 -0
- package/dist/mqtt/topic-cache.js +58 -0
- package/dist/mqtt/topic-cache.js.map +1 -0
- package/dist/server/auth.d.ts +59 -0
- package/dist/server/auth.js +185 -0
- package/dist/server/auth.js.map +1 -0
- package/dist/server/catalog.d.ts +52 -0
- package/dist/server/catalog.js +96 -0
- package/dist/server/catalog.js.map +1 -0
- package/dist/server/compact.d.ts +3 -0
- package/dist/server/compact.js +105 -0
- package/dist/server/compact.js.map +1 -0
- package/dist/server/config-store.d.ts +36 -0
- package/dist/server/config-store.js +155 -0
- package/dist/server/config-store.js.map +1 -0
- package/dist/server/events.d.ts +50 -0
- package/dist/server/events.js +71 -0
- package/dist/server/events.js.map +1 -0
- package/dist/server/http.d.ts +27 -0
- package/dist/server/http.js +168 -0
- package/dist/server/http.js.map +1 -0
- package/dist/server/importers.d.ts +40 -0
- package/dist/server/importers.js +75 -0
- package/dist/server/importers.js.map +1 -0
- package/dist/server/index.d.ts +6 -0
- package/dist/server/index.js +8 -0
- package/dist/server/index.js.map +1 -0
- package/dist/server/log-buffer.d.ts +22 -0
- package/dist/server/log-buffer.js +55 -0
- package/dist/server/log-buffer.js.map +1 -0
- package/dist/server/presets.d.ts +17 -0
- package/dist/server/presets.js +55 -0
- package/dist/server/presets.js.map +1 -0
- package/dist/server/preview.d.ts +19 -0
- package/dist/server/preview.js +121 -0
- package/dist/server/preview.js.map +1 -0
- package/dist/server/server.d.ts +107 -0
- package/dist/server/server.js +810 -0
- package/dist/server/server.js.map +1 -0
- package/dist/server/update.d.ts +60 -0
- package/dist/server/update.js +191 -0
- package/dist/server/update.js.map +1 -0
- package/docs/api.md +128 -0
- package/docs/architecture.md +121 -0
- package/docs/config.md +538 -0
- package/docs/importers.md +241 -0
- package/example/mqtt2matter.json +276 -0
- package/package.json +90 -4
- package/presets/mqtt-smarthome/button.json +47 -0
- package/presets/mqtt-smarthome/contact.json +37 -0
- package/presets/mqtt-smarthome/cover.json +50 -0
- package/presets/mqtt-smarthome/dimmer.json +57 -0
- package/presets/mqtt-smarthome/humidity.json +38 -0
- package/presets/mqtt-smarthome/light.json +47 -0
- package/presets/mqtt-smarthome/occupancy.json +46 -0
- package/presets/mqtt-smarthome/switch.json +47 -0
- package/presets/mqtt-smarthome/temperature.json +38 -0
- package/presets/openbeken/color-light.json +64 -0
- package/presets/openbeken/ct-light.json +51 -0
- package/presets/openbeken/dimmer.json +47 -0
- package/presets/openbeken/humidity.json +37 -0
- package/presets/openbeken/relay.json +40 -0
- package/presets/openbeken/temperature.json +41 -0
- package/presets/shelly-gen1/dimmer.json +48 -0
- package/presets/shelly-gen1/door-window.json +43 -0
- package/presets/shelly-gen1/ht.json +43 -0
- package/presets/shelly-gen1/relay-pm.json +60 -0
- package/presets/shelly-gen1/relay.json +36 -0
- package/presets/shelly-gen1/roller.json +52 -0
- package/presets/shelly-gen2/cover.json +68 -0
- package/presets/shelly-gen2/dimmer.json +61 -0
- package/presets/shelly-gen2/ht.json +47 -0
- package/presets/shelly-gen2/i4.json +82 -0
- package/presets/shelly-gen2/switch-pm.json +101 -0
- package/presets/shelly-gen2/switch.json +47 -0
- package/presets/tasmota/climate.json +52 -0
- package/presets/tasmota/color-light.json +63 -0
- package/presets/tasmota/ct-light.json +50 -0
- package/presets/tasmota/dimmer.json +45 -0
- package/presets/tasmota/relay.json +39 -0
- package/presets/tasmota/shutter.json +46 -0
- package/presets/tasmota/temperature-humidity.json +42 -0
- package/presets/tasmota/temperature.json +32 -0
- package/presets/valetudo/vacuum.json +103 -0
- package/presets/wled/dimmer.json +46 -0
- package/presets/wled/light.json +59 -0
- package/ui/dist/assets/index-BDtT6bdH.js +10 -0
- package/ui/dist/assets/index-CHiG-aoU.css +1 -0
- package/ui/dist/index.html +18 -0
|
@@ -0,0 +1,467 @@
|
|
|
1
|
+
/* One Matter bridge: a ServerNode with an aggregator, the bridged devices under it, and a handle per
|
|
2
|
+
device endpoint the runtime talks to. Several bridges live in one process (the node manager owns them);
|
|
3
|
+
each has its own id — and therefore its own storage directory, fabrics and endpoint numbers — port,
|
|
4
|
+
passcode and discriminator. The mDNS service is process-wide and shared. A device's first endpoint is
|
|
5
|
+
the bridged node (with BridgedDeviceBasicInformation), the others are its parts with ids
|
|
6
|
+
`<key>~<endpoint id>`. */
|
|
7
|
+
import { Endpoint, ServerNode, VendorId } from '@matter/main';
|
|
8
|
+
import { AggregatorEndpoint } from '@matter/main/endpoints/aggregator';
|
|
9
|
+
import { DeviceTypeConformanceService } from '@matter/node';
|
|
10
|
+
import { familyFor, forgetContext, registerContext } from "../families/index.js";
|
|
11
|
+
import { COMPOSITE_ATTRIBUTES, cluster as clusterInfo } from "../model/catalog.js";
|
|
12
|
+
import { mappingTarget } from "../model/schema.js";
|
|
13
|
+
import { buildEndpoint } from "./device-types.js";
|
|
14
|
+
import { BRIDGE_PRODUCT_LABEL, bridgedInformation, childEndpointId, deviceEndpointId, HARDWARE_VERSION, label32, softwareVersionNumber, uniqueId, VENDOR_NAME, } from "./ids.js";
|
|
15
|
+
/** the messages of an aggregate error's causes, matter.js style (`errors`, `cause`), flattened */
|
|
16
|
+
export function nestedErrors(error, depth = 0) {
|
|
17
|
+
if (depth > 4 || typeof error !== 'object' || error === null) {
|
|
18
|
+
return [];
|
|
19
|
+
}
|
|
20
|
+
const result = [];
|
|
21
|
+
const e = error;
|
|
22
|
+
for (const child of Array.isArray(e.errors) ? e.errors : []) {
|
|
23
|
+
const message = child.message;
|
|
24
|
+
if (message !== undefined) {
|
|
25
|
+
result.push(message);
|
|
26
|
+
}
|
|
27
|
+
result.push(...nestedErrors(child, depth + 1));
|
|
28
|
+
}
|
|
29
|
+
if (e.cause !== undefined) {
|
|
30
|
+
const message = e.cause.message;
|
|
31
|
+
if (message !== undefined) {
|
|
32
|
+
result.push(message);
|
|
33
|
+
}
|
|
34
|
+
result.push(...nestedErrors(e.cause, depth + 1));
|
|
35
|
+
}
|
|
36
|
+
return result;
|
|
37
|
+
}
|
|
38
|
+
/** the Matter side of one endpoint of a device, as the runtime uses it */
|
|
39
|
+
export class EndpointHandle {
|
|
40
|
+
key;
|
|
41
|
+
config;
|
|
42
|
+
endpoint;
|
|
43
|
+
built;
|
|
44
|
+
context;
|
|
45
|
+
/** the conformance violations matter.js reported for this endpoint */
|
|
46
|
+
violations = [];
|
|
47
|
+
log;
|
|
48
|
+
writeObservers = [];
|
|
49
|
+
constructor(key, config, endpoint, built, log) {
|
|
50
|
+
this.key = key;
|
|
51
|
+
this.config = config;
|
|
52
|
+
this.endpoint = endpoint;
|
|
53
|
+
this.built = built;
|
|
54
|
+
this.log = log;
|
|
55
|
+
const statuses = new Set();
|
|
56
|
+
for (const mapping of config.mappings) {
|
|
57
|
+
if (mapping.status !== undefined) {
|
|
58
|
+
statuses.add(mappingTarget(mapping).name);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
this.context = {
|
|
62
|
+
endpoint,
|
|
63
|
+
options: config.options,
|
|
64
|
+
features: built.features,
|
|
65
|
+
commands: new Map(),
|
|
66
|
+
statuses,
|
|
67
|
+
log,
|
|
68
|
+
scratch: new Map(),
|
|
69
|
+
};
|
|
70
|
+
registerContext(this.context);
|
|
71
|
+
for (const [cluster, behaviorId] of built.clusters) {
|
|
72
|
+
for (const attribute of familyFor(cluster)?.writes ?? []) {
|
|
73
|
+
this.observe(cluster, attribute, behaviorId);
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
get number() {
|
|
78
|
+
return this.endpoint.maybeNumber;
|
|
79
|
+
}
|
|
80
|
+
/** the endpoint's state (matter.js' immutable view), keyed by behavior id */
|
|
81
|
+
get state() {
|
|
82
|
+
return this.endpoint.state;
|
|
83
|
+
}
|
|
84
|
+
shapeOf(ref) {
|
|
85
|
+
const key = `${ref.cluster}.${ref.attribute}`;
|
|
86
|
+
if (key in COMPOSITE_ATTRIBUTES) {
|
|
87
|
+
return { metatype: 'any' };
|
|
88
|
+
}
|
|
89
|
+
const info = clusterInfo(ref.cluster)?.attributes.get(ref.attribute);
|
|
90
|
+
if (info === undefined) {
|
|
91
|
+
return undefined;
|
|
92
|
+
}
|
|
93
|
+
return {
|
|
94
|
+
metatype: info.metatype,
|
|
95
|
+
nullable: info.nullable,
|
|
96
|
+
enumMembers: info.enumMembers,
|
|
97
|
+
bitFields: info.bitFields,
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
async set(ref, value) {
|
|
101
|
+
if (!this.endpoint.lifecycle.isReady) {
|
|
102
|
+
throw new Error(`endpoint ${this.key} is not ready`);
|
|
103
|
+
}
|
|
104
|
+
const behaviorId = this.built.clusters.get(ref.cluster);
|
|
105
|
+
if (behaviorId === undefined) {
|
|
106
|
+
throw new Error(`endpoint ${this.key} has no cluster ${ref.cluster}`);
|
|
107
|
+
}
|
|
108
|
+
const family = familyFor(ref.cluster);
|
|
109
|
+
if (family?.status !== undefined) {
|
|
110
|
+
const result = await family.status(this.context, ref.attribute, value);
|
|
111
|
+
if (result === true) {
|
|
112
|
+
return;
|
|
113
|
+
}
|
|
114
|
+
if (result !== false) {
|
|
115
|
+
await this.endpoint.set({ [behaviorId]: result });
|
|
116
|
+
return;
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
if (`${ref.cluster}.${ref.attribute}` in COMPOSITE_ATTRIBUTES) {
|
|
120
|
+
throw new Error(`${ref.cluster}.${ref.attribute} is a composite the family did not handle`);
|
|
121
|
+
}
|
|
122
|
+
await this.endpoint.set({ [behaviorId]: { [ref.attribute]: value } });
|
|
123
|
+
}
|
|
124
|
+
async emitEvent(channel, value) {
|
|
125
|
+
const family = familyFor(channel);
|
|
126
|
+
if (family?.event === undefined) {
|
|
127
|
+
throw new Error(`${channel} has no event channel`);
|
|
128
|
+
}
|
|
129
|
+
await family.event(this.context, value);
|
|
130
|
+
}
|
|
131
|
+
onCommand(key, handler) {
|
|
132
|
+
if (handler === undefined) {
|
|
133
|
+
this.context.commands.delete(key);
|
|
134
|
+
return;
|
|
135
|
+
}
|
|
136
|
+
this.context.commands.set(key, handler);
|
|
137
|
+
const [cluster, attribute] = key.split('.');
|
|
138
|
+
const behaviorId = this.built.clusters.get(cluster);
|
|
139
|
+
if (attribute !== undefined && behaviorId !== undefined) {
|
|
140
|
+
this.observe(cluster, attribute, behaviorId);
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
/**
|
|
144
|
+
* A writable attribute: controllers write it (matter.js applies the write), so a command half is routed
|
|
145
|
+
* from the attribute's change with an online context, and the family keeps the cluster consistent.
|
|
146
|
+
* Observed once per attribute.
|
|
147
|
+
*/
|
|
148
|
+
observe(cluster, attribute, behaviorId) {
|
|
149
|
+
const key = `${cluster}.${attribute}`;
|
|
150
|
+
if (this.writeObservers.some((o) => o.attribute === key)) {
|
|
151
|
+
return;
|
|
152
|
+
}
|
|
153
|
+
const info = clusterInfo(cluster)?.attributes.get(attribute);
|
|
154
|
+
if (info?.writable !== true) {
|
|
155
|
+
return;
|
|
156
|
+
}
|
|
157
|
+
const events = this.endpoint.events[behaviorId];
|
|
158
|
+
const observable = events?.[`${attribute}$Changed`];
|
|
159
|
+
if (observable === undefined) {
|
|
160
|
+
return;
|
|
161
|
+
}
|
|
162
|
+
const family = familyFor(cluster);
|
|
163
|
+
const observer = (value, _old, context) => {
|
|
164
|
+
if (context?.offline === true) {
|
|
165
|
+
return;
|
|
166
|
+
}
|
|
167
|
+
const fields = {};
|
|
168
|
+
const shape = this.shapeOf({ cluster, attribute, behaviorId });
|
|
169
|
+
if (typeof value === 'number' && shape?.enumMembers !== undefined) {
|
|
170
|
+
for (const [name, id] of shape.enumMembers) {
|
|
171
|
+
if (id === value) {
|
|
172
|
+
fields.name = name;
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
const handler = this.context.commands.get(key);
|
|
177
|
+
(handler === undefined ? Promise.resolve(true) : handler(value, fields))
|
|
178
|
+
.then(async () => {
|
|
179
|
+
await family?.write?.(this.context, attribute, value);
|
|
180
|
+
})
|
|
181
|
+
.catch((error) => {
|
|
182
|
+
this.log.error(`${this.key} ${key}: routing the write failed`, error);
|
|
183
|
+
});
|
|
184
|
+
};
|
|
185
|
+
observable.on(observer);
|
|
186
|
+
this.writeObservers.push({
|
|
187
|
+
attribute: key,
|
|
188
|
+
off: () => {
|
|
189
|
+
observable.off(observer);
|
|
190
|
+
},
|
|
191
|
+
});
|
|
192
|
+
}
|
|
193
|
+
async setReachable(reachable) {
|
|
194
|
+
if (!('bridgedDeviceBasicInformation' in this.endpoint.state)) {
|
|
195
|
+
return;
|
|
196
|
+
}
|
|
197
|
+
await this.endpoint.set({ bridgedDeviceBasicInformation: { reachable } });
|
|
198
|
+
}
|
|
199
|
+
close() {
|
|
200
|
+
for (const { off } of this.writeObservers) {
|
|
201
|
+
off();
|
|
202
|
+
}
|
|
203
|
+
this.writeObservers.length = 0;
|
|
204
|
+
forgetContext(this.endpoint);
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
/** one device: its endpoints by id; the first is the bridged node */
|
|
208
|
+
export class DeviceHandle {
|
|
209
|
+
key;
|
|
210
|
+
device;
|
|
211
|
+
endpoints;
|
|
212
|
+
constructor(key, device, endpoints) {
|
|
213
|
+
this.key = key;
|
|
214
|
+
this.device = device;
|
|
215
|
+
this.endpoints = endpoints;
|
|
216
|
+
}
|
|
217
|
+
get main() {
|
|
218
|
+
const first = this.endpoints.values().next().value;
|
|
219
|
+
if (first === undefined) {
|
|
220
|
+
throw new Error(`device ${this.key} has no endpoint`);
|
|
221
|
+
}
|
|
222
|
+
return first;
|
|
223
|
+
}
|
|
224
|
+
get endpoint() {
|
|
225
|
+
return this.main.endpoint;
|
|
226
|
+
}
|
|
227
|
+
get number() {
|
|
228
|
+
return this.main.number;
|
|
229
|
+
}
|
|
230
|
+
get state() {
|
|
231
|
+
return this.main.state;
|
|
232
|
+
}
|
|
233
|
+
/** the runtime's targets, keyed by the model's endpoint id */
|
|
234
|
+
targets() {
|
|
235
|
+
return new Map(this.endpoints);
|
|
236
|
+
}
|
|
237
|
+
violations() {
|
|
238
|
+
const result = [];
|
|
239
|
+
for (const [id, handle] of this.endpoints) {
|
|
240
|
+
for (const violation of handle.violations) {
|
|
241
|
+
result.push({ endpointId: id, violation });
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
return result;
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
export class Bridge {
|
|
248
|
+
id;
|
|
249
|
+
options;
|
|
250
|
+
log;
|
|
251
|
+
node;
|
|
252
|
+
aggregator;
|
|
253
|
+
handles = new Map();
|
|
254
|
+
pending = new Map();
|
|
255
|
+
constructor(options) {
|
|
256
|
+
this.options = options;
|
|
257
|
+
this.id = options.id;
|
|
258
|
+
this.log = options.log;
|
|
259
|
+
}
|
|
260
|
+
get online() {
|
|
261
|
+
return this.node?.lifecycle.isOnline ?? false;
|
|
262
|
+
}
|
|
263
|
+
get commissioned() {
|
|
264
|
+
return this.node?.state.commissioning.commissioned ?? false;
|
|
265
|
+
}
|
|
266
|
+
get pairingCodes() {
|
|
267
|
+
if (this.node === undefined) {
|
|
268
|
+
return undefined;
|
|
269
|
+
}
|
|
270
|
+
const { manualPairingCode, qrPairingCode } = this.node.state.commissioning.pairingCodes;
|
|
271
|
+
return { manualPairingCode, qrPairingCode };
|
|
272
|
+
}
|
|
273
|
+
get port() {
|
|
274
|
+
return this.options.config.port;
|
|
275
|
+
}
|
|
276
|
+
get serverNode() {
|
|
277
|
+
return this.node;
|
|
278
|
+
}
|
|
279
|
+
devices() {
|
|
280
|
+
return [...this.handles.values()];
|
|
281
|
+
}
|
|
282
|
+
handle(key) {
|
|
283
|
+
return this.handles.get(key);
|
|
284
|
+
}
|
|
285
|
+
/** register a device; installed when the bridge starts, or right away if it runs already */
|
|
286
|
+
async addDevice(key, device) {
|
|
287
|
+
if (this.aggregator === undefined) {
|
|
288
|
+
this.pending.set(key, device);
|
|
289
|
+
return undefined;
|
|
290
|
+
}
|
|
291
|
+
return await this.install(key, device);
|
|
292
|
+
}
|
|
293
|
+
async removeDevice(key) {
|
|
294
|
+
this.pending.delete(key);
|
|
295
|
+
const handle = this.handles.get(key);
|
|
296
|
+
if (handle === undefined) {
|
|
297
|
+
return;
|
|
298
|
+
}
|
|
299
|
+
this.handles.delete(key);
|
|
300
|
+
for (const endpoint of handle.endpoints.values()) {
|
|
301
|
+
endpoint.close();
|
|
302
|
+
}
|
|
303
|
+
await handle.endpoint.close();
|
|
304
|
+
}
|
|
305
|
+
/** create the node and the endpoints without going online (the dry run uses this) */
|
|
306
|
+
async build() {
|
|
307
|
+
if (this.node !== undefined) {
|
|
308
|
+
return;
|
|
309
|
+
}
|
|
310
|
+
const { config, vendorId, productId, softwareVersion } = this.options;
|
|
311
|
+
const name = label32(config.name, `mqtt2matter ${this.id}`);
|
|
312
|
+
const node = await ServerNode.create({
|
|
313
|
+
id: this.id,
|
|
314
|
+
network: { port: config.port },
|
|
315
|
+
commissioning: {
|
|
316
|
+
passcode: this.options.commissioning.passcode,
|
|
317
|
+
discriminator: this.options.commissioning.discriminator,
|
|
318
|
+
},
|
|
319
|
+
productDescription: {
|
|
320
|
+
name,
|
|
321
|
+
deviceType: AggregatorEndpoint.deviceType,
|
|
322
|
+
},
|
|
323
|
+
basicInformation: {
|
|
324
|
+
vendorName: VENDOR_NAME,
|
|
325
|
+
vendorId: VendorId(vendorId),
|
|
326
|
+
nodeLabel: name,
|
|
327
|
+
productName: VENDOR_NAME,
|
|
328
|
+
productLabel: BRIDGE_PRODUCT_LABEL,
|
|
329
|
+
productId,
|
|
330
|
+
serialNumber: label32(`mqtt2matter-${this.id}`, this.id),
|
|
331
|
+
uniqueId: uniqueId('bridge', this.id),
|
|
332
|
+
softwareVersion: softwareVersionNumber(softwareVersion),
|
|
333
|
+
softwareVersionString: softwareVersion.slice(0, 64),
|
|
334
|
+
hardwareVersion: HARDWARE_VERSION,
|
|
335
|
+
hardwareVersionString: String(HARDWARE_VERSION),
|
|
336
|
+
},
|
|
337
|
+
});
|
|
338
|
+
this.node = node;
|
|
339
|
+
const aggregator = new Endpoint(AggregatorEndpoint, { id: 'aggregator' });
|
|
340
|
+
await node.add(aggregator);
|
|
341
|
+
this.aggregator = aggregator;
|
|
342
|
+
for (const [key, device] of this.pending) {
|
|
343
|
+
await this.install(key, device);
|
|
344
|
+
}
|
|
345
|
+
this.pending.clear();
|
|
346
|
+
}
|
|
347
|
+
async start() {
|
|
348
|
+
await this.build();
|
|
349
|
+
const node = this.node;
|
|
350
|
+
if (node === undefined || node.lifecycle.isOnline) {
|
|
351
|
+
return;
|
|
352
|
+
}
|
|
353
|
+
await node.start();
|
|
354
|
+
this.log.info(`bridge ${this.id} online on port ${this.options.config.port}, ${this.handles.size} device(s)`);
|
|
355
|
+
}
|
|
356
|
+
/** stop the node; its storage stays, so a later start keeps fabrics and endpoint numbers */
|
|
357
|
+
async stop() {
|
|
358
|
+
const node = this.node;
|
|
359
|
+
this.node = undefined;
|
|
360
|
+
this.aggregator = undefined;
|
|
361
|
+
for (const handle of this.handles.values()) {
|
|
362
|
+
for (const endpoint of handle.endpoints.values()) {
|
|
363
|
+
endpoint.close();
|
|
364
|
+
}
|
|
365
|
+
}
|
|
366
|
+
this.handles.clear();
|
|
367
|
+
if (node !== undefined) {
|
|
368
|
+
await node.close();
|
|
369
|
+
}
|
|
370
|
+
}
|
|
371
|
+
info() {
|
|
372
|
+
return {
|
|
373
|
+
id: this.id,
|
|
374
|
+
port: this.port,
|
|
375
|
+
online: this.online,
|
|
376
|
+
commissioned: this.commissioned,
|
|
377
|
+
pairingCodes: this.pairingCodes,
|
|
378
|
+
devices: this.devices().map((h) => ({
|
|
379
|
+
key: h.key,
|
|
380
|
+
endpointId: h.endpoint.id,
|
|
381
|
+
number: h.number,
|
|
382
|
+
violations: h.violations().length,
|
|
383
|
+
})),
|
|
384
|
+
};
|
|
385
|
+
}
|
|
386
|
+
async install(key, device) {
|
|
387
|
+
if (this.aggregator === undefined || this.node === undefined) {
|
|
388
|
+
throw new Error('bridge not started');
|
|
389
|
+
}
|
|
390
|
+
const [main, ...children] = device.endpoints;
|
|
391
|
+
if (main === undefined) {
|
|
392
|
+
return undefined;
|
|
393
|
+
}
|
|
394
|
+
const built = new Map();
|
|
395
|
+
const children_ = new Map();
|
|
396
|
+
let mainEntry;
|
|
397
|
+
try {
|
|
398
|
+
const parts = [];
|
|
399
|
+
for (const child of children) {
|
|
400
|
+
const childBuilt = buildEndpoint(child);
|
|
401
|
+
const endpoint = new Endpoint(childBuilt.type, {
|
|
402
|
+
id: childEndpointId(key, child.id),
|
|
403
|
+
...childBuilt.defaults,
|
|
404
|
+
});
|
|
405
|
+
parts.push(endpoint);
|
|
406
|
+
children_.set(child.id, { config: child, built: childBuilt, endpoint });
|
|
407
|
+
}
|
|
408
|
+
const mainBuilt = buildEndpoint(main, main.options, { bridged: true });
|
|
409
|
+
const primaryType = main.deviceTypes[0] ?? 'device';
|
|
410
|
+
const endpoint = new Endpoint(mainBuilt.type, {
|
|
411
|
+
id: deviceEndpointId(key),
|
|
412
|
+
parts,
|
|
413
|
+
...mainBuilt.defaults,
|
|
414
|
+
bridgedDeviceBasicInformation: bridgedInformation(this.id, key, device, primaryType, this.options.softwareVersion),
|
|
415
|
+
});
|
|
416
|
+
mainEntry = { config: main, built: mainBuilt, endpoint };
|
|
417
|
+
}
|
|
418
|
+
catch (error) {
|
|
419
|
+
this.log.error(`${key}: not built`, error);
|
|
420
|
+
return undefined;
|
|
421
|
+
}
|
|
422
|
+
// the main entry first: the runtime's reachable flag lives there
|
|
423
|
+
built.set(main.id, mainEntry);
|
|
424
|
+
for (const [id, entry] of children_) {
|
|
425
|
+
built.set(id, entry);
|
|
426
|
+
}
|
|
427
|
+
try {
|
|
428
|
+
await this.aggregator.add(mainEntry.endpoint);
|
|
429
|
+
}
|
|
430
|
+
catch (error) {
|
|
431
|
+
this.log.error(`${key}: the endpoint failed to initialise`, error);
|
|
432
|
+
for (const detail of nestedErrors(error)) {
|
|
433
|
+
this.log.error(`${key}: ${detail}`);
|
|
434
|
+
}
|
|
435
|
+
return undefined;
|
|
436
|
+
}
|
|
437
|
+
const handles = new Map();
|
|
438
|
+
for (const [id, { config, built: b, endpoint }] of built) {
|
|
439
|
+
const handle = new EndpointHandle(key, config, endpoint, b, this.log.child(`${key}/${id}`));
|
|
440
|
+
handles.set(id, handle);
|
|
441
|
+
handle.violations = this.violationsOf(endpoint);
|
|
442
|
+
for (const violation of handle.violations) {
|
|
443
|
+
this.log.warn(`${key}/${id}: ${violation.deviceType} ${violation.kind} ${violation.requirement}: ${violation.detail}`);
|
|
444
|
+
}
|
|
445
|
+
}
|
|
446
|
+
const handle = new DeviceHandle(key, device, handles);
|
|
447
|
+
this.handles.set(key, handle);
|
|
448
|
+
this.log.debug(`${key} = endpoint ${handle.endpoint.number} (${main.deviceTypes.join(', ')})${children.length > 0 ? ` + ${children.length} child endpoint(s)` : ''}`);
|
|
449
|
+
return handle;
|
|
450
|
+
}
|
|
451
|
+
violationsOf(endpoint) {
|
|
452
|
+
const node = this.node;
|
|
453
|
+
if (node === undefined) {
|
|
454
|
+
return [];
|
|
455
|
+
}
|
|
456
|
+
try {
|
|
457
|
+
const service = node.env.get(DeviceTypeConformanceService);
|
|
458
|
+
const verdict = service.validate(endpoint);
|
|
459
|
+
return [...verdict.values()].flat();
|
|
460
|
+
}
|
|
461
|
+
catch (error) {
|
|
462
|
+
this.log.debug(`conformance check unavailable: ${String(error)}`);
|
|
463
|
+
return [];
|
|
464
|
+
}
|
|
465
|
+
}
|
|
466
|
+
}
|
|
467
|
+
//# sourceMappingURL=bridge.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/matter/bridge.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { Config } from '../config/schema.ts';
|
|
2
|
+
import { type Issue } from '../model/validate.ts';
|
|
3
|
+
export interface CheckResult {
|
|
4
|
+
/** device key → the issues, static and from the dry run */
|
|
5
|
+
devices: Map<string, Issue[]>;
|
|
6
|
+
ok: boolean;
|
|
7
|
+
}
|
|
8
|
+
/** check every enabled device of the config; nothing goes online */
|
|
9
|
+
export declare function checkConfig(config: Config): Promise<CheckResult>;
|
|
10
|
+
/** the check's result as lines for the command line */
|
|
11
|
+
export declare function formatCheck(result: CheckResult): string[];
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
/* The strict dry run (the second validation layer): build every enabled device in a throw-away ServerNode of its
|
|
2
|
+
own Environment with `endpoint.validation=strict` and in-memory storage, never going online, and
|
|
3
|
+
collect what matter.js refuses — construction errors and the DeviceTypeConformanceService's
|
|
4
|
+
violations. `mqtt2matter --check` prints the result; the UI's check button calls it. */
|
|
5
|
+
import { Endpoint, Environment, Logger as MatterLogger, MemoryStorageDriver, ServerNode, StorageService, VariableService, VendorId, } from '@matter/main';
|
|
6
|
+
import { AggregatorEndpoint } from '@matter/main/endpoints/aggregator';
|
|
7
|
+
import { DeviceTypeConformanceService } from '@matter/node';
|
|
8
|
+
import { validateDevice } from "../model/validate.js";
|
|
9
|
+
import { nestedErrors } from "./bridge.js";
|
|
10
|
+
import { MATTER_LEVELS } from "./node-manager.js";
|
|
11
|
+
import { buildEndpoint } from "./device-types.js";
|
|
12
|
+
import { BRIDGE_PRODUCT_LABEL, bridgedInformation, childEndpointId, deviceEndpointId, HARDWARE_VERSION, uniqueId, VENDOR_NAME, } from "./ids.js";
|
|
13
|
+
let counter = 0;
|
|
14
|
+
/** a child of the process environment with its own variables (strict validation) and memory storage */
|
|
15
|
+
function checkEnvironment() {
|
|
16
|
+
const env = new Environment(`mqtt2matter-check-${++counter}`, Environment.default);
|
|
17
|
+
const vars = new VariableService(env);
|
|
18
|
+
vars.set('endpoint.validation', 'strict');
|
|
19
|
+
const storage = new StorageService(env);
|
|
20
|
+
storage.registerDriver(MemoryStorageDriver);
|
|
21
|
+
storage.defaultDriver = 'memory';
|
|
22
|
+
storage.configuredDriver = 'memory';
|
|
23
|
+
return env;
|
|
24
|
+
}
|
|
25
|
+
/** check every enabled device of the config; nothing goes online */
|
|
26
|
+
export async function checkConfig(config) {
|
|
27
|
+
const devices = new Map();
|
|
28
|
+
MatterLogger.level = MATTER_LEVELS[config.log.matter];
|
|
29
|
+
const env = checkEnvironment();
|
|
30
|
+
const node = await ServerNode.create({
|
|
31
|
+
id: 'check',
|
|
32
|
+
environment: env,
|
|
33
|
+
network: { port: 0 },
|
|
34
|
+
commissioning: { passcode: 20202021, discriminator: 3840 },
|
|
35
|
+
productDescription: { name: 'check', deviceType: AggregatorEndpoint.deviceType },
|
|
36
|
+
basicInformation: {
|
|
37
|
+
vendorName: VENDOR_NAME,
|
|
38
|
+
vendorId: VendorId(config.vendorId),
|
|
39
|
+
nodeLabel: 'check',
|
|
40
|
+
productName: VENDOR_NAME,
|
|
41
|
+
productLabel: BRIDGE_PRODUCT_LABEL,
|
|
42
|
+
productId: config.productId,
|
|
43
|
+
serialNumber: 'check',
|
|
44
|
+
uniqueId: uniqueId('check', 'check'),
|
|
45
|
+
softwareVersion: 1,
|
|
46
|
+
hardwareVersion: HARDWARE_VERSION,
|
|
47
|
+
},
|
|
48
|
+
});
|
|
49
|
+
try {
|
|
50
|
+
const aggregator = new Endpoint(AggregatorEndpoint, { id: 'aggregator' });
|
|
51
|
+
await node.add(aggregator);
|
|
52
|
+
const conformance = node.env.get(DeviceTypeConformanceService);
|
|
53
|
+
for (const [key, device] of Object.entries(config.devices)) {
|
|
54
|
+
const issues = [...validateDevice(device).issues];
|
|
55
|
+
if (device.enabled) {
|
|
56
|
+
const [main, ...children] = device.endpoints;
|
|
57
|
+
if (main !== undefined) {
|
|
58
|
+
try {
|
|
59
|
+
const parts = [];
|
|
60
|
+
for (const child of children) {
|
|
61
|
+
const built = buildEndpoint(child);
|
|
62
|
+
parts.push(new Endpoint(built.type, { id: childEndpointId(key, child.id), ...built.defaults }));
|
|
63
|
+
}
|
|
64
|
+
const built = buildEndpoint(main, main.options, { bridged: true });
|
|
65
|
+
const endpoint = new Endpoint(built.type, {
|
|
66
|
+
id: deviceEndpointId(key),
|
|
67
|
+
parts,
|
|
68
|
+
...built.defaults,
|
|
69
|
+
bridgedDeviceBasicInformation: bridgedInformation('check', key, device, main.deviceTypes[0] ?? 'device', '0.0.0'),
|
|
70
|
+
});
|
|
71
|
+
await aggregator.add(endpoint);
|
|
72
|
+
const verdict = conformance.validate([endpoint, ...parts]);
|
|
73
|
+
for (const [ep, violations] of verdict) {
|
|
74
|
+
for (const violation of violations) {
|
|
75
|
+
issues.push({
|
|
76
|
+
level: 'error',
|
|
77
|
+
path: ep === endpoint ? 'endpoints[0]' : `endpoints[${1 + parts.indexOf(ep)}]`,
|
|
78
|
+
message: `${violation.deviceType}: ${violation.kind} ${violation.requirement} — ${violation.detail}`,
|
|
79
|
+
});
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
await endpoint.close();
|
|
83
|
+
}
|
|
84
|
+
catch (error) {
|
|
85
|
+
const details = nestedErrors(error);
|
|
86
|
+
issues.push({
|
|
87
|
+
level: 'error',
|
|
88
|
+
path: 'endpoints',
|
|
89
|
+
message: details.length > 0 ? details.join('; ') : error.message,
|
|
90
|
+
});
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
if (issues.length > 0) {
|
|
95
|
+
devices.set(key, issues);
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
finally {
|
|
100
|
+
await node.close();
|
|
101
|
+
}
|
|
102
|
+
const ok = [...devices.values()].every((issues) => issues.every((i) => i.level !== 'error'));
|
|
103
|
+
return { devices, ok };
|
|
104
|
+
}
|
|
105
|
+
/** the check's result as lines for the command line */
|
|
106
|
+
export function formatCheck(result) {
|
|
107
|
+
const lines = [];
|
|
108
|
+
for (const [key, issues] of result.devices) {
|
|
109
|
+
for (const issue of issues) {
|
|
110
|
+
lines.push(`${issue.level === 'error' ? 'ERROR' : 'warn '} ${key} ${issue.path}: ${issue.message}`);
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
lines.push(result.ok ? 'ok' : 'not ok');
|
|
114
|
+
return lines;
|
|
115
|
+
}
|
|
116
|
+
//# sourceMappingURL=check.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/matter/check.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
export interface ClusterDefaults {
|
|
2
|
+
/** features chosen when neither the device type, a family nor the config chose any */
|
|
3
|
+
features?: readonly string[];
|
|
4
|
+
attributes?: (features: ReadonlySet<string>) => Record<string, unknown>;
|
|
5
|
+
}
|
|
6
|
+
export declare const CLUSTER_DEFAULTS: Readonly<Record<string, ClusterDefaults>>;
|