Se050Handler.h

Go to the documentation of this file.

 
#ifndef COMPONENT_HANDLER_SE050_HANDLER_H_
#define COMPONENT_HANDLER_SE050_HANDLER_H_
 
#include <atomic>
#include <cstddef>
#include <cstdint>
 
#include "RtosMutex.h"
#include "base/BaseGpio.h"
#include "base/BaseI2c.h"
 
#include "core/hf-core-drivers/external/hf-se050-driver/inc/se050_device.hpp"
#include "core/hf-core-drivers/external/hf-se050-driver/inc/se050_i2c_transport_interface.hpp"
 
//==============================================================================
// CRTP I2C ADAPTER (BaseI2c → se050 transport)
//==============================================================================
 
class HalI2cSe050Comm : public se050::I2cTransceiveInterface<HalI2cSe050Comm> {
public:
    HalI2cSe050Comm(BaseI2c& i2c, BaseGpio* reset_gpio) noexcept : i2c_(i2c), reset_gpio_(reset_gpio) {}
 
    [[nodiscard]] bool EnsureInitialized() noexcept { return i2c_.EnsureInitialized(); }
 
    [[nodiscard]] se050::Error I2cWrite(const std::uint8_t* tx, std::size_t tx_len,
                                        std::uint32_t timeout_ms) noexcept;
 
    [[nodiscard]] se050::Error I2cRead(std::uint8_t* rx, std::size_t rx_len,
                                        std::uint32_t timeout_ms) noexcept;
 
    [[nodiscard]] se050::Error Transceive(const std::uint8_t* tx, std::size_t tx_len, std::uint8_t* rx,
                                          std::size_t rx_cap, std::size_t* rx_len_out,
                                          std::uint32_t timeout_ms) noexcept;
 
    [[nodiscard]] se050::Error HardwareReset() noexcept;
 
    void delay_ms_impl(std::uint32_t ms) noexcept;
 
    [[nodiscard]] bool HoldBus(std::uint32_t timeout_ms) noexcept;
    void ReleaseBus() noexcept;
    [[nodiscard]] bool BusHeld() const noexcept { return bus_held_; }
 
private:
    BaseI2c&   i2c_;
    BaseGpio* reset_gpio_;
    bool      bus_held_{false};
};
 
//==============================================================================
// Handler configuration
//==============================================================================
 
struct Se050HandlerConfig {
    std::uint32_t apdu_timeout_ms{300};
    std::uint32_t warm_reset_timeout_ms{200};
    std::uint32_t t1_inter_frame_delay_ms{2};
    bool skip_chip_warm_reset{false};
};
 
//==============================================================================
// Handler
//==============================================================================
 
class Se050Handler {
public:
    using DeviceType = se050::Device<HalI2cSe050Comm>;
 
    explicit Se050Handler(BaseI2c& i2c, const Se050HandlerConfig& config = Se050HandlerConfig{},
                           BaseGpio* reset_gpio = nullptr, RtosMutex* bus_mutex = nullptr) noexcept;
 
    Se050Handler(const Se050Handler&)            = delete;
    Se050Handler& operator=(const Se050Handler&) = delete;
    Se050Handler(Se050Handler&&)                 = delete;
    Se050Handler& operator=(Se050Handler&&)      = delete;
 
    [[nodiscard]] const Se050HandlerConfig& Config() const noexcept { return config_; }
 
    bool EnsureInitialized() noexcept;
 
    [[nodiscard]] bool IsPresent() const noexcept {
        return initialized_.load(std::memory_order_acquire);
    }
 
    [[nodiscard]] DeviceType&       GetDevice() noexcept { return device_; }
    [[nodiscard]] const DeviceType& GetDevice() const noexcept { return device_; }
 
private:
    bool EnsureInitializedLocked() noexcept;
 
    Se050HandlerConfig config_;
    HalI2cSe050Comm     comm_;
    DeviceType          device_;
 
    std::atomic<bool> initialized_{false};
 
    RtosMutex  private_mutex_{};
    RtosMutex* bus_mutex_;
};
 
#endif  // COMPONENT_HANDLER_SE050_HANDLER_H_