lattice-protocol

README

lattice-protocol

Shared protocol definitions for the Lattice mesh network. Defines the opcode and adapter-type constants consumed by all Lattice services and firmware.

Used by:

• motionSensorServer (Go) — imports as a Go module
• Lattice-nodes (ESP32/C++) — includes via git submodule

Packages

Package	Description
opcodes/	Serial command opcode constants (Go)
adapter/	Adapter type identifiers and helpers (Go)
c/	Generated C headers for firmware — do not edit directly
cmd/gen-headers/	Generator that writes c/ from the Go constants

Usage

Go (motionSensorServer)

import (
    "github.com/superbrobenji/lattice-protocol/opcodes"
    "github.com/superbrobenji/lattice-protocol/adapter"
)

payload[0] = opcodes.OpLEDSolid
if adapter.IsOutput(node.AdapterType) { ... }

C (Lattice-nodes — via git submodule at main/lib/lattice-protocol)

#include "lib/lattice-protocol/c/opcodes.h"
#include "lib/lattice-protocol/c/adapter_types.h"

payload[0] = OP_LED_SOLID;

Set up the submodule:

git submodule update --init

Contributing

See CONTRIBUTING.md for the full protocol contribution workflow — adding opcodes or adapter types, regenerating C headers, and opening a PR.

Versioning

This module follows semver. Consumers pin to a tag.

Tag	Notes
v0.3.0	Add health opcodes 0xB0/0xB1/0xB2
v0.2.1	Lower go directive to 1.21.0
v0.2.0	Generated C headers; submodule support
v0.1.0	Initial release

License

Copyright (C) 2026 Lattice Contributors

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

See LICENSE for the full terms.