若该文为原创文章,转载请注明原文出处。
字符设备驱动程序的基本框架,主要是如何申请及释放设备号、添加以及注销设备,初始化、添加与删除 cdev 结构体,并通过 cdev_init 函数建立 cdev 和 file_operations 之间的关联,cdev 结构体和 file_operations 结构体。
使用的开发板是正点原子的ATK-DLRK3568.
一、查看原理图
通过查看原理图,得知LED控制引脚接到了 GPIO0_C0上,通过三极管控制LED,GPIO0_C0输出高电平,LED亮,输出低电平,LED灭。
二、GPIO介绍
GPIO(General Purpose Input/Output Port):通用输入输出端口。
除作为一般的输入/输出功能外,还可以配置为中断和模拟UART、CAN、PWM、I2C、SDMMC、CLK等功能。
比如 GPIO0_C0 这个 IO 就可以用 作:GPIO,PWM1_M0,GPU_AVS 和 UART0_RX 这四个功能,所以我们首先要设置好当前引 脚用作什么功能。
rk356x 系列对应的文档为:
• Rockchip_RK3568_TRM_Part1_xxx.pdf
• Rockchip_RK3566_Datasheet_xxx.pdf
• Rockchip_RK3568_Datasheet_xxx.pdf
1、GPIO分组
RK3568共160个GPIO引脚,复用型引脚分为 5 组 (GPIO0~4),每组里面都有 32 个复 用型引脚,而且又分为 4 个小组 (A、B、C、D),每个小组 8 个引脚 (0~7)。例如:GPIO0_C7 是 GPIO0 大组,第 3 个小组,第 8 个引脚。
要查找GPIO对应的配置寄存器地址,必须知道他属于哪个分组。
2、GPIO引脚号计算方法
pins = 32*bank_num + 8*group + x
bank_num : 0 ~ 4,对应GPIO 0~4
group : 0 ~ 3,对应GPIO A~D
GPIO0_C2 = 32*0(bank_num) + 8*2(group) + 0 = 16
根据计算GPIO0_C0序号为16。在后面驱动代码时会用到。
2、寄存器配置
这里以GPIO0_C0为例,查看Rockchip_RK3568_TRM_Part1手册可知,GPIO0 组复用功能是在 PMU_GRF 寄存器,实验中需要对 GPIO 进行配置,一般情况下需要对 GPIO 的复用寄存器,方向寄存器,数据寄存器进行配置, 和复用相关的总共 8 个寄存器。
1. 查找复用寄存器
2. 查找方向寄存器
通过寄存器描述,该寄存器有高 16bit 和低 16bit,高 16bit 控制低 16bit 的 写使能,低 16bit 控制 GPIO 的输出方向, 0:输入,1:输出。
GPIO0_C0属于 GPIO0 中 A-D 组总计 64 个引脚中的高 32 引脚范围,所以需要将 GPIO_SWPORT_DDR_H 寄存器的第 0bit 位和 16bit 位置 1,允许写 bit16。
Operational Base + offset = 0xFDD60000 + 0x000C = 0xFDD6000C
3. GPIO 引脚高低电平设置
GPIO_SWPORT_DR_L 和 GPIO_SWPORT_DR_H 寄存器有高 16bit 和低 16bit,高 16bit 控制低 16bit 的写 使能,低 16bit 控制 GPIO 的高低电平。
GPIO0_C0属于 GPIO0 中 A-D 组总计 64 个引脚 中高的 32 引脚范围,所以需要将 GPIO_SWPORT_DR_H 寄存器的第0bit 位和 16bit 位置 1。
4. 总结
GPIO 的基地址为 0xFDD60000,偏移地址为 0x000C,
GPIO 的基地址为 0xFDD60000,偏移地址为 0x0004,
三、驱动程序编写
1、编写led_cdev.c驱动文件
#include <linux/init.h>
#include <linux/module.h>
#include <linux/cdev.h>
#include <linux/fs.h>
#include <linux/uaccess.h>
#include <linux/io.h>
#define DEV_NAME "led_chrdev"
#define DEV_CNT (1)
#define GPIO0_BASE (0xfdd60000)
//每组GPIO,有2个寄存器,对应32个引脚,每个寄存器负责16个引脚;
//一个寄存器32位,其中高16位都是使能位,低16位对应16个引脚,每个引脚占用1比特位
#define GPIO0_DR_L (GPIO0_BASE + 0x0000)
#define GPIO0_DR_H (GPIO0_BASE + 0x0004)
#define GPIO0_DDR_L (GPIO0_BASE + 0x0008)
#define GPIO0_DDR_H (GPIO0_BASE + 0x000C)
static dev_t devno;
struct class *led_chrdev_class;
struct led_chrdev {
struct cdev dev;
unsigned int __iomem *va_dr; // 数据寄存器,设置输出的电压
unsigned int __iomem *va_ddr; // 数据方向寄存器,设置输入或者输出
unsigned int led_pin; // 偏移
};
/* 打开设备函数 */
static int led_chrdev_open(struct inode *inode, struct file *filp)
{
unsigned int val = 0;
struct led_chrdev *led_cdev = (struct led_chrdev *)container_of(inode->i_cdev, struct led_chrdev,dev);
filp->private_data = container_of(inode->i_cdev, struct led_chrdev, dev);
printk("open\n");
//设置输出模式
val = ioread32(led_cdev->va_ddr);
val |= ((unsigned int)0x1 << (led_cdev->led_pin+16));
val |= ((unsigned int)0X1 << (led_cdev->led_pin));
iowrite32(val,led_cdev->va_ddr);
//输出高电平
val = ioread32(led_cdev->va_dr);
val |= ((unsigned int)0x1 << (led_cdev->led_pin+16));
val |= ((unsigned int)0x1 << (led_cdev->led_pin));
iowrite32(val, led_cdev->va_dr);
return 0;
}
static int led_chrdev_release(struct inode *inode, struct file *filp)
{
return 0;
}
/* 从设备读取数据 */
static ssize_t led_chrdev_read(struct file *file, char __user *buf, size_t size, loff_t *off)
{
printk("This is led_chrdev_read\r\n");
return 0;
}
/* 向设备写入数据函数 */
static ssize_t led_chrdev_write(struct file *filp, const char __user * buf,
size_t count, loff_t * ppos)
{
unsigned long val = 0;
char ret = 0;
struct led_chrdev *led_cdev = (struct led_chrdev *)filp->private_data;
printk("write \n");
get_user(ret, buf);
val = ioread32(led_cdev->va_dr);
printk("val = %lx\n", val);
if (ret == '0' || ret == 0){
val |= ((unsigned int)0x1 << (led_cdev->led_pin+16));
val &= ~((unsigned int)0x01 << (led_cdev->led_pin)); /*设置GPIO引脚输出低电平*/
}
else{
val |= ((unsigned int)0x1 << (led_cdev->led_pin+16));
val |= ((unsigned int)0x01 << (led_cdev->led_pin)); /*设置GPIO引脚输出高电平*/
}
iowrite32(val, led_cdev->va_dr);
printk("val = %lx\n", val);
return count;
}
/* 设备操作函数 */
static struct file_operations led_chrdev_fops = {
.owner = THIS_MODULE, // 将 owner 字段指向本模块,可以避免在模块的操作正在被使用时卸载该模块
.open = led_chrdev_open, // 将 open 字段指向 chrdev_open(...)函数
.read = led_chrdev_read, // 将 open 字段指向 chrdev_read(...)函数
.write = led_chrdev_write, // 将 open 字段指向 chrdev_write(...)函数
.release = led_chrdev_release, // 将 open 字段指向 chrdev_release(...)函数
};
static struct led_chrdev led_cdev[DEV_CNT] = {
{.led_pin = 0}, //偏移,高16引脚,GPIO0_C0
};
/* 驱动入口函数 */
static __init int led_chrdev_init(void)
{
int i = 0;
dev_t cur_dev;
printk("led_chrdev init (lubancat2 GPIO0_C7)\n");
/*0 将物理地址转化为虚拟地址 */
led_cdev[0].va_dr = ioremap(GPIO0_DR_H, 4); //
led_cdev[0].va_ddr = ioremap(GPIO0_DDR_H, 4); //
/*1 创建设备号 */
alloc_chrdev_region(&devno, 0, DEV_CNT, DEV_NAME);
/*2 创建类 */
led_chrdev_class = class_create(THIS_MODULE, "led_chrdev");
for (; i < DEV_CNT; i++) {
/*3 初始化 cdev */
cdev_init(&led_cdev[i].dev, &led_chrdev_fops);
led_cdev[i].dev.owner = THIS_MODULE;
/*4 获取主设备号和次设备号 */
cur_dev = MKDEV(MAJOR(devno), MINOR(devno) + i);
/*5 添加一个 cdev,完成字符设备注册到内核 */
cdev_add(&led_cdev[i].dev, cur_dev, 1);
/*6 创建设备*/
device_create(led_chrdev_class, NULL, cur_dev, NULL, DEV_NAME "%d", i);
}
return 0;
}
/* 驱动出口函数 */
static __exit void led_chrdev_exit(void)
{
int i;
dev_t cur_dev;
printk("led chrdev exit (lubancat2 GPIO0_C7)\n");
/*注销字符设备*/
for (i = 0; i < DEV_CNT; i++) {
iounmap(led_cdev[i].va_dr); // 释放模式寄存器虚拟地址
iounmap(led_cdev[i].va_ddr); // 释放输出类型寄存器虚拟地址
}
for (i = 0; i < DEV_CNT; i++) {
cur_dev = MKDEV(MAJOR(devno), MINOR(devno) + i);
//删除设备
device_destroy(led_chrdev_class, cur_dev);
// 删除 cdev
cdev_del(&led_cdev[i].dev);
}
// 注销设备号
unregister_chrdev_region(devno, DEV_CNT);
// 删除类
class_destroy(led_chrdev_class);
}
module_init(led_chrdev_init);
module_exit(led_chrdev_exit);
MODULE_AUTHOR("yifeng");
MODULE_LICENSE("GPL");
总结:
模块加载
1、初始化 LED 灯结构体成员,将物理寄存器的地址映射到虚拟地址空间
2、向动态申请一个设备号
3、创建设备类
4、绑定 led_cdev 与 led_chrdev_fops
5、注册设备
6、创建设备
模块卸载
1、删除设备
2、注销设备
3、释放被占用的设备号
2、编写makefile
KERNELDIR := /home/alientek/rk3568_linux_sdk/kernel
ARCH=arm64
CROSS_COMPILE=/opt/atk-dlrk356x-toolchain/usr/bin/aarch64-buildroot-linux-gnu-
export ARCH CROSS_COMPILE
CURRENT_PATH := $(shell pwd)
obj-m := led_cdev.o
build: kernel_modules
kernel_modules:
$(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) modules
clean:
$(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) clean
编译
3、编写APP应用
ledApp.c
#include "stdio.h"
#include "unistd.h"
#include "sys/types.h"
#include "sys/stat.h"
#include "fcntl.h"
#include "stdlib.h"
#include "string.h"
#define LEDOFF 0
#define LEDON 1
/*
* @description : main主程序
* @param - argc : argv数组元素个数
* @param - argv : 具体参数
* @return : 0 成功;其他 失败
*/
int main(int argc, char *argv[])
{
int fd, retvalue;
char *filename;
unsigned char databuf[1];
if(argc != 3){
printf("Error Usage!\r\n");
return -1;
}
filename = argv[1];
/* 打开led驱动 */
fd = open(filename, O_RDWR);
if(fd < 0){
printf("file %s open failed!\r\n", argv[1]);
return -1;
}
databuf[0] = atoi(argv[2]); /* 要执行的操作:打开或关闭 */
/* 向/dev/led文件写入数据 */
retvalue = write(fd, databuf, sizeof(databuf));
if(retvalue < 0){
printf("LED Control Failed!\r\n");
close(fd);
return -1;
}
retvalue = close(fd); /* 关闭文件 */
if(retvalue < 0){
printf("file %s close failed!\r\n", argv[1]);
return -1;
}
return 0;
}
编译
/opt/atk-dlrk356x-toolchain/bin/aarch64-buildroot-linux-gnu-gcc ledApp.c -o ledApp
4、测试
测试有两个,一是直接测试,二是使用APP应用程序测试。
在测试前需要关闭心跳灯
echo none > /sys/class/leds/work/trigger
加载LED驱动:
insmod led_cdev.ko
测试方法一:
sh -c 'echo 0 >/dev/led_chrdev0'
sh -c 'echo 1 >/dev/led_chrdev0'
正点原子的LED是反的,所以1是亮,0是灭。
测试方法二:
./ledApp /dev/led 1 //打开 LED 灯
./ledApp /dev/led 0 //关闭 LED 灯
经实验,LED驱动工作正常。
卸载驱动:
rmmod led_cdev
如有侵权,或需要完整代码,请及时联系博主。