RPi.GPIO 模塊程序包提供了一個在 Raspberry Pi 中控制 GPIO 的類。

注意，該模塊不適合應(yīng)用到追求實時性或計數(shù)周期的應(yīng)用中。這是由于您無法預(yù)測 Ptyhon 何時繁忙，以及資源回收的時間。而且它是運行在基于 Linux 核心的系統(tǒng)中，也不合適用于實時應(yīng)用 – 原因在于其它進(jìn)程可能獲得更高的 CPU 優(yōu)先級。如果您一定要追求實時操作的性能，可以考慮購買一塊 Arduino 主板!

還需要注意一點，目前的版本還不支持 Raspberry Pi 的 SPI、I2C、1-wire、串口等功能。計劃在不久的將來會實現(xiàn)的！

本文是 RPi.GPIO 模塊文檔系列文章的第一篇，除本文外還包括以下幾篇：

使用 RPi.GPIO 模塊的輸入（Input）功能
使用 RPi.GPIO 模塊的輸出（Output）功能
使用 RPi.GPIO 模塊的脈寬調(diào)制（PWM）功能

導(dǎo)入模塊

導(dǎo)入 RPi.GPIO 模塊：

通過該操作，您可以將模塊名稱映射為 GPIO，以便接下來您其它腳本進(jìn)行使用。

導(dǎo)入模塊并檢查它是否導(dǎo)入成功，可以嘗試：

針腳編號

目前有兩種方式可以通過 RPi.GPIO 對 Raspberry Pi 上的 IO 針腳進(jìn)行編號。

第一種方式是使用 BOARD 編號系統(tǒng)。該方式參考 Raspberry Pi 主板上 P1 接線柱的針腳編號。使用該方式的優(yōu)點是無需考慮主板的修訂版本，您硬件始終都是可用的狀態(tài)。您將無需從新連接線路和更改您的代碼。

第二種方式是使用 BCM 編號。這是一種較低層的工作方式 – 該方式參考 Broadcom SOC 的通道編號。使用過程中，您始終要保證主板上的針腳與圖表上標(biāo)注的通道編號相對應(yīng)。您的腳本可能在 Raspberry Pi 主板進(jìn)行修訂版本更新時無法工作。

指定您所使用的方式（必須指定）：

或者

警告

可能您的 Raspberry Pi 的 GPIO 上同時有多個腳本/循環(huán)。因此，如果 RPi.GPIO 檢測到某個針腳被設(shè)置為其它用途而非默認(rèn)的狀態(tài)（默認(rèn)為輸入），您會在嘗試配置某腳本時得到警告消息。

禁用該警告消息：

配置通道

您需要為每個用于輸入或輸出的針腳配置通道。

配置為輸入的通道：

（通道編號是基于您所使用的編號系統(tǒng)所指定的（BOARD 或 BCM）。）

更多關(guān)于輸入通道的進(jìn)階信息可以在這里找到。

配置為輸出的通道：

（通道編號是基于您所使用的編號系統(tǒng)所指定的（BOARD 或 BCM）。）

您還可以指定輸出通道的初始值：

輸入

讀取 GPIO 針腳的值：

（通道編號是基于您所使用的編號系統(tǒng)所指定的（BOARD 或 BCM）。）這將返回 0 / GPIO.LOW / False 或者 1 / GPIO.HIGH / True。

輸出

設(shè)置 GPIO 針腳的輸出狀態(tài)：

（通道編號是基于您所使用的編號系統(tǒng)所指定的（BOARD 或 BCM）。）

狀態(tài)可以為 0 / GPIO.LOW / False 或者 1 / GPIO.HIGH / True。

清理

在任何程序結(jié)束后，請養(yǎng)成清理用過的資源的好習(xí)慣。使用 RPi.GPIO 也同樣需要這樣。恢復(fù)所有使用過的通道狀態(tài)為輸入，您可以避免由于短路意外損壞您的 Raspberry Pi 針腳。注意，該操作僅會清理您的腳本使用過的 GPIO 通道。

在您的腳本結(jié)束后進(jìn)行清理：

Raspberry Pi 修訂版本和 RPi.GPIO 版本

檢測 Raspberry Pi 主板的修訂版本：

檢測 RPi.GPIO 的版本：