Builder for Silabs multiprotocol (Zigbee, OpenThread, Bluetooth Low Energy) components.

Uses Silicon Labs Simplicity SDK and Silicon Labs Configurator (slc) to build binaries and configurations files for supported architectures (arm32, arm64, x86_64). It mimics the official Silicon Labs Multiprotocol Docker container to be able to use the components outside of containers.

The following installation steps have been tested (unless otherwise noted) on Ubuntu 24.04 x64 (VirtualBox) with a Sonoff Dongle-E with this firmware.

This step extracts the previously downloaded archive in its own folder and runs the necessary local adjustments to the newly extracted files, including possible customization.

tar xf silabs-multiprotocol-components-ARCH.tar.xz --one-top-level
cd silabs-multiprotocol-components-ARCH
sudo chmod +x ./pre-setup.sh
sudo ./pre-setup.sh

• --device-path DEVICE_PATH
  • The path to your physical adapter.
  • Default: /dev/ttyACM0.
• --baudrate BAUDRATE
  • The baudrate of your RCP firmware.
  • Default: 460800.
• --hardware-flow HARDWARE_FLOW
  • The flow control of your RCP firmware (sw or rtscts=false should set this to false).
  • Default: true.
• --disable-encryption DISABLE_ENCRYPTION
  • See CPCd configuration below.
  • Default: true.
• --disable-conflict-services DISABLE_CONFLICT_SERVICES
  • Automatically disables conflicting services on your machine when set to true. Note: This is false by default as that may alter your current machine's state in an undesirable way. Check script/_disable_services for details on what may be conflicting if you wish to do it manually.
  • Default: false.
• --zigbeed-iid ZIGBEED_IID
  • The zigbeed process interface id (iid) which is used to differentiate between multiple networks using the same RCP. The iid must be set to a value between 1 and 3 and must be unique for each host process using the multi-PAN 802.15.4 RCP.
  • Default: 1.
• --otbr-iid OTBR_IID
  • Same as above, for OTBR process.
  • Default: 2.

This is the default if no parameter given:

sudo ./pre-setup.sh --device-path /dev/ttyACM0 --baudrate 460800 --hardware-flow true --disable-encryption true --disable-conflict-services false --zigbeed-iid 1 --otbr-iid 2

These components currently require an RCP firmware version 2024.6.1. You can find some experimental builds here: https://github.com/Nerivec/silabs-firmware-builder/releases/tag/v2024.6.1

rcp-uart-802154-blehci => with BLE support.

rcp-uart-802154 => without BLE support (you won't be able to use the BLE components).

This step installs the requested components and sets up any startup requirements.

sudo chmod +x ./install.sh
sudo ./install.sh

By default (without parameters), the script only installs cpcd (required for all others), use the parameters below to install the components you want.

• --zigbeed
  • Install zigbeed components.
• --otbr
  • Install otbr components.
• --ot-cli
  • Install ot-cli components.
• --ble
  • Install ble components.
• --skip-cpcd
  • Skip installation of cpcd components (useful if you want to launch the script in multiple steps to install components one at a time).
• --all
  • Takes precedence over --skip-cpcd if supplied after it, doesn't if before it.
• --infra-if-name INFRA_IF_NAME
  • Interface name (for OTBR), usually eth0 or enp0s3.
  • Default: return value of ip -o -4 route show to default | awk '{print $5}'.

Base communication protocol for RCP support.

Location: /usr/local/etc/cpcd.conf

Add ZigBee support.

Location: /usr/local/etc/zigbeed.conf

Location: /etc/systemd/system/zigbeed-socat.service

To use TCP instead, you can change the default socat command to something like this:

ExecStart=/usr/bin/socat -v tcp-l:9627,reuseaddr,fork pty,link=/tmp/ttyZigbeeNCP,raw

Then you can use 127.0.0.1:9627 in your ZigBee application (in whatever IP/port format required). Check other socat tutorials to configure the TCP part as needed.

Add OpenThread support.

See https://openthread.io/reference/cli/commands and https://openthread.io/guides/border-router/tools for more details.

sudo /usr/local/bin/ot-cli 'spinel+cpc://cpcd_0?iid=2&iid-list=0'

See README.md for more details.

Add Bluetooth Low Energy support.

Bluetooth CLI utility:

sudo bluetoothctl

View traffic:

sudo btmon

Use journalctl to get more information if a service is misbehaving or just to check the logs:

sudo journalctl -fexu cpcd
sudo journalctl -fexu zigbeed-socat
sudo journalctl -fexu zigbeed
sudo journalctl -fexu otbr-agent
sudo journalctl -fexu otbr-web
sudo journalctl -fexu cpc-hci-bridge
sudo journalctl -fexu hciattach
sudo journalctl -fexu bluetooth