ad 电位器库

关于读取电位器（可调电阻）模拟信号的“库”，在嵌入式开发（尤其是 Arduino 平台）中，通常不需要专门为电位器安装额外的库。Arduino 的核心功能已经提供了读取模拟引脚电压的函数，这正是读取电位器值最常用的方法。

以下是详细说明和操作指南：

? 核心方法：使用 `analogRead()` 函数

硬件连接：
- 将电位器的两端引脚分别连接到开发板的 VCC (如 5V 或 3.3V) 和 GND。
- 将电位器的中间引脚（滑动端/游标）连接到开发板的一个 模拟输入引脚 (例如 Arduino Uno 上的 A0, A1, ..., A5)。

代码：

void setup() {
    Serial.begin(9600);       // 初始化串口通信，用于输出调试信息
}

void loop() {
    int sensorValue = analogRead(A0);   // 读取连接在 A0 引脚的电位器值
    Serial.println(sensorValue);        // 将读取到的值（0-1023）打印到串口监视器
    delay(100);                         // 短暂延迟，降低输出频率
}

? 关键点

analogRead(pin)：这是 Arduino 内置的核心函数。
- 参数 pin 指定要读取的模拟引脚（例如 A0）。
- 返回值 是一个 0 到 1023 之间的整数。这个值代表引脚上的电压相对于参考电压（默认通常是 VCC）的比例。
  - 0 对应 0V (GND)。
  - 1023 对应 VCC (如 5V 或 3.3V)。
- 电位器旋转时，中间引脚的电压在 0V 到 VCC 之间变化，因此 analogRead() 返回的值也会在 0 到 1023 之间相应变化。
无需额外库： 这个函数包含在 Arduino 核心库中，无需单独下载或安装任何库。你只需要 #include <Arduino.h>（在标准的 Arduino IDE sketch 中通常会自动包含）。

? 进阶处理 / 可能需要库的场景

虽然基本读取不需要库，但在某些需求下，可能需要用到辅助库来处理读取到的原始值：

滤波：
- 需求： 电位器输出可能有抖动或噪声，导致 analogRead() 返回值在小范围内跳动。
- 库解决方案：
  - ResponsiveAnalogRead: 这是一个非常流行的库，旨在平滑模拟输入（如电位器）的噪声和抖动。它提供了一个简单易用的接口，替代 analogRead。
    - GitHub: https://github.com/dxinteractive/ResponsiveAnalogRead
  - Bounce2: 虽然主要用于数字输入消抖，但其作者也提供了 Bounce2.h 的一个扩展版本（或类似原理）可用于简单的模拟输入滤波。
  - MovingAverage / Average: 你可以自己实现一个简单的移动平均滤波器，或者使用像 MovingAverage 或 Average 这样的库来计算读取值的平均值。
    - Library Manager 搜索： MovingAverage 或 Average。
多路复用器：
- 需求： 如果你需要读取大量电位器（超过开发板上的模拟输入引脚数量），通常会使用模拟多路复用器芯片（如 CD4051, 74HC4067）。
- 库解决方案：
  - Multiplexer: 有专门用于驱动常见多路复用器芯片的库（如 CD74HC4067）。你需要根据使用的具体芯片查找对应库。
  - 手动控制： 也可以不使用库，直接通过数字引脚控制多路复用器的选择引脚（S0, S1, S2, S3），然后读取其公共输出引脚。
映射数值范围：
- 需求： 将 0-1023 的范围映射到你实际需要的范围（例如 0-255 用于 PWM，0-100 表示百分比，或特定的角度 0-270）。
- 内置函数：
  - 使用 Arduino 内置的 map(value, fromLow, fromHigh, toLow, toHigh) 函数。无需额外库。
  - 示例： int pwmValue = map(sensorValue, 0, 1023, 0, 255); // 将电位器值映射到 PWM 范围
旋转编码器：
- ⚠️ 注意： 虽然有时被混淆，但旋转编码器 (Rotary Encoder) 与电位器 (Potentiometer) 是不同的器件。编码器通常输出数字脉冲（增量式）或绝对位置码（绝对式）。
- 库解决方案： 如果你实际使用的是旋转编码器，则需要专门的解码库，如：
  - Encoder (https://www.pjrc.com/teensy/td_libs_Encoder.html) - 非常高效，使用中断。
  - RotaryEncoder (https://github.com/mathertel/RotaryEncoder) - 另一种流行选择。
  - ClickEncoder - 常与按钮支持一起使用。