EVO ONO GPIO 使用说明#

GPIO接口使用说明#

GPIO接口信号定义#

接口名称

引脚序号

接口说明

设备节点

DI_0

1

GPIO IN

271

DI_1

3

GPIO IN

270

DI_2

5

GPIO IN

269

DI_3

7

GPIO IN

268

DO_0

9

GPIO OUT

272

DO_1

11

GPIO OUT

273

DO_2

13

GPIO OUT

274

DO_3

15

GPIO OUT

275

DIGND

2、4、6、8

DI地

/

DOGND

10、12、14、16

DO地

/

DI硬件规格#


电压

逻辑电平高

3.75V ~ 24V

逻辑低电平

0V ~ 2V

DI使用方法#

#


说明

Vin

输入电压

GND

地

对GPIO接口使用的示例如下

# 切换到root用户
sudo su -
# 读取数据(DI)
cat /sys/class/gpio/<设备节点>/value
# 示例: cat /sys/class/gpio/gpio339/value

DO硬件规格#


电压

逻辑电平高

3.3V/5V/12V/24V

逻辑低电平

0V

DO使用方法#


说明

Vout

输出电压

GND

地

Load

负载

对DO接口使用的示例如下,请将< >中的信息修改为想要调整的DO节点号,修改为想要调整的输出电平(支持3.3、5、12、24,默认3.3),具体对应关系请参考【接口说明】部分

# 切换到root用户
sudo su -
# 设置为高电平(DO)
echo 1 > /sys/class/gpio/<gpio339>/value
# 设置输出电平为3.3V
sudo /usr/local/bin/volout.sh 3.3
# 设置为低电平(DO)
echo 0 > /sys/class/gpio/<gpio339>/value
# 读取数据(DI)
cat /sys/class/gpio/<gpio339>/value

GPIO问题排查#

​一、权限与引脚占用类问题​#

​现象​

​原因分析​

​解决方法​

执行echo X > export时

返回 ‘”Device or resource busy”

GPIO已被其他驱动/进程占用

1. 检查占用源:cat /sys/kernel/debug/gpio

2. 终止占用进程:lsof /sys/class/gpio/gpioX/value

3. 强制释放:echo X > unexport → 重启系统

操作/sys/class/gpio文件时 ​权限不足​

用户未加入gpio组或未用sudo

1. 添加用户组:sudo usermod -aG gpio <user>

2. 修改文件权限:sudo chmod 0660 /sys/class/gpio/gpioX/value

二、电平异常类问题​#

​现象​

​原因分析​

​解决方法​

​输出电平不稳定​

1. 电源干扰/接地不良

2. PCB跨分割导致阻抗突变<br>3. 负载电流超限

1. 增加去耦电容滤波

2. 检查PCB布线,避免信号线跨越电源分割区

3. 外接MOSFET驱动高负载设备

​输入值错误​

1. 未配置上下拉电阻

2. 外部电压超范围

1. 软件配置上拉:echo pullup > /sys/class/gpio/gpioX/direction

2. 硬件增加4.7kΩ上拉电阻,或使用电平转换器

​输出模式下读取电平导致死机​

1. 错误访问输入寄存器(IDR)

2. 外部电路短路

1. 改用输出数据寄存器读取状态

2. 硬件串联100Ω限流电阻,避免过流

​三、中断与事件检测故障​#

​现象​

​原因分析​

​解决方法​

​中断无响应​(边缘触发失效)

1. 中断类型配置错误

2. ISR阻塞过久

1. 确认触发边沿:echo rising > /sys/class/gpio/gpioX/edge

2. 优化ISR:用perf top分析耗时,拆分长任务

​事件检测误触发​(如无故触发高电平)

1. 信号噪声干扰

2. 引脚虚焊/接触不良

1. 软件添加消抖:sysfs中设置debounce值

2. 硬件屏蔽线隔离干扰源,或增加RC滤波电路

​四、功能配置冲突​#

​现象​

​原因分析​

​解决方法​

GPIO方向设置无效​(无法切输入/输出)

1. 复用功能冲突(如被占用为I2C)

2. 驱动未加载

1. 检查设备树:确认apex_ad10.dts中未复用引脚

2. 加载驱动:modprobe gpio_chip_cdev

​同一引脚输出/输入切换失败​

1. 模式切换时序冲突

2. 中断抢占导致状态错乱

1. 关闭中断期间操作:local_irq_save()

2. 用全局变量缓存状态,避免频繁切换