Arduino 8 位并行 IO 端口库：一行代码实现 8 位数字读写

痛点背景

Arduino 标准库 digitalWrite()/digitalRead() 只能逐个操作单个引脚。当需要驱动 7 段数码管、DIP 拨码开关、DAC 芯片等 8 位并行设备时，必须写 8 次循环，代码冗长且效率低。本库通过将任意 8 个 Arduino 引脚“捆绑”为一个虚拟 8 位端口，实现单指令读写整个字节，大幅简化代码并提升速度。

库特性

• 任意选取 8 个数字引脚组合成 8 位端口
• 支持输入/输出方向配置，可运行时切换（第二种构造函数）
• 仅 5 个核心函数，零依赖，占用 Flash 极小
• 自带越界保护（数据 >255 报错）与方向未设置提示
• 兼容所有 AVR 架构 Arduino（UNO、Nano、Mega 等）

安装方法

1. 下载 IO_Port_8bit.zip。
2. Arduino IDE → 草图 → 包含库 → 添加 .ZIP 库 → 选择该文件。
3. 在代码中 #include <IO_Port_8bit.h> 即可使用。

API 速查

典型应用示例

示例 1：8 个 LED 交替闪烁（1 Hz）

#include <IO_Port_8bit.h>
IO_Port_8bit myPort(2,3,4,5,6,7,8,9, 'O'); // D2~D9 作输出口

void setup() {}

void loop() {
  myPort.send_8bit_data(0b01010101); // 奇数位亮
  delay(500);
  myPort.send_8bit_data(0b10101010); // 偶数位亮
  delay(500);
}

示例 2：LED 显示 0~F 二进制计数

IO_Port_8bit port(2,3,4,5,6,7,8,9); // 先不定方向
void setup() { port.set_IO_direction('O'); }
void loop() {
  for (int i=0; i<16; i++) {
    port.send_8bit_data(i);
    delay(200);
  }
}

示例 3：电位器控制 8 位 LED 电平条（模拟电压可视化）

IO_Port_8bit bar(2,3,4,5,6,7,8,9, 'O');
void setup() {
  bar.send_8bit_data(255); delay(500);
  bar.send_8bit_data(0);
}
void loop() {
  int level = map(analogRead(A0), 0, 1023, 0, 80);
  if (level > 70) bar.send_8bit_data(0xFF);
  else if (level > 60) bar.send_8bit_data(0x7F);
  else if (level > 50) bar.send_8bit_data(0x3F);
  else if (level > 40) bar.send_8bit_data(0x1F);
  else if (level > 30) bar.send_8bit_data(0x0F);
  else if (level > 20) bar.send_8bit_data(0x07);
  else if (level > 10) bar.send_8bit_data(0x03);
  else if (level > 0)  bar.send_8bit_data(0x01);
  else bar.send_8bit_data(0x00);
}

示例 4：读取 8 位 DIP 开关并串口打印

IO_Port_8bit dip(2,3,4,5,6,7,8,9);
void setup() {
  Serial.begin(9600);
  dip.set_IO_direction('I');
}
void loop() {
  int val = dip.get_8bit_data();
  Serial.print("DIP值: "); Serial.println(val);
  delay(1000);
}

原理图连接

8 个引脚分别通过限流电阻连接 LED 阳极（输出模式）或接 DIP 开关一端、另端接地（输入模式，需启用内部上拉或外接上拉电阻）。库内部自动配置 pinMode 与 digitalWrite/Read，无需手动干预。

适用场景

• 多位 7 段数码管动态扫描（配合位选）
• 并行 DAC（如 R-2R 电阻网络）输出波形
• 键盘矩阵/拨码开关批量读取
• 简单逻辑分析仪/总线监听原型

注意事项

• 同一端口不能同时作为输入和输出；若需双向，请用两个端口对象分别绑定不同引脚组。
• 引脚顺序即位权顺序：p1=LSB (bit0)，p8=MSB (bit7)。
• 输入模式下建议外接上拉/下拉电阻，避免悬空抖动。