skills.rest
open-watt
open-wattOFFICIAL
Explore all skills by this author →
GitHub

zigbee-work

Document Zigbee subsystem architecture for debugging and modifying OpenWatt code.

2|Updated Sep 15, 2023
Search Tags:#debugging#ash#coordinator#zigbee#ezsp#node-storage#protocol-stack
One-click install
npx skills add https://github.com/open-watt/openwatt --skill zigbee-work
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zigbee-work
Source: https://github.com/open-watt/openwatt/tree/main/.claude/skills/zigbee-work
Command: npx skills add https://github.com/open-watt/openwatt --skill zigbee-work

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep architectural knowledge for the Zigbee subsystem helps engineers avoid re-exploration of the OpenWatt Zigbee codebase when modifying or debugging EZSP, coordinator logic, node storage, or ZCL/ZDO workflows.

Core Features & Use Cases

  • ZigbeeInterface manages packet interfaces, message queues, and EZSP callbacks within the router
  • EZSPClient handles EZSP command serialization, ASHInterface lifecycle, and network state transitions
  • ASHInterface provides ASHv2 framing over serial with a sliding window and reliable delivery
  • ZigbeeCoordinator performs network formation, security provisioning, and join handling
  • ZigbeeProtocolModule stores and indexes known nodes, routers, and endpoints for fast lookups
  • ZigbeeController coordinates asynchronous interview loops to discover and register devices
  • Use Case: When integrating a new Zigbee device, quickly understand how the code paths route messages and manage node state.

Quick Start

Inspect and modify Zigbee subsystem code to implement or debug networking, node management, and EZSP protocol handling.

Frequently Asked Questions about zigbee-work

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does the EZSP protocol handle ASH framing for reliable serial communication?▼

The EZSP protocol uses an ASH interface to provide ASHv2 framing over serial connections, utilizing a sliding window mechanism to ensure reliable packet delivery and manage the ASH lifecycle for network state transitions.

How do I debug Zigbee coordinator network formation and device join handling?▼

Debug Zigbee coordinator network formation by inspecting the architectural code paths that manage security provisioning, network formation, and asynchronous interview loops to discover and register new devices joining the network.

How does the Zigbee protocol stack manage node storage and endpoint indexing?▼

The Zigbee protocol stack manages node storage through a dedicated protocol module that stores and indexes known nodes, routers, and endpoints, enabling fast lookups and efficient message routing across the network.

Can I use this architectural knowledge to modify ZCL and ZDO workflows?▼

Yes, the architectural knowledge documents component relationships and Zigbee command flow, allowing you to safely modify ZCL and ZDO workflows, packet interfaces, and message queues without re-exploring the codebase.

What is the best way to trace message routing within a Zigbee protocol stack?▼

The best way to trace message routing is to follow the documented file map and component relationships that detail how the Zigbee interface manages packet queues, EZSP callbacks, and message routing paths.

Related Skills

Explore More Software Engineering Skills→
wimbleroboticswimblerobotics
18

serial-communication-protocol

Design packet-based serial protocols with CRC validation for ROS 2 and microcontrollers.

Community
Advanced
HouseGarofaloHouseGarofalo
3

zigbee2mqtt

Configure and manage Zigbee devices via Zigbee2MQTT for smart home automation.

Official
Intermediate
benswiftbenswift
26

elixir-ash-phoenix

Build and debug Elixir apps with Ash resources and Phoenix LiveView.

Community
Advanced
IlyaGulyaIlyaGulya

xstate-inspection

Inspect XState v5 actor systems via the Inspect API and Stately Inspector.

Community
Intermediate