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.

Small update on sensor history



Just would like you to know that we just pushed a small design update to the sensor history.

Beta testers wanted for Telldus Live! mobile

We are now finishing the re-write on our app and we need your help to test it.
Right now there are no new features. We've changed the framework used by the app and basically built it again from scratch.
We're now inviting Android users to test the app. We really care about having active testers, make sure you have some time available to play with the app and to provide feedback.
Sometimes beta softwares are not stable. If you (or your family) prefers to have a stable setup at all time - you better don’t get into BETA testing.
Please sign up here.

IFTTT to the people!

A while ago, we released our IFTTT channel for our PRO users. Now it's time to launch it for all our Live! users. With IFTTT, you can connect a variety of online services such as Spotify and Philips Hue with each other. The possibilities are endless.

Read more about IFTTT  here.

Telldus Live! in Norwegian

Finally! - Telldus Live! is now available in Norwegian!

If you see any strange translations, please let us know.

Philio (and D-Link) multisound siren

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

Looking for translators

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@…

Release of Telldus IFTTT channel

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.

FAQ:
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.

Use Aeon Labs Minimote

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:

  1. Include it into the Z-Wave network: Add a new device in Telldus Live! Press the Learn-button on the remote control
  1. Press and hold the button you like to configure - the blue led will flash after 1 sec.
  1. 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.
  1. Set the dimmer level or the on/off-state you want the button to set.
  1. Release the button.

If patient then success. Finally Telldus+IFTTT=True!

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:

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.

Push Notifications in Telldus Live mobile!

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.

http://developer.telldus.com/raw-attachment/blog/2016/05/30/push-notification/iphone-push-notification.pnghttp://developer.telldus.com/raw-attachment/blog/2016/05/30/push-notification/apple-watch-push-notification.png

Telldus Live! mobile app has been updated!

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.

http://developer.telldus.com/raw-attachment/blog/2016/03/23/my_topic/IMG_2676.PNG

Telldus Live! in Polish

Telldus Live! is now available in Polish!

If you see any strange translations, please let us know.

Hide devices

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.

For developers

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.

Use Fibaro Motion Sensor

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.

To set the interval between light reports, set configuration 42:

To set the settings for temperature, set configurations 60 to 64:

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.

Merry Christmas!

Use Aeon Labs Key Fob

Aeon Labs Key Fob

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.

Sensor data export, beta update

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

Sensor history, small update to 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

New products from Telldus

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.

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

Telldus Z-Wave beta 1

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:

We are looking for testers for the software and platform. These are our requirements:

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.

We are enhancing Telldus Live!

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.