IOT INTEGRATION / EMBEDDED SYSTEMS

Connecting the physical system. Securing the data.

HeliControl integrates ESP8266 IoT devices for cockpit door access and simulator telemetry, with secure backend communication and monitoring through the mobile application.

ESP8266 PHP / JSON API MYSQL CYBERSECURITY
01 / DEVICE MODULES

Two IoT components. One platform.

Each ESP8266 has a specific role and communicates with its dedicated backend API endpoint. This separation helps maintain clear validation, processing and security boundaries.

DEVICE / 01 DOOR CONTROL

Door ESP8266

Handles cockpit door-state monitoring and access integration with the backend system.

Door-state reporting
Device authentication
Cockpit validation
Backend processing
GET / POST /api/iot/door.php
DEVICE / 02 TELEMETRY

Telemetry ESP8266

Submits simulator telemetry to the backend for validation, storage and alert processing.

Telemetry submission
Payload validation
Cockpit validation
Alert engine input
GET / POST /api/iot/telemetry.php
02 / System Architecture

From device to application.

IoT data passes through the relevant API and backend processing layer before reaching persistent storage. Telemetry can then feed the alert engine and Flutter monitoring interface.

HeliControl IoT Data Path LOGICAL ARCHITECTURE / NOT A LIVE TRACE
ESP8266 Device

Door-state reporting or simulator telemetry submission over HTTPS.

01 / DEVICE
IoT API Endpoint

The relevant Door API or Telemetry API receives the HTTP request and JSON payload.

02 / API
Backend Validation and Processing

Device authentication, request validation, cockpit association checks and server-side business logic.

03 / SECURITY
MySQL Database

Validated system information and relevant records are stored through the backend.

04 / STORAGE
Alert Engine and Flutter Dashboard

The telemetry flow can trigger configured operational alerts and update the monitoring experience through backend services.

05 / MONITORING
Architecture rule: ESP8266 devices and the Flutter application must not connect directly to MySQL. The PHP backend remains the security boundary. The exact processing path depends on whether the request concerns door state or telemetry.
03 / API Implementation

Explicit endpoints. Controlled requests.

The IoT integration uses HTTP requests with JSON payloads and device API-key authentication. The following routes document the known API surface; this page does not execute device commands or modify backend records.

API / 01

Door IoT API

Retrieves the current door state or submits a door-state update, subject to the endpoint's authentication and validation rules.

GET /api/iot/door.php?cockpit_id=1 POST /api/iot/door.php
API / 02

Telemetry IoT API

Retrieves current telemetry or submits a new telemetry payload for backend validation and processing.

GET /api/iot/telemetry.php?cockpit_id=1 POST /api/iot/telemetry.php
API / 03

Request Requirements

Device requests use HTTPS. POST requests send JSON and authenticate using the assigned device key. Secrets must remain outside public website code.

Content-Type: application/json X-API-Key: [device key kept private]
04 / Telemetry Data

Simulator data. Structured for monitoring.

These are documented telemetry field names that describe the type of information the monitoring system may handle. They are not readings retrieved from the live database.

Telemetry Field Reference

Example schema labels / not live sensor output

REFERENCE ONLY
altitude_ft Altitude Feet (ft)
airspeed_knots Airspeed Knots (kt)
fuel_percent Fuel Level Percentage (%)
heading_deg Heading Degrees (°)
vertical_speed_fpm Vertical Speed Feet per minute
oil_temp_c Oil Temperature Degrees Celsius
engine_status Engine State Backend-defined value
cockpit_id Cockpit Reference Associated cockpit identifier
Implementation note: Confirm the current firmware payload, field types, valid ranges and units against the actual Telemetry API before using these labels as a device integration contract. This page does not invent sensor readings or transmission frequency.
05 / Security Boundary

Secure the device. Validate the request.

IoT security is enforced through the backend API rather than by trusting device requests or exposing database access to the network.

Backend-enforced IoT security

The PHP backend acts as the security boundary between device traffic, persistent data and application services. The public website explains these controls; it does not replace or implement them.

Device API-key authentication

IoT requests supply the expected X-API-Key header. Missing or invalid credentials should be rejected by the existing backend.

Device and cockpit validation

The backend checks the registered device and relevant cockpit association before processing an authorised request.

Payload validation

Incoming JSON data must be checked for required fields, expected types and valid values by the server-side implementation.

Controlled database access

Device input reaches MySQL through backend logic. Database credentials and direct database connectivity are not exposed to the ESP8266 or public page.

Monitoring and alert processing

Relevant telemetry can feed the existing operational alert engine. Security events and cockpit operational alerts remain distinct processing categories.

06 / Integration Scope

Document what is tested. Verify what remains.

API tests and physical hardware integration are separate milestones. A successful manual HTTP request alone does not prove that an ESP8266 device is fully integrated.

PREVIOUSLY TESTED

Manual API scenarios

Previous project notes record successful manual Door API state-update scenarios and controlled authentication or payload-validation responses. Retest against the current deployment before final demonstration.

VERIFY REQUIRED

Physical device integration

Confirm the actual Door and Telemetry ESP8266 hardware, firmware configuration, real payloads, device connectivity and end-to-end behaviour.

ARCHITECTURE

Backend remains the boundary

Keep the existing PHP APIs, MySQL data layer, backend validation and relevant Flutter monitoring flows. This website page does not alter them.

Continue Exploring

One simulator. Connected layers.

Explore the project architecture, application interface and cybersecurity controls to understand how each component contributes to HeliControl.