1. 项目概述
SM_8MOS 是一款专为 Sequent Microsystems 八路 MOSFET 8 层可堆叠 HAT（Hardware Attached on Top）设计的 Arduino 库，面向 Raspberry Pi 平台，但其核心通信与控制逻辑完全兼容标准 Arduino 生态。该库并非仅限于树莓派使用，而是通过标准化 I²C 接口实现跨平台硬件抽象，使开发者可在 Uno、Nano、Teensy、Feather 或 ESP32 等任意具备 I²C 功能的微控制器上，以统一 API 控制物理层的八路高压/大电流开关输出。
该 HAT 的本质是一个基于 I²C 总线的远程数字输出扩展模块，每层提供 8 路独立可控的 N 沟道增强型 MOSFET 输出通道（典型型号如 IRFZ44N 或等效器件），支持直流负载驱动能力达 30V/30A（单通道持续），适用于继电器线圈、LED 阵列、直流电机启停、加热元件通断等工业级开关控制场景。其“8 层堆叠”特性意味着最多可将 8 块相同 HAT 物理堆叠在单个 Raspberry Pi 的 40pin GPIO 排针上，通过 I²C 地址拨码开关（0x20–0x27）实现总线隔离，最终在软件层面扩展出多达 64 路独立 MOSFET 输出通道，而无需额外主控或复杂布线。
本库的设计哲学是“零配置即用”：默认情况下，所有通道处于高阻态（关断），I²C 地址自动适配，PWM 参数预设为安全值（1kHz/0% 占空比），避免上电误动作；所有 API 均采用阻塞式同步调用，返回布尔值指示底层 I²C 事务是否成功，便于嵌入式系统中进行故障诊断与容错处理。
2. 硬件接口与连接方式
2.1 标准 I²C 连接（通用 Arduino 方案）
该 HAT 通过标准 2 线 I²C 总线与主控通信，物理连接仅需 4 根线：SDA（数据线）、SCL（时钟线）、+5V（逻辑供电与电平基准）、GND（共地）。HAT 板载电平转换电路确保与 3.3V 或 5V 主控兼容，无需外部电平转换器。
下表为 HAT 40pin GPIO 接口定义（面向 Raspberry Pi 引脚编号），其中仅标出必需连接引脚：
| HAT Pin | Signal | Connection Target | Notes |
|---|---|---|---|
| 3 | I2C-SDA | Arduino SDA (A4) | 必须接上拉电阻（4.7kΩ） |
| 5 | I2C-SCL | Arduino SCL (A5) | 必须接上拉电阻（4.7kΩ） |
| 2 / 4 | +5V | Arduino 5V | 提供逻辑电平与 I²C 上拉电源 |
| 6 / 9 / 14 / 20 / 26 / 30 / 34 / 39 | GND | Arduino GND | 至少连接 1 处，推荐多点接地降低噪声 |
关键工程提示：
- 所有未使用的 GPIO 引脚（如 1, 7, 11–13, 15–19, 21–25, 27–29, 31–33, 35–38, 40）均为悬空状态，严禁连接任何信号源，否则可能触发 HAT 内部保护逻辑或损坏 I²C 总线。
- 若使用长线缆（>20cm）或存在强电磁干扰环境，建议在 SDA/SCL 线上增加 100pF 旁路电容至 GND，并缩短走线长度。
- +5V 必须由主控板直接提供，不可由 HAT 反向供电给主控，因其无稳压反馈回路。
2.2 Sequent Microsystems 专用适配方案
2.2.1 SM Arduino Raspberry Pi 替换套件
该套件是一块物理尺寸与 Raspberry Pi Zero W 完全兼容的 PCB 转接板，一侧为标准 40pin GPIO 插座（用于插入 HAT），另一侧为 Arduino Uno/Nano/Teensy/Feather/ESP32 的排针接口。其核心价值在于：
- 将 HAT 的 40pin 接口电气隔离并重映射为 Arduino 标准引脚（D0–D13, A0–A5）；
- 内置 I²C 总线缓冲器，允许多层 HAT 在同一总线上稳定运行（解决电容负载超限问题）；
- 提供独立的 5V/3A 电源输入端子，可为 HAT 负载供电，避免主控 USB 供电过载。
使用时，将 HAT 插入套件的 40pin 插座，再将套件插在目标 Arduino 开发板上，即可直接调用SM_8MOS库，无需任何跳线。
2.2.2 SM ESP32-Pi 替代主控板
ESP32-Pi 是一款集成 ESP32-WROVER 模组的 Raspberry Pi 外形因子开发板，其 GPIO 引脚布局与树莓派完全一致，并原生支持 MicroPython/Arduino IDE。该板内置硬件 I²C（默认 GPIO21/22），且已预烧录适配固件，可直连 HAT 并通过Wire.h实现零延迟通信。其优势在于：
- 单板集成 Wi-Fi/BLE，支持 OTA 远程更新 MOSFET 状态；
- 双核 Xtensa LX6 处理器，可同时运行 FreeRTOS 任务：一个任务轮询传感器，另一个任务根据阈值实时切换 MOSFET；
- 板载 4MB PSRAM，足以缓存 64 路通道的状态快照与历史 PWM 曲线。
3. 核心 API 详解与工程化用法
3.1 类构造与初始化
SM_8MOS(uint8_t stack = 0);- 参数
stack：HAT 的堆叠地址偏移量（0–7），对应 I²C 地址0x20 + stack。例如：SM_8MOS mos(0);→ 使用地址0x20（默认第一层）；SM_8MOS mos1(0), mos2(1);→ 分别控制地址0x20和0x21的两层 HAT。
- 工程意义：
stack参数解耦了硬件物理堆叠与软件逻辑分组。在大型楼宇自动化系统中，可将stack=0–3分配给照明回路，stack=4–7分配给 HVAC 设备，通过mos1.writeChannel(1, true)与mos2.writeChannel(1, true)实现跨层协同控制。
bool begin();- 功能：执行 I²C 总线扫描、寄存器自检、PWM 模块复位三重初始化。
- 返回值：
true表示 HAT 存在且通信链路正常；false表示 I²C 无应答（检查接线）、地址冲突（多层地址重复）或内部寄存器校验失败。 - 典型用法：
void setup() { Serial.begin(115200); if (!mos.begin()) { Serial.println("ERROR: SM_8MOS not found at address 0x20"); while(1); // 硬件看门狗复位前挂起 } Serial.println("SM_8MOS initialized successfully"); }
bool isAlive();- 功能：轻量级心跳检测，仅发送 I²C START + 地址 + STOP，不访问任何寄存器。
- 用途：在 FreeRTOS 任务中周期性调用（如每 500ms），作为设备在线状态监控信号。若连续 3 次
isAlive()返回false，可触发告警 LED 闪烁或通过 MQTT 上报离线事件。
3.2 数字输出控制
bool writeChannel(uint8_t channel, uint8_t val);- 参数：
channel：通道号，取值范围1–8（非 0 基索引，与丝印标识一致）；val：逻辑电平，0（LOW）= 关断 MOSFET，1（HIGH）= 导通 MOSFET。
- 底层机制：写入 HAT 的
OUTPUT_REG寄存器（地址 0x00），该寄存器为 8bit，bit0–bit7 对应 CH1–CH8。 - 关键限制：该操作为纯数字开关，无软启动/斜率控制。若负载为感性（如继电器），需在硬件端并联续流二极管（1N4007），否则关断瞬间产生的反电动势可能击穿 MOSFET。
bool readChannel(uint8_t channel);- 功能：读取
OUTPUT_REG当前值，返回指定通道的输出状态（非实际漏极电压采样）。 - 注意：此函数返回的是 MCU 最后一次写入的期望状态，而非真实负载电压。若需验证负载是否真正导通，必须外接 ADC 采集 MOSFET 漏极对地电压。
3.3 PWM 输出控制（高级功能）
bool writePWM(uint8_t channel, float pwm);- 参数：
channel：同writeChannel，1–8；pwm：占空比百分比，0.0–100.0（浮点数，支持小数精度）。
- 实现原理：HAT 板载专用 PWM 发生器（非 MCU 软件模拟），通过 I²C 配置通道专用 PWM 占空比寄存器（
PWM_CHx_REG, x=1..8）。 - 精度：10bit 分辨率（0–1023），
pwm=50.0对应512/1023 ≈ 49.95%，满足绝大多数调光/调速需求。
bool writeFreqency(int frequency);- 参数
frequency：全局 PWM 频率，单位 Hz，有效范围16–2000。 - 硬件约束：频率由 HAT 的 1MHz 基准时钟分频生成，计算公式为
f_pwm = 1000000 / (prescaler × period)。库内建查表法确保输入值被映射到最接近的合法分频系数。 - 选型指南：
频率范围 典型应用 注意事项 16–100Hz 大功率加热控制 避免低频嗡鸣，需加装散热片 100–500Hz 直流电机调速 兼顾效率与转矩脉动抑制 500–2000Hz LED 调光 >1kHz 消除人眼可见闪烁
float readPWM(uint8_t channel); int readFreqency();- 用途：用于状态同步与调试。例如在 OTA 更新后，读取当前 PWM 设置以验证固件一致性；或在 PID 控制循环中，动态调整频率以优化电机响应。
4. 典型工程应用场景与代码示例
4.1 工业级继电器阵列控制（抗干扰强化版）
在 PLC 替代应用中，需确保继电器线圈通断的可靠性与抗干扰性。以下代码实现 CH1–CH4 控制四路 24VDC 继电器，加入硬件去抖与状态确认：
#include <Wire.h> #include <SM_8MOS.h> SM_8MOS relayHat(0); void setup() { Wire.setClock(100000); // 降频至 100kHz 提高抗噪性 if (!relayHat.begin()) { while(1) { delay(1000); } // 持续告警 } // 初始化所有通道为关断 for (uint8_t ch = 1; ch <= 4; ch++) { relayHat.writeChannel(ch, 0); } } void loop() { // 模拟外部输入信号（如光电开关） static bool sensorState = digitalRead(2); // 假设 D2 接传感器 static unsigned long lastChange = 0; if (sensorState != digitalRead(2) && millis() - lastChange > 20) { sensorState = !sensorState; lastChange = millis(); // 确认传感器状态后，控制继电器 if (sensorState) { // CH1 启动主电机，CH2 启动冷却泵 relayHat.writeChannel(1, 1); delay(10); // 确保 I²C 事务完成 relayHat.writeChannel(2, 1); // 验证写入结果 if (!relayHat.readChannel(1) || !relayHat.readChannel(2)) { Serial.println("RELAY WRITE FAILED!"); } } else { relayHat.writeChannel(1, 0); relayHat.writeChannel(2, 0); } } delay(10); }4.2 FreeRTOS 多任务 PWM 调光系统
利用 ESP32-Pi 的双核能力，将 PWM 控制与网络服务分离：
#include <freertos/FreeRTOS.h> #include <freertos/task.h> #include <SM_8MOS.h> SM_8MOS ledHat(0); // 任务句柄 TaskHandle_t xTaskPWMHandle, xTaskWebHandle; // PWM 控制任务：以 100Hz 频率更新 CH1–CH3 的 RGB LED void vTaskPWM(void *pvParameters) { ledHat.writeFreqency(100); // 全局设为 100Hz float r = 0.0, g = 0.0, b = 0.0; for(;;) { // 模拟呼吸灯算法 r = 50.0 + 40.0 * sin(millis() * 0.001); g = 50.0 + 40.0 * sin(millis() * 0.001 + 2.094); b = 50.0 + 40.0 * sin(millis() * 0.001 + 4.189); ledHat.writePWM(1, r); // Red ledHat.writePWM(2, g); // Green ledHat.writePWM(3, b); // Blue vTaskDelay(50 / portTICK_PERIOD_MS); // 20Hz 更新率 } } // Web 服务任务：接收 HTTP 请求动态调整亮度 void vTaskWeb(void *pvParameters) { for(;;) { // 此处集成 ESPAsyncWebServer 示例 // GET /set?ch=1&val=75 → ledHat.writePWM(1, 75.0) vTaskDelay(1000 / portTICK_PERIOD_MS); } } void setup() { Serial.begin(115200); if (!ledHat.begin()) { Serial.println("HAT init failed"); } // 创建两个独立任务 xTaskCreate(vTaskPWM, "PWM_TASK", 2048, NULL, 1, &xTaskPWMHandle); xTaskCreate(vTaskWeb, "WEB_TASK", 4096, NULL, 1, &xTaskWebHandle); } void loop() { // FreeRTOS 调度器接管 }4.3 多层 HAT 协同控制（64 路开关矩阵）
通过stack参数实例化多个对象，构建统一控制接口：
// 定义 8 层 HAT 对象数组 SM_8MOS hat[8] = { SM_8MOS(0), SM_8MOS(1), SM_8MOS(2), SM_8MOS(3), SM_8MOS(4), SM_8MOS(5), SM_8MOS(6), SM_8MOS(7) }; // 全局通道映射：layer 0–7, channel 1–8 → total index 0–63 bool setGlobalChannel(uint8_t globalIndex, bool state) { uint8_t layer = globalIndex / 8; // 0–7 uint8_t ch = (globalIndex % 8) + 1; // 1–8 if (layer >= 8) return false; if (!hat[layer].begin()) return false; // 首次访问时初始化 return hat[layer].writeChannel(ch, state ? 1 : 0); } void setup() { // 批量初始化所有层（实际项目中应逐层检测） for (int i = 0; i < 8; i++) { hat[i].begin(); } // 同时打开第 0 层 CH1 和第 7 层 CH8 setGlobalChannel(0, true); // layer0, ch1 setGlobalChannel(63, true); // layer7, ch8 }5. 故障诊断与调试技巧
5.1 I²C 通信异常排查
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
begin()返回false | SDA/SCL 上拉缺失 | 用万用表测 SDA/SCL 对 +5V 电阻，应为 4.7kΩ；若为开路，补焊上拉电阻 |
writeChannel()偶发失败 | 总线电容超限（>400pF） | 减少堆叠层数；改用 SM 替换套件；或在Wire.begin()后添加Wire.setClock(50000) |
readChannel()值与写入不符 | HAT 供电不足（<4.75V） | 用示波器测 HAT 的 +5V 引脚纹波，若 >100mVpp，增加 100μF 电解电容 |
5.2 MOSFET 异常发热分析
- 现象：某通道 MOSFET 在导通状态下温升 >60°C（手触烫）。
- 根因定位流程：
- 断开负载，测量 CHx 漏极对地电阻：若 <10Ω，说明 MOSFET 击穿（更换 HAT）；
- 接入额定负载，用万用表直流档测漏极电压：若 >0.5V，说明驱动不足（检查 HAT 输入电压是否达标）；
- 测量栅极驱动波形（需示波器）：若上升沿缓慢（>1μs），检查 I²C 时钟频率是否过低导致 PWM 更新延迟。
5.3 PWM 频率设置失效
当writeFreqency(500)后readFreqency()返回1000，表明：
- HAT 固件版本过旧（v1.0 以下不支持动态频率修改）；
- 解决方案：从 Sequent Microsystems 官网下载最新固件，通过
i2cset命令行工具升级：i2cset -y 1 0x20 0xFF 0x01 # 进入 Bootloader 模式 i2cset -y 1 0x20 0x00 [firmware_data] # 逐字节写入
6. 硬件设计注意事项（PCB 布局指南）
- 电源路径：HAT 的 +5V 输入必须使用 ≥2oz 铜厚走线，宽度 ≥3mm，从接插件直达 MOSFET 源极；
- 地平面：PCB 底层铺设完整地平面，所有 GND 引脚通过 ≥4 个过孔连接到底层；
- 高频去耦：每个 MOSFET 栅极串联 10Ω 电阻，并在源极与地之间放置 100nF X7R 陶瓷电容（0805 封装）；
- EMI 抑制：在 HAT 的 +5V 输入端并联 10μF 钽电容 + 100nF 陶瓷电容，形成复合滤波。
该库的工程价值在于将复杂的 I²C 寄存器操作封装为直观的writeChannel()和writePWM()，使嵌入式工程师能聚焦于控制逻辑而非底层协议细节。在实际产线部署中，建议将begin()检测结果写入 EEPROM，若连续 10 次初始化失败则锁定设备并点亮红色 LED，避免现场维护人员盲目更换硬件。
