1. 用代码开发工具把 PCF8591 接进 ESP32:一条 I2C 采集链路的最小闭环
代码开发工具这个词听起来泛,落到具体场景就是一块 ESP32、一块 PCF8591 模块和一根 USB 线。Arduino IDE 是这里要用的代码开发工具,Wire 库把 I2C 的起止时序封在背后,你只要把地址、控制字节和读字节顺序写对,四路模拟量就能从串口出来。反直觉的是,接上 SDA/SCL 并不等于能读对:地址写成数据手册上的 0x90、读的时候把第一个字节当成有效值、控制字节固定不变,这三处任意一处没对齐,串口就可能只吐 0 和 255。这篇面向手上有模块、想先把一条采集链路跑通的人,也写给已经跑通但读数偶尔跳的熟手。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具准备:Arduino IDE、Wire 库与 PCF8591 接线
先把工具和硬件摆正。Arduino IDE 负责编译下载,Wire 负责 I2C 事务,PCF8591 负责把模拟量转成 8 位数字量。三者之间靠两个东西衔接:从机地址和控制字节。地址错了,后面所有代码都白写;控制字节错了,四个通道会读成同一个数。
2.1 PCF8591 的 I2C 地址:为什么代码里写 0x90 >> 1
I2C 从机地址有 7 位和 8 位两种写法。PCF8591 数据手册常给 8 位写地址 0x90,其中最低位是读写位,真正参与寻址的是高 7 位 0x48。Arduino 的 Wire 库要 7 位地址,所以材料里写 #define PCF8591 (0x90 >> 1)。右移一位等于把读写位丢掉,得到 0x48。
c复制#define PCF8591 (0x90 >> 1) // 0x90 右移一位 = 0x48,Wire 要的是 7 位地址
这个宏不是可读性装饰,是地址位宽的分界线。直接把 0x90 填进 Wire.beginTransmission(),Wire 会把它当 7 位地址,总线上找的是另一个从机,PCF8591 不应答,Wire.read() 读回来的通常是 0 或 255。下面这张表把两种写法摆在一起,调试时先对照它。
| 写法 | 值 | 填进 Wire 的结果 |
|---|---|---|
| 数据手册 8 位写地址 | 0x90 | 被当成 7 位地址,从机不应答 |
| 右移后的 7 位地址 | 0x48 | 正常寻址到 PCF8591 |
控制字节是第二个容易随手改坏的地方。材料里固定发 0x04,它的低两位是通道选择,0x04 的低两位为 00,对应通道 0。想读 AIN1,就把低两位改成 01,写成 0x04 | 0x01。其余位先保持材料里的写法,不要凭感觉改。
c复制Wire.write(0x04); // 低两位 00,通道 0
Wire.write(0x04 | 0x01); // 低两位 01,通道 1
| 低两位 | 通道 | 写法 |
|---|---|---|
| 00 | AIN0 | 0x04 |
| 01 | AIN1 | 0x04 | 0x01 |
| 10 | AIN2 | 0x04 | 0x02 |
| 11 | AIN3 | 0x04 | 0x03 |
2.2 接线:SDA、SCL、供电和模拟输入
接线先按模块标称来,不要拿 ESP32 的 3.3V 去赌所有模块都兼容。下面是一张最小接线表,具体 GPIO 以你手上板子的默认 I2C 脚为准;Wire.begin() 不传参数时走默认那对脚,常见是 GPIO21 作 SDA、GPIO22 作 SCL。
| PCF8591 模块 | ESP32 | 说明 |
|---|---|---|
| VCC | 按模块标称供电 | 先确认模块电平与 ESP32 匹配 |
| GND | GND | 必须共地 |
| SDA | 默认 SDA | I2C 数据线 |
| SCL | 默认 SCL | I2C 时钟线 |
| AIN0 | 待测模拟信号 | 本例先读通道 0 |
| AOUT | 不接 | 本例只做采集 |
I2C 是开漏总线,SDA/SCL 要有上拉。PCF8591 模块通常自带上拉,裸芯片则要按总线常见做法外接。调试时如果读数偶尔跳、手碰杜邦线数值就变,先换短线、确认共地、确认模块上拉有没有生效,再回头怀疑代码。模拟输入 AIN0 接待测信号,信号源地跟模块地要共在一起,否则读出来的数会飘。
2.3 Arduino IDE 里要做的四件事
第一步装 Arduino IDE,第二步装 ESP32 板支持,第三步选对板子和端口,第四步打开串口监视器并把波特率设成 9600。Wire 库是 IDE 内置的,不用额外装。板支持装完后如果编译能过、下载报错,先检查板子型号和端口有没有选对,不要一上来改代码。
c复制void setup()
{
Wire.begin(); // 不传参数时走默认 SDA/SCL
Serial.begin(9600); // 串口监视器也要 9600
}
Wire.begin() 放在 setup() 里只执行一次,负责把 I2C 外设初始化好;Serial.begin(9600) 决定串口输出的波特率,这里的 9600 要和监视器右下角的选择一致。两个初始化都不带返回值,写完就可以进 loop()。
提示:板支持安装和端口选择按官方文档走,不要在不明来源的压缩包里找“一键包”,版本对不上时编译错误会很难查。
3. 代码开发工具里的驱动实现:控制字节、读时序与首字节
这一章把材料里的代码拆成四段看。整段逻辑不复杂,关键是顺序:先发起一次转换,再请求字节,读的时候第一个字节要丢掉,最后才打印。顺序错一步,读数就会对不上。
3.1 一份能直接烧进去的完整代码
c复制#include "Wire.h"
#define PCF8591 (0x90 >> 1) // 7 位地址 0x48
byte adcvalue0, adcvalue1, adcvalue2, adcvalue3;
void setup()
{
Wire.begin(); // 初始化 I2C
Serial.begin(9600); // 串口波特率 9600
}
void loop()
{
Wire.beginTransmission(PCF8591);
Wire.write(0x04); // 控制字节:低两位 00,通道 0
Wire.endTransmission();
Wire.requestFrom(PCF8591, 5); // 请求 5 个字节
adcvalue0 = Wire.read(); // 第一次读到的是上一次转换结果
adcvalue0 = Wire.read(); // 覆盖:这次才是当前通道
adcvalue1 = Wire.read();
adcvalue2 = Wire.read();
adcvalue3 = Wire.read();
Serial.print(adcvalue0);
Serial.print(" ,");
Serial.print(adcvalue1);
Serial.print(" ,");
Serial.print(adcvalue2);
Serial.print(" ,");
Serial.print(adcvalue3);
Serial.println();
delay(1000);
}
setup() 只做两件初始化的事,loop() 是一个固定节奏的采集循环。整段没有复杂分支,所有坑都藏在地址、控制字节和读字节顺序里。下面按执行顺序拆开讲。
3.2 发起转换:beginTransmission、write、endTransmission 三件事
c复制Wire.beginTransmission(PCF8591);
Wire.write(0x04);
Wire.endTransmission();
beginTransmission(PCF8591) 把 7 位地址 0x48 放进发送队列,告诉总线“接下来要跟这个从机说话”。Wire.write(0x04) 往队列里放一个控制字节,决定本次访问哪个通道。Wire.endTransmission() 才真正把地址加数据发到总线上。三个函数要连着写,少一个都不会产生一次完整事务。
参数上只有两个要盯:地址必须是 0x90 >> 1 的结果,控制字节低两位必须跟你要读的通道一致。常见做法是看 endTransmission() 的返回值,返回 0 表示从机应答了;返回非 0 先查接线、地址和上拉,不要继续往下读。材料里没有在这一步加延时,也不需要加,PCF8591 的转换在读到数据时完成。
3.3 读五个字节:requestFrom 的 quantity 与首字节丢弃
c复制Wire.requestFrom(PCF8591, 5);
adcvalue0 = Wire.read();
adcvalue0 = Wire.read();
adcvalue1 = Wire.read();
adcvalue2 = Wire.read();
adcvalue3 = Wire.read();
requestFrom(PCF8591, 5) 里的 5 是请求字节数。为什么是 5 而不是 4:PCF8591 读操作返回的第一个字节是上一次转换的结果,多请求一个用来垫掉它。代码里 adcvalue0 = Wire.read() 连着写两次,第一次的值立刻被第二次覆盖,这不是笔误,是故意丢首字节。第一次丢掉之后,第二次读到的才是当前通道的有效值,后面三次分别给 adcvalue1 到 adcvalue3。
按这段代码的读法,第二个字节给通道 0,后面三个给通道 1 到通道 3。如果你只改控制字节低两位、不加轮询,读到的仍然是同一个通道。Wire.read() 每调用一次消耗一个缓冲字节,读的次数要和 requestFrom 的请求数对上,多读少读都会让下一次事务拿到错位的数据。
3.4 串口输出与 1 秒节奏
c复制Serial.print(adcvalue0);
Serial.print(" ,");
Serial.print(adcvalue1);
Serial.print(" ,");
Serial.print(adcvalue2);
Serial.print(" ,");
Serial.print(adcvalue3);
Serial.println();
delay(1000);
Serial.print() 输出数值,中间用逗号和空格分隔,Serial.println() 换行,这样监视器里一行就是一次四通道采样。delay(1000) 让循环大约每秒跑一次,读数看起来是一秒跳一格。想加快就减小这个数,但先确认读到的数稳定,不要一上来把间隔压到很小,否则串口刷屏反而看不清哪一路在跳。
注意:串口监视器波特率必须和
Serial.begin(9600)一致,不一致时看到的不是数值,是乱码。
4. 避坑与排查:地址、首字节、通道和串口四类翻车
这一章按现象、原因、解决三段写,都是这条采集链路上先查的几处。顺序上先查地址,再查通道,再查首字节,最后查串口和硬件,能少走很多弯路。
4.1 串口全是 0 或 255:先查地址有没有右移
现象:烧录后串口每行都是 0 ,0 ,0 ,0 或者 255 ,255 ,255 ,255,换通道也没变化。
原因:#define PCF8591 (0x90 >> 1) 被改成了 0x90,Wire 把 8 位写地址当成 7 位地址用,总线上找不到 0x48 这个从机,读操作没有有效数据,缓冲里不是 0 就是 255。
解决:把宏改回 (0x90 >> 1),确认 beginTransmission() 里填的是 PCF8591 而不是 0x90。如果改回后还是全 0,再用现成的 I2C 扫描示例确认总线上能看到 0x48,看不到就查 SDA/SCL 接线和共地,不要继续改代码。
c复制// 错误:把 8 位写地址直接填进去
#define PCF8591 0x90
// 正确:右移一位得到 7 位地址
#define PCF8591 (0x90 >> 1)
4.2 四个通道一个样:控制字节没跟着通道走
现象:AIN0 接信号、AIN1 接另一个电压,串口四列数字几乎一样,换通道也没有区别。
原因:控制字节一直写 0x04,低两位固定 00,每次事务都在选通道 0。代码里没有根据目标通道改低两位,读回来的自然是同一路。
解决:把控制字节改成 0x04 | (ch & 0x03),ch 取 0 到 3。每次读之前重新发一次控制字节,不要只在 setup() 里发一次。改完后先单通道验证,再轮询四路,避免一次改太多变量。
c复制Wire.write(0x04); // 一直读通道 0
Wire.write(0x04 | ch); // 按 ch 改低两位
4.3 第一个数对不上:首字节是上一次转换结果
现象:每次上电第一行数据的第一个数明显偏大或偏小,后面几行又恢复正常;或者把第一次 Wire.read() 删掉后,四个数整体错位。
原因:PCF8591 读操作返回的第一个字节是上一次转换结果,材料里连续两次给 adcvalue0 赋值,第一次就是用来丢这个旧值的。删掉第一次读,旧值会被当成当前通道,后面的字节也全部前移一位。
解决:保留两次读,第一次不参与打印;或者在封装函数里明确写一行丢弃。判断是否丢对,看第二个字节是否跟着 AIN0 的电压变化,变化正常就说明首字节已经垫掉。
4.4 串口乱码、数据一秒一跳:波特率和 delay
现象:串口监视器里出现不可读字符;或者数据大约一秒才更新一次,看起来像程序卡住。
原因:前者的 Serial.begin(9600) 和监视器波特率不一致;后者的 delay(1000) 是阻塞延时,循环里没有别的任务,读数自然一秒一格。
解决:把监视器波特率调到 9600,和代码一致。采样节奏先保持 1 秒,确认四路数值稳定后再减小 delay;如果既要快又要打印,先把打印间隔和采样间隔分开,不要直接把 delay(1000) 删掉。
4.5 读数偶尔跳变:上拉、共地和线长
现象:数值大部分时间正常,偶尔蹦到 0 或 255,手碰杜邦线时跳得更明显。
原因:I2C 是开漏总线,SDA/SCL 依赖上拉;模块上拉没生效、杜邦线接触不良、信号源和模块没有共地,都会让某一次事务读回无效值。
解决:先换短线,确认模块 VCC/GND 与 ESP32 共地,确认模块自带上拉;裸芯片按总线常见做法外接上拉。硬件排除完再回头看代码,不要一出现跳变就加滤波,滤波会把接线问题盖住。
5. 把采集封装成 readChannel:通道轮询与电压换算的落地习惯
四路都读通之后,下一步是把重复代码收成一个函数。下面这个封装只做最小整理:地址、控制字节、请求字节数都沿用前面的写法,把通道作为参数传进去。
c复制byte readChannel(byte ch)
{
Wire.beginTransmission(PCF8591);
Wire.write(0x04 | (ch & 0x03)); // 低两位换通道
Wire.endTransmission();
Wire.requestFrom(PCF8591, 5);
Wire.read(); // 丢掉上一次转换结果
byte value = Wire.read(); // 当前通道的 8 位结果
Wire.read();
Wire.read();
Wire.read();
return value;
}
ch 只取 0 到 3,ch & 0x03 防止传入越界值把控制字节的高位弄乱。返回值是 0 到 255 的 8 位原始码,不是电压。要把原始码换成电压,用下面这个换算,vref 按你模块实际参考电压传进去,常见是 3.3V 或 5V,不要写死一个自己没确认过的数。
c复制float toVoltage(byte raw, float vref)
{
return raw * vref / 255.0;
}
轮询时按 readChannel(0) 到 readChannel(3) 依次调用,每次调用内部都会重发控制字节,通道才会真正切换。打印前先做一次单通道验证:AIN0 接已知电压,看 toVoltage() 的结果是否跟万用表接近;接近了再轮询,不接近就回到第 4 章查地址和首字节。
从那以后我每次上电前都先确认三件事:地址是 0x48 不是 0x90,控制字节低两位跟着通道走,读五个字节时第一个丢掉。这三步做完再谈校准和滤波,能少很多后悔药。希望帮到你。
