项目简介
本项目提供了名为CmdSerial的Arduino库,能简化通过串口接收和处理命令的流程,允许用户定义命令、设置值,以结构化方式从串口监视器接收输入。
项目的主要特性和功能
- 命令处理:支持定义和响应串口接收的命令。
- 值设置:可根据接收到的命令设置变量的值。
- 帮助功能:提供获取可用命令及其使用方法信息的内置机制。
- 串口监视器交互:支持通过串口监视器发送数据,用预定义关键字进行监控和停止监控。
安装使用步骤
安装
- 解压文件:将下载的ZIP文件解压。
- 复制文件夹:把解压后的文件夹复制到Arduino sketchbook目录下的
libraries
文件夹中。 - 重命名文件夹:将文件夹重命名为
CmdSerial
。 - 重启Arduino IDE:若Arduino IDE已打开,需重启以加载新库。
使用示例
- 包含头文件:在Arduino草图中包含
CmdSerial.h
头文件: ```cpp
include
2. 创建实例:创建CmdSerial类的实例:
cpp
CmdSerial cmd;
3. 监听命令:在`loop()`函数中调用`listen()`方法监听串口命令:
cpp
void loop() {
cmd.listen();
// 其他代码
}
4. 定义命令:使用`show()`方法定义命令。例如,响应`data show`命令:
cpp
int testInt = 42;
if (cmd.show(F("data"))) {
cmd.print(F("Output message"), testInt);
}
5. 设置值:使用`set()`方法根据串口命令设置变量值。例如,设置`temperature`值:
cpp
float temperature;
if (cmd.set(F("temperature"), temperature)) {
// 值已设置,执行额外操作
}
``
6. 获取帮助:在串口监视器中输入
help获取所有定义的命令列表,或输入特定命令名后跟
help`获取详细信息。
在线示例
可在Wokwi在线模拟器中查看该库的在线模拟示例。
文档
所有方法的详细文档可在api.md中找到。
许可证
本库基于MIT许可证发布,详细信息请参阅LICENSE文件。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】