最稳妥方式是直接使用 /sys/class/gpio 接口，因其不依赖第三方库、无需编译内核驱动，且现代嵌入式 Linux 默认启用 CONFIG_GPIO_SYSFS；HAL 仅适用于裸机或 RTOS，寄存器直写在 Linux 用户态会因 MMU 保护触发段错误。
直接用 /sys/class/gpio 接口最稳妥，不依赖第三方库，也不用编译内核驱动——只要系统启用了 CONFIG_GPIO_SYSFS（现代嵌入式 Linux 发行版基本默认开启）。
为什么不用 HAL 或寄存器直写？
HAL 库（如 STM32 HAL）只适用于裸机或 RTOS 环境，运行在 Linux 用户空间时不可用；寄存器直写（如 *(volatile uint32_t*)0x40020000）在 Linux 下会被 MMU 拦截，触发 Segmentation fault——用户态进程无权访问物理地址。
- Linux 是保护模式操作系统，所有硬件访问必须经由内核提供的接口
-
/sys/class/gpio是内核导出的稳定 ABI，比libgpiod更轻量、兼容性更好（尤其在旧版 BusyBox 系统中） - 不要试图用
mmap(/dev/mem)绕过——需要 root +CONFIG_STRICT_DEVMEM关闭，且存在安全风险
如何用 C++ 写入 GPIO 电平（/sys/class/gpio 方式）
核心流程只有四步：导出引脚 → 设置方向 → 写 value → （可选）取消导出。所有操作都是文件 I/O，无需额外链接库。
Linux Security Scanner
下载
Linux 安全审计工具，检查 SSH 配置、开放/监听端口、防火墙规则（ufw/iptables/nftables）、失败登录尝试、sudoers 权限...
- 引脚编号计算公式：
gpio_chip_base + pin_offset，例如树莓派 BCM 编号 17 对应的 sysfs 编号通常是 17（部分 SoC 如 i.MX6ULL 需查/sys/class/gpio/gpiochip*/base） - 写方向时，
"out"和"in"是唯一标准值；"high"/"low"是非标准扩展，仅部分内核版本支持，不建议依赖 -
value文件只接受字符'0'或'1'（注意是 ASCII 字符，不是整数），写入其他内容会返回EINVAL - 务必检查每次
open()、write()的返回值，/sys/class/gpio下的文件对权限和原子性很敏感
#include <fcntl.h>
#include <unistd.h>
#include <string>
bool set_gpio_value(int gpio_num, bool high) {
std::string export_path = "/sys/class/gpio/export";
int fd = open(export_path.c_str(), O_WRONLY);
if (fd < 0) return false;
write(fd, std::to_string(gpio_num).c_str(), std::to_string(gpio_num).size());
close(fd);
std::string dir_path = "/sys/class/gpio/gpio" + std::to_string(gpio_num) + "/direction";
fd = open(dir_path.c_str(), O_WRONLY);
if (fd < 0) return false;
write(fd, "out", 3);
close(fd);
std::string val_path = "/sys/class/gpio/gpio" + std::to_string(gpio_num) + "/value";
fd = open(val_path.c_str(), O_WRONLY);
if (fd < 0) return false;
write(fd, high ? "1" : "0", 1); // 注意：只写一个字节 '0' 或 '1'
close(fd);
return true;
}
libgpiod vs /sys/class/gpio：选哪个？
libgpiod 是更现代的选择，但实际项目中容易踩坑：
立即学习“C++免费学习笔记（深入）”；
-
gpiod_chip_open_by_name("gpiochip0")在多芯片系统（如带 PMIC GPIO）中可能打开错误芯片，需配合gpiod_chip_get_line()前先调用gpiod_chip_get_lines()查找真实名称 -
gpiod_line_request_output()的初始电平参数在某些内核版本（如 5.10 LTS）中无效，首次set_value才真正生效 -
/sys/class/gpio虽然被标记为 “deprecated”，但至今仍是绝大多数嵌入式 Linux BSP（Yocto、Buildroot）默认启用且文档最全的方式 - 若必须用
libgpiod，优先使用gpiod_line_set_value_bulk()批量操作，避免单线程频繁系统调用开销
真正容易被忽略的是引脚复用冲突——比如你控制的 GPIO 实际已被设备树配置为 I2C 功能，此时 /sys/class/gpio/gpioN 根本不会生成。动手前先确认 cat /sys/kernel/debug/pinctrl/*-pinctrl-base/pins | grep N，看该引脚是否处于 function: gpio 状态。
