Homebridge icon

Homebridge

Interact with Homebridge API

Actions80

Accessory → Set Characteristic

AI-generated

Overview

This node interacts with the Homebridge API to set a specific characteristic of a HomeKit accessory. It is useful for automating smart home device configurations, such as changing the state or properties of accessories like lights, thermostats, or sensors within a Homebridge environment.

Use Case Examples

  1. Setting the brightness level of a smart light bulb by specifying the characteristic type and value.
  2. Changing the temperature setting on a smart thermostat accessory.

Properties

Name Meaning
Access Token Access token from Login operation or manually entered for authentication with the Homebridge API.
Unique ID The unique identifier of the accessory to target for the characteristic update.
Characteristic Type The type of characteristic to set on the accessory, such as brightness, temperature, or on/off state.
Value The value to assign to the specified characteristic, which can be a string, boolean, or integer.
Request Options Settings to control request behavior such as batching, SSL certificate validation, proxy usage, and timeout duration.

Output

JSON

  • characteristicType - The characteristic type that was set on the accessory.
  • value - The value that was set for the characteristic.
  • uniqueId - The unique identifier of the accessory that was updated.

Dependencies

  • Homebridge API access with an API key or access token credential

Troubleshooting

  • Ensure the access token is valid and has not expired to avoid authentication errors.
  • Verify the unique ID corresponds to an existing accessory in the Homebridge setup to prevent 'not found' errors.
  • Check that the characteristic type is supported by the accessory to avoid invalid characteristic errors.
  • If SSL issues occur, consider enabling the 'Ignore SSL Issues' option or verify the server's SSL certificate.
  • Adjust timeout settings if requests are timing out due to slow network or server response.

Discussion