# Wi-Fi and smart-home pairing — Serin Link

> Use Serin Link to connect compatible controller firmware to Wi-Fi, open its web interface, and display pairing codes for home apps.

Source: https://serin-labs.com/link/connections.html
Last updated: 2026-11-10

These procedures configure the selected controller’s network and home-app connections. Serin Link displays its setup codes.

## Wi-Fi setup

The controller uses Wi-Fi for network functions. Daily Serin Link control uses a separate wireless connection. Available setup actions depend on controller firmware.

## Start setup or change a network

[![Wi-Fi setup offer](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/wifi-needed.png)](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/wifi-needed.png)

Wi-Fi setup offer

Tap the home-screen Wi-Fi offer or push the knob to start. To suppress future automatic offers, hold the knob **on that offer** until the confirmation arc completes. Setup remains available through **Settings → Wi-Fi**.

In Settings, highlight **Wi-Fi**. Follow the applicable case:

Scroll sideways to read all columns.

| Controller state | Action |
| --- | --- |
| No configured network, setup available | Push the knob to start setup. |
| Configured network disconnected, · **change network** · hint | Push the knob to configure a network. |
| Working network with · **change network** · hint | Keep the knob pushed until the confirmation arc completes. Alternatively, touch and hold the Wi-Fi status. This starts network change. Releasing the touch does not open the web QR code. |
| Working network with a reported IP address | A brief push or tap on the Wi-Fi status opens the controller web QR code. It does not change the network. |
| Controller offline, or setup unavailable | Restore the connection between Serin Link and the controller, or use the controller firmware’s setup procedure. |

Note

Changing networks can interrupt network functions. Release before the confirmation arc completes to cancel. A cancelled touch hold stays in Settings; tap the Wi-Fi status briefly to open the web QR code.

Use **change network** to move a Matter-compatible controller to another network while keeping its home pairings.

Warning

Holding a Matter-compatible controller’s physical button for ten seconds erases its saved Wi-Fi credentials and restarts it. The light blinks red at seven seconds; release during that warning, before ten seconds, to cancel the erase. The web interface’s **Forget Wi-Fi** action also erases credentials. Set up the controller’s Wi-Fi again after either erase.

## Connect the controller to Wi-Fi

[![QR code for the setup hotspot](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/wifi-qr.png)](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/wifi-qr.png)

QR code for the setup hotspot

1. Scan the QR code and accept the phone’s request to join the temporary network.
2. On the setup page, select your home network, enter its password, and submit.
3. Wait for **Wi-Fi connected**, then reconnect your phone to the home network.

For unusual network names or keys, see the [Wi-Fi reference](https://serin-labs.com/link/technical-reference.html#wi-fi-credentials).

If scanning does not connect the phone, select the displayed **Serin-XXXX** network in the phone’s Wi-Fi settings. Enter `serinlabs` as its password. While connected to that hotspot, open `http://192.168.4.1` if the setup page does not open automatically. These hotspot details apply to the controller firmware described in the [Serin setup guide](https://serin-labs.com/setup.html).

[![Wi-Fi connected](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/wifi-connected.png)](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/wifi-connected.png)

Wi-Fi connected

If a pairing code appears, continue with [HomeKit and Matter pairing](https://serin-labs.com/link/connections.html#homekit-and-matter-pairing). If no home pairing is needed, push the knob to finish.

A new Matter controller can instead receive Wi-Fi details from the home app during Matter pairing. A Wi-Fi offer on Serin Link is not a prerequisite for that process. Use the controller’s setup instructions if Serin Link offers no hotspot.

## Cancel Wi-Fi setup

During a network change, hold the knob while the hotspot starts, or push or hold on its QR screen. Supported controllers confirm cancellation: Serin Link stops setup requests, retries cancellation until acknowledged, then returns to Settings.

Cancellation does not erase credentials. For an open hotspot or unconfirmed cancellation, see [setup recovery](https://serin-labs.com/link/troubleshooting.html#retry-cancel-or-return-later).

For initial setup, push or hold on the QR screen, or hold while the hotspot starts, to leave it available for later. Serin Link returns to Settings or home, depending on where setup began. This does not suppress the automatic offer; only a long hold **on the home-screen offer** does that.

For setup failures or screen timeouts, see [Retry, cancel, or return later](https://serin-labs.com/link/troubleshooting.html#retry-cancel-or-return-later).

## Open the controller web interface

The controller must be online, connected to Wi-Fi, and reporting an IP address.

1. Connect your phone to the controller’s home network.
2. Open **Settings → Wi-Fi** and push when **show web UI** appears.
3. Scan the QR code and open the offered address.

[![Controller web interface QR code and IP address](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/controller-web-qr.png)](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/controller-web-qr.png)

Controller web interface QR code and IP address

Alternatively, enter `http://` followed by the displayed IP address in your browser. For example, use `http://192.168.1.50/` only if Serin Link shows that address. Push or hold the knob to leave.

## HomeKit and Matter pairing

These procedures add the **controller** to a home app. They are separate from pairing **Serin Link** with **Serin Controller**. Select the intended zone before you start. Use the code on your own device, not a code in a manual figure.

## Add HomeKit-compatible firmware to Apple Home

Use an iPhone or iPad with the Home app. Connect the controller and phone to the same home network. The controller must be online and unpaired with a home.

1. Open **Settings → HomeKit** and push the knob to show the code.
2. In Apple Home, select **+ → Add Accessory**, scan the code, and follow the prompts.

[![HomeKit setup QR code](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/homekit-qr.png)](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/homekit-qr.png)

HomeKit setup QR code

If scanning fails, use the app’s manual setup option. Enter the eight-digit HomeKit code shown on Serin Link. The HomeKit-compatible firmware is not Apple certified. The app can show an uncertified-accessory message during setup. Refer to [Apple’s accessory setup instructions](https://support.apple.com/en-us/104998) and [manual code entry](https://support.apple.com/guide/iphone/iph125110541/ios).

When the controller reports success, Serin Link shows **HomeKit paired**. Push the knob to finish.

[![HomeKit pairing complete](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/homekit-paired.png)](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/homekit-paired.png)

HomeKit pairing complete

## Add Matter-compatible firmware to a home app

Use a Matter-capable home app and its required hub. Enable Bluetooth on the phone for initial setup. The Serin Matter-compatible firmware uses Wi-Fi, not Thread. The controller must accept pairing, and Serin Link must have an online connection to it. Normal entry from Settings requires an unpaired controller.

1. Open **Settings → Matter** and push the knob to show the code.
2. Add the controller in your home app using its procedure below.
3. Wait for **Matter paired**, then push the knob to finish.

[![Matter setup QR code](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/matter-qr.png)](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/matter-qr.png)

Matter setup QR code

For **Apple Home**, use **+ → Add Accessory**. Scan Serin Link’s Matter QR code. Alternatively, enter its Matter setup code with the app’s manual option. Complete the room and name prompts. See [Apple’s Matter instructions](https://support.apple.com/en-us/102135).

For **Google Home**, this test firmware requires developer setup before pairing. Follow the [Google Home setup reference](https://serin-labs.com/link/technical-reference.html#google-home-test-firmware).

For another Matter app, follow that app’s instructions for adding an accessory. Check its requirements for uncertified firmware before pairing. Do not assume that every app accepts the controller without additional configuration.

[![Matter pairing complete](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/matter-paired.png)](https://serin-labs.com/assets/link/manual/b354d9ab980d0a1f6ee511b2de4669a8f890b33a/figures/matter-paired.png)

Matter pairing complete

## Continue after Wi-Fi setup or return later

If Wi-Fi setup leads directly to a pairing code, continue in the phone app. Push or hold the knob to leave. Return through **Settings → HomeKit** or **Settings → Matter** while the controller remains unpaired. A timeout returns home without removing a pairing.

For unavailable codes or pairing options, see [Pairing status and missing codes](https://serin-labs.com/link/troubleshooting.html#pairing-status-and-missing-codes).

## Add another home app or remove a home pairing

These procedures use the controller web interface. They apply when its HomeKit or Matter card offers the named controls.

To add another Matter ecosystem:

1. Open the [controller web interface](https://serin-labs.com/link/connections.html#open-the-controller-web-interface), then **Matter → Open Pairing Window**.
2. Add an accessory in the new home app and scan the web interface’s QR code before the window closes. Complete the app’s prompts.

The already-paired Serin Link Settings screen does not open this QR code.

Warning

Removing a home pairing removes that home’s access to the controller. It does not remove the Serin Link zone pairing.

To remove one Matter ecosystem:

1. Open the controller web interface’s **Matter** card.
2. Select **Remove** beside the intended home.
3. Check its name, then confirm or cancel.

Other paired homes remain. If you intend to remove every Matter home, select **Reset Matter Pairing** instead. Read its warning before you confirm. This action removes all Matter pairings and restarts the controller.

To remove HomeKit pairings:

Select **Reset HomeKit Pairing** in the web interface’s **HomeKit** card. Read the warning that all HomeKit pairings will be removed, then confirm or cancel.

After removal, use the applicable home-pairing procedure again. If a home app retains an old accessory entry, follow that app’s removal instructions.

**Source details**

Source: `serin-link`
Manual: `docs/manual/MANUAL.md`
Source revision: `b354d9ab980d0a1f6ee511b2de4669a8f890b33a`
