diff --git a/book/src/usage.md b/book/src/usage.md index d7e288794..7f136c14d 100644 --- a/book/src/usage.md +++ b/book/src/usage.md @@ -8,13 +8,14 @@ # Miniconf Run-time Settings Stabilizer supports run-time settings configuration using MQTT or the USB port. -Settings can be stored either in the MQTT broker so that they are automatically applied whenever +Settings can be stored in the MQTT broker so that they are automatically applied whenever Stabilizer reboots and connects. This is referred to as "retained" settings. Broker implementations may optionally store these retained settings as well such that they will be reapplied between restarts of the MQTT broker. Stabilizer also supports storing run time settings on the device. Any configurations saved to stabilizer via the USB port will be automatically reapplied when Stabilizer reboots. +MQTT settings retained on the broker or settings published after the device has connected to the broker override the settings saved on Stabilizer. Settings are specific to a device. Any settings configured for one Stabilizer will not be applied to another. Disambiguation of devices is done by using Stabilizer's MQTT identifier, which is