matter_fab_settings.c

Fstatic int fab_set(const char *name, size_t len, settings_read_cb read_cb, void *cb_arg)

Settings callback to deserialize and load stored Matter fabrics, Thread dataset, thread extended PAN ID, ICAC metadata, and ICAC certificate. Validates version and layout match; rejects short fabric reads and mismatched sizes to avoid loading truncated data. Returns -EINVAL on version or layout mismatch, or the result of the read callback on success.

Fint matter_fab_store(const struct matter_device_info *info)

Write the operational identity to the settings store. Call after anything that changes the fabric table or the Thread dataset. Cheap enough to call on every such event and far cheaper than being wrong: the alternative is a node that looks commissioned until it reboots.

returns

0, or a negative errno from the settings backend.

Fstatic void discard_partial(struct matter_device_info *info)

Undo a partial read. Shared, because two paths reject a record and both have to leave the same nothing behind.

Fint matter_fab_load(struct matter_device_info *info)

Read it back into @p info.

returns

1 when nothing was stored (never commissioned), 0 when a fabric was restored, negative on a settings error. A stored record written by a different firmware layout is DISCARDED rather than trusted -- see the note on the size check in the .c file.

Fint matter_fab_erase(void)

Forget it, so the next boot comes up commissionable.