redphx / ultimate-magic-cube

Unlocking the full potential of Mi/Aqara Magic Cube with Home Assistant & Node-RED

Ultimate Magic Cube

Unlocking the full potential of Mi/Aqara Magic Cube with Home Assistant & Node-RED.

How it works:

• Everything is fully customizable.
• I don't think it's possible to do without Node-RED.
• Unlike normal usage, you'll need to do an activation gesture first (you don't have to worry about triggering commands by accident when moving the cube around).
• Each activation gesture enables a set of commands.
• The cube will be deactivated after X seconds of inactivity (default is 10s). Or you do a slide gesture to deactivate it immediately. All states will be reset.
• Info of the current action/last action are stored in $flow.cube (this info will be deteled when the cube is deactivated).

{
  "activated_mode": "shake",
  "current_action": {
    "gesture": "flip90",
    "detailed_gesture": "flip_1_2",
    "last_side": 1,
    "current_side": 2
  },
  "last_action": {
    "gesture": "rotate_right",
    "detailed_gesture": "rotate_right",
    "last_side": 1,
    "current_side": 1
  }
}

Setup

Import ultumate-magic-cube.json file to your Node-RED project (it's recommended to create a separate flow/tab for it). Edit your cube's ID in Prepare message node.
I'm using deconz_event event to listen to the cube. If you're using ConBee II or something similar then you can ignore this. Otherwise you'll need to make sure events & gestures pass to Parse event are in this format:

{
  "event": 1002,
  "gesture": 3,
}

With:

• event: number of the event.
• gesture: number of the gesture (not string).
  • 1: SHAKE
  • 2: FREE_FALL
  • 3: FLIP_90
  • 4: FLIP_180
  • 5: SLIDE
  • 6: DOUBLE_TAP
  • 7: ROTATE_RIGHT
  • 8: ROTATE_LEFT

How to add/remove activation gestures:

1. Edit $flow.CUBE_ACTIVATION_GESTURES value in the Setup Gestures node. Supported gestures are available in the Context Data window.

2. Add/remove these gestures in the Check activated gesture node.

Supported gestures:

• WAKE_UP: Cube wakes up from sleep. Trigger by the cube itself.
• SLIDE: Slide. Reserved for deactivating the cube, but you can change/remote if you want.
• SHAKE: Shake.
• FREE_FALL: Fall.
• DOUBLE_TAP: Doble Tap.
• FLIP: Flip 90/180 degrees. Use this when you don't care about the sides.
• FLIP_90: Flip 90 degrees.
• FLIP_180: Flip 180 degrees.
• ROTATE_LEFT: Turn counter clockwise.
• ROTATE_RIGHT: Turn clockwise.

Replace X, Y with the side's number (1-6) if you want to be more specific.

• DOUBLE_TAP_X: Double Tap on side #X.
• SLIDE_X: Slide the cube when side #X is up.
• FLIP_X_Y: Flip the cube from side #X to side #Y.

My example setup: https://youtu.be/nm5i1GbjaZQ

1. Slide = deactivate cube
2. Shake = control Spotify
   • Shake: play random playlist
   • Flip 180: play on soundbar
   • Double tap: play/pause
   • Rotate right: next track
   • Rotate left: previous track
3. Double tap Aqara side (#1) = control lights
   • Shake: randomize colors
   • Flip 90: toggle night light mode of ceiling light
   • Double tap: toggle lights
   • Rotate right: brightness up
   • Rotate left: brightness down
4. Double tap any other side = control TV/Soundbar
   • Double tap: toggle TV on/off
   • Rotate right: soundbar volume's up
   • Rotate left: soundbar volume's down