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.
On the new device
- Open the Zendo app.
- On the welcome screen, press and hold the Zendo logo to enter pairing mode. On a wall panel, tap “Get Started” instead.
- On “Activate This Device”, tap “Continue”.
- Grant location permission if prompted (required to detect your Wi-Fi network).
- 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.
- Keep this screen open until pairing is complete.
On the active device
- Tap
- Tap “Settings”
- Tap “Control Panels”
- Tap “Add Device”, then “Continue”.
- Grant location and camera permissions if prompted.
- Scan the QR code shown on the new device.
- “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”.
- 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”.
- 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.
- Zendo gets the device ready and sends it to the new device. When “Continue on the New Device” appears, tap “Done”.
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.
Use a setup link instead
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.- Tap
- Tap “Settings”
- Tap “Control Panels”
- Tap “Set Up via Link”.
- Tap “New Setup Link”.
- On “Choose Device Group”, tap the device group the tablet will join, or tap “New Device Group” to create one.
- 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.
- 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.
- Open the link on the tablet.
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.
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.