List all AC Infinity controllers on the account with current readings and port status.

tent is the climate inside the grow tent (external probe: temperature °C, humidity %, VPD kPa) — use this when the user asks how the tent is doing. ambient (AI controllers only) is the onboard sensor in the controller housing, i.e. the room outside the tent. Also returns every port with name, power level (0-10), on/off state and active mode, and on AI controllers every individual sensor reading. Readings are null while offline.

A port whose mode is 'Off' but whose power is > 0 is being driven by an Advance Automation program — call list_automations to see the rules governing it.

Get the mode configuration of one port: active mode, on/off power, auto temperature and humidity triggers (°C / %), VPD triggers (kPa), timer and cycle durations (minutes) and the schedule window (HH:MM). Units are already converted; nothing is scaled.

Return the unmodified API object for a port (getdevModeSettingList) including the nested devSetting advanced settings. Port 0 = controller-level settings. Values are in API units (see docs/api/controls-and-settings.md); use get_port_settings for converted values.

Return the advanced settings object (getDevSetting) for a port, or for the controller when port=0: temperature unit, calibration offsets, load type, dynamic response, sunrise timer, display options. Values are in API units. Works on both controller families; on AI controllers the same data is also nested as devSetting in get_port_settings_raw.

List the Advance Automation programs of a controller (the app's "Automations" tab).

A program is a named set of rules; each rule governs one or more ports with a mode (On/Off/Auto/Cycle/VPD), on/off power, a schedule and, for Auto/VPD, sensor thresholds. These rules override the per-port mode from get_port_settings while they run — on AI controllers this is where the real configuration lives.

Use schedule/continuous for when a rule applies: continuous=true means the app's 24/7 switch is on and the rule runs at all times (window/days are then null/empty). Thresholds: low/high are null when that trigger is not set; the underlying record is only partially reverse-engineered (see raw), so report values as decoded from the device rather than as guaranteed.

Unmodified Advance Automation rule objects (getGroups) plus alarms (getAlarms) for a controller, in API units. Use list_automations for the decoded view.

Save the complete configuration of a controller (every port's mode settings, the controller record, all Advance Automation rules and alarms) to a local JSON file. Nothing on the device changes. Do this before any set_* call; restore_settings undoes changes.

List saved backups (newest first) with their ids for restore_settings/compare_backup.

Show every configuration field that differs between a backup and the device right now (per port and per automation rule), without changing anything. Use it after write experiments to verify the device is back in its original state.

Write a backup back to the device: each changed port's full mode settings and each changed automation rule (in place, by id). The controller record (port 0) and rules that no longer exist are skipped and reported. Afterwards the device is re-read and any remaining differences are returned — an empty remaining_changes means fully restored.

Rename a port (the label shown in the AC Infinity app). Does not change any mode or power.

Switch the active mode of a port (e.g. Off, On, Auto, Schedule). The mode's parameters (power, triggers, timers) keep their current values — set them first with the other tools.

Set the power levels (0-10) a port uses in its on and/or off state. Applies to every mode; in On mode on_power is the running level. Pass only the values you want to change.

Configure a countdown timer: the port turns on (to_on) or off (to_off) after minutes.

Configure Cycle mode: repeat on_minutes on, then off_minutes off.

Configure Schedule mode: on at start, off at end (controller local time). A window crossing midnight (e.g. 18:00 → 06:00) is allowed. Null disables that edge (API value 65535).

Configure Auto-mode temperature/humidity triggers. Each trigger has a value and an enabled flag; pass only what should change. Temperatures are °C (the °F twin is derived).

Configure VPD-mode high/low triggers in kPa (one decimal). Pass only what should change.