April 16, 2026 · Release Summary

[orlin369]

Pull Request: March 24 – April 16, 2026 · Release Summary

What's in this update

This update brings new device integrations, a BLU provisioning system, documentation standardisation across all MODBUS examples, and a set of production promotions. Changes span the the_pill/, blu-assistant/, and http-integrations/ areas.

---

For Installers

You wire devices — this update makes that easier and more consistent.

Standardised RS485 wiring diagram across every MODBUS example Every ## RS485 Wiring section in the repository now shows the same ASCII block diagram instead of inconsistent pin tables or bullet lists. You no longer need to interpret different formats across devices — the layout of The Pill 5-Terminal Add-on relative to the RS485 transceiver and the slave device is shown the same way everywhere.

GND note clarified The reliability note now reads "Always share GND between nodes if you share power" — the previous wording was unconditional and could cause confusion in isolated-supply setups.

New hardware you can connect:

• GACIA AICB2SP smart circuit breaker — read voltage, current, power, energy, frequency, power factor, temperature and switch the breaker on/off over RS485
• DFRobot SEN0492 laser ranging sensor — IP67-rated, 40–4000 mm, RS485/MODBUS-RTU, production-ready
• MarsRock G2 SUN Series grid-tie micro-inverter — live AC power, grid voltage, DC input, temperature via RS485
• EcoFlow STREAM Ultra — static load balancing over HTTP (cloud-independent)

BLU Assistant WiFi provisioning A two-script pair lets a BLU Assistant physical button trigger automatic Wi-Fi provisioning of nearby Gen3/Gen4 Shelly devices. Useful for commissioning devices on-site without touching each one individually.

---

For Integrators

You build systems — this update gives you cleaner primitives and broader device coverage.

ComWinTop MB308V refactor The mb308v.shelly.js script was significantly simplified: the verbose ENTITIES array and redundant FC/CRC_TABLE constants were removed, replaced with compact count variables. Configuration surface is cleaner. If you were building on top of this script, review the updated CONFIG block — SLAVE_ID default is now 2.

MODBUS HTTP Bridge (existing, now properly documented in the root index) modbus_http_bridge.shelly.js exposes any MODBUS-RTU slave over HTTP — GET and POST, JSON register descriptors, support for holding/input/coil/discrete register types, u16/i16/u32/i32/f32 data types, configurable byte and word order, and per-request slave address override. Use this as a universal gateway between RS485 buses and any HTTP-capable automation platform.

EcoFlow STREAM Ultra load balancing load_balancing_static.shelly.js integrates with EcoFlow's local API for static load management without cloud dependency. Full CONFIG/DEVICES_CFG reference documented in the README.

BLU WiFi provisioning wifi-provisioning.shelly.js BLE-scans for devices matching a configurable TARGET_MODEL_IDS array (full Gen3/Gen4 model ID reference in script comments), then provisions them as STA clients with retry queue. Designed to run alongside button-event-source.shelly.js.

MODBUS root README structure fixed Davis/, HTTP-Bridge/, and MarsRock/ were missing from the ## Structure index — all three now appear with descriptions. Folder list is alphabetically sorted.

9 scripts promoted to production status, 5 of which are in this period:

• the_pill/MODBUS/ComWinTop/mb308v.shelly.js
• the_pill/MODBUS/ComWinTop/mb308v_vc.shelly.js
• the_pill/MODBUS/MarsRock/SUN-G2/sun_g2.shelly.js
• the_pill/MODBUS/MarsRock/SUN-G2/sun_g2_vc.shelly.js
• the_pill/MODBUS/wirenboard/WB-MIR-v-3/wb_mir_v3_ir.shelly.js

---

For DIY

You build for yourself and share what you learn — this update adds several new areas to explore.

MarsRock SUN-G2 — if you have a grid-tie micro-inverter on your solar setup, you can now read AC output power, grid voltage, DC input voltage and inverter temperature directly into Shelly Virtual Components. No cloud, no vendor app. Register map corrections and byte-order fixes went through several iterations in this period — the current scripts reflect validated addresses.

DFRobot SEN0492 — industrial laser distance sensor at 40–4000 mm, IP67. Scripts include a console reader and a Virtual Components version. A screenshot of the VC page is included in the README.

GACIA AICB2SP — smart circuit breaker with built-in metering. Read per-circuit consumption and control the breaker state over RS485. Register map was reverse-engineered from the KWS-303L/Tuya RS485 reference — notes in the script header if your unit returns unexpected values.

BLU Assistant button provisioning — walk into a room, press a button, and nearby unprovisioned Shelly devices join your Wi-Fi. The button-event-source.shelly.js / wifi-provisioning.shelly.js pair is designed to be readable and hackable. BLE scanning target list (TARGET_MODEL_IDS) is easy to customise.

EcoFlow STREAM Ultra — if you have this portable power station, load_balancing_static.shelly.js lets you manage load allocation locally using the device's HTTP API.

---

For End-Users

You have the system installed — here's what has changed in plain terms.

More devices are supported. Your installer or integrator can now connect MarsRock solar inverters, DFRobot distance sensors, GACIA smart circuit breakers, and EcoFlow STREAM Ultra power stations to your Shelly system and make their data visible in the Shelly app.

Wiring guides are now consistent. If someone is connecting a new RS485 device to your system, every device guide now uses the same clear wiring diagram format — less room for wiring mistakes during installation.

BLU device setup is faster. A single button press on a BLU Assistant device can now automatically connect nearby Shelly devices to your Wi-Fi network. This reduces commissioning time when new devices are being added to your installation.

Scripts are more stable. Several scripts that were marked "under development" have been tested and promoted to production status. If you had these running, no changes are needed on your end.

---