zigbee

type APSFrame struct {
	FrameControl APSFrameControl `json:"frame_control"`
	// DestinationEndpoint is the 1-byte destination endpoint
	// (Data / Ack frames only; absent for Group delivery mode
	// where the group address replaces it).
	DestinationEndpoint *int `json:"destination_endpoint,omitempty"`
	// GroupAddress is the 2-byte group address (present only
	// when DeliveryMode = Group on Data/Ack frames).
	GroupAddress    string `json:"group_address,omitempty"`
	GroupAddressRaw int    `json:"group_address_raw,omitempty"`
	// ClusterID is the 2-byte cluster identifier (Data/Ack only).
	ClusterID    string `json:"cluster_id,omitempty"`
	ClusterIDRaw int    `json:"cluster_id_raw,omitempty"`
	// ProfileID is the 2-byte profile identifier (Data/Ack only).
	ProfileID    string `json:"profile_id,omitempty"`
	ProfileIDRaw int    `json:"profile_id_raw,omitempty"`
	// SourceEndpoint is the 1-byte source endpoint (Data/Ack
	// only).
	SourceEndpoint *int `json:"source_endpoint,omitempty"`
	// APSCounter is the 1-byte APS sequence counter.
	APSCounter int `json:"aps_counter"`
	// ExtendedHeaderHex is the raw extended header bytes when
	// the flag is set. Walking it (fragmentation control / block
	// number / ack bitfield) is deferred to a follow-on Spec.
	ExtendedHeaderHex string `json:"extended_header_hex,omitempty"`
	// AuxSecurityHeaderHex is the raw APS aux security header
	// when the Security flag is set. Same shape as the NWK
	// security header (1-byte security control + 4-byte frame
	// counter + optional 8-byte source IEEE + optional 1-byte
	// key sequence number).
	AuxSecurityHeaderHex string `json:"aux_security_header_hex,omitempty"`
	// PayloadHex is the APS payload after all headers.
	PayloadHex string `json:"payload_hex,omitempty"`
	// ProfileName is the recognised Zigbee profile (HA, ZLL,
	// SE, ZDP, Green Power, etc.) when ProfileID is in the
	// well-known set.
	ProfileName string `json:"profile_name,omitempty"`
}

type APSFrameControl struct {
	Raw int `json:"raw"`
	// FrameType (bits 1..0).
	FrameType     int    `json:"frame_type"`
	FrameTypeName string `json:"frame_type_name"`
	// DeliveryMode (bits 3..2).
	DeliveryMode     int    `json:"delivery_mode"`
	DeliveryModeName string `json:"delivery_mode_name"`
	// AckFormat (bit 4) — only meaningful for Acknowledge frames
	// (0 = APS data ACK, 1 = APS command ACK).
	AckFormat bool `json:"ack_format"`
	// Security (bit 5) — APS auxiliary security header present.
	Security bool `json:"security"`
	// AckRequest (bit 6) — sender wants an APS-level ACK.
	AckRequest bool `json:"ack_request"`
	// ExtendedHeader (bit 7) — APS extended header present.
	ExtendedHeader bool `json:"extended_header_present"`
}

type APSFrameType int

type DeliveryMode int

type DiscoverRoute int

type Frame struct {
	FrameControl FrameControl `json:"frame_control"`
	// DestinationAddress is the 16-bit short address of the
	// destination node (or broadcast 0xFFFF / 0xFFFD / 0xFFFC /
	// 0xFFFB for documented broadcast classes).
	DestinationAddress    string `json:"destination_address"`
	DestinationAddressRaw int    `json:"destination_address_raw"`
	// SourceAddress is the 16-bit short address of the source.
	SourceAddress    string `json:"source_address"`
	SourceAddressRaw int    `json:"source_address_raw"`
	// Radius is the hop limit (decremented at each forwarding hop).
	Radius int `json:"radius"`
	// SequenceNumber is the NWK-layer sequence number.
	SequenceNumber int `json:"sequence_number"`
	// DestinationIEEEHex / SourceIEEEHex are populated when the
	// respective presence flag is set. Stored little-endian on
	// wire, rendered big-endian to match the form printed on
	// device labels.
	DestinationIEEEHex string `json:"destination_ieee,omitempty"`
	SourceIEEEHex      string `json:"source_ieee,omitempty"`
	// MulticastControl is populated when the multicast flag is
	// set. The byte encodes mode + non-member radius + max
	// non-member radius.
	MulticastControl *MulticastControl `json:"multicast_control,omitempty"`
	// SourceRouteHex is the raw source-route subframe when the
	// flag is set (relay count + relay index + relay list).
	SourceRouteHex string `json:"source_route_hex,omitempty"`
	// AuxSecurityHeaderHex is the raw security header when the
	// flag is set. Walking it (security level / key identifier /
	// frame counter) is deferred to a follow-on Spec.
	AuxSecurityHeaderHex string `json:"aux_security_header_hex,omitempty"`
	// PayloadHex is the NWK payload after all headers.
	PayloadHex string `json:"payload_hex,omitempty"`
	// BroadcastClass names the well-known broadcast destination
	// when applicable.
	BroadcastClass string `json:"broadcast_class,omitempty"`
}

type FrameControl struct {
	Raw int `json:"raw"`
	// Frame Type (bits 1..0).
	FrameType     int    `json:"frame_type"`
	FrameTypeName string `json:"frame_type_name"`
	// Protocol Version (bits 5..2) — Zigbee Pro R22 uses 2.
	ProtocolVersion int `json:"protocol_version"`
	// Discover Route (bits 7..6).
	DiscoverRoute     int    `json:"discover_route"`
	DiscoverRouteName string `json:"discover_route_name"`
	// Bit 8: Multicast (when set, multicast control byte follows
	// the addressing fields).
	Multicast bool `json:"multicast"`
	// Bit 9: Security (auxiliary security header present).
	Security bool `json:"security"`
	// Bit 10: Source Route (source route subframe present).
	SourceRoute bool `json:"source_route"`
	// Bit 11: Destination IEEE Address present (8 bytes after
	// source NWK address).
	DestinationIEEE bool `json:"destination_ieee_present"`
	// Bit 12: Source IEEE Address present.
	SourceIEEE bool `json:"source_ieee_present"`
}

type MulticastControl struct {
	Raw                int    `json:"raw"`
	Mode               int    `json:"mode"`
	ModeName           string `json:"mode_name"`
	NonMemberRadius    int    `json:"non_member_radius"`
	MaxNonMemberRadius int    `json:"max_non_member_radius"`
}

type NWKFrameType int