validation_utils.h

См. документацию.

#pragma once

 
#include <Arduino.h>
#include <vector>
 
// ============================================================================
// СТРУКТУРЫ РЕЗУЛЬТАТОВ ВАЛИДАЦИИ
// ============================================================================

struct ValidationResult
{
    bool isValid;
    String message;
};

struct ValidationError
{
    String field;
    String message;
};

struct ConfigValidationResult
{
    bool isValid;
    std::vector<ValidationError> errors;
};

struct SensorValidationResult
{
    bool isValid;
    std::vector<ValidationError> errors;
};
 
// ============================================================================
// СТРУКТУРЫ ДАННЫХ (forward declarations)
// ============================================================================
 
// Упрощенная структура конфигурации для валидации
struct ConfigData
{
    String ssid;
    String password;
    bool mqttEnabled;
    String mqttServer;
    int mqttPort;
    bool thingSpeakEnabled;
    String thingSpeakAPIKey;
    unsigned long sensorReadInterval;
    unsigned long mqttPublishInterval;
    unsigned long thingspeakInterval;
    unsigned long ntpUpdateInterval;
};
 
// Упрощенная структура данных датчика для валидации
struct SensorData
{
    float temperature;
    float humidity;
    float ph;
    float ec;          // Исправлено: должно быть float
    float nitrogen;    // Исправлено: должно быть float
    float phosphorus;  // Исправлено: должно быть float
    float potassium;   // Исправлено: должно быть float
};
 
// ============================================================================
// ФУНКЦИИ ВАЛИДАЦИИ КОНФИГУРАЦИИ
// ============================================================================

ValidationResult validateSSID(const String& ssid);

ValidationResult validatePassword(const String& password);

ValidationResult validateMQTTServer(const String& server);

ValidationResult validateMQTTPort(int port);

ValidationResult validateThingSpeakAPIKey(const String& apiKey);

ValidationResult validateInterval(unsigned long interval, unsigned long min_val, unsigned long max_val,
                                  const char* name);

ValidationResult validateSensorReadInterval(unsigned long interval);

ValidationResult validateMQTTPublishInterval(unsigned long interval);

ValidationResult validateThingSpeakInterval(unsigned long interval);

ValidationResult validateNTPInterval(unsigned long interval);
 
// ============================================================================
// ФУНКЦИИ ВАЛИДАЦИИ ДАННЫХ ДАТЧИКА
// ============================================================================

ValidationResult validateTemperature(float temperature);

ValidationResult validateHumidity(float humidity);

ValidationResult validatePH(float ph);

ValidationResult validateEC(float ec);

ValidationResult validateNPK(float value, const char* nutrient);
 
// ============================================================================
// КОМПЛЕКСНАЯ ВАЛИДАЦИЯ
// ============================================================================

ConfigValidationResult validateFullConfig(const ConfigData& config, bool checkRequired = true);

SensorValidationResult validateFullSensorData(const SensorData& data);
 
// ============================================================================
// УТИЛИТЫ ВАЛИДАЦИИ
// ============================================================================

bool isValidIPAddress(const String& ip);

bool isValidHostname(const String& hostname);

String formatValidationErrors(const ConfigValidationResult& result);

String formatSensorValidationErrors(const SensorValidationResult& result);
 
// ============================================================================
// ЛОГИРОВАНИЕ ВАЛИДАЦИИ
// ============================================================================

void logValidationResult(const ConfigValidationResult& result, const char* context);

void logSensorValidationResult(const SensorValidationResult& result, const char* context);