Changing a device
The LIFX protocol supports Set
messages which are used to change metadata or the visual appearance of a device. These messages also return State
messages like the Get
messages do when you specify res_required=1
.
Note however that if your Set
messages changes the visual appearance of the light it is likely you'll get the state of the device before your change.
Device
SetPower - Packet 21
This packet lets you set the current level of power on the device.
Will return one StatePower (22) message
|
SetLabel - Packet 24
This packet lets you set the label
on the device. The label is a string you assign to the device and will be displayed as the name of the device in the LIFX mobile apps.
Will return one StateLabel (25) message
|
SetReboot - Packet 38
This packet will instruct the device to perform a reboot similar to if it had been power cycled.
SetLocation - Packet 49
This packet lets you set the location
information on the device.
Will return one StateLocation (50) message
SetGroup - Packet 52
This packet lets you set the group
information on the device.
Will return one StateGroup (53) message
Light
SetColor - Packet 102
This packet lets you set the HSBK value for the light. For devices that have multiple zones, this will set all Zones on the device to this color.
Will return one LightState (107) message
SetWaveform - Packet 103
This packet lets you set the HSBK and Waveforms value for the light. For devices that have multiple zones, this will treat all the zones on the device as one.
Will return one LightState (107) message
SetLightPower - Packet 117
This is the same as SetPower (21) but allows you to specify how long it will take to transition to the new power state.
Will return one StateLightPower (118) message
SetWaveformOptional - Packet 119
This behaves like SetWaveform (103) but allows you to keep certain parts of the original HSBK values during the transition.
Will return one LightState (107) message
|
|
|
|
|
|
|
|
|
SetInfrared - Packet 122
This packet lets you change the current infrared value on the device
Will return one StateInfrared (121) message
This packet requires the device has the infrared
capability. You may use GetVersion (32), GetHostFirmware (14) and the Product Registry to determine whether your device has this capability
|
SetHevCycle - Packet 143
This packet lets you start or stop a HEV cycle on the device.
Will return one StateHevCycle (144) message
This packet requires the device has the hev
capability. You may use GetVersion (32), GetHostFirmware (14) and the Product Registry to determine whether your device has this capability
|
|
SetHevCycleConfiguration - Packet 146
This packet lets you set default values for a HEV cycle on the device
Will return one StateHevCycleConfiguration (147) message
This packet requires the device has the hev
capability. You may use GetVersion (32), GetHostFirmware (14) and the Product Registry to determine whether your device has this capability
|
|
MultiZone
SetColorZones - Packet 501
Set a segment of your strip to a HSBK value. If your devices supports extended multizone messages it is recommended you use those messages instead.
Will return one StateMultiZone (506) message
This packet requires the device has the Linear Zones
capability. You may use GetVersion (32), GetHostFirmware (14) and the Product Registry to determine whether your device has this capability
|
|
|
|
|
|
|
|
SetMultiZoneEffect - Packet 508
Start a multizone Firmware Effect on the device.
Will return one StateMultiZoneEffect (509) message
This packet requires the device has the Linear Zones
capability. You may use GetVersion (32), GetHostFirmware (14) and the Product Registry to determine whether your device has this capability
|
|
|
|
|
|
|
|
SetExtendedColorZones - Packet 510
This message lets you change the HSBK values for all zones on the strip in one message.
Will return one StateExtendedColorZones (512) message
This packet requires the device has the Extended Linear Zones
capability. You may use GetVersion (32), GetHostFirmware (14) and the Product Registry to determine whether your device has this capability
|
|
|
|
|
Relay
SetRPower - Packet 817
Set the power state of a relay on a switch device. Current models of the LIFX switch do not have dimming capability, so the two valid values are 0
for off
and 65535
for on
.
Will return one StateRPower (818) message
This packet requires the device has the Relays
capability. You may use GetVersion (32), GetHostFirmware (14) and the Product Registry to determine whether your device has this capability
Tile
SetUserPosition - Packet 703
Allows you to specify the position of this device in the chain relative to other device in the chain.
You can find more information about this data by looking at Tile Positions.
This message has no response packet even if you set res_required=1
.
This packet requires the device has the Matrix Zones
capability. You may use GetVersion (32), GetHostFirmware (14) and the Product Registry to determine whether your device has this capability
Set64 - Packet 715
This lets you set up to 64
HSBK values on the device.
This message has no response packet even if you set res_required=1
.
This packet requires the device has the Matrix Zones
capability. You may use GetVersion (32), GetHostFirmware (14) and the Product Registry to determine whether your device has this capability
|
|
|
|
|
|
|
|
SetTileEffect - Packet 719
This packet will let you start a Firmware Effect on the device.
Will return one StateTileEffect (720) message
This packet requires the device has the Matrix Zones
capability. You may use GetVersion (32), GetHostFirmware (14) and the Product Registry to determine whether your device has this capability
Note: The Sky effect is only supported on LIFX Ceiling, running firmware 4.4 or higher
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Updated 15 days ago