当前位置：首页 > news >正文

龙芯久久派开发入门：从环境搭建到GPIO点灯实战

news 2026/6/16 3:28:31

1. 项目概述：从“点灯”开始，走进龙芯久久派的世界

如果你刚拿到一块龙芯久久派开发板，看着这块搭载了国产龙芯2K0300处理器的精致板卡，心里既兴奋又有点无从下手，那么“点灯”就是你最好的起点。这几乎是所有嵌入式开发者的“Hello World”，一个看似简单的动作，背后却串联起了从硬件认知、环境搭建、到代码编写、系统交互的完整开发链条。对于久久派这样一款基于龙芯自主指令集架构（LoongArch）的开发板，这个过程更是理解其独特生态的绝佳入口。

龙芯2K0300是龙芯中科推出的面向嵌入式领域的高性价比处理器，而久久派则是围绕它打造的一款功能丰富的开源硬件平台。它不仅仅是一块开发板，更是我们接触、学习和应用龙芯技术栈的桥梁。通过控制一颗LED灯的亮灭，我们将亲手触摸到LoongArch指令集的脉搏，理解如何在龙芯的Loongnix或LoongOS系统上进行应用开发，并掌握其特有的交叉编译与调试方法。这远不止是让一个灯闪烁，而是开启一扇门，门后是物联网、边缘计算、工业控制等众多基于自主核心技术的应用场景。

2. 久久派开发环境全解析与搭建

在点亮LED之前，我们必须把“战场”准备好。与常见的ARM架构开发板（如树莓派、STM32）不同，龙芯久久派使用的是LoongArch架构，这意味着我们通常的x86或ARM电脑无法直接编译出能在它上面运行的程序。因此，搭建一个高效的交叉编译环境是第一步，也是最关键的一步。

2.1 硬件准备与连接

首先，确保你手头的久久派板卡和必要的周边设备已经就位。我建议你按照以下清单核对：

久久派开发板：确认型号，通常为标准版或带无线模块的版本。
电源适配器：推荐使用5V/2A或更高规格的Type-C电源。供电不足可能导致板子运行不稳定，尤其是在连接外设时。
MicroSD卡：容量16GB或以上，Class10或U1速度等级。这是系统的“硬盘”，非常重要。
USB转TTL串口模块：这是初期调试和登录系统的生命线。久久派板载了调试串口（通常是UART0），你需要一个像CH340、CP2102这类常见的模块。
杜邦线：用于连接串口模块和久久派的调试串口针脚（TX、RX、GND）。
网线（可选但推荐）：用于有线网络连接，比Wi-Fi初始配置更稳定。
LED和电阻：为了“点灯”实验，你需要一个发光二极管（LED）和一个220Ω至1kΩ的限流电阻。当然，久久派板载可能已经有用户LED，但外接一个能让你更清晰地理解GPIO操作。

连接串口是关键步骤。将USB转TTL模块的TX引脚连接到久久派调试串口的RX引脚，RX连接久久派的TX，GND对接GND。切记不要接错，更不要将VCC接到板子上，以免损坏设备。在电脑上使用终端软件（如Windows的Putty、MobaXterm，或macOS/Linux的screen、minicom）连接对应的串口端口，波特率通常设置为115200，数据位8，停止位1，无奇偶校验。

2.2 系统镜像烧录与启动

久久派通常运行Loongnix（基于Linux）或LoongOS。官方资料汇集帖（如网络资料中提到的）提供了系统镜像的下载链接。你需要：

从百度网盘或Git仓库下载最新的系统镜像文件（通常是.img或.iso格式）。
使用烧录工具（如Raspberry Pi Imager,balenaEtcher, 或dd命令）将镜像写入MicroSD卡。
将烧录好的SD卡插入久久派，连接串口和电源。

上电后，在串口终端里你将看到系统的启动日志。首次启动可能需要一些时间进行初始化。成功启动后，你会看到登录提示符。默认的登录用户名和密码通常是loongson或root，具体请查阅你下载的镜像说明文档。

注意：烧录镜像会清空SD卡所有数据，请提前备份。确保使用可靠的烧录工具，并验证烧录完整性，避免因镜像损坏导致无法启动。

2.3 交叉编译工具链部署

这是LoongArch开发的核心环节。因为我们的开发主机（Host）多是x86_64架构，而目标板（Target）是LoongArch64架构，所以需要交叉编译工具链。

根据网络资料，官方提供的工具链下载链接为：http://ftp.loongnix.cn/toolchain/gcc/release/loongarch/gcc8/loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.3-1.tar.xz。

在你的开发主机（以Ubuntu为例）上，可以按以下步骤操作：

# 1. 下载工具链（也可以先在浏览器下载，再传到主机） wget http://ftp.loongnix.cn/toolchain/gcc/release/loongarch/gcc8/loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.3-1.tar.xz # 2. 解压到合适目录，例如 /opt sudo tar -xJf loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.3-1.tar.xz -C /opt # 3. 将工具链路径添加到系统环境变量 echo 'export PATH=/opt/loongson-gnu-toolchain-8.3-x86_64-loongarch64-linux-gnu-rc1.3/bin:$PATH' >> ~/.bashrc source ~/.bashrc # 4. 验证安装 loongarch64-linux-gnu-gcc --version

如果安装成功，命令会输出gcc的版本信息，并且明确显示Target: loongarch64-linux-gnu。至此，你的开发主机就具备了为久久派编译程序的能力。

2.4 本地开发与远程调试环境配置

为了提高效率，我强烈建议配置SSH和网络文件系统（如NFS）。

配置网络：通过串口登录久久派，使用ifconfig或ip addr查看网络接口。如果有线网口（如eth0）已连接，它可能会通过DHCP自动获取IP。你也可以手动配置。更便捷的方式是配置Wi-Fi（如果板子支持），资料中的B站视频链接提供了相关教程。
启用SSH：大多数Linux镜像默认已安装SSH服务器。使用systemctl start ssh启动服务，systemctl enable ssh设置开机自启。然后就可以在开发主机上通过ssh username@板子IP远程登录了，告别串口终端。
搭建NFS（可选但高效）：在开发主机上搭建NFS服务器，将代码目录共享出来。在久久派上挂载这个NFS共享目录。这样，你可以在主机上编辑代码，直接在共享目录里编译，然后在板子上运行，无需反复拷贝文件，极大提升迭代速度。

3. “点灯”实战：从硬件原理到代码实现

环境就绪，现在让我们聚焦核心目标——控制GPIO点亮LED。我们将采用最直接、最能理解底层原理的方式：通过操作Linux系统的Sysfs GPIO接口。

3.1 硬件电路与GPIO引脚识别

首先，我们需要确定使用哪个GPIO引脚。你需要查阅久久派的原理图（资料帖中有提供）或板卡手册，找到可供用户使用的GPIO引脚及其对应的物理引脚号（例如，板载LED可能连接在GPIO12上）。为了演示，我们假设使用GPIO12来控制一个外接LED。

硬件连接很简单：将LED的正极（长脚）通过一个220Ω的限流电阻连接到GPIO12，LED的负极（短脚）连接到板子的GND（地）引脚。电阻必不可少，用于限制电流，保护GPIO口和LED。

在Linux系统中，GPIO号并不是物理引脚号，而是内核中的编号。有时需要根据芯片数据手册进行换算。对于久久派，一个简便的方法是查看系统中的GPIO映射。登录板子系统，可以查看/sys/class/gpio/目录，或者使用gpiod工具（如果已安装）来探测。

3.2 Sysfs GPIO控制方法详解

Linux Sysfs GPIO接口是一种经典的文件系统操作方式，非常直观。以下是在板子系统内部直接操作的步骤：

# 1. 导出GPIO引脚。假设我们要操作的GPIO在内核中的编号是12。 echo 12 > /sys/class/gpio/export # 执行后，会生成 /sys/class/gpio/gpio12 目录 # 2. 设置引脚方向为输出。 echo out > /sys/class/gpio/gpio12/direction # 3. 控制引脚电平，点亮LED。 echo 1 > /sys/class/gpio/gpio12/value # 输出高电平 # 等待一秒 sleep 1 # 熄灭LED echo 0 > /sys/class/gpio/gpio12/value # 输出低电平 # 4. 取消导出（操作完成后） echo 12 > /sys/class/gpio/unexport

这就是最基础的Shell脚本点灯。但我们的目标是在主机上编写C程序，交叉编译后传到板子上运行。

3.3 交叉编译C语言点灯程序

在开发主机上，创建一个名为blink.c的文件：

#include <stdio.h> #include <stdlib.h> #include <unistd.h> #include <fcntl.h> #include <string.h> #define GPIO_PIN "12" // 根据实际使用的GPIO号修改 #define GPIO_PATH "/sys/class/gpio/" #define GPIO_EXPORT GPIO_PATH "export" #define GPIO_UNEXPORT GPIO_PATH "unexport" #define GPIO_DIR GPIO_PATH "gpio" GPIO_PIN "/direction" #define GPIO_VAL GPIO_PATH "gpio" GPIO_PIN "/value" int write_to_file(const char *filename, const char *value) { int fd = open(filename, O_WRONLY); if (fd < 0) { perror("Failed to open file"); return -1; } if (write(fd, value, strlen(value)) < 0) { perror("Failed to write to file"); close(fd); return -1; } close(fd); return 0; } int main() { printf("Blinking LED on GPIO %s...\n", GPIO_PIN); // 1. 导出GPIO if (write_to_file(GPIO_EXPORT, GPIO_PIN) < 0) { fprintf(stderr, "Maybe GPIO %s already exported?\n", GPIO_PIN); // 继续尝试，不直接退出 } // 2. 设置为输出模式 if (write_to_file(GPIO_DIR, "out") < 0) { perror("Set direction failed"); return 1; } // 3. 闪烁10次 for (int i = 0; i < 10; i++) { // 点亮 if (write_to_file(GPIO_VAL, "1") < 0) { perror("Set high failed"); break; } sleep(1); // 熄灭 if (write_to_file(GPIO_VAL, "0") < 0) { perror("Set low failed"); break; } sleep(1); } // 4. 取消导出 (可选，系统重启后会自动清理) // write_to_file(GPIO_UNEXPORT, GPIO_PIN); printf("Done.\n"); return 0; }

使用我们之前安装的交叉编译工具链进行编译：

loongarch64-linux-gnu-gcc -static -o blink_loongarch blink.c

-static参数进行静态链接，将程序依赖的库都打包进可执行文件，这样可以避免板子系统上缺少某些动态库而无法运行的问题，对于简单的测试程序非常方便。

3.4 程序上传、执行与验证

将编译生成的blink_loongarch文件通过SCP命令传到久久派上：

scp blink_loongarch loongson@<板子IP>:~/

然后通过SSH登录板子，给程序添加执行权限并运行：

ssh loongson@<板子IP> chmod +x blink_loongarch sudo ./blink_loongarch # 操作GPIO通常需要root权限

如果一切顺利，你将看到LED开始闪烁，每秒一次，共10次。恭喜你，你已经成功在龙芯久久派上完成了第一个硬件控制程序！

实操心得：第一次操作时，最容易出错的地方是GPIO编号和权限。如果程序报错“Permission denied”，记得用sudo运行。如果提示“Device or resource busy”，可能是该GPIO已被系统其他驱动（比如LED触发器）占用，可以尝试换一个未使用的GPIO，或者先取消其他占用（如echo none > /sys/class/leds/xxx/trigger）。

4. 深入理解：GPIO操作的高级方式与框架

通过Sysfs操作GPIO虽然直观，但效率较低，且在现代Linux开发中，更推荐使用libgpiod库或直接进行内存映射（MMAP）操作。这对于追求高性能或需要精确时序控制的应用至关重要。

4.1 使用libgpiod库进行开发

libgpiod是Linux官方推荐的GPIO用户空间库，它提供了更简洁、更安全的API。首先，你需要在久久派系统上安装libgpiod的开发包（如果镜像未预装）：

sudo apt update sudo apt install libgpiod-dev libgpiod-doc

更常见的做法是，在交叉编译时，需要将主机的交叉编译工具链指向包含libgpiod头文件和库的路径，但这通常需要先在主机上为LoongArch架构交叉编译libgpiod库本身，过程较为复杂。一个更简单的方法是，直接在久久派系统上编译使用libgpiod的程序，这对于学习API是可行的。

一个使用libgpiod的简单点灯程序示例：

#include <gpiod.h> #include <stdio.h> #include <unistd.h> int main() { const char *chipname = "gpiochip0"; // GPIO控制器名称 struct gpiod_chip *chip; struct gpiod_line *line; int ret; // 打开GPIO芯片 chip = gpiod_chip_open_by_name(chipname); if (!chip) { perror("Open chip failed"); return 1; } // 获取GPIO线（假设偏移量为12，即GPIO12） line = gpiod_chip_get_line(chip, 12); if (!line) { perror("Get line failed"); gpiod_chip_close(chip); return 1; } // 请求将线设置为输出，初始低电平 ret = gpiod_line_request_output(line, "blink-example", 0); if (ret < 0) { perror("Request line as output failed"); gpiod_line_release(line); gpiod_chip_close(chip); return 1; } // 闪烁LED for (int i = 0; i < 10; i++) { gpiod_line_set_value(line, 1); sleep(1); gpiod_line_set_value(line, 0); sleep(1); } // 释放资源 gpiod_line_release(line); gpiod_chip_close(chip); return 0; }

在板子上用gcc编译运行即可。libgpiod的优势在于它更规范，支持更多高级功能（如事件监听），且不依赖缓慢的sysfs文件操作。

4.2 内存映射（MMAP）与寄存器直接操作

对于实时性要求极高的场景，比如生成精确的PWM波形，绕过操作系统内核，直接操作GPIO寄存器是最快的方式。这需要开发者深入了解龙芯2K0300芯片的寄存器手册，直接读写物理内存地址。

警告：此操作风险极高，不当操作可能导致系统崩溃或硬件损坏，仅适用于深度开发且清楚自己在做什么的开发者。

基本原理是：

打开/dev/mem设备文件。
使用mmap系统调用将GPIO控制器的物理内存地址映射到用户空间的虚拟地址。
通过指针操作这些映射后的地址，读写寄存器。

由于涉及具体芯片的寄存器地址和位域定义，代码与硬件强相关，此处不展开详细代码。但思路是：找到GPIO方向寄存器（如GPIO_DIR）和数据寄存器（如GPIO_DATA）的物理地址，通过计算偏移量控制特定引脚。

4.3 集成到应用框架：以LoongMui为例

网络资料中提到了“LoongMui”项目（Gitee链接）。这是一个为龙芯开发板（包括久久派）设计的图形界面或应用框架示例。对于更复杂的应用，比如你想做一个带图形界面控制LED的桌面程序，或者将GPIO控制嵌入到一个网络服务中，就需要考虑框架集成。

例如，在LoongMui或Qt for LoongArch这样的图形框架中，你可以将GPIO控制逻辑（通过libgpiod或系统调用封装）写成一个后台服务或一个类，然后由前端的按钮点击事件来触发。这标志着你的开发从简单的命令行测试，进入了真正的应用开发阶段。

5. 项目扩展与实战应用场景

成功点灯只是一个开始。基于这个基础，我们可以探索更多有趣且实用的项目，将久久派的能力真正发挥出来。

5.1 实现呼吸灯效果（PWM模拟）

久久派的GPIO本身可能不支持硬件PWM，但我们可以用软件模拟。原理是通过循环快速改变GPIO高低电平的占空比。

// 简化的软件PWM思路 void soft_pwm(int gpio_pin, int duty_cycle, int period_ms) { // duty_cycle: 占空比 (0-100) // period_ms: PWM周期（毫秒） int on_time = period_ms * duty_cycle / 100; int off_time = period_ms - on_time; // 这里需要实现微秒级延时（如usleep）来控制更平滑 // 点亮 set_gpio_high(gpio_pin); delay_ms(on_time); // 熄灭 set_gpio_low(gpio_pin); delay_ms(off_time); } // 在主循环中调用，并逐渐改变duty_cycle，即可实现呼吸效果。

通过改变一个周期内高电平的时间比例，就能调节LED的视觉亮度。虽然软件PWM精度和稳定性不如硬件，但对于指示灯效果绰绰有余。

5.2 结合传感器输入（如按键控制）

让LED与外界交互。例如，连接一个轻触开关到另一个GPIO引脚，并配置为输入模式。当检测到按键按下时，改变LED的状态（亮/灭/闪烁模式）。

// 伪代码 int led_pin = 12; int button_pin = 13; setup_gpio(led_pin, OUTPUT); setup_gpio(button_pin, INPUT_PULLUP); // 上拉输入 while(1) { if (read_gpio(button_pin) == LOW) { // 按键按下 toggle_gpio(led_pin); // 翻转LED状态 delay_ms(200); // 简单防抖 while(read_gpio(button_pin) == LOW); // 等待按键释放 delay_ms(200); } }

这就构成了一个最简单的输入-输出系统，是许多物联网设备的原型。

5.3 构建网络控制服务

这是将本地硬件能力开放到网络的关键一步。你可以在久久派上运行一个简单的Web服务器（如使用Python的Flask、Bottle框架，或C语言的mongoose库），创建一个HTTP API。

# 一个使用Flask的简单示例 (在久久派上运行) from flask import Flask, request import os app = Flask(__name__) LED_PATH = "/sys/class/gpio/gpio12/value" @app.route('/led/<state>') def control_led(state): if state in ['on', '1']: with open(LED_PATH, 'w') as f: f.write('1') return 'LED ON' elif state in ['off', '0']: with open(LED_PATH, 'w') as f: f.write('0') return 'LED OFF' else: return 'Invalid command' if __name__ == '__main__': app.run(host='0.0.0.0', port=8080)

运行这个脚本后，你在同一局域网的手机或电脑浏览器访问http://久久派IP:8080/led/on，就能远程点亮LED。这为智能家居、远程监控等应用打下了基础。

5.4 迈向更复杂的应用：与“YOLO”等AI应用的结合

网络热词中提到了“龙芯2k300 yolo”。龙芯2K300处理器具备一定的算力，足以运行轻量级的AI模型。你可以将“点灯”作为AI推理结果的输出端。例如：

在久久派上部署一个轻量级YOLO模型（如YOLOv5s，需要转换为适合LoongArch的推理框架，如ncnn、TNN等）。
使用USB摄像头（资料中提到了USB摄像头方案）采集图像。
运行模型进行目标检测。
当检测到特定目标（比如“人”）时，控制GPIO点亮LED作为报警指示。

这就完成了一个完整的“感知-思考-执行”的嵌入式AI边缘计算原型。虽然性能无法与高端GPU相比，但在很多低功耗、实时性要求的场景（如特定物体出现报警、简单分类任务）中非常有用。

6. 开发中的常见问题与深度排查指南

在龙芯久久派的开发过程中，你肯定会遇到各种问题。这里我总结了一些典型问题及其排查思路，希望能帮你少走弯路。

6.1 交叉编译工具链问题

问题：执行loongarch64-linux-gnu-gcc提示“未找到命令”或“Permission denied”。
- 排查：检查环境变量PATH是否正确设置。可以通过echo $PATH查看，或直接使用绝对路径/opt/工具链路径/bin/loongarch64-linux-gnu-gcc。确保解压后的bin目录下有该文件，并且有可执行权限。
问题：编译程序时提示“找不到头文件”或“链接库错误”。
- 排查：交叉编译时，如果需要链接第三方库（如libgpiod），你需要该库针对LoongArch架构的版本。通常需要自行交叉编译该库。对于简单的标准C库程序，使用-static静态链接可以避免大部分库依赖问题。

6.2 系统启动与串口连接问题

问题：上电后串口无任何输出。
- 排查：
  1. 电源：确认电源适配器功率足够（5V/2A+），Type-C线缆能传输数据和电力。
  2. 串口连接：再三检查TX/RX是否接反，GND是否连接。尝试交换TX和RX。
  3. 串口参数：确认波特率是否为115200，数据位8，停止位1，无校验，无流控。
  4. SD卡镜像：重新烧录官方提供的镜像，确保烧录过程无误。
  5. 硬件：尝试更换USB转TTL模块或USB端口。
问题：系统启动到一半卡住或报错。
- 排查：观察卡住前的最后几条日志信息。可能是文件系统损坏、内核不匹配或硬件驱动问题。尝试更换SD卡，或重新下载、烧录镜像。

6.3 GPIO控制失败问题

问题：执行echo 12 > export时提示Device or resource busy。
- 排查：该GPIO可能已被内核的其他子系统占用。常见于板载LED（其驱动可能以LED类设备注册）。你可以检查/sys/class/leds/目录下是否有对应的设备，并尝试将其触发器设置为none：echo none | sudo tee /sys/class/leds/xxx/trigger。或者，换一个原理图上标明未使用的GPIO引脚。
问题：能导出GPIO，但设置方向或值时提示Permission denied。
- 排查：操作/sys/class/gpio下的文件需要root权限。确保使用sudo执行你的程序或命令。在编写自启动服务时，也要注意权限问题。
问题：LED不亮，但程序似乎运行正常。
- 排查：
  1. 硬件连接：用万用表测量GPIO引脚在输出1时的电压，应为高电平（如3.3V）。检查LED极性是否接反，电阻阻值是否过大。
  2. GPIO编号：确认你操作的GPIO内核编号与物理引脚对应关系是否正确。最可靠的方法是查阅官方提供的引脚复用表。
  3. 引脚复用：有些GPIO引脚可能默认被配置为其他功能（如I2C、SPI）。需要查阅手册，确保在设备树（Device Tree）或内核启动参数中，该引脚被正确配置为GPIO功能。对于久久派，通常用户可用的GPIO已经是通用功能。

6.4 网络与远程访问问题

问题：无法通过SSH连接。
- 排查：
  1. IP地址：通过串口登录，用ip addr确认板子的IP地址。
  2. SSH服务：运行systemctl status ssh检查服务是否运行。如果没有安装，使用sudo apt install openssh-server安装。
  3. 防火墙：检查是否有防火墙规则阻止了SSH端口（默认22）。
  4. 网络连通性：在主机上ping板子的IP，确认网络层是通的。
问题：NFS挂载失败。
- 排查：首先确保主机NFS服务已启动且共享目录已正确导出（/etc/exports配置）。在板子上使用showmount -e <主机IP>查看可用的共享列表。挂载时注意权限，可以尝试在挂载命令中添加-o nolock参数解决某些锁服务问题。

6.5 性能与稳定性调优

当项目复杂后，你可能会关心性能。

Sysfs太慢：如前所述，对于高频操作，Sysfs是瓶颈。切换到libgpiod或内存映射方式。
系统负载：使用top或htop命令监控CPU和内存使用情况。如果运行AI应用，关注CPU各核心的利用率。龙芯2K300是多核处理器，确保你的应用能够利用多线程。
实时性：标准Linux内核并非实时操作系统。如果对GPIO翻转时序有微秒级精度要求，可以考虑使用内核的GPIO字符设备（/dev/gpiochipX）配合libgpiod，或者探索为内核打上PREEMPT_RT实时补丁的可能性（这需要自行编译内核，难度较高）。

开发龙芯久久派的过程，是一个不断遇到问题、查阅资料（善用官方论坛、QQ群和Git仓库）、动手尝试和解决问题的循环。每一次成功的点亮，不仅是一个LED，更是你对自主技术体系理解的一次点亮。从最基础的GPIO控制出发，你可以逐步深入到驱动开发、内核裁剪、应用部署，最终将它打造成满足你特定项目需求的强大工具。

查看全文

http://www.jsqmd.com/news/1020815/