Part16-用platform总线实现led点灯

0 platform总线介绍

>> 从Linux2.6内核起，引入一套新的驱动管理和注册机制：platform总线。相对于USB、PCI、I2C、SPI等物理总线来说，
     platform总线是一种虚拟、抽象出来的总线，实际中并不存在这样的总线。 
>> platform总线将“设备相关硬件操作”与“驱动程序”分离,因为硬件相关操作差异大，而驱动程序较稳定。这样分离使得它们
    的耦合度降低，即更加灵活，方便维护和拓展。而设备与驱动的关联由platform总线自动完成。

对于platform总线的基本使用，理解核心结构体和几个常用函数即可，如下
1）核心的结构体：platform_device 代表一个设备， platform_driver代表一个驱动

struct platform_device {
	const char * name;    // 平台总线下设备的名字
	u32  id;   // ID 是用来区分如果设备名字相同的时候(通过在后面添加一个数字来代表不同的设备，因为有时候有这种需求)
	struct device dev;   // 所有设备通用的属性部分
	u32  num_resources;  // 设备使用到的resource的个数
	struct resource * resource;    // 指向一个资源结构体数组
};

struct resource {               // 资源结构体
    resource_size_t start;      // 资源的起始值，如果是地址，那么是物理地址，不是虚拟地址
    resource_size_t end;        // 资源的结束值，如果是地址，那么是物理地址，不是虚拟地址
    const char *name;           // 资源名
    unsigned long flags;        // 资源的标示，用来识别不同的资源(如flags可以为IORESOURCE_IO、
    				// IORESOURCE_MEM、IORESOURCE_IRQ、IORESOURCE_DMA 等)
    struct resource *parent, *sibling, *child;   // 资源指针，可以构成链表
};

struct platform_driver {
	int (*probe)(struct platform_device *);     // 驱动探测函数
	int (*remove)(struct platform_device *);    // 去掉一个设备
	void (*shutdown)(struct platform_device *); // 关闭一个设备
	int (*suspend)(struct platform_device *, pm_message_t state);
	int (*resume)(struct platform_device *);
    	struct device_driver driver;                // 所有设备共用的一些属性
    	const struct platform_device_id *id_table;  // 设备ID表
};

2）platform总线的主要函数

1：platform_device_register()：向platform总线注册设备，调用层次关系
     调用关系：platform_device_register()
	         	platform_device_add()
    				device_add()    // 向内核注册设备
    	相应的用 platform_device_unregister() 注销设备
2：platform_driver_register()：向platform总线注册驱动，调用层次关系
     调用关系：platform_driver_register()
			       	        driver_register()  //向内核注册驱动
		相应的用 platform_driver_unregister() 注销设备
	3：platform_match()：匹配函数，解释如下

static int platform_match(struct device *dev, struct device_driver *drv) 
{ 
    struct platform_device *pdev = to_platform_device(dev); 
    struct platform_driver *pdrv = to_platform_driver(drv); 
    /* match against the id table first */
    if (pdrv->id_table) 
        return platform_match_id(pdrv->id_table, pdev) != NULL; 
    /* fall-back to driver name match */
    return (strcmp(pdev->name, drv->name) == 0); 
}
分析可知，platform的匹配过程是：
    先根据id_table的名字进行匹配，如果匹配失败，则再根据device和driver的名字进行匹配，
    如果匹配还不成功，则说明驱动和设备不匹配。如果这里匹配成功，则会调用platform_driver_probe()函数

4：platform_driver_probe()：驱动和设备匹配成功后自动执行的探测函数，通常
5.  platform_get_resource()  驱动程序用于从设备获取资源(如中断号、引脚等)

下面看一个简单例子，以明确使用 platform 总线注册设备和驱动的基本方法

1 点灯源码与测试结果

led_dev.c

#include <linux/module.h>
#include <linux/version.h>
#include <linux/init.h>
#include <linux/kernel.h>
#include <linux/types.h>
#include <linux/interrupt.h>
#include <linux/list.h>
#include <linux/timer.h>
#include <linux/init.h>
#include <linux/serial_core.h>
#include <linux/platform_device.h>

/* 分配/设置/注册一个platform_device */
static struct resource led_resource[] = {
    [0] = {
        .start = 0x56000050,
        .end   = 0x56000050 + 8 - 1,
        .flags = IORESOURCE_MEM,
    },
    [1] = {
        .start = 5,
        .end   = 5,
        .flags = IORESOURCE_IRQ,
    }
};
static void led_release(struct device * dev)
{
}
static struct platform_device led_dev = {
    .name         = "myled",
    .id       = -1,
    .num_resources    = ARRAY_SIZE(led_resource),
    .resource     = led_resource,
    .dev = { 
     .release = led_release, 
 },
};
static int led_dev_init(void)
{
	platform_device_register(&led_dev);
 	return 0;
}
static void led_dev_exit(void)
{
	platform_device_unregister(&led_dev);
}

module_init(led_dev_init);
module_exit(led_dev_exit);
MODULE_LICENSE("GPL");

led_drv.c

/* 分配/设置/注册一个platform_driver */
#include <linux/module.h>
#include <linux/version.h>
#include <linux/init.h>
#include <linux/fs.h>
#include <linux/interrupt.h>
#include <linux/irq.h>
#include <linux/sched.h>
#include <linux/pm.h>
#include <linux/sysctl.h>
#include <linux/proc_fs.h>
#include <linux/delay.h>
#include <linux/platform_device.h>
#include <linux/input.h>
#include <linux/irq.h>
#include <asm/uaccess.h>
#include <asm/io.h>

static int major;
static struct class *cls;
static volatile unsigned long *gpio_con;
static volatile unsigned long *gpio_dat;
static int pin;

static int led_open(struct inode *inode, struct file *file)
{
	//printk("first_drv_open\n");
	/* 配置为输出 */
 	*gpio_con &= ~(0x3<<(pin*2));
 	*gpio_con |= (0x1<<(pin*2));
 	return 0; 
}
static ssize_t led_write(struct file *file, const char __user *buf, size_t count, loff_t * ppos)
{
 	int val;
 	//printk("first_drv_write\n");
 	copy_from_user(&val, buf, count); // copy_to_user();
 	if (val == 1)
 	{
  		// 点灯
  		*gpio_dat &= ~(1<<pin);
 	}
 	else
 	{
  		// 灭灯
  		*gpio_dat |= (1<<pin);
 	}
 	return 0;
}
static struct file_operations led_fops = {
    	.owner  =   THIS_MODULE,    /* 这是一个宏，推向编译模块时自动创建的__this_module变量 */
	.open   =   led_open,     
 	.write = led_write,    
};
static int led_probe(struct platform_device *pdev)
{
 	struct resource  *res;
 	/* 根据platform_device的资源进行ioremap */
 	res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
 	gpio_con = ioremap(res->start, res->end - res->start + 1);
 	gpio_dat = gpio_con + 1;
	res = platform_get_resource(pdev, IORESOURCE_IRQ, 0);
 	pin = res->start;
 	
 	/* 注册字符设备驱动程序 */
	printk("led_probe, found led\n");
 	major = register_chrdev(0, "myled", &led_fops);
 	cls = class_create(THIS_MODULE, "myled");
 	class_device_create(cls, NULL, MKDEV(major, 0), NULL, "led"); /* /dev/led */
 	return 0;
}
static int led_remove(struct platform_device *pdev)
{
 	/* 卸载字符设备驱动程序 */
	/* iounmap */
	printk("led_remove, remove led\n");
 	class_device_destroy(cls, MKDEV(major, 0));
 	class_destroy(cls);
 	unregister_chrdev(major, "myled");
 	iounmap(gpio_con);
 	return 0;
}
struct platform_driver led_drv = {
 	.probe  = led_probe,
 	.remove  = led_remove,
 	.driver  = {
  		.name = "myled",
	}
};
static int led_drv_init(void)
{
	platform_driver_register(&led_drv);
	return 0;
}
static void led_drv_exit(void)
{
	platform_driver_unregister(&led_drv);
}
module_init(led_drv_init);
module_exit(led_drv_exit);
MODULE_LICENSE("GPL");

Makefile

KERN_DIR = /work/system/linux-2.6.22.6
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
obj-m += led_dev.o

led_ts.c 测试文件

#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <stdio.h>
/* led_test on
 * led_test off
 */
int main(int argc, char **argv)
{
 	int fd;
 	int val = 1;
 	fd = open("/dev/led", O_RDWR);
 	if (fd < 0)
 	{
  		printf("can't open!\n");
 	}
 	if (argc != 2)
 	{
  		printf("Usage :\n");
  		printf("%s <on|off>\n", argv[0]);
  		return 0;
 	}
 	if (strcmp(argv[1], "on") == 0)
 		val  = 1;
 	else
	 	val = 0;

 	write(fd, &val, 4);
 	return 0;
}

测试结果

2 设备/驱动文件编写总结

对于设备文件：
	1. 定义static struct resource my_rsc[] ={...} 资源数组
	2. 定义 static struct platform_device my_dev{...}; 
	             里面有.resource = my_rsc指定资源数组，还有设备名。
	             注意必须要有.dev = { 
				 .release = led_release, 
		     },成员 ，led_release可以为空函数
       3. 在设备入口函数里调用platform_device_register(&my_dev) 注册设备
       4. 在设备出口函数里调用platform_device_unregister(&my_dev) 卸载设备
       5. module_init(入口函数)  module_eixt(出口函数)  MODULE_LICENSE("GPL")

对于驱动文件：
       1. 定义：struct platform_driver my_drv {
				.probe  = my_drv_probe,
				 .remove  = my_drv_remove,
		 		.driver  = {
				.name = "my_drv",
			} } // 注意：驱动名字一定要和设备名相同
      2. 实现 my_drv_probe()函数，里面可以做一些初始化工作(如注册字符设备，获取资源
    		platform_get_resource()等等)
      3. 实现 my_drv_remove 里面做一些处理工作(如卸载字符设备，iounmap等等)
      4. 在驱动入口函数里调用platform_driver_register(&my_drv) 在platform总线注册驱动
      5. 在驱动出口函数里调用platform_driver_unregister(&my_drv) 从platform总线卸载驱动
      6. module_init(入口函数)  module_eixt(出口函数)  MODULE_LICENSE("GPL")