linux驱动篇-Led

Led

本篇是linux下Led设备驱动,也是属于字符设备类的驱动,一起来动手吧。下面的话,老朋友可以跳过了直接从《需求描述》章节看起,新朋友可以试着看看。

特别说明:本系列教程可以配套《韦东山视频教程二期》,是韦老师教程的有益补充。

Csdn地址如下:

https://blog.csdn.net/chichi123137/article/details/89636184

前言

在嵌入式行业,有很多从业者。我们工作的主旋律是拿开源代码,拿厂家代码,完成产品的功能,提升产品的性能,进而解决各种各样的问题。或者是维护一个模块或方向,一搞就是好几年。

 

时间长了,中年润发现我们对从零开始编写驱动、应用、算法、系统、协议、文件系统等缺乏经验。没有该有的广度和深度。中年润也是这样,工作了很多年,都是针对某个问题点修修补补或者某个模块的局部删删改改。很少有机会去独自从零开始编写一整套完整的代码。

 

当然,这种现状对于企业来说是比较正常的,可以降低风险。但是对于员工本身,如果缺乏必要的规划,很容易工作多年却还是停留在单点的层面,而丧失了提升到较高层面的机会。随着时间的增长很容易丧失竞争力。

 

另外,根据中年润的经验,绝大多数公司对于0-5年经验从业者的定位主要是积极的问题解决者。而对于5-10经验从业者的定位主要是积极的系统规划者和引领者。在这种行业规则下,中年润认为,每个从业者都应该问自己一句,“5年后,我是否具备系统化把控软件的能力呢?”。

 

当前的这种行业现状,如果我们不做出一点改变,是没有办法突破的。有些东西,仅仅知道是不够的,还需要深思熟虑的思考和必要的训练,简单来说就是要知行合一。

 

也许有读者会有疑惑?这不就是重复造轮子么?我们确实是在重复造轮子,因为别人会造轮子那是别人的能力,我们自己会造轮子是我们自己的能力。在行业中,有太多的定制化需求是因为轮子本身有原生性缺陷,我们无法直接使用,或者需要对其进行改进,或者需要抽取开源代码的主体思想和框架,根据公司的需要定制自己的各项功能。设想,如果我们具备这种能力,必然会促使我们在行业中脱颖而出,而不是工作很多年一直在底层搬砖。底层搬砖没什么不好,问题是当有更廉价更激情的劳动力涌进来的时候,我们这些老的搬砖民工也就失去了价值。我们不会天天重复造轮子,我们需要通过造几个轮子使得自己具备造轮子的能力,从而更好的适应这个环境,适应这个世界。

 

针对当前行业现状,中年润经过深思熟虑,想为大家做点实实在在的事情,希望能够帮助大家在巩固基础的同时提升系统化把控软件的能力。当然,中年润的水平也有限,有些观点也只是一家之谈,希望大家独立思考,谨慎采用,如果写的有错误或者不对的地方还请读者们批评斧正,我们一起共同进步。

 

在这里简单介绍下中年润,中年润现在就职于一家大型国际化公司,工作经验6年,硕士毕业。曾经担任过组内的项目主管,项目经理,也曾经组建过新团队,带领大家冲锋陷阵。在工作中,有做的不错的地方,也有失误的地方,有激情的时刻,也有失落的时刻。现在偏安一隅,专心搞技术,目前个人规划的技术方向是嵌入式和AI基础设施建设,以及嵌入式和AI的融合发展。

 

最后,说了这么多,中年润希望,在未来的日子里和未知的领域里,你我同行,为我们的美好生活而努力奋斗。

 

总体目标

本篇文章的目标是介绍如何从自顶向下从零编写linux下的led字符设备驱动。着力从总体思路,需求端,分析端,实现端,详尽描述一个完整需求的开发流程,是中年润多年经验的提炼,希望读者能够有所收获。最后的实战目标,请读者尽量完成,这样读者才能形成自己的思路。

本示例采用arm920架构,天祥电子生产的tx2440a开发板,核心为三星的s3c2440。Linux版本为2.6.31,是已经移植好的版本。编译器为arm920t-eabi-4.1.2.tar。

 

总体思路

总体思路是严格遵循需求的开发流程来,不遗漏任何思考环节。读者在阅读时请先跟中年润的思路走一遍,然后再抛弃中年润的思路,按照自己的思路走一遍,如果遇到困难请先自己思考,实在不会再来参考中年润的思路和实现。

 

中年润在写代码的的总体思路如下:

需求描述—能够详细完整的描述一个需求。

需求分析—根据需求描述,提取可供实现的功能,需要有定量或者定性的指标。(从宏观上确定需要什么功能)。

需求分解—根据需求分析,考虑要实现需求所需要做的工作(根据宏观确定的功能,拆分成小的可单独实现的功能)。

编写思路—根据需求分解从总体上描述应该如何编写代码,(解决怎么在宏观上实现)。

详细步骤—根据编写思路,落实具体步骤,(解决怎么在微观上实现)。

编写框架—根据编写思路,实现总体框架(实现编写思路里主体框架,细节内容留在具体代码里编写)。

具体代码—根据编写框架和详细步骤,编写每一个函数里所需要实现的小功能,主要是实现驱动代码,测试代码。

Makefile—用来编译驱动代码。

目录结构—用来说明当完成编码后的结果。

测试步骤—说明如何对驱动进行测试,主要是加载驱动模块,执行测试代码。

执行结果—观察执行结果是否符合预期。

结果总结—回顾本节的知识点,api,结构体。

实战目标—说明如何根据本文档训练。

请大家尽量按照自顶向下的学习思路来学习和实战,因为我们所有工作的动力都是我们心中的需求。这些步骤仅仅是我们达到目标所要走过的路。目录起到提纲挈领的重要作用,写的时候要实时看下提纲,看有没有偏离自己的方向。

 

需求描述

使用linux提供的字符设备api接口,编写一个led字符设备驱动和一个测试代码,能够在输入./led on命令时点亮四个led灯,在输入./led off的时候熄灭四个led灯。

 

需求分析

我们需要两个.c文件,一个表示驱动,一个表示app。其中app是驱动的用户,于是我们分析用户的工作流程,进而可以分析出驱动应该完成哪些工作。

用户工作流程如下:

1用户调用open函数打开/dev/myled设备节点,获取fd

2用户拿到fd之后,调用write函数将特定的值写入fd中

3如果用户写入的是1,则点亮4个led灯

4如果用户写入的是0,则熄灭4个led灯

5关闭fd

 

根据用户的工作流程,我们可以得到驱动必须完成的工作:

1用户调用open函数打开/dev/myled设备节点,获取fd

A驱动需要提供一个节点,名字为myled

2用户拿到fd之后,调用write函数用读取fd中的值

B驱动需要提供一个write函数,向led对应的gpio管脚写数据

3如果用户写入的是1,则点亮4个led灯

C驱动需要根据用户写入的1,操作led对应的gpio管脚的地址,点亮led灯

4如果用户写入的是0,则熄灭4个led灯

D驱动需要根据用户写入的0,操作led对应的gpio管脚的地址,熄灭led灯

5关闭fd

F驱动需要提供一个close函数

 

需求分解

根据《需求分析》的结果,将宏观确定的功能拆分成小的可单独实现的功能,我们需要做以下几件工作。

针对测试代码:

1需要打开/dev/myled,获得fd。

2需要向fd中写入数值

2.1写入1点亮led灯

2.2写入0熄灭led灯

3关闭fd

 

针对驱动代码:

1需要创建一个设备节点/dev/myled

2需要编写打开函数,配置跟led相应的gpio管脚为输出模式

3需要编写write函数,根据用户传来的数值控制led灯的亮和灭

4需要编写空的关闭函数。

 

编写思路

编写思路主要用来搭建代码框架,解决在宏观上如何用代码实现驱动的功能。

确定目标:

1我们需要一个字符设备,存在于/dev/目录下(因此需要在入口函数创建设备)

2我们需要操作led所对应的gpio(因此需要映射gpio的地址)

3我们需要控制led所对应的gpio管脚的状态

(因此需要一个打开函数来配置gpio为输出模式)

(因此需要一个写函数来向gpio所对应的地址写数据)

 

0搭建基础框架

0.1编写代码框架,头文件

0.2编写空的出口函数

0.3编写空的入口函数

0.4修饰出口函数,修饰入口函数,声明LICENSE

 

在入口函数中所做的工作如下

1入口函数

1.1注册一个字符设备,名字为s3c_led

1.1.1定义file_operations结构体

1.1.2编写空的打开函数,写函数,关闭函数

1.2创建一个类,名字为led,(决定了class下目录的名字)

1.3创建一个设备节点,名字为myled(决定了/dev下目录的名字)

1.4映射gpio的物理地址为虚拟地址,一个是控制寄存器地址,一个是数据寄存器地址

 

在出口函数中所作的工作如下

2出口函数

2.1卸载字符设备

2.2删除设备节点

2.3销毁这个类

2.4取消地址映射

 

详细步骤

详细步骤主要用来在代码框架里填充必要的细节代码,解决在微观上如何用代码实现驱动各个小功能。

 

0搭建基础框架

0.1编写代码框架,头文件

0.2编写空的出口函数

0.3编写空的入口函数

0.4修饰出口函数,修饰入口函数,声明LICENSE

 

在入口函数中所做的工作如下

1入口函数

1.1注册一个字符设备,名字为s3c_led

1.1.1定义file_operations结构体

1.1.2编写空的打开函数,写函数,关闭函数

1.2创建一个类,名字为led,(决定了class下目录的名字)

1.3创建一个设备节点,名字为myled(决定了/dev下目录的名字)

1.4映射gpio的物理地址为虚拟地址,一个是控制寄存器地址,一个是数据寄存器地址

 

在出口函数中所作的工作如下

2出口函数

2.1卸载字符设备

2.2删除设备节点

2.3销毁这个类

2.4取消地址映射

 

编写操作函数

3编写file_operations里的操作函数

3.1编写打开函数

3.1.1配置GPF0,1,2,3为输出模式(用来点灯)(根据s3c2440 芯片手册配置)

3.2编写写函数

3.2.1拷贝用户空间数据

3.2.2如果用户空间传来1,输出低电平,点灯

3.2.3如果用户空间传来0,输出高电平,灭灯

 

如何根据原理图查询寄存器

在编写代码前,我们先来看看怎么查询硬件原理图上的gpio是哪个gpio,如何配置gpio为特定的功能模式,如何向gpio特定管脚写入数据。

1先看主板的原理图

先看Tx2440底板 V3.pdf,查找到LED1-LED4所对应的管脚为41,42,43,44。

2再看核心板的原理图

再看核心板COREBOARD .pdf文件,查找到41-44所对应的管脚为EINT0-EINT3。

又看到EINT0-EINT3对应GPF0-GPF3,由此可知,LED1-LED4对应GPF0-GPF4口

3查询 s3c2440 手册

要查询GPF管脚的的寄存器地址,主要关注控制寄存器和数据寄存器

控制寄存器用来配置管脚的模式,是输入、输出还是中断模式,而数据寄存器用来收发数据

TX2440A用的GPF0,1,2,3,只要配置成输出模式,根据用户的输入往数据寄存器写数据就好了。

4查询如何设置GPF引脚为输出引脚

将GPF0-GPF3设置为输出引脚,即都设置为01。

5如何向gpio管脚写数据

GPF0-3对应的就是GPFDAT寄存器的0-3bit,我们在写数据的时候只要向GPFDAT的地址0x56000054的低四位写入即可。

 

编写框架

根据编写思路,实现总体框架(实现编写思路里主体框架,细节内容留在具体代码里编写)。

/* 本文件名字为led_drv_skel.c*/
/* 本文件是依照led 驱动<编写思路>章节编写,本文件
  * 的目的是编写代码框架,不做具体细节的编写
  */
  
/* 本头文件是linux2.6.31内核所提供的,其他版本按需调整 */
 
 
/* 0.1编写代码框架,头文件 */
#include <linux/module.h>
#include <linux/ioport.h>
#include <linux/io.h>
#include <linux/platform_device.h>
#include <linux/init.h>
#include <linux/serial_core.h>
#include <linux/serial.h>
#include <asm/irq.h>
#include <mach/hardware.h>
#include <plat/regs-serial.h>
#include <mach/regs-gpio.h>
#include <asm/uaccess.h>
 
/* 使用函数时所需要的全局变量 */
int major; 
static struct class *led_class;
static struct class_device      *led_class_dev;
volatile unsigned long *gpfcon = NULL;
volatile unsigned long *gpfdat = NULL;
 
/* 1.1.2编写空的打开函数 */
static int led_drv_open(struct inode *inode, struct file *file)
{
       return 0;
}
 
/* 1.1.2编写空的写函数 */
static ssize_t led_drv_write(struct file *file, const char __user *buf, size_t count, loff_t * ppos)
{
       return 0;
}

/* 1.1.2编写空的关闭函数 */
static int led_drv_release(struct inode *inode, struct file *file)
{
       return 0;
}

/* 1.1.1定义file_operations结构体 */
static struct file_operations led_drv_fops = {
    .owner  =   THIS_MODULE,    /* 这是一个宏,推向编译模块时自动创建的__this_module变量 */
    .open   =   led_drv_open,     
.write   =   led_drv_write,    
.release  =   led_drv_release,
};
 
/* 0.2编写空的入口函数 */
static int led_drv_init(void)
{
       /* 1.1注册一个字符设备,名字为s3c_led */
       major = register_chrdev(0, "s3c_led", &led_drv_fops); 
       /* 1.2创建一个类,名字为led,(决定了class下目录的名字) */
       led_class = class_create(THIS_MODULE, "led");
       /* 1.3创建一个设备节点,名字为myled(决定了/dev下目录的名字) */
/* 2.6.31 上只有device_create 其他版本内核可能是class_device_create */
       led_class_dev = device_create(led_class, NULL, MKDEV(major, 0), NULL, "myled"); /* /dev/xyz */
       /* 1.4映射gpio的物理地址为虚拟地址,一个是控制寄存器地址,一个是数据寄存器地址 */
       gpfcon = (volatile unsigned long *)ioremap(0x56000050, 16);
       gpfdat = gpfcon + 1;
       return 0;
}
 
/* 0.3编写空的出口函数 */
static void led_drv_exit(void)
{
       /* 主要是和出口函数的反向操作*/
       
       /* 2.1 卸载字符设备 */
       unregister_chrdev(major, "first_drv"); 
       /* 2.2 删除设备节点 */
       device_unregister(led_class_dev);
       /* 2.3 销毁这个类 */
       class_destroy(led_class);
       /* 2.4 取消地址映射 */
       iounmap(gpfcon);
}
 
 
/* 0.4修饰出口函数,修饰入口函数,声明LICENSE */
module_init(led_drv_init);
module_exit(led_drv_exit);
MODULE_LICENSE("GPL");

 

驱动代码

根据《编写框架》《详细步骤》章节,编写每一个函数里所需要实现的小功能。

/* 本文件名字为led_drv.c*/
/* 本文件是依照led 驱动<详细步骤>章节编写,本文件
  * 的目的是编写代码框架,不做具体细节的编写
  */
  
/* 本头文件是linux2.6.31内核所提供的,其他版本按需调整 */
 
 
/* 0.1编写代码框架,头文件 */
#include <linux/module.h>
#include <linux/ioport.h>
#include <linux/io.h>
#include <linux/platform_device.h>
#include <linux/init.h>
#include <linux/serial_core.h>
#include <linux/serial.h>
#include <asm/irq.h>
#include <mach/hardware.h>
#include <plat/regs-serial.h>
#include <mach/regs-gpio.h>
#include <asm/uaccess.h>
 
/* 使用函数时所需要的全局变量 */
int major; 
static struct class *led_class;
static struct class_device      *led_class_dev;
volatile unsigned long *gpfcon = NULL;
volatile unsigned long *gpfdat = NULL;
 
/* 1.1.2编写空的打开函数 */
static int led_drv_open(struct inode *inode, struct file *file)
{
       /* 配置GPF0,1,2,3为输出 */
       *gpfcon &= ~((0x3<<(0*2)) | (0x3<<(1*2)) | (0x3<<(2*2)) | (0x3<<(3*2)));
       *gpfcon |= ((0x1<<(0*2)) | (0x1<<(1*2)) | (0x1<<(2*2)) | (0x1<<(3*2)));
       return 0;
}
 
/* 1.1.2编写空的写函数 */
static ssize_t led_drv_write(struct file *file, const char __user *buf, size_t count, loff_t * ppos)
{
       int val;
       
       /* 3.2.1拷贝用户空间数据 */
       copy_from_user(&val, buf, count); 
       if (val == 1)
       {
              /* 3.2.2如果用户空间传来1,输出低电平,点灯 */
              *gpfdat &= ~((1<<0) | (1<<1) | (1<<2) | (1<<3));
       }
       else
       {
              /* 3.2.3如果用户空间传来0,输出高电平,灭灯 */
              *gpfdat |= (1<<0) | (1<<1) | (1<<2) | (1<<3);
       }
 
       return 0;
}
/* 1.1.2编写空的关闭函数 */
static int led_drv_release(struct inode *inode, struct file *file)
{
       return 0;
}

/* 1.1.1定义file_operations结构体 */
static struct file_operations led_drv_fops = {
.owner  =   THIS_MODULE,    /* 这是一个宏,推向编译模块时自动创建的__this_module变量 */
.open   =   led_drv_open,     
.write   =   led_drv_write,   
 .release  =   led_drv_release,
};
 
/* 0.2编写空的入口函数 */
static int led_drv_init(void)
{
       /* 1.1注册一个字符设备,名字为s3c_led */
       major = register_chrdev(0, "s3c_led", &led_drv_fops); 
       /* 1.2创建一个类,名字为led,(决定了class下目录的名字) */
       led_class = class_create(THIS_MODULE, "led");
       /* 1.3创建一个设备节点,名字为myled(决定了/dev下目录的名字) */
/* 2.6.31 上只有device_create 其他版本内核可能是class_device_create */
       led_class_dev = device_create(led_class, NULL, MKDEV(major, 0), NULL, "myled"); /* /dev/xyz */
       /* 1.4映射gpio的物理地址为虚拟地址,一个是控制寄存器地址,一个是数据寄存器地址 */
       gpfcon = (volatile unsigned long *)ioremap(0x56000050, 16);
       gpfdat = gpfcon + 1;
       return 0;
}
 
/* 0.3编写空的出口函数 */
static void led_drv_exit(void)
{
       /* 主要是和出口函数的反向操作*/
       
       /* 2.1 卸载字符设备 */
       unregister_chrdev(major, "first_drv"); 
       /* 2.2 删除设备节点 */
       device_unregister(led_class_dev);
       /* 2.3 销毁这个类 */
       class_destroy(led_class);
       /* 2.4 取消地址映射 */
       iounmap(gpfcon);
}
 
 
/* 0.4修饰出口函数,修饰入口函数,声明LICENSE */
module_init(led_drv_init);
module_exit(led_drv_exit);
MODULE_LICENSE("GPL");

 

测试代码

测试代码编写思路如下:

1打开/dev/myled文件

2根据执行的命令不同,向文件里写不同的值

3关闭文件

 

测试代码如下:

/* 本文件是led_test.c,是根据led驱动的
  * <测试代码>章节编写,主要任务是用来测试
  * led 驱动
  */
 
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <stdio.h>
int main(int argc, char **argv)
{
       int fd;
       int val = 1;
       
       fd = open("/dev/myled", O_RDWR);
       if (fd < 0)
       {
              printf("can't open!\n");
       }
       if (argc != 2)
       {
              printf("Usage :\n");
              printf("%s <on|off>\n", argv[0]);
              return -1;
       }
       if (strcmp(argv[1], "on") == 0)
       {
              val  = 1; //点灯
       }
       else
       {
              val = 0;   //灭灯
       }
       
       write(fd, &val, 4);
       close(fd);
       return 0;
}
 

Makefile

KERN_DIR = /home/linux/tools/linux-2.6.31_TX2440A
all:
       make -C $(KERN_DIR) M=`pwd` modules 
clean:
       make -C $(KERN_DIR) M=`pwd` modules clean
       rm -rf modules.order
obj-m += led_drv.o
 

 

目录结构

代码编写完成的目录结构如下所示。直接执行make即可生成.ko文件。

.
├── led_drv.c(驱动代码)
├── led_drv_skel.c(驱动框架代码)
├── led_test.c(驱动测试代码)
└── Makefile(用来编译驱动代码)

 

测试步骤

0 在linux下的makefile +180行处配置好arch为arm,cross_compile为arm-linux-(或者arm-angstrom-linux-gnueabi-)

1 在menuconfig中配置好内核源码的目标系统为s3c2440

2 在pc上将驱动程序编译生成.ko,命令:make

3 在pc上将测试程序编译生成elf可执行文件,生成的led就是我们所要使用的命令,在配合on和off就可以控制led灯的亮和灭了。

编译:arm-angstrom-linux-gnueabi-gcc led_test.c -o led

4 挂载nfs,这样就可以在开发板上看到pc端的.ko文件和测试文件

mount -t nfs -o nolock,vers=2 192.168.0.105:/home/linux/nfs_root  /mnt/nfs

5 insmod led_drv.ko,加载led的驱动模块

6执行命令./led on,观察开发板上的四个led灯是否亮了。

7执行命令./led off,观察开发板上的四个led灯是否灭了。

 

执行结果

执行完./led on后,四个led灯亮了,如下图所示:

执行完./led off后,四个led灯灭了,如下图所示

 

结果总结

在本篇文章中,中年润跟读者分享了led字符设备驱动的编写思路和方法,其中贯穿始终的有几个函数和关键数据结构,它们分别是:

struct file_operations
struct class
struct class_device
 
register_chrdev
class_create
device_create
unregister_chrdev
device_destroy
class_destroy
ioremap
iounmap

 

请读者尽力去了解这些函数的作用,入参,返回值。

 

实战目标

1请读者根据《需求描述》章节,独立编写需求分析和需求分解。

2请读者根据需求分析和需求分解,独立编写编写思路和详细步骤。

3请读者根据编写思路,独立写出编写框架。

4请读者根据详细步骤,独立编写驱动代码和测试代码。

5请读者根据《Makefile》章节,独立编写Makefile。

6请读者根据《测试步骤》章节,独立进行测试。

7请读者抛开上述练习,自顶向下从零开始再编写一遍驱动代码,测试代码,makefile

8如果无法独立写出7,请重复练习1-6,直到能独立写出7。

 

参考资料

《linux设备驱动开发祥解》

《TX2440开发手册及代码》

《韦东山嵌入式教程》

《鱼树驱动笔记》

《s3c2440a》芯片手册英文版和中文版

 

致谢

感谢在嵌入式领域深耕多年的前辈,感谢中年润的家人,感谢读者。没有前辈们的开拓,我辈也不能站在巨人的肩膀上看世界;没有家人的鼎力支持,我们也不能集中精力完成自己的工作;没有读者的关注和支持,我们也没有充足的动力来编写和完善文章。看完中年润的文章,希望读者学到的不仅仅是如何编写代码,更进一步能够学到一种思路和一种方法。

 

为了省去驱动开发者搜集各种资料来写驱动,中年润后续有计划按照本模板编写linux下的常见驱动,敬请读者关注。

 

联系方式

微信群:自顶向下学嵌入式(可先加微信号:runzhiqingqing, 通过后会邀请入群。添加时请注明来自哪个平台)

微信订阅号:自顶向下学嵌入式  公众号:EmbeddedAIOT

CSDN博客:中年润  网址:https://blog.csdn.net/chichi123137?utm_source=blog_pc_recommand

邮箱:834759803@qq.com

QQ群:766756075

更多原创文章请关注微信公众号。另外,中年润还代理销售韦东山老师的视频教程,欢迎读者咨询。在中年润这里购买了韦东山老师的视频教程,除了能得到韦东山官方的技术支持外,还能获得中年润细致入微的技术和非技术的支持和帮助。欢迎选购哦。

学习交流群

入群小助手

  • 8
    点赞
  • 27
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值