Hanasu

Encrypted chat and machine-to-machine messaging over a self-healing Thread mesh, on $10 boards, with an embedded Forth and signed over-the-air updates.

Concepts & Vocabulary

The words used throughout the Hanasu docs: nodes, channels, credentials, envelopes, the host link, …

Architecture

How a Hanasu node is layered from the host link down to the 802.15.4 radio, why all output goes …

Boards & Builds

The boards Hanasu runs on, the PlatformIO environments and Zephyr build variants for each, and what …

Getting Started

From zero to two Hanasu nodes chatting on a private channel: build, flash, open the host link, and …

Host Control Protocol (HCP)

The line protocol a host uses to drive a Hanasu node over USB serial or BLE: framing, responses, …

Security Model

How Hanasu derives channel keys, encrypts and authenticates every frame, rejects replays, authorizes …

Wire Protocol

The Hanasu v2.1 envelope byte by byte, frame types, the system command namespace, CoAP resources and …

Extended Transfer (Type 6)

How Hanasu moves photo-sized payloads over Thread: windowed CON unicast with a NACK bitmap, the XFER …

Mesh Time

How a Hanasu mesh shares a wall clock without NTP: one host-seeded anchor, stratum-ranked announces, …

Forth, Bundles & Bots

The Hanasu node's Forth control layer: the dual-mode link, the mn-* vocabulary, chat hooks, boot …

Over-the-Air Updates

How Hanasu firmware travels over the Thread mesh as a signed package, is applied by an admin, and …

OTA Operator Guide

Generate release keys offline, build and sign a release, install it by cable once, then push, apply, …

XIAO MG24 on Zephyr

How the unmodified Hanasu core runs on the Silicon Labs EFR32MG24 under Zephyr: compat layer, …