StmI2c.h

Go to the documentation of this file.

 
#pragma once
 
#include "BaseI2c.h"
#include "PlatformMutex.h"
#include "StmTypes.h"
#include <vector>
#include <memory>
 
class StmI2cBus;
 
class StmI2cDevice : public BaseI2c {
public:
    StmI2cDevice(StmI2cBus* parent, const hf_i2c_device_config_t& config) noexcept;
    ~StmI2cDevice() noexcept override;
 
    bool Initialize() noexcept override;
    bool Deinitialize() noexcept override;
 
    hf_i2c_err_t Write(const hf_u8_t* data, hf_u16_t length,
                       hf_u32_t timeout_ms = 0) noexcept override;
    hf_i2c_err_t Read(hf_u8_t* data, hf_u16_t length,
                      hf_u32_t timeout_ms = 0) noexcept override;
    hf_i2c_err_t WriteRead(const hf_u8_t* tx_data, hf_u16_t tx_length,
                           hf_u8_t* rx_data, hf_u16_t rx_length,
                           hf_u32_t timeout_ms = 0) noexcept override;
    hf_u16_t GetDeviceAddress() const noexcept override;
 
    void SetDeviceAddress(hf_u16_t address_7bit) noexcept;
 
    const hf_i2c_device_config_t& GetConfig() const noexcept { return config_; }
 
    StmI2cBus* GetParentBus() const noexcept { return parent_bus_; }
 
    uint32_t LastHalError() const noexcept { return last_hal_error_; }
 
private:
    void NoteHalFailure(const I2C_HandleTypeDef* hi2c) noexcept;
    uint32_t last_hal_error_{0};
    hf_u32_t GetEffectiveTimeout(hf_u32_t requested_ms) const noexcept;
 
    static hf_i2c_err_t ConvertHalStatus(hf_u32_t hal_status) noexcept;
 
    StmI2cBus*           parent_bus_;  
    hf_i2c_device_config_t config_;    
};
 
class StmI2cBus {
public:
    explicit StmI2cBus(const hf_i2c_bus_config_t& config) noexcept;
 
    explicit StmI2cBus(I2C_HandleTypeDef* hal_handle, hf_u32_t timeout_ms = 1000) noexcept;
 
    ~StmI2cBus() noexcept;
 
    bool Initialize() noexcept;
    bool IsInitialized() const noexcept;
    bool Deinitialize() noexcept;
 
    int CreateDevice(const hf_i2c_device_config_t& device_config) noexcept;
 
    BaseI2c* GetDevice(int device_index) noexcept;
    const BaseI2c* GetDevice(int device_index) const noexcept;
 
    std::size_t GetDeviceCount() const noexcept;
 
    bool RemoveDevice(int device_index) noexcept;
 
    const hf_i2c_bus_config_t& GetConfig() const noexcept;
 
    I2C_HandleTypeDef* GetHalHandle() const noexcept;
 
    bool LockBus(hf_u32_t timeout_ms) noexcept;
    void UnlockBus() noexcept;
 
private:
    friend class StmI2cDevice;
 
    hf_i2c_bus_config_t config_;
    bool initialized_{false};
    mutable PlatformMutex bus_mutex_{};
    std::vector<std::unique_ptr<StmI2cDevice>> devices_;
};