# DFRobot_PAV3000

**Repository Path**: dfrobot/DFRobot_PAV3000

## Basic Information

- **Project Name**: DFRobot_PAV3000
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

DFRobot_PAV3000
===========================

* [English Version](./README.md)

这是一个空气流速传感器的驱动库。

![产品效果图片](./resources/images/SEN0501.png)
![产品效果图片](./resources/images/SEN0500.png)

## 产品链接（https://www.dfrobot.com）

    SKU：NULL
  
## 目录

  * [概述](#概述)
  * [库安装](#库安装)
  * [方法](#方法)
  * [兼容性](#兼容性)
  * [历史](#历史)
  * [创作者](#创作者)

## 概述

这是一个空气流速传感器的驱动库。

## 库安装

使用此库前，请首先下载库文件，将其粘贴到\Arduino\libraries目录中，然后打开examples文件夹并在该文件夹中运行演示。

## 方法

```C++
    /**
     * @fn setRange
     * @brief 设置气流检测范围并初始化校准数据。
     * @details 本函数将传感器配置为 7 m/s 或 15 m/s 量程，并加载相应的校准数据点用于线性插值。
     *          校准数据由原始 ADC 值及对应的特定点气流速度组成。
     * @param range AIRFLOW_RANGE_7_MPS: PAV3000_1005 (0-7.23 m/s)，
     *              AIRFLOW_RANGE_15MPS: PAV3000_1015 (0-15 m/s)
     * @return 1: 设置成功，0: 设置失败（I2C 通信错误）
     */
    uint8_t setRange(uint8_t range);

    /**
     * @fn readRaw
     * @brief 获取传感器得原始数据
     * @return PAV3000 寄存器原始数据
     */
    uint16_t readRaw(void);

    /**
     * @fn readMeterPerSec
     * @brief 使用线性插值法获取以米每秒为单位的气流速度。
     * @details 本函数通过线性插值算法将原始 ADC 值转换为速度测量值。算法流程如下：
     *          1. 从传感器读取原始 ADC 值
     *          2. 检查数值是否在有效范围内 (409-3686)
     *          3. 找到包围该原始值的校准数据点
     *          4. 计算原始值在区间内的百分比位置
     *          5. 应用线性插值公式：velocity = v1 + (v2 - v1) * percentage
     * @return 返回气流速度（单位：m/s），若传感器读数无效则返回 0.0
     */
    float readMeterPerSec(void);

    /**
     * @fn readMilePerHour
     * @brief 获取英里/小时为单位的空气流速
     * @return 空气流速数据
     */
    float readMilePerHour(void);
```


## 兼容性

MCU                | SoftwareSerial | HardwareSerial |      IIC      |
------------------ | :----------: | :----------: | :----------: | 
Arduino Uno        |      X       |      X       |      √       |
Mega2560           |      X       |      X       |      √       |
Leonardo           |      X       |      X       |      √       |
ESP32              |      X       |      X       |      √       |
ESP8266            |      X       |      X       |      √       |
micro:bit          |      X       |      X       |      √       |
FireBeetle M0      |      X       |      X       |      √       |
raspberry          |      X       |      X       |      √       |

## 历史
- 2024-12-05 - 1.0.0 版本

## 创作者

Written by TangJie(jie.tang@dfrobot.com), 2025. (Welcome to our [website](https://www.dfrobot.com/))