MyHome Passport — Installer Reference Guide

Hardware setup procedures for field installers — keep this page open or print it out

Print

Contents

  1. Device Overview
  2. Shelly EM Gen 3 — Clamp Setup
  3. SLZB-06M — Gateway Setup
  4. Frient — Sensor Pairing
  5. Troubleshooting
📋

Device Overview

What each device does and what you need before you start
Shelly EM Gen 3
Clamp meter
ProtocolWiFi → HTTPS
Reports toMyHome server (webhook)
Config methodLocal web UI + Script
Reporting intervalEvery 60 seconds
NeedsProperty WiFi password
SLZB-06M
Zigbee gateway
ProtocolZigbee → MQTT → TLS
Reports toMyHome MQTT broker
Config methodLocal web UI (192.168.4.1)
AP hotspot nameSLZB-06M (no password)
NeedsWiFi credentials + MQTT settings

Frient Smart Climate Sensor
Zigbee sensor
ProtocolZigbee (via SLZB-06M gateway)
MeasuresTemperature, humidity, CO₂, VOC
Pairing methodButton hold (3× LED blink)
Range~10–15 m line-of-sight from gateway
ℹ️

Before you start: Register the property on the platform and create rooms for each occupied space. The app will generate a unique webhook URL for each Shelly EM — you need this during setup. Get the MQTT broker credentials from the admin panel before going on site.

Shelly EM Gen 3 — Clamp Setup

WiFi-connected current clamp. One per circuit to monitor.
1
Register the device in the app
Open MyHome Passport → Sensors tab → Add Clamp. Enter a display name (e.g. "Flat 4 – Heat Pump"), the component being monitored, and the Shelly's device ID (found on the label or under Device Settings → Device Info in the Shelly app — looks like shellyem3g-AABBCC). Tap Register — the app will generate a webhook URL for you. Copy it.
2
Connect the Shelly to property WiFi
Power up the Shelly EM. Use the Shelly app to connect it to the property's WiFi network, or connect to its AP hotspot and configure WiFi via 192.168.33.1.
3
Open the Shelly local web UI
Connect your phone to the same WiFi as the Shelly. Find the device's local IP in your router's DHCP table or the Shelly app, then open a browser and go to that IP address.
4
Go to Scripts → + Add Script
In the left sidebar tap Scripts, then + Add Script in the top right corner.
5
Paste the reporting script
The app will show you the full script — copy it and paste it into the editor. The script is pre-configured with the correct webhook URL for this device. Tap Save, then toggle the script On. It will POST a reading every 60 seconds automatically.

The script runs entirely on the Shelly. It does not require port-forwarding, local servers, or a Shelly Cloud account. The only requirement is outbound HTTPS access from the property's internet connection.

6
Verify data is arriving
Wait 60–90 seconds, then tap Check Data Received in the app. You should see a green "Data received" confirmation with a live wattage reading. Then tap Verify Live Reading to complete setup.
⚠️

Gen 3 only: Only Shelly EM Gen 3 devices are supported. Gen 1 / Gen 2 devices use a different API and are not compatible with the current platform.

📡

SLZB-06M — Gateway Setup

Zigbee-to-MQTT gateway. One per property (or per floor in larger buildings).
1
Power up the gateway
Plug in the SLZB-06M via USB-C (5 V / 1 A minimum). The LED will flash while it broadcasts its AP hotspot. Place it centrally for maximum Zigbee coverage — avoid metal enclosures.
2
Connect your phone to the SLZB-06M hotspot
Open WiFi settings on your phone and connect to the network named SLZB-06M (no password). The gateway's AP IP is 192.168.4.1.
3
Open the gateway web UI
Open a browser and go to 192.168.4.1. You'll see the SLZB-06 dashboard. Default credentials (if prompted): admin / admin.
4
Connect to property WiFi
Go to Network → WiFi and enter the property's WiFi name (SSID) and password. Save and wait ~30 seconds. The LED on the gateway will turn solid once it reconnects. Reconnect your phone to the property WiFi.
5
Configure MQTT
Find the gateway's new local IP (shown in the app once it registers, or via your router). Open the web UI at that IP, then go to Settings → MQTT and enter the values shown in the app:
SLZB-06M FieldValue sourceNotes
Server/HostFrom app → MQTT SettingsBroker hostname or IP
Port1883 (or 8883 for TLS)Use TLS if broker requires it
UsernameFrom app → MQTT SettingsProperty-specific credential
PasswordFrom app → MQTT SettingsProperty-specific credential
Base topicFrom app → MQTT Settingse.g. myhome/gw/abc123
ℹ️

Tap the copy icon next to each value in the app to avoid typos. After saving MQTT settings, the gateway status in the app should turn Online within 30 seconds.

6
Register the gateway in the app
Back in MyHome Passport, complete the gateway setup wizard. Enter a name (e.g. "Block A – Ground Floor") and tap Register. The app will confirm the gateway is online.
🌡️

Frient Sensor — Pairing

Zigbee climate sensor. Pair after the gateway is online.
⚠️

Gateway must be online first. Do not attempt to pair sensors until the SLZB-06M gateway is registered and showing as Online in the app. Sensors pair within ~10–15 m of the gateway (line of sight).

1
Select a room and start pairing
Open MyHome Passport → Sensors tab → + Add Sensor. Pick or create the room where the sensor will be installed. Tap Start Pairing — the app opens a 60-second pairing window and listens for new Zigbee devices.
2
Put the Frient sensor into pairing mode
Press and hold the small button on the back of the sensor for 3–5 seconds until the LED blinks 3 times rapidly, then release. The sensor is now in pairing mode. It will be detected by the gateway within a few seconds.
ℹ️

Do not just tap the button — it must be a sustained hold until the 3× blink pattern appears. If the LED blinks once and stops, the battery may need replacing or the sensor is already joined to a network (factory reset it first).

3
Confirm the detected sensor
The app will show "Sensor Detected!" with the device's Zigbee ID. Enter a name for the sensor (e.g. "Living Room") and tap Confirm & Save.
4
Verify readings appear
After pairing, the sensor will appear on the Sensors screen. The first reading may take up to 5 minutes. If readings don't appear within 10 minutes, check the gateway is online and retry pairing.

Frient factory reset (if previously paired)

Hold the button for 10+ seconds until the LED blinks rapidly many times in a row. Release — the sensor has reset and is back in pairing mode.
🔧

Troubleshooting

Common issues and how to resolve them on site
SymptomLikely causeFix
Shelly: "No readings received" Script not saved / not toggled On In Shelly web UI → Scripts, confirm the script exists and its toggle is On. Wait a full 60 seconds and check again.
Shelly: "No readings received" (continued) Shelly not on property WiFi Confirm the Shelly has a valid IP on the property network. AP mode (192.168.33.1) means it hasn't joined WiFi yet.
Gateway: status stays Offline Wrong MQTT credentials or broker unreachable Double-check all 5 MQTT fields (host, port, username, password, base topic) — copy from the app one at a time. Confirm the broker is running (ask admin). Check port 1883/8883 is not blocked by the property router.
Gateway: can't open 192.168.4.1 Not connected to the SLZB-06M AP Reconnect your phone to the "SLZB-06M" WiFi network. Disable mobile data if your phone switches automatically.
Sensor: not detected in 60 s Button not held long enough Hold the button for at least 3–5 seconds until you see 3× rapid blinks. A single blink means it wasn't long enough.
Sensor: not detected in 60 s (continued) Sensor too far from gateway Move the sensor within 5 m of the gateway to pair, then reposition it. Zigbee mesh extends range through other paired devices.
Sensor: not detected in 60 s (continued) Sensor already joined to another network Factory reset the sensor: hold the button for 10+ seconds until rapid multi-blink. Then retry pairing.
App: "Gateway not found" Gateway changed IP after WiFi reconnect Check the new IP in your router's DHCP table or the gateway web UI. The app uses the gateway's ID, not its IP — this should resolve automatically once the gateway reconnects to MQTT.
📞

If you can't resolve an issue on site, contact your platform administrator with the device's ID, property name, and a screenshot of the error in the app. Do not attempt to factory reset the gateway unless instructed.