Differences

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

--- start [2025/07/03 15:34] – [🔐 Philosophy] mosh
+++ start [2026/06/11 01:40] (current) – [For Protocol Development] mosh
@@ Line 1: / Line 1: @@
-====== Welcome to the MOSH Wiki ======
+====== MOSH ======
+MOSH is a modular smart-home and embedded networking platform built around flexible nodes, reusable elements, and transport-independent communication.
-==== Modern Offline Smart Home ====
+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.
+===== Start Here =====
-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.
+  * [[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.
-This wiki is your central hub for all things MOSH:
+===== What MOSH Is =====
-from getting started with basic nodes to understanding how to extend the protocol and contribute back.
+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
-===== 🚀 Getting Started =====
+This separation allows the system to grow without tightly coupling application logic to any single radio, board, or transport.
-[[mosh:project_vision|Project Vision]]
+===== Documentation Paths =====
-[[mosh:overview|Project Overview]]
+==== For Builders ====
+  * [[guide:first_node|Build a First Node]]
+  * [[hardware:support_matrix|Supported Platforms]]
+  * [[hardware:transport_options|Transport Options]]
-[[mosh:protocol_overview|Protocol Overview]]
+==== For MOSH Development ====
-===== 💻 MOSH Nodes =====
-[[mosh:devices:bridge|Bridge]] -- A node that relays messages between different transports.
+  * [[mosh:architecture|MOSH Architecture]]
+  * [[mosh:virtual_wires|Virtual Wires]]
+  * [[mosh:elements|Elements]]
+  * [[mosh:nodes|Node Roles]]
-[[mosh:devices:coordinator|Coordinator]] -- The primary logic node that manages the local network.
+==== For Protocol Development ====
-[[mosh:devices:gateway|Gateway]] -- A node that interfaces with external systems (e.g., internet, phone app, MQTT).
+  * [[mtrp:overview|MTRP Overview]]
+  * [[mtrp:frame_format|Frame Format]]
+  * [[mtrp:messages|Control Messages]]
+  * [[mtrp:routing|Routing Behavior]]
+  * [[mtrp:policies|Routing Policies]]
+  * [[mtrp:diagnostics|Diagnostics]]
-[[mosh:devices:peripheral|Peripheral]] -- A node that performs a dedicated function (like sensing or controlling).
+==== For Architecture Reference ====
-===== 🧠 Core Concepts =====
-[[mosh:mosh_core|Mosh Core]]
+  * [[guide:architecture_map|Architecture Map]]
+  * [[imc:carrier|IMC Carrier Model]]
+  * [[imc:mtrp_carrier|MTRP Carrier]]
-[[mosh:element_manager|Element Manager]]
+===== Project Status =====
-[[mosh:virtual_wire_manager|Virtual Wire Manager]]
+MOSH is under active development.
-[[mosh:transport_manager|Transport Manager]]
+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 =====
-===== 🧰 Libraries & APIs =====
+  * Legacy or outdated documentation may be retained for reference during development.
+  * Protocol and architecture pages are being updated gradually toward the current design.
-[[mosh:element_library|Element Library]]
-[[mosh:sensor_library|Sensor Library]]
-[[mosh:transports|Transports]]
-[[mosh:supported_platforms|Hardware Support Matrix]]
-===== 📟 Official Hardware and Nodes =====
-[[mosh:hardware:coordinator|MOSH Coordinator]] (Waveshare 7-inch Display Development Board)
-[[mosh:hardware:bridge|Bridge]]
-[[mosh:hardware:gateway|Gateway]]
-==== 🎚️Peripherals ====
-[[mosh:hardware:peripherals:movement_detection|Movement Detection]] (Waveshare ESP32 With Display and QMI8658 IMU)
-[[mosh:hardware:peripherals:human_detection|Human Detection]] (Waveshare Human Micro-Motion Detection mmWave Sensor)
-===== 🤝 Contribute =====
-MOSH is an evolving protocol, and your contributions are welcome.
-How to Contribute
-Code Style Guide
-Submit a Proposal