{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"The LIFX Switch","type":"basic","slug":"the-lifx-switch","excerpt":"","body":"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.\n\nThis device is a \"non light\" and has some differencees in behaviour to existing LIFX devices.\n\nThis includes new messages to control the features specific to the Switch and some differences in how it responds to existing \"light\" messages.\n\nYou can find switch related messages on the [switch messages](#switch-messages) page.\n\nFor 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](#doc:light-messages) messages. As the switch is not a \"light\", it will ignore these messages and return a special `StateUnhandled` message instead of the usual State message a LIFX light would respond with.\n\n### StateUnhandled - 223\n\nExpresses that the device received but did not support your message\n\n| Field | Type | Description |\n|-----|------|------|\n| unhandled_type | unsigned 16-bit integer |The type of the packet that was ignored |\n\nFor example, if you send a [GetColor](doc:light-messages#section-get-101) to a LIFX switch, then you would received a ``StateUnhandled`` with a ``unhandled_type`` of 101.","updates":[],"order":7,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5fa49a962f771e0045ca9e75","createdAt":"2020-11-06T00:36:38.803Z","user":"57749b725b96cf0e00558ea6","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Guides","slug":"guides","order":1,"from_sync":false,"reference":false,"_id":"57fdb520bcc07b0e00d1ef41","createdAt":"2016-10-12T03:59:28.475Z","__v":0,"project":"5581248904ae5b0d0026289a","version":"57fdb17c4defec0e0064228b"},"version":{"version":"2.0","version_clean":"2.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["57fdb17c4defec0e0064228c","57fdb17c4defec0e0064228d","57fdb17c4defec0e0064228e","57fdb520bcc07b0e00d1ef41"],"_id":"57fdb17c4defec0e0064228b","project":"5581248904ae5b0d0026289a","__v":2,"createdAt":"2016-10-12T03:43:56.009Z","releaseDate":"2016-10-12T03:43:56.009Z"},"project":"5581248904ae5b0d0026289a","__v":0,"parentDoc":null}
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. This includes new messages to control the features specific to the Switch and some differences in how it responds to existing "light" messages. You can find switch related messages on the [switch messages](#switch-messages) page. 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](#doc:light-messages) messages. As the switch is not a "light", it will ignore these messages and return a special `StateUnhandled` message instead of the usual State message a LIFX light would respond with. ### StateUnhandled - 223 Expresses that the device received but did not support your message | Field | Type | Description | |-----|------|------| | unhandled_type | unsigned 16-bit integer |The type of the packet that was ignored | For example, if you send a [GetColor](doc:light-messages#section-get-101) to a LIFX switch, then you would received a ``StateUnhandled`` with a ``unhandled_type`` of 101.