# cht8305_cht8310_c_驱动

**Repository Path**: wangykzg/cht8305cht8310c-driver

## Basic Information

- **Project Name**: cht8305_cht8310_c_驱动
- **Description**: 使用mcu驱动cht8305或者8310读取温湿度数据的驱动文件，代码中采用stm32实现，可方便的改为其他mcu
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-29
- **Last Updated**: 2025-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CHT8305/CHT8310 温湿度传感器驱动

[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)

## 简介

这是一个为 CHT8305 和 CHT8310 温湿度传感器编写的驱动程序，基于 STM32 HAL 库和 I2C 外设。它支持多型号检测、数据采集与转换，并提供简单的接口函数以方便集成。

## 特性

- 自动检测传感器型号（CHT8305C 和 CHT8310）。
- 支持读取原始温湿度数据并转换为实际值（温度：℃，湿度：%RH）。
- 基于 STM32 HAL 库的 I2C 通信实现。
- 提供初始化、数据采集和转换的完整流程。

## 文件结构

- `cht8305_8310.c`：驱动程序实现文件。
- `cht8305_8310.h`：驱动程序头文件，包含寄存器定义、传感器型号、配置结构体和函数声明。

## 安装

1. **硬件连接**：将传感器的 I2C 引脚连接到 STM32 开发板的 I2C 端口（如 I2C2）。
2. **依赖项**：确保已安装并配置好 STM32 HAL 库。
3. **代码集成**：
   - 将 `cht8305_8310.c` 和 `cht8305_8310.h` 文件添加到您的项目中。
   - 在项目中包含 `cht8305_8310.h` 头文件。

## 使用方法

### 初始化

调用 `cht8305_8310_sensor_init()` 函数初始化传感器。该函数会自动检测传感器型号并进行配置。

```c
if (!cht8305_8310_sensor_init())
{
    // 初始化失败处理
    return -1;
}
```
### 数据读取
调用   `get_cht8305_8310_temp_humi(float *temp, float *humi)`   函数获取温湿度数据。

```c
uint16_t temperature, humidity;

cht8305_8310_get_temperature_humidity(&temperature, &humidity);

```
### 示例代码

```c
#include "cht8305_8310.h"

int main(void)
{
    // 初始化传感器
    if (!cht8305_8310_sensor_init())
    {
        // 初始化失败处理
        return -1;
    }

    float temperature, humidity;

    while (1)
    {
        // 获取温湿度数据
        get_cht8305_8310_temp_humi(&temperature, &humidity);

        // 打印温湿度值
        printf("Temperature: %.2f°C, Humidity: %.2f%%RH\n", temperature, humidity);

        // 延时一段时间后再次读取
        HAL_Delay(1000);
    }

    return 0;
}
```

## 注意事项

- 请确保传感器的 I2C 地址正确。
- iic配置正确

## 贡献

如果您对此项目有任何意见或建议，欢迎提交 [issue](https://github.com/hzlzh/CHT8305C-CHT8310-Sensor-HAL/issues) 或 [PR](https://github.com/hzlzh/CHT8305C-CHT8310-Sensor-HAL/pulls)。
## 许可证

本项目采用 MIT 许可证。