Example 40: BMP280 pressure sensor

Synchronized Device Documentation

This page corresponds to the synchronized Chinese source. Commands, JSON examples, API paths, field names, and screenshots are kept aligned with the Chinese device-side source documentation.

What This Page Covers

• Overview
• Wiring
• JSON Configuration Example
• PeriphExec Linkage
• Notes

Source Reference

The detailed operational source is preserved below so implementation details stay exact while the English navigation, titles, and reading path remain available.

示例40:BMP280气压传感器

实验概述

BMP280 是一款高精度数字气压/温度传感器，通过 I2C 接口通信。可测量气压（300_{1100hPa）、温度（-40}+85°C）和估算海拔。FastBee 在 ESP32-S3（full 固件）中内置 BMP280 驱动。

注意：此功能仅在 ESP32-S3（full 固件）中可用，需要 FASTBEE_ENABLE_I2C_SENSORS=1。

硬件接线

开发板标识	GPIO引脚	连接设备
SDA	GPIO21	BMP280 SDA
SCL	GPIO22	BMP280 SCL

BMP280 I2C 地址：SDO接GND为 0x76，SDO接VCC为 0x77。

JSON 配置示例

{
  "peripherals": [
    {
      "id": "bmp280_01",
      "name": "BMP280气压计",
      "type": 38,
      "enabled": false,
      "pins": [21, 22],
      "params": {
        "category": "bmp280",
        "i2cAddress": "0x76"
      }
    }
  ]
}

数据通道

通道	字段名	单位	说明
0	temperature	°C	环境温度
1	pressure	hPa	大气压强
2	altitude	m	估算海拔（基于标准气压）

外设执行联动

场景：气压温度采集（定时触发）

功能：定时读取BMP280的气压和温度数据

Web界面配置步骤

步骤1：创建规则

1. 点击左侧菜单 外设配置 → 切换到 外设执行管理 标签
2. 点击 新增规则 按钮
3. 填写基础配置：
   • 规则名称：气压温度采集
   • 上报数据：✅ 启用
   • 启用：✅ 启用

步骤2：配置触发器（定时触发）

1. 点击 添加触发 按钮

2. 填写触发器配置：

   字段	填写内容	说明
   触发类型	选择 定时触发	定时采集
   定时模式	选择 固定间隔	按秒间隔
   间隔时间	10	10秒

步骤3：配置动作（传感器读取）

1. 点击 添加动作 按钮

2. 填写：

   • 动作类型：选择 传感器读取
   • 目标外设：选择 bmp280_01
   • 数据字段：pressure（气压）

3. 点击 保存 按钮

BMP280数据通道

通道	字段名	单位	说明
0	temperature	°C	环境温度
1	pressure	hPa	大气压强（300-1100hPa）
2	altitude	m	估算海拔（基于标准气压）

注意事项

1. 仅 S3-full：需要 ESP32-S3 + full 固件
2. I2C 共享：可与其他 I2C 设备共享总线（SDA/SCL）
3. 海拔精度：海拔估算基于标准气压 1013.25hPa，实际需校准
4. 采样间隔：建议 5-10 秒采样一次
5. BME280 兼容：BME280（带湿度）使用相同地址和基本协议