Pairing Yale Conexis Lock and Openzwave

I struggled getting the Yale Conexis smart lock working with the Aeotec Z-Stick Gen5. Turns out the issue is it must be a secure pairing - the default method in the instructions (unplug Z-Stick, press button near to the device, initiate pairing), does not perform a secure pairing, and so even though the device will appear in software, you won’t get any state for it or be able to perform an actions.

How to pair securely

The full instructions for this are here.

It must not be paired to start with, so first unpair if you’ve previously paired it. Put the Z-Stick into exclusion mode by holding for 2s when unplugged (orange fast blink), and then tap 3 times on Yale A button.

  1. Set a SecureKey in /usr/config/options.xml:

    <Option name="NetworkKey" value="0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C, 0x0D, 0x0E, 0x0F, 0x10" />

    Use a random set of 16 hex bytes in exactly the format above - and keep a copy for safe keeping.

  2. Plug in the Z-Stick, and start ozwsh --device=/dev/...

  3. Start pairing in ozwsh (under Controller, run command: add_node True).

  4. Initiate pairing on the Yale lock (press the A button under the top flap quickly 3 times).

  5. Success is indicated by a short beep from the Yale lock, and the device state should correctly show up in ozwsh.