C-Periphery：让Linux嵌入式外围设备操作变得这么简单！

作者

引子

你有没有遇到过在Linux嵌入式开发中，想直接操作GPIO、LED、PWM、SPI、I2C、MMIO、Serial等硬件接口，却发现原生API复杂、繁琐、难以维护？或者每次都要写一堆底层代码，调试起来特别折腾？如果你也觉得这些问题困扰着你，那你一定要知道，这个名叫 c-periphery 的C库，能帮你轻松搞定这些硬件接口！

今天我就来详细介绍一下这个“神器”——c-periphery，它到底是什么？它解决了什么痛点？又怎么用？优缺点又有哪些？让我们一探究竟！

简单来说，c-periphery是个专为Linux嵌入式平台（比如树莓派、BeagleBone、NanoPi啥的）设计的小型C库，用来操作各种硬件外围接口的。它封装了Linux底层的接口，让你用几行代码就能轻松控制GPIO、LED、PWM、SPI、I2C、MMIO、Serial等设备。

它不像那些复杂的底层驱动，你不用写繁琐的IOCTL调用，也不用去和设备文件打交道。它把这些都封装成简单的API，让你专注于你的逻辑开发。

简单说，c-periphery就是你硬件“管家”工具箱，让这些硬件接口的操作变得像搭积木一样简单。

它解决了哪些痛点？

  1. 1. 繁琐的底层API：Linux的GPIO、SPI、I2C等接口都很底层，API繁琐，难以快速上手。c-periphery封装后，API清晰、简洁。

  2. 2. 跨平台性差：不同硬件平台底层差异大，使用c-periphery后，几乎无需关心底层差异，只需调用统一接口。

  3. 3. 依赖繁多：没有其他复杂依赖，只依赖标准C库和Linux，轻量、易集成。

  4. 4. 易用性差：没有封装的API，写底层代码很容易出错，调试也烦。c-periphery提供了友好的错误提示，让你调试变简单。

  5. 5. 多接口支持：一套API搞定多种硬件接口，节省开发时间。

  6. 6. 多语言扩展：除了C语言，还有Python、Lua、Java、Dart等封装版本，满足不同开发需求。

用它能做啥？实战示例告诉你！

GPIO（引脚控制）

#include <stdio.h>
#include <stdlib.h>
#include <stdbool.h>
#include "gpio.h"

intmain(){
gpio_t*gpio_in = gpio_new();
gpio_t*gpio_out = gpio_new();

// 打开GPIO引脚，线号为10，设置为输入
if(gpio_open(gpio_in,"/dev/gpiochip0",10, GPIO_DIR_IN)<0){
fprintf(stderr,"开输入GPIO失败：%s\n", gpio_errmsg(gpio_in));
return1;
}

// 打开GPIO线，线号为12，设置为输出
if(gpio_open(gpio_out,"/dev/gpiochip0",12, GPIO_DIR_OUT)<0){
fprintf(stderr,"开输出GPIO失败：%s\n", gpio_errmsg(gpio_out));
return1;
}

bool val;
if(gpio_read(gpio_in,&val)<0){
fprintf(stderr,"读取GPIO失败：%s\n", gpio_errmsg(gpio_in));
return1;
}
printf("读取到的输入值：%d\n", val);

// 将输出引脚写反
if(gpio_write(gpio_out,!val)<0){
fprintf(stderr,"写GPIO失败：%s\n", gpio_errmsg(gpio_out));
return1;
}

    gpio_close(gpio_in);
    gpio_close(gpio_out);
    gpio_free(gpio_in);
    gpio_free(gpio_out);
return0;
}

LED控制

#include <stdio.h>
#include <stdlib.h>
#include <stdbool.h>
#include "led.h"

intmain(){
led_t*led = led_new();
if(led_open(led,"led0")<0){
fprintf(stderr,"打开LED失败：%s\n", led_errmsg(led));
return1;
}

// 点亮LED
    led_write(led,true);
unsignedint max_brightness;
    led_get_max_brightness(led,&max_brightness);
printf("最大亮度：%u\n", max_brightness);

// 设置半亮
    led_set_brightness(led, max_brightness /2);
    led_close(led);
    led_free(led);
return0;
}

PWM调速

#include <stdio.h>
#include <stdlib.h>
#include "pwm.h"

int main(){
pwm_t *pwm = pwm_new();

if(pwm_open(pwm,0,10)<0){
fprintf(stderr,"打开PWM失败：%s\n", pwm_errmsg(pwm));
return 1;
}

    pwm_set_frequency(pwm,1000);// 1kHz
    pwm_set_duty_cycle(pwm,0.75);// 75%
    pwm_enable(pwm);

// 调整占空比
    pwm_set_duty_cycle(pwm,0.5);// 50%
    pwm_close(pwm);
    pwm_free(pwm);
return 0;
}

SPI通信

#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
#include "spi.h"

intmain(){
spi_t*spi = spi_new();
uint8_t buf[4]={0xAA,0xBB,0xCC,0xDD};

if(spi_open(spi,"/dev/spidev1.0",0,1000000)<0){
 fprintf(stderr,"打开SPI失败：%s\n", spi_errmsg(spi));
 return 1;
}

if(spi_transfer(spi, buf, buf,sizeof(buf))<0){
 fprintf(stderr,"SPI传输失败：%s\n", spi_errmsg(spi));
 return 1;
}

printf("返回数据：%02X %02X %02X %02X\n", buf[0], buf[1], buf[2], buf[3]);
    spi_close(spi);
    spi_free(spi);
return 0;
}

这些例子只是冰山一角，c-periphery还支持I2C、MMIO、Serial等接口，满足你各种硬件需求。

优缺点大揭秘

优点：

  • • 轻量级：只有标准C依赖，包体小，运行快

  • • 封装好用：API设计清晰，操作简单

  • • 跨平台：支持多种硬件平台

  • • 无依赖：没有额外依赖，容易集成

  • • 多语言支持：Python、Lua、Java、Dart都有封装版本

  • • 开源MIT许可证：自由使用、二次开发无压力

缺点：

  • • 功能相对基础：没有像专业驱动那样的高阶功能

  • • 性能可能有限：对于极端性能要求的场景，底层API可能更优

  • • 只适用于用户空间：无法直接操作内核驱动，限制在用户空间

总结

如果你正为嵌入式Linux开发找一个“好用、简单、封装良好”的硬件接口库，c-periphery绝对是个不错的选择！它帮你将繁琐的底层操作封装成简单的API，让你可以专注于开发逻辑，节省大量调试时间。

它支持多种外围接口，易于集成，无依赖，适合各种硬件平台，特别是树莓派、BeagleBone这类的单板机开发者。无论你是做物联网、机器人、还是各种硬件项目，c-periphery都能帮你事半功倍。

总之，想让Linux硬件操作变得so easy？试试c-periphery吧！

如果你想深入了解，可以访问项目地址：https://github.com/vsergeev/c-periphery


发表评论