因为内核安全策略（CONFIG_STRICT_DEVMEM等）硬性拦截外设区物理地址映射，/dev/mem访问GPIO基址（如0x7e200000）被禁止；应改用/dev/gpiomem设备，它仅暴露GPIO寄存器、默认对gpio组用户可读写，且无需sudo。
为什么不能直接 mmap GPIO 物理地址到用户空间
树莓派 Linux（特别是 5.4+ 内核）默认禁止用户态进程通过 mmap 直接映射 /dev/mem 访问 GPIO 物理地址（如 0x7e200000），这是内核安全策略（CONFIG_STRICT_DEVMEM + CONFIG_IO_STRICT_DEVMEM）强制启用的结果。即使你用 sudo 运行程序，open("/dev/mem", O_RDWR) 也会成功，但后续 mmap 在访问 GPIO 区域时大概率返回 Invalid argument 或触发 Bus error。
根本原因不是权限不够，而是内核在 devmem_is_allowed() 中硬性拦截了对 0x7e000000–0x7effffff（Broadcom SoC 外设区）的映射请求——这个区域被标记为“strict”，仅允许内核模块或特定驱动访问。
替代方案：用 /dev/gpiomem 而非 /dev/mem
树莓派官方提供了更安全、更可控的接口：/dev/gpiomem。它由 gpiomem 字符设备驱动导出，只暴露 GPIO 寄存器块（约 0x1000 字节），且不包含其他敏感外设（如 UART、PWM）。该设备默认对 gpio 组用户可读写，无需 sudo（只要用户在 gpio 组里）。
- 确认设备存在：
ls -l /dev/gpiomem→ 应显示crw-rw---- 1 root gpio - 把当前用户加入
gpio组：sudo usermod -aG gpio $USER，然后重新登录 - 物理基地址不用再硬编码
0x7e200000；/dev/gpiomem映射后，起始地址即为 GPIO 控制寄存器基址（对应 BCM2835 手册中 GPIO_BASE）
示例片段（C++）：
int fd = open("/dev/gpiomem", O_RDWR);
if (fd == -1) { /* handle error */ }
volatile uint32_t* gpio = static_cast<uint32_t>(
mmap(nullptr, 4096, PROT_READ | PROT_WRITE, MAP_SHARED, fd, 0)
);
if (gpio == MAP_FAILED) { /* check errno: usually EINVAL if /dev/gpiomem missing or perms wrong */ }
// gpio[0] 是 GPFSEL0，控制 GPIO 0–9 功能
</uint32_t>
映射后操作引脚必须按 BCM2835 手册定义寄存器偏移
/dev/gpiomem 映射的是 GPIO 寄存器组的起始页，但**不是整个外设总线**。你只能访问 GPIO 相关寄存器（GPFSEL, GPSET, GPCLR, GPLEV 等），不能碰 GPEDS（除非你明确需要边缘检测并已使能）或误读写其他外设寄存器（比如去读 0x100 偏移以外的地址可能返回 0 或触发 fault）。
关键点：
-
GPFSELn（功能选择）：每 3 位控制 1 个 GPIO，偏移n * 4（n=0..5），对应 GPIO 0–27（BCM 编号） -
GPSETn（置高）：写 1 置位，写 0 无影响；偏移0x1c + n * 4（n=0..2） -
GPCLRN（置低）：同理，偏移0x28 + n * 4 - 务必用
volatile修饰指针，防止编译器优化掉多次写操作 - 不要用
*(gpio + offset/4) = val直接算偏移；用宏或常量定义更安全，例如：#define GPFSEL0 0,#define GPSET0 0x1c/4
注意内存屏障和时序：裸寄存器操作没有驱动层保护
直接操作 /dev/gpiomem 绕过了 libgpiod 或 wiringPi 的抽象，意味着你需要自己处理：
- 写
GPSET/GPCLR后，GPIO 电平变化是即时的，但若紧接着读GPLEV，可能因 CPU 乱序或缓存未同步而读到旧值 → 插入__asm__ volatile("dsb sy" ::: "memory")（ARM DSB 数据同步屏障） - 高频翻转（如模拟 PWM）需注意最小脉宽；GPIO 切换本身有几纳秒延迟，但软件开销（函数调用、分支预测失败）远大于此
- 没有引脚复用自动管理：如果 GPIO 已被
config.txt设为 I2C 或 SPI 模式，写GPFSEL可能无效，或导致总线冲突 → 先用raspi-gpio get确认当前功能 - 程序退出前记得
munmap和close(fd)，否则下次运行可能因资源占用失败
最易被忽略的是：/dev/gpiomem 不提供中断支持，也不做电平/边沿去抖。你要轮询 GPLEV 或结合 epoll 监听 /sys/class/gpio 的 uevent —— 但这又回到用户空间驱动的老路了。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
