🛡 Transit Guardian Admin

Register a New Transit Guardian

Each physical unit must be registered here. A unique user code is generated automatically — give this code to the recipient so they can monitor their specific device.

Per-Device Setup Checklist

Complete these steps for each physical unit before shipping.

1. Flash the Transit Guardian firmware to the Heltec WiFi LoRa 32 board (see Build Guide).
2. Power on the device and connect to its setup AP (TransitGuardian-SETUP).
3. Open 192.168.4.1 in a browser and enter the destination WiFi credentials.
4. Note the device's local IP address once it joins the network (shown on the OLED display).
5. Enter that IP in the Device WiFi URL field above and register the device.
6. Test all sensors from the Transit Hub live view (Connect → verify telemetry).
7. Calibrate the shock threshold if needed via the device web interface.
8. Insert a formatted microSD card (FAT32, ≤32 GB) into the device.
9. Label the physical unit with the generated user code and the owner's name.
10. Pack securely and share the user code with the recipient.

📶 Meshtastic Node Auto-Setup Wizard

Use this wizard to configure a new Meshtastic node for use with Transit Guardian. Connect the node via USB or BLE, then follow each step. For full configuration, open the Meshtastic tab.

🛒 Bill of Materials

Parts required to build one Transit Guardian unit.

🔌 Wiring Diagram (GPIO Pin Map)

Heltec WiFi LoRa 32 V3 pin assignments
───────────────────────────────────────
I²C Bus (shared):
  SDA  → GPIO 21
  SCL  → GPIO 22
  Devices: MPU-6050 (addr 0x68), BMP280 (addr 0x76)

SPI Bus (microSD):
  CS   → GPIO  5
  MOSI → GPIO 23
  MISO → GPIO 19
  SCK  → GPIO 18

Analog:
  LDR voltage divider → GPIO 35 (ADC1_CH7)

Digital:
  Reed switch (NC, pull-up) → GPIO 32
  Sound sensor (digital)    → GPIO 33

Power:
  3.3 V rail → MPU-6050 VCC, BMP280 VCC, LDR top, KY-037 VCC
  GND        → all GND pins
  LiPo 3.7 V → Heltec BAT connector (JST-PH)

🔧 Step-by-Step Assembly

Phase 1 – Prepare Components

Phase 2 – Wiring

Phase 3 – Firmware

Phase 4 – WiFi Configuration

Phase 5 – Validation & Packaging

📋 Firmware Configuration Reference

Key constants to configure at the top of the Transit Guardian Arduino sketch.

// ── Transit Guardian Firmware Config ──────────────────
const char* UNIT_ID        = "TG-00000001"; // unique per device
const char* LORA_BAND      = "915E6";       // US: 915E6 | EU: 868E6
const int   SHOCK_G_THRESH = 2;             // trigger at 2g acceleration
const int   SOUND_THRESH   = 80;            // dB-equivalent trimpot level
const int   LOG_INTERVAL   = 5000;          // log every 5 s (ms)
const int   TELEMETRY_INT  = 2000;          // broadcast LoRa every 2 s
const char* SETUP_AP_PASS  = "";            // leave blank = open AP
// ─────────────────────────────────────────────────────

🔑 Change Admin Password

The admin password is stored as a SHA-256 hash in this HTML file. To change it:

1. Enter your new password below and click Compute Hash.
2. Copy the resulting hash.
3. Open transit-guardian-admin.html in a text editor.
4. Find the constant HASH_HEX in the <script> section.
5. Replace its value with the new hash (keep the surrounding quotes).
6. Save and deploy the file.

🗑 Data Management

Device registrations are stored in your browser's localStorage. This data is local to this browser. Export regularly to keep a backup.

ℹ️ About This Panel

Transit Guardian Admin v1.0 — © 2008-2026 Barbrick Design
Manage and monitor all Transit Guardian units from one password-protected page.
Device data is stored locally in localStorage — no cloud storage required.

Connect to Node

Connected Node

Mesh Network Nodes

Nodes discovered through BLE/Serial/HTTP connection appear here. Registered Transit Guardian devices are shown with their registration status.

📡 Radio & Network Configuration Reference

Key settings for all Transit Guardian mesh nodes. Configure via the Meshtastic web client.

📨 Send Broadcast Message

Sends a text message to ALL nodes on the mesh network (broadcast address 0xFFFFFFFF). The message will be relayed by all nodes within range.

Message History

📜 Activity Log

Persistent log of all admin actions, node connections, messages, and errors. Stored in your browser's localStorage (up to 500 entries).

Live feed of AgentR orchestration events. All entries are simultaneously written to the 📜 Activity Log where you can filter by source or level.

⚡ Quick Actions

🔌 TCP / WebSocket Direct Connection

Connect directly to your Heltec V3 (ntR2) via WebSocket on port 4403. WiFi must be enabled on the node. If this page is served over HTTPS, browsers block non-TLS WebSocket connections — in that case use the HTTP tab or the official Meshtastic web client.

⚙️ Remote Control Plane

Send commands to the connected node from anywhere on the network. Requires an active connection in any tab (TCP, BLE, Serial, or HTTP).

📡 LoRa Parameter Tuning

Adjust LoRa radio settings for ntR2. Changes are queued and applied on next Admin-capable connection. Best-practice values for the Heltec V3 are pre-filled.

🚀 OTA Firmware & Config Push

🧬 Autonomous Monitoring Config

AgentR2 continuously monitors the mesh, detects anomalies, and alerts in the Packet Analyzer tab and Activity Log. Configure thresholds below.

📡 Signal Quality

🛰️ GPS / Position

🌡️ Environment Sensors

📊 Session Statistics

📋 Node Registry

🛡️ Mesh Guardian — Intrusion Detection

🔬 Live Packet Stream

All packets received via the active connection are captured in real time. Capture begins automatically when any connection is established.

📊 Per-Node Traffic Analysis

Packet counts and message rates per source node this session.

📊 Live Anomaly Scores

Each metric is independently scored using Exponentially Weighted Moving Average (EWMA) baseline learning. Score > 2.5σ triggers a warning; > 4σ triggers a critical alert. Baselines update continuously from live or demo data.

🔮 Predictive Analytics

Linear regression on the last 20 data points per metric. Predicts values 5 samples ahead. Requires ≥ 10 data points per metric to activate.

ℹ️ How the ML Engine Works