unit_BH1750FVI_data.hpp

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD
 *
 * SPDX-License-Identifier: MIT
 */
#ifndef M5_UNIT_LIGHT_UNIT_BH1750FVI_DATA_HPP
#define M5_UNIT_LIGHT_UNIT_BH1750FVI_DATA_HPP
 
#include <cstdint>
#include <limits>
 
namespace m5 {
namespace unit {
 
namespace bh1750fvi {
 
enum class Mode : uint8_t {
    Continuous,  
    OneTime,     
};
 
enum class Resolution : uint8_t {
    Low,    
    High,   
    High2,  
};
 
constexpr uint8_t MTREG_MIN{31};
constexpr uint8_t MTREG_MAX{254};
constexpr uint8_t MTREG_DEFAULT{69};
 
constexpr float SENSITIVITY_FACTOR_MIN{0.45f};
constexpr float SENSITIVITY_FACTOR_MAX{3.68f};
 
struct Data {
    uint16_t raw{};                           
    uint8_t mtreg{MTREG_DEFAULT};             
    Resolution resolution{Resolution::High};  
 
    inline float lux() const
    {
        if (mtreg == 0) {
            return std::numeric_limits<float>::quiet_NaN();
        }
        const float base{static_cast<float>(raw) / 1.2f};
        const float scale{static_cast<float>(MTREG_DEFAULT) / static_cast<float>(mtreg)};
        float v{base * scale};
        if (resolution == Resolution::High2) {
            v *= 0.5f;
        }
        return v;
    }
};
 
}  // namespace bh1750fvi
}  // namespace unit
}  // namespace m5
 
#endif