unit_AW3641E.hpp

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD
 *
 * SPDX-License-Identifier: MIT
 */
#ifndef M5_UNIT_FLASHLIGHT_UNIT_AW3641E_HPP
#define M5_UNIT_FLASHLIGHT_UNIT_AW3641E_HPP
 
#include <M5UnitComponent.hpp>
 
namespace m5 {
namespace unit {
 
namespace aw3641e {
 
enum class SwitchPosition : uint8_t {
    Flash,  
    Torch,  
};
 
enum class Brightness : uint8_t {
    Pct100,  
    Pct90,   
    Pct80,   
    Pct70,   
    Pct60,   
    Pct50,   
    Pct40,   
    Pct30,   
};
 
constexpr uint32_t PULSE_HIGH_US{4};
constexpr uint32_t PULSE_LOW_US{4};
constexpr uint32_t PULSE_OFF_US{600};
 
constexpr uint16_t FLASH_MAX_DURATION_MS{220};
 
constexpr uint16_t TORCH_MAX_DURATION_MS{1300};
 
constexpr uint8_t to_pulse_count(const Brightness b)
{
    return static_cast<uint8_t>(static_cast<uint8_t>(b) + 1u);
}
 
}  // namespace aw3641e
 
class UnitAW3641E : public Component {
    M5_UNIT_COMPONENT_HPP_BUILDER(UnitAW3641E, 0x00);
 
public:
    struct config_t {
        aw3641e::SwitchPosition switch_position{aw3641e::SwitchPosition::Flash};
    };
 
    explicit UnitAW3641E(const uint8_t addr = DEFAULT_ADDRESS) : Component(addr)
    {
    }
    virtual ~UnitAW3641E()
    {
    }
 
    virtual bool begin() override;
    virtual void update(const bool force = false) override;
 
    inline config_t config()
    {
        return _cfg;
    }
    inline void config(const config_t& cfg)
    {
        _cfg = cfg;
    }
 
 
    bool stop();
 
    bool flash(const aw3641e::Brightness brightness = aw3641e::Brightness::Pct100,
               const uint16_t duration_ms           = aw3641e::FLASH_MAX_DURATION_MS);
 
    bool torch(const uint16_t duration_ms = aw3641e::TORCH_MAX_DURATION_MS);
 
    inline uint16_t lastDurationMs() const
    {
        return _flash_duration_ms;
    }
    inline bool active() const
    {
        return _flash_active;
    }
 
protected:
    bool send_pulse_train(const uint8_t pulse_count);
 
protected:
    config_t _cfg{};
    // Flash timing tracker for non-blocking auto-shutdown in update().
    bool _flash_active{false};
    uint32_t _flash_start_ms{0};
    uint16_t _flash_duration_ms{0};
};
 
}  // namespace unit
}  // namespace m5
 
#endif