linux pinctl 分析,基于Linux 3.10.49内核的pinctrl流程分析

linux kernel 3.10.49+

重要结构体:

struct pinctrl_desc {                      // pinctrl_register(...) 使用到.

const char *name;                      // 设备的名字platform_device传过来, 注意:不是node(dts 节点)的名字, 是xxxxx.*或a8000000.xxxxx

struct pinctrl_pin_desc const *pins;    // 引脚枚举{枚举号, 引脚名字}  // 全局变量赋值  ---|

unsigned int npins;                    // 引脚总数                    //              ---| 这两个pinctrl_register_pins会使用到.

const struct pinctrl_ops *pctlops;      // 必须                        // 全局变量赋值

const struct pinmux_ops *pmxops;        // 可选(引脚复用时,需选上)      // 全局变量赋值

const struct pinconf_ops *confops;      // 可选(一般不用.)              // 全局变量赋值

struct module *owner;                  // THIS_MODULE

};

struct pinctrl_dev      : pinctrl设备结构体(包含struct device通用属性, 其它是pinctrl独有属性)

struct platform_device  : platform设备结构体(包含struct device通用属性, 其它是pinctrl独有属性)

// 用of 解析的dts设备, 一开始都认为是platform设备, 所以都使用platform_driver_register来注册, probe回传platform_device结构体

// 如: gpio, pinctrl

// pinctrl 会通过pinctrl_register把转platform_device换成pinctrl_dev. (通用属性, 直接赋值过来, 其它重新初始化.)

重要变量:

pinctrl_maps: 这个是全局变量, 虽然与struct pinctrl_maps同名, 由LIST_HEAD(pinctrl_maps)生成

// 在drivers/pinctrl/core.c路径下.由pinctrl_register_map(...)函数使用.

// 保存引脚控制句柄(struct pinctrl_dt_map)列表, 每个设备(dts带有pinctrl-0和pinctrl-names两个属性)驱动注册时, 都会过来全部保存.

// 如果节点有pinctrl-0和pinctrl-names两个属性, 则说明这个节点有复用信息,

// 所以这个节点驱动注册时去轮询dts时, 保存这个节点的子节点的io复用的group, function两个字符串信息.

//

// struct pinctrl_map 包含于struct pinctrl_maps, 是专门保存group, function两个字符串信息的容器.

//

// 如果dts中有两个节点带有pinctrl-0, 则pinctrl_maps列表中就会有两个有效struct pinctrl_dt_map的数据.

// 简单地说, 就复用信息映射

pinctrl_list: 这个是全局变量, 由static LIST_HEAD(pinctrl_list)生成

// 在drivers/pinctrl/core.c路径下.由create_pinctrl(...)函数使用.

// 保存引脚控制句柄(struct pinctrl)列表, 每个设备驱动注册时, 都会过来保存一次.

// struct pinctrl有两个比较重要的成员states, dt_maps;

// dt_maps如果节点dts带有pinctrl-0(也就是说是dts描述复用的设备), 那么dt_maps与struct pinctrl_dt_map一样, 否则为空.

// states如果节点dts带有pinctrl-0(也就是说是dts描述复用的设备), 那么states与pinctrl-names的值一样, 一般来说只有一个"default"值, 否则为空(如:gpio为空)

##########################################################################################################################################

重要函数:

static inline void platform_set_drvdata(struct platform_device *pdev, void *data);

// 设置platform_device的私有数据(自定义数据), 实际上是保存私有指针到pdev->dev->p->driver_data

// pdev->dev                        :是struct device通用属性

// pdev->dev->p                    :是struct device 的 struct device_private 结构体指针

// pdev->dev->p->driver_data        :可以存放自定义数据的指针

static inline void *platform_get_drvdata(const struct platform_device *pdev);

// 获取platform_device的私有数据(自定义数据的指针)

static inline const char *dev_name(const struct device *dev)

// 获取struct device的name, 因为struct device没有name成员, 可以用这个.

static struct pinctrl_state *create_state(struct pinctrl *p,

const char *name);

// 参数:

// p: 就是引脚控制句柄,

// name: pinctrl-names的值, 或PINCTRL_STATE_DEFAULT

static struct pinctrl_state *find_state(struct pinctrl *p,

const char *name);

// 参数:

// p: 就是引脚控制句柄,

// name: pinctrl-names的值, 或PINCTRL_STATE_DEFAULT, 一般为PINCTRL_STATE_DEFAULT

struct pinctrl_state *pinctrl_lookup_state(struct pinctrl *p,

const char *name);

// 参数:

// p: 就是引脚控制句柄,

// name: pinctrl-names的值, 或PINCTRL_STATE_DEFAULT, 一般为PINCTRL_STATE_DEFAULT

##########################################################################################################################################

其它, 重要函数:

struct list_head;  // 只是一个环形链表指针管理工具, 构建结构体包含它, 就可以通过container_of宏访问到构建的结构体变量.

static inline void list_add(struct list_head *new, struct list_head *head);

// 环形链表, 把 new 插入到 head 的后面

// 如 head == h 10 20

// 如 1 --> head == h 1 10 20

// 如 2 --> head == h 2 1 10 20

static inline void list_add_tail(struct list_head *new, struct list_head *head)

// 环形链表, 把 new 插入到 head 的前面

// 如 head == h 10 20

// 如 1 --> head == 1 h 10 20      ==> [ h 10 20 1 ]

// 如 2 --> head == 2 h 10 20 1    ==> [ h 10 20 1 2 ]

重要宏:

LIST_HEAD(name)

// 宏: 生成以name为名字的全局list_head变量, 并初始化成员next, prev指向自已

static inline void INIT_LIST_HEAD(struct list_head *list)

// 初始化已经存在的list变量的成员next, prev指向自已

for_each_maps(maps_node, i, map)

// 参数定义如下:

// struct pinctrl_maps *maps_node    // 只是提供struct pinctrl_maps这样一个结构体, 由typeof使用.(宏内部使用)

// int i;                            // 作为一个interator使用.(宏内部使用)

// struct pinctrl_map const *map;    // 轮询pinctrl_maps这个全局变量列表, 得到每个列表结节的成员(struct pinctrl_map).