This is an old revision of the document!
To use the controller, a config file is needed. pilight-control can then easily switch devices by using their config location and name. This allows for controlling devices without having to remember all different ID numbers.
root@pi:~# pilight-control -l living -d bookshelve
The config file will automatically be updated with the status of the configured devices. So while sending, but also while receiving.
To force the device in a specific state:
root@pi:~# pilight-control -l living -d bookshelve -s on
To also simultaneously change the value a device such as a dimmer you can use:
root@pi:~# pilight-control -l living -d main -s on -v dimlevel=1