1. 项目概述一个极简主义的I2C总线扫描仪在嵌入式开发尤其是涉及传感器、执行器或各类外设模块的项目中I2C总线是最常用的通信协议之一。调试I2C设备时最基础也最让人头疼的问题之一就是确认设备地址是否正确、总线连接是否正常。市面上有现成的逻辑分析仪或I2C主机适配器但对于一个只想快速验证一下的极客或工程师来说它们要么太贵要么太笨重要么需要连接电脑不够“随手可用”。于是我动手做了一个“微型I2C扫描仪”。它的核心思想是极简和便携用一颗超低成本的8位单片机ATtiny44驱动一块小巧的0.96英寸OLED显示屏再通过软件模拟一个I2C主机端口去扫描总线。整个设备可以做得非常小巧甚至可以集成到你的开发板旁边随时插上SDA和SCL两根线就能在屏幕上直观地看到总线上所有设备的地址。这玩意儿不追求功能强大只追求在关键时刻能快速、可靠地告诉你“嘿你的传感器还活着地址是0x68。”这个项目的魅力在于它的“螺蛳壳里做道场”。ATtiny44资源极其有限仅4KB Flash256字节RAM既要驱动一个128x64像素的图形OLED又要实现I2C扫描逻辑还不能用硬件I2C因为ATtiny44没有且一个硬件I2C端口也不够同时驱动屏幕和扫描。这就需要我们在软件架构和算法上做一些精巧的设计比如如何在没有足够RAM做显存的情况下实时渲染扫描结果矩阵。接下来我会详细拆解这个项目的设计思路、硬件选型、软件实现以及那些只有亲手做过才会知道的“坑”。2. 核心硬件选型与电路设计解析2.1 主控芯片为什么是ATtiny44在8位AVR单片机家族里可选型号很多比如更常见的ATmega328PArduino Uno核心或ATtiny85。选择ATtiny44是基于以下几个核心考量引脚数量与I/O需求这个项目至少需要4个GPIO两个用于软件模拟I2C驱动OLEDSCL_A, SDA_A两个用于软件模拟I2C扫描总线SCL_B, SDA_B。ATtiny44拥有12个可用的I/O引脚14引脚封装扣除VCC和GND完全满足需求并且还有余量可以添加一个复位按钮或状态LED。而ATtiny85只有6个I/O会显得捉襟见肘。内存与性能的平衡ATtiny44拥有4KB的Flash和256字节的SRAM。256字节的RAM是关键瓶颈。一个128x64的单色位图缓冲区需要1024字节128 * 64 / 8这远远超出了它的能力。因此我们必须放弃使用帧缓冲区的传统方式采用实时计算像素点的“无缓存”渲染算法。ATtiny44的4KB Flash足以容纳这种算法和I2C驱动代码。它的运行速度最高20MHz也足以保证扫描和显示刷新率在人眼可接受的范围内。成本与封装ATtiny44价格低廉且提供SOIC、PDIP等易于手工焊接的封装。相比之下功能更强的ATmega系列芯片成本更高体积也更大不符合“微型”的定位。注意ATtiny44没有硬件I2C外设。这在本项目中反而成了一个优势因为我们需要两个独立的I2C主机端口一个固定地址用于屏幕一个可变地址用于扫描。用软件模拟Bit-banging可以更灵活地控制这两个端口的时序和状态互不干扰。2.2 显示模块0.96英寸OLED及其驱动0.96英寸的OLED显示屏通常指的是分辨率为128x64的模块驱动芯片多为SSD1306。选择它原因如下可视性与尺寸0.96英寸的尺寸在“足够显示信息”和“保持设备微型化”之间取得了完美平衡。128x64的分辨率足以显示一个8x8的地址矩阵以及一些文本信息。接口与功耗这类模块通常支持I2C和SPI两种接口。我们选择I2C接口因为它只需要两根数据线加上电源线比SPI更节省引脚。OLED是自发光器件在显示深色内容时功耗极低非常适合电池供电的便携设备。驱动兼容性SSD1306的驱动非常成熟有大量开源库。但为了极致压缩代码空间并适配我们的无缓存渲染算法我们不能直接使用通用的Adafruit_SSD1306或U8g2库它们通常需要帧缓冲区。我们需要为其编写一个高度定制化的、只包含最基本绘图命令如画点、画线的轻量级驱动。电路连接设计OLED模块通常有4个引脚VCC3.3V或5V、GND、SCL、SDA。ATtiny44的I/O口是5V容忍的但SSD1306芯片的工作电压通常是3.3V。因此必须在ATtiny44的SCL/SDA输出线与OLED的SCL/SDA输入线之间串联一个330Ω-1kΩ的电阻作为简单的限流/电平匹配。或者更稳妥的方法是使用一个双向电平转换器如TXB0104。VCC可以接3.3V或5V如果模块支持5V。扫描端口引出两个排针或测试钩分别标记为SDA_SCAN和SCL_SCAN。这两个端口需要连接上拉电阻通常4.7kΩ到VCC这是I2C总线正常工作的必要条件。可以在PCB上集成这两个电阻也可以依赖被扫描设备的总线上拉电阻但为了可靠性最好自己集成。电源整个系统可以由一枚CR2032纽扣电池3V或USB接口5V供电。如果使用3V供电需要确认ATtiny44和OLED都能在3V下正常工作ATtiny44最低工作电压为1.8VSSD1306通常最低2.8V。使用5V供电则更通用但需注意OLED模块的耐压。2.3 PCB设计与布局要点为了达到“微型”和“一体”的效果最佳方案是设计一块与0.96英寸OLED模块尺寸完全一致的PCB。OLED模块通过排针垂直插在这块PCB上就像盾板一样。尺寸匹配精确测量OLED模块的安装孔和排针位置在PCB上对应位置放置焊盘或通孔。确保OLED插上后稳固且高度合适。核心器件布局ATtiny44应放置在PCB背面与OLED显示面相反以节省正面空间。扫描端口SDA/SCL的排针和电源输入接口如电池座或Micro USB插座可以布置在PCB边缘。去耦电容必须在ATtiny44的VCC和GND引脚之间尽可能靠近芯片的位置放置一个0.1uF的陶瓷去耦电容。这是保证单片机稳定运行、防止电源噪声的关键绝不能省略。编程接口ATtiny44需要通过ISP如USBasp编程。需要在PCB上预留一个6针的ISP接口MOSI, MISO, SCK, RESET, VCC, GND。项目完成后这个接口可以空置不影响使用。3. 软件架构与核心算法实现3.1 双软件I2C主机驱动实现由于需要两个独立的I2C端口我们必须实现两个软件I2C主机。这里的关键是代码复用和时序精度。// 定义两个I2C端口使用的引脚 #define I2C_DISPLAY_PORT 0 #define I2C_SCAN_PORT 1 #define SDA_DISPLAY PB0 #define SCL_DISPLAY PB1 #define SDA_SCAN PA0 #define SCL_SCAN PA1 // 通用的I2C延时函数用于产生标准模式100kHz或快速模式400kHz的时序 void i2c_delay(void) { _delay_us(5); // 对应约100kHz根据实际CPU时钟调整 } // 针对特定端口的引脚操作宏 #define SDA_HIGH(port) if(portI2C_DISPLAY_PORT) DDRB ~(1SDA_DISPLAY); else DDRA ~(1SDA_SCAN) #define SDA_LOW(port) if(portI2C_DISPLAY_PORT) { DDRB | (1SDA_DISPLAY); PORTB ~(1SDA_DISPLAY); } else { DDRA | (1SDA_SCAN); PORTA ~(1SDA_SCAN); } // ... 类似定义SCL_HIGH, SCL_LOW, SDA_READ // 完整的软件I2C启动、发送字节、接收应答、停止等函数 // 这些函数需要接收一个port参数来区分操作哪个总线 uint8_t i2c_send_byte(uint8_t port, uint8_t data) { for(uint8_t i0; i8; i){ if(data 0x80) SDA_HIGH(port); else SDA_LOW(port); i2c_delay(); SCL_HIGH(port); i2c_delay(); SCL_LOW(port); i2c_delay(); data 1; } // 读取ACK SDA_HIGH(port); i2c_delay(); SCL_HIGH(port); i2c_delay(); uint8_t ack SDA_READ(port); SCL_LOW(port); return ack; // 返回0表示收到ACK }注意事项时序精度_delay_us()函数的精度依赖于CPU时钟频率和编译优化。务必使用#define F_CPU正确定义时钟频率如1000000UL表示1MHz并确保编译器优化级别如-Os不会过度优化这些延时循环。最好用示波器验证一下SCL频率是否符合预期。端口操作速度软件模拟I2C会占用大量CPU时间。在扫描总线时显示屏的刷新可能会稍有延迟这是可以接受的。如果扫描速度太慢可以尝试提高CPU时钟频率ATtiny44最高可运行于20MHz或者优化延时函数。3.2 无帧缓冲区的OLED实时渲染算法这是本项目最精妙的部分。我们无法在256字节的RAM里存放128x64的位图但我们可以利用OLED的“页寻址模式”Page Addressing Mode和“实时计算”来绘制内容。SSD1306将屏幕在垂直方向分为8个“页”Page每页8行像素对应一个字节的数据。向显存写入数据时可以按页、按列的顺序进行。渲染地址矩阵的思路 我们想在屏幕上画一个8行 x 8列的矩阵每个格子代表一个可能的I2C地址低4位。例如左上角格子代表地址0x00右下角代表地址0xEE注意由于地址是7位左移一位所以实际有效的地址都是偶数即低4位只能是0,2,4,6,8,A,C,E。数据结构我们只需要一个8字节的数组uint8_t address_map[8]。每个字节的8个位bit对应一行中的8个地址即高4位相同低4位不同的8种可能。如果某个地址有设备就将对应的位置1。例如address_map[0] 0x81表示在低4位为0x0?的这一行中高4位为0x0和0x7的地址有设备。渲染函数我们不需要知道整个屏幕的图像只需要知道当前正在绘制的这个“页”8行像素里哪些点需要点亮。外层循环遍历8列对应地址的高4位0-F但只取0-7因为矩阵是8x8这里需要澄清实际上I2C地址是7位范围0x08-0x77。我们将其左移一位变成8位地址后范围是0x10-0xEE。高4位范围是1-E低4位是0,2,4,6,8,A,C,E。为了在8x8矩阵中显示我们需要做一个映射。一种常见的直观映射是用行号表示地址的[3:1]位因为最低位恒为0用列号表示地址的[6:4]位。这样8行8列刚好覆盖0x08-0x77的扫描范围。内层循环遍历当前页的8行像素实际上一次渲染一页即8行像素的高度。核心计算对于当前页的每一行像素记为page_row0-7我们需要计算这一行像素所对应的所有地址格子中有哪些格子应该被点亮。这需要根据address_map和当前绘制的位置进行位运算。具体绘制每个地址格子可能占据多个像素比如16x16像素。计算好当前页的这一行像素所对应的所有像素点后合并成一个字节通过I2C一次性发送给OLED控制器写入当前列的对应位置。void draw_address_matrix(void) { // 假设我们已经通过扫描填充好了 address_map[8] // 设置OLED进入页寻址模式并定位到绘图起始位置 oled_set_page_address(0, 7); oled_set_column_address(0, 127); // 每个地址格子假设宽16像素高8像素正好一页 for(uint8_t col0; col8; col) { // 遍历8列 for(uint8_t page0; page8; page) { // 遍历8页对应整个屏幕高度 uint8_t page_data[16] {0}; // 临时存储这一页中16列像素的数据 // 对于这一页中的每一行像素page*8 row_in_page // 我们需要找出哪些地址格子落在这行像素上 // 这涉及到将屏幕像素坐标映射回 address_map 的位 // ... 这里是复杂的映射和位运算代码 ... // 计算完成后将 page_data 的16个字节通过I2C发送出去 for(uint8_t i0; i16; i) { i2c_send_byte(I2C_DISPLAY_PORT, page_data[i]); } } } }实操心得这个映射和实时计算算法是调试中最耗时的部分。建议先在PC上用Python或C语言写一个模拟程序将预期的address_map打印成文本形式的矩阵或者生成一个PNG图片与OLED实际显示进行对比调试。在单片机上调屏幕显示非常低效。3.3 I2C设备扫描逻辑I2C扫描的原理很简单遍历所有可能的7位地址0x08到0x770x00-0x07和0x78-0x7F是保留地址向每个地址发送一个START信号然后发送地址字节写操作即地址左移一位最低位为0看是否收到ACK应答。void scan_i2c_bus(void) { // 清空地址地图 memset(address_map, 0, sizeof(address_map)); for(uint8_t addr 0x08; addr 0x77; addr) { // 1. 发送START条件 i2c_start(I2C_SCAN_PORT); // 2. 发送地址字节写模式 uint8_t write_addr addr 1; if(i2c_send_byte(I2C_SCAN_PORT, write_addr) 0) { // 收到ACK说明该地址有设备 // 将地址映射到我们的 address_map 位中 uint8_t row (addr 0x0E) 1; // 取地址的[3:1]位作为行索引因为最低位恒为0所以右移1位 uint8_t col (addr 4) 0x07; // 取地址的[6:4]位作为列索引 address_map[row] | (1 col); } // 3. 发送STOP条件结束本次探测 i2c_stop(I2C_SCAN_PORT); _delay_ms(1); // 短暂延时避免总线过于拥挤 } }注意事项保留地址务必避开0x00-0x07和0x78-0x7F的I2C保留地址。扫描这些地址可能导致不可预知的行为。总线锁死如果总线上有设备在通信中发生错误如未及时释放SDA线可能导致总线锁死。一个健壮的扫描程序应该在每次扫描前尝试发送几个STOP条件来复位总线状态。可以在i2c_start函数前先调用几次i2c_stop。扫描速度遍历128个地址加上延时一次完整扫描可能需要几百毫秒。这对于一个调试工具来说是可以接受的。你可以将其设置为上电扫描一次然后按按钮重新扫描。4. 系统软件流程与优化策略4.1 主程序循环设计主程序的结构需要平衡扫描、显示和用户交互。int main(void) { // 初始化 clock_init(); // 设置系统时钟如内部8MHz io_init(); // 配置I/O引脚方向 oled_init(); // 初始化OLED设置为页寻址模式等 oled_clear(); // 清屏 draw_static_elements(); // 绘制标题、边框等静态内容 // 首次扫描并显示 scan_i2c_bus(); draw_address_matrix(); while(1) { // 1. 检查按键如果接了按键 if(button_pressed()) { _delay_ms(50); // 消抖 if(button_pressed()) { // 重新扫描并更新显示 scan_i2c_bus(); draw_address_matrix(); while(button_pressed()); // 等待按键释放 } } // 2. 可以加入低功耗睡眠模式如果使用电池供电 // 在没有按键操作时让MCU进入空闲(IDLE)或掉电(Power-down)模式 // 通过外部中断按键唤醒 // set_sleep_mode(SLEEP_MODE_PWR_DOWN); // sleep_enable(); // sleep_cpu(); // sleep_disable(); // 3. 简单的看门狗喂狗如果使能了看门狗 // wdt_reset(); } }4.2 内存与代码空间优化技巧在ATtiny44上编程必须精打细算每一字节的RAM和Flash。使用const和PROGMEM所有不变的字符串、字体点阵数据、静态图像数据必须存放在Flash中使用PROGMEM关键字并通过pgm_read_byte()函数读取。绝对不要放在RAM里。const uint8_t font_5x7[] PROGMEM { ... }; uint8_t char_data pgm_read_byte(font_5x7[char_index * 5 col]);全局变量最小化除了绝对必要的状态变量如address_map尽量使用局部变量。编译器通常会将局部变量优化到寄存器中。选择合适的数据类型在AVR上int是16位处理起来比8位的uint8_t慢。对于循环计数器、引脚编号等小数值坚持使用uint8_t。函数复用与内联将频繁使用的小函数如i2c_delay、引脚操作宏定义为static inline可以节省函数调用的开销。但注意过度内联会增加代码体积需要权衡。编译器优化务必使用-Os优化选项优化尺寸。有时-O2优化速度可能会产生更小的代码需要实测。4.3 显示效果的增强基础的地址矩阵可能有些枯燥。我们可以增加一些有用的信息来提升用户体验地址标注在矩阵的左侧和上方用极小的字体如3x5像素标注出行和列对应的十六进制数高半字节和低半字节。这需要额外的字体数据和绘图逻辑。选中高亮如果连接了多个设备可以通过一个旋转编码器或两个按键来“选择”矩阵中的一个地址。被选中的地址格子可以闪烁或反色显示并在屏幕角落显示该地址的完整十六进制值如0x68。扫描动画在扫描过程中可以在屏幕上显示一个进度条或者让当前正在探测的地址格子闪烁让用户知道设备正在工作。这些增强功能会消耗更多的Flash空间需要根据编译后的大小决定是否加入。一个基本原则是核心的扫描和矩阵显示功能必须保证增强功能是锦上添花。5. 制作、调试与问题排查实录5.1 焊接与组装注意事项ATtiny44焊接SOIC封装相对容易焊接。使用助焊剂和细头烙铁。检查所有引脚防止桥接和虚焊。焊接完成后用万用表蜂鸣档检查VCC和GND是否短路以及每个I/O引脚与相邻引脚是否短路。OLED连接确保OLED排针与PCB焊盘对齐并垂直。可以先焊接排针到PCB上再将OLED插上。或者使用排母female header焊在PCB上这样OLED可以随时拔插但会稍微增加一点厚度。上拉电阻扫描端口SDA_SCAN, SCL_SCAN的4.7kΩ上拉电阻必须焊接。即使你打算使用外部总线的上拉电阻也建议保留作为默认配置。电源滤波0.1uF的去耦电容必须尽可能靠近ATtiny44的VCC和GND引脚。这是稳定工作的基石。5.2 软件调试流程与常见问题问题1OLED完全不亮或显示乱码。检查电源用万用表测量OLED模块VCC和GND之间的电压确认是3.3V还是5V是否符合模块要求。检查I2C地址常见的0.96寸OLED的I2C地址可能是0x3C或0x3D。你需要查阅模块资料或尝试扫描。我们的扫描仪自己还没工作可以用另一个Arduino运行I2C扫描程序来确认地址。检查时序用逻辑分析仪或示波器抓取SCL和SDA的波形。确认START条件SDA在SCL高时由高变低、数据位变化SDA在SCL低时变化高时稳定、ACK位以及STOP条件SDA在SCL高时由低变高是否符合I2C规范。软件延时i2c_delay的数值可能需要根据你的CPU频率微调。检查初始化序列SSD1306需要一系列初始化命令才能进入图形显示模式。确保你的oled_init()函数正确发送了所有必要的命令如设置对比度、显示开、页寻址模式等。可以参考成熟的驱动库如ssd1306.h中的初始化代码。问题2I2C扫描不到任何设备但设备用其他工具测试是好的。检查接线确认SDA和SCL线没有接反接触良好。检查上拉电阻扫描端口必须有上拉电阻4.7kΩ。如果没有总线无法拉高所有通信都会失败。检查总线电压如果被扫描设备是3.3V电平而你的扫描仪输出是5V可能会造成通信失败或损坏设备。建议在扫描端口也加入电平转换电路或者确保扫描仪工作在3.3V。扫描逻辑错误在i2c_send_byte函数中发送完8位数据后释放SDA线设置为输入上拉并读取ACK的步骤是否正确ACK信号是设备在第九个时钟周期将SDA拉低。你的程序需要在这个周期将SDA引脚配置为输入并读取其电平。设备忙有些设备在完成一次操作后需要一定时间才能响应下一次寻址。在发送STOP条件后增加一个几毫秒的_delay_ms()。问题3显示矩阵错位或显示不全。映射算法错误这是最可能的原因。仔细检查你的draw_address_matrix函数中的坐标映射逻辑。用已知的地址如连接一个0x68的RTC模块进行测试看它是否出现在矩阵的正确位置高4位0x6低4位0x8左移一位后为0xD0。低4位0x8对应行索引需要根据你的映射公式计算。在PC上编写模拟器进行可视化调试是最有效的方法。OLED设置错误确认OLED的起始列和起始页设置正确。oled_set_page_address(0, 7)和oled_set_column_address(0, 127)应该设置整个屏幕区域。有些驱动芯片需要你精确设置绘图窗口。问题4程序运行不稳定偶尔复位或无响应。电源问题电池电量不足或电源纹波过大。用示波器观察VCC电压在MCU启动或扫描时是否有大的跌落。确保去耦电容焊接良好。堆栈溢出AVR的堆栈空间很小。避免在中断服务程序或递归函数中使用大数组。检查你的函数调用深度。看门狗复位如果你使能了看门狗WDT必须在主循环中定期喂狗wdt_reset()否则MCU会不断复位。5.3 功能扩展思路这个微型扫描仪是一个很好的基础平台可以在此基础上扩展更多实用功能I2C信号发生器/调试器增加几个按键和菜单可以发送特定的I2C数据包如读取某个寄存器的值用于更深入的设备调试。总线电压监测利用ATtiny44的ADC功能测量SDA/SCL线的实际电压并在屏幕上显示帮助诊断电平不匹配问题。多协议支持同样的硬件通过修改软件可以变成SPI总线扫描仪或1-Wire总线扫描仪。外壳设计用3D打印一个精致的外壳将PCB、电池和按钮包裹起来形成一个真正的便携式工具。制作这样一个微型工具的过程不仅让你获得了一个实用的调试利器更重要的是让你深入理解了I2C协议的精髓、单片机资源受限下的编程哲学以及软硬件协同调试的方法。当屏幕上第一次正确显示出你连接的I2C设备地址时那种成就感是无可替代的。希望这份详细的拆解能帮助你成功复现或启发你做出属于自己的嵌入式小工具。
