Skip to main content

Intro

Add Device lets you add a new device to your Zendo by scanning a QR code and pairing over your local network. There’s no link to share, no email to send, and no credentials to type. It’s for devices that belong to your property rather than to one person, such as wall-mounted tablets and tablets on a stand. Each one joins a device group, which decides the accessories it shows. It’s also quick for setting up several devices in a row - just scan the QR code on each device. To add someone’s own phone or tablet, invite them instead.

How it works

Two devices are involved:
  • New device - the device being added to your Zendo.
  • Active device - a device already set up on your Zendo that will pair the new one.
The active device scans a QR code displayed on the new device. Both devices authenticate each other over your local network, then the active device securely sends the new device what it needs to join your Zendo - all without leaving the room.

On the new device

  1. Open the Zendo app.
  2. On the welcome screen, press and hold the Zendo logo to enter pairing mode. On a wall panel, tap “Get Started” instead.
  3. On “Activate This Device”, tap “Continue”.
  4. Grant location permission if prompted (required to detect your Wi-Fi network).
  5. A QR code and a 6-character verification code appear, with a reminder of where to go on the active device: “Settings”, then “Control Panels”, then “Add Device”. The screen stays awake while waiting.
  6. Keep this screen open until pairing is complete.

On the active device

  1. Tap
  2. Tap “Settings”
  3. Tap “Control Panels”
  4. Tap “Add Device”, then “Continue”.
  5. Grant location and camera permissions if prompted.
  6. Scan the QR code shown on the new device.
  7. “Ready to Pair” shows the new device’s name, type, and verification code. Verify the code matches what’s displayed on the new device, then tap “Continue”.
  8. On “Choose Device Group”, tap the device group the new device will join. To create a device group, tap “New Device Group”, enter a Name and tap “Continue”.
  9. If Zendo asks you to log in to your Home Assistant/Homey, tap “Log In Now” so the new device can use your Zendo straight away. On “Automatic login”, you can tap “Log In on the Device Later” instead, to log in on the new device. A wall panel can’t log in itself, so for a wall panel Zendo shows “Log in to activate”, and you need to log in now.
  10. Zendo gets the device ready and sends it to the new device. When “Continue on the New Device” appears, tap “Done”.
The device group decides which accessories the new device shows on the floorplan and in the Tiles view. See Choose what a device group shows.

Back on the new device

The device activates automatically. Follow the on-screen instructions to complete setup. If the new device replaces an old one, such as a broken tablet or an older wall panel, replace the old device once it’s set up, from “Control Panels” on your phone or tablet. Your automations then control the new device with no changes, and the new device takes on the old device’s settings and admin code. Replace a Device is available if an installer set up Zendo at your property. Otherwise, change your automations to control the new device.

Requirements

  • Both devices must be on the same Wi-Fi network.
  • The network must allow devices to communicate with each other (client isolation must be off, multicast must be allowed). Connections across VLANs may not work.
  • Both devices need internet access to complete onboarding.
  • A wall panel must be on its own network, so connect the active device to that network while you pair. See Network security.

If the two devices can’t reach each other, for example because your network stops Wi-Fi devices from communicating with each other, you can add a tablet with a setup link instead. The tablet joins the device group you choose, just as it would with Add Device. The link needs to be opened on the new device, so this works on a tablet. A wall panel can’t open links: add it with Add Device.
  1. Tap
  2. Tap “Settings”
  3. Tap “Control Panels”
  4. Tap “Set Up via Link”.
Then create the link, and open it on the tablet:
  1. Tap “New Setup Link”.
  2. On “Choose Device Group”, tap the device group the tablet will join, or tap “New Device Group” to create one.
  3. If Zendo asks you to log in to your Home Assistant/Homey, tap “Log In Now” so the tablet can use your Zendo straight away, or tap “Log In on the Device Later” to log in on the tablet instead.
  4. Zendo creates the link and opens your device’s options for sharing it. Send the link somewhere you can open it on the tablet, such as an email or a message.
  5. Open the link on the tablet.
A setup link works like an invitation link for a person, except that it only works for 24 hours, or until you delete it. You can open it on more than one tablet in that time, they’ll all join the same device group. “Set Up via Link” lists the setup links that haven’t expired, under their device group’s name. Tap one to see when it was sent, when it expires and how many times it’s been used. Tap “Delete Setup Link” to stop it working.

Security

The pairing process uses mutual authentication and encryption:
  • The QR code contains a one-time passcode used by both devices to authenticate each other. It is never sent over the network.
  • All communication after the initial handshake is encrypted.
  • Each session uses unique encryption keys (forward secrecy).
  • An eavesdropper on the network can’t recover the passcode or decrypt the session.
The QR code is only valid for a single pairing session. Once used or dismissed, a new code must be generated. Keep the QR code private - anyone who can see it can use it to pair with the device.
Add Device follows a similar approach to the Matter smart home standard, using SPAKE2+ for secure device commissioning.

Troubleshooting

  • Can’t connect - make sure both devices are on the same Wi-Fi network. The QR code screen shows the network name so you can verify. If they still can’t reach each other, use a setup link instead.
  • Connection drops - check that your router doesn’t isolate Wi-Fi clients from each other.
  • No internet - both devices need internet access to complete onboarding. Make sure they are connected to a Wi-Fi network with internet access.