【亲测免费】 HCSR04超声波传感器库使用教程

1. 项目目录结构及介绍

HCSR04-ultrasonic-sensor-lib/
├── examples/
│   ├── basic/
│   └── multiple_sensors/
├── src/
│   ├── HCSR04.cpp
│   └── HCSR04.h
├── LICENSE
├── README.md
├── keywords.txt
└── library.properties

目录结构说明

• examples/: 包含示例代码，帮助用户快速上手使用该库。
  • basic/: 基本的单传感器使用示例。
  • multiple_sensors/: 多传感器使用示例。
• src/: 包含库的核心源代码。
  • HCSR04.cpp: 库的实现文件。
  • HCSR04.h: 库的头文件。
• LICENSE: 项目的开源许可证文件，采用MIT许可证。
• README.md: 项目的介绍和使用说明。
• keywords.txt: 关键字文件，用于Arduino IDE中的语法高亮。
• library.properties: 库的元数据文件，包含库的名称、版本、作者等信息。

2. 项目的启动文件介绍

启动文件：examples/basic/basic.ino

#include <HCSR04.h>

HCSR04 hc(2, 3); // 初始化类 HCSR04 (触发引脚, 回声引脚)

void setup() {
  Serial.begin(9600);
}

void loop() {
  Serial.println(hc.dist()); // 返回当前距离（厘米）到串口
  delay(60); // 建议使用超过60ms的测量周期，以防止触发信号与回声信号冲突
}

启动文件说明

• #include <HCSR04.h>: 引入库的头文件。
• HCSR04 hc(2, 3);: 初始化HCSR04对象，指定触发引脚和回声引脚。
• setup(): 初始化串口通信。
• loop(): 循环读取传感器数据并输出到串口。

3. 项目的配置文件介绍

配置文件：library.properties

name=HCSR04 ultrasonic sensor
version=2.0.3
author=gamegine
maintainer=gamegine
sentence=Allows an Arduino board to use HCSR04 module
paragraph=This library allows an Arduino board to use multiple HCSR04 sensors for get current distance in cm.
category=Sensors
url=https://github.com/gamegine/HCSR04-ultrasonic-sensor-lib
architectures=*

配置文件说明

• name: 库的名称。
• version: 库的版本号。
• author: 库的作者。
• maintainer: 库的维护者。
• sentence: 库的简短描述。
• paragraph: 库的详细描述。
• category: 库的分类，这里是传感器。
• url: 库的GitHub仓库地址。
• architectures: 支持的架构，*表示支持所有架构。

通过以上内容，您可以快速了解并开始使用HCSR04超声波传感器库。