Multi-protocol gateway

WB-MGE v.3

RS-485, Ethernet, Wi-Fi, WBIO interface converter
Multi-protocol gateway

The WB-MGE v.3 gateway is designed to connect devices with RS‑485 and WBIO (I/O modules) interfaces over Ethernet and Wi‑Fi.

It provides two independent RS‑485—TCP channels; each can operate in one of the following modes:

  1. Modbus TCP — for working with RS‑485 Modbus RTU devices.
  2. Raw TCP Bridge — for any serial RS‑485 protocol (e.g., Modbus RTU, DOOYA, AKKO, etc.).

WBIO modules connect via the side I/O Bus connector and are exposed as a Modbus device on the RS485‑2 bus with an address printed on the module label. WBIO support can be disabled in the web interface to free the port for any protocols.

Main Features

Ethernet and Wi‑Fi

Two network interfaces:

  1. Wi‑Fi — enabled by default with an access point and password. Modes available: “access point”, “client”, and “disabled”.
  2. Ethernet — configured to obtain an IP address via DHCP.

If the device you use to connect to the gateway supports mDNS, the module is reachable as wb-mge-XXXXXX.local on any network interface.

You can change the hostname, Wi‑Fi mode, and network settings. Default values are available in the documentation.

2 × RS‑485

Two independent RS‑485 ports, exposed as channels with the following modes:

  • Modbus TCP — Modbus RTU frames are converted to Modbus TCP and served over the network interfaces.
  • Raw TCP Bridge — frames are forwarded “as is” without conversion. In this mode you can connect classic Modbus RTU devices (Modbus RTU over TCP) as well as devices using arbitrary protocols over RS‑485.

For each RS‑485 port you can set its TCP port and mode, then poll it over any network interface.

Termination and Failsafe Bias on RS‑485 Ports

Each RS‑485 port provides software‑switchable:

  • Termination — 120 Ω resistor between A and B. Enable if the module is at the end of the bus; disable if it’s in the middle.
  • Failsafe bias — 560 Ω pull resistors that bias the line to avoid undefined levels when all transmitters are idle. Enable if the module acts as a master; otherwise disable.

This simplifies wiring and adds flexibility during design and commissioning.

I/O Bus (WBIO)

The I/O Bus is the interface for side‑mounted WBIO modules designed for the Wiren Board controller.

Inside the gateway, the I/O Bus is exposed as a Modbus device on the RS485‑2 port with the address printed on the label. This allows polling WBIO modules via RS‑485 using Modbus RTU, or via network interfaces using Modbus TCP / Modbus RTU over TCP.

If WBIO support is not required and you want to use RS485‑2 for other protocols, you can disable the I/O Bus in settings.

Power for the Module and Connected Devices

By default, the module is powered from 9…28 VDC.

Optionally, a PoE module can be installed with support for:

  • 802.3af, 802.3at — active PoE up to 48 V;
  • Passive PoE — delivering up to 24 V over four pairs.

Supply fed into the module via dedicated terminals is provided to devices connected to the RS‑485 ports. There is a 2.5 A current protection common to both ports, as well as software on/off with state retention across reboots. When powered via PoE, the output provides 24 VDC, with a maximum current of 500 mA on Vout.

All this enables compact installations without extra terminal blocks — and, when using PoE, without a separate power supply.

Indicators

Front‑panel indicators:

  • module status;
  • Ethernet and Wi‑Fi activity;
  • Vout state for powering connected devices;
  • RS‑485 port traffic.

They let you assess the module state without opening the web interface.

Web Interface for Configuration

The modern web UI adapts to any screen size and lets you configure network interfaces, port settings, modes, etc. Access is protected with login and password.

If WB‑MGE v.3 is connected to one of the network interfaces of a Wiren Board controller that is linked to Wiren Board Cloud, you can proxy the module’s web UI through the cloud and access it remotely. See the documentation for details.

Fast Modbus Support

All Wiren Board devices, in addition to standard Modbus RTU, can operate with the extended Fast Modbus ⚡ protocol, which adds:

  • instant reading of input states and measured values via events;
  • fast discovery of devices connected to the controller;
  • address collision resolution on the bus.

WB‑MGE v.3 supports Fast Modbus in all modes: transparent gateway and Modbus TCP.

Reset to Defaults and Factory Mode

If you forget the module settings, you can always reset them to factory defaults using the Config button. The same can be done from the web interface.

For edge cases when the firmware cannot boot, Factory mode is available to reliably flash the latest stable firmware.

Firmware Updates

We occasionally release new firmware to fix issues or add features.

Users can upload a new version directly through the web interface — no programmer required.

DIY — Experiment with Firmware

WB‑MGE v.3 is based on an ESP32 microcontroller and ships with our stock firmware that implements gateway functionality.

However, you can use the hardware with your own firmware and turn the gateway into a compact smart‑home server with the features you need. For convenience we’ve added a USB‑C connector, so you only need a computer and a USB‑C cable to flash your software.

The documentation provides full GPIO descriptions and examples for the popular ESPHome platform. Of course, you can use any tool or language you prefer: C, MicroPython, Lua, etc.

Whatever you try, you can always restore our stock gateway firmware and use the device as intended. The warranty remains valid.

Quality control at each stage of production

We develop and manufacture all Wiren Board devices ourselves. Also everyone devices undergo multi-stage quality control:

  • During development - checking the components used for compliance with the declared ones characteristics and testing of the prototype device at extreme operating conditions.
  • After installation of SMD components - automated optical control.
  • After soldering the lead components - visual inspection of soldering.
  • After assembling the device, functional testing on an automated stand.
  • When shipped to the warehouse - control of completeness, stickers, appearance.

Thanks to this approach, the failure rate is no more than 0.5% of all released devices.

If the device fails within two years from the date of purchase, we will replace it for free without need to be sent to a service center.

Configuration

PoE support
Adds support for operation from Active PoE 802.3af and 802.3at.

Legal purchase terms

  • These terms of sale are developed based on the Civil Code of the Republic of Kazakhstan, the Law of the Republic of Kazakhstan "On Consumer Protection," and other regulatory acts. These rules regulate the procedure for retail purchase and sale of goods through the online store, being a public offer addressed to individuals and legal entities ("Buyers").
  • The Buyer accepts the terms and conditions set out in these terms and conditions by placing an Order on the online store's website. An order is considered properly executed if the Buyer provides the Seller with the following information:
    • Buyer's last name and first name
    • Phone number
    • Delivery address
    • Product name
    • Quantity
  • The Buyer grants the Seller the right to use all personal data transmitted in the Order for the following purposes:
    • Fulfilling obligations to the Buyer
    • Forming and developing a loyalty program
    • Informing Buyers about news from the online store
  • Delivery is carried out through third-party services and is available on weekdays from 9:00 to 18:00. Delivery times depend on the region and range from 1 to 14 business days. Delivery terms include the following:
    • Delivery is without demonstration of the product
    • If the Buyer disagrees with the delivery terms, they may cancel the order at any time before receiving it
    • Delivery costs are charged in case of refusal of the product
    • The Buyer must check the product packaging for damages upon receipt
  • Payment for ordered Products can be made:
    • By bank transfer based on the invoice issued to the Buyer
    • By credit card via a payment link generated for the Buyer
  • Orders are processed on working days from 10:00 to 18:00 Astana time. Orders placed after 18:00 will be processed the next business day.
  • Products of good quality can be returned within 14 days of receipt, provided they have not been used. For returns:
    • The Buyer must email a return request to the Seller's support
    • The refund excludes delivery costs
    • Refunds are processed within 10 days of claim submission
  • The warranty period for the Product is 24 months from the date of shipment.
  • The risk of accidental loss or damage passes to the Buyer at the time of transfer, as confirmed by the Buyer's signature on the delivery documents. Ownership passes upon full payment.
  • The legislation of the Republic of Kazakhstan applies to relations between the Buyer and the Seller.
  • The Seller reserves the right to amend these terms. Changes will be posted on the website at least 7 days before their effective date.
  • The Buyer guarantees they understand and accept all terms unconditionally and in full.
  • All disputes will be resolved through negotiations. If no agreement is reached, disputes will be referred to the arbitration court of Astana.