====== MOSH ======

MOSH is a modular smart-home and embedded networking platform built around flexible nodes, reusable elements, and transport-independent communication.

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 =====

  * [[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.

===== 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.