JetHome Zigbee USB Stick JetStick Z4 (EFR32MG21)
The JetStick Z4 stick is designed to work as a Zigbee coordinator and can be used to control other home infrastructure wireless devices that operate on the Zigbee protocol as part of a Smart Home controller with the appropriate software installed and configured.
The stick is based on a modern wireless microcontroller for the 2.4GHz band Silicon Labs EFR32MG21A020F1024IM32 ( microcontroller description ) and is characterized by high performance, increased transmitter output power and compact size.
Main technical characteristics:
- 80MHz Arm® Cortex®-M33 processor;
- Flash memory 1024KB;
- SRAM 96KB;
- Transmitter output power up to +20 dBm;
- Supply voltage 5V from USB port;
- The current consumption in the active mode is not more than 150 mA.
- Overall dimensions of the stick in the case without an external antenna: 62 x 18 x 10 mm.
The package includes an external 2.4 GHz antenna. The stick can also be used with other external 2.4GHz antennas. To connect an external antenna, use the RP-SMA connector installed on the stick board.
On the board of the stick are also placed:
- button to switch the boot mode of the microcontroller (used to flash the microcontroller). To access the button, you need to open the body of the stick;
- two LEDs (green and red) that can be used to display stick operation modes. The operation of the LEDs depends on the firmware installed in the microcontroller stick.
The stick is intended for use in residential and office premises. Operating conditions:
- Ambient temperature: 0..+40 С;
- Relative air humidity up to 80% without moisture condensation;
- Closed rooms without aggressive vapors and gases.
The stick comes preinstalled with a bootloader and coordinator firmware based on the original Silicon Labs EZSP Coordinator v8 firmware (see Supported Firmwares). Factory firmware serial port settings: baud rate 115200 bps, software flow control Xon/Xoff.
The manufacturer is not responsible for possible incorrect operation of the stick due to errors in the software.
Attention! This device is not professional equipment for security and control systems. And it cannot be used on objects that potentially pose a danger to the life and health of others.
The transition to the bootloader mode is carried out at a low logic level at the input PB00 of the microcontroller. You can control the state of this input using the "FLASH" button installed on the board of the stick. A low logic level at the PB00 input is set when the button is pressed.
The LEDs are connected to the microcontroller pins PD02 (red LED) and PD03 (green LED). A high logic level on these pins lights the corresponding LED.
The UART TX line is connected to the PA05 pin of the microcontroller, UART RX - PA06. Hardware flow control is not used. To connect the microcontroller to the computer, a Silicon Labs CP2102 USB-UART interface converter chip is used.
For information on supported firmware, see the documentation: Software for sticks and modules based on the Silicon Labs EFR32MG21 chip
Stick flashing procedure
For instructions on flashing the stick, see the documentation: Instructions for flashing microcontrollers EFR32MG21
To switch the stick to bootloader mode:
- Open the stick body;
- While holding down the "FLASH" button on the stick board, insert the stick into the computer's USB port;
- Release the FLASH button.
Using the Stick with Home Assistant
When using the recommended firmware for the coordinator (see p. "Supported firmware"), the stick provides work as a coordinator in conjunction with Home Assistant .
In Home Assistant, you need to install the ZHA add-on:
- Connect the stick to the computer (controller);
- On the main page of the Home Assistant web interface, select the "Configuration" menu, then "Integrations".
- Click on the "+" button at the bottom right and select "ZHA" from the list of supported add-ons;
- In a popup windowin the line "Serial Device Path" a list of detected serial devices will be displayed. Select the required device (if only one stick is connected to the computer, then as a rule the device name is /dev/ttyUSB0);
- Click on the button "Confirm" (Submit);
- The type of Zigbee adapter will be determined automatically and after a successful connection, information about it will be displayed.
Using a stick with Zigbee2MQTT
Support for Silabs-based coordinator in Zigbee2MQTT is in the experimental and testing phase. Correct operation of the stick with Zigbee2MQTT is not guaranteed.
To use a stick in the Zigbee2MQTT configuration.yaml configuration file, in the serial: section, you must specify the adapter type:
serial: adapter: ezsp
If firmware with UART speed 57600 Bps is used, then additionally in the advanced: section, you must specify the port speed:
advanced: baudrate: 57600