12、树莓派GPIO硬件与Sysfs GPIO使用指南

树莓派GPIO硬件与Sysfs GPIO使用指南

1. GPIO硬件基础

在树莓派的GPIO（通用输入输出）系统中，有一些关键的电压参数需要了解。输入低电压（VIL）应小于等于0.8V，输入高电压（VIH）应大于等于1.3V。在VIL和VIH之间的电压水平对于逻辑值0和1来说是模糊或未定义的，应该避免。但在驱动像LED这样的电流负载时，这一点的重要性会降低。

1.1 输入引脚

GPIO输入引脚的电压应在0到3.3V的最大范围内。当与使用更高电压（如TTL逻辑的5V）的其他电路连接时，需要格外小心，因为系统芯片（SoC）不能承受过电压，可能会损坏。虽然芯片上有保护二极管来防止负输入摆动和过电压，但它们很弱，仅用于释放静电电荷，且制造商未记录这些保护二极管的电流容量。

1.2 输出引脚

作为输出GPIO引脚，用户需要完全负责电流限制，因为没有提供内置的电流限制。当输出引脚处于高状态时，它会尝试提供3.3V的电压（在晶体管和供电电压调节器的限制范围内）。如果输出引脚短路到地，可能会有尽可能多的电流流过，这可能导致永久性损坏。

输出引脚的工作也遵循前面提到的电压规格，但连接的负载可能会影响工作电压范围。输出引脚可以源电流或吸收电流，所需的电流量和配置的输出驱动量会改变工作电压曲线。只要在配置的驱动能力的电流限制范围内，树莓派应该能满足电压规格。

2. 电流源和吸收

2.1 源电流

GPIO端口可以向负载提供电流。例如，电流从+3.3V电源通过晶体管M1，经过GPIO引脚，流入负载，然后到地。这种情况下，需要高电平（逻辑1）才能向负载发送电流，这是一种高电平有效配置。

2.2 吸收电流

GPIO输出也可以通过负载将电流吸收到地。负载连接到+3.3V电源，电流从电源流入负载，然后通过晶体管M2流入GPIO输出引脚到地。要使电流通过负载，需要向输出端口写入逻辑0，这是低电平有效配置。

3. 驱动LED

当将LED连接到GPIO输出端口时，负载包括LED和限流电阻。有两种驱动LED的方式：高电平有效配置和低电平有效配置。

3.1 高电平有效配置

当向GPIO写入1位时，晶体管M1导通，电流通过LED1，LED1点亮。

3.2 低电平有效配置

当向GPIO写入0位时，晶体管M2导通，将电流吸收到地，LED2点亮。

为了限制通过LED的电流并保护输出晶体管，应该使用限流电阻（R）。可以使用欧姆定律计算电阻：
[R = \frac{V}{I}]
由于LED有正向电压降（VF），在计算电阻时应从电源电压（VCC）中减去这个电压降。对于红色LED，电压降通常在1.63到2.03V之间。

假设电源电压VCC为+3.3V，所需的LED电流为8mA，取最低电压降1.63V，可计算出限流电阻：
[R = \frac{3.3 - 1.63}{0.008} = 208.75\Omega]
由于电阻有标准值，应向上取整到最接近的标准10%组件值220Ω。

3.3 其他颜色的LED

一些纯绿色、蓝色、白色和紫外线（UV）LED的VF约为3.3V，在这种情况下，不需要限流电阻。黄色LED的VF约为1.8V。在处理LED时，通常没有数据手册，最好使用面包板电路测量VF。在测量时，使用5V或更高的电源，将数字万用表（DMM）的探头连接到指定点测量电压。假设使用220到330Ω的电阻（使用3mm或更小的LED时电阻更高）。

尽管采取了测量正向电压的预防措施，可能仍然会计算出220或330Ω的10%电阻值，但这可以确保GPIO不会受到损害。对于更高电压的LED，可以安全地消除限流电阻。如果有任何疑问，测量LED点亮时消耗的电流，不应超过16mA以保持在树莓派的驱动限制内。

4. 驱动逻辑接口

对于LED，接口的要求相对简单，只要输出端口处于一种状态时LED点亮，处于另一种状态时LED熄灭即可。如果遵守最大电流限制，GPIO输出引脚在这两种状态下出现的精确电压并不重要。

当连接到逻辑电路时，输出电压至关重要。对于接收逻辑，输出电平必须至少为VIH才能可靠地注册为1位（对于BCM2835，为1.3V），同样，输出应低于VIL才能可靠地在接收器中注册为0（对于BCM2835，为0.8V）。任何介于这些限制之间的电压电平都是模糊的，可能导致接收器随机看到0或1。

连接不同逻辑系列的方法有很多，包括直接连接（安全时）、分压电阻、二极管电阻网络和更复杂的运算放大器比较器。在选择方法时，需要考虑接口所需的开关速度。

5. 驱动双色LED

可以通过改变一对GPIO输出的极性来改变双色LED的颜色。当两个GPIO输出状态不同时，一个LED或另一个LED会点亮，因为有电流可以流动。当两个GPIO都处于相同状态时，没有电流流动，两个LED都熄灭。

需要注意的是，不同颜色的LED的VF可能有很大差异，需要在限流电阻上进行折衷。确保GPIO输出永远不需要源或吸收超过16mA的电流。

6. GPIO的替代功能

当配置GPIO引脚时，需要选择它是输入、输出还是替代功能（如UART）。具体的替代功能取决于所配置的引脚。

6.1 输出引脚配置

当引脚配置为输出时，剩余的配置元素包括逻辑感测和输出状态。GPIO引脚的输出状态可以作为32位字一次影响32个GPIO，也可以单独设置或清除。单独的设置/清除操作允许主机更改单个位而不影响其他位的状态，也不需要知道它们的状态。

6.2 输入引脚配置

输入引脚更复杂，因为提供了额外的硬件功能。输入GPIO引脚需要配置以下功能：
- 检测上升输入信号（同步/异步）
- 检测下降输入信号（同步/异步）
- 检测高电平信号
- 检测低电平信号
- 逻辑感测
- 中断处理（由驱动程序处理）
- 选择无上拉；使用上拉或下拉电阻

配置完成后，可以接收与输入信号变化相关的数据，或者简单地查询引脚的当前状态。

6.3 浮动电位

如果没有提供或配置上拉或下拉电阻，未连接的GPIO输入可能会“浮动”。当输入连接到驱动电路时，该电路将提供非浮动电压电平。GPIO输入使用MOSFET晶体管，它只对电压敏感（不像双极晶体管对电流敏感）。因此，当输入未连接时，GPIO输入可以感应电压，包括附近的静电（如猫产生的静电）。

输出GPIO引脚被钳位到输出电平，这使内部输入晶体管处于安全状态。当GPIO配置为输入时，通常最好配置上拉或下拉电阻，将信号拉高或拉到地。否则，静电将是随机的，需要ESD（静电放电二极管）保护二极管来释放电荷。

7. Sysfs GPIO

可以使用Raspbian Linux的sysfs伪文件系统来访问GPIO驱动程序。使用Raspbian驱动程序，即使是shell脚本也可以配置、读取或写入GPIO引脚。虽然C/C++程序员可能会认为这种方法太慢，但驱动程序提供了合理的边缘检测功能，这是直接寄存器访问方法无法实现的，并且可以接收关于GPIO状态变化的中断。

7.1 /sys/class/gpio目录

可以以root身份进入/sys/class/gpio目录：

$ sudo -i
# cd /sys/class/gpio

在这个目录中，可以看到两个主要的伪文件：
- export：用于保留GPIO引脚供用户使用，类似于打开文件。
- unexport：用于将资源返回给Raspbian内核管理。

这些是只写的伪文件，即使是root用户也不能读取。

7.2 导出GPIO

要获得GPIO17的独占使用权，可以向export伪文件写入：

# echo 17 >/sys/class/gpio/export
# echo $?
0

如果返回码为0，表示没有错误发生。如果提供了无效的GPIO编号或未释放的编号，将返回错误。成功保留gpio17后，会出现一个名为gpio17的新伪子目录。

7.3 配置GPIO

导出GPIO后，有几个重要的伪文件用于配置：
- direction：设置I/O方向
- value：读取或写入GPIO值
- active_low：改变逻辑感测
- edge：检测中断驱动的变化

7.3.1 gpioX/direction

可以向direction伪文件写入以下值来配置GPIO：
| Value | Meaning |
| ---- | ---- |
| in | The GPIO port is an input. |
| out | The GPIO port is an output. |
| high | Configure as output and output a high to the port. |
| low | Configure as output and output a low to the port. |

例如，将gpio17配置为输出引脚：

# echo out > /sys/class/gpio/gpio17/direction
# cat /sys/class/gpio/gpio17/direction
out

也可以使用direction伪文件一步配置GPIO为输出并设置其值：

# echo high > /sys/class/gpio/gpio17/direction
# echo low > /sys/class/gpio/gpio17/direction

7.3.2 gpioX/value

可以向value伪文件写入1或0来设置GPIO的值。当GPIO设置为输出模式时，写入高电平（1）可以点亮连接到GPIO17的LED：

# echo 1 > /sys/class/gpio/gpio17/value

读取输入时，会返回1或0。写入低电平（0）可以关闭LED：

# echo 0 > /sys/class/gpio/gpio17/value

7.3.3 gpioX/active_low

有时信号的极性不方便，可以使用active_low伪文件改变信号的逻辑感测。例如：

# cat /sys/class/gpio/gpio17/active_low
0
# echo 1 > /sys/class/gpio/gpio17/active_low
# cat /sys/class/gpio/gpio17/active_low
1

将逻辑感测从高电平有效改为低电平有效后，写入1会关闭LED，写入0会点亮LED。

7.3.4 gpioX/edge和gpioX/uevent

一些应用程序需要检测GPIO的变化。可以向edge伪文件写入以下值：
| Value | Meaning |
| ---- | ---- |
| none | No edge detection. |
| rising | Detect a rising signal change. |
| falling | Detect a falling signal change. |
| both | Detect a rising or falling signal change. |

例如，将gpio17配置为输入并检测上升和下降信号变化：

# echo in > /sys/class/gpio/gpio17/direction
# echo both > /sys/class/gpio/gpio17/edge
# cat /sys/class/gpio/gpio17/edge
both

配置完成后，可以使用uevent伪文件检查变化，但这需要使用C/C++程序，并使用poll(2)或select(2)来获取通知。当使用poll(2)时，请求事件POLLPRI和POLLERR；当使用select(2)时，应将文件描述符放入异常集。不幸的是，uevent文件对shell程序员没有帮助。

树莓派GPIO硬件与Sysfs GPIO使用指南

8. 总结与注意事项

树莓派的GPIO具有丰富的功能和灵活性，涵盖了驱动能力、上拉电阻和替代功能等多方面。但在使用过程中，也有诸多需要注意的要点。

• 电压和电流限制 ：输入引脚电压要控制在0 - 3.3V，避免过电压损坏芯片；输出引脚要做好电流限制，防止短路造成永久损坏。
• LED驱动 ：不同颜色LED的正向电压降不同，需合理计算限流电阻，确保LED正常工作且不超出树莓派驱动电流限制。
• 逻辑接口 ：连接逻辑电路时，输出电压要严格符合VIL和VIH要求，防止信号模糊。
• GPIO配置 ：根据实际需求选择合适的GPIO功能（输入、输出或替代功能），并正确配置相关参数。

9. 操作流程总结

为了更清晰地展示树莓派GPIO的使用步骤，以下为大家梳理了操作流程：

graph LR
    A[开始] --> B[确定GPIO功能需求]
    B --> C{功能类型}
    C -->|输入| D[配置输入引脚参数]
    C -->|输出| E[配置输出引脚参数]
    C -->|替代功能| F[选择合适替代功能]
    D --> G[检测信号变化配置]
    E --> H[确定输出状态和逻辑感测]
    E --> I{是否驱动LED}
    I -->|是| J[计算限流电阻并连接]
    I -->|否| K[直接连接负载]
    F --> L[根据外设类型微调配置]
    G --> M[接收输入信号数据]
    H --> N[设置输出值]
    J --> O[测试LED点亮情况]
    K --> P[测试负载工作情况]
    L --> Q[测试外设功能]
    M --> R[结束]
    N --> R
    O --> R
    P --> R
    Q --> R

10. 常见问题及解决方法

在使用树莓派GPIO过程中，可能会遇到一些常见问题，下面为大家列出并给出解决方法：

11. 扩展应用思路

树莓派GPIO的应用场景广泛，除了上述提到的基本应用，还可以进行更多的扩展。

• 智能家居控制 ：通过GPIO连接各种传感器（如温度传感器、湿度传感器）和执行器（如继电器、电机），实现家居设备的自动化控制。
• 机器人开发 ：利用GPIO控制机器人的运动、传感器数据采集等，打造个性化的机器人。
• 数据采集系统 ：连接各种数据采集设备，将采集到的数据传输到树莓派进行处理和分析。

12. 后续学习建议

如果你希望深入学习树莓派GPIO的使用，可以从以下几个方面入手：

• 学习编程语言 ：掌握Python、C/C++等编程语言，以便编写更复杂的控制程序。
• 阅读官方文档 ：深入了解树莓派的硬件特性和驱动程序的使用方法。
• 实践项目 ：通过实际项目的练习，加深对GPIO的理解和应用能力。

总之，树莓派GPIO为我们提供了一个强大而灵活的硬件接口，通过合理的使用和配置，可以实现各种有趣的应用。希望大家在学习和实践过程中，不断探索和创新，开发出更多有价值的项目。