Differences

This shows you the differences between two versions of the page.

--- start [2026/06/10 14:10] – mosh
+++ start [2026/06/11 01:40] (current) – [For Protocol Development] mosh
@@ Line 1: / Line 1: @@
-===== MOSH (Modern Offline Smart Home) =====
+====== MOSH ======
-MOSH is a modular, offline-first protocol for building smart home systems that are private, reliable, and resilient—designed specifically for embedded devices like the Teensy, ESP32, and nRF52.
+MOSH is a modular smart-home and embedded networking platform built around flexible nodes, reusable elements, and transport-independent communication.
-This wiki is your central hub for all things MOSH:
+It is designed to let small devices, bridge nodes, and higher-capability controllers participate in one system while keeping routing, messaging, and application behavior clearly separated.
-from getting started with basic nodes to understanding how to extend the protocol.
-[[guide:project_vision|Project Vision]]
+===== Start Here =====
-[[mosh:protocol_overview|Protocol Overview]]
+  * [[guide:project_vision|Project Vision]]
+    * Curious about why all this was developed?
+  * [[guide:start|Getting Started]]
+    * New to MOSH? Start here for the high-level architecture and first steps.
+  * [[mosh:start|MOSH Overview]]
+    * Learn how MOSH models nodes, elements, and system behavior.
+  * [[mtrp:start|MTRP Protocol]]
+    * Read the routing and transport protocol reference.
+  * [[imc:start|IMC Layer]]
+    * Learn how MOSH bridges application behavior to carriers and protocols.
-[[mosh:protocol_details|Protocol Details]]
+===== What MOSH Is =====
+MOSH is organized in layers:
+  * ''MOSH'' defines smart-home and node behavior
+  * ''IMC'' provides the message and carrier abstraction between layers
+  * ''MTRP'' provides routing and multi-transport packet delivery
+  * ''Hardware/Transports'' provide the physical communication paths
+This separation allows the system to grow without tightly coupling application logic to any single radio, board, or transport.
+===== Documentation Paths =====
+==== For Builders ====
+  * [[guide:first_node|Build a First Node]]
+  * [[hardware:support_matrix|Supported Platforms]]
+  * [[hardware:transport_options|Transport Options]]
+==== For MOSH Development ====
+  * [[mosh:architecture|MOSH Architecture]]
+  * [[mosh:virtual_wires|Virtual Wires]]
+  * [[mosh:elements|Elements]]
+  * [[mosh:nodes|Node Roles]]
+==== For Protocol Development ====
+  * [[mtrp:overview|MTRP Overview]]
+  * [[mtrp:frame_format|Frame Format]]
+  * [[mtrp:messages|Control Messages]]
+  * [[mtrp:routing|Routing Behavior]]
+  * [[mtrp:policies|Routing Policies]]
+  * [[mtrp:diagnostics|Diagnostics]]
+==== For Architecture Reference ====
+  * [[guide:architecture_map|Architecture Map]]
+  * [[imc:carrier|IMC Carrier Model]]
+  * [[imc:mtrp_carrier|MTRP Carrier]]
+===== Project Status =====
+MOSH is under active development.
+Some older pages may describe behavior or architecture that has since changed. When in doubt, prefer:
+  * [[guide:architecture_map|Architecture Map]]
+  * [[mosh:architecture|Current MOSH Architecture]]
+  * [[mtrp:start|Current MTRP Reference]]
+===== Notes =====
+  * Legacy or outdated documentation may be retained for reference during development.
+  * Protocol and architecture pages are being updated gradually toward the current design.