Go语言在树莓派上操作GPIO：使用davecheney/gpio库实践指南-Golang-PHP中文网

Go语言在树莓派上操作GPIO：使用davecheney/gpio库实践指南

霞舞

发布： 2025-10-26 10:34:13

原创

709人浏览过

Go语言在树莓派上操作GPIO：使用davecheney/gpio库实践指南

本文旨在指导读者如何利用go语言在树莓派上进行gpio操作，重点介绍并推荐使用`davecheney/gpio`库。我们将探讨该库的安装、基本用法，并通过一个经典的led闪烁示例，展示如何设置引脚模式、读取和写入引脚状态，从而实现对树莓派硬件的有效控制。

树莓派GPIO与Go语言编程概述

树莓派的通用输入/输出（GPIO）引脚是其强大的硬件交互能力的核心。通过这些引脚，我们可以连接各种传感器、LED、继电器等外部设备，并利用软件进行控制和数据读取。对于Go语言开发者而言，选择一个功能强大且易于使用的GPIO库至关重要。davecheney/gpio正是这样一个优秀的选择，它提供了一套简洁的API，使得Go语言在树莓派上进行GPIO编程变得高效而直接。

推荐的Go语言GPIO库：davecheney/gpio

davecheney/gpio是由Dave Cheney开发的一个Go语言库，专注于提供树莓派GPIO的低级别、高性能访问。它抽象了底层的硬件寄存器操作，让开发者能够以更友好的方式控制引脚。无论是简单的数字信号输入输出，还是更复杂的时序控制，该库都能提供坚实的基础。

安装davecheney/gpio

在您的开发环境中（可以是树莓派本身，也可以是用于交叉编译的宿主机），您可以通过Go模块管理工具轻松安装此库：

go get github.com/davecheney/gpio

登录后复制

安装完成后，您就可以在Go项目中导入并使用它了。

立即学习“go语言免费学习笔记（深入）”；

交叉编译（针对非树莓派开发环境）

如果您在非树莓派设备上编写代码并希望部署到树莓派上运行，您需要进行交叉编译。这涉及到设置Go的环境变量GOOS和GOARCH：

# 例如，针对树莓派3B/4B (arm64)
export GOOS=linux
export GOARCH=arm64
go build -o your_program_name main.go

# 或者针对较旧的树莓派 (armv6/armv7)
export GOOS=linux
export GOARCH=arm
export GOARM=7 # 或 6
go build -o your_program_name main.go

登录后复制

编译完成后，将生成的可执行文件传输到树莓派上运行即可。

基本GPIO操作

davecheney/gpio库提供了直观的API来执行常见的GPIO操作：

打开引脚 (Open Pin)： 在使用任何GPIO引脚之前，需要先将其打开。库会根据BCM（Broadcom SOC channel）引脚编号来识别引脚。
设置引脚模式 (Set Pin Mode)： 引脚可以设置为输入模式（用于读取传感器数据）或输出模式（用于控制外部设备）。
读取引脚状态 (Read Pin State)： 当引脚设置为输入模式时，可以读取其当前状态（高电平或低电平）。
写入引脚状态 (Write Pin State)： 当引脚设置为输出模式时，可以设置其状态（高电平或低电平）来控制连接的设备。

示例代码：LED闪烁

最经典的GPIO示例莫过于LED闪烁。我们将通过一个Go程序来演示如何使用davecheney/gpio库控制一个连接到树莓派GPIO引脚的LED。

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

硬件连接： 将一个LED的长引脚（正极）通过一个220欧姆的限流电阻连接到树莓派的GPIO 18（BCM编号），短引脚（负极）连接到树莓派的任意GND（地）引脚。

Go语言代码 (blink.go):

package main

import (
    "fmt"
    "time"

    "github.com/davecheney/gpio" // 导入gpio库
)

func main() {
    // 定义要控制的GPIO引脚（BCM编号）
    // 例如，GPIO 18 (物理引脚12)
    pin := gpio.Pin(18)

    // 将引脚设置为输出模式
    // 错误处理是必要的，尤其是在硬件操作中
    err := pin.Output()
    if err != nil {
        fmt.Printf("Error setting pin %d to output mode: %v\n", pin, err)
        return
    }
    defer pin.Close() // 确保程序退出时关闭引脚，释放资源

    fmt.Printf("GPIO %d (BCM) configured as output. Starting LED blink...\n", pin)

    // 循环使LED闪烁
    for i := 0; i < 10; i++ { // 闪烁10次
        // 设置引脚为高电平，LED亮
        err = pin.Set()
        if err != nil {
            fmt.Printf("Error setting pin %d high: %v\n", pin, err)
            return
        }
        fmt.Println("LED ON")
        time.Sleep(500 * time.Millisecond) // 亮0.5秒

        // 设置引脚为低电平，LED灭
        err = pin.Clear()
        if err != nil {
            fmt.Printf("Error setting pin %d low: %v\n", pin, err)
            return
        }
        fmt.Println("LED OFF")
        time.Sleep(500 * time.Millisecond) // 灭0.5秒
    }

    fmt.Println("Blink sequence finished.")
}

登录后复制

运行程序：

将上述代码保存为 blink.go 文件。
在树莓派上打开终端，导航到文件所在目录。

编译并运行：

go run blink.go

登录后复制

或者先编译再运行（推荐）：

go build -o blinker blink.go
sudo ./blinker # 通常需要root权限来访问GPIO

登录后复制

您将看到连接到GPIO 18的LED以每秒一次的频率闪烁10次。

注意事项与进阶

权限问题： 通常，直接访问树莓派的GPIO需要root权限。因此，在运行Go程序时，您可能需要使用sudo命令。
引脚编号：davecheney/gpio库默认使用BCM（Broadcom SOC channel）引脚编号。请务必查阅您的树莓派型号的引脚图，以确定正确的BCM编号。例如，物理引脚12对应BCM GPIO 18。
错误处理： 在进行硬件操作时，错误处理至关重要。davecheney/gpio库的许多函数都返回error类型，务必检查并妥善处理这些错误，以提高程序的健壮性。
读取传感器数据： 对于读取简单的数字传感器（如按钮、限位开关或简单的数字温度传感器），您可以将引脚设置为输入模式，然后使用pin.Get()方法获取其状态。例如：
```
// ...
pin := gpio.Pin(23) // 假设传感器连接到GPIO 23
err := pin.Input()
if err != nil { /* handle error */ }
defer pin.Close()

for {
    state, err := pin.Get()
    if err != nil { /* handle error */ }
    if state == gpio.High {
        fmt.Println("Sensor HIGH (e.g., button pressed)")
    } else {
        fmt.Println("Sensor LOW (e.g., button released)")
    }
    time.Sleep(100 * time.Millisecond)
}
// ...
```
登录后复制
对于更复杂的传感器（如通过One-Wire协议的DS18B20，或I2C/SPI接口的传感器），可能需要结合其他Go库或自行实现协议解析。davecheney/gpio主要提供基础的数字IO能力。