ota.h

Go to the documentation of this file.

 
#pragma once
 
#include "fl/stl/function.h"
#include "fl/stl/shared_ptr.h"
#include "fl/stl/noexcept.h"
 
// Note: OTA implementation uses Arduino/ESP-IDF standard types
// No FastLED type headers needed here to avoid conflicts
 
namespace fl {
 
// Forward declaration
namespace platforms {
    class IOTA;
}
 
namespace net {
namespace ota {

enum class Service : u8 {
    NONE = 0,                    
    MDNS_FAILED = 1 << 0,        
    HTTP_FAILED = 1 << 1,        
    ARDUINO_OTA_FAILED = 1 << 2  
};
 
} // namespace ota

class OTA {
public:
    OTA() FL_NOEXCEPT;

    ~OTA() FL_NOEXCEPT;
 
    // ========== Network Setup Methods ==========

    bool beginWiFi(const char* hostname, const char* password,
                   const char* ssid, const char* wifi_pass);

    bool begin(const char* hostname, const char* password);
 
    // ========== Optional Configuration ==========

    bool enableApFallback(const char* ap_ssid, const char* ap_pass = nullptr);
 
    // ========== Callback Registration ==========

    using ProgressCallback = fl::function<void(size_t written, size_t total)>;

    using ErrorCallback = fl::function<void(const char* message)>;

    using StateCallback = fl::function<void(u8 state)>;

    void onProgress(ProgressCallback callback);

    void onError(ErrorCallback callback);

    void onState(StateCallback callback);

    void onBeforeReboot(void (*callback)());
 
    // ========== Runtime Methods ==========

    void poll();

    bool isConnected() const;

    u8 getFailedServices() const;
 
private:
    // Platform-specific implementation (lazy initialized via shared_ptr)
    // Using shared_ptr for proper lifetime management and lazy initialization
    fl::shared_ptr<fl::platforms::IOTA> mImpl;
};
 
} // namespace net
 
}  // namespace fl