LIFX LAN Protocol

The LIFX LAN Protocol Developer Hub

Welcome to the LIFX LAN Protocol developer hub. You'll find comprehensive guides and documentation to help you start working with LIFX LAN Protocol as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

The LIFX Switch

LIFX released in 2020 a new device that is installed in your wall and acts as a physical interface to turning your lights on and off. This device can control "dumb" lights wired into the switch as well as your smart lights attached to the LIFX Cloud.

This device is a "non light" and has some differencees in behaviour to existing LIFX devices.

For existing messages in the LIFX public API, the device will appear like any other LIFX device on your network except for its response to "Light" messages. As the switch is not a "light", it will ignore these messages and return a special StateUnhandled (223) message instead of the usual State message a LIFX light would respond with.

Controlling Relays

The switch messages are for controlling features specific to the LIFX Switch. The public API only contains messages for turning "relays" on and off and more messages will be added in the future.

A LIFX switch has a number of buttons that may either modify a physical "relay" attached to a "dumb" light, or make a request to the LIFX cloud to modify a light.

The switch has both inputs (the physical buttons on the device) and outputs (the electrical relays). The following messages allow you to inspect and set the power level of those electrical relays.

We have released GetRPower (816), SetRPower (817) and StateRPower (818)

Updated 2 months ago

The LIFX Switch


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.