Welcome to Telldus API
Here you will find information and sample code for develop against Telldus Live!
In order to get started, please see our php example implementing the API.
You can also test the API right in your browser using the API explorer.
Finally! - Telldus Live! is now available in Norwegian!
If you see any strange translations, please let us know.
The Siren from Philio (PSE02) is sold as a multi sound device, but to make it play other sounds it has to receive a NOTIFICATION_REPORT. This report is normally sent out from a sensor such as a PIR or door/window-sensor. That means it's possible to e.g. play a Door Chime sound when a door/window-sensor is opened.
When sending a SWITCH_BINARY_SET (which is the default command that will be sent to this device from TellStick ZNet) will only make it play the default emergency sound.
In order to play other sounds, a NOTIFICATION_REPORT has to be sent out from TellStick - that can be done from a Lua-script.
We've put together a script that can send out the NOTIFICATION_REPORT when a device (or dummy-device) is turned on, it's available here: https://github.com/telldus/tellstick-lua-examples/blob/master/zwave/Philio/Siren.lua
Each day more people from all over the world are discovering Telldus Live! We want Telldus Live! to be as welcoming as possible for everyone. That's why we want Telldus Live! to be available in your language. Maybe you can help us with this? If you are interested in translating Telldus Live!, we can offer you a Pro subscription for a year, and continuing as long as you keep the translations up to date.
We are now especially looking for translations into
Norwegian, Finnish and German, but other languages are also of interest.
Telldus Live! is already available in English, Swedish, French, Polish, Croatian and Danish.
If this sounds like something for you, please write to fredrik.gullberg@…
We are about to release the IFTTT channel. It will hopefully be released at the end of next week, if all remaining tests performed by IFTTT will pass.
We will initially only release this for Pro users. Non pro users will have access to the IFTTT channel in may 2017.
Q: My triggers are delayed before they are executed.
A: This is due to how IFTTT works. IFTTT is requesting the status from our servers regularly. This means that the trigger can be up to one hour delayed.
Q: My sensor triggers are not triggered
A: To get sensor triggers to work the sensor must have history enabled on it. Try enabling history on the sensor first.
Q: My triggers are triggering twice
A: The triggers from IFTTT are requesting the device/sensor history. If the sensor have reported a value twice since last update the trigger will also trigger twice
Q: My sensor trigger is constantly triggering while the temperature is above the threshold. I am getting a lot of notifications!
A: For each value the sensor is over the threshold the trigger will continue to trigger. For a notification that only fires once, please use regular events instead.
Update: The channel is now released.
The Aeon Labs Minimote is a nice looking remote control for Z-Wave devices. It might be a little hard to understand the manual and the scenes and associations described though.
This remote control does not support normal association where the main controller can set the nodes in association groups. Instead this is done on the remote control itself.
The remote control can only control devices that uses Switch Multilevel and Switch Binary, that means most dimmer and most on/off devices.
To make this device control other devices set it up by following these steps:
- Include it into the Z-Wave network: Add a new device in Telldus Live! Press the Learn-button on the remote control
- Press and hold the button you like to configure - the blue led will flash after 1 sec.
- While still holding the button, make the device you want to control send out it's Node Information Frame. The blue led will stay steady blue.
- Set the dimmer level or the on/off-state you want the button to set.
- Release the button.
One of the most requested features we get is to connect to the popular service IFTTT. For a long time we have tried to convince IFTTT to connect their awsome service with us. They never replied so we asked you, our users, to also ask them. Our plan was that when enough people requesting Telldus support they might listen. And they did!
We are very pleased to announce that Telldus is getting a channel in IFTTT!
What is IFTTT? IFTTT is a service that allows many different services to communicate with each other. That means Telldus products will be able to control any other service also connected with IFTTT. At the moment I am writing this IFTTT has support for over 300 channels. So at once you can combine Telldus products with Philips Hue, SmartThings, Netatmo, Nest, and more!
What can I do? You can do a lot. But here is some examples to get your imagination going:
- When an astronaut enters space, ring my bell.
- When I plug in my phone to the charger at night, turn off all lights in the house.
- Log my sensor data to a Google spreadsheet.
- When someone rings on my doorbell, tweet about it.
- When I leave home, lock my door.
Since we are still developing this channel we are not yet ready to launch it yet. But we would really like to have some testers. We have reserved 50 spots in a beta test for this. Since there is limited number of spots in this test they will be reserved for Pro users.
We are very excited to announce a brand new feature for the Telldus Live! mobile app: Push Notifications as an action to an event! Initially this is available only to Pro members, though will be released to all users after the summer. To add a push notification to an event, visit http://live.telldus.com
Please contact our support if you encounter any issues or have questions about this or any other feature in our products.
We are happy to announce an update for the Telldus Live! mobile app! Among some of the new exciting features is translations in Swedish and Norwegian, an addition we know will please many of our users, more translations are coming. After feedback from our users we have extensively developed the dimmer slider. Test it by pressing and holding on a button for a dimmable device in the dashboard or device list.
In the recent releases, including this one, we have focused a lot on the connectivity between the app and your TellStick. Your feedback has been very valuable and we encourage you to continue to give feedback on the app and all of our products. It all comes down to the fact that we want to give you the best experience so that you can reliably and conveniently interact with your Smart Home. We are continually investigating ways to improve the reliability of the connection, even if you are at home, in your summer cottage or laying on the beach in the Bahamas, you can be in control.
Telldus Live! is now available in Polish!
If you see any strange translations, please let us know.
We have just released a well requested feature, hiding of devices.
Many Z-Waves support multi channels. This means that one device may have several devices in Telldus Live! This is for instance in-wall receivers with dual relays, power strips and others. Sometimes you don't need all nodes a Z-Wave device may offer and those devices will then clutter the interface.
By hiding unused devices it is also possible to prevent controlling of sensitive devices by mistake.
A new api-call has been added, device/setIgnore. This works exactly the same as for sensors. Ignored devices are not returned by devices/list. Just as sensors/list there is now a parameter includeIgnored to retrieve all devices.
The Fibaro Motion Sensor is a really nice and small PIR with additional temperature and light sensor.
The light and temperature sensor reports are turned off by default, to activate them you'll need to set configurations 42 to 64 to desired values.
Keep in mind that this is a battery operated sensor and that it will drain more battery to send sensor values more often. Select values so that you get the reports as often as you need them.
The temperature sensor report will only be sent if the temperature differs more than the value set in configuration 60. If the temperature is very steady and the value of configuration 60 is set to eg. 1 degree, the report will be sent very rarely.
The settings will not be sent to the sensor when you press save since it's sleeping most of the time. The settings will be sent automatically on next wake up or if you wake it up manually by pressing the button three times quickly.
Regarding the wake up time, this setting should be set to a low value when you are setting up the device in order for it to wake up often and receive new settings. But after that is done you should set it to only wake up rarely to reduce the battery consumption.
The Aeon Labs Key Fob is a nice and small remote control for Z-Wave devices, it might be a little hard to understand the manual and the different modes it has though.
In order to make it easier to use, we've put together a small guide on how to include and configure this device.
The Key Fob can act as a Primary Controller if you don't have an existing Z-Wave network, but we will include it into the TellStick ZNet Lite Z-Wave network.
Start by add a new device in Telldus Live!. Use a pin or paperclip and push the learn button located on the back side of the Key Fob.
Give the new device a name.
Until now, the Key Fob has been in the Setup mode. Now we need to change the mode to Use Mode.
Use a pin or paperclip and push the learn button and the mode button for 3 seconds.
The LED will light up red for 3 seconds and then green for 1 second, confirming the mode change.
Since TellStick ZNet Lite does not support Z-Wave Scenes at the moment, we'll need to use the group mode to control devices.
Group mode is the default mode. To check the current mode, click on the device in Telldus Live!, click Edit device, Click Configuration, Click Advanced settings, check configuration number 250, it should be set to Group mode.
Now it's time to select a device to control from the Key Fob.
The device you wish to control needs to be included to TellStick ZNet Lite.
Depending on the mode of the device when it's paired with the Key Fob, the button will act as follows:
ON - Toggle the device
OFF - Turn off the device
DIM - Toggle dim on the device.
Press and hold the button on the Key Fob that you wish to use.
Start learn mode on the device. Please refer to the manual if you're unsure how to do this.
Release the button on the Key Fob.
If the device is controlled using the same button as start learn mode, you'll need to set the correct state before you start the learn mode.
Many switches start learn mode by pressing three times on the button that also controls the device.
When pressing three times, the status will also change three times. Make sure the device is OFF before starting learn mode if you want the Key Fob button to toggle the device.
We are now introducing the ability to export sensor data for beta users. This is your data, so you should be able to do what you want with it. Head over to http://live.telldus.com/sensor/index2, open up the sensor graph, update it with the interval you are interested in and press "Export range". The data will be exported to a CSV-file.
Just as in the graph we are at the moment limiting the exports to 5000 data points, but you can of course choose a new range and export again if not all data is included the first time.
The time is displayed as a unix timestamp. If you want to convert them to readable dates, you can use this algorithm for each timestamp, and then change the format of the cell to "date": =A2/86400+25569 (assuming the timestamp is in A2, this is tested in Libre Office, might be a bit different in Excel)
We know that this is a highly anticipated feature, and we hope you'll find it useful. If you discover any problems with it (it's still beta), let us know.
If you are not a beta user already, please sign up for all functions and consistent values: http://developer.telldus.com/blog/2015/03/24/sensor_history_beta
For you using the beta, we have now added a (very) basic time interval setting.
Just enter two dates to change the range in the graph. Right now we are limiting the data to a few thousand measure points, so you might not be able to view the whole selected interval in the graph. Since we are storing fewer data points further back in time (every third hour vs every 5 minutes), you might for example be able to see the graph for a whole year two years back, but only a few months back at a time if you start from today, since the number of data points is the same.
To access this function you need to use the new test version of the sensors-page, available at http://live.telldus.com/sensor/index2
If you find any problems, except from design issues, with the graph or the index2-page (it should load much faster), please let us know.
Remembering those sweet summer days...
If you are not using the beta yet, it's still possible to sign up here: http://developer.telldus.com/blog/2015/03/24/sensor_history_beta
A while ago we announced our new platform. But we did not tell you that much about our upcoming products. It's now time.
Let’s start with the new generation TellStick. Before starting developing the new generation of products we really listened to you. We wanted to take the TellStick you love and make it even better. With almost 10 years of feedback from our community we have received many great ideas and suggestions.
Our new model of TellStick is named TellStick ZNet Lite. Just as TellStick Net this is a standalone unit that connects and is controlled from Telldus Live! We have included a Z-Wave chip so it can communicate with over 1000 Z-Wave certified products. Since many of you already have a home full of 433 products and switching everything to Z-Wave is nothing you do over night, we have also included a 433 transmitter. This means you can still control all your existing 433 products and still leverage all the benefits from new Z-Wave products.
We know some of you don't always have a stable internet connection and relying on a steady connection is not always possible. That is why TellStick ZNet Lite runs all schedules and events offline. That means that even if you lose internet connectivity the schedules and local events will still run as nothing happened. Skipping the extra roundtrip to the servers also makes them a lot faster. With Z-Wave being a faster protocol than 433 to begin with, the events really come to their full potential when they are run locally.
We will also release another model, called TellStick ZNet Pro. This one has all the features from TellStick ZNet Lite and we have also included a 433 receiver to receive signals from 433 sensors. It is as easy to control as the TellStick ZNet Lite, but is also perfectly suited for all you hackers out there. With this model you will be able to run your own plugins and code directly on the device.
This products is aimed to be fully hackable.
- Do you want to support more than just 433 and Z-Wave? Develop your own plugin. We will provide samples to integrate both Philips Hue and Belkin WeMo.
- Do you not like our software at all? Don't worry. Use the sdcard option to boot your own linux distribution and run whatever software you like.
- Missing some hardware? We added a usb host option so you can extend it even further.
Both TellStick ZNet Lite and TellStick ZNet Pro are, with a built in web server, prepared for local control in the future.
In addition to our new gateways we are also releasing our very own Z-Wave On/Off receiver and a door/window sensor. Just as the gateways, both hardware and firmware are developed and designed by ourselves, so that we have full control of all functions.
Edit: Available for preorder at m.nu here: https://www.m.nu/telldus-znet-lite-forhandsbestallning-preliminar-leverans-september-p-2341.html
We are looking for testers for one of our Z-Wave based TellStick. This is not the final hardware and might be disabled when this test is complete. After this test period, an upgrade program to the final hardware will be available.
This TellStick has the following specifications:
- Z-Wave EU controller
- No 433 MHz is available
- Requires an internet connection
We are looking for testers for the software and platform. These are our requirements:
- You need to have your own Z-Wave accessories since we have no possibility to supply this.
- We expect a report at least once a week on your experiences.
After signing up please send an email to mp@… and motivate why you should be accepted in this test.
There is only 4 pieces available for this test so be sure to motivate well why you should be chosen.
Interested? Please sign up.
THIS BETA IS CLOSED.
With a guide it will be easier and clearer
More and more devices are supported in Telldus Live! We think that is very pleasant! But at the same time it has made it somewhat difficult to identify the correct accessory that you want to add to your smart home system. That is why we have made a completely new guide.
This enhancement means that you will identify your device much easier by brand and pictures of each device. In the last step you will get a step-by-step guide of how to install that specific device into your smart home system. So now you can almost skip reading the the manual how to install the device.
Just follow the guide in Telldus Live! and you will make no mistakes.
One of the most requested features is the possibility to view sensor values over time. Did the temperature at any point go below 0°C last night? How much does the temperature in my fridge fluctuate? How humid was it in my basement in August compared to June?
We are now launching a closed beta where you can follow your sensor history. Sensor history is mainly a Pro-feature, so while the stored values are only saved every 10 minutes and kept for 2 hours for non-pro-users, they're stored much longer for Pro-users. For Pro-users, incoming values are saved with 5 minute intervals for one month, 15 minute intervals for three months, 1 hour intervals for a year, and every third hour a value is stored with no expiration date at all. These limits may change in the future. In the beginning of the beta it will however only be possible to view values from a week ago in any case.
Temperature, humidity, rain and wind values are stored. The total rainfall and wind direction is not presented in a sensible way yet, but it's kept for future use. For Z-Wave, power consumption and luminescence sensors are also included.
If history should be kept or not is set per sensor and is off by default for all new sensors. Max and min values are recorded for all sensors though.
If you are interested in joining the beta please note this first:
- Beta is only available for Pro-users
- The sensor history might be purged without warning if necessary for development reasons
- Beta users will be using a completely different storage system for all sensor values, and even if the system has gone through a lot of testing there might still be issues that could effect ordinary sensor viewing or event executions. If you got important sensor events the beta perhaps isn't for you. However, it's always possible to change back to non-beta, should there be any problems.
- The sensor values in Telldus Live! are right now only viewable from the last week, even if there actually might be history stored from a year back. They are displayed in a very rudimentary graph right now (see picture below), where scales or time frames cannot be set. But it's possible to access all history using a new API function.
Interested? Please sign up here.
[EDIT] Since all beta slots now is taken, it's possible to access the sensor history beta by navigating to: http://live.telldus.com/sensor/index2 to activate/access the sensor history without applying for a beta slot.
Many sensor models report their battery status (for example Oregon Scientific and Mandolyn). In an upcoming server upgrade we're starting to show this in Telldus Live! for sensors reporting it to TellStick Net. An icon to the right indicates the status.
Typically "battery low" is reported when there is 10% capacity left in the battery, but how much longer the battery will actually last is totally dependent of the sensor type.
There is no event associated with low battery.
This is a slow rollout, so you'll see the battery status depending on if the server your TellStick Net currently is connected to is updated or not.
The battery status is now also included in the sensor/info and sensors/list API call. Possible values are:
0-100 - percentage left, if the sensor reports this
253 - battery ok
254 - battery status unknown (not reported by this sensor type, or not decoded)
255 - battery low
At the moment, all supported sensors only reports "low" or "ok". The percentage left is reported by some Z-Wave devices however and will be used in the future.
For the last two years we have been working hard on the next generation of TellStick and accessories. It is time for us to present our next step.
One of Telldus main philosophies is that we don't want to lock our users into a one company closed down solution, limiting what products to use and how to extend it further. This thought is the foundation of the TellStick family. We want the user to be able to reuse the products in their home and freely choose what products to purchase to extend the smart home. When we started to work on the TellStick over eight years ago the (Swedish) market consisted nearly exclusively of 433 MHz products. Therefore the choice for communcation in the first TellStick was easy.
Some years have since then passed and the market has evolved. The needs are no longer the same as it where. We have thoroughly followed the development of the "Smart Home" and "Internet of things" areas to find out what the best next step is for Telldus. We still strongly believe that interopability is the key. We will never be able to solve everybodys needs ourselves. Instead we want you to freely choose between different vendors and products.
Therefore, we believe, the next step for us is Z-Wave.
Let us first explain what Z-Wave is and what it can do for you.
Z-Wave is a communication standard developed by the company Sigma Designs. Sigma Designs does not develop nor sell any own products. Instead they focus on the communication technology and let other companies use this standard for their products. In order for a company, like us, to be able to use this standard we must also guarantee compatibilty with all other producs on the market also using Z-Wave.
Different companies specialize in different areas. Z-Wave allows all these to talk the same language and communicate each other. Each company can focus on their area of expertise and what they do best, thermostats, garage port openers, or water leakage detectors.
This is one reason why we strongly believe in Z-Wave.
Another benefit is that Z-Wave has two way communication. Any command sent will be acknowledged by the receiver, ensuring the command actually was received by the receiver and resend the signal when needed. The receivers themselves can also act as a repeater and repeat the signal and extending the range even further.
Since about a year Telldus has been a member in Z-Wave Alliance. Z-Wave Alliance is a cooperation between the companies developing Z-Wave products. It aims to help companies ensure the interoperability between all the products using the Z-Wave logo.
What about the 433 MHz products, you may wonder?
We still believe in 433 as well. The 433 products are more affordable and easier to find in the market. For a lot of applications there is no need for Z-Wave. We will continue to support 433 and we are working on products with both 433 and Z-Wave. This way you will be able to mix and match what products fits you the most. And you will be able to use 433 and Z-Wave together in your home.
We have been developing both next generation TellStick as well as new accessories. We are now ready for testing and we will soon start looking for anyone wanting to help us test our new system and new products. Please keep an eye on this blog for beta-announcements in the near future.