unit_KmeterISO.hpp

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: 2024 M5Stack Technology CO LTD
 *
 * SPDX-License-Identifier: MIT
 */
#ifndef M5_UNIT_UNIFIED_KMETERISO_UNIT_KMETERISO_HPP
#define M5_UNIT_UNIFIED_KMETERISO_UNIT_KMETERISO_HPP
 
#include <M5UnitComponent.hpp>
#include <m5_utility/container/circular_buffer.hpp>
#include <limits>  // NaN
#include <array>
 
namespace m5 {
namespace unit {
 
namespace kmeterISO {
 
enum MeasurementUnit : uint8_t {
    Celsius,     
    Fahrenheit,  
};
 
struct Data {
    std::array<uint8_t, 4> raw{};  // raw data
    inline float temperature() const
    {
        return static_cast<int32_t>(((uint32_t)raw[3] << 24) | ((uint32_t)raw[2] << 16) | ((uint32_t)raw[1] << 8) |
                                    ((uint32_t)raw[0] << 0)) *
               0.01f;
    }
};
}  // namespace kmeterISO
 
class UnitKmeterISO : public Component, public PeriodicMeasurementAdapter<UnitKmeterISO, kmeterISO::Data> {
    M5_UNIT_COMPONENT_HPP_BUILDER(UnitKmeterISO, 0x66);
 
public:
    struct config_t {
        bool start_periodic{true};
        uint32_t interval{100};
        kmeterISO::MeasurementUnit measurement_unit{kmeterISO::MeasurementUnit::Celsius};
    };
 
    explicit UnitKmeterISO(const uint8_t addr = DEFAULT_ADDRESS)
        : Component(addr), _data{new m5::container::CircularBuffer<kmeterISO::Data>(1)}
    {
        auto ccfg  = component_config();
        ccfg.clock = 100 * 1000U;
        component_config(ccfg);
    }
    virtual ~UnitKmeterISO()
    {
    }
 
    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;
    }
 
 
    kmeterISO::MeasurementUnit measurementUnit() const
    {
        return _munit;
    }
    void setMeasurementUnit(const kmeterISO::MeasurementUnit munit)
    {
        _munit = munit;
    }
 
    inline float temperature() const
    {
        return !empty() ? oldest().temperature() : std::numeric_limits<float>::quiet_NaN();
    }
 
 
    inline bool startPeriodicMeasurement()
    {
        return PeriodicMeasurementAdapter<UnitKmeterISO, kmeterISO::Data>::startPeriodicMeasurement();
    }
    inline bool startPeriodicMeasurement(const uint32_t interval,
                                         const kmeterISO::MeasurementUnit munit = kmeterISO::Celsius)
    {
        return PeriodicMeasurementAdapter<UnitKmeterISO, kmeterISO::Data>::startPeriodicMeasurement(interval, munit);
    }
    inline bool stopPeriodicMeasurement()
    {
        return PeriodicMeasurementAdapter<UnitKmeterISO, kmeterISO::Data>::stopPeriodicMeasurement();
    }
 
    bool readStatus(uint8_t& status);
    bool isReady()
    {
        uint8_t s{};
        return readStatus(s) && (s == 0U);
    }
 
    bool readFirmwareVersion(uint8_t& ver);
 
 
    bool measureSingleshot(kmeterISO::Data& d, kmeterISO::MeasurementUnit munit = kmeterISO::MeasurementUnit::Celsius,
                           const uint32_t timeoutMs = 0);
    bool measureInternalSingleshot(kmeterISO::Data& d,
                                   kmeterISO::MeasurementUnit munit = kmeterISO::MeasurementUnit::Celsius,
                                   const uint32_t timeoutMs         = 0);
 
 
    bool changeI2CAddress(const uint8_t i2c_address);
    bool readI2CAddress(uint8_t& i2c_address);
 
protected:
    bool start_periodic_measurement();
    bool start_periodic_measurement(const uint32_t interval,
                                    const kmeterISO::MeasurementUnit munit = kmeterISO::Celsius);
    bool stop_periodic_measurement();
 
    bool read_measurement(kmeterISO::Data& d, const kmeterISO::MeasurementUnit munit);
    bool read_internal_measurement(kmeterISO::Data& d, const kmeterISO::MeasurementUnit munit);
 
    M5_UNIT_COMPONENT_PERIODIC_MEASUREMENT_ADAPTER_HPP_BUILDER(UnitKmeterISO, kmeterISO::Data);
 
protected:
    std::unique_ptr<m5::container::CircularBuffer<kmeterISO::Data>> _data{};
    kmeterISO::MeasurementUnit _munit{kmeterISO::MeasurementUnit::Celsius};
    config_t _cfg{};
};
 
namespace kmeterISO {
namespace command {
// See also https://github.com/m5stack/M5Unit-KMeterISO/blob/main/docs/Unit_KmeterISO_I2C_Protocol.pdf
constexpr uint8_t TEMPERATURE_CELSIUS_VAL_REG{0X00};
constexpr uint8_t TEMPERATURE_FAHRENHEIT_VAL_REG{0X04};
constexpr uint8_t INTERNAL_TEMPERATURE_CELSIUS_VAL_REG{0X10};
constexpr uint8_t INTERNAL_TEMPERATURE_FAHRENHEIT_VAL_REG{0X14};
constexpr uint8_t ERROR_STATUS_REG{0x20};
constexpr uint8_t TEMPERATURE_CELSIUS_STRING_REG{0x30};
constexpr uint8_t TEMPERATURE__FAHRENHEIT_STRING_REG{0x40};
constexpr uint8_t INTERNAL_TEMPERATURE_CELSIUS_STRING_REG{0x50};
constexpr uint8_t INTERNAL_TEMPERATURE_FAHRENHEIT_STRING_REG{0x60};
constexpr uint8_t FIRMWARE_VERSION_REG{0xFE};
constexpr uint8_t I2C_ADDRESS_REG{0xFF};
}  // namespace command
}  // namespace kmeterISO
 
}  // namespace unit
}  // namespace m5
#endif