在嵌入式系统开发，特别是使用 Arduino 平台进行硬件控制时，digitalWrite 是一个极为常用且功能强大的函数。它虽然并非纯粹C 语言标准库的一部分，而是 Arduino 编程环境为了简化微控制器 I/O 操作而封装的函数，但其底层实现正是基于C 语言或 C++。理解 digitalWrite 的作用，就相当于掌握了用C 语言代码来直接操控数字引脚（Digital Pin）输出高低电平的能力，从而控制外部电子元件的开启与关闭。
digitalWrite 的定义与基本用法
digitalWrite 函数的C 语言（或 C++）原型通常是这样的：void digitalWrite(uint8_t pin, uint8_t value);。
pin 参数：指定要操作的数字引脚编号。这个编号通常对应微控制器上的实际物理引脚。
value 参数：指定要输出的电平状态。它有两个可选值：
HIGH：代表高电平，通常对应微控制器的电源电压（例如 5V 或 3.3V）。当引脚输出高电平，它可以驱动LED亮起、继电器吸合等。
LOW：代表低电平，通常对应接地（0V）。当引脚输出低电平，可以关闭LED、释放继电器等。 在调用 digitalWrite 之前，必须使用 pinMode(pin, OUTPUT); 函数将对应的引脚设置为输出模式，否则 digitalWrite 将无法正常工作。
digitalWrite 的实际应用场景
digitalWrite 函数的应用场景非常广泛，它是嵌入式系统中最基础的输出控制手段之一：
控制 LED 灯：这是最经典的例子。通过 digitalWrite(LED_BUILTIN, HIGH); 可以点亮板载LED，digitalWrite(LED_BUILTIN, LOW); 则可以熄灭。通过循环和延时，可以实现 LED 闪烁效果。
驱动继电器：继电器是一种常用的电磁开关，通过 digitalWrite 控制其线圈通电与否，可以间接控制大电流负载（如交流电器）的通断。
控制蜂鸣器：通过 digitalWrite 快速切换引脚高低电平，可以驱动无源蜂鸣器发出声音。
驱动步进电机或舵机：虽然复杂驱动需要脉冲宽度调制（PWM）或特定库函数，但基本的启停信号或方向控制有时也可以通过 digitalWrite 来实现。
实现数字通信协议：在某些简单的串行通信协议中，如位数字串行传输，可以通过 digitalWrite 来精确控制数据线的电平变化，模拟通信信号。
digitalWrite 与 C 语言底层操作
尽管 digitalWrite 方便易用，但其底层逻辑最终会转换为对微控制器特定寄存器的直接C 语言位操作。例如，Arduino Uno 使用 ATmega328P 微控制器，digitalWrite 的内部实现会操作特定的端口数据寄存器（如 PORTB, PORTC, PORTD）的相应位，来设置引脚的电平状态。理解 digitalWrite 的封装性及其底层C 语言原理，有助于开发者在需要时直接进行寄存器操作，以获得更快的执行速度或更精细的控制，这对于高性能或资源受限的嵌入式项目尤为重要。