The most basic commands for devices are F1 (ON) and F0 (OFF). If F1 is sent to a dimmer device, that device will go to its previous light level. If the device is already on, will remain at its existing light level. If F1 is sent to an open/close device, that device will go to the open position. If F0 is sent to an open/close device, that device will go to the close position.
Dimming can be done in increments of 32 steps from and including 1 to 32. 1 will result in the minimum brightness of a dimmer device and 32 resulting in full brightness. The commands are FdP, followed by the dim level you are looking for.
Open and Close commands can be sent to the JSJSLW821 (500W relay) only. Dimmer and on/off devices will ignore any open, stop or close commands. The commands are F( for open, F) for close and F^ for stop.
LightwaveRF LED colour changing products will respond to the above on/off and dim commands to handle light output control, but also have the ability to change the colour output, as well as having the functionality to cycle through the colours the device supports.
The command to change the device to a colour is F*cP followed by an integer between 1 and 20 depending on the desired colour (see table below). For example, !R1D1F*cP10 would send Room 1 Device 1 to go to Middle Orange.
| Code | Colour |
|---|---|
| 1 | White |
| 2 | Green White |
| 3 | Red White |
| 4 | Yellow White |
| 5 | Red |
| 6 | Middle Red |
| 7 | Pink |
| 8 | Light Red |
| 9 | Orange |
| 10 | Middle Orange |
| 11 | Green White |
| 12 | Light Orange |
| 13 | Green |
| 14 | Middle Green |
| 15 | Light Yellow Green |
| 16 | Yellow Green |
| 17 | Blue |
| 18 | Water Blue |
| 19 | Light Blue |
| 20 | White Blue |
The colour changing products have the ability to cycle between the colours in 4 modes:
1) Between current colour palette (White, Red, Orange, Green, Blue) - Fast
2) Between current colour palette (White, Red, Orange, Green, Blue) - Slow
3) Between all colour palettes - Fast
4) Between all colour palettes - Slow
It is not possible to choose which cycling mode to use. Each additional transmission of the cycle command will move onto the next mode.
To make the device move to the next cycle, the command to send is F*y, for example !R3D2F*y.
LightwaveRF lighting and power products can be locked on or off. The exception is the JSJSLW381 (promo socket)*. The WiFiLink can send two types of lock commands, plus unlock:
Partial Lock - Devices cannot be switched manually but can be from an RF device (such as the WiFiLink, remote control, PIR etc). Send Fl for this.
Full Lock - Devices cannot be switched either manually nor from an RF command until unlocked. Send Fk for this.
Unlock - Devices which were previously locked will now be able to be controlled. Send Fu for this.
Note The LightwaveRF Dimmer products will still turn on for 5 minutes when they are locked off. After the 5 minutes has elapsed, this will revert back to off. This is a safety feature to allow a user to have light in an emergency, such as a house fire in the middle of the night.
“Normal” commands :
| Command | Operator | Example |
|---|---|---|
| Turn On Room 1 Device 1 | F1 | !R1D1F1 |
| Turn Off Room 1 Device 2 | F0 | !R1D2F0 |
| Dim Room 1 Device 3 (Dim levels 1-32) | FdP | !R1D3FdP32 (100%) |
| !R1D3FdP16 (50%) | ||
| !R1D3FdP3 (10% approx) | ||
| Open Room 2 Device 4 | F( | !R2D4F( |
| Stop Room 2 Device 5 | F^ | !R2D5F^ |
| Close Room 2 Device 6 | F) | !R2D6F) |
| Partially Lock Room 3 Device 7 | Fl | !R3D7Fl |
| Fully Lock Room 3 Device 8 | Fk | !R3D8Fk |
| Unlock Room 3 Device 9 | Fu | !R3D9Fu |
| Set Colour Room 4 Device 10 | F*cP | !R4D10F*cP2 |
| Change Cycling of Room 4 Device 11 | F*y | !R4D10F*y |
In recent versions of the Lightwave Link and WiFiLink (2.92 onwards) there have been the introduction of JSON packets in response to almost all commands. When the Link receives the commands above, it will send an OK response initially (described in Example Interactions) and then a second packet containing information on what radio it has transmitted.
It is also possible for the Link to transmit radio of its own accord through timers and events, or from other clients or in response to server commands.
The format for the power and device transmits will look like:
*!{
"trans":1,
"mac":"03:45:67",
"time":1420070400,
"pkt":"433T",
"fn":"dim",
"room":1,
"dev":1,
"param":16
}where:
| Name | Value(s) | Description |
|---|---|---|
| trans | 1-4294967295 | Transaction number of the JSON packet. Increments every transaction |
| mac | XX:XX:XX | Last 6 octets of Links MAC Address |
| time | 1420070400 | Timestamp of the transaction in a local UNIX time (i.e if Link is set to UTC+2, this time will be UNIX + (3600*2) |
| pkt | 433T | This JSON packet output is a result of a 433MHz transmission |
| fn | on | The radio output is sending function “On” |
| off | The radio output is sending function “Off” | |
| dim | The radio output is sending function “Dim” | |
| fullLock | The radio output is sending function “Full Lock” | |
| manualLock | The radio output is sending function “Manual Lock” | |
| unlock | The radio output is sending function “Unlock” | |
| open | The radio output is sending function “Open” | |
| close | The radio output is sending function “Close” | |
| stop | The radio output is sending function “Stop” | |
| ledColour | The radio output is sending function “Colour Change” | |
| ledColourCycle | The radio output is sending function “Change Colour Cycle” | |
| room | 1-15 | The room number that the command was sent to |
| dev | 1-16 | The device number that the command was sent to |
| param | 1-32 | Not in every packet. The parameter for the function, if the function requires a parameter (i.e. dim) |
Moods are pre-set statuses LightwaveRF power and lighting devices can retain in their memory. The exception is with the JSJSLW381 (promo socket)*. The status can be recalled at a later point for all devices in a room. Recalling the mood will alter the status of every device in the room concurrently. This will change the status of all devices in a room with one command.
*correct as of Q1 2016
It is important to note that it is the devices and not the WiFiLink which retains the mood information. The devices simply follow the command to go to their preset mood, no matter which RF device is sending the command.
The devices have 3 ‘standard’ mood memory slots. These correspond with the JSJSLW101 (Master Mood Switch), the JSJSLW104 (Mood Remote) and the JSJSLW100 (Handheld Remote) products’ buttons which have 1, 2 or 3 dots denoting their mood commands.
In addition there are two further slots. These are recommended to be used as ‘Entry and Exit’ moods. This relates to the JSJSLW101 (Master Mood Switch) which can be setup to use Moods 4 and 5 for moods when the user enters or exits a room. When a user enters a room, they may want certain devices to switch on or off, while when they exit a room they may want certain devices to switch off while some devices remain on.
FsP1 will store the current status all devices within a room are in as their Mood 1.
The user should be directed to first place their devices into the statuses they desire and before sending this command.
FsP1 - Store statuses as Mood 1
FsP2 - Store statuses as Mood 2
FsP3 - Store statuses as Mood 3
FsP4 - Store statuses as Entry Mood
FsP5 - Store statuses as Exit Mood
FmP2 will recall all devices in a room to their previously stored Mood 2.
If a device does not have anything stored in its memory slot for Mood 2 then it will ignore this command and remain in its previous state.
FmP1 - Recall Mood 1
FmP2 - Recall Mood 2
FmP3 - Recall Mood 3
FmP4 - Recall Entry Mood
FmP5 - Recall Exit Mood
This will turn all LightwaveRF devices within a room off.
!R1Fa - Turn All Devices in Room1 Off
Command List :
| Command | Operator | Example |
|---|---|---|
| Save Mood 1 in Room 10 | FsP1 | !R10FsP1 |
| Recall Mood 2 in Room 11 | FmP2 | !R11FmP2 |
| Turn Everything Off in Room 12 | Fa | !R12Fa |
In recent versions of the Lightwave Link and WiFiLink (2.92 onwards) there have been the introduction of JSON packets in response to almost all commands. When the Link receives the commands above, it will send an OK response initially (described in Example Interactions) and then a second packet containing information on what radio it has transmitted.
It is also possible for the Link to transmit radio of its own accord through timers and events, or from other clients or in response to server commands.
The format for the room control transmits will look like:
*!{
"trans":36341,
"mac":"03:45:67",
"time":1420070400,
"pkt":"433T",
"fn":"moodRecall",
"param":1,
"room":1,
"dev":16
}where:
| Name | Value(s) | Description |
|---|---|---|
| trans | 1-4294967295 | Transaction number of the JSON packet. Increments every transaction |
| mac | XX:XX:XX | Last 6 octets of Links MAC Address |
| time | 1420070400 | Timestamp of the transaction in a local UNIX time (i.e if Link is set to UTC+2, this time will be UNIX + (3600*2) |
| pkt | 433T | This JSON packet output is a result of a 433MHz transmission |
| fn | allOff | The radio output is sending function “All Off” |
| moodStore | The radio output is sending function “Store Mood” | |
| moodRecall | The radio output is sending function “Dim” | |
| room | 1-15 | The room number that the command was sent to |
| dev | 1-16 | Though a number will be output, it is irrelevant in any room commands, as all devices will respond |
| param | 1-5 | Not in All Off. The parameter for the function for moods. i.e. Mood 1, 2, 3 etc |
Last updated 21/12/16