add ikea Tradfri shortcut button support

[joten75]

Feature request type

add support for ikea shortcut button

Description

Considered alternatives

Additional context

[ebaauw]

Missed that one. Google reveals a number of news articles from around June, mentioning that the shortcut button was spotted in the Netherlands online store, but I cannot find it. Where (in which country) did you buy it? I've been trying to get a standalone open/close remote (for my Xiaomi curtains controller); IKEA customer service mentioned it's listed in their database, but not yet available to customers. They seem to have some challenges in getting these devices ready for mass distribution.

I'd prefer to get my hands on this device myself, but, in the meanwhile, can you provide the following info:

1. The new items suggest it only supports a single action, to recall a scene. It is physically like the on/off switch and open/close remote, with two pushable areas, or indeed just a single pushable area?
2. Could you please read each attribute in the Basic cluster (using the Attribute Editor popup window if needed) and make another set of screenshots. I'm particularly interested in ZCL_Version, Date Code, Product Code, and SW Build ID.
3. The device fingerprint is a spitting image of the on/off switch, except that the server 0xFC7C cluster is missing. Unfortunately, it gives no clue how the button works. It's missing a client Scenes cluster as well as a server cluster for attribute reporting. My guess is it would use On/Off and/or Level Control commands and direct bindings to the Trådfri Hub. The Hub then generates the commands for enacting the (non-Zigbee !) scene, similar to how the SYMFONISK controller works: the Hub translates Move to Level to Sonos API calls. The concept would be very similar to deCONZ and Hue bridge rules. Do you have a Trådfri Hub? If so, how does the IKEA Home Smart app configure the "scene"? Could you post any screenshots?
4. Could you run deCONZ with --dbg-info=2 and see what "No button event" messages appear, including the asdu of the preceding APS-DE.indication message? Make sure to try single click (press and release quickly), press & hold, and release after holding.

[joten75]

it's a single click button. like the xiaomi round button. I don't have ikea hub sorry.

I bought it in Italy two months ago.

[Mimiix]

Swapped labels.

[MattWestb]

Was looking on ikea.it but cod not finding it online :-(
Not one big problem then can't going over border without 14 days "forced extra hallyday".

The PCB is one slimmed (one button less) of the On/Off dimmer / Open/Close switch from FCC-ID.

The PCB layout is nice like the the big brothers and can easy being modded to one Zigbee sniffer or one EZSP Coordinator in 5 minutes :-)))))

[joshua-schnabel]

I got the button (or even three) at IKEA Germany (Karlsruhe). The button is not listed by Ikea. It is also not listed on the OTA page (http://fw.ota.homesmart.ikea.net/feed/version_info.json). @ebaauw below you will find the information you are looking for. This is a different tool I used but I stumbled over the issue during my research and thought I share my information.

Zigbee2MQTT:debug 2020-11-02 21:46:56: Received Zigbee message from '0x680ae2fffe34c590', type 'readResponse', cluster 'genBasic', data '{"modelId":"TRADFRI SHORTCUT Button"}' from endpoint 1 with groupID 0
Zigbee2MQTT:debug 2020-11-02 21:46:56: No converter available for 'E1812' with cluster 'genBasic' and type 'readResponse' and data '{"modelId":"TRADFRI SHORTCUT Button"}'
Zigbee2MQTT:debug 2020-11-02 21:46:58: Received Zigbee message from '0x680ae2fffe34c590', type 'readResponse', cluster 'genBasic', data '{"manufacturerName":"IKEA of Sweden"}' from endpoint 1 with groupID 0
Zigbee2MQTT:debug 2020-11-02 21:46:58: No converter available for 'E1812' with cluster 'genBasic' and type 'readResponse' and data '{"manufacturerName":"IKEA of Sweden"}'
Zigbee2MQTT:debug 2020-11-02 21:47:00: Received Zigbee message from '0x680ae2fffe34c590', type 'readResponse', cluster 'genBasic', data '{"powerSource":3}' from endpoint 1 with groupID 0
Zigbee2MQTT:debug 2020-11-02 21:47:00: No converter available for 'E1812' with cluster 'genBasic' and type 'readResponse' and data '{"powerSource":3}'
Zigbee2MQTT:debug 2020-11-02 21:47:02: Received Zigbee message from '0x680ae2fffe34c590', type 'readResponse', cluster 'genBasic', data '{"zclVersion":3}' from endpoint 1 with groupID 0
Zigbee2MQTT:debug 2020-11-02 21:47:02: No converter available for 'E1812' with cluster 'genBasic' and type 'readResponse' and data '{"zclVersion":3}'
Zigbee2MQTT:debug 2020-11-02 21:47:04: Received Zigbee message from '0x680ae2fffe34c590', type 'readResponse', cluster 'genBasic', data '{"appVersion":33}' from endpoint 1 with groupID 0
Zigbee2MQTT:debug 2020-11-02 21:47:04: No converter available for 'E1812' with cluster 'genBasic' and type 'readResponse' and data '{"appVersion":33}'
Zigbee2MQTT:debug 2020-11-02 21:47:06: Received Zigbee message from '0x680ae2fffe34c590', type 'readResponse', cluster 'genBasic', data '{"stackVersion":98}' from endpoint 1 with groupID 0
Zigbee2MQTT:debug 2020-11-02 21:47:06: No converter available for 'E1812' with cluster 'genBasic' and type 'readResponse' and data '{"stackVersion":98}'
Zigbee2MQTT:debug 2020-11-02 21:47:08: Received Zigbee message from '0x680ae2fffe34c590', type 'readResponse', cluster 'genBasic', data '{"hwVersion":1}' from endpoint 1 with groupID 0
Zigbee2MQTT:debug 2020-11-02 21:47:08: No converter available for 'E1812' with cluster 'genBasic' and type 'readResponse' and data '{"hwVersion":1}'
Zigbee2MQTT:debug 2020-11-02 21:47:10: Received Zigbee message from '0x680ae2fffe34c590', type 'readResponse', cluster 'genBasic', data '{"dateCode":"20190715"}' from endpoint 1 with groupID 0
Zigbee2MQTT:debug 2020-11-02 21:47:10: No converter available for 'E1812' with cluster 'genBasic' and type 'readResponse' and data '{"dateCode":"20190715"}'
Zigbee2MQTT:debug 2020-11-02 21:47:12: Received Zigbee message from '0x680ae2fffe34c590', type 'readResponse', cluster 'genBasic', data '{"swBuildId":"2.3.015"}' from endpoint 1 with groupID 0
Zigbee2MQTT:debug 2020-11-02 21:47:12: No converter available for 'E1812' with cluster 'genBasic' and type 'readResponse' and data '{"swBuildId":"2.3.015"}'
Zigbee2MQTT:debug 2020-11-02 21:50:30: Received Zigbee message from '0x680ae2fffe34c590', type 'commandQueryNextImageRequest', cluster 'genOta', data '{"fieldControl":1,"fileVersion":587290161,"imageType":4550,"manufacturerCode":4476}' from endpoint 1 with groupID 0

type 'commandOn', cluster 'genOnOff'
type 'commandMoveWithOnOff', cluster 'genLevelCtrl'
type 'commandStopWithOnOff', cluster 'genLevelCtrl'

[ebaauw]

Thanks, @joshua-schnabel. Could you also get the commands the device sends when the button is pressed?

@joten75, could you please read the attributes before making a screenshot. Double-click on each attribute for the Attribute Editor popup window and do a Read there; the Cluster Info panel only reads a few attributes on battery-powered devices.

[edvaldocastro]

Hi @ebaauw , I'm facing the same issue, so instead of opening another issue, I'm trying to contribute on this one. Please check if the below is the information you are looking for. (It looks like I cannot read the attributes, but I hope it helps).

"I'm particularly interested in ZCL_Version, Date Code, Product Code, and SW Build ID."

ZCL_Version

Date Code

Product Code

SW Build ID

Unfortunately it looks like most of reading from the attributes have failed, but some of them worked, please see the full picture below.

I hope this helps.

Edvaldo Castro

[SwoopX]

Unfortunately, it doesn't. However, try pushing the button and then immediately read the attributes. The device must be awake the get the read requests.

[edvaldocastro]

Unfortunately I couldn't make it work.. all the readings are failing, I'll keep trying... Let's see if others have more success on it.

[Mimiix]

@edvaldocastro Keep clicking the button when its reading (Both the read button and the button itself).

[t0bse]

any news on this? got two shortcut buttons but can't read them in deconz.
it's listed here now:

http://fw.ota.homesmart.ikea.net/feed/version_info.json

{"fw_binary_url":"http://fw.ota.homesmart.ikea.net/global/GW1.0/01.12.031/bin/10054470-TRADFRI-shortcut-button-2.3.015.ota.ota.signed","fw_file_version_LSB":22065,"fw_file_version_MSB":8961,"fw_filesize":181310,"fw_image_type":4550,"fw_manufacturer_id":4476,"fw_type":2},

i also took a picture of it without the case:

[letszb]

The button is online at ikea DK, Available at 3 of 5 stores and for shipping.
https://www.ikea.com/dk/da/p/tradfri-genvejskontakt-hvid-40356381/

edit 17.12.2020: now also listed in Sweden and Norway:
https://www.ikea.com/se/sv/p/tradfri-genvaegsknapp-vit-40356381/
https://www.ikea.com/no/no/p/tradfri-bryter-hvit-40356381/

edit 23.12.2020: now also listed in Finland:
https://www.ikea.com/fi/fi/p/tradfri-pikanappula-valkoinen-40356381/

edit 04.01.2021: now also listed in Italy and Canada:
https://www.ikea.com/it/it/p/tradfri-pulsante-scorciatoia-bianco-40356381/
https://www.ikea.com/ca/en/p/tradfri-shortcut-button-white-20356382/

edit 11.01.2021: now also listed in France:
https://www.ikea.com/fr/fr/p/tradfri-lanceur-de-scenario-connecte-blanc-40356381/

edit 19.01.2021: now also listed in Netherlands:
https://www.ikea.com/nl/nl/p/tradfri-snelkoppelknop-wit-40356381/

edit 27.01.2021: now also listed in Portugal:
https://www.ikea.com/pt/pt/p/tradfri-botao-de-atalho-branco-40356381/

edit 28.01.2021: now also listed in Austria:
https://www.ikea.com/at/de/p/tradfri-shortcut-button-weiss-40356381/

edit 01.02.2021: now also listed in Germany:
https://www.ikea.com/de/de/p/tradfri-shortcut-button-weiss-40356381/

edit 08.02.2021: now also listed in Morocco, Spain, Switzerland and Belgium:
https://www.ikea.com/ma/en/p/tradfri-shortcut-button-white-40356381/
https://www.ikea.com/es/en/p/tradfri-shortcut-button-white-40356381/
https://www.ikea.com/ch/de/p/tradfri-shortcut-button-weiss-40356381/
https://www.ikea.com/be/nl/p/tradfri-snelkoppelknop-wit-40356381/

[mtjoernelund]

Just bought a couple of these myself. I run Deconz headless, but will try to fire it up in x11 remote and see if I can provide information. First time trying to help implement new devices, so I am a little unsure if it is all information that is still missing or if it is something specific?

[Lemocin]

I manages to read some of the values by deleting and repairing. If you need some other values, please let me know, i will try to read them out!

[ebaauw]

Finally got my hands on one, thanks to Kevin!

It's one of those devices that goes to sleep pretty quickly after pairing, and won't wake up, unless you created a binding within that time.

On pressing the button, it sends an On command to the bound group. When holding the button, it sends a Move with OnOff; direction is always Up and Rate 83. When releasing the button (after hold) it sends a Stop with OnOff. It's really half an on/off switch; we can probably re-use the buttonmap.

The client Window Covering cluster seems to be there just for show. Battery Percentage Remaining is reported in full percentage, as with other IKEA devices. It supports attribute reporting.

It's gonna be a very basic ZHASwitch, with just a 1002 and 1001/1003 buttonevent values.

[ebaauw]

It's really half an on/off switch; we can probably re-use the buttonmap.

This must have been the easiest device I've ever integrated.

$ ph get /sensors/10
{
  "config": {
    "alert": "none",
    "battery": 87,
    "group": "11",
    "on": true,
    "reachable": true
  },
  "ep": 1,
  "etag": "729f204a8ff1827197ab1abb52bc59b0",
  "lastseen": "2020-12-22T21:53Z",
  "manufacturername": "IKEA of Sweden",
  "mode": 1,
  "modelid": "TRADFRI SHORTCUT Button",
  "name": "TRADFRI SHORTCUT Button ",
  "state": {
    "buttonevent": 1002,
    "lastupdated": "2020-12-22T21:53:06.523"
  },
  "swversion": "2.3.015",
  "type": "ZHASwitch",
  "uniqueid": "68:0a:e2:ff:fe:34:91:ec-01-1000"
}

And the group:

$ ph get /groups/11
{
  "action": {
    "alert": "none",
    "bri": 127,
    "colormode": "hs",
    "ct": 0,
    "effect": "none",
    "hue": 0,
    "on": true,
    "sat": 127,
    "scene": null,
    "xy": [
      0,
      0
    ]
  },
  "devicemembership": [
    "10"
  ],
  "etag": "0034c83da5355a6a42c2b6a996456718",
  "id": "11",
  "lights": [],
  "name": "TRADFRI SHORTCUT Button ",
  "scenes": [],
  "state": {
    "all_on": false,
    "any_on": false
  },
  "type": "LightGroup",
  "uniqueid": "68:0a:e2:ff:fe:34:91:ec"
}

Not sure why the endpoint is missing from the group's (probably non-unique) uniqueid.

[martinimarcello00]

Hi, I just installed the update of the latest version (2.09.03) of deCONZ. Theoretically this version should allow the pairingof the Tradfri Shortcut Button by the phoscon webapp (in my case installed on home assistant). I repeatedly tried to connect the new device but every time the connection time runs out and the error "Failed to connect" appears.What can I do in order to pair the device? Thanks for the support.

[mtjoernelund]

I’m on version 2.09.00. I can’t get the shortcut button to show in the Phoscon webapp, however they pair just fine using the old webapp (open wireless light control). Only issue has been that I struggled to rename them in the old webapp. Easily solved using the ph command that comes with ebaauw’s Homebridge-hue plugin.

[al-wi]

Can confirm that pairing is not possible in the webapp with a new shortcut button in version 2.09.03. However you'll find the node in the deconz app:

[Mimiix]

@Elvys8 You need to update as you are on 2.05.79.

[Elvys8]

@Mimiix Thanks for the quick reply. That "The version is up to date" message totally fooled me…
I've been looking on Google for a way to update the Phoscon software on my docker container but couldn't find a tutorial.
I'm assuming it's quite an obvious process but my basic skills don't go that far I'm afraid.
Any idea on how to update the software?
Thanks again!

[Mimiix]

@Mimiix Thanks for the quick reply. That "The version is up to date" message totally fooled me…
I've been looking on Google for a way to update the Phoscon software on my docker container but couldn't find a tutorial.
I'm assuming it's quite an obvious process but my basic skills don't go that far I'm afraid.
Any idea on how to update the software?
Thanks again!

I have no clue either. Check with the docker repo.

[Knuspel]

@Mimiix Thanks for the quick reply. That "The version is up to date" message totally fooled me…

I've been looking on Google for a way to update the Phoscon software on my docker container but couldn't find a tutorial.

I'm assuming it's quite an obvious process but my basic skills don't go that far I'm afraid.

Any idea on how to update the software?

Thanks again!

It is properly explained in the docker repo. Basically you need to stop the container and then run the update script once.

As to pairing the shortcut button. As said before I only was successful with the Phoscon beta accessible through their webservice.

And even then it did not work as a light switch for certain things. I needed it to activate scenes that then turned the light on. Just as an FYI.

[Smanar]

No one with the double event bug can try this PR ? #4265
It can discard double event if it s the same sequence number.

[Elvys8]

I managed to update the docket container. I’m on version 2.10.02 now.
Still no luck, as mentioned by others pairing is not working properly with the Phoscon web app: "Failed to connect".
It does somehow shows up on my Home app via homebridge-hue, but not as a button.

[ebaauw]

It does somehow shows up on my Home app via homebridge-hue, but not as a button

Please open an issue in the Homebridge Hue repo, attaching the debug dump file and capturing and attaching a debug log file. See the Homebridge Hue FAQ on how to do this.

[jonalbr]

I paired the shortcut switch like @Knuspel (phoscon beta) which worked as expected. However the switch does not report the correct battery percentages. It's still stating 0% in Homekit (through Homebridge).
@ebaauw Is this a bug or did I miss something?
Thanks!

[ebaauw]

It's still stating 0% in Homekit (through Homebridge).

How long is "still"? It could probably take a couple of hours after pairing before the switch send the first battery report to deCONZ. Best check in the deCONZ GUI if Battery Percentage Remaining in the Power Configuration cluster is still 0. If it remains 0 after several hours, the binding and attribute reporting haven't been setup properly. Either do this manually (see the User Manual in the GUI) or reset and re-pair the button (without deleting it from deCONZ first).

[Elvys8]

It's still stating 0% in Homekit (through Homebridge).

It took a couple of days for me to show up properly. Same with Aqara buttons and sensors.

[jonalbr]

Thanks for the fast reply @ebaauw and @Elvys8

It's been about two days since pairing. I'll wait a few days and than try the suggested approaches.

[davewatson91]

This still doesn't appear to be working for me - I can't add it through the Phoscon interface. In deCONZ, it shows up as connected, but in HA it only provides a battery status and nothing else..

[Lars-B84]

Have you tried using the shortcut button Blueprint thats available? Op di 13 apr. 2021 11:13 schreef David Watson ***@***.***>:

…

This still doesn't appear to be working for me - I can't add it through the Phoscon interface. In deCONZ, it shows up as connected, but in HA it only provides a battery status and nothing else.. — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <#3495 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AJRFINEVGNHTNVH2CGDDBB3TIQDL3ANCNFSM4S5PCBSQ> .

[davewatson91]

Have you tried using the shortcut button Blueprint thats available? Op di 13 apr. 2021 11:13 schreef David Watson @.***>:
…
This still doesn't appear to be working for me - I can't add it through the Phoscon interface. In deCONZ, it shows up as connected, but in HA it only provides a battery status and nothing else.. — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <#3495 (comment)>, or unsubscribe https://github.com/notifications/unsubscribe-auth/AJRFINEVGNHTNVH2CGDDBB3TIQDL3ANCNFSM4S5PCBSQ .

Thankyou - that does work! - Why can't the shortcut button be treated like any other button in HA?

[psaggiomo]

Hi. Any news about integration?

[Mimiix]

@psaggiomo not sure why you are asking as it is integrated.

If you don't see it in phoscon, check their repository.

[sieren]

Seems to work overall pretty "ok" on my end with the most recent deconz beta.
However it's now showing the battery level at 16% (after only 7 days of use with the stock battery). Is anyone else experiencing this?

[jonalbr]

@sieren I experienced the same. Just ignore it. A couple of uses later it will change to about 80%. I guess IKEA guesses the battery over provided voltages and that fluctuates sometimes.

[sieren]

Thanks for the info! :) Good to know!

[mrclschstr]

Since phoscon beta 2.12.01 it finally works. Just give it a shot!

[LukeDefeo]

Hello I am on the latest non beta version and im unable to get this thing to pair

Ive tried pressing the button 4 times, I see the red flashing light, I get to add switches > other but it doesn't pair.

Ive paired many ikea dimmer switches with this method but can't get it to work with the shortcut button

Any suggestions

Thanks

[ggruening]

As described above, it only works properly with the beta 2.12.01. But you can try to check deCONZ after a supposedly unsuccessful pairing to see whether the button appears. That was the case with me.

[Mimiix]

The device wont show up in Phoscon probably. But it always should in deCONZ.

Even if a device is not supported yet by either Phoscon or deCONZ, it should always show up in deCONZ.

[alundstroem]

I’m on the latest version of Home Assistant (hassio/supervised), using the latest version of the deCONZ addon, and a Conbee II updated with the latest firmware - l’ve added/synced my (one and only) Ikea Tradfri Shortcut button in Phoscon (successfully from what I can tell). Home Assistant lists it as well, I can see the battery level (100%) but it does not work in automations, not by event nor via blueprint from Home Assistant community - what can I do/check to try and resolve this?

[alundstroem]

I’m on the latest version of Home Assistant (hassio/supervised), using the latest version of the deCONZ addon, and a Conbee II updated with the latest firmware - l’ve added/synced my (one and only) Ikea Tradfri Shortcut button in Phoscon (successfully from what I can tell). Home Assistant lists it as well, I can see the battery level (100%) but it does not work in automations, not by event nor via blueprint from Home Assistant community - what can I do/check to try and resolve this?

Hmm, dunno why but after debugging events in Home Assistant (dev tools, events, listen to ”deconz_event”) and not seeing any events for this particular button/switch I removed and te-synced it a couple of times… finally it works as intended. But many times it just registered in Phoscon, showed up in deconz/visible by vnc, but no events… not working when added as a switch to a group in Phoscon either…

Anyways, perhaps helps someone else to know

[ggruening]

Troubleshooting in Home Assistant has become easier (see https://www.home-assistant.io/docs/automation/troubleshooting/), but I still like to use the Node Red plugin in such cases. Here, together with the installed node-red-contrib-deconz and a few debug nodes, you can often get very far... HTH next time.

[alundstroem]

Troubleshooting in Home Assistant has become easier (see https://www.home-assistant.io/docs/automation/troubleshooting/), but I still like to use the Node Red plugin in such cases. Here, together with the installed node-red-contrib-deconz and a few debug nodes, you can often get very far... HTH next time.

Thanks dude, I will remember your suggestions for future issues (; Luckily this issue was quickly resolved