# Serin Link technical reference

> Serin Link technical reference for display behavior, Wi-Fi credential limits, Google Home test-device setup, and ESPHome update configuration.

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

Specialist setup and display details. For everyday use, see the [Serin Link manual](https://serin-labs.com/link/manual.html).

## Display behavior

When the idle display or the dark screen starts, Serin Link also returns to the home screen. It closes an open explanation and ends the on-screen tips. The Wi-Fi and home-pairing screens are the exception. These screens stay bright until their own timeout. Refer to [setup troubleshooting](https://serin-labs.com/link/troubleshooting.html#retry-cancel-or-return-later).

A Serin Controller can also control the screen, if its firmware has that function. With this control:

- The screen becomes dark after approximately 30 seconds. The **Idle screen** setting does not apply.
- The screen shows the Glance display immediately when the controller removes the dark condition.

With more than one zone, a request to show the display has priority over a request to make the screen dark.

### Display differences

With **Settings → Advanced → Night** enabled, the controller can limit brightness at night. On the VIEWE 1.5 display, the limit is normally 20%. The controller can supply a different limit. A Brightness adjustment temporarily lifts the limit. Inactivity restores it. Ordinary knob activity wakes a dim display, but does not itself remove the night limit.

The VIEWE 2.1 display does not use the same idle brightness ramp or night cap. Its **Idle screen → Off** option still makes the screen dark. Check the board name in **About → Details → LINK** before comparing display behavior.

## Built-in sensor correction

The 1.5-inch Serin Link kit compensates for electronics heat by subtracting 1.00 °C (about 1.80 °F) and multiplying relative humidity by 1.110. These corrections remain constant while the heat pump runs and apply to readings sent to the controller. Saved temperature calibration overrides the default and survives firmware updates. See the [sensor troubleshooting instructions](https://github.com/Serin-Labs/serin-link/blob/679245d9185827523e016e1fe645ac9c2d00fc10/docs/TROUBLESHOOTING.md#sensor).

## Wi-Fi credentials

The HomeKit-compatible controller firmware accepts Wi-Fi network names up to 32 bytes, passphrases up to 63 characters, and 64-character hexadecimal keys. It keeps the full network name and key when reconnecting or restoring the previous network after an unsuccessful change. Non-ASCII characters can use more than one byte of the network-name limit.

## Google Home test firmware

For **Google Home**, first prepare a compatible Matter hub and enable IPv6 on the home network. This controller's test firmware also needs a Google Developer Console Matter integration with matching device identifiers. Check the controller web interface's **About → Matter ID** before configuration. The audited firmware uses Vendor ID `0xFFF1` and Product ID `0x8000`.

Use the same Google account for the developer project and the Home app. Follow [Google's test-device setup instructions](https://developers.home.google.com/matter/get-started). Then open Google Home. Select **Add → Device** and scan the QR code on Serin Link. Complete the app's setup prompts. App versions can offer **Set up without QR code** for manual entry. Follow [Google's current pairing instructions](https://support.google.com/googlehome/answer/13127223?hl=en) if the labels differ.

## ESPHome updates

The official Serin ESPHome board configurations enable Serin Link firmware updates through `serin_link.link_ota_credentials: true` and require ESPHome 2026.7.4 or newer. Install an updated controller build to apply the setting; existing Serin Link pairings remain valid.

In the website's ESPHome YAML generator, select **Connect a Serin Link**. **Allow Link firmware updates** is selected by default when Serin Link is enabled. Clear that checkbox to keep wireless controls without sharing Wi-Fi credentials. The generated configuration explicitly records this choice. All generated configurations require ESPHome 2026.7.4 or newer. The generator uses fixed component revisions and ESP-IDF 5.5.5; its Serin Link component is currently a beta release. Install the generated configuration on the controller before using **Update** on Serin Link.

When Serin Link requests an update, the controller sends its Wi-Fi network name and key over the encrypted connection to the paired Serin Link. To disable this sharing, set `link_ota_credentials: false` under `serin_link:` in the controller YAML and install that configuration. This hides Serin Link's **Update** action. WPA-Enterprise networks require this setting to be disabled. Serin Link needs direct internet access for HTTPS downloads and time synchronization.
