Wiren BoardDocumentation
Documentation / Expansion modules / WBE2R-R-ZIGBEE v.2
Device manual · English

WBE2R-R-ZIGBEE v.2

Zigbee radio expansion module

revision 107007
Covered order codes (1)
  • WBE2R-R-ZIGBEE v.2

This page describes the new WBE2R-R-ZIGBEE v.2 device; for the previous version, see WBE2R-R-ZIGBEE v.1.

WBE2R-R-ZIGBEE v.2 rear side
WBE2R-R-ZIGBEE v.2 rear side
WBE2R-R-ZIGBEE v.2 front side
WBE2R-R-ZIGBEE v.2 front side

Module overview

WBE2R-R-ZIGBEE v.2 uses the RF-BM-2652P2I radio module with a Texas Instruments CC2652P chip (documentation), supporting Z-Stack 3.x, up to 50 directly connected devices and up to 200 through routers (information source).

Technical specifications

Parameter Value
Transmitter model RF-BM-2652P2I
Transmit power 20 dBm (100 mW)
Power consumption, W 0.3
Warranty 2 years
Service life 8 years

The module has no built-in antenna. Connect an external antenna through the RP-SMA female connector.

When a Wiren Board controller is ordered with the module, the external-antenna connector is installed in the controller enclosure.

Installation

The module is compatible with all revisions of the Wiren Board 6, Wiren Board 7 and Wiren Board 8 controllers, subject to the compatibility table below:

Module and controller connector compatibility
Model WB6.3 — 6.6 WB6.7/WB7 WB8.4 WB8.5
MOD1 MOD2 MOD3 MOD1 MOD2 MOD3 MOD4 MOD1 MOD2 MOD3 MOD4 MOD1 MOD2 MOD3 MOD4
WBE2R-R-ZIGBEE v.2 + + + + + + + - + + - + + + +


When modules are ordered together with a Wiren Board controller, the manufacturer installs them at the factory. You only need to configure the modules in the controller web interface .

If you purchased the modules separately, install them as follows:

  1. Open the controller enclosure.
  2. Install the module with the correct polarity: its locating tab must enter the slot on the controller PCB.
  1. Secure the SMA socket in the enclosure hole above the Ethernet connectors using its nuts. The socket and enclosure hole have a flat section that aligns the connector and prevents rotation. Enclosures earlier than Wiren Board 6.5 require drilling a 6.5 mm hole.
  2. Reassemble the enclosure. The cable between the module and SMA socket must not be pinched, sharply bent or trapped between the LED and the top-cover light guide.
  3. Screw the external antenna onto the SMA socket.
  4. For reliable radio communication in a metal cabinet, position the antenna outside it.

Configuration

Access permissions

User configuration
User configuration


The access level depends on the user account. Users authenticate with a username and password. To change the controller settings, your account must have the following access level: Admin. User accounts are managed under Settings → Users. See User authentication and authorization.

In releases earlier than wb-2602 there are no user accounts; the access level is configured under Settings → Permissions.

Configuration

Configuring expansion modules in the Wiren Board controller web interface
Configuring expansion modules in the Wiren Board controller web interface

After physically connecting the module, add it to the controller configuration:

  1. In the web interface, open Settings → Configs → Expansion modules and ports and select the Internal slot in which the expansion module is installed.
  2. In the Module type list, select the name of the installed module.
  3. Click Save. The controller will enable the ports required by the module.

To remove a module from the configuration, select Not installed.

Module type to select in the field Module type: WBE2R-R-ZIGBEE.

Note: an operating WBE2R-R-ZIGBEE v.2 module does not appear on the Devices.

After installing the module, install zigbee2mqtt on the controller following:

Transmitter power configuration

Transmit power is set in the zigbee2mqtt configuration.

Firmware

The module is shipped with firmware installed and is ready to use. Reflash it only when necessary.

Updating WBE2R-R-ZIGBEE firmware

Use with a Wiren Board controller

Communication with the module uses a serial port whose name depends on the connector containing the module.

Expansion module Serial port
MOD1 /dev/ttyMOD1
MOD2 /dev/ttyMOD2
MOD3 /dev/ttyMOD3
MOD4 /dev/ttyMOD4

Controller configuration instructions are available in Connecting Zigbee devices to a Wiren Board controller

Known issues

WBE2R-R-ZIGBEE v.2 known issues (errata)

Hardware revisions

The batch number is printed on a label on the side of the enclosure or on the PCB.

Revision Batches Release date Changes from the previous revision
2.4 v2.4D, v2.4F - ... 09.2025 - ...
  • Firmware CC1352P2_CC2652P_launchpad_coordinator_20250321
2.4 v2.4A/1, v2.4B, v2.4C, v2.4E 03.2025 - 09.2025
2.4 v2.4A 02.2025 - 03.2025
  • Minor internal changes
2.3 v2.3C/1, v2.3D, v2.3E, v2.3F, v2.3G 06.2024 - 02.2025
  • Right-angle SMA on the u.FL–SMA adapter cable
2.3 v2.3A, v2.3B, v2.3C 10.2023 - 06.2024
  • Larger PCB cutout for WB7.4 compatibility
2.2 v2.2A, v2.2B, v2.2C, v2.2D, v2.2E, v2.2F, v2.2G, v2.2H, v2.2H/G, v2.2I 07.2022 - 10.2023
  • Minor internal changes
2.1 v2.1A 06.2022
  • Module based on RF-BM-2652P2I
  • Firmware CC1352P2_CC2652P_other_coordinator_xxxxxxxx
Revision 107007.