# SMHUB Early Adopter – Quick Start Guide

The **SMHUB Early Adopter Version** is the first public release of our multi-radio smart hub. It’s designed for early buyers who want to explore the platform before the full release.

<table border="1" id="bkmrk-%23-date-updates-%2F-cha" style="border-collapse: collapse; width: 100%; height: 3980.59px;"><colgroup><col style="width: 6.19638%;"></col><col style="width: 11.7969%;"></col><col style="width: 12.7502%;"></col><col style="width: 8.69876%;"></col><col style="width: 60.5338%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**\#**</td><td style="height: 29.7969px;">**Date**</td><td style="height: 29.7969px;">**Type**</td><td style="height: 29.7969px;">**Version**</td><td style="height: 29.7969px;">**Updates / Changes**</td></tr><tr><td>17</td><td>28 Feb 2026</td><td>smhub-os

smhub-services

openthread

</td><td>0.9.6dev0.2.11

0.3.0-1

</td><td>**smhub-services, smhub-web &amp; SMHUB OS Released – Key Features:**

- **Linux Kernel 6.18** (upgrade from vendor kernel 5.4.x) for better stability, performance, and hardware support
- **Base for the pre-1.0.0 release candidate** (DEV channel, but recommended as a strong daily version)
- **Factory Reset via hardware button** (hold the middle button for 10 seconds on SMHUB Essentials/Premium)
- **User data backup &amp; restore** support added
- **New “Backups” page** in the Web UI for managing backups

**For more details and to update, follow this guide**:

[https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes)

</td></tr><tr><td>16</td><td>22 Jan 2026</td><td>smhub-os

smhub-services

openthread

</td><td>0.3.11

0.2.8

0.2.1-2

</td><td>**smhub-services, smhub-web &amp; SMHUB OS Released – Key Features:**

- Fixed issue with `cron.daily` preventing daily package updates
- Improved kernel options required for OTBR firewall functionality
- Migrated autostart files to new structure for improved service handling
- Added support for configuring the OTBR app directly
- Improved logging and debugging output
- Improved pairing flow for new Thread devices
- Added support for firewall and NAT64 configuration

💡 **How to update:**

**SMHUB-OS:** Settings -&gt; Update and restore **smhub-services/smhub-web:** Apps-&gt; smhub-services/web or   
via SSH (either Internal console or external SSH client - [manual is here](https://smlight.tech/support/manuals/books/smhub/page/access-smhub-via-external-ssh-client)) by executing these commands:

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk-sudo-opkg-update-sud-2"><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg update`</div><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg upgrade`</div></div>**For more details and to update, follow this guide**:

[https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes)

</td></tr><tr><td>15</td><td>19 Jan 2026</td><td>smhub-os

smhub-services  
smhub-web

</td><td>0.3.10

0.2.7

0.2.23

</td><td>**smhub-services, smhub-web &amp; SMHUB OS Released – Key Features:**

- Added nftables (+ iptables compat) for Tailscale/firewall
- Auto log truncation (daily / size limit) – to resolve freezes issue
- Improved NanoMR4 EFR flashing (CC flash reset)
- Zigbee2MQTT default logs set to info
- Fixed rare boot into backup partition
- Faster startup (deferred component loading)
- Increased flasher load timeout
- Updated GPIO mapping for kernel 6.18
- Updated Buildroot to 2025.11.x

💡 **How to update:**

**SMHUB-OS:** Settings -&gt; Update and restore **smhub-services/smhub-web:** Apps-&gt; smhub-services/web or   
via SSH (either Internal console or external SSH client - [manual is here](https://smlight.tech/support/manuals/books/smhub/page/access-smhub-via-external-ssh-client)) by executing these commands:

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk-sudo-opkg-update-sud"><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg update`</div><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg upgrade`</div></div>**For more details and to update, follow this guide**:

[https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes)

</td></tr><tr><td>13</td><td>26 Nov 2025</td><td>smhub-os

smhub-services  
smhub-web

</td><td>0.3.7

0.2.2

0.2.16

</td><td>**smhub-services, smhub-web &amp; SMHUB OS Released – Key Features:**

- **smhub-services v0.2.2**  
    • Added support for reading **EEPROM v1 format**  
    • Radio flashing endpoints updated to support model-based flashing  
    • Updated **pysmlight v0.2.11** for Nano flashing  
    • Corrected some default Zigbee2MQTT settings
- **smhub-web v0.2.16**  
    • Radio page now supports **Nano Mg24** flashing  
    • Device **model displayed in sidebar**  
    • Updated default Zigbee2MQTT settings  
    • **App status** displayed on Apps settings page  
    • Progress bar + changelog displayed for **OS updates**
- **SMHUB OS v0.3.7**  
    • Added hooks enabling **model-specific features**  
    • **Nano boot LED indicators** enabled  
    • Fixed duplicate services appearing after OTA restart

💡 **How to update:**

**SMHUB-OS:** Settings -&gt; Update and restore **smhub-services/smhub-web:** Apps-&gt; smhub-services/web or   
via SSH (either Internal console or external SSH client - [manual is here](https://smlight.tech/support/manuals/books/smhub/page/access-smhub-via-external-ssh-client)) by executing these commands:

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk-sudo-opkg-update-sud-1"><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg update`</div><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg upgrade`</div></div>**For more details and to update, follow this guide**:

[https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes)

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">12</td><td style="height: 29.7969px;">22 Nov 2025</td><td style="height: 29.7969px;">smhub-os

smhub-services  
smhub-web

</td><td style="height: 29.7969px;">0.3.6

0.2.1

0.2.15

</td><td style="height: 29.7969px;">**smhub-services v0.2.0 &amp; smhub-web v0.2.14 – Key Features**

- **CC Radio Flashing:**  
    Added full support for flashing TI CC radios (CC26xx) directly from the Web UI.
- **Improved Radio Flashers:**  
    Better progress bar behaviour and clearer error messages during flashing of CC and EFR32 radios.
- **App Logs &amp; Restart Buttons:**  
    Iframe improvements and new App Logs + Restart controls added for supported apps.
- **Run/Stop App Fixes:**  
    Run/Stop buttons now work more reliably across all apps.
- **Log Formatting Fix:**  
    Resolved issue where logs were incorrectly rendered in Title Case.
- **Backend Flashing Support (services):**  
    Added *smlight-cc-flasher* and integrated flashing logic into the backend.
- **Zigbee2MQTT Defaults Fix:**  
    Corrected default settings in the Web UI configuration form.
- **Node-RED Logs Fix:**  
    Fixed Node-RED log handling so logs display properly.
- **OS Base Image Updated:**  
    OS v0.3.6 now uses Buildroot v2025.08.1 and includes correct paths for CC and Silabs flashers.

💡 **How to update:**

**SMHUB-OS:** Settings -&gt; Update and restore **smhub-services/smhub-web:** Apps-&gt; smhub-services/web or   
via SSH (either Internal console or external SSH client - [manual is here](https://smlight.tech/support/manuals/books/smhub/page/access-smhub-via-external-ssh-client)) by executing these commands:

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk-sudo-opkg-update-sud-3"><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg update`</div><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg upgrade`</div></div>**For more details and to update, follow this guide**:

[https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes)

</td></tr><tr style="height: 414.359px;"><td style="height: 414.359px;">11</td><td style="height: 414.359px;">15 Nov 2025</td><td style="height: 414.359px;">smhub-services  
smhub-web

</td><td style="height: 414.359px;">0.2.0  
0.2.14

</td><td style="height: 414.359px;">**smhub-services v0.2.0 &amp; smhub-web v0.2.14 – Key Features**

- **EFR32 Firmware Flashing:**  
    Built-in flasher for Silicon Labs radios, fully integrated into the UI.
- **New Radio Page:**  
    Central place to manage radios and perform flashing operations.
- **Run/Stop App Controls:**  
    Start or stop apps directly from the Apps page.
- **OpenThread Support:**  
    SMHUB can now be configured as an **OpenThread Border Router** via the UI (flashing + app installation + launch).

💡 **How to update:**

**smhub-services/smhub-web:** Apps-&gt; smhub-services/web or   
via SSH (either Internal console or external SSH client - [manual is here](https://smlight.tech/support/manuals/books/smhub/page/access-smhub-via-external-ssh-client)) by executing these commands:

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk-sudo-opkg-update-sud-4"><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg update`</div><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg upgrade`</div></div>**For more details and to update, follow this guide**:

[https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes)

</td></tr><tr style="height: 265.984px;"><td style="height: 265.984px;">10</td><td style="height: 265.984px;">09 Nov 2025</td><td style="height: 265.984px;">smhub-os

</td><td style="height: 265.984px;">0.3.4

</td><td style="height: 265.984px;">**smhub-os Released – Key Features:**

**🔹SMHUB OS v0.3.4**

- Set the default **apps update channel** to *stable*
- Fixed **OTA upgrade issue** affecting users on firmware v0.3.2/v0.3.3 (update to v0.3.4 now available and functional across all installations)
- Fixed **UART communication** for baud rates above **115200**

💡 **How to update:**

**SMHUB-OS:** Settings -&gt; Update and restore

**For more details and to update, follow this guide**:

[https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-smhub-os-0.3.3%2C-smhu](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-smhub-os-0.3.3%2C-smhu)

</td></tr><tr style="height: 504.984px;"><td style="height: 504.984px;">9</td><td style="height: 504.984px;">07 Nov 2025</td><td style="height: 504.984px;">smhub-services  
smhub-web

</td><td style="height: 504.984px;">0.1.20  
0.2.12

</td><td style="height: 504.984px;">**smhub-services, smhub-web Released – Key Features:**

🔹 **smhub-web v0.2.12**

- Added Timezone Selector in *Settings → General*
- LTE page fixes: corrected status display and connectivity info
- Z-Wave JS page: now indicates if module is installed
- App tiles: fixed version comparison bug on app overview page

🔹 **smhub-services v0.1.19**

- Timezone management: added backend support for listing and setting timezone
- EEPROM integration: added support to read product data from device EEPROM
- App update stability: fixed bugs related to version comparison and update channel logic

💡 **How to update:**

**smhub-services/smhub-web:** Apps-&gt; smhub-services/web or   
via SSH (either Internal console or external SSH client - [manual is here](https://smlight.tech/support/manuals/books/smhub/page/access-smhub-via-external-ssh-client)) by executing these commands:

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk-sudo-opkg-update-sud-5"><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg update`</div><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg upgrade`</div></div>**For more details and to update, follow this guide**:

[https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-smhub-services-v0.1.-1](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-smhub-services-v0.1.-1)

</td></tr><tr style="height: 458.109px;"><td style="height: 458.109px;">8</td><td style="height: 458.109px;">03 Nov 2025</td><td style="height: 458.109px;">smhub-os

smhub-services  
smhub-web

</td><td style="height: 458.109px;">0.3.3  
0.1.18  
0.2.11

</td><td style="height: 458.109px;">**smhub-os, smhub-services, smhub-web Released – Key Features:**

🔹 **smhub-web v0.2.11-1**  
• New Ethernet settings page  
• New 4G/LTE management page

🔹 **smhub-services v0.1.18-1**  
• Added backend support for 4G/LTE  
• Added peripheral backend layer for future hardware features  
  
🔹 **SMHUB OS v0.3.3**  
• Added timezone data to the base system *(frontend integration coming soon)*  
• Added 4G/LTE modem support

💡 **How to update:**

**SMHUB-OS:** Settings -&gt; Update and restore **smhub-services/smhub-web:** Apps-&gt; smhub-services/web or   
via SSH (either Internal console or external SSH client - [manual is here](https://smlight.tech/support/manuals/books/smhub/page/access-smhub-via-external-ssh-client)) by executing these commands:

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk-sudo-opkg-update-sud-6"><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg update`</div><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg upgrade`</div></div>**For more details and to update, follow this guide**:

[https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-smhub-services-v0.1.-1](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-smhub-services-v0.1.-1)

</td></tr><tr style="height: 474.906px;"><td style="height: 474.906px;">7</td><td style="height: 474.906px;">28 Oct 2025</td><td style="height: 474.906px;">smhub-os  
smhub-services  
smhub-web

</td><td style="height: 474.906px;">0.3.2  
0.1.17  
0.2.10

</td><td style="height: 474.906px;">**smhub-os, smhub-services, smhub-web Released – Key Features:**  
🔹 **Wi-Fi setup in UI** – scan &amp; connect to 2.4 GHz networks (5 GHz in testing mode – IPv6 works so far)  
🔹 **USB Device/Host selector** – switch modes in Settings *(requires reboot)*  
🔹 **USB device list** – view connected devices (up to 127 supported)  
🔹 **Change device hostname** – directly from the Web UI  
🔹 **WireGuard** – now supports hostnames + IPv4 and IPv6  
🔹 **Improved recovery** – fixed Type-C / SD-Card flashing, added U-Boot realignment &amp; auto-reinstall scripts  
🔹 **Wi-Fi MAC fix** – persistent across reboots  
🔹 Added **gpiod** utilities  
🔹 **Blue LED** indicators during **Type-C / SD flashing**

💡 **How to update:**

**SMHUB-OS:** Settings -&gt; Update and restore **smhub-services/smhub-web:** Apps-&gt; smhub-services/web or   
via SSH (either Internal console or external SSH client - [manual is here](https://smlight.tech/support/manuals/books/smhub/page/access-smhub-via-external-ssh-client)) by executing these commands:

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk-sudo-opkg-update-sud-7"><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg update`</div><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg upgrade`</div></div>**For more details and to update, follow this guide**:

[https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-2025-oct-28%3A](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-2025-oct-28%3A)   
</td></tr><tr style="height: 335.969px;"><td style="height: 335.969px;">6</td><td style="height: 335.969px;">24 Oct 2025</td><td style="height: 335.969px;">smhub-service

smhub-web

</td><td style="height: 335.969px;">0.1.16

0.2.9

</td><td style="height: 335.969px;">**smhub-services, smhub-web Released – Key Features:**

- **💾 Wireguard client Settings in UI:** Configure SMHUB’s internal Wireguard client from the UI (Settings → Wireguard).
- 🔄 Small, but helpful tweak - Reboot button at the left bottom corner of the UI :)

**Important**:

Please update via SSH (either Internal console or external SSH client - [manual is here](https://smlight.tech/support/manuals/books/smhub/page/access-smhub-via-external-ssh-client)) by executing these commands:

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk-sudo-opkg-update-sud-8"><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg update`</div><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg upgrade`</div></div>**For more details and to update, follow this guide**:

[https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-2025-oct-13%3A](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-2025-oct-13%3A)

</td></tr><tr style="height: 419.953px;"><td style="height: 419.953px;">5</td><td style="height: 419.953px;">18 Oct 2025</td><td style="height: 419.953px;">OS  
smhub-service

smhub-web

</td><td style="height: 419.953px;">0.3.0

0.1.13

0.2.8

</td><td style="height: 419.953px;">**New SMHUB-OS, smhub-services, smhub-web Released – Key Features:**

- 🧠 **MQTT Broker Settings:** Configure SMHUB’s internal MQTT broker directly from the UI (Settings → Mqtt) or link it to an external broker in bridge mode.
- 💾 **Read-only RootFS:** The system partition is now read-only for higher reliability; all settings remain saved after OS updates.
- ⚙️ **Improved Stability:** Fixed MQTT user saving, web upgrade errors, and refined translations and form handling.
- 🪄 **Improved Resets:** Deleting the overlay restores system defaults instantly.

Important:

Please update via SSH (either Internal console or external SSH client - [manual is here](https://smlight.tech/support/manuals/books/smhub/page/access-smhub-via-external-ssh-client)) by executing these commands:

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk-sudo-opkg-update-sud-9"><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg update`</div><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg upgrade`</div></div>**For more details and to update, follow this guide**: [https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-smhub-os-v0.2.2-%2B%C2%A0sm](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-smhub-os-v0.2.2-%2B%C2%A0sm)

</td></tr><tr style="height: 283.406px;"><td style="height: 283.406px;">4</td><td style="height: 283.406px;">13 Oct 2025</td><td style="height: 283.406px;">smhub-service

smhub-web

</td><td style="height: 283.406px;">0.1.9

0.2.5

</td><td style="height: 283.406px;">**New SMHUB Services v0.1.9 &amp; SMHUB Web v0.2.5 Released – Key Features:**

- 🖥 **Web Console (Console Tab):** Run Linux commands directly from the Web UI — no SSH required.
- ⚙️ **Improved Logs:** Fixed log visibility for Web and Z-Wave apps.
- 🛠 **Fixed Service Installation Hang:** Updates now install reliably via Web UI.
- 🚫 **401 Error Fix:** Prevented HEAD request spam in system logs.
- 🔄 **Added `opkg update` Endpoint:** Enables smoother package refresh via backend.
- 👤 Web terminal now logs in as `smlight` with color-enabled shell.

**For more details and to update, follow this guide:**

[https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-smhub-services-v0.1](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-smhub-services-v0.1).

</td></tr><tr style="height: 450.75px;"><td style="height: 450.75px;">3</td><td style="height: 450.75px;">12 Oct 2025</td><td style="height: 450.75px;">OS  
smhub-service

smhub-web

</td><td style="height: 450.75px;">0.2.2  
0.1.7-1

0.2.3-1

</td><td style="height: 450.75px;">**New SMHUB OS 0.2.2 Released – Key Features:**

- **Full Kernel OTA Support:** Until now, only WebUI and backend (smhub-services, smhub-web) could be updated via OTA. Starting with version **0.2.2**, the **Linux kernel** is now also OTA-upgradable - no Type-C flashing needed.
- **New Logs Tab:** Apps such as **Zigbee2MQTT** now have live log viewing directly in the Web UI.
- **Improved System Boot:** Fixed Z-Wave JS startup issue.
- **Dashboard Improvements:** Added explanatory notes for clarity.
- **Settings Layout Update:** Disabled not-yet-available pages.
- **Firmware Version Display:** Added version indicator to the bottom-left corner.
- **Coming Soon:** Web console for running Linux commands from **Settings → Console**.

**Update Sequence (Required):**  
1️⃣ Update **OS to 0.2.1c**  
2️⃣ Update **smhub-services** and **smhub-web** to latest versions  
3️⃣ Then check **Settings → Update and Backup** to update **OS to 0.2.2**

To update, follow this guide: [https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-smhub-os-v0.2.2-%2B%C2%A0sm](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-release-notes#bkmrk-smhub-os-v0.2.2-%2B%C2%A0sm)

<span style="background-color: rgb(251, 238, 184);">**IMPORTANT: if you updated via the UI button, and the UI hangs/freezes, please read the link above for the solution.** </span>

</td></tr><tr style="height: 282.781px;"><td style="height: 282.781px;">2</td><td style="height: 282.781px;">06 Oct 2025</td><td style="height: 282.781px;">OS

</td><td style="height: 282.781px;">0.2.1c

</td><td style="height: 282.781px;">**New SMHUB OS 0.2.1c Released - Key Features**:

- **Kernel OTA Support**: Previously, only the WebUI, backend, and apps supported OTA updates - the kernel did not. Starting with version 0.2.1c, kernel updates now work as well. After this update, the entire system can be updated via OTA, with no need for USB flashing.
- **LED Animation During Boot**: After powering on (in about 3–5 seconds), the LEDs display a blue chasing animation. When this animation stops, it indicates that the device is accessible via SSH. Shortly after, all green LEDs turn on, meaning that the Web UI is also accessible.
- **Other Internal Improvements and Bug Fixes**

To update, please follow this manual: [https://smlight.tech/support/manuals/books/smhub/page/smhub-early-adopter-quick-start-guide#bkmrk-updating-smhub-firmw](https://smlight.tech/support/manuals/books/smhub/page/smhub-early-adopter-quick-start-guide#bkmrk-updating-smhub-firmw)

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">1</td><td style="height: 29.7969px;">26 Sep 2025</td><td style="height: 29.7969px;">OS</td><td style="height: 29.7969px;">0.2.0</td><td style="height: 29.7969px;">Initial release</td></tr></tbody></table>

---

## What’s Already Installed (Ready to Use)

- **Zigbee2MQTT** (for CC26XX or EFR32XX radios)
- **Mosquitto MQTT broker**
- **Matterbridge**
- **Node-RED**

---

## Hardware – Working Now

- CC26XX radio
- EFR32MGXX radio
- 100 Mb Ethernet port
- 12× WS2812B RGB LEDs (Ambilight effects)
- eMMC storage
- PoE module support (optional)
- Z-Wave module support (optional)

---

## Hardware – Present but Still in Development

- Wi-Fi 6 (2.4 / 5 GHz) and Bluetooth (currently CLI only, UI support coming)
- IR receiver and transmitter
- USB ports: 2× USB-C (1 for power/upstream, 1 downstream), 1× USB-A
- SD card slot
- 3.5 mm audio jack
- 4× Service LEDs
- 3× Hardware buttons
- Expansion connectors: UART, I²C, SPI, DIY pinouts

---

## Updates &amp; Roadmap

- More hardware functions will be enabled gradually via **SMHUB-OS updates**.
- New features will roll out continuously (but availability is not guaranteed).
- **Early adopters receive updates and improvements first**.

---

## Updating SMHUB Firmware

This section is moved to the dedicated page here [https://smlight.tech/support/manuals/books/smhub/page/smhub-os-update-restore-methods](https://smlight.tech/support/manuals/books/smhub/page/smhub-os-update-restore-methods)

---

## Updating Zigbee Firmware

### EFR32

1. Connect to device via SSH terminal [https://smlight.tech/support/manuals/books/smhub/page/3-getting-started#bkmrk-ssh-access](https://smlight.tech/support/manuals/books/smhub/page/3-getting-started#bkmrk-ssh-access)
2. Type following commands:
3. ```shell
    sudo pip install python_magic~=0.4.27 && sudo pip install pysmlight~=0.1.3 && sudo pip install universal-silabs-flasher
    cd /home/
    sudo wget -O ncp-uart-hw-v7.4.1.0-slzb-07-115200.gbl  http://updates.smlight.tech/firmware/slzb-07/ncp-uart-hw-v7.4.1.0-slzb-07-115200.gbl
    sudo wget -O efr_btl_enabler.sh  http://updates.smlight.tech/firmware/smhub/utils/efr_btl_enabler.sh
    sudo chmod 777 efr_btl_enabler.sh
    sudo ./efr_btl_enabler.sh
    universal-silabs-flasher --device /dev/ttyS2 --probe-method bootloader flash --firmware ncp-uart-hw-v7.4.1.0-slzb-07-115200.gbl
    ```
    
    EFR32 firmware will be updated to **v7.4.1.0**

## Accessing the Web Interface

- Open: **[http://smhub.local](http://smhub.local)**

[![image.png](https://smlight.tech/support/manuals/uploads/images/gallery/2025-09/scaled-1680-/hyKimage.png)](https://smlight.tech/support/manuals/uploads/images/gallery/2025-09/hyKimage.png)

On first boot, **no apps are running**. You must enable them.

---

## Running Apps (Example: Zigbee2MQTT)

1. Open the **Apps tab**.
2. In **Z2M app settings**:
    
    
    - Choose your Zigbee chip:
        
        
        - `ttyS1` → CC26XX SoC
        - `ttyS2` → EFR32XX SoC
    - Configure MQTT broker if needed.
3. Toggle:
    
    
    - **Enabled** → allows the app to run.
    - **Start on boot** → app starts automatically after reboot.
        
        [![image.png](https://smlight.tech/support/manuals/uploads/images/gallery/2025-09/scaled-1680-/SDximage.png)](https://smlight.tech/support/manuals/uploads/images/gallery/2025-09/SDximage.png)
4. **Reboot SMHUB** (press Reset or power cycle).
5. Once booted, open the **Zigbee2MQTT tab** – you’ll see the configuration page.

[![image.png](https://smlight.tech/support/manuals/uploads/images/gallery/2025-09/scaled-1680-/Do6image.png)](https://smlight.tech/support/manuals/uploads/images/gallery/2025-09/Do6image.png)

You can repeat the same steps for:

- **Matterbridge**
- **Node-RED**
    
    [![image.png](https://smlight.tech/support/manuals/uploads/images/gallery/2025-09/scaled-1680-/cOMimage.png)](https://smlight.tech/support/manuals/uploads/images/gallery/2025-09/cOMimage.png)
    
      
    [![image.png](https://smlight.tech/support/manuals/uploads/images/gallery/2025-09/scaled-1680-/CRLimage.png)](https://smlight.tech/support/manuals/uploads/images/gallery/2025-09/CRLimage.png)

---

## Note 1

- The **Settings tab** is under development – more options will appear in future updates.
- Once per day, the device automatically runs `opkg update` to check for available updates.
- If you do not see package updates in the web interface, you can force an update manually:
    
    
    1. Connect to the device using an **SSH terminal** (e.g., PuTTY).
    2. Log in with credentials:
        
        
        - **User:** `smlight`
        - **Password:** `smlight`
    3. Run the command:
        
        <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="sticky top-9">  
        </div><div class="overflow-y-auto p-4" dir="ltr">`sudo opkg <span class="hljs-keyword">update</span>`using password `smlight`</div></div>
    4. Return to the web interface and **refresh the Apps page**.
    5. Please note that this update feature is applicable only for packages (apps) and is not applicable for SMHUB-OS.   
        SMHUB-OS OTA is planned to be released in the coming weeks.

## Note 2

  
If you cannot flash the device and the `flash.bat` window disappears, follow the steps below to get more information about why the process stops. This can help in troubleshooting:

1. **Check drivers**  
    Make sure the required drivers are installed (see the manual above).
2. **Open Command Prompt as Administrator**
    
    
    - Click the **Windows button**, type **CMD**.
    - Right-click **Command Prompt** and select **Run as Administrator**.
3. **Navigate to the flash.bat folder**  
    Type the following command:
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="sticky top-9"><div class="absolute end-0 bottom-0 flex h-9 items-center pe-2"><div class="bg-token-bg-elevated-secondary text-token-text-secondary flex items-center gap-4 rounded-sm px-2 font-sans text-xs">  
    </div></div></div><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-built_in">cd</span> full_path_to_the_file_flash_bat`</div></div>Replace `full_path_to_the_file_flash_bat` with the actual folder path where `flash.bat` is located.  
    *Example:*
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="sticky top-9">  
    </div><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-built_in">cd</span> C:\Users\zigbee\Downloads\smhub_v0.1.3`</div></div>
4. **Run the flashing script**  
    Type:
    
    <div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="sticky top-9">  
    </div><div class="overflow-y-auto p-4" dir="ltr">`flash.bat`</div></div>and press **Enter**.
5. **Check the error message**  
    Review the output in the Command Prompt window to identify the error.