GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - Vanderhell/uMesh: Lightweight open mesh protocol over raw 802.11 for ESP32

BranchesTags
Open more actions menu

Latest commit

 

History

87 Commits
87 Commits

Folders and files

NameName
Last commit message
Last commit date
.github
.github
 
 
docs
docs
 
 
examples
examples
 
 
include
include
 
 
port
port
 
 
releases
releases
 
 
src
src
 
 
tests
tests
 
 
third_party
third_party
 
 
tools
tools
 
 
.gitignore
.gitignore
 
 
.gitmodules
.gitmodules
 
 
CHANGELOG.md
CHANGELOG.md
 
 
CMakeLists.txt
CMakeLists.txt
 
 
CONTRIBUTING.md
CONTRIBUTING.md
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
SECURITY.md
SECURITY.md
 
 
SUPPORT.md
SUPPORT.md
 
 
VERIFICATION.md
VERIFICATION.md
 
 
library.properties
library.properties
 
 

Repository files navigation

µMesh (uMesh)

Strict documentation policy: every important claim is either verified by repository contents and/or commands executed in this run, explicitly marked NOT VERIFIED, or removed.

Status (this run)

Verified by test execution (Windows / MSVC / CMake, POSIX port):

  • CMake configure/build succeeded for -DUMESH_PORT=posix -DUMESH_BUILD_TESTS=ON
  • ctest ran 13 tests and reported 100% pass (13/13)
    Evidence: VERIFICATION.md

CI (configuration only):

  • GitHub Actions workflow exists for Ubuntu + Windows POSIX builds: .github/workflows/ci.yml
    NOT VERIFIED: whether CI is currently passing on GitHub.

What is implemented (code-visible)

µMesh is a C99 library that implements a small mesh-style protocol on top of a “raw 802.11 frame” PHY abstraction with separate modules for:

  • PHY abstraction: src/phy/ (+ ESP32 and POSIX ports in port/)
  • MAC: src/mac/ (send path includes CSMA/CA/backoff + ACK/retry logic)
  • Network: src/net/ (discovery + routing modes)
  • Security: src/sec/ (AES-128-CTR + HMAC-SHA256 truncated MIC + replay window)
  • Optional power-management module: src/power/ (compile-time gated)

Verification and evidence

See:

  • VERIFICATION.md (commands run, results, and what was NOT run)
  • docs/DIAGRAMS.md (Mermaid diagrams derived from the code paths)
  • SECURITY.md (threat model + limitations; no “strong security” claims without proof)

Version consistency

Package / release version currently implemented in code: 1.5.0 (docs/IMPLEMENTATION.md mirrors the versioned package metadata). v1.4.0 is historical and remains unchanged.

Release tag prepared in this release: v1.5.0 This tag is separate from the wire protocol version and from compatibility wrappers.

Wire protocol version: UMESH_WIRE_VERSION in include/umesh.h This field is independent from the package/release tag.

NOT VERIFIED: Git tags / GitHub releases in this run beyond local git inspection.

Getting started (API)

The public header is include/umesh.h. For configuration fields and defaults, see docs/API_REFERENCE.md (defaults are derived from code in src/umesh.c and constants in src/common/defs.h).

What is NOT VERIFIED (intentionally not claimed here)

This repository (and this run) does not provide measured evidence for radio range, throughput, latency, or current consumption. Any such numbers must be backed by reproducible measurement artifacts (hardware, antenna, channel, TX power, environment) and linked from documentation.

Documentation index

  • docs/COOKBOOK.md
  • docs/API_REFERENCE.md
  • docs/KNOWN_LIMITATIONS.md
  • CONTRIBUTING.md
  • SUPPORT.md
  • docs/SECURITY_LAYER.md
  • docs/PHYSICAL_LAYER.md
  • docs/MAC_LAYER.md
  • docs/NETWORK_LAYER.md
  • docs/POWER_MANAGEMENT.md
  • docs/KNOWN_ISSUES.md

License

MIT (see LICENSE).

About

Lightweight open mesh protocol over raw 802.11 for ESP32

Topics

802-11c99embeddedesp32iotiot-protocolmeshmesh-networkprotocolsensor-networkwirelesszero-allocation

Resources

Readme
MIT license

Contributing

Contributing

Security policy

Security policy
Activity

Stars

6 stars

Watchers

0 watching

Forks

2 forks
Report repository

Releases

Packages

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.