#ifndef SYS_OTA_BOOT_REQUEST_H
#define SYS_OTA_BOOT_REQUEST_H

#include <stdint.h>

/**
 * @brief DCU_APP 进入 Bootloader OTA 窗口控制模块。
 * @note ESP32 通过 CAN-FD 发送受保护命令，APP 写 OTA 标志后软复位，
 *       Bootloader 下次启动会停留在 OTA 等待窗口。
 */
class OtaBootRequest {
public:
    /** @brief 初始化内部状态。 */
    static void init();

    /**
     * @brief 尝试处理一帧 CAN 接收报文。
     * @param[in] channel 报文来源 CAN 通道。
     * @param[in] id 报文 ID。
     * @param[in] data 报文负载。
     * @param[in] length 报文负载长度。
     * @retval true 该报文已被 OTA/BOOT 控制模块消费。
     * @retval false 该报文不是 OTA/BOOT 控制报文。
     */
    static bool handleCanFrame(uint8_t channel, uint32_t id, const uint8_t *data, uint8_t length);

    /**
     * @brief 设置 Bootloader OTA 等待标志并安排软复位。
     * @retval true 标志写入成功，稍后会复位进入 Bootloader。
     * @retval false Flash 标志写入失败。
     * @note 此函数会执行 Flash 操作（可能擦页 20-30ms），不可在 ISR 内调用。
     */
    static bool requestEnterBoot();

    /**
     * @brief 异步请求进入 Bootloader（ISR 安全）。
     * @note 仅设置 pending 标志，Flash 操作和复位由 process() 在主循环执行。
     *       用于 SPI EXTI ISR 内的 0xB0 命令处理，避免 Flash 擦除阻塞 SPI 中断。
     */
    static void requestEnterBootAsync();

    /** @brief 若已确认进入 BOOT 请求，则延迟片刻后复位。 */
    static void process();

    /** @brief 查询是否已收到进入 Bootloader 请求（等待复位中）。
     *         供主循环在复位前停止主动按铃等可能干扰 OTA 的操作。 */
    static bool isRebootPending() { return s_rebootPending; }

private:
    static volatile bool s_rebootPending;
    static volatile bool s_bootRequestPending; ///< 0xB0 异步请求标志，process() 中执行 Flash 操作
};

#endif /* SYS_OTA_BOOT_REQUEST_H */