讲师中心 微信公众号
AI工具推荐 视频效率加速

C++在树莓派Linux上怎么使用mmap直接映射GPIO物理基地址操作引脚

落杰君_3377

落杰君_3377

发布时间:2026-10-27 11:44:30

|

103人浏览过

|

来源于php中文网

原创

因为内核安全策略(CONFIG_STRICT_DEVMEM等)硬性拦截外设区物理地址映射,/dev/mem访问GPIO基址(如0x7e200000)被禁止;应改用/dev/gpiomem设备,它仅暴露GPIO寄存器、默认对gpio组用户可读写,且无需sudo。

c++在树莓派linux上怎么使用mmap直接映射gpio物理基地址操作引脚

为什么不能直接 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++):

立即学习“C++免费学习笔记(深入)”;

Obsidian (Linux)
Obsidian (Linux)

操作 Obsidian 库(纯 Markdown 笔记),并通过 notesmd-cli 实现自动化。

下载
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 功能

映射后操作引脚必须按 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 —— 但这又回到用户空间驱动的老路了。

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2268

2024.03.14

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

1039

2024.03.14

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

447

2024.03.14

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

327

2024.03.14

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

426

2024.03.14

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

600

2024.03.14

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

1429

2024.03.21

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

1237

2024.03.22

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

0

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
linux嵌入式开发+驱动开发视频教程
linux嵌入式开发+驱动开发视频教程

共39课时 | 9.5万人学习

JavaScript OOP调试技巧视频教程
JavaScript OOP调试技巧视频教程

共5课时 | 1.1万人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn