set_temperature_automation
Enable temperature automation on a controller port by switching to AUTO mode and setting min/max temperature thresholds. The fan speeds up above max_temp and slows down below min_temp.
Instructions
Enable temperature automation on a port using the built-in temperature sensor.
Switches the port to AUTO mode (atType=3) and sets the temperature thresholds. The controller speeds up when temperature exceeds max_temp and slows down below min_temp. Uses read-before-write. Defaults to dry_run=True.
Pass values in the device's preferred unit (°F or °C). Call discover_devices
first to check temp_unit. Valid range: 32–122°F or 0–50°C (device API cap = 50°C).
Args: device_id: Device code from discover_devices (e.g. "C58ZA"). port: 1-based port number. min_temp: Minimum temperature threshold in the device's preferred unit. Sub-degree values are rounded to the nearest integer. max_temp: Maximum temperature threshold in the device's preferred unit. Must exceed min_temp. Sub-degree values are rounded to the nearest integer. dry_run: If True (default), returns the payload that would be sent without writing.
Returns:
JSON with action, device_id, port, min_temp, max_temp, unit, dry_run,
controller_type, sent, and payload (when dry_run=True).
On failure returns {"error": "..."}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device_id | Yes | ||
| port | Yes | ||
| min_temp | Yes | ||
| max_temp | Yes | ||
| dry_run | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |