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_NO_EXCEPT;

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

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

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

    bool enableApFallback(const char* ap_ssid, const char* ap_pass = nullptr) FL_NO_EXCEPT;
 
    // ========== 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) FL_NO_EXCEPT;

    void onError(ErrorCallback callback) FL_NO_EXCEPT;

    void onState(StateCallback callback) FL_NO_EXCEPT;

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

    void poll() FL_NO_EXCEPT;

    bool isConnected() const FL_NO_EXCEPT;

    u8 getFailedServices() const FL_NO_EXCEPT;
 
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