ESP32Encoder：一个功能强大、使用简便的ESP32 编码器库，助力快速实现机器人控制等编码器应用

作者

在嵌入式系统中，编码器是常见的传感器，用于测量角度、距离或速度。ESP32 芯片集成的脉冲计数器 (PCNT) 模块提供了硬件加速的编码器接口，可以高效地处理来自编码器的信号。ESP32Encoder 库正是利用了这个特性，为用户提供了简单易用的 API 接口，支持多达 8 个编码器，助力您的项目快速开发。

ESP32Encoder 简介

ESP32Encoder 库是基于 ESP32 芯片的脉冲计数器 (PCNT) 模块开发的，可以轻松地处理来自编码器的信号。该库提供了一个简单的 API 接口，支持多种编码器模式，包括全正交、半正交和单边计数模式。

优势

  • • 高效率： 利用 ESP32 的硬件脉冲计数器，ESP32Encoder 库能够高效地处理编码器信号，并提供精确的计数信息。

  • • 低功耗： 由于使用了硬件计数器，ESP32Encoder 库对 CPU 资源消耗很小，有助于降低系统功耗。

  • • 多编码器支持： ESP32Encoder 库最多支持 8 个编码器，方便用户在单个 ESP32 芯片上处理多个编码器数据。

  • • 易于使用： 该库提供了一个简单的 API 接口，方便用户快速上手。

应用场景

ESP32Encoder 库适用于各种需要编码器的应用场景，例如：

  • • 机器人控制： 控制机器人的关节运动

  • • 电机控制： 测量电机转速和位置

  • • 人机交互： 设计旋转编码器来控制系统参数

  • • 数据采集： 收集来自传感器的数据

主要功能

  • • 支持全正交、半正交和单边计数模式

  • • 提供配置选项，例如内部弱上拉/下拉电阻、中断服务例程 CPU 核心选择

  • • 支持硬件去抖动功能，减少噪声干扰

使用方法

ESP32Encoder 库的使用非常简单，以下是主要步骤：

  1. 1. 安装库： 使用 ESP-IDF 或Arduino包管理器安装 ESP32Encoder 库。

  2. 2. 创建编码器对象： 使用 ESP32Encoder 类创建一个编码器对象，并指定编码器的引脚和模式。

  3. 3. 设置配置： 使用 setFilter() 函数设置硬件去抖动滤波器，使用 useInternalWeakPullResistors() 函数设置内部弱上拉/下拉电阻，使用 isrServiceCpuCore() 函数设置中断服务例程 CPU 核心。

  4. 4. 获取计数信息： 使用 getCount() 函数获取编码器的当前计数信息。

代码示例

#include <Arduino.h>
#include "ESP32Encoder.h"

// 初始化编码器对象
ESP32Encoder encoder;

void setup() {
// 初始化串口
Serial.begin(115200);

// 将编码器连接到引脚
  encoder.attach(25,26,true,false);// 使用内部弱上拉电阻

// 设置硬件去抖动滤波器
  encoder.setFilter(1023);

// 打印计数信息
Serial.println("Encoder count: "+String(encoder.getCount()));
}

void loop() {
// 获取编码器计数信息
int32_t count = encoder.getCount();

// 打印计数信息
Serial.println("Encoder count: "+String(count));

// 延迟 100 毫秒
delay(100);
}

需要注意的细节

  • • ESP32Encoder 库支持的编码器数量受 ESP32 芯片的硬件限制，ESP32 和 ESP32C2 支持 8 个编码器，ESP32S3 支持 2 个编码器，ESP32C3 不支持硬件加速编码器。

  • • 对于某些类型的编码器，例如 KY-040 编码器，需要在编码器信号线上增加外部去抖电容 (0.1-2uF) 来减少机械抖动。

  • • 可以通过设置 isrServiceCpuCore() 函数来指定中断服务例程的运行 CPU 核心，避免由于多个编码器共享中断导致计数信息不准确的问题。

总结

ESP32Encoder 库是一个功能强大、使用简便的库，可以帮助用户快速实现基于 ESP32 的编码器应用。利用硬件加速的脉冲计数器，ESP32Encoder 库可以提供高效、稳定的编码器数据处理，为各种嵌入式系统提供可靠的解决方案。

项目地址：https://github.com/madhephaestus/ESP32Encoder


发表评论