/* USER CODE BEGIN Header */
/**
  ******************************************************************************
  * @file    sts_aq_sgp30.h		            								   *
  * @author  Yunhorn (r) Technology Limited Application Team	               *
  * @brief   Yunhorn (r) SmarToilets (r) Product configuration file.		   *
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2025 Yunhorn Technology Limited.
  * Copyright (c) 2025 Shenzhen Yunhorn Technology Co., Ltd.
  * All rights reserved.
  *
  * This software is licensed under terms that can be found in the LICENSE file
  * in the root directory of this software component.
  * If no LICENSE file comes with this software, it is provided AS-IS.
  *
  ******************************************************************************
  */
/* USER CODE END Header */

#ifndef SGP30_H
#define SGP30_H
#include "sensirion_arch_config.h"
#include "sensirion_common.h"
#include "sensirion_i2c.h"

#define SGP30_ERR_UNSUPPORTED_FEATURE_SET (-10)
#define SGP30_ERR_INVALID_PRODUCT_TYPE (-12)

#ifdef __cplusplus
extern "C"
{
#endif

    /**
     * sgp30_probe() - check if SGP sensor is available and initialize it
     *
     * This call aleady initializes the IAQ baselines (sgp30_iaq_init())
     *
     * Return:  STATUS_OK on success,
     *          SGP30_ERR_INVALID_PRODUCT_TYPE if the sensor is not an SGP30,
     *          SGP30_ERR_UNSUPPORTED_FEATURE_SET if the sensor's feature set
     *                                            is unknown or outdated,
     *          An error code otherwise
     */
    int16_t sgp30_probe(void);

    /**
     * sgp30_iaq_init() - reset the SGP's internal IAQ baselines
     *
     * Return:  STATUS_OK on success.
     */
    int16_t sgp30_iaq_init(void);

    /**
     * sgp30_get_driver_version() - Return the driver version
     * Return:  Driver version string
     */
    const char *sgp30_get_driver_version(void);

    /**
     * sgp30_get_configured_address() - returns the configured I2C address
     *
     * Return:      uint8_t I2C address
     */
    uint8_t sgp30_get_configured_address(void);

    /**
     * sgp30_get_feature_set_version() - Retrieve the sensor's feature set version
     * and product type
     *
     * @feature_set_version:    The feature set version
     * @product_type:           The product type: 0 for sgp30, 1: sgpc3
     *
     * Return:  STATUS_OK on success
     */
    int16_t sgp30_get_feature_set_version(uint16_t *feature_set_version,
                                          uint8_t *product_type);

    /**
     * sgp30_get_serial_id() - Retrieve the sensor's serial id
     *
     * @serial_id:    Output variable for the serial id
     *
     * Return:  STATUS_OK on success
     */
    int16_t sgp30_get_serial_id(uint64_t *serial_id);

    /**
     * sgp30_get_iaq_baseline() - read out the baseline from the chip
     *
     * The IAQ baseline should be retrieved and persisted for a faster sensor
     * startup. See sgp30_set_iaq_baseline() for further documentation.
     *
     * A valid baseline value is only returned approx. 60min after a call to
     * sgp30_iaq_init() when it is not followed by a call to
     * sgp30_set_iaq_baseline() with a valid baseline. This functions returns
     * STATUS_FAIL if the baseline value is not valid.
     *
     * @baseline:   Pointer to raw uint32_t where to store the baseline
     *              If the method returns STATUS_FAIL, the baseline value must be
     *              discarded and must not be passed to sgp30_set_iaq_baseline().
     *
     * Return:      STATUS_OK on success, else STATUS_FAIL
     */
    int16_t sgp30_get_iaq_baseline(uint32_t *baseline);

    /**
     * sgp30_set_iaq_baseline() - set the on-chip baseline
     * @baseline:   A raw uint32_t baseline
     *              This value must be unmodified from what was retrieved by a
     *              successful call to sgp30_get_iaq_baseline() with return value
     *              STATUS_OK. A persisted baseline should not be set if it is
     *              older than one week.
     *
     * Return:      STATUS_OK on success, an error code otherwise
     */
    int16_t sgp30_set_iaq_baseline(uint32_t baseline);

    /**
     * sgp30_get_tvoc_inceptive_baseline() - read the chip's tVOC inceptive baseline
     *
     * The inceptive baseline must only be used on the very first startup of the
     * sensor. It ensures that measured concentrations are consistent with the air
     * quality even before the first clean air event.
     *
     * @tvoc_inceptive_baseline:
     *              Pointer to raw uint16_t where to store the inceptive baseline
     *              If the method returns STATUS_FAIL, the inceptive baseline value
     *              must be discarded and must not be passed to
     *              sgp30_set_tvoc_baseline().
     *
     * Return:      STATUS_OK on success, an error code otherwise
     */
    int16_t sgp30_get_tvoc_inceptive_baseline(uint16_t *tvoc_inceptive_baseline);

    /**
     * sgp30_set_tvoc_baseline() - set the on-chip tVOC baseline
     * @baseline:   A raw uint16_t tVOC baseline
     *              This value must be unmodified from what was retrieved by a
     *              successful call to sgp30_get_tvoc_inceptive_baseline() with
     * return value STATUS_OK.
     *
     * Return:      STATUS_OK on success, an error code otherwise
     */
    int16_t sgp30_set_tvoc_baseline(uint16_t tvoc_baseline);

    /**
     * sgp30_measure_iaq_blocking_read() - Measure IAQ concentrations tVOC, CO2-Eq.
     *
     * @tvoc_ppb:   The tVOC ppb value will be written to this location
     * @co2_eq_ppm: The CO2-Equivalent ppm value will be written to this location
     *
     * The profile is executed synchronously.
     *
     * Return:      STATUS_OK on success, an error code otherwise
     */
    int16_t sgp30_measure_iaq_blocking_read(uint16_t *tvoc_ppb,
                                            uint16_t *co2_eq_ppm);
    /**
     * sgp30_measure_iaq() - Measure IAQ values async
     *
     * The profile is executed asynchronously. Use sgp30_read_iaq to get the values.
     *
     * Return:  STATUS_OK on success, an error code otherwise
     */
    int16_t sgp30_measure_iaq(void);

    /**
     * sgp30_read_iaq() - Read IAQ values async
     *
     * Read the IAQ values. This command can only be exectued after a measurement
     * has started with sgp30_measure_iaq and is finished.
     *
     * @tvoc_ppb:   The tVOC ppb value will be written to this location
     * @co2_eq_ppm: The CO2-Equivalent ppm value will be written to this location
     *
     * Return:      STATUS_OK on success, an error code otherwise
     */
    int16_t sgp30_read_iaq(uint16_t *tvoc_ppb, uint16_t *co2_eq_ppm);

    /**
     * sgp30_measure_tvoc_blocking_read() - Measure tVOC concentration
     *
     * The profile is executed synchronously.
     *
     * Return:  tVOC concentration in ppb. Negative if it fails.
     */
    int16_t sgp30_measure_tvoc_blocking_read(uint16_t *tvoc_ppb);

    /**
     * sgp30_measure_tvoc() - Measure tVOC concentration async
     *
     * The profile is executed asynchronously. Use sgp30_read_tvoc to get the
     * ppb value.
     *
     * Return:  STATUS_OK on success, an error code otherwise
     */
    int16_t sgp30_measure_tvoc(void);

    /**
     * sgp30_read_tvoc() - Read tVOC concentration async
     *
     * Read the tVOC value. This command can only be exectued after a measurement
     * has started with sgp30_measure_tvoc and is finished.
     *
     * @tvoc_ppb:   The tVOC ppb value will be written to this location
     *
     * Return:      STATUS_OK on success, an error code otherwise
     */
    int16_t sgp30_read_tvoc(uint16_t *tvoc_ppb);

    /**
     * sgp30_measure_co2_eq_blocking_read() - Measure CO2-Equivalent concentration
     *
     * The profile is executed synchronously.
     *
     * Return:  CO2-Equivalent concentration in ppm. Negative if it fails.
     */
    int16_t sgp30_measure_co2_eq_blocking_read(uint16_t *co2_eq_ppm);

    /**
     * sgp30_measure_co2_eq() - Measure tVOC concentration async
     *
     * The profile is executed asynchronously. Use sgp30_read_co2_eq to get the
     * ppm value.
     *
     * Return:  STATUS_OK on success, an error code otherwise
     */
    int16_t sgp30_measure_co2_eq(void);

    /**
     * sgp30_read_co2_eq() - Read CO2-Equivalent concentration async
     *
     * Read the CO2-Equivalent value. This command can only be exectued after a
     * measurement was started with sgp30_measure_co2_eq() and is finished.
     *
     * @co2_eq_ppm: The CO2-Equivalent ppm value will be written to this location
     *
     * Return:      STATUS_OK on success, an error code otherwise
     */
    int16_t sgp30_read_co2_eq(uint16_t *co2_eq_ppm);

    /**
     * sgp30_measure_raw_blocking_read() - Measure raw signals
     * The profile is executed synchronously.
     *
     * @ethanol_raw_signal: Output variable for the ethanol raw signal
     * @h2_raw_signal:      Output variable for the h2 raw signal
     *
     * Return:      STATUS_OK on success, an error code otherwise
     */
    int16_t sgp30_measure_raw_blocking_read(uint16_t *ethanol_raw_signal,
                                            uint16_t *h2_raw_signal);

    /**
     * sgp30_measure_raw() - Measure raw signals async
     *
     * The profile is executed asynchronously. Use sgp30_read_raw to get the
     * signal values.
     *
     * Return:  STATUS_OK on success, an error code otherwise
     */
    int16_t sgp30_measure_raw(void);

    /**
     * sgp30_read_raw() - Read raw signals async
     * This command can only be exectued after a measurement started with
     * sgp30_measure_raw and has finished.
     *
     * @ethanol_raw_signal: Output variable for ethanol raw signal.
     * @h2_raw_signal: Output variable for h2 raw signal.
     *
     * Return:      STATUS_OK on success, an error code otherwise
     */
    int16_t sgp30_read_raw(uint16_t *ethanol_raw_signal, uint16_t *h2_raw_signal);

    /**
     * sgp30_measure_test() - Run the on-chip self-test
     *
     * This method is executed synchronously and blocks for the duration of the
     * measurement (~220ms)
     *
     * @test_result:    Allocated buffer to store the chip's error code.
     *                  test_result is SGP30_CMD_MEASURE_TEST_OK on success or set
     *                  to zero (0) in the case of a communication error.
     *
     * Return: STATUS_OK on a successful self-test, an error code otherwise
     */
    int16_t sgp30_measure_test(uint16_t *test_result);

    /**
     * sgp30_set_absolute_humidity() - set the absolute humidity for compensation
     *
     * The absolute humidity must be provided in mg/m^3 and the value must be
     * between 0 and 256000 mg/m^3.
     * If the absolute humidity is set to zero, humidity compensation is disabled.
     *
     * @absolute_humidity:      absolute humidity in mg/m^3
     *
     * Return:      STATUS_OK on success, an error code otherwise
     */
    int16_t sgp30_set_absolute_humidity(uint32_t absolute_humidity);

#ifdef __cplusplus
}
#endif

#endif /* SGP30_H */

/**********************************************************
 *@file    sgp30.h
 *@brief
 *         基于STM32 HAL 库的SGP30 甲醛传感器驱动
 *
 *@author  mculover666<2412828003@qq.com>
 *@date    2020/07/23
 *@note
 *         1. 驱动默认使用硬件i2c 1
 *         2. 如果不需要打印报错信息，可以去掉printf相关
**********************************************************/

#ifndef _SGP30_H_
#define _SGP30_H_

//#include "stm32l4xx.h"
#include <stdio.h>
#include <system.h>

#define SGP30_ADDR          0x58
#define	SGP30_ADDR_WRITE	SGP30_ADDR<<1       //0xb0
#define	SGP30_ADDR_READ		(SGP30_ADDR<<1)+1   //0xb1

/* SGP30传感器接的硬件I2C接口 */
//#define SGP30_I2C_Handle_Name   hi2c1
//I2C_HandleTypeDef SGP30_I2C_Handle_Name;

typedef struct sgp30_data_st {
    u16t co2;
    u16t tvoc;
}sgp30_data_t;

typedef enum sgp30_cmd_en {
    /* 初始化空气质量测量 */
    INIT_AIR_QUALITY = 0x2003,
    
    /* 开始空气质量测量 */
    MEASURE_AIR_QUALITY = 0x2008
    
} sgp30_cmd_t;

// extern I2C_HandleTypeDef SGP30_I2C_Handle_Name;
extern sgp30_data_t      sgp30_data;

int sgp30_init(void);
int sgp30_read(void);


#endif /* _SGP30_H_ */