zig-a-zig-ah! (zzh, for short) is a tiny "USB stick" form-factor development board for multiprotocol RF tinkering.
- TI CC2652R 2.4 GHz multi-protocol wireless microcontroller targeting Thread, Zigbee, Bluetooth 5 Low Energy, IEEE 802.15.4g, IPv6-enabled smart objects (6LoWPAN) and proprietary systems
- Communicates with the host computer via the common CH340 USB-UART bridge, no manual driver installation needed in most cases (Windows, Linux, FreeBSD, OpenBSD, and macOS), no driver support for illumos
- Self-programming via the TI CC-series serial bootloader. As long as it is not explicitly disabled in code, no external programmer needed! Pushbutton on the default pin to trigger this mode
- cJTAG debug header, in case you disable BSL by accident or want a proper debug interface
- SMA antenna port for an external antenna of your choice
- General purpose LED
It is designed to fit in a tiny Gōng mó "USB Shell" and looks a bit like this when paired with your favourite SBC:
Think of it as an upgrade to the ubiquitous CC2531 USB Sticks commonly used for Zigbee tinkering. CC2652 has a much beefier processor, more memory and a sane free compiler that should enable easier development compared to the old 8051 based CC2530/1 devices.
Assembled versions of zzh are available on the Electrolama Tindie Store. Orders ship from London, UK.
Each zzh order contains a fully assembled and tested PCBA along with a plastic enclosure and a small antenna:
An optional debug adapter kit of parts (requires assembly) can also be purchased:
Please keep in mind that zzh is a general purpose development board. It is shipped with a simple test program that just blinks the LED on and off (with no radio functionality) to verify that the MCU is running. You will need to program it before it does anything meaningful. Given the application dependent nature of this board, limited after-sales support can be provided for Tindie purchases (For example: we can help you program this board but can't fix your Zigbee network range issues or offer specific software support).
ℹ️ Documentation has moved! Please head over to the Quick Start guide and follow along.
Links below are kept for archival reasons.
Drivers for CH340
Flashing using BSL
Flashing using external debugger
Zigbee Home Automation (ZHA) integration in Home Assistant
Aside: TI Part Numbers
In the repo, click here.
zig-a-zig-ah! is designed by Electrolama / Omer Kilic and licensed under the Solderpad Hardware License 2.0.
This kit is designed to allow Product developers to evaluate electronic components, circuitry, or software associated with the kit to determine whether to incorporate such items in a finished product and Software developers to write software applications for use with the end product. This kit is not a finished product and when assembled may not be resold or otherwise marketed unless all required FCC (or any other local authority) equipment authorizations are first obtained. Operation is subject to the condition that this product not cause harmful interference to licensed radio stations and that this product accept harmful interference.
- @GeorgeIoak and @matthewvenn for design review and comments during early prototyping
- Fredrik K for his domain expertise, design review and (much appreciated!) RF help
- @KoenKK for his work on the great Zigbee2mqtt project and testing prototypes
- @egelmex for testing prototypes, improving docs and being an all around cool dude
- All the contributors to the documentation repo!
Name credit goes to @9600, this had a much boring name before he suggested zig-a-zig-ah!
For general enquiries, suggestions and errors spotted: Email us at [email protected]. Community contributions to these pages are very much encouraged so you could also send pull requests on the documentation repo (source of these pages) with your proposed changes.
For support regarding Tindie purchases: [email protected]. Please note that we do not monitor Github issues or third party forums for customer support.