龙芯2K0300实战：用C语言和Bash脚本玩转GPIO，实现流水灯与远程控制
嵌入式开发的世界里，硬件与软件的完美结合总能带来令人兴奋的成果。今天我们将深入探索龙芯2K0300开发板的GPIO控制，通过两种截然不同的方式——Bash脚本和C语言程序，来实现LED流水灯效果，并借助MobaXterm实现远程部署与控制。这不仅是一次技术实践，更是一场理解Linux系统底层硬件交互原理的绝佳机会。
1. 龙芯2K0300开发环境搭建
在开始GPIO编程之前，我们需要先搭建好开发环境。龙芯2K0300采用LoongArch架构，这意味着我们需要配置交叉编译环境才能在x86主机上为这块开发板生成可执行文件。
1.1 交叉编译工具链配置
首先需要获取龙芯官方提供的交叉编译工具链。这个工具链包含了针对LoongArch架构的GCC编译器、链接器等必要工具。
# 解压工具链到/opt目录 sudo tar -xvf loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.3-1.tar.xz -C /opt # 将工具链路径添加到环境变量 echo 'export PATH=/opt/loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.3-1/bin:$PATH' >> ~/.bashrc source ~/.bashrc验证工具链是否安装成功：
loongarch64-linux-gnu-gcc --version如果看到类似以下的输出，说明工具链配置正确：
loongarch64-linux-gnu-gcc (GCC) 8.3.0 Copyright (C) 2018 Free Software Foundation, Inc.1.2 开发板连接与文件传输
龙芯2K0300开发板通常通过串口或SSH连接。我们推荐使用MobaXterm作为终端工具，它集成了SSH客户端和SFTP文件传输功能，非常适合嵌入式开发。
连接步骤：
- 通过网线将开发板连接到与主机相同的局域网
- 在路由器管理界面查找开发板的IP地址
- 在MobaXterm中新建SSH会话，输入开发板IP地址
- 使用默认凭据登录（通常用户名/密码为loongson/loongson）
成功连接后，你可以通过MobaXterm的SFTP面板直接将编译好的程序拖拽到开发板上，极大简化了部署流程。
2. GPIO子系统基础与引脚映射
龙芯2K0300的GPIO控制通过Linux标准的sysfs接口实现，这为我们提供了统一的硬件访问方式，无需编写专门的设备驱动。
2.1 GPIO sysfs接口详解
在Linux系统中，GPIO通过/sys/class/gpio目录下的虚拟文件系统进行控制。主要操作文件包括：
- export：写入GPIO编号来启用对应引脚
- unexport：写入GPIO编号来禁用对应引脚
- gpioX/direction：设置引脚方向（in/out）
- gpioX/value：读取或设置引脚电平（0/1）
- gpioX/edge：配置中断触发方式（none/rising/falling/both）
2.2 龙芯2K0300 GPIO引脚映射
每个GPIO引脚在开发板上都有特定的物理位置和功能。以LS2K0300久久派开发板为例：
| GPIO编号 | 物理引脚 | 复用功能1 | 复用功能2 |
|---|---|---|---|
| 64 | 21 | GPIO64 | SPI_CLK |
| 65 | 25 | GPIO65 | SPI_CS |
| 66 | 27 | GPIO66 | SPI_MISO |
| 67 | 23 | GPIO67 | SPI_MOSI |
重要提示：在使用GPIO前，务必查阅开发板原理图，确认引脚没有与其他功能冲突，特别是复用功能引脚。
3. Bash脚本实现GPIO控制
Bash脚本是快速验证GPIO功能的绝佳工具，它无需编译，修改后立即生效，非常适合原型开发。
3.1 单LED闪烁脚本
下面是一个简单的Bash脚本示例，控制单个LED闪烁：
#!/bin/bash # 定义GPIO引脚 LED_GPIO=83 # 导出GPIO echo $LED_GPIO > /sys/class/gpio/export echo "out" > /sys/class/gpio/gpio$LED_GPIO/direction # 循环控制LED while true; do echo 1 > /sys/class/gpio/gpio$LED_GPIO/value # LED亮 sleep 0.5 echo 0 > /sys/class/gpio/gpio$LED_GPIO/value # LED灭 sleep 0.5 done # 退出时清理（这行不会被执行，需要手动操作） echo $LED_GPIO > /sys/class/gpio/unexport使用说明：
- 将脚本保存为led_blink.sh
- 赋予执行权限：
chmod +x led_blink.sh - 运行脚本：
./led_blink.sh - 按Ctrl+C停止脚本
3.2 四路流水灯实现
扩展上面的脚本，我们可以实现更复杂的流水灯效果：
#!/bin/bash # 定义GPIO引脚数组 GPIO_PINS=(64 65 66 67) # 初始化所有GPIO for pin in ${GPIO_PINS[@]}; do echo $pin > /sys/class/gpio/export echo "out" > /sys/class/gpio/gpio$pin/direction echo 1 > /sys/class/gpio/gpio$pin/value # 初始状态为灭 done # 流水灯效果 while true; do for pin in ${GPIO_PINS[@]}; do echo 0 > /sys/class/gpio/gpio$pin/value # 点亮当前LED sleep 0.2 echo 1 > /sys/class/gpio/gpio$pin/value # 熄灭当前LED done done # 清理代码（需要手动执行） for pin in ${GPIO_PINS[@]}; do echo $pin > /sys/class/gpio/unexport done提示：Bash脚本虽然方便，但在处理复杂逻辑或需要精确时序控制时性能有限。对于更专业的应用，建议使用C语言实现。
4. C语言实现高效GPIO控制
C语言提供了更高效的GPIO控制方式，适合生产环境部署。我们将从基础的单引脚控制开始，逐步构建完整的流水灯程序。
4.1 基础GPIO操作函数
首先封装一组基本的GPIO操作函数，提高代码复用性：
#include <stdio.h> #include <stdlib.h> #include <unistd.h> #include <fcntl.h> #include <string.h> #define GPIO_PATH "/sys/class/gpio" #define MAX_BUF 64 int gpio_export(int pin) { char path[MAX_BUF]; snprintf(path, MAX_BUF, "%s/export", GPIO_PATH); int fd = open(path, O_WRONLY); if (fd < 0) { perror("Failed to open export file"); return -1; } char buf[MAX_BUF]; snprintf(buf, MAX_BUF, "%d", pin); if (write(fd, buf, strlen(buf)) < 0) { perror("Failed to export GPIO"); close(fd); return -1; } close(fd); return 0; } int gpio_unexport(int pin) { char path[MAX_BUF]; snprintf(path, MAX_BUF, "%s/unexport", GPIO_PATH); int fd = open(path, O_WRONLY); if (fd < 0) { perror("Failed to open unexport file"); return -1; } char buf[MAX_BUF]; snprintf(buf, MAX_BUF, "%d", pin); if (write(fd, buf, strlen(buf)) < 0) { perror("Failed to unexport GPIO"); close(fd); return -1; } close(fd); return 0; } int gpio_set_direction(int pin, const char *direction) { char path[MAX_BUF]; snprintf(path, MAX_BUF, "%s/gpio%d/direction", GPIO_PATH, pin); int fd = open(path, O_WRONLY); if (fd < 0) { perror("Failed to open direction file"); return -1; } if (write(fd, direction, strlen(direction)) < 0) { perror("Failed to set GPIO direction"); close(fd); return -1; } close(fd); return 0; } int gpio_set_value(int pin, int value) { char path[MAX_BUF]; snprintf(path, MAX_BUF, "%s/gpio%d/value", GPIO_PATH, pin); int fd = open(path, O_WRONLY); if (fd < 0) { perror("Failed to open value file"); return -1; } char buf[MAX_BUF]; snprintf(buf, MAX_BUF, "%d", value); if (write(fd, buf, strlen(buf)) < 0) { perror("Failed to set GPIO value"); close(fd); return -1; } close(fd); return 0; }4.2 完整流水灯程序
基于上面的基础函数，我们可以构建一个完整的流水灯程序：
#include "gpio_utils.h" // 假设上面的函数放在这个头文件中 #define NUM_LEDS 4 const int led_pins[NUM_LEDS] = {64, 65, 66, 67}; void initialize_leds() { for (int i = 0; i < NUM_LEDS; i++) { if (gpio_export(led_pins[i]) < 0) { fprintf(stderr, "Failed to export GPIO %d\n", led_pins[i]); exit(1); } if (gpio_set_direction(led_pins[i], "out") < 0) { fprintf(stderr, "Failed to set direction for GPIO %d\n", led_pins[i]); exit(1); } // 初始状态：所有LED熄灭 gpio_set_value(led_pins[i], 1); } } void cleanup_leds() { for (int i = 0; i < NUM_LEDS; i++) { gpio_set_value(led_pins[i], 1); // 熄灭LED gpio_unexport(led_pins[i]); } } void water_flow_effect(int delay_ms) { while (1) { for (int i = 0; i < NUM_LEDS; i++) { gpio_set_value(led_pins[i], 0); // 点亮当前LED usleep(delay_ms * 1000); gpio_set_value(led_pins[i], 1); // 熄灭当前LED } } } int main() { // 设置信号处理，确保程序退出时清理GPIO signal(SIGINT, [](int sig) { cleanup_leds(); exit(0); }); initialize_leds(); water_flow_effect(200); // 200ms延迟 return 0; // 实际上不会执行到这里 }编译这个程序需要使用龙芯交叉编译工具链：
loongarch64-linux-gnu-gcc -o led_water led_water.c然后将生成的可执行文件传输到开发板上运行：
./led_water按Ctrl+C可以优雅地停止程序，所有GPIO会被正确释放。
5. 进阶：远程控制与自动化部署
在实际开发中，我们经常需要远程控制和监控开发板的状态。下面介绍几种提升开发效率的方法。
5.1 基于SSH的远程控制
通过SSH，我们可以直接在主机上执行开发板上的命令：
# 执行单个命令 ssh loongson@192.168.1.100 "./led_water" # 交互式会话 ssh loongson@192.168.1.1005.2 自动化部署脚本
创建一个自动化部署脚本，实现编译、传输和运行一条龙服务：
#!/bin/bash # 编译 loongarch64-linux-gnu-gcc -o led_water led_water.c # 传输到开发板 scp led_water loongson@192.168.1.100:~ # 在开发板上运行 ssh loongson@192.168.1.100 "./led_water"5.3 GPIO状态监控
我们可以编写一个简单的监控脚本，实时显示GPIO状态：
#!/bin/bash GPIO_PINS=(64 65 66 67) while true; do clear echo "GPIO状态监控 (按Ctrl+C退出)" echo "---------------------------" for pin in ${GPIO_PINS[@]}; do value=$(cat /sys/class/gpio/gpio$pin/value 2>/dev/null || echo "N/A") echo "GPIO$pin: $value" done sleep 0.5 done6. 性能优化与错误处理
在实际应用中，我们需要考虑程序的健壮性和性能。下面是一些优化建议。
6.1 文件操作优化
频繁打开/关闭GPIO值文件会影响性能。我们可以改为打开文件后保留文件描述符：
typedef struct { int pin; int value_fd; } GPIOHandle; GPIOHandle gpio_setup(int pin, const char *direction) { GPIOHandle handle; handle.pin = pin; // 导出GPIO和设置方向（同上） gpio_export(pin); gpio_set_direction(pin, direction); // 打开value文件并保留文件描述符 char path[MAX_BUF]; snprintf(path, MAX_BUF, "%s/gpio%d/value", GPIO_PATH, pin); handle.value_fd = open(path, O_WRONLY); if (handle.value_fd < 0) { perror("Failed to open value file"); exit(1); } return handle; } void gpio_write(GPIOHandle handle, int value) { char buf[2] = {value ? '1' : '0', '\0'}; if (write(handle.value_fd, buf, 1) < 0) { perror("Failed to write GPIO value"); } } void gpio_cleanup(GPIOHandle handle) { close(handle.value_fd); gpio_unexport(handle.pin); }6.2 错误处理与日志记录
完善的错误处理能极大提高程序可靠性：
#include <syslog.h> void init_logging() { openlog("gpio_control", LOG_PID|LOG_CONS, LOG_USER); } void log_error(const char *message) { syslog(LOG_ERR, "%s", message); fprintf(stderr, "ERROR: %s\n", message); } // 使用示例 int main() { init_logging(); GPIOHandle led = gpio_setup(64, "out"); if (led.value_fd < 0) { log_error("Failed to initialize LED GPIO"); return 1; } // ...程序逻辑... gpio_cleanup(led); closelog(); return 0; }6.3 多线程控制
对于需要同时控制多个LED的复杂场景，可以考虑使用多线程：
#include <pthread.h> typedef struct { GPIOHandle handle; int interval_ms; } ThreadData; void *blink_led(void *arg) { ThreadData *data = (ThreadData *)arg; while (1) { gpio_write(data->handle, 0); usleep(data->interval_ms * 1000); gpio_write(data->handle, 1); usleep(data->interval_ms * 1000); } return NULL; } int main() { pthread_t threads[4]; ThreadData data[4]; int pins[] = {64, 65, 66, 67}; int intervals[] = {200, 300, 400, 500}; // 不同频率 for (int i = 0; i < 4; i++) { data[i].handle = gpio_setup(pins[i], "out"); data[i].interval_ms = intervals[i]; pthread_create(&threads[i], NULL, blink_led, &data[i]); } // 主线程等待 for (int i = 0; i < 4; i++) { pthread_join(threads[i], NULL); } return 0; }7. 实际应用案例扩展
掌握了GPIO控制的基础后，我们可以将这些技术应用到更复杂的场景中。
7.1 结合传感器输入
通过添加传感器，我们可以创建响应环境的智能灯光系统。例如，使用光敏电阻控制LED亮度：
// 假设光敏电阻连接到GPIO68（需要配置为输入） GPIOHandle sensor = gpio_setup(68, "in"); while (1) { char buf[2]; lseek(sensor.value_fd, 0, SEEK_SET); read(sensor.value_fd, buf, 1); int light_level = buf[0] - '0'; // 根据光照水平调整LED亮度（PWM实现） adjust_led_brightness(light_level); sleep(1); }7.2 网络控制接口
创建一个简单的HTTP服务器，允许通过网络控制LED：
# 这是一个Python示例，展示如何结合GPIO控制和网络接口 from flask import Flask import os app = Flask(__name__) @app.route('/led/<int:pin>/<int:state>') def control_led(pin, state): os.system(f"echo {state} > /sys/class/gpio/gpio{pin}/value") return f"GPIO{pin} set to {state}" if __name__ == '__main__': # 初始化GPIO for pin in [64, 65, 66, 67]: os.system(f"echo {pin} > /sys/class/gpio/export") os.system(f"echo out > /sys/class/gpio/gpio{pin}/direction") app.run(host='0.0.0.0', port=8080)7.3 与OpenCV结合实现视觉反馈
结合摄像头和OpenCV库，我们可以创建根据视觉输入变化的灯光效果：
#include <opencv2/opencv.hpp> // 初始化摄像头 cv::VideoCapture cap(0); if (!cap.isOpened()) { std::cerr << "无法打开摄像头" << std::endl; return -1; } cv::Mat frame; while (cap.read(frame)) { // 计算图像平均亮度 cv::Mat gray; cv::cvtColor(frame, gray, cv::COLOR_BGR2GRAY); double brightness = cv::mean(gray)[0]; // 根据亮度控制LED int led_state = (brightness > 128) ? 1 : 0; gpio_set_value(64, led_state); // 显示图像 cv::imshow("Frame", frame); if (cv::waitKey(10) == 27) break; // ESC退出 }这个例子展示了如何将GPIO控制与计算机视觉结合，创造出更智能的交互系统。
