# bme280

**Repository Path**: xiaodingding/bme280

## Basic Information

- **Project Name**: bme280
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-05-09
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BME280

## 简介

本软件包是为 Bosch BME280 加速度传感器提供的通用传感器驱动包。通过使用此软件包，开发者可以快速的利用 RT-Thread 将此传感器驱动起来。

本篇文档主要内容如下：

- 传感器介绍
- 支持情况
- 使用说明

## 传感器介绍

BME280 是 Bosch（博世）公司开发的一款环境传感器，既能测量气压也能测量湿度。

## 支持情况

| 包含设备         | 气压计 | 湿度计 | 温度计 |
| ---------------- | ------ | ------ | ------ |
| **通讯接口**     |        |        |        |
| IIC              | √      | √      | √      |
| SPI              |        |        |        |
| **工作模式**     |        |        |        |
| 轮询             | √      | √      | √      |
| 中断             |        |        |        |
| FIFO             |        |        |        |
| **电源模式**     |        |        |        |
| 掉电             | √      | √      | √      |
| 低功耗           |        |        |        |
| 普通             | √      | √      | √      |
| 高功耗           |        |        |        |
| **数据输出速率** | √      | √      | √      |
| **测量范围**     |        |        |        |
| **自检**         |        |        |        |
| **多实例**       |        |        |        |

## 使用说明

### 依赖

- RT-Thread 4.0.0+
- Sensor 组件
- IIC 驱动：BME280 设备使用 IIC 进行数据通讯，需要系统 IIC 驱动框架支持；
- PIN 驱动：用于处理设备中断引脚；

### 获取软件包

使用 BME280 软件包需要在 RT-Thread 的包管理中选中它，具体路径如下：

```
RT-Thread online packages --->
    peripheral libraries and drivers --->
        sensors drivers --->
            [*] BME280: BME280 sensor driver package, support: barometric, humidity.
                    Version (latest)  --->
```

**Version**：软件包版本选择

### 使用软件包

BME280 软件包初始化函数如下所示：

```
int rt_hw_bme280_init(const char *name, struct rt_sensor_config *cfg);
```

该函数需要由用户调用，函数主要完成的功能有，

- 设备配置和初始化（根据传入的配置信息，配置接口设备和中断引脚）；
- 注册相应的传感器设备，完成 BME280 设备的注册；

#### 初始化示例

```
#include "sensor_bosch_bme280.h"

int bme280_port(void)
{
    struct rt_sensor_config cfg;
    
    cfg.intf.dev_name = "i2c1";
    cfg.intf.user_data = (void *)BME280_ADDR_DEFAULT;
    cfg.irq_pin.pin = RT_PIN_NONE;

    rt_hw_bme280_init("bme280", &cfg);
    return 0;
}
INIT_APP_EXPORT(bme280_port);
```

## 注意事项

暂无

## 联系人信息

维护人:

- [guozhanxin](https://github.com/Guozhanxin)