STM32H750XB_RT-THREAD/I2C—AP3216C(光照三合一)/4.AP3216C全功能例程_(模拟I2C)/User/ap3216c/ap3216c.h

148 lines
5.0 KiB
C
Raw Permalink Normal View History

2025-07-21 06:34:29 +00:00
#ifndef __DRV_AP3216C_H__
#define __DRV_AP3216C_H__
#include "stm32h7xx.h"
//<2F>ж<EFBFBD><D0B6><EFBFBD><EFBFBD>Ŷ<EFBFBD><C5B6><EFBFBD>
/*******************************************************/
#define AP_INT_GPIO_PORT GPIOD
#define AP_INT_GPIO_CLK_ENABLE() __GPIOD_CLK_ENABLE();
#define AP_INT_GPIO_PIN GPIO_PIN_7
/*******************************************************/
#define AP_INT_Read() HAL_GPIO_ReadPin(AP_INT_GPIO_PORT, AP_INT_GPIO_PIN) // <20><><EFBFBD>ж<EFBFBD><D0B6><EFBFBD><EFBFBD>ŵ<EFBFBD>״̬
void AP_INT_Config(void);
enum ap3216c_mode_value
{
AP3216C_MODE_POWER_DOWN, //Power down (Default)
AP3216C_MODE_ALS, //ALS function active
AP3216C_MODE_PS, //PS+IR function active
AP3216C_MODE_ALS_AND_PS, //ALS and PS+IR functions active
AP3216C_MODE_SW_RESET, //SW reset
AP3216C_MODE_ALS_ONCE, //ALS function once
AP3216C_MODE_PS_ONCE, //PS+IR function once
AP3216C_MODE_ALS_AND_PS_ONCE, //ALS and PS+IR functions once
};
enum ap3216c_int_clear_manner
{
AP3216C_INT_CLEAR_MANNER_BY_READING, //INT is automatically cleared by reading data registers(Default)
AP3216C_ALS_CLEAR_MANNER_BY_SOFTWARE, //Software clear after writing 1 into address 0x01 each bit
};
enum als_range
{
AP3216C_ALS_RANGE_20661, //Resolution = 0.35 lux/count(default).
AP3216C_ALS_RANGE_5162, //Resolution = 0.0788 lux/count.
AP3216C_ALS_RANGE_1291, //Resolution = 0.0197 lux/count.
AP3216C_ALS_RANGE_323, //Resolution = 0.0049 lux/count
};
typedef enum als_range als_range_t;
enum ps_gain
{
AP3216C_PS_GAIN1, //detection distance *1.
AP3216C_PS_GAIN2, //detection distance *2 (default).
AP3216C_PS_GAIN4, //detection distance *4.
AP3216C_PS_GAIN8, //detection distance *8.
};
typedef enum als_gain ps_gain_t;
enum ap3216c_cmd
{
AP3216C_SYSTEM_MODE, //system Configuration(Default : 000)
AP3216C_INT_PARAM, //INT Clear Manner(Default : 0)
AP3216C_ALS_RANGE, //ALS dynamic range(Default : 00)
AP3216C_ALS_PERSIST, //ALS persist(Default : 0000)
AP3216C_ALS_CALIBRATION, //ALS window loss calibration(Default : 0x40)
AP3216C_ALS_LOW_THRESHOLD_L, //Lower byte of low interrupt threshold for ALS(Default : 0x00)
AP3216C_ALS_LOW_THRESHOLD_H, //Higher byte of low interrupt threshold for ALS(Default : 0x00)
AP3216C_ALS_HIGH_THRESHOLD_L, //Lower byte of high interrupt threshold for ALS (Default : 0xFF)
AP3216C_ALS_HIGH_THRESHOLD_H, //Higher byte of high interrupt threshold for ALS(Default : 0xFF)
AP3216C_PS_INTEGRATED_TIME, //PS or IR Integrated time select(Default : 0000)
AP3216C_PS_GAIN, //PS gain (Default : 01)
AP3216C_PS_PERSIST, //Interrupt filter(Default : 01)
AP3216C_PS_LED_CONTROL, //LED pulse(Default : 01)
AP3216C_PS_LED_DRIVER_RATIO, //LED driver ratio(Default : 11)
AP3216C_PS_INT_MODE, //PS INT Mode(Default : 0x01)
AP3216C_PS_MEAN_TIME, //PS mean time(Default : 0x00)
AP3216C_PS_WAITING_TIME, //PS LED Waiting(Default : 0x00)
AP3216C_PS_CALIBRATION_L, //PS Calibration L(Default : 0x00)
AP3216C_PS_CALIBRATION_H, //PS Calibration H(Default : 0x00)
AP3216C_PS_LOW_THRESHOLD_L, //PS Low Threshold L(Default :0x00)
AP3216C_PS_LOW_THRESHOLD_H, //PS Low Threshold H(Default :0x00)
AP3216C_PS_HIGH_THRESHOLD_L, //PS high Threshold L(Default :0xff)
AP3216C_PS_HIGH_THRESHOLD_H, //PS high Threshold H(Default :0xff)
};
typedef enum ap3216c_cmd ap3216c_cmd_t;
/* intrrupt parameters of ap3216c on ps or als */
struct ap3216c_threshold
{
uint16_t min; /* als 16 bits, ps 10 bits available(low byte <20><>0-1 bit and High Byte <20><>8-15 bit ) */
uint16_t max; /* als 16 bits, ps 10 bits available(low byte <20><>0-1 bit and High Byte <20><>8-15 bit ) */
uint8_t noises_time; /* filter special noises trigger interrupt */
};
typedef struct ap3216c_threshold ap3216c_threshold_t;
uint8_t ap3216c_get_IntStatus(void);
/**
* This function initializes ap3216c registered device driver
*
* @param no
*
* @return no
*/
void ap3216c_init(void);
/**
* This function reads temperature by ap3216c sensor measurement
*
* @param no
*
* @return the ambient light converted to float data.
*/
float ap3216c_read_ambient_light(void);
/**
* This function reads temperature by ap3216c sensor measurement
*
* @param no
*
* @return the proximity data.
*/
uint16_t ap3216c_read_ps_data(void);
uint16_t ap3216c_read_ir_data(void);
/**
* This function sets parameter of ap3216c sensor
*
* @param cmd the parameter cmd of device
* @param value for setting value in cmd register
*
* @return the setting parameter status,RT_EOK reprensents setting successfully.
*/
void ap3216c_set_param(ap3216c_cmd_t cmd, uint8_t value);
/**
* This function gets parameter of ap3216c sensor
*
* @param cmd the parameter cmd of device
* @param value to get value in cmd register
*
* @return the getting parameter status,RT_EOK reprensents getting successfully.
*/
void ap3216c_get_param(ap3216c_cmd_t cmd, uint8_t *value);
#endif /*__DRV_AP3216C_H__ */