Skip to content

Latest commit

 

History

History
64 lines (48 loc) · 3.54 KB

README.md

File metadata and controls

64 lines (48 loc) · 3.54 KB

ESP32 Avionics Command Console (Web BLE)

This project provides a high-fidelity, single-page web interface for controlling an ESP32 "Master" board via the Web Bluetooth API (BLE). It allows for real-time arming and monitoring of multiple hardware nodes (Master + Sub-Boards).

Features

  • Secure Web Bluetooth Link: Seamlessly connects to ESP32 hardware using the GATT protocol.
  • Dynamic Node Discovery: Automatically generates UI controls based on the number of sub-boards reported by the Master.
  • Multi-Board Architecture: Sidebar navigation allows switching between the "Master Unit" and various "Auxiliary Boards."
  • Avionics Control Grid: 6 channels per board with high-visibility "ARM" and "SAFE" (Disarm) controls.
  • Real-Time Feedback Loop: Visual status indicators (Red/Glowing Green) only update upon hardware confirmation, ensuring safety and accuracy.
  • Robust Data Handling: Implements packet buffering to prevent command corruption during BLE transmission.
  • Responsive Ground Station UI: Built with Tailwind CSS for a professional, mission-control feel.

Technology Stack

  • Frontend: HTML5, Tailwind CSS
  • Logic: JavaScript (ES6+) with Web Bluetooth API
  • Firmware Compatibility: ESP32 (Arduino/NimBLE-BLE)

How to Run

1. Prerequisites

  • Browser: Google Chrome, Microsoft Edge, or Bluefy (iOS).
  • Security: Web Bluetooth REQUIRES a secure context. You must host this via https:// or localhost.
  • Hosting: If using VS Code, use the Live Server extension. Simply opening the file (file://...) will not work.

2. Hardware Setup

Flash your ESP32 with the provided firmware. The UI is configured to look for these specific UUIDs:

  • Service UUID: 4fafc201-1fb5-459e-8fcc-c5c9c331914b
  • Write Char UUID: beb5483e-36e1-4688-b7f5-ea07361b26a8
  • Notify Char UUID: 498c599b-ad01-4148-8a6a-73c332854747

Workflow & Usage

  1. Establish Connection: Click ESTABLISH CONNECTION and select your ESP32 (default name: "Ganesha-Master").
  2. Syncing: Upon connection, the UI automatically sends SYNC_BOARDS. The sidebar will populate based on the hardware response.
  3. Commanding: * Select a board from the sidebar.
    • Click ARM to activate a channel. The indicator will pulse green once the ESP32 confirms the state.
    • Click SAFE to disarm.
  4. Re-Sync: Use the RE-SYNC ALL button to force a status update of every channel across all connected nodes.

Communication Protocol

The UI and ESP32 communicate using a newline-terminated (\n) string protocol to ensure data integrity.

Command (UI -> ESP) Description
SYNC_BOARDS Requests total count of auxiliary boards.
SYNC_ALL Requests status of every channel on every board.
B[ID]_CH[N]_ARM Request to ARM Board ID, Channel N.
B[ID]_CH[N]_DISARM Request to SAFE Board ID, Channel N.
Notification (ESP -> UI) Description
BOARDS:[X] Tells UI to render X auxiliary boards.
B[ID]_CH[N]_ARMED Confirms Channel N on Board ID is now ARMED.
B[ID]_CH[N]_DISARMED Confirms Channel N on Board ID is now SAFED.

Safety Note

This software is designed for telemetry and control. When used for high-power applications (e.g., rocket pyrotechnics), ensure your ESP32 firmware includes physical safety interlocks and failsafes. The UI provides "Optimistic UI" prevention—meaning it will only show a "Green" status once the hardware has confirmed the state change.

Developed for Rocket Propulsion Lab Avionics Systems.