Openmotorbridge front node

OpenMotorBridge (v10.0) - Universal Motorcycle Intercom & Telemetry Bridge

        

OpenMotorBridge (OMB) is an open-source, cross-vendor communication and telemetry bridge for motorcycles. It seamlessly interconnects proprietary wireless intercom systems (Sena Mesh 3.0 and Cardo DMC Gen2) with an open 2.4 GHz / 868 MHz OpenMotorMesh (OMM), high-precision GNSS Tour Logging (Automotive Dead Reckoning), and a wireless WebBLE PWA cockpit dashboard.

---

📚 Technical Documentation

The comprehensive technical specification is split into 18 logically organized chapters:

1. 01 - System Architecture & Satellite Topology
   The 5 standardized functional nodes, de-sensing philosophy, RF diversity, whitepaper engineering decisions, and cockpit integration.

2. 02 - Intercom Matrix, Hardware Profiles & Routing
   The 5 OEM adapter classes A-E, LittleFS profile engine, zero-latency PTT (< 1.8 ms), and audio cross-matrix.

3. 03 - Audio DSP, Acoustics & Knowles MEMS Wind Tracking
   1500V Bourns isolation, ES8388 Codec, Knowles MEMS acoustic wind sampling, and Raised-Cosine Ducking.

4. 04 - Mesh Network, LoRa & GNSS Navigation
   OpenMotorMesh (OMM), Dynamic Leader Election (DLE), 868 MHz LoRa fallback, and 10 Hz Multi-GNSS.

5. 05 - Power Management, UPS Battery & Power Gate
   LM5164-Q1 72V buck, BQ24075 UPS, TPS25921 Quad-eFuse, Front Node TPS54302 / SW3526 30W PD & 1-click CarPlay hard reboot.

6. 06 - Telemetry Blackbox, SDIO Ringbuffer & WebDAV Sync
   4-bit high-speed SDIO, GDPR/court-compliant ringbuffer, ECDSA SHA-256, and automated private cloud sync.

7. 07 - Hardware Architecture & Board Pinouts (All 10 PCBAs)
   All 10 active circuit boards: layer stackup, controlled impedance, net classes, functional zoning, and pinout tables (PCBA 01, 03, 05, 05B, 05C, 05D, 07, 08, 09, 10).

8. 08 - Mechanical Enclosures, CAD & Reference Mounting Kits
   Screwless Dual-Rail Slide-In Monocoques (Type A & B), Under-Perch Mirror Pod (PCBA 05C), 5-Port Glovebox Hub (PCBA 05B), Sensor Puck (PCBA 05D), Radar 2.0 Winged Housing with Garmin Bayonet, and 4-pin IP67 magnetic breakaway couplers.

9. 09 - Firmware Architecture, FreeRTOS & Rollback-OTA
   Multi-core ESP32-S31 (Main) & ESP32-P4 + ESP32-E22 (Front), Pod Co-Processors (ESP32-C6), ESP-NOW low-latency protocol (< 1.8 ms), and dual-bank rollback OTA.

10. 10 - WebApp PWA & Dashboard Operation
    Zero-cloud PWA web app, Web Bluetooth API (WebBLE), vehicle dynamics HUD, Front Node controls, Support-Van / Convoy profile modes, and 4-tier GPX export.

11. 11 - Smart-Managed CarPlay & Android Auto Bridge Architecture (PCBA 05)
    Harley Skyline OS / Boom! Box integration, CP2AA protocol bridge, Virtual WHIM bypass, source-gated handlebar controls & headless dongle management.

12. 12 - Vehicle CAN-Bus Profiles, DBC JSON Schema & Universal Telemetry Engine
    Data-driven LittleFS profiles for Harley-Davidson, BMW Motorrad, KTM, and OBD2, passive listen-only protection, and EKF tunnel dead reckoning.

13. 13 - Digital Simulation & Multi-Physics Master Testbench
    9 modular Python testbenches and 10 HIL scenarios verifying SPICE, thermal, transients, RF, and acoustics.

14. 14 - EMC Hardening, RF Shielding & Environmental Protection
    Automotive transient immunity (ISO 7637-2), 2.4 GHz vs 868 MHz isolation, IPC-CC-830B coating, and shock damping.

15. 15 - Bill of Materials (BOM) & SMT Manufacturing (All 10 PCBAs)
    Complete 10-board BOM for JLCPCB SMT production, ordering checklist, two-cable backbone harness, and COTS items.

16. 16 - Build Instructions, Wiring & Vehicle Installation
    Step-by-step assembly guide for screwless v10 Slide-In Monocoques, 3D printing parameters (FDM vs. MJF), Front Node & Glovebox Hub mounting, Harley 4-pin magnetic side-wall pass-through, Smart-Keyfob build, and commissioning.

17. 17 - Automotive Standards & Technical References
    Index for ISO 7637-2, ISO 16750, ECE R10, RED 2014/53/EU, IEC 61672-1 Class 1, and Bluetooth SIG.

18. 18 - Legal Compliance, Privacy (GDPR) & Licensing
    Open-source licenses (GPL-3.0, CERN-OHL-S v2, CC BY-SA 4.0), GDPR compliance, and liability disclaimer.

---

🛠️ Repository Layout

• docs/de/: Complete technical specifications in German.
• docs/en/: Complete technical specifications in English.
• firmware/main_controller/: ESP-IDF / C++ source code for the central main box (ESP32-S31, PCBA 01).
• firmware/front_node/: ESP-IDF / C++ source code for the Universal Front Node (ESP32-P4 + ESP32-E22, PCBA 05).
• firmware/smart_cartridge/: ESP-IDF / C++ source code for Saddlebag Pod Gateways Pod 1 & 2 (ESP32-C6, PCBA 03).
• firmware/radar_submcu/: ESP-IDF / C++ source code for Heck-Radar 2.0 Sub-MCU & Halo Wings (ESP32-C5, PCBA 08).
• webapp_pwa/: Zero-cloud offline WebBLE dashboard (HTML5, Vanilla JS, CSS3, Service Worker, i18n).
• hardware/: KiCad schematics, Gerber files, and 3D enclosure CAD models.
• tools/audio_testbench/: Interactive Live Audio DSP Studio & Real-Time Testbench (python3 tools/audio_testbench/server.py $\rightarrow$ Web Audio testbench with live mic, Spacebar PTT, speedometer & ducking).
• tools/simulators/: 9 modular Python simulation testbenches (python3 tools/run_all_simulations.py).

---

📜 Licenses

• Hardware & PCB Layouts: CERN-OHL-S v2 (Strongly Reciprocal)
• Firmware & Web Dashboard: GNU General Public License v3.0 (GPL-3.0)
• Documentation & 3D Models: Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)

---

⚠️ Liability Disclaimer

All information, schematics, board layouts, 3D printing files, and software published in this project are provided free of charge on an "AS IS" basis. Assembly, installation, and operation occur entirely at the user's own risk. All mentioned brand names (Harley-Davidson®, BMW®, Garmin®, Sena®, Cardo®, Apple CarPlay®) are registered trademarks of their respective owners.