---
updatedAt: 2026-08-06T06:14:32.000Z
agentTools:
  projectIndex: https://lan.developer.lifx.com/llms.txt
---

# Information messages

You will receive a State message to your request when you send a Get message or if your Set message has the `res_required` flag set to 1. Though typically you would only require acknowledgement from Set messages.

# Core

### Acknowledgement - Packet 45

This packet is returned when you specify `ack_required=1`.

# Discovery

### StateService - Packet 3

This packet is used to tell you what services are available and the port each service is on.

This packet is the reply to the [GetService (2)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getservice---packet-2) message

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>service</code>: <a href="doc:field-types#uint8">Uint8</a> using <a href="doc:field-types#services">Services</a> Enum</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>port</code>: <a href="doc:field-types#uint32">Uint32</a><br>The port of the service. This value is usually <code>56700</code> but you should not assume this is always the case.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

# Device

### StateHostFirmware - Packet 15

This packet will tell you what version of firmware is on the device.

Typically you would use this information along with [StateVersion (33)](https://lan.developer.lifx.com/docs/information-messages#stateversion---packet-33) to determine the capabilities of your device as specified in our [Product Registry](https://lan.developer.lifx.com/docs/product-registry).

The `version_major` and `version_minor` should be thought of as a pair of `(major, minor)`. So say `major` is `3` and `minor` is `60`, then the version is `(3, 60)`. This means that `(2, 80)` is considered less than `(3, 60)` and `(3, 70)` is considered greater.

LIFX products will specify a different `major` for each generation of our devices.

This packet is the reply to the [GetHostFirmware (14)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethostfirmware---packet-14) message

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>build</code>: <a href="doc:field-types#uint64">Uint64</a><br>The timestamp of the firmware that is on the device as an epoch</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved6</code>: 8 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>version_minor</code>: <a href="doc:field-types#uint16">Uint16</a><br>The minor component of the firmware version</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>version_major</code>: <a href="doc:field-types#uint16">Uint16</a><br>The Major component of the firmware version</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StateWifiInfo - Packet 17

This packet will give you information about the signal strength of the device.

The units of this field varies between different products, You can use the following pseudo code to determine the signal strength of your device.

```
rssi = int(floor(10 * Log10(signal) + 0.5))

if rssi < 0 or rssi == 200:
    if rssi == 200:
        status = "No signal"
    else if rssi <= -80:
        status = "Very bad signal"
    else if rssi <= -70:
        status = "Somewhat bad signal"
    else if rssi <= -60:
        status = "Alright signal"
    else:
        status = "Good signal"

if rssi == 4 or rssi == 5 or rssi == 6:
    status = "Very bad signal"

elif rssi >= 7 and rssi <= 11:
    status = "Somewhat bad signal"

elif rssi >= 12 and rssi <= 16:
    status = "Alright signal";

elif rssi > 16:
    status = "Good signal"

else:
    status = "No signal"
```

This packet is the reply to the [GetWifiInfo (16)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getwifiinfo---packet-16) message

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>signal</code>: <a href="doc:field-types#float">Float</a><br>The signal strength of the device.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved6</code>: 4 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved7</code>: 4 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved8</code>: 2 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StateWifiFirmware - Packet 19

This packet is the reply to the [GetWifiFirmware (18)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getwififirmware---packet-18) message

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>build</code>: <a href="doc:field-types#uint64">Uint64</a><br>The timestamp when the wifi firmware was created as an epoch, This is only relevant for the first two generations of our products.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved6</code>: 8 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>version_minor</code>: <a href="doc:field-types#uint16">Uint16</a><br>The <code>minor</code> component of the version.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>version_major</code>: <a href="doc:field-types#uint16">Uint16</a><br>The <code>major</code> component of the version.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StatePower - Packet 22

This packet tells us the current power level of the device. `0` means off and any other value means on. Note that `65535` is full power and during a power transition (i.e. via [SetLightPower (117)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#setlightpower---packet-117)) the value may be any value between `0` and `65535`.

This packet is the reply to the [GetPower (20)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getpower---packet-20) and [SetPower (21)](https://lan.developer.lifx.com/docs/changing-a-device#setpower---packet-21) messages

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>level</code>: <a href="doc:field-types#uint16">Uint16</a><br>The current level of the device&#39;s power.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StateLabel - Packet 25

This packet tells us the label of the device.

This packet is the reply to the [GetLabel (23)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getlabel---packet-23) and [SetLabel (24)](https://lan.developer.lifx.com/docs/changing-a-device#setlabel---packet-24) messages

|                                                    |
| :------------------------------------------------- |
|                                                    |
| `label`: 32 bytes [String](https://lan.developer.lifx.com/docs/field-types#string) |

### StateVersion - Packet 33

This packet tell us the version of the firmware on the device. This information can be used with our [Product Registry](https://lan.developer.lifx.com/docs/product-registry) to determine what capabilities are supported by the device.

This packet is the reply to the [GetVersion (32)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getversion---packet-32) message

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>vendor</code>: <a href="doc:field-types#uint32">Uint32</a><br>For LIFX products this value is <code>1</code>. There may be devices in the future with a different <code>vendor</code> value.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>product</code>: <a href="doc:field-types#uint32">Uint32</a><br>The product id of the device. The available products can be found in our <a href="doc:product-registry">Product Registry</a>.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved6</code>: 4 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StateInfo - Packet 35

This packet provides information about the device.

This packet is the reply to the [GetInfo (34)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getinfo---packet-34) message

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>time</code>: <a href="doc:field-types#uint64">Uint64</a><br>The current time according to the device. Note that this is most likely inaccurate.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>uptime</code>: <a href="doc:field-types#uint64">Uint64</a><br>The amount of time in nanoseconds the device has been online since last power on</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>downtime</code>: <a href="doc:field-types#uint64">Uint64</a><br>The amount of time in nanseconds of power off time accurate to 5 seconds.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StateLocation - Packet 50

This packet provides the details of the location set on the device.

To determine the label of a location you need to send a [GetLocation (48)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getlocation---packet-48) to all the devices you can find and for each location `uuid` determine which label is accompanied by the latest `updated_at` value.

This packet is the reply to the [GetLocation (48)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getlocation---packet-48) and [SetLocation (49)](https://lan.developer.lifx.com/docs/changing-a-device#setlocation---packet-49) messages

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>location</code>: 16 <a href="doc:field-types#bytes">Bytes</a><br>The unique identifier of this group as a <code>uuid</code>.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>label</code>: 32 bytes <a href="doc:field-types#string">String</a><br>The name assigned to this location</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>updated_at</code>: <a href="doc:field-types#uint64">Uint64</a><br>An epoch in nanoseconds of when this location was set on the device</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StateGroup - Packet 53

This packet provides the details of the group set on the device.

To determine the label of a group you need to send a [GetGroup (51)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getgroup---packet-51) to all the devices you can find and for each group `uuid` determine which label is accompanied by the latest `updated_at` value.

This packet is the reply to the [GetGroup (51)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getgroup---packet-51) and [SetGroup (52)](https://lan.developer.lifx.com/docs/changing-a-device#setgroup---packet-52) messages

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>group</code>: 16 <a href="doc:field-types#bytes">Bytes</a><br>The unique identifier of this group as a <code>uuid</code>.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>label</code>: 32 bytes <a href="doc:field-types#string">String</a><br>The name assigned to this group</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>updated_at</code>: <a href="doc:field-types#uint64">Uint64</a><br>An epoch in nanoseconds of when this group was set on the device</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### EchoResponse - Packet 59

This tells you the same value you specified when you sent an [EchoRequest (58)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#echorequest---packet-58) to the device.

|                                              |
| :------------------------------------------- |
|                                              |
| `echoing`: 64 [Bytes](https://lan.developer.lifx.com/docs/field-types#bytes) |

### StateUnhandled - Packet 223

For some firmware, this packet is returned when the device receives a packet it does not know how to handle. For now, only the LIFX Switch has this behaviour.

It will return the type of packet it couldn't handle. For example, if you send a [GetColor (101)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getcolor---packet-101) to a LIFX switch, then you would receive one of these with a `unhandled_type` of 101.

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>unhandled_type</code>: <a href="doc:field-types#uint16">Uint16</a><br>The type of the packet that was ignored.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

# Light

### LightState - Packet 107

The current visual state of the device and it's label

This packet is the reply to [GetColor (101)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getcolor---packet-101), [SetColor (102)](https://lan.developer.lifx.com/docs/changing-a-device#setcolor---packet-102), [SetWaveform (103)](https://lan.developer.lifx.com/docs/changing-a-device#setwaveform---packet-103) and [SetWaveformOptional (119)](https://lan.developer.lifx.com/docs/changing-a-device#setwaveformoptional---packet-119) messages

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>hue</code>: <a href="doc:field-types#uint16">Uint16</a></p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>saturation</code>: <a href="doc:field-types#uint16">Uint16</a></p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>brightness</code>: <a href="doc:field-types#uint16">Uint16</a></p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>kelvin</code>: <a href="doc:field-types#uint16">Uint16</a></p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved6</code>: 2 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>power</code>: <a href="doc:field-types#uint16">Uint16</a><br>The current power level of the device.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>label</code>: 32 bytes <a href="doc:field-types#string">String</a><br>The current label on the device.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved7</code>: 8 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StateLightPower - Packet 118

This says the current power level of the device.

This packet is the reply to the [GetLightPower (116)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getlightpower---packet-116) and [SetLightPower (117)](https://lan.developer.lifx.com/docs/changing-a-device#setlightpower---packet-117) messages

|                                           |
| :---------------------------------------- |
|                                           |
| `level`: [Uint16](https://lan.developer.lifx.com/docs/field-types#uint16) |

### StateInfrared - Packet 121

This says the current brightness of the infrared output from the device

This packet requires the device has the `infrared` capability. You may use [GetVersion (32)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getversion---packet-32), [GetHostFirmware (14)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethostfirmware---packet-14) and the [Product Registry](https://lan.developer.lifx.com/docs/product-registry) to determine whether your device has this capability

This packet is the reply to the [GetInfrared (120)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getinfrared---packet-120) and [SetInfrared (122)](https://lan.developer.lifx.com/docs/changing-a-device#setinfrared---packet-122) messages

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>brightness</code>: <a href="doc:field-types#uint16">Uint16</a><br>The amount of infrared. <code>0</code> is no infrared output and <code>65535</code> is full infrared output.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StateHevCycle - Packet 144

This says whether a HEV cycle is running on the device.

This packet requires the device has the `hev` capability. You may use [GetVersion (32)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getversion---packet-32), [GetHostFirmware (14)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethostfirmware---packet-14) and the [Product Registry](https://lan.developer.lifx.com/docs/product-registry) to determine whether your device has this capability

This packet is the reply to the [GetHevCycle (142)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethevcycle---packet-142) and [SetHevCycle (143)](https://lan.developer.lifx.com/docs/changing-a-device#sethevcycle---packet-143) messages

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>duration_s</code>: <a href="doc:field-types#uint32">Uint32</a><br>The duration, in seconds, this cycle was set to.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>remaining_s</code>: <a href="doc:field-types#uint32">Uint32</a><br>The duration, in seconds, remaining in this cycle</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>last_power</code>: <a href="doc:field-types#boolint">BoolInt</a><br>The power state before the HEV cycle started, which will be the power state once the cycle completes. This is only relevant if remaining_s is larger than 0.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StateHevCycleConfiguration - Packet 147

This packet lets you set default values for a HEV cycle on the device

This packet requires the device has the `hev` capability. You may use [GetVersion (32)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getversion---packet-32), [GetHostFirmware (14)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethostfirmware---packet-14) and the [Product Registry](https://lan.developer.lifx.com/docs/product-registry) to determine whether your device has this capability

This packet is the reply to the [GetHevCycleConfiguration (145)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethevcycleconfiguration---packet-145) and [SetHevCycleConfiguration (146)](https://lan.developer.lifx.com/docs/changing-a-device#sethevcycleconfiguration---packet-146) messages

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>indication</code>: <a href="doc:field-types#boolint">BoolInt</a><br>Whether a short flashing indication is run at the end of an HEV cycle.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>duration_s</code>: <a href="doc:field-types#uint32">Uint32</a><br>This is the default duration that is used when <a href="doc:changing-a-device#sethevcycle---packet-143">SetHevCycle (143)</a> is given 0 for duration_s.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StateLastHevCycleResult - Packet 149

This packet tells you the result of the last HEV cycle that was run

This packet requires the device has the `hev` capability. You may use [GetVersion (32)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getversion---packet-32), [GetHostFirmware (14)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethostfirmware---packet-14) and the [Product Registry](https://lan.developer.lifx.com/docs/product-registry) to determine whether your device has this capability

This packet is the reply to the [GetLastHevCycleResult (148)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getlasthevcycleresult---packet-148) message

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>result</code>: <a href="doc:field-types#uint8">Uint8</a> using <a href="doc:field-types#lightlasthevcycleresult">LightLastHevCycleResult</a> Enum<br>An enum saying whether the last cycle completed or interrupted.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

# MultiZone

### StateZone - Packet 503

This represents the [HSBK](https://lan.developer.lifx.com/docs/representing-color-with-hsbk) value of a single zone on your strip.

This packet requires the device has the `Linear Zones` capability. You may use [GetVersion (32)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getversion---packet-32), [GetHostFirmware (14)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethostfirmware---packet-14) and the [Product Registry](https://lan.developer.lifx.com/docs/product-registry) to determine whether your device has this capability

This packet is the reply to the [GetColorZones (502)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getcolorzones---packet-502) and [SetColorZones (501)](https://lan.developer.lifx.com/docs/changing-a-device#setcolorzones---packet-501) messages

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>zones_count</code>: <a href="doc:field-types#uint8">Uint8</a><br>The total number of zones on the strip.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>zone_index</code>: <a href="doc:field-types#uint8">Uint8</a><br>The zone this packet refers to.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>hue</code>: <a href="doc:field-types#uint16">Uint16</a></p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>saturation</code>: <a href="doc:field-types#uint16">Uint16</a></p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>brightness</code>: <a href="doc:field-types#uint16">Uint16</a></p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>kelvin</code>: <a href="doc:field-types#uint16">Uint16</a></p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StateMultiZone - Packet 506

This represents a segment of `8` [HSBK](https://lan.developer.lifx.com/docs/representing-color-with-hsbk) values on your strip.

This packet requires the device has the `Linear Zones` capability. You may use [GetVersion (32)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getversion---packet-32), [GetHostFirmware (14)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethostfirmware---packet-14) and the [Product Registry](https://lan.developer.lifx.com/docs/product-registry) to determine whether your device has this capability

This packet is the reply to the [GetColorZones (502)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getcolorzones---packet-502) and [SetColorZones (501)](https://lan.developer.lifx.com/docs/changing-a-device#setcolorzones---packet-501) messages

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>zones_count</code>: <a href="doc:field-types#uint8">Uint8</a><br>The total number of zones on your strip</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>zone_index</code>: <a href="doc:field-types#uint8">Uint8</a><br>The first zone represented by this packet</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>colors</code>: 8 <a href="doc:field-types#color">Color</a> structures<br>The <a href="doc:representing-color-with-hsbk">HSBK</a> values of the zones this packet refers to.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StateMultiZoneEffect - Packet 509

This packet tells us what [Firmware Effect](https://lan.developer.lifx.com/docs/firmware-effects) is current running on the device.

This packet requires the device has the `Linear Zones` capability. You may use [GetVersion (32)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getversion---packet-32), [GetHostFirmware (14)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethostfirmware---packet-14) and the [Product Registry](https://lan.developer.lifx.com/docs/product-registry) to determine whether your device has this capability

This packet is the reply to the [GetMultiZoneEffect (507)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getmultizoneeffect---packet-507) and [SetMultiZoneEffect (508)](https://lan.developer.lifx.com/docs/changing-a-device#setmultizoneeffect---packet-508) messages

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>instanceid</code>: <a href="doc:field-types#uint32">Uint32</a><br>The unique value identifying this effect</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>type</code>: <a href="doc:field-types#uint8">Uint8</a> using <a href="doc:field-types#multizoneeffecttype">MultiZoneEffectType</a> Enum</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved6</code>: 2 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>speed</code>: <a href="doc:field-types#uint32">Uint32</a><br>The time it takes for one cycle of the effect in milliseconds</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>duration</code>: <a href="doc:field-types#uint64">Uint64</a><br>The amount of time left in the current effect in nanoseconds</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved7</code>: 4 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved8</code>: 4 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>parameters</code>: 32 <a href="doc:field-types#bytes">Bytes</a><br>The parameters that was used in the request.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StateExtendedColorZones - Packet 512

The [HSBK](https://lan.developer.lifx.com/docs/representing-color-with-hsbk) values of the zones specified in the request

This packet requires the device has the `Extended Linear Zones` capability. You may use [GetVersion (32)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getversion---packet-32), [GetHostFirmware (14)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethostfirmware---packet-14) and the [Product Registry](https://lan.developer.lifx.com/docs/product-registry) to determine whether your device has this capability

This packet is the reply to the [GetExtendedColorZones (511)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getextendedcolorzones---packet-511) and [SetExtendedColorZones (510)](https://lan.developer.lifx.com/docs/changing-a-device#setextendedcolorzones---packet-510) messages

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>zones_count</code>: <a href="doc:field-types#uint16">Uint16</a><br>The number of zones on your strip</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>zone_index</code>: <a href="doc:field-types#uint16">Uint16</a><br>The first zone represented in the packet. If the light has more than 82 zones, then this property indicates the relative positioning of the colors contained in a given message.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>colors_count</code>: <a href="doc:field-types#uint8">Uint8</a><br>The number of <a href="doc:representing-color-with-hsbk">HSBK</a> values in the <code>colors</code> array that map to zones.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>colors</code>: 82 <a href="doc:field-types#color">Color</a> structures<br>The <a href="doc:representing-color-with-hsbk">HSBK</a> values currently set on each zone.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

# Relay

### StateRPower - Packet 818

Current models of the LIFX switch do not have dimming capability, so the two valid values are `0` for `off` and `65535` for `on`.

This packet requires the device has the `Relays` capability. You may use [GetVersion (32)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getversion---packet-32), [GetHostFirmware (14)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethostfirmware---packet-14) and the [Product Registry](https://lan.developer.lifx.com/docs/product-registry) to determine whether your device has this capability

This packet is the reply to the [GetRPower (816)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getrpower---packet-816) and [SetRPower (817)](https://lan.developer.lifx.com/docs/changing-a-device#setrpower---packet-817) messages

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>relay_index</code>: <a href="doc:field-types#uint8">Uint8</a><br>The relay on the switch starting from <code>0</code>.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>level</code>: <a href="doc:field-types#uint16">Uint16</a><br>The new value of the relay</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

# Button

### StateButtonConfig - Packet 911

The current button configuration on the device. The haptic duration is how long haptic feedback lasts after a button press. The backlight colors reflect the color and brightness of the button backlight when it is `on` and `off`.

This packet requires the device has the `Buttons` capability. You may use [GetVersion (32)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getversion---packet-32), [GetHostFirmware (14)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethostfirmware---packet-14) and the [Product Registry](https://lan.developer.lifx.com/docs/product-registry) to determine whether your device has this capability

This packet is the reply to the [GetButtonConfig (909)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getbuttonconfig---packet-909) and [SetButtonConfig (910)](https://lan.developer.lifx.com/docs/changing-a-device#setbuttonconfig---packet-910) messages

<Table align={["left"]}>
  <thead>
    <tr>
      <th>

      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>

      </td>
    </tr>

    <tr>
      <td>
        `haptic_duration_ms`: [Uint16](https://lan.developer.lifx.com/docs/field-types#uint16)
        The duration of haptic feedback after a button press in milliseconds, between `0` and `500`. A value of `0` indicates no haptic feedback.
      </td>
    </tr>

    <tr>
      <td>
        `backlight_on_color`: [ButtonBacklightHSBK](https://lan.developer.lifx.com/docs/field-types#buttonbacklighthsbk) structure
        The color and brightness of the button backlight when the button is `on`.
      </td>
    </tr>

    <tr>
      <td>
        `backlight_off_color`: [ButtonBacklightHSBK](https://lan.developer.lifx.com/docs/field-types#buttonbacklighthsbk) structure
        The color and brightness of the button backlight when the button is `off`.
      </td>
    </tr>
  </tbody>
</Table>

# Tile

### StateDeviceChain - Packet 702

Information about each device in the chain.

This packet requires the device has the `Matrix Zones` capability. You may use [GetVersion (32)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getversion---packet-32), [GetHostFirmware (14)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethostfirmware---packet-14) and the [Product Registry](https://lan.developer.lifx.com/docs/product-registry) to determine whether your device has this capability

This packet is the reply to the [GetDeviceChain (701)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getdevicechain---packet-701) message

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>start_index</code>: <a href="doc:field-types#uint8">Uint8</a><br>The index of the first device in the chain this packet refers to</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>tile_devices</code>: 16 <a href="doc:field-types#tile">Tile</a> structures<br>The information for each device in the chain</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>tile_devices_count</code>: <a href="doc:field-types#uint8">Uint8</a><br>The number of device in <code>tile_devices</code> that map to devices in the chain.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### State64 - Packet 711

The current [HSBK](https://lan.developer.lifx.com/docs/representing-color-with-hsbk) values of the zones in a single device.

This packet requires the device has the `Matrix Zones` capability. You may use [GetVersion (32)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getversion---packet-32), [GetHostFirmware (14)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethostfirmware---packet-14) and the [Product Registry](https://lan.developer.lifx.com/docs/product-registry) to determine whether your device has this capability

This packet is the reply to the [Get64 (707)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#get64---packet-707) and [Set64 (715)](https://lan.developer.lifx.com/docs/changing-a-device#set64---packet-715) messages

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>tile_index</code>: <a href="doc:field-types#uint8">Uint8</a><br>The index of the device in the chain this packet refers to. This is <code>0</code> based starting from the device closest to the controller.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved6</code>: 1 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>x</code>: <a href="doc:field-types#uint8">Uint8</a><br>The x coordinate the colors start from</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>y</code>: <a href="doc:field-types#uint8">Uint8</a><br>The y coordinate the colors start from</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>width</code>: <a href="doc:field-types#uint8">Uint8</a><br>The width of each row</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>colors</code>: 64 <a href="doc:field-types#color">Color</a> structures</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### StateTileEffect - Packet 720

The current [Firmware Effect](https://lan.developer.lifx.com/docs/firmware-effects) running on the device

This packet requires the device has the `Matrix Zones` capability. You may use [GetVersion (32)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#getversion---packet-32), [GetHostFirmware (14)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gethostfirmware---packet-14) and the [Product Registry](https://lan.developer.lifx.com/docs/product-registry) to determine whether your device has this capability

This packet is the reply to the [GetTileEffect (718)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#gettileeffect---packet-718) and [SetTileEffect (719)](https://lan.developer.lifx.com/docs/changing-a-device#settileeffect---packet-719) messages

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"></td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved0</code>: 1 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>instanceid</code>: <a href="doc:field-types#uint32">Uint32</a><br>The unique value identifying the request</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>type</code>: <a href="doc:field-types#uint8">Uint8</a> using <a href="doc:field-types#tileeffecttype">TileEffectType</a> Enum</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>speed</code>: <a href="doc:field-types#uint32">Uint32</a><br>The time it takes for one cycle in milliseconds.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>duration</code>: <a href="doc:field-types#uint64">Uint64</a><br>The amount of time left in the current effect in nanoseconds</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved1</code>: 4 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved2</code>: 4 <a href="doc:field-types#reserved">Reserved</a> bytes</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>skyType</code>: <a href="doc:field-types#tileeffectskytype">TileEffectSkyType</a>  only used on <code>SKY</code> effect</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved3</code>: 3 <a href="doc:field-types#reserved">Reserved</a>  bytes</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>cloudSaturationMin</code> 1  <a href="doc:field-types#bytes">Bytes</a>   only used on <code>SKY</code> effect when using <code>CLOUDS</code></p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved4</code>: 3 <a href="doc:field-types#reserved">Reserved</a>   bytes</p>
</td>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>reserved5</code>: 24 <a href="doc:field-types#reserved">Reserved</a>  bytes<br>This field is currently ignored by all firmware effects.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>palette_count</code>: <a href="doc:field-types#uint8">Uint8</a><br>The number of colors in the <code>palette</code> that are relevant</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>palette</code>: 16 <a href="doc:field-types#color">Color</a> structures<br>The colors specified for the effect.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

### SensorStateAmbientLight - Packet 402

**Note: This is a legacy feature that is unsupported.**\
This feature is only supported by a limited number of devices.\
This packet shows the current levels of ambient light as detected by the target device, and is emitted by a device in response to a `[SensorGetAmbientLight (401)](https://lan.developer.lifx.com/docs/querying-the-device-for-data#sensorgetambientlight---packet-401)` message.

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p><code>lux</code>: <a href="doc:field-types#uint8">Float</a><br>The value of the detected light level. If a light is turned on at the time the message is sent, the value will be unreliable and potentially maxed out. For best results, only send this message to devices that are currently &quot;soft off&quot;.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>