Pixy2机器视觉模块实战：从通信协议到嵌入式视觉项目部署-育师

简介：pixy2-master.zip 是面向 Arduino 开发者与机器视觉入门者的 Pixy2 视觉模块完整项目资源包，围绕物体识别、颜色签名与形状追踪等核心能力，帮助读者把视觉传感器快速集成到机器人、自动化分拣等项目中。压缩包共 490 个文件，约 81.26MB，以 h 与 cpp 源码、m 与 c 实现文件为主，辅以 ino 示例程序、makefile 与 ld 构建脚本、png 与 art 素材、pdf 文档及 hex 固件等，覆盖从底层驱动到上层应用的完整链路。目前已有 904 人学习下载。资源内含颜色签名设置、串口通信、LCD 实时显示等示例代码与文档，读者可据此理解 Pixy2 与 Arduino 的 SPI/I2C 交互方式，并参考机器人足球追踪、仓库货物识别等场景进行二次开发，适合希望系统掌握机器视觉集成思路的爱好者与工程人员。

1. 拆开 pixy2-master.zip：一块能跑视觉的嵌入式模块到底能解决什么

如果你正在做一块需要“看得见”的小型设备，比如巡线小车、分拣装置、云台追踪或者互动装置，大概率会遇到同一个问题：主控算力不够，跑不动 OpenCV，更别提深度学习模型。这时候 pixy2-master.zip 就是一个值得认真拆一遍的资源。它对应的是 Pixy2 机器视觉模块的固件、上位机工具和通信协议参考实现，核心价值在于把颜色识别、线段追踪、条形码读取这些视觉任务从主控卸载到一块独立模块上，主控只需要通过串口或 I2C 拿结果。适合谁？做嵌入式视觉原型的工程师、带学生做机器视觉入门项目的导师、以及想给机器人加“眼睛”但不想碰 Linux 和 GPU 的开发者。它不解决高精度识别，但解决“快速让设备看见并做出反应”这件事。

2. 从 zip 到能跑：pixy2 的通信链路与最小验证

拿到 pixy2-master.zip 之后，很多人第一反应是找可执行文件，结果发现里面主要是源码、协议文档和示例。这个资源不是“双击即用”的安装包，而是一套让你理解模块如何被驱动、如何被二次开发的参考实现。要让它跑起来，得先理清三条链路：模块与主控的物理连接、主控侧的协议解析、以及上位机配置工具的使用。

2.1 硬件连接与供电：别小看那根排线

Pixy2 模块通常提供两种接口：I2C 和 UART 串口。I2C 适合与 Arduino、树莓派这类主控连接，占用引脚少，但速率受限；UART 适合需要更高帧率或更长距离的场景。供电方面，模块标称 5V，但实际对电源纹波比较敏感。我一般会在模块 VCC 和 GND 之间并一个 100μF 电解电容加一个 0.1μF 陶瓷电容，尤其是当主控和电机共用电源时，这一步能省掉很多“玄学丢包”。

接线顺序建议先只接电源和地，用万用表确认模块上的 LED 能正常亮起或闪烁，再接数据线。如果一上来就把 I2C 的 SDA/SCL 接反，模块不会烧，但会一直无响应，容易误判为固件问题。

2.2 协议解析：从原始字节到可用坐标

Pixy2 的通信协议是二进制帧格式，不是 ASCII 字符串。以颜色识别为例，模块返回的每个“块”包含签名编号、位置、宽高和角度。下面这段 Python 代码演示了如何通过串口读取并解析一帧数据，适用于主控是树莓派或 PC 的场景。

import serial import struct # 打开串口，Pixy2 默认波特率 115200 ser = serial.Serial('/dev/ttyUSB0', 115200, timeout=1) def parse_pixy_block(data): """ 解析 Pixy2 颜色识别块 帧结构参考：0xAA 0x55 后跟块数据 每个块 14 字节：签名(2) + X(2) + Y(2) + 宽(2) + 高(2) + 角度(2) + 保留(2) """ blocks = [] idx = 0 while idx < len(data) - 1: # 寻找帧头 if data[idx] == 0xAA and data[idx+1] == 0x55: idx += 2 # 读取块数量（简化处理，实际协议有校验和） if idx + 1 >= len(data): break count = data[idx] idx += 1 for _ in range(count): if idx + 14 > len(data): break sig, x, y, w, h, angle, _ = struct.unpack('<HHHHHHH', data[idx:idx+14]) blocks.append({ 'signature': sig, 'x': x, 'y': y, 'width': w, 'height': h, 'angle': angle }) idx += 14 else: idx += 1 return blocks # 主循环：读取并打印 while True: raw = ser.read(64) # 一次读 64 字节，实际帧长可能更短 if raw: result = parse_pixy_block(raw) for b in result: print(f"签名 {b['signature']} 位置 ({b['x']}, {b['y']}) 尺寸 {b['width']}x{b['height']}")

这段代码的关键点在于帧头识别和块长度固定为 14 字节。参数说明：signature是你在上位机里给不同颜色分配的编号，默认 1 到 7；x和y是块中心坐标，范围取决于分辨率，默认 0 到 315（水平）和 0 到 207（垂直）；angle是块的主轴角度，对追踪线条或倾斜物体有用。实际使用时，串口一次读取的字节数可能包含半帧，所以更稳妥的做法是维护一个缓冲区，按帧头切分后再解析。上面为了简洁直接按 64 字节读，你在正式项目里最好改成环形缓冲。

2.3 上位机配置：签名和参数的“后悔药”

Pixy2 配套的上位机工具（PixyMon）可以实时预览画面并设置颜色签名。很多人第一次用的时候发现模块识别不到自己想要的颜色，原因通常是光照变化导致签名偏移。我的习惯是：先在目标场景的实际光照下，用 PixyMon 的“设置签名”功能框选目标颜色，然后保存到模块的闪存里。这样即使断电重启，签名也不会丢。

如果你不想依赖图形界面，也可以通过串口发送命令来修改签名。常见做法是发送0xAE开头的配置帧，具体字节序列在源码的src/host/目录下有参考。注意：修改签名后需要发送保存命令，否则掉电即失。这一步没有“后悔药”，只能重新配置。

3. 把 pixy2 用进项目：三种典型场景的代码骨架

理解了通信链路之后，下一步是把模块塞进实际项目。pixy2-master.zip 里的示例覆盖了颜色追踪、线段追踪和条形码识别，但示例往往只演示单一功能。真实项目里你需要把视觉结果和运动控制结合起来。下面按三个场景给出可抄的骨架。

3.1 颜色追踪云台：从坐标到舵机角度

假设你用两个舵机构成一个二自由度云台，想让云台始终对准红色物体。核心逻辑是：读取块坐标，计算与画面中心的偏差，用比例控制调整舵机角度。

import serial import struct import time ser = serial.Serial('/dev/ttyUSB0', 115200, timeout=0.1) # 画面中心，Pixy2 默认分辨率 316x208 CENTER_X = 158 CENTER_Y = 104 # 比例系数，需要根据舵机响应速度调整 KP_X = 0.15 KP_Y = 0.15 def read_blocks(): # 简化版读取，实际应使用缓冲区 raw = ser.read(128) blocks = [] idx = 0 while idx < len(raw) - 1: if raw[idx] == 0xAA and raw[idx+1] == 0x55: idx += 2 if idx >= len(raw): break count = raw[idx] idx += 1 for _ in range(count): if idx + 14 > len(raw): break sig, x, y, w, h, angle, _ = struct.unpack('<HHHHHHH', raw[idx:idx+14]) blocks.append((sig, x, y, w, h)) idx += 14 else: idx += 1 return blocks # 假设舵机控制函数，参数为角度 def set_servo(channel, angle): # 实际项目中这里会调用 PCA9685 或直接输出 PWM pass current_x = 90 current_y = 90 while True: blocks = read_blocks() for sig, x, y, w, h in blocks: if sig == 1: # 假设签名 1 是红色 error_x = x - CENTER_X error_y = y - CENTER_Y # 比例控制，注意方向根据云台安装方式调整 current_x -= error_x * KP_X current_y += error_y * KP_Y # 限幅 current_x = max(0, min(180, current_x)) current_y = max(0, min(180, current_y)) set_servo(0, current_x) set_servo(1, current_y) time.sleep(0.02)

逻辑说明：error_x为正表示物体在中心右侧，云台需要向右转，但具体是增加还是减少舵机角度取决于你的机械结构。参数KP_X和KP_Y是调参重点，太大会震荡，太小会滞后。我一般从 0.1 开始试，观察云台是否等幅振荡，再逐步降低。注意time.sleep(0.02)对应约 50Hz 的控制频率，Pixy2 在颜色识别模式下帧率可以到 60fps 以上，但串口读取和解析会占时间，实际能跑到 30Hz 左右就不错了。

3.2 线段追踪：让小车沿黑线走

Pixy2 的线段追踪模式会返回多条线段的起点和终点坐标，以及一个“主线段”的向量。对于巡线小车，你只需要关心主线段与画面垂直方向的偏差。

def parse_line_data(raw): """ 解析线段追踪数据，返回主线段向量 帧结构：0xAA 0x55 后跟线段数量，每条线段 6 字节 """ idx = 0 while idx < len(raw) - 1: if raw[idx] == 0xAA and raw[idx+1] == 0x55: idx += 2 if idx >= len(raw): break count = raw[idx] idx += 1 lines = [] for _ in range(count): if idx + 6 > len(raw): break x0, y0, x1, y1, _, _ = struct.unpack('<HHHHHH', raw[idx:idx+6]) lines.append((x0, y0, x1, y1)) idx += 6 return lines else: idx += 1 return [] # 主循环中计算偏差 lines = parse_line_data(ser.read(128)) if lines: # 取第一条线段作为参考，实际应选最长的 x0, y0, x1, y1 = lines[0] # 计算线段中点与画面底边中点的水平偏差 mid_x = (x0 + x1) // 2 error = mid_x - CENTER_X # 用 error 控制左右轮差速 left_speed = base_speed + error * 0.5 right_speed = base_speed - error * 0.5

参数说明：base_speed是基础速度，error乘以系数后叠加到左右轮。系数太大会让小车画龙，太小则过弯迟钝。常见做法是先用纯比例控制跑通，再根据弯道表现加入微分项。注意 Pixy2 的线段追踪对光照和对比度有要求，黑线要足够黑，背景要足够白，否则返回的线段会跳变。

3.3 条形码与二维码：触发式读取

Pixy2 支持读取 EAN-13 和二维码，但它的解码能力有限，适合近距离、正对、光照均匀的场景。代码上比颜色识别简单，因为返回的是字符串。

def parse_barcode(raw): # 条形码帧以 0xAA 0x55 开头，后跟长度和 ASCII 数据 idx = 0 while idx < len(raw) - 1: if raw[idx] == 0xAA and raw[idx+1] == 0x55: idx += 2 if idx >= len(raw): break length = raw[idx] idx += 1 if idx + length > len(raw): break code = raw[idx:idx+length].decode('ascii', errors='ignore') return code else: idx += 1 return None # 使用示例 code = parse_barcode(ser.read(64)) if code: print(f"读到条码：{code}") # 触发后续动作，比如记录或分拣

注意：条形码读取需要模块处于对应模式，默认上电是颜色识别模式，需要通过串口命令切换。切换命令在源码的src/host/里有定义，通常是发送0xAE后跟模式字节。切换后模块会重启，需要等待约 1 秒再开始读取。

4. 避坑与排查：pixy2 实际部署中的五个血泪经验

这一章不讲新功能，只讲我踩过的坑。如果你正准备把 Pixy2 装到设备上，下面五条能帮你省下至少一个周末。

4.1 现象：串口读不到任何数据，模块 LED 正常亮

原因：最常见的是波特率不匹配。Pixy2 默认 115200，但有些主控的串口时钟源不准，尤其是低端单片机用内部 RC 振荡器时，误差可能超过 3%，导致通信失败。另一个原因是 TX/RX 接反，模块的 TX 要接主控的 RX。

解决：先用 USB 转串口工具直接连模块，确认能收到数据。如果 USB 转串口能收到，说明模块没问题，再检查主控串口配置。对于时钟不准的主控，换用外部晶振或降低波特率到 57600 试试。

4.2 现象：颜色识别时有时无，物体稍微一动就丢

原因：签名阈值设置过窄。Pixy2 的颜色识别基于 HSV 空间，如果只框选了目标颜色的一小部分，光照稍变就会超出范围。另外，模块的自动白平衡和自动增益会随画面变化，导致同一颜色在不同背景下识别效果不同。

解决：在 PixyMon 里把签名范围拉大一些，尤其是色调（Hue）范围。如果场景光照变化大，可以考虑关闭自动白平衡，手动固定曝光。具体做法是在 PixyMon 的设置里找到“相机”选项，把自动模式改成手动，然后调曝光值直到画面不过曝也不欠曝。

4.3 现象：I2C 通信偶尔卡死，需要重新上电

原因：I2C 总线被拉死。Pixy2 作为从机，如果主控在模块发送数据时复位，或者总线电容过大导致上升沿变缓，都可能让 SDA 被持续拉低。另一个原因是模块的 I2C 地址与总线上其他设备冲突，Pixy2 默认地址是 0x54，但可以通过命令修改。

解决：在 SDA 和 SCL 上各加一个 4.7kΩ 上拉电阻到 3.3V 或 5V（取决于主控电平）。如果总线很长，降低 I2C 速率到 100kHz。软件上，主控的 I2C 驱动最好有超时复位机制，检测到总线忙超过一定时间就重新初始化。

4.4 现象：线段追踪返回的线段数量很多，但都不是想要的

原因：背景纹理被误识别为线段。Pixy2 的线段追踪算法对边缘敏感，如果背景有格子、条纹或阴影，会产生大量短线段。另外，模块的“线段合并”参数如果设置不当，会把相邻的干扰线段合并成一条长线。

解决：在 PixyMon 里调整线段追踪的阈值，提高最小线段长度，过滤掉短线段。如果背景实在复杂，考虑改用颜色识别模式，在目标路径上贴一条高饱和度颜色的胶带，用颜色块的中心点来巡线。虽然精度略低，但抗干扰能力强很多。

4.5 现象：模块发热明显，长时间运行后识别率下降

原因：Pixy2 的处理器在满负荷运行时功耗不小，如果装在密闭外壳里，热量散不出去，芯片温度升高会导致图像传感器噪声增大。另外，如果供电电压低于 4.8V，模块内部的 LDO 会工作在线性区，额外发热。

解决：外壳上开散热孔，或者直接把模块贴在金属结构件上辅助散热。供电线尽量短而粗，避免压降。如果主控和电机共用电源，给 Pixy2 单独加一个 5V 稳压模块，比如常见的 7805 或 DC-DC 降压模块，能显著改善稳定性。

5. 进阶：用 pixy2-master 源码做二次开发与性能验证

如果你不满足于调用现成协议，pixy2-master.zip 里的源码可以让你改固件、加自定义识别算法，或者把模块当成一个可编程视觉前端。这一章讲两个方向：一是如何验证你的修改是否生效，二是如何在不改固件的前提下榨出更高帧率。

5.1 编译与烧录：从源码到模块

源码目录里通常包含src/和scripts/，编译需要对应的工具链。以常见的 ARM 平台为例，流程如下：

# 进入源码目录 cd pixy2-master/src # 配置编译目标，具体名称看 Makefile 里的定义 make clean make pixy2 # 生成的固件通常在 build/ 目录下 ls build/*.bin

烧录一般通过模块上的调试接口，需要专用的编程器。如果你没有编程器，也可以尝试通过串口进入 bootloader 模式，但 Pixy2 的 bootloader 通常不开放给用户。所以更现实的做法是：只修改上位机侧的解析代码，不动固件。这样风险最低，也足够应对大多数定制需求。

5.2 帧率验证：用时间戳算真实吞吐

很多人以为 Pixy2 标称 60fps 就能在项目里跑到 60fps，实际串口传输和解析会吃掉大量时间。下面这段代码用来测量从发送请求到收到完整一帧的耗时。

import time import serial ser = serial.Serial('/dev/ttyUSB0', 115200, timeout=0.05) def measure_fps(duration=5): start = time.time() frames = 0 while time.time() - start < duration: # 发送请求帧，具体命令参考协议文档 ser.write(b'\xae\x01\x00') # 示例：请求颜色块 raw = ser.read(128) if raw and raw[0] == 0xAA: frames += 1 elapsed = time.time() - start print(f"实际帧率：{frames / elapsed:.1f} fps") measure_fps()

参数说明：duration是测量时长，建议至少 5 秒。ser.read(128)的 128 是经验值，足够容纳一帧颜色数据。如果实际帧率远低于预期，先检查串口波特率是否真的跑在 115200，有些 USB 转串口芯片在高波特率下会丢字节。另一个瓶颈是 Python 的 GIL，如果主控是树莓派，可以考虑用 C 重写解析部分，或者用pyserial的in_waiting属性批量读取。

5.3 自定义签名与多模块协同

Pixy2 支持最多 7 个颜色签名，但如果你需要识别更多颜色，可以通过切换签名组来实现。源码里有一个“签名组”的概念，每组 7 个，最多可以存 3 组。切换命令发送后模块会重新加载签名，耗时约 200ms。如果你的项目需要同时追踪多种颜色，又不想频繁切换，可以考虑用两个 Pixy2 模块，一个负责暖色，一个负责冷色，通过不同的 I2C 地址挂在同一条总线上。

I2C 地址修改命令在源码的src/host/里有示例，通常是发送0xAE后跟地址字节。修改后需要保存并重启。注意：两个模块的地址不能相同，否则总线冲突。