EvilFirmwareAPI.h

/*
   Evil Firmware Fleet Management API Library
   
   Provides REST API and BLE endpoints for device management, monitoring,
   and remote control. Compatible with ESP32-based Evil devices.
   
   Features:
   - REST API for device status, control, and payload execution
   - BLE GATT service for direct device communication
   - Firmware version tracking
   - Battery and connectivity monitoring
   - Command execution interface
   - Sensor data reporting
*/

#ifndef EVIL_FIRMWARE_API_H
#define EVIL_FIRMWARE_API_H

#include <Arduino.h>
#include <ArduinoJson.h>

// API Version
#define EVIL_API_VERSION "1.0.0"
#define EVIL_DEVICE_TYPE "UNKNOWN"  // Override in device firmware

// BLE UUIDs for fleet management
#define EVIL_BLE_SERVICE_UUID "6e400001-b5a3-f393-e0a9-e50e24dcca9e"
#define EVIL_BLE_RX_CHAR_UUID "6e400002-b5a3-f393-e0a9-e50e24dcca9e"
#define EVIL_BLE_TX_CHAR_UUID "6e400003-b5a3-f393-e0a9-e50e24dcca9e"

// API Endpoints
#define API_ENDPOINT_STATUS "/api/status"
#define API_ENDPOINT_BATTERY "/api/battery"
#define API_ENDPOINT_SENSORS "/api/sensors"
#define API_ENDPOINT_PAYLOAD "/api/payload"
#define API_ENDPOINT_COMMAND "/api/command"
#define API_ENDPOINT_FIRMWARE "/api/firmware"
#define API_ENDPOINT_LOGS "/api/logs"

// Device status structure
typedef struct {
  String device_id;
  String device_type;
  String firmware_version;
  String api_version;
  bool wifi_connected;
  String wifi_ssid;
  int8_t wifi_rssi;
  uint32_t uptime_ms;
  float battery_voltage;
  int battery_percent;
  float cpu_temp;
  uint32_t free_heap;
  uint32_t total_heap;
} DeviceStatus;

// Sensor data structure
typedef struct {
  float temperature;
  float humidity;
  float pressure;
  double latitude;
  double longitude;
  float gps_accuracy;
  bool gps_valid;
} SensorData;

// Command structure
typedef struct {
  String command_id;
  String command_type;
  String target;
  String parameters;
  uint32_t timestamp;
} Command;

class EvilFirmwareAPI {
private:
  String device_id;
  String device_type;
  String firmware_version;
  DeviceStatus current_status;
  SensorData sensor_data;
  
public:
  EvilFirmwareAPI();
  
  // Initialization
  void begin(String id, String type, String version);
  
  // Status management
  void updateStatus();
  DeviceStatus getStatus();
  
  // JSON serialization
  String statusToJSON();
  String sensorsToJSON();
  String batteryToJSON();
  
  // Sensor data
  void setSensorData(SensorData data);
  SensorData getSensorData();
  
  // Payload/Command execution interface (to be implemented by device)
  virtual void executePayload(String payload_name, String parameters) {}
  virtual void executeCommand(Command cmd) {}
  
  // Utility functions
  uint32_t getUptime();
  float getBatteryVoltage();
  int getBatteryPercent();
  String getDeviceID();
  String getFirmwareVersion();
};

// Helper function to create status JSON response
inline DynamicJsonDocument createStatusResponse(EvilFirmwareAPI* api) {
  DynamicJsonDocument doc(512);
  DeviceStatus status = api->getStatus();
  
  doc["status"] = "ok";
  doc["device_id"] = status.device_id;
  doc["device_type"] = status.device_type;
  doc["firmware_version"] = status.firmware_version;
  doc["api_version"] = status.api_version;
  doc["wifi_connected"] = status.wifi_connected;
  doc["wifi_ssid"] = status.wifi_ssid;
  doc["wifi_rssi"] = status.wifi_rssi;
  doc["uptime_ms"] = status.uptime_ms;
  doc["battery_voltage"] = status.battery_voltage;
  doc["battery_percent"] = status.battery_percent;
  doc["cpu_temp"] = status.cpu_temp;
  doc["free_heap"] = status.free_heap;
  doc["total_heap"] = status.total_heap;
  
  return doc;
}

// Helper function to create command response
inline DynamicJsonDocument createCommandResponse(bool success, String message) {
  DynamicJsonDocument doc(256);
  doc["success"] = success;
  doc["message"] = message;
  doc["timestamp"] = millis();
  return doc;
}

#endif // EVIL_FIRMWARE_API_H