以下代碼都在pinctrl相關的驅動函數和設備樹中
pinctrl-rockchip.c驅動,對應的是那個(那些)設備樹呢?
答案:通過.compatible = "rockchip,rk3568-pinctrl"連接到rk3568.dtsi根節點下的pinctrl節點
一,pinctrl_desc結構體
/*用于描述 Pin controller
*/
struct pinctrl_desc {const char *name; //1,名字const struct pinctrl_pin_desc *pins; //2,一個引腳unsigned int npins; //3,一共有多少引腳const struct pinctrl_ops *pctlops; //4,xxx操作集合const struct pinmux_ops *pmxops; //5,xxx操作集合const struct pinconf_ops *confops; //6,xxx操作集合struct module *owner; //7,模塊的擁有者
#ifdef CONFIG_GENERIC_PINCONFunsigned int num_custom_params; //自定義相關const struct pinconf_generic_params *custom_params;const struct pin_config_item *custom_conf_items;
#endif
};
????????構建完 pinctrl結構體之后,會調用pinctrl_register函數注冊一個pinctrl控制器,得到一個pinctrl_dev。
1.1pinctrl_desc結構體在probe中的使用
不同的芯片廠,的pinctrl的驅動不一樣,我的被打包到了rockchip_pinctrl結構體之中了!!!
struct rockchip_pinctrl {struct regmap *regmap_base;int reg_size;struct regmap *regmap_pull;struct regmap *regmap_pmu;struct device *dev;struct rockchip_pin_ctrl *ctrl;struct pinctrl_desc pctl; //在這里struct pinctrl_dev *pctl_dev;struct rockchip_pin_group *groups;unsigned int ngroups;struct rockchip_pmx_func *functions;unsigned int nfunctions;
};
1.2用rockchip_pinctrl_register函數進行注冊。
ret = rockchip_pinctrl_register(pdev, info);
if (ret)return ret;--->>進入rockchip_pinctrl_register函數
{struct pinctrl_desc *ctrldesc = &info->pctl;struct pinctrl_pin_desc *pindesc, *pdesc;struct rockchip_pin_bank *pin_bank;int pin, bank, ret;int k;ctrldesc->name = "rockchip-pinctrl"; //驅動名字和compatible配對ctrldesc->owner = THIS_MODULE; ctrldesc->pctlops = &rockchip_pctrl_ops; //三個操作集合ctrldesc->pmxops = &rockchip_pmx_ops; //ctrldesc->confops = &rockchip_pinconf_ops;////給管腳申請內存空間pindesc = devm_kcalloc(&pdev->dev,info->ctrl->nr_pins, sizeof(*pindesc),GFP_KERNEL);if (!pindesc)return -ENOMEM;ctrldesc->pins = pindesc;ctrldesc->npins = info->ctrl->nr_pins;//給管腳 編號 命名pdesc = pindesc;for (bank = 0, k = 0; bank < info->ctrl->nr_banks; bank++) {pin_bank = &info->ctrl->pin_banks[bank];for (pin = 0; pin < pin_bank->nr_pins; pin++, k++) {pdesc->number = k;pdesc->name = kasprintf(GFP_KERNEL, "%s-%d",pin_bank->name, pin);pdesc++;}}//在devm_pinctrl_register中調用pinctrl_register函數進行注冊ret = rockchip_pinctrl_parse_dt(pdev, info);if (ret)return ret;info->pctl_dev = devm_pinctrl_register(&pdev->dev, ctrldesc, info);if (IS_ERR(info->pctl_dev)) {dev_err(&pdev->dev, "could not register pinctrl driver\n");return PTR_ERR(info->pctl_dev);}}
二,pinctrl 子系統函數操作集
2.1 groups和function
groups(引腳組):
引腳組是一組具有相似功能、約束條件或共同工作的引腳的集合。
function(功能):
定義了芯片上具有外設功能的功能。每個功能節點對應于一個或多個 IO 組(group)的配置信息。這些功能可以是串口、SPI、I2C 等外設功能。
在.dtsi文件中:
can0 { //這是一個function/omit-if-no-ref/ //這是一組groupscan0m0_pins: can0m0-pins {rockchip,pins =/* can0_rxm0 */<0 RK_PB4 2 &pcfg_pull_none>,/* can0_txm0 */<0 RK_PB3 2 &pcfg_pull_none>;};/omit-if-no-ref/ //這是一另組groupscan0m1_pins: can0m1-pins {rockchip,pins =/* can0_rxm1 */<2 RK_PA2 4 &pcfg_pull_none>,/* can0_txm1 */<2 RK_PA1 4 &pcfg_pull_none>;};};can1 { //這是一另個function /omit-if-no-ref/can1m0_pins: can1m0-pins {rockchip,pins =/* can1_rxm0 */<1 RK_PA0 3 &pcfg_pull_none>,/* can1_txm0 */<1 RK_PA1 3 &pcfg_pull_none>;};/omit-if-no-ref/can1m1_pins: can1m1-pins {rockchip,pins =/* can1_rxm1 */<4 RK_PC2 3 &pcfg_pull_none>,/* can1_txm1 */<4 RK_PC3 3 &pcfg_pull_none>;};};
可已這么說:can0和can1對應2個function,為CAN0控制器和CAN1控制器,而每個控制器中又有2給不同的groups引腳組
2.2pinctrl_ops結構體:
里面都是函數。
struct pinctrl_ops {//獲取設備樹中的groups用了多少個int (*get_groups_count) (struct pinctrl_dev *pctldev);//獲取指定groups的名字const char *(*get_group_name) (struct pinctrl_dev *pctldev,unsigned selector);//獲取指定groups的管腳int (*get_group_pins) (struct pinctrl_dev *pctldev,unsigned selector,const unsigned **pins,unsigned *num_pins);//調試用void (*pin_dbg_show) (struct pinctrl_dev *pctldev, struct seq_file *s,unsigned offset);//節點轉化為mapint (*dt_node_to_map) (struct pinctrl_dev *pctldev,struct device_node *np_config,struct pinctrl_map **map, unsigned *num_maps);//dt_node_to_map的反操作void (*dt_free_map) (struct pinctrl_dev *pctldev,struct pinctrl_map *map, unsigned num_maps);
};
2.3pinmux_ops結構體:
/* pinctrl_dev:代表著一個 pin controller*/
struct pinmux_ops {//1,申請引腳int (*request) (struct pinctrl_dev *pctldev, unsigned offset);//2,釋放引腳int (*free) (struct pinctrl_dev *pctldev, unsigned offset);//3,獲取 pin controller 中 function 的數量int (*get_functions_count) (struct pinctrl_dev *pctldev);//4,獲取指定 function 的名字const char *(*get_function_name) (struct pinctrl_dev *pctldev,unsigned selector);//5,獲取指定 function 的 groupsint (*get_function_groups) (struct pinctrl_dev *pctldev,unsigned selector,const char * const **groups,unsigned *num_groups);//6,設定引腳的 復用功能 (GPIO/I2C/SPI...)int (*set_mux) (struct pinctrl_dev *pctldev, unsigned func_selector,unsigned group_selector);//7,申請并使能 GPIOint (*gpio_request_enable) (struct pinctrl_dev *pctldev,struct pinctrl_gpio_range *range,unsigned offset);//8,禁止并釋放 GPIOvoid (*gpio_disable_free) (struct pinctrl_dev *pctldev,struct pinctrl_gpio_range *range,unsigned offset);//9,設置GPIO的方向int (*gpio_set_direction) (struct pinctrl_dev *pctldev,struct pinctrl_gpio_range *range,unsigned offset,bool input);//不允許同時在同一個引腳上使用 GPIO 和 其他功能 (在同一時間,只能用一個功能)bool strict;
};
2.4pinconf_ops結構體:
struct pinconf_ops {
#ifdef CONFIG_GENERIC_PINCONFbool is_generic;
#endif//1,獲取某個引腳的配置int (*pin_config_get) (struct pinctrl_dev *pctldev,unsigned pin,unsigned long *config);//2,設置某個引腳的配置int (*pin_config_set) (struct pinctrl_dev *pctldev,unsigned pin,unsigned long *configs,unsigned num_configs);//3,設置某個組的引腳配置int (*pin_config_group_get) (struct pinctrl_dev *pctldev,unsigned selector,unsigned long *config);//4,獲取某個組的引腳配置int (*pin_config_group_set) (struct pinctrl_dev *pctldev,unsigned selector,unsigned long *configs,unsigned num_configs);//6,解析和修改調試信息int (*pin_config_dbg_parse_modify) (struct pinctrl_dev *pctldev,const char *arg,unsigned long *config);//789,調試使用void (*pin_config_dbg_show) (struct pinctrl_dev *pctldev,struct seq_file *s,unsigned offset);void (*pin_config_group_dbg_show) (struct pinctrl_dev *pctldev,struct seq_file *s,unsigned selector);void (*pin_config_config_dbg_show) (struct pinctrl_dev *pctldev,struct seq_file *s,unsigned long config);
};
2.5rockchip_pinctrl 進一步分析
在1.1中我看到了struct pinctrl_desc,在pinctrl_desc結構體里有:
struct rockchip_pin_group *groups; //瑞芯微芯片引腳組指針
unsigned int ngroups; //引腳組數量
struct rockchip_pmx_func *functions; //瑞芯微芯片引腳功能指針
unsigned int nfunctions; //引腳功能數量
這四個變量被在pinctrl的probe函數中-->rockchip_pinctrl_register函數中的rockchip_pinctrl_parse_dt函數處理:
static int rockchip_pinctrl_register(struct platform_device *pdev,struct rockchip_pinctrl *info)
{struct pinctrl_desc *ctrldesc = &info->pctl;struct pinctrl_pin_desc *pindesc, *pdesc;struct rockchip_pin_bank *pin_bank;int pin, bank, ret;int k;ctrldesc->name = "rockchip-pinctrl";ctrldesc->owner = THIS_MODULE;ctrldesc->pctlops = &rockchip_pctrl_ops; //瑞芯微封裝的操作集1ctrldesc->pmxops = &rockchip_pmx_ops; //瑞芯微封裝的操作集2ctrldesc->confops = &rockchip_pinconf_ops; //瑞芯微封裝的操作集3pindesc = devm_kcalloc(&pdev->dev,info->ctrl->nr_pins, sizeof(*pindesc),GFP_KERNEL);if (!pindesc)return -ENOMEM;ctrldesc->pins = pindesc;ctrldesc->npins = info->ctrl->nr_pins;pdesc = pindesc;for (bank = 0, k = 0; bank < info->ctrl->nr_banks; bank++) {pin_bank = &info->ctrl->pin_banks[bank];for (pin = 0; pin < pin_bank->nr_pins; pin++, k++) {pdesc->number = k;pdesc->name = kasprintf(GFP_KERNEL, "%s-%d",pin_bank->name, pin);pdesc++;}}//rockchip_pinctrl_parse_dt在這個函數里處理了上面四個變量ret = rockchip_pinctrl_parse_dt(pdev, info);if (ret)return ret;info->pctl_dev = devm_pinctrl_register(&pdev->dev, ctrldesc, info);if (IS_ERR(info->pctl_dev)) {dev_err(&pdev->dev, "could not register pinctrl driver\n");return PTR_ERR(info->pctl_dev);}return 0;
}
2.6函數操作集的具體實現
? ?都是調用pinctrl_dev_get_drvdata函數來處理
?static const struct pinctrl_ops rockchip_pctrl_ops = {.get_groups_count = rockchip_get_groups_count,.get_group_name = rockchip_get_group_name,.get_group_pins = rockchip_get_group_pins,.dt_node_to_map = rockchip_dt_node_to_map,.dt_free_map = rockchip_dt_free_map, };
static const struct pinmux_ops rockchip_pmx_ops = {.get_functions_count = rockchip_pmx_get_funcs_count,.get_function_name = rockchip_pmx_get_func_name,.get_function_groups = rockchip_pmx_get_groups,.set_mux = rockchip_pmx_set, };
static const struct pinconf_ops rockchip_pinconf_ops = {.pin_config_get = rockchip_pinconf_get,.pin_config_set = rockchip_pinconf_set,.is_generic = true, };
三,dt_node_to_map函數
????????設備樹(Device Tree)中存放的是對硬件設備信息的描述,包含了硬件設備的配置和連接信息,例如在pinctrl節點中的引腳的配置和映射關系。而rockchip_dt_node_to_map函數的作用就是根據設備樹中的節點信息,生成對應的引腳映射數組。這個映射數組將描述硬件功能(如 復用功能和配置信息)與設備樹中的引腳信息進行綁定。
3.1pinctrl_map結構體
struct pinctrl_map{const char*dev_name; //設備名稱const char*name; //映射名稱enum pinctrl_map_type type;//映射類型const char *ctrl_dev_name; //控制設備名稱union{struct pinctrl_map_mux mux; //復用映射數據struct pinctrl_map_configs configs; //配置映射數據}data;
};
需要將設備樹上的信息來轉化為驅動中可以用的函數,放在pinctrl_map結構體中
3.2dt_node_to_map流程分析
/**傳入參數:*1,pin control class device*2,設備樹中的一個node信息*3,略*4,略*/
static int rockchip_dt_node_to_map(struct pinctrl_dev *pctldev,struct device_node *np,struct pinctrl_map **map, unsigned *num_maps)
{//獲取pinctrl信息struct rockchip_pinctrl *info = pinctrl_dev_get_drvdata(pctldev);const struct rockchip_pin_group *grp;struct pinctrl_map *new_map; //要轉化為的map數據struct device_node *parent; //存放傳入節點的父節點int map_num = 1;int i;/** 通過節點的名字獲取組的信息,并且檢查是否需要創建配置映射*/grp = pinctrl_name_to_group(info, np->name);if (!grp) {dev_err(info->dev, "unable to find group for node %pOFn\n",np);return -EINVAL;}/**grp->npins:是獲取的組里引腳的數量*/map_num += grp->npins;/**分配map_num數量的內存,首地址放在new_map中*/new_map = kcalloc(map_num, sizeof(*new_map), GFP_KERNEL);if (!new_map)return -ENOMEM;*map = new_map;*num_maps = map_num;/* create mux map */parent = of_get_parent(np);if (!parent) {kfree(new_map);return -EINVAL;}//引腳配置信息的父節點寫入map中new_map[0].type = PIN_MAP_TYPE_MUX_GROUP;new_map[0].data.mux.function = parent->name;new_map[0].data.mux.group = np->name;of_node_put(parent);/* create config map */new_map++;for (i = 0; i < grp->npins; i++) { //遍歷每一個成員//引腳配置信息寫入map中new_map[i].type = PIN_MAP_TYPE_CONFIGS_PIN;new_map[i].data.configs.group_or_pin =pin_get_name(pctldev, grp->pins[i]);new_map[i].data.configs.configs = grp->data[i].configs;new_map[i].data.configs.num_configs = grp->data[i].nconfigs;}dev_dbg(pctldev->dev, "maps: function %s group %s num %d\n",(*map)->data.mux.function, (*map)->data.mux.group, map_num);return 0;
}
四,開發板上用到的pinctrl
在設備樹下的兩個部分:
//1,在rk3568-evb1-ddr4-v10.dtsi文件的根目錄下//是一個設備,pinctrl的客戶端rk_485_ctl: rk-485-ctl {compatible = "topeet,rs485_ctl";gpios = <&gpio0 22 GPIO_ACTIVE_HIGH>;pinctrl-names = "default";pinctrl-0 = <&rk_485_gpio>; //這里就是引用了2部分的rk_485_gpio};//2,在rk3568-evb1-ddr4-v10.dtsi里的
//服務端
&pinctrl {cam {camera_pwr: camera-pwr {rockchip,pins =/* camera power en */<0 RK_PC1 RK_FUNC_GPIO &pcfg_pull_none>;};};headphone {hp_det: hp-det {rockchip,pins = <3 RK_PC2 RK_FUNC_GPIO &pcfg_pull_up>;};};rk_485{rk_485_gpio:rk-485-gpio {rockchip,pins = <3 13 RK_FUNC_GPIO &pcfg_pull_none>;};};
};