Share the Alamo gateway request budget

[onehouse] / doc / alamo.rst

diff --git a/doc/alamo.rst b/doc/alamo.rst
index 365f713c85ea26ad919c22a339d01da20d0461a6..c9e6fde47ee62174b7eff135f25135036f3641c9 100644 (file)
--- 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.