DFRobot_CCS811

SKU：SEN0315

    /**
     * @fn begin
     * @brief 初始化函数
     * @return 初始化结果
     * @retval ERR_OK          初始化成功
     * @retval ERR_DATA_BUS    总线数据错误
     * @retval ERR_IC_VERSION  传感器id错误
     */ 
    int begin();

    /**
     * @fn checkDataReady
     * @brief 判断传感器数据是否准备就绪
     * @return  检查结果
     * @retval  true   数据准备就绪
     * @retval  false  数据还未准备好
     */
    bool checkDataReady();

    /**
     * @fn softReset
     * @brief 复位传感器，清除所有配置数据。
     */
    void softReset();

    /**
     * @fn setInTempHum
     * @brief 设置环境参数
     * @param temperature 设定温度值，单位:摄氏度，范围(-40~85℃)
     * @param humidity    设置湿度值，单位:RH，范围(0~100)
     */
    void setInTempHum(float temperature, float humidity);

    /**
     * @fn setMeasurementMode
     * @brief 测量参数配置
     * @param mode
     * @n            eClosed       空闲(在此模式下测量被禁用)
     * @n            eCycle_1s     恒功率模式，每秒测量室内空气质量
     * @n            eCycle_10s    每10秒测量一次脉冲加热模式的室内空气质量
     * @n            eCycle_60s    每60秒测量一次低功率脉冲加热模式的室内空气质量
     * @n            eCycle_250ms  恒功率模式，传感器每250ms测量一次1xx:预留模式(供以后使用)
     * @param thresh  阈值中断模式
     * @n            0             正常中断模式
     * @n            1             达到或者超过阈值产生中断信号
     * @param interrupt
     * @n            0             禁止中断模式
     * @n            1             当一个新的样本准备就绪时，int信号被触发(驱动低)
     */
    void setMeasurementMode(eCycle_t mode, uint8_t thresh = 0, uint8_t interrupt = 0);

    /**
     * @fn setThresholds
     * @brief 设置中断阈值
     * @param lowToMed: 中断触发值范围从低到中
     * @param medToHigh: 中断触发值范围中至高
     */
    void setThresholds(uint16_t lowToMed, uint16_t medToHigh);

    /**
     * @fn getMeasurementMode
     * @brief 获取当前配置参数
     * @return configuration code, needs to be converted into binary code to analyze
     * @n       第二位： 0 正常中断模式；1:当数据不在阈值内，中断模式触发nINT信号
     * @n       第三位:  0 禁止中断； 1: 当一个新的样本准备就绪时，int信号被触发(驱动低)
     * @n       第四到六位: 详情见 eCycle_t
     */
    uint8_t getMeasurementMode();

    /**
     * @fn getCO2PPM
     * @brief 获取当前的二氧化碳浓度
     * @return 当前二氧化碳浓度，单位:ppm
     */
    uint16_t getCO2PPM();

    /**
     * @fn getTVOCPPB
     * @brief 得到当前TVOC浓度
     * @return 当前TVOC浓度，单位:ppb
     */
    uint16_t getTVOCPPB();

    /**
     * @fn readBaseLine
     * @brief 获取当前基线数
     * @return 当前基线数，16进制数
     */
    uint16_t readBaseLine();

    /**
     * @fn writeBaseLine
     * @brief 将基线数写入寄存器
     * @param baseLine 基线数
     */
    void writeBaseLine(uint16_t baseLine);