This tutorial will familiarize you with Automagically and help you set up the system to control a single ON/OFF switch using a nice GUI on your phone or PC.
Prerequsites and assumed equipmentEdit
- Automagically installed properly on a Raspberry Pi with a Tellstick/Tellstick Duo from Telldus.
- A remote controlled 432 MHz switch, such as Nexa or Proove self-learning switches, and an accompanying remote - paired and working together.
The signal system of AutomagicallyEdit
Automagically is built around an ingenious signalling system. When things happens in the system, the different modules of Automagically publishes information on a signal bus. Likewise, the different modules also listen to this signal bus and acts when something relevant happens.
It is also possible to trace what happens on this signal bus. One can temporarily enable a signal trace and look what is getting passed in the system between the modules.
A warning though; if you forget to turn off tracing - the system will become very, very slow up to the point where it is no longer usable. The only way to get it back working is to log in to the Pi using SSH and perform the following:
$ sudo /etc/init.d/automagically stop $ sudo rm ~/source/automagically/site/plugins/signaldebug.txt $ sudo /etc/init.d/automagically start
Creating a device by tracing the on/off signalsEdit
The simplest way to set up a new device is to use the signal tracer in Automagically. Point your browser to the administrative pages (/admin/) of Automagically and click on See signals and create handler or device from them. (/signals/index/)
Click on the Toggle signal debug button and notice that the text changes to "Signal debug is turned on". At this point, use your Nexa/Proove remote and click the on button.
If you now press Refresh, you should see something like this in the signal trace:
There is also a link named Tellstick device at the far right. Click on that link and you will come to a page where you are asked to fill in some information about the device. Do not touch House or Code - those are the codes used to control your device.
Give the device a name, e.g. Lamp and a name for the tellstick.config file, e.g. lamp. The rest you can simply leave untouched. Press the Save button, it'll take you to a place called Change raw tellstick device.
Do a final check of the parameters and click Save.
Testing your newly added deviceEdit
Point your browser to the Main Page (/core/) and press refresh in your browser. Now you should see a single black/yellow box on that page with the title Lamp (or whatever your device).
Click on Yellow to turn the device on and Black to turn it off.
If you click on the name of the device, you can schedule it to torn on/off at a later point in time.
Creating a remote and adding the device to itEdit
The Main Page is not very good looking and you surely want to have a nice looking remote to control your home with.
Once again, got to the administrative pages (/admin/) of Automagically and click on Create and configure remotes (/admin/remote/).
Start by adding a new remote by clicking on the +Add next to the line Remotes. Name the remote, e.g. MyRemote, and select jQuery from the Theme dropdown. You might consider to enable OfflineApp, it's up to you. Click Save.
Go back to Home > Remote (/admin/remote/) and click on the +Add next to the line Pages. Name the page, e.g. Home, select MyRemote from Remote. Click Save.
Go back to Home > Remote (/admin/remote/) and click on the +Add next to the line On off devs. Name the device, e.g. Lamp, select Home from Page. And select Lamp from Dev. Click Save.
Testing the remoteEdit
Now you should have a fully functioning remote. Point your brower to the the administrative pages and at the far bottom of that page, click on Change my remote. Here you should now see a remote named MyRemote. Click on Set as my remote (/remote/) and you will now see a On / Off button called Lamp.
Why not click on the buttons and see what happens? Maybe click on Schedule and schedule when the lamp shall be shut down.
Now you might want to start automate your house, jump to next step.