X-Git-Url: https://git.giacomolli.uk/onehouse/blobdiff_plain/db3091ee257788c92421a5b8b1af49d429ce8f8e..b9a4f3bdd2609a8b178dd42f313c383ccb59049b:/doc/alamo.rst?ds=inline

diff --git a/doc/alamo.rst b/doc/alamo.rst
index 365f713..c9e6fde 100644
--- a/doc/alamo.rst
+++ b/doc/alamo.rst
@@ -19,3 +19,17 @@ Configure thermostats through the manufacturer's application before use.
 The gateway exposes local heating activity, not independent load-current
 or contactor feedback. Fake HTTP tests do not verify a physical gateway,
 thermostat firmware, or electrical safety.
+
+The driver request scheduler applies one minimum six-second
+request-start interval to status polls and actions together. Its
+operation timeout starts after the rate wait. Caller cancellation or a
+command deadline stops the wait without another exchange. A multi-step
+command can expire between actions. The gateway budget belongs to one
+driver owner.
+
+The private control value uses ``settings.mode`` (``off`` or ``heat``),
+``settings.target_temperature`` in degrees Celsius,
+``current_temperature``, ``floor_temperature``, ``action`` (``off``,
+``idle``, or ``heating``), and ``locked``. Commands contain the complete
+mode and target settings only. House-specific target bounds and steps
+belong to core validation. The driver accepts finite targets.