ESP32 PCNT模块双通道配置实现高精度正交编码方向检测

1. 从“数脉冲”到“辨方向”：为什么ESP32的PCNT模块这么特别？

大家好，我是老陈，在嵌入式这块摸爬滚打十几年了，玩过不少单片机。今天想和大家聊聊ESP32里一个非常有意思的硬件模块——PCNT，也就是脉冲计数器。很多朋友第一次接触它，可能觉得这不就是个“数数”的嘛，给个脉冲就加一，能有多复杂？我以前也是这么想的，直到有一次项目里要用旋转编码器，才发现这玩意儿用好了，简直是“麻雀虽小，五脏俱全”，尤其是它的双通道配置，能实现正交编码的方向检测，这个功能在电机控制、位置反馈这些场景里太关键了。

简单来说，ESP32的PCNT模块，基础功能确实是数脉冲。但它聪明就聪明在，一个计数通道里，给了你两个“观察员”：一个专门盯着信号的边沿（是上升沿还是下降沿），另一个则盯着信号的电平（当前是高还是低）。这就好比你有两个哨兵，一个负责看敌人是“来了”（上升沿）还是“走了”（下降沿），另一个负责看敌人是“站着”（高电平）还是“趴着”（低电平）。单独一个哨兵信息有限，但两个哨兵的信息一结合，故事就完整了。

而正交编码器，正是输出两路相位差90度的方波信号（通常叫A相和B相）。它的核心价值就在于，通过这两路信号的相位关系，我们不仅能知道转了多少格（脉冲数），还能知道是顺时针转还是逆时针转（方向）。传统的软件解码或者用普通外部中断的方式，虽然也能实现，但会占用大量CPU时间，响应速度也受限制。ESP32的PCNT模块，通过硬件级别的双通道协同工作，把方向判断这个逻辑“固化”在了硬件里，CPU几乎不用管，计数和方向信息就实时、准确地出来了，既省心又高效。

所以，如果你正在为你的智能小车、DIY数控机床、或者任何一个需要精确知道旋转方向和角度的项目寻找方案，那么好好琢磨一下ESP32的PCNT双通道配置，绝对是一个性价比超高的选择。它把看似需要复杂逻辑判断的“方向检测”，转化成了一种优雅的硬件配置，接下来我就带你一步步拆解这里面的门道。

2. 庖丁解牛：正交编码的波形与PCNT的“眼睛”

要理解PCNT怎么判断方向，咱们得先回到问题的源头：正交编码器输出的波形到底长啥样？理解了波形，后面的配置逻辑就水到渠成了。

2.1 正交编码器的“语言”：A相与B相

想象一下旋转编码器的轴，它转动时，会输出两路方波信号，我们命名为A和B。它们频率相同，但关键点在于，其中一路总会比另一路领先或落后1/4个周期，也就是90度的相位差。这个相位差的方向，就编码了旋转方向。

• 正向旋转（例如顺时针）：A相领先B相90度。具体到波形上看，当A相发生跳变（比如上升沿）时，我们去观察B相的电平，会发现B相此时是高电平。反过来，当B相发生跳变时，A相是低电平。
• 反向旋转（例如逆时针）：B相领先A相90度。此时，当A相跳变时，B相是低电平；当B相跳变时，A相是高电平。

这个“在某个跳变边沿时刻，观察另一路信号的电平高低”的关系，就是方向判断的黄金法则。我画个简单的逻辑表，大家一看就明白：

旋转方向	A相边沿时刻	B相电平	B相边沿时刻	A相电平
正向	跳变（上/下）	高	跳变（上/下）	低
反向	跳变（上/下）	低	跳变（上/下）	高

你看，规律非常清晰。PCNT模块要做的，就是实时捕捉这个规律。

2.2 PCNT的双通道如何“分工协作”

现在，我们把PCNT模块的两个“观察员”——边沿检测和电平检测——派到这两路信号上去。但这里有个精妙的设计：我们需要配置两个PCNT通道，并且让它们交叉监视。

• 通道A：它的“边沿检测员”盯着A相信号的跳变，而它的“电平检测员”却盯着B相信号的高低。
• 通道B：正好相反，它的“边沿检测员”盯着B相信号的跳变，它的“电平检测员”盯着A相信号的高低。

这就形成了一种交叉验证的机制。每个通道都只负责“半个故事”：通道A在A相跳变时，记录下B相的状态；通道B在B相跳变时，记录下A相的状态。然后，PCNT模块内部根据一套预设的规则（我们接下来要配置的set_edge_action和set_level_action），来决定此时计数器是加、是减，还是保持不动。

我打个比方，这就像两个人（通道A和B）在玩一个协作游戏。A只负责在自己听到哨声（A相边沿）时，看B举的是红旗还是蓝旗（B相电平），然后根据规则决定往计分板上写“+1”还是“-1”。B同理，在自己听到哨声（B相边沿）时，看A举什么旗（A相电平）来决定操作。两个人配合，就能完整还原整个旋转过程的方向和步数。

3. 实战配置：手把手写代码实现方向检测

理论说再多，不如一行代码。我们直接上干货，看看如何用ESP-IDF的API，把上面说的这套逻辑配置出来。我会把每一步都掰开揉碎了讲，确保你不仅能复制粘贴，更能理解为什么这么写。

3.1 硬件连接与基础单元配置

首先，假设你的旋转编码器的A相接在了GPIO32上，B相接在了GPIO33上。我们先把PCNT计数单元创建出来。

#include "driver/pcnt.h"

// 定义引脚
#define ENCODER_A_GPIO 32
#define ENCODER_B_GPIO 33
// 定义计数器的上下限，防止溢出（这里根据你的编码器每转脉冲数设置，留足余量）
#define PCNT_HIGH_LIMIT 10000
#define PCNT_LOW_LIMIT  -10000

pcnt_unit_handle_t pcnt_unit = NULL; // PCNT单元句柄

void encoder_init() {
    // 1. 配置并创建PCNT单元
    pcnt_unit_config_t unit_config = {
        .high_limit = PCNT_HIGH_LIMIT,
        .low_limit = PCNT_LOW_LIMIT,
        .flags.accum_count = true, // 非常重要！允许计数值累积，而不是到达阈值后复位
    };
    ESP_ERROR_CHECK(pcnt_new_unit(&unit_config, &pcnt_unit));

    // 2. （可选但强烈推荐）设置毛刺滤波器
    // 机械编码器可能会有抖动，产生毛刺脉冲，这个滤波器可以过滤掉短时间的噪声
    pcnt_glitch_filter_config_t filter_config = {
        .max_glitch_ns = 1000, // 过滤掉宽度小于1000纳秒（1微秒）的脉冲
    };
    ESP_ERROR_CHECK(pcnt_unit_set_glitch_filter(pcnt_unit, &filter_config));
}

这里有几个关键点：

• accum_count标志位设为true：这表示计数器到达上限或下限后，会继续累积计数，而不是清零或停止。对于需要连续旋转的编码器，这是必须的。否则转几圈就卡住了。
• glitch filter：对于廉价的机械编码器，触点抖动是家常便饭。这个硬件滤波器能帮你省去很多软件去抖的麻烦，直接过滤掉极短的干扰脉冲，让计数更稳定。1微秒（1000ns）是个常用的起始值，你可以根据实际情况调整。

3.2 核心魔法：双通道的交叉配置

接下来是最关键的一步，创建两个通道并进行交叉配置。这是实现方向检测的灵魂所在。

    // 3. 创建通道A：用A相做边沿检测，B相做电平控制
    pcnt_channel_handle_t pcnt_chan_a = NULL;
    pcnt_chan_config_t chan_a_config = {
        .edge_gpio_num = ENCODER_A_GPIO, // 边沿检测引脚 -> A相
        .level_gpio_num = ENCODER_B_GPIO, // 电平控制引脚 -> B相
        // .virt_edge 和 .invert_edge 等参数通常保持默认即可
    };
    ESP_ERROR_CHECK(pcnt_new_channel(pcnt_unit, &chan_a_config, &pcnt_chan_a));

    // 4. 创建通道B：用B相做边沿检测，A相做电平控制
    pcnt_channel_handle_t pcnt_chan_b = NULL;
    pcnt_chan_config_t chan_b_config = {
        .edge_gpio_num = ENCODER_B_GPIO, // 边沿检测引脚 -> B相
        .level_gpio_num = ENCODER_A_GPIO, // 电平控制引脚 -> A相
    };
    ESP_ERROR_CHECK(pcnt_new_channel(pcnt_unit, &chan_b_config, &pcnt_chan_b));

配置好硬件连接后，我们要给每个通道设定“行为准则”：当边沿发生时做什么？当电平不同时又该如何影响这个行为？

    // 5. 配置通道A的动作规则
    // 边沿动作：上升沿时计数器减少，下降沿时计数器增加
    ESP_ERROR_CHECK(pcnt_channel_set_edge_action(pcnt_chan_a,
                                                PCNT_CHANNEL_EDGE_ACTION_DECREASE, // 上升沿动作
                                                PCNT_CHANNEL_EDGE_ACTION_INCREASE)); // 下降沿动作
    // 电平动作：当电平控制引脚（B相）为高时，保持上面边沿动作的设置；为低时，反转边沿动作的设置
    ESP_ERROR_CHECK(pcnt_channel_set_level_action(pcnt_chan_a,
                                                 PCNT_CHANNEL_LEVEL_ACTION_KEEP,    // 高电平动作
                                                 PCNT_CHANNEL_LEVEL_ACTION_INVERSE)); // 低电平动作

    // 6. 配置通道B的动作规则
    // 边沿动作：上升沿时计数器增加，下降沿时计数器减少 （注意：这里和通道A是相反的！）
    ESP_ERROR_CHECK(pcnt_channel_set_edge_action(pcnt_chan_b,
                                                PCNT_CHANNEL_EDGE_ACTION_INCREASE, // 上升沿动作
                                                PCNT_CHANNEL_EDGE_ACTION_DECREASE)); // 下降沿动作
    // 电平动作：当电平控制引脚（A相）为高时，保持；为低时，反转。
    ESP_ERROR_CHECK(pcnt_channel_set_level_action(pcnt_chan_b,
                                                 PCNT_CHANNEL_LEVEL_ACTION_KEEP,
                                                 PCNT_CHANNEL_LEVEL_ACTION_INVERSE));

这段配置代码是精华，我多解释几句。set_edge_action定义了该通道“听到哨声”（检测到边沿）时的本能反应。我们故意把通道A和B的本能反应设成相反（一个上升沿减、下降沿加；另一个上升沿加、下降沿减）。set_level_action则定义了“看到旗子”（检测到电平）时，是否要改变这个本能反应。INVERSE就是反转，加变减，减变加；KEEP就是保持原样。

这套组合拳打下来，就完美对应了我们在第2章总结的波形规律。当正向旋转时，A相边沿对应B相高电平（通道A的LEVEL_ACTION_KEEP生效，执行其“上升沿减、下降沿加”），B相边沿对应A相低电平（通道B的LEVEL_ACTION_INVERSE生效，反转其“上升沿加、下降沿减”，变成“上升沿减、下降沿加”）。两个通道在正转时，所有边沿产生的动作都变成了增加计数。反向旋转时，通过电平的反转作用，两个通道的所有边沿动作都变成了减少计数。这样就实现了每个有效边沿都计数，且自动区分方向！

3.3 启动与读数

配置完成后，我们就可以启动单元并随时读取计数值了。

    // 7. （可选）设置监视点，用于触发中断，这里我们先不用
    // ESP_ERROR_CHECK(pcnt_unit_add_watch_point(pcnt_unit, PCNT_HIGH_LIMIT));

    // 8. 启用单元，清空计数，然后启动
    ESP_ERROR_CHECK(pcnt_unit_enable(pcnt_unit));
    ESP_ERROR_CHECK(pcnt_unit_clear_count(pcnt_unit));
    ESP_ERROR_CHECK(pcnt_unit_start(pcnt_unit));
}

// 一个简单的读取计数值的函数
int32_t get_encoder_count() {
    int32_t count = 0;
    ESP_ERROR_CHECK(pcnt_unit_get_count(pcnt_unit, &count));
    return count;
}

现在，在你的主循环里调用get_encoder_count()，就能得到一个带符号的整数。正数表示正向旋转的净脉冲数，负数表示反向旋转的净脉冲数。这个值会随着你正反转动实时变化，非常灵敏。

4. 避坑指南与高级应用场景

代码跑起来固然开心，但实际项目中总会遇到些小麻烦。这里分享几个我踩过的坑和对应的解决办法，希望能帮你节省时间。

4.1 常见问题与调试技巧

1. 计数不准、跳变：十有八九是抖动问题。首先检查硬件，编码器电源是否干净，信号线是否过长。然后，务必启用并合理配置前面提到的glitch_filter。如果还不行，可以尝试增大滤波时间，比如调到2000或3000纳秒。另外，ESP32的PCNT模块输入信号有频率上限（具体看芯片手册，通常远高于机械编码器频率），一般不会是瓶颈。
2. 方向反了：这是最常遇到的情况。解决办法很简单：交换一下set_edge_action里INCREASE和DECREASE的位置。比如把通道A的DECREASE和INCREASE对调。或者，更物理一点，直接把编码器的A相和B相两根线对调一下接。
3. 计数速度慢或丢失脉冲：如果你的编码器是高速的（比如光电编码器，每秒上万转），要确保你的代码读取计数的频率足够高。PCNT硬件计数很快，但如果你用pcnt_unit_get_count函数读得太慢，可能会因为计数器溢出（即使有accum_count，也受限于int32_t的范围）或软件来不及处理而丢失信息。对于高速应用，建议使用中断。通过pcnt_unit_add_watch_point在计数器达到某个值时触发中断，在中断服务程序里快速读取并累积计数。
4. 上电初始位置不确定：编码器一上电，PCNT计数器从0开始。但编码器的机械位置是随机的，这可能导致你的“零位”不对。解决方法通常是在系统启动后，让设备运动到一个已知的机械限位或参考点（比如归零传感器），然后调用pcnt_unit_clear_count将计数器清零，以此位置作为软件零位。

4.2 超越旋转编码器：更多应用可能

掌握了PCNT双通道方向检测，你的思路可以打开。它本质上是一个双路相位关系解码器。任何能产生两路有相位差脉冲信号的场景，都可以考虑用它。

• 直线光栅尺：在数控机床或高精度测量中，光栅尺输出的就是正交信号。用PCNT解码，可以直接得到带方向的位移脉冲，精度极高。
• 双路速度传感器：比如在两个靠近的位置安装光电传感器检测传送带上的标记，通过两路信号的相位差可以判断传送带的运行方向，防止打滑误判。
• 手动旋钮与多功能编码器：很多现代旋钮不仅旋转，还能按下。你可以将按下作为一个独立按键，旋转部分用PCNT解码，轻松实现一个多功能输入设备，手感比普通电位器好太多，而且没有模拟量的漂移问题。
• 与MCPWM联动实现闭环控制：这是更进阶的玩法。ESP32的MCPWM模块可以输出精密的PWM控制电机，而PCNT可以实时读取同轴编码器的反馈。你可以在一个芯片内，用高速定时器中断或FreeRTOS任务，将PCNT读取的位置/速度反馈，与MCPWM的目标值进行比较，实现一个完整的位置环或速度环PID控制，这对于自制平衡车、机械臂关节等项目是核心技能。

配置PCNT双通道，一开始可能会被那几个EDGE_ACTION和LEVEL_ACTION绕晕，但一旦你亲手画一下正反旋转的波形图，对照着配置代码走一遍逻辑，就会有种豁然开朗的感觉。它体现了硬件设计的一种美感：用简单的逻辑门组合，高效地解决一个常见的复杂问题。下次你的项目需要检测旋转方向时，别再只用一路脉冲加软件判断了，试试ESP32的PCNT双通道方案，你会发现它的稳定性和便利性远超预期。