Aqara Magic Cube Zigbee2MQTT MQTT Triggered - 2024-06-02 by SirGoodenough
This Blueprint uses a Zigbee2MQTT built sensor to sort out the 38(+54) unique commands available from the Xiaomi Magic Cube Remote. (Some unique commands are available thru templating only. See the related document.)
The split out of functions gives you the ability to assign local scripts or functions to do the things you want the remote to do.
Functions that are left empty will simply do nothing.
๐ There is a set of 36 event functions that will trigger on specific actions on specific sides that are listed as Group 1 actions ๐.
๐ There is a set of 6 event functions that will trigger on specific actions on ANY side that are listed as Group 2 actions ๐.
๐ There is a set of 30 event functions that will trigger on cube flips to & from specific sides that are listed as Group 3 actions ๐.
๐ There are 2 actions (shake and drop) that only occur once and are OK to be combined with any other group. Listed as Group 4 sections ๐.
Please be aware that ALL actions except the Group 4 actions ๐ will trigger an action in ALL 3 groups at the same time every time. Therefore I suggest if you just have a couple of things you want this remote to do that you choose the ANY / Group 2 / ๐ events.
If you want more than a few events, you should select actions in Group 1 / ๐ OR Group 3 / ๐.
Group 4 actions ๐ will not affect others.
With careful selection you can use mixed groups, but you run the risk of a single cube action triggering more than 1 Home Assistant action and making a mess of things ๐ฑ.
NOTICE: This cube can be triggered 124 ways, but only 38(+54) of them are unique (with templating).
There is sample code to make the template sensor in the help file on GitHib named Zigbee2MQTT - Xiaomi Cube Controller MQTT Triggered.md & in the community page related to this.
Within this blueprint there is an event handler that will latch the last command that the blueprint finds and sends that to the event buss. From there a simple Template sensor can grab it and show you the last action sent. Thie will help when setting up new functions and to troubleshoot strange behaviours.
This was forked from https://community.home-assistant.io/t/z2m-xiaomi-cube-controller/263006 1.2 project authored by luckypoppy and the friends he pulled together to create the base. I sincerely thank Him (Them) for their work. I felt there needed to be more documentation for rookie users to properly set this up. I had quite a few questions and when I saw a few questions in that chat from people struggling, I wanted to help. I also had a better idea for troubleshooting info.
Community link for this blueprint
๐ฟNotice๐ฎ๐ฟโโ๏ธ:
-
Copies of the original Blueprint that were converted via the 'Take Control' feature or other means are officially not supported by me.
-
I may or may not be able to support you when you have a problem after you make changes to my code, as some of the code is no longer mine.
-
I & my license also require attribution as a link back to the original should you use this code in your own creation.
-
Here is a link to my license & the original github post expected to be followed & referenced as attribution should you use this code elsewhere.
Import to Home Assistant
Click to import this blueprint directly into your Home Assistant instance.
Configuration
Requires 16 inputs to configure
Source Code
View on GitHubDetails
Related Blueprints
More button actions automations you might like