一、前言

對于一個嵌入式軟件工程師，我們的軟件模塊經(jīng)常和硬件打交道，pin control subsystem也不例外，被它驅(qū)動的硬件叫做pin controller（一般ARM soc的datasheet會把pin controller的內(nèi)容放入GPIO controller的章節(jié)中），主要功能包括：

（1）pin multiplexing。基于ARM core的嵌入式處理器一般會提供豐富的功能，例如camera interface、LCD interface、USB、I2C、SPI等等。雖然處理器有幾百個pin，但是這些pin還是不夠分配，因此有些pin需要復(fù)用。例如：127號GPIO可以做一個普通的GPIO控制LED，也可以配置成I2C的clock信號，也可以配置成SPI的data out信號。當然，這些功能不可能同時存在，因為硬件信號只有一個。

（2）pin configuration。這些配置參數(shù)包括：pull-up/down電阻的設(shè)定， tri-state設(shè)定，drive-strength的設(shè)定。

本文主要描述pin control subsystem中的low level driver，也就是驅(qū)動pin controller的driver。具體的硬件選用的是S3C2416的硬件平臺。既然是代碼分析，本文不是非常多的描述框架性的內(nèi)容，關(guān)于整個pin control subsystem軟件結(jié)構(gòu)的描述請參考Linux內(nèi)核中的GPIO系統(tǒng)之（2）。

閱讀本文需要device tree的知識，建議首先閱讀device tree代碼分析。

?

二、pin controller相關(guān)的DTS描述

類似其他的硬件，pin controller這個HW block需要是device tree中的一個節(jié)點。此外，各個其他的HW block在驅(qū)動之前也需要先配置其引腳復(fù)用功能，因此，這些device（我們稱pin controller是host，那么這些使用pin controller進行引腳配置的device叫做client device）也需要在它自己的device tree node中描述pin control的相關(guān)內(nèi)容

1、S3C2416 pin controller DTS結(jié)構(gòu)

下面的偽代碼描述了S3C2416 pin controller 的DTS結(jié)構(gòu)：

pinctrl@56000000 {??
??????? 定義S3C2416 pin controller自己的屬性

??????? 定義屬于S3C2416 pin controller的pin configurations

}

每個pin configuration都是pin controller的child node，描述了client device要使用到的一組pin的配置信息。具體如何定義pin configuration是和具體的pin controller相關(guān)的。

在pin controller node中定義pin configuration其目的是為了讓client device引用。所謂client device其實就是使用pin control subsystem提供服務(wù)的那些設(shè)備，例如串口設(shè)備。在使用之前，我們一般會在初始化代碼中配置相關(guān)的引腳功能是串口功能。有了device tree，我們可以通過device tree來傳遞這樣的信息。也就是說，各個device可以通過自己節(jié)點的屬性來指向pin controller的某個child node，也就是pin configuration了。samsung 24xx系列SOC的pin controller的pin configurations包括兩類，一類是定義pin bank，另外一類是定義功能復(fù)用配置。

2、pin configuration定義

我們舉兩個簡單的例子（當然一個是pin bank，另外一個是定義功能復(fù)用配置）來理解pin configuration第一個例子是描述pin bank：

pinctrl@56000000 {??
??????? 定義S3C2416 pin controller自己的屬性

……

??????? gpf {?
??????????? gpio-controller;?
??????????? #gpio-cells = <0x2>;?
??????????? interrupt-controller;?
??????????? #interrupt-cells = <0x2>;?
??????????? linux,phandle = <0xc>;?
??????????? phandle = <0xc>;?
??????? };

……

}

其實S3C2416 pin controller定義了gpa到gpm共計11個sub node，每個sub node是描述S3C2416 GPIO controller的各個bank信息。S3C2416有138個I/O 端口（或者叫做pin、finger、pad）這些端口分成了11個bank（這里沒有用group這個術(shù)語，為了和pin group這個概念區(qū)分開，pin group的概念下面會具體描述）：

Port A(GPA) : 25-output port?
Port B(GPB) : 9-input/output port?
Port C(GPC) : 16-input/output port?
Port D(GPD) : 16-input/output port?
Port E(GPE) : 16-input/output port?
Port F(GPF) : 8-input/output port?
Port G(GPG) : 8-input/output port?
Port H(GPH) : 15-input/output port?
Port K(GPK) : 16-input/output port?
Port L(GPL) : 7-input/output port?
Port M(GPM) : 2-input port

之所以分成bank，主要是把特性相同的GPIO進行分組，方便控制。例如：這些bank中，只有GPF和GPG這兩個bank上的引腳有中斷功能，其他的都沒有。interrupt-controller這個屬性相信大家已經(jīng)熟悉，就是說明該node是一個interrupt controller。gpio-controller類似，說明該device node是一個GPIO controller。#gpio-cells屬性是一個GPIO controller的必須定義的屬性，它描述了需要多少個cell來具體描述一個GPIO（這是和具體的GPIO controller相關(guān)的）。#interrupt-cells的概念類似，不再贅述。phandle（linux,phandle這個屬性和phandle是一樣的，只不過linux,phandle是old-style，多定義一個屬性是為了兼容）定義了一個句柄，當其他的device node想要引用這個node的時候就可以使用該句柄。具體的例子參考下節(jié)client device的DTS的描述。

另外一個例子是uart的pin configuration，代碼如下：

pinctrl@56000000 {??
??????? 定義S3C2416 pin controller自己的屬性

……

uart0-data {?
??? samsung,pins = "gph-0", "gph-1";?
??? samsung,pin-function = <0x2>;?
??? linux,phandle = <0x2>;?
??? phandle = <0x2>;?
};

uart0-fctl {?
??? samsung,pins = "gph-8", "gph-9";?
??? samsung,pin-function = <0x2>;?
??? linux,phandle = <0x3>;?
??? phandle = <0x3>;?
};

……

}

samsung,pins這個屬性定義了一個pin configuration所涉及到的引腳定義。對于uart0-data這個node，該配置涉及了gph bank中的第一個和第二個GPIO pin。一旦選擇了一個功能，那么samsung,pins定義的所有的引腳都需要做相應(yīng)的功能設(shè)定，那么具體設(shè)定什么值呢？這就是samsung,pin-function定義的內(nèi)容了。而具體設(shè)定哪個值則需要去查閱datasheet了。對于uart0-data，向gph bank中的第一個和第二個GPIO pin對應(yīng)的配置寄存器中寫入2就可以把這兩個pin定義為uart功能。

3.client device的DTS

一個典型的device tree中的外設(shè)node定義如下：

device-node-name {??
??????? 定義該device自己的屬性??

??????? pinctrl-names = "sleep", "active";－－－－－－（1）?
??????? pinctrl-0 =?<pin-config-0-a>;－－－－－－－－－－－－－－（2）?
??????? pinctrl-1 =?<pin-config-1-a pin-config-1-b>;?????????
??? };

（1）pinctrl-names定義了一個state列表。那么什么是state呢？具體說應(yīng)該是pin state，對于一個client device，它使用了一組pin，這一組pin應(yīng)該同時處于某種狀態(tài)，畢竟這些pin是屬于一個具體的設(shè)備功能。state的定義和電源管理關(guān)系比較緊密，例如當設(shè)備active的時候，我們需要pin controller將相關(guān)的一組pin設(shè)定為具體的設(shè)備功能，而當設(shè)備進入sleep狀態(tài)的時候，需要pin controller將相關(guān)的一組pin設(shè)定為普通GPIO，并精確的控制GPIO狀態(tài)以便節(jié)省系統(tǒng)的功耗。state有兩種，標識，一種就是pinctrl-names定義的字符串列表，另外一種就是ID。ID從0開始，依次加一。根據(jù)例子中的定義，state ID等于0（名字是active）的state對應(yīng)pinctrl-0屬性，state ID等于1（名字是idle）的state對應(yīng)pinctrl-1屬性。具體設(shè)備state的定義和各個設(shè)備相關(guān)，具體參考在自己的device bind。

（2）pinctrl-x的定義。pinctrl-x是一個句柄（phandle）列表，每個句柄指向一個pin configuration。有時候，一個state對應(yīng)多個pin configure。例如在active的時候，I2C功能有兩種配置，一種是從pin ID{7,8}引出，另外一個是從pin ID{69,103}引出。

我們選取samsung串口的dts定義如下：

serial@50000000 {??
??????? ……?
??????? pinctrl-names = "default";?
??????? pinctrl-0 = <0x2 0x3>;?
??? };

該serial device只定義了一個state就是default，對應(yīng)pinctrl-0屬性定義。pinctrl-0是一個句柄（phandle）列表，每個句柄指向一個pin configuration。0x2對應(yīng)上節(jié)中的uart0-data節(jié)點，0x03對應(yīng)uart0-fctl 節(jié)點，也就是說，這個串口有兩種配置，一種是從gph bank中的第一個和第二個GPIO pin引出，另外一個是從gph bank中的第8個和第9個GPIO pin引出。

?

三、 pin controller driver初始化

1、注冊pin control device

舊的內(nèi)核一般是在machine相關(guān)的代碼中建立靜態(tài)的platform device的數(shù)據(jù)結(jié)構(gòu)，然后在machine初始化的時候，將靜態(tài)定義的platform device注冊到系統(tǒng)。不過在引入device tree之后，事情發(fā)生了變化。

根據(jù)device tree代碼分析，我們知道，在系統(tǒng)初始化的時候，dts描述的device node會形成一個樹狀結(jié)構(gòu)，在machine初始化的過程中，會scan device node的樹狀結(jié)構(gòu)，將真正的硬件device node變成一個個的設(shè)備模型中的device結(jié)構(gòu)（比如struct platform_device）并加入到系統(tǒng)中。我們看看具體2416描述pin controller的dts code，如下：

pinctrl@56000000 {?
??????? reg = <0x56000000 0x1000="">;?
??????? compatible = "samsung,s3c2416-pinctrl";

……省略wakeup的pin configuration

……省略gpb～gpm這些pink bank的pin configuration

……省略Pin groups的相關(guān)描述

}

reg屬性描述pin controller硬件的地址信息，開始地址是0x56000000 ，地址長度是0x1000。compatible屬性用來描述pin controller的programming model。該屬性的值是string list，定義了一系列的modle（每個string是一個model）。這些字符串列表被操作系統(tǒng)用來選擇用哪一個pin controller driver來驅(qū)動該設(shè)備，后面的代碼會更詳細的描述。 pin control subsystem要想進行控制，必須首先了解自己控制的對象，也就是說軟件需要提供一個方法將各種硬件信息（total有多少可控的pin，有多少bank，pin的復(fù)用情況以及pin的配置情況）注冊到pin control subsystem中，這也是pin controller driver的初始化的主要內(nèi)容。這些信息當然可以通過定義靜態(tài)的表格（參考linux/drivers/pinctrl目錄下的pinctrl-u300.c文件，該文件定義了一個大數(shù)組u300_pads來描述每一個pin），也可以通過dts加上靜態(tài)表格的方式（2416采用的方式）。

2、注冊pin controller driver

當然，pinctrl@56000000這個device node也會變成一個platform device加入系統(tǒng)。有了device，那么對應(yīng)的platform driver是如何注冊到系統(tǒng)中的呢？代碼如下：

static int __init samsung_pinctrl_drv_register(void)?
{?
?? ……

??? return platform_driver_register(&samsung_pinctrl_driver);?
}

系統(tǒng)初始化的時候，該函數(shù)會執(zhí)行，向系統(tǒng)注冊了samsung_pinctrl_driver：

static struct platform_driver samsung_pinctrl_driver = {?
??? .probe??????? = samsung_pinctrl_probe, －－－－該driver的初始化函數(shù)?
??? .driver = {?
??????? .name??? = "samsung-pinctrl",?
??????? .owner??? = THIS_MODULE,?
??????? .of_match_table = samsung_pinctrl_dt_match, －－－－匹配列表?
??? },?
};

?

3、probe過程（driver初始化過程）

在linux kernel引入統(tǒng)一設(shè)備模型之后，bus、driver和device形成了設(shè)備模型中的鐵三角。對于platform這種類型的bus，其鐵三角數(shù)據(jù)是platform_bus_type（表示platform這種類型的bus）、struct platform_device（platform bus上的device）、struct platform_driver（platform bus上的driver）。統(tǒng)一設(shè)備模型大大降低了驅(qū)動工程師的工作量，驅(qū)動工程師只要將driver注冊到系統(tǒng)即可，剩余的事情交給統(tǒng)一設(shè)備模型來完成。每次系統(tǒng)增加一個platform_driver，platform_bus_type都會啟動scan過程，讓新加入的driver掃描整個platform bus上的device的鏈表，看看是否有device讓該driver驅(qū)動。同樣的，每次系統(tǒng)增加一個platform_device，platform_bus_type也會啟動scan過程，遍歷整個platform bus上的driver的鏈表，看看是否有適合驅(qū)動該device的driver。具體匹配的代碼是platform bus上的match函數(shù)，如下：

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);

??? /* Attempt an OF style match first */?
??? if (of_driver_match_device(dev, drv))?
??????? return 1;

??? /* Then try ACPI style match */?
??? if (acpi_driver_match_device(dev, drv))?
??????? return 1;

??? /* Then try to match against the id table */?
??? 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的匹配函數(shù)就是簡單的比較device和driver的名字，多么簡單，多么清晰，真是有點懷念過去單純而美好的生活。當然，事情沒有那么糟糕，我們這里只要關(guān)注OF style的匹配過程即可，思路很簡單，解鈴還需系鈴人，把匹配過程推給device tree模塊，代碼如下：

const struct of_device_id *of_match_device(const struct of_device_id *matches,?
?????????????????????? const struct device *dev)?
{?
??? if ((!matches) || (!dev->of_node))?
??????? return NULL;?
??? return of_match_node(matches, dev->of_node);?
}

platform driver提供了match table（struct device_driver 中的of_match_table的成員）。platform device提供了device tree node（struct device中的of_node成員）。對于我們這個場景，match table是samsung_pinctrl_dt_match，代碼如下：

static const struct of_device_id samsung_pinctrl_dt_match[] = {?
……?
??? { .compatible = "samsung,s3c2416-pinctrl",?
??????? .data = s3c2416_pin_ctrl },?
……?
??? {},?
};

再去看看dts中pin controller的節(jié)點compatible屬性的定義，你會禁不住感慨：啊，終于遇到對的人。這里還要特別說明的是data成員被設(shè)定為s3c2416_pin_ctrl ，它描述了2416的HW pin controller，我們稱之samsung pin controller的描述符，初始化的過程中需要這個數(shù)據(jù)結(jié)構(gòu)，后面還會詳細介紹它。一旦pin controller這個device遇到了適當?shù)膁river，就會調(diào)用probe函數(shù)進行具體的driver初始化的動作了，代碼如下：

static int samsung_pinctrl_probe(struct platform_device *pdev)?
{?
??? struct samsung_pinctrl_drv_data *drvdata;?
??? struct device *dev = &pdev->dev;?
??? struct samsung_pin_ctrl *ctrl;?
??? struct resource *res;?
??? int ret;

??? drvdata = devm_kzalloc(dev, sizeof(*drvdata), GFP_KERNEL); －－－－－－（1）

??? ctrl = samsung_pinctrl_get_soc_data(drvdata, pdev); －－－－－－－－－－（2）?
??? drvdata->ctrl = ctrl;?
??? drvdata->dev = dev;

??? res = platform_get_resource(pdev, IORESOURCE_MEM, 0); －－－－－分配memory資源?
??? drvdata->virt_base = devm_ioremap_resource(&pdev->dev, res);?
??? if (IS_ERR(drvdata->virt_base))?
??????? return PTR_ERR(drvdata->virt_base);

??? res = platform_get_resource(pdev, IORESOURCE_IRQ, 0); －－－－－－分配IRQ資源?
??? if (res)?
??????? drvdata->irq = res->start;

??? ret = samsung_gpiolib_register(pdev, drvdata); －－－－－－－－－－－－－（3）

??? ret = samsung_pinctrl_register(pdev, drvdata); －－－－－－－－－－－－－（4）

??? if (ctrl->eint_gpio_init) －－－－－－－－－－－－－－－－－－（5）?
??????? ctrl->eint_gpio_init(drvdata);?
??? if (ctrl->eint_wkup_init)?
??????? ctrl->eint_wkup_init(drvdata);

??? platform_set_drvdata(pdev, drvdata); －設(shè)定platform device的私有數(shù)據(jù)為samsung_pinctrl_drv_data

??? /* Add to the global list */?
??? list_add_tail(&drvdata->node, &drvdata_list); －－掛入全局鏈表

??? return 0;?
}

（1）devm_kzalloc函數(shù)是為struct samsung_pinctrl_drv_data數(shù)據(jù)結(jié)構(gòu)分配內(nèi)存。每當driver probe一個具體的device實例的時候，都需要建立一些私有的數(shù)據(jù)結(jié)構(gòu)來保存該device的一些具體的硬件信息（本場景中，這個數(shù)據(jù)結(jié)構(gòu)就是struct samsung_pinctrl_drv_data）。在過去，驅(qū)動工程師多半使用kmalloc或者kzalloc來分配內(nèi)存，但這會帶來一些潛在的問題。例如：在初始化過程中，有各種各樣可能的失敗情況，這時候就依靠driver工程師小心的撰寫代碼，釋放之前分配的內(nèi)存。當然，初始化過程中，除了memory，driver會為probe的device分配各種資源，例如IRQ 號，io memory map、DMA等等。當初始化需要管理這么多的資源分配和釋放的時候，很多驅(qū)動程序都出現(xiàn)了資源管理的issue。而且，由于這些issue是異常路徑上的issue，不是那么容易測試出來，更加重了解決這個issue的必要性。內(nèi)核解決這個問題的模式（所謂解決一類問題的設(shè)計方法就叫做設(shè)計模式）是Devres，即device resource management軟件模塊。更細節(jié)的內(nèi)容就不介紹了，其核心思想就是資源是設(shè)備的資源，那么資源的管理歸于device，也就是說不需要driver過多的參與。當device和driver detach的時候，device會自動的釋放其所有的資源。

（2）分配了struct samsung_pinctrl_drv_data數(shù)據(jù)結(jié)構(gòu)的內(nèi)存，當然下一步就是初始化這個數(shù)據(jù)結(jié)構(gòu)了。我們先看看2416的pin controller driver是如何定義該數(shù)據(jù)結(jié)構(gòu)的：

struct samsung_pinctrl_drv_data {?
??? struct list_head??????? node;－－－－－－－－－多個pin controller的描述符可以形成鏈表?
??? void __iomem??????????? *virt_base;－－－－－－－－－訪問硬件寄存器的基地址?
??? struct device??????????? *dev;－－－－－－－－－－－和platform device建立聯(lián)系?
??? int??????????????? irq; －－－－－－－－irq number，對于2416 pin control硬件而言，不需要irq資源

??? struct samsung_pin_ctrl??????? *ctrl;－－－－samsung pin controller描述符?
??? struct pinctrl_desc??????? pctl; －－－－－－指向pin control subsystem中core driver中抽象的

????????????????????????????????????????????????????????????? pin controller描述符。?
??? struct pinctrl_dev??????? *pctl_dev; －－－－－－指向core driver的pin controller class device

??? const struct samsung_pin_group??? *pin_groups; －描述samsung pin controller中pin groups的信息?
??? unsigned int??????????? nr_groups; －－－－－－－－描述samsung pin controller中pin groups的數(shù)目?
??? const struct samsung_pmx_func??? *pmx_functions; －－描述samsung pin controller中function信息
??? unsigned int??????????? nr_functions; －－－－－－－－描述samsung pin controller中function的數(shù)目?
};

struct pinctrl_desc和struct pinctrl_dev 都是pin control subsystem中core driver的概念。各個具體硬件的pin controller可能會各不相同，但是可以抽取其共同的部分來形成一個HW independent的數(shù)據(jù)結(jié)構(gòu)，這個數(shù)據(jù)就是pin controller描述符，在core driver中用struct pinctrl_desc表示，具體該數(shù)據(jù)結(jié)構(gòu)的定義如下：

struct pinctrl_desc {?
??? const char *name;?
??? struct pinctrl_pin_desc const *pins;－－－指向npins個pin描述符，每個描述符描述一個pin?
??? unsigned int npins;－－－－－－－－－－－－該pin controller中有多少個可控的pin?
??? const struct pinctrl_ops *pctlops;－－－－－－callback函數(shù)，是core driver和底層driver的接口?
??? const struct pinmux_ops *pmxops;－－－－－callback函數(shù)，是core driver和底層driver的接口?
??? const struct pinconf_ops *confops;－－－－－callback函數(shù)，是core driver和底層driver的接口?
??? struct module *owner;?
};

其實整個初始化過程的核心思想就是low level的driver定義一個pinctrl_desc ，設(shè)定pin相關(guān)的定義和callback函數(shù)，注冊到pin control subsystem中。我們用引腳描述符（pin descriptor）來描述一個pin。在pin control subsystem中，struct pinctrl_pin_desc用來描述一個可以控制的引腳，我們稱之引腳描述符，代碼如下：

struct pinctrl_pin_desc {?
??? unsigned number;－－－－－－－ID，在本pin controller中唯一標識該引腳?
??? const char *name;－－－－－－－user friedly name?
??? void *drv_data;?
};

冰冷的pin ID是給機器用的，而name是給用戶使用的，是ascii字符。

struct pinctrl_dev在pin control subsystem的core driver中抽象一個pin control device。其實我們可以通過多個層面來定義一個device。在這個場景下，pin control subsystem的core driver關(guān)注的是一類pin controller的硬件設(shè)備，具體其底層是什么硬件連接方式，使用什么硬件協(xié)議它不關(guān)心，它關(guān)心的是pin controller這類設(shè)備所有的通用特性和功能。當然2416的pin controller是通過platform bus連接的，因此，在low level的層面，需要一個platform device來標識2416的pin controller（需要注意的是：pin controller class device和platform device都是基于一個驅(qū)動模型中的device派生而來的，這里struct device是基類，struct pinctrl_dev和struct platform_device都是派生類，當然c本身不支持class，但面向?qū)ο蟮母拍钍峭瑯拥?#xff09;。為了充分理解class這個概念，我們再舉一個例子。對于audio的硬件抽象層，它應(yīng)該管理所有的audio設(shè)備，因此這個軟件模塊應(yīng)該有一個audio class的鏈表，連接了所有的系統(tǒng)中的audio設(shè)備。但這些具體的audio設(shè)備可能是PCI接口的audio設(shè)備，也可能是usb接口的audio設(shè)備，從具體的總線層面來看，也會有PCI或者USB設(shè)備來抽象對應(yīng)的聲卡設(shè)備。

OK，我們再看看samsung_pinctrl_drv_data底部四個成員，要理解該數(shù)據(jù)結(jié)構(gòu)底部的四個成員，還要理解什么是pin mux function，什么是pin group。對于SOC而言，其引腳除了配置成普通GPIO之外，若干個引腳還可以組成一個pin group，形成特定的功能。例如pin number是{ 0, 8, 16, 24 }這四個引腳組合形成一個pin group，提供SPI的功能。既然有了pin group的概念，為何又有function這個概念呢？什么是function呢？SPI是function，I2C也是一個function，當然GPIO也是一個function。一個function有可能對應(yīng)一組或者多組pin。例如：為了設(shè)計靈活，芯片內(nèi)部的SPI0的功能可能引出到pin group { A8, A7, A6, A5 }，也可能引出到另外一個pin group{ G4, G3, G2, G1 }，但毫無疑問，這兩個pin group不能同時active，畢竟芯片內(nèi)部的SPI0的邏輯功能電路只有一個。 從這個角度看，pin control subsystem要進行功能設(shè)定的時候必須要給出function以及function的pin group才能確定所有的物理pin的位置。

我們前面已經(jīng)說過了，struct samsung_pinctrl_drv_data數(shù)據(jù)結(jié)構(gòu)就是2416的pin controller driver要驅(qū)動2416的HW pin controller的私有數(shù)據(jù)結(jié)構(gòu)。這個數(shù)據(jù)結(jié)構(gòu)中最重要的就是samsung pin controller描述符了。關(guān)于pin controller有兩個描述符，一個是struct pinctrl_desc，是具體硬件無關(guān)的pin controller的描述符。struct samsung_pin_ctrl描述的具體samsung pin controller硬件相關(guān)的信息，比如說：pin bank的信息，不是所有的pin controller都是分bank的，因此pin bank的信息只能封裝在low level的samsung pin controller driver中。這個數(shù)據(jù)結(jié)構(gòu)定義如下：

struct samsung_pin_ctrl {?
??? struct samsung_pin_bank??? *pin_banks;－－－－定義具體的pin bank信息?
??? u32??????? nr_banks; －－－－－－－－－number of pin bank

??? u32??????? base;－－－－該pin controller的pin ID base。?
??? u32??????? nr_pins; －－－－－總的可以控制的pin的數(shù)目

其他成員和本場景無關(guān)，和GPIO type的中斷控制器驅(qū)動代碼有關(guān)?
};

關(guān)于上面的base可以多說兩句。實際上，系統(tǒng)支持多個pin controller設(shè)備，這時候，系統(tǒng)要管理多個pin controller控制下的多個pin。每個pin有自己的pin ID，是唯一的，假設(shè)系統(tǒng)中有兩個pin controller，一個是A，控制32個，另外一個是B，控制64個pin，我們可以統(tǒng)一編號，對A，pin ID從0～31，對于B，pin ID是從32～95。對于B，其pin base就是32。

samsung_pinctrl_probe->samsung_pinctrl_get_soc_data函數(shù)中會根據(jù)device tree的信息和靜態(tài)定義的table來初始化該描述符，具體的代碼如下：

static struct samsung_pin_ctrl *samsung_pinctrl_get_soc_data(?
??????????????? struct samsung_pinctrl_drv_data *d,?
??????????????? struct platform_device *pdev)?
{?
??? int id;?
??? const struct of_device_id *match;?
??? struct device_node *node = pdev->dev.of_node; －－－獲取device tree中的device node指針?
??? struct device_node *np;?
??? struct samsung_pin_ctrl *ctrl;?
??? struct samsung_pin_bank *bank;?
??? int i;

??? id = of_alias_get_id(node, "pinctrl");?
??? match = of_match_node(samsung_pinctrl_dt_match, node);?
??? ctrl = (struct samsung_pin_ctrl *)match->data + id; －－－－－－－－A

??? bank = ctrl->pin_banks;?
??? for (i = 0; i < ctrl->nr_banks; ++i, ++bank) {－－－－－－－－－－－－B??
??????? spin_lock_init(&bank->slock);?
??????? bank->drvdata = d;?
??????? bank->pin_base = ctrl->nr_pins; －－－ctrl->nr_pins初始的時候等于0，最后完成bank初始化后，

??????????????????????????????????????????????????????????????? 該值等于total的pin number。?
??????? ctrl->nr_pins += bank->nr_pins;?
??? }

for_each_child_of_node(node, np) {? －－－－－－－－－－－－－－－－C?
??????? if (!of_find_property(np, "gpio-controller", NULL))?
??????????? continue;?
??????? bank = ctrl->pin_banks;?
??????? for (i = 0; i < ctrl->nr_banks; ++i, ++bank) {?
??????????? if (!strcmp(bank->name, np->name)) {?
??????????????? bank->of_node = np;?
??????????????? break;?
??????????? }?
??????? }?
??? }?

ctrl->base = pin_base; －－－－－－－－－－－－－－－－－－－－－－D?
??? pin_base += ctrl->nr_pins;

??? return ctrl;?
}

samsung_pinctrl_get_soc_data這個函數(shù)名字基本反應(yīng)了其功能，2416是samsung的一個具體的SOC型號，調(diào)用該函數(shù)可以返回一個表示2416 SOC的samsung pin controller的描述符。

A：這段代碼主要是獲取具體的2416的HW pin controller的信息，該數(shù)據(jù)結(jié)構(gòu)在上文中出現(xiàn)過（具體參考pin controller的device tree match table：samsung_pinctrl_dt_match），就是s3c2416_pin_ctrl這個變量。這個變量定義了2416的pin controller的信息（S3C2416的pin controller的pin bank信息是定義在pin controller driver的靜態(tài)數(shù)據(jù)，其實最好在dts中定義）如下：

struct samsung_pin_ctrl s3c2416_pin_ctrl[] = {?
??? {?
??????? .pin_banks??? = s3c2416_pin_banks,－－－－－－靜態(tài)定義的2416的pin bank的信息?
??????? .nr_banks??? = ARRAY_SIZE(s3c2416_pin_banks),?
??????? .eint_wkup_init = s3c24xx_eint_init,?
??????? .label??????? = "S3C2416-GPIO",?
??? },?
};

這個變量中包含了2416的pin bank的信息，包括：有多少個pin bank，每個bank中有多少個pin，pin bank的名字是什么，寄存器的offset是多少。這些信息用來初始化pin controller描述符數(shù)據(jù)結(jié)構(gòu)。

B：初始化2416 samsung pin controller中各個bank的描述符。

C：device tree中表示pin controller的device node有若干的child node，分別表示gpa～gpl這11個bank，每個bank都是一個gpio controller。下面的代碼遍歷各個child node，并初始化各個bank描述符中的device tree node成員。 這里需要注意的是靜態(tài)定義的pin bank的名字要和dts文件中定義的pin bank node的名字一樣。

D：系統(tǒng)中有可能有多個pin controller，多個pin controller上的pin ID 應(yīng)該是系統(tǒng)唯一的，ctrl->base表示本pin controller中的pin ID的起始值。

（3）本來pin control subsystem和GPIO subsystem應(yīng)該是無關(guān)的兩個子系統(tǒng)，應(yīng)該各自進行自己的初始化過程。但實際中，由于硬件的復(fù)雜性，這兩個子系統(tǒng)耦合性非常高。這里samsung_gpiolib_register函數(shù)就是把各個bank代表的gpio chip注冊到GPIO subsystem中。更具體的信息請參考GPIO subsystem軟件框架文檔。

（4）samsung_pinctrl_register函數(shù)的主要功能是將本pin controller注冊到pin control subsystem。代碼如下：

static int samsung_pinctrl_register(struct platform_device *pdev,?
??????????????????? struct samsung_pinctrl_drv_data *drvdata)?
{?
??? struct pinctrl_desc *ctrldesc = &drvdata->pctl;?
??? struct pinctrl_pin_desc *pindesc, *pdesc;?
??? struct samsung_pin_bank *pin_bank;?
??? char *pin_names;?
??? int pin, bank, ret;

??? ctrldesc->name = "samsung-pinctrl";－－－－－－－－A?
??? ctrldesc->owner = THIS_MODULE;?
??? ctrldesc->pctlops = &samsung_pctrl_ops; －－－call 函數(shù)，具體參考第四章的內(nèi)容?
??? ctrldesc->pmxops = &samsung_pinmux_ops;?
??? ctrldesc->confops = &samsung_pinconf_ops;

??? pindesc = devm_kzalloc(&pdev->dev, sizeof(*pindesc) *－－－－－－－B?
??????????? drvdata->ctrl->nr_pins, GFP_KERNEL);?
??? ctrldesc->pins = pindesc;?
??? ctrldesc->npins = drvdata->ctrl->nr_pins;??
??? for (pin = 0, pdesc = pindesc; pin < ctrldesc->npins; pin++, pdesc++)－－－C?
??????? pdesc->number = pin + drvdata->ctrl->base;

??? pin_names = devm_kzalloc(&pdev->dev, sizeof(char) * PIN_NAME_LENGTH *－－－B?
??????????????????? drvdata->ctrl->nr_pins, GFP_KERNEL);

??? for (bank = 0; bank < drvdata->ctrl->nr_banks; bank++) { －－－－－－－－－C?
??????? pin_bank = &drvdata->ctrl->pin_banks[bank];?
??????? for (pin = 0; pin < pin_bank->nr_pins; pin++) {?
??????????? sprintf(pin_names, "%s-%d", pin_bank->name, pin);?
??????????? pdesc = pindesc + pin_bank->pin_base + pin;?
??????????? pdesc->name = pin_names;?
??????????? pin_names += PIN_NAME_LENGTH;?
??????? }?
??? }

??? ret = samsung_pinctrl_parse_dt(pdev, drvdata);－－－－－－D

??? drvdata->pctl_dev = pinctrl_register(ctrldesc, &pdev->dev, drvdata);－－－E

??? for (bank = 0; bank < drvdata->ctrl->nr_banks; ++bank) {－－－－－F?
??????? pin_bank = &drvdata->ctrl->pin_banks[bank];?
??????? pin_bank->grange.name = pin_bank->name;?
??????? pin_bank->grange.id = bank;?
??????? pin_bank->grange.pin_base = pin_bank->pin_base;?
??????? pin_bank->grange.base = pin_bank->gpio_chip.base;?
??????? pin_bank->grange.npins = pin_bank->gpio_chip.ngpio;?
??????? pin_bank->grange.gc = &pin_bank->gpio_chip;?
??????? pinctrl_add_gpio_range(drvdata->pctl_dev, &pin_bank->grange);?
??? }

??? return 0;?
}

A：初始化硬件無關(guān)的pin controller描述符（struct samsung_pinctrl_drv_data中的pctl成員）。該數(shù)據(jù)結(jié)構(gòu)中還包含了所有pin的描述符的信息，這些pin descriptor所需要的內(nèi)存在步驟B中分配

B：初始化過程中涉及不少內(nèi)存分配，這些內(nèi)存主要用于描述每一個pin（術(shù)語叫做pin descriptor）以及pin name。

C：初始化每一個pin 描述符的名字和ID。對于samsung的pin描述符，其名字使用pin-bank name + pin ID的形式。 ID的分配是從該pin controller的pin base開始分配ID的，逐個加一。

D：初始化pin group和function（具體內(nèi)容在下節(jié)描述）

E：調(diào)用pinctrl_register注冊到pin control subsystem 。這是pin control subsystem的核心函數(shù)，可以參考GPIO系統(tǒng)之2的描述。

F：在這里又不得不進行pin control subsystem和GPIO系統(tǒng)的耦合了。每個bank都是一個GPIO controller，但是pin bank使用的ID是pin control space中的ID，GPIO 子系統(tǒng)中使用的是GPIO space的ID，對于pin control subsystem而言，它需要建立這兩個ID的映射關(guān)系。pinctrl_add_gpio_range就是起這個作用的。更具體的內(nèi)容請參考pin control subsystem軟件結(jié)構(gòu)文檔。 需要注意的是直接在pin controller driver中調(diào)用pinctrl_add_gpio_range是不推薦的，建議使用dts的方式在GPIO controller設(shè)備節(jié)點中描述。

（5）這里的代碼是向kernel中的中斷子系統(tǒng)注冊interrupt controller。對于2416，有兩個bank有中斷功能，gpf和gpg，本質(zhì)上gpf和gpg就是兩個interrupt controller，掛接在2416真正的那個interrupt contrller之下，形成樹狀結(jié)構(gòu)。具體的代碼就不分析了，請參考GPIO類型的中斷控制器代碼分析。

?

4、pin control subsystem如何獲取pin group的信息

具體的代碼如下：

static int samsung_pinctrl_parse_dt(struct platform_device *pdev,?
??????????????????? struct samsung_pinctrl_drv_data *drvdata)?
{?
??? struct device *dev = &pdev->dev;?
??? struct device_node *dev_np = dev->of_node;?
??? struct device_node *cfg_np;?
??? struct samsung_pin_group *groups, *grp;?
??? struct samsung_pmx_func *functions, *func;?
??? unsigned *pin_list;?
??? unsigned int npins, grp_cnt, func_idx = 0;?
??? char *gname, *fname;?
??? int ret;

??? grp_cnt = of_get_child_count(dev_np); －－－－－－（1）

??? groups = devm_kzalloc(dev, grp_cnt * sizeof(*groups), GFP_KERNEL); －－－－（2）?
??? grp = groups;

??? functions = devm_kzalloc(dev, grp_cnt * sizeof(*functions), GFP_KERNEL); －－－（2）?
??? func = functions;

??? for_each_child_of_node(dev_np, cfg_np) { －－－－遍歷pin control的所有的child node?
??????? u32 function;??
????? if (!of_find_property(cfg_np, "samsung,pins", NULL)) －忽略掉那些沒有samsung,pins屬性的node?
??????????? continue;

??????? ret = samsung_pinctrl_parse_dt_pins(pdev, cfg_np, －－－－－－－－（3）?
??????????????????? &drvdata->pctl,??? &pin_list, &npins);?
??????? if (ret)?
??????????? return ret;

??????? /* derive pin group name from the node name */??
? gname = devm_kzalloc(dev, strlen(cfg_np->name) + GSUFFIX_LEN, －分配pin group名字需要的內(nèi)存
??????????????????? GFP_KERNEL);

??? sprintf(gname, "%s%s", cfg_np->name, GROUP_SUFFIX);－－添加“-grp”的后綴

??????? grp->name = gname; －－－－－－－－－－－－－－－－（4）?
??????? grp->pins = pin_list;?
??????? grp->num_pins = npins;?
??????? of_property_read_u32(cfg_np, "samsung,pin-function", &function);?
??????? grp->func = function;?
??????? grp++;

??????? if (!of_find_property(cfg_np, "samsung,pin-function", NULL))??
??????????? continue; －－－－忽略掉那些沒有samsung,pin-function屬性的node

??????? /* derive function name from the node name */?
??????? fname = devm_kzalloc(dev, strlen(cfg_np->name) + FSUFFIX_LEN,?
??????????????????? GFP_KERNEL);??
??????? sprintf(fname, "%s%s", cfg_np->name, FUNCTION_SUFFIX); －－－－－（5）

??????? func->name = fname;?
??????? func->groups = devm_kzalloc(dev, sizeof(char *), GFP_KERNEL); －－－－（6）?
??????? if (!func->groups) {?
??????????? dev_err(dev, "failed to alloc memory for group list "?
??????????????????? "in pin function");?
??????????? return -ENOMEM;?
??????? }?
??????? func->groups[0] = gname;?
??????? func->num_groups = 1;?
??????? func++;?
??????? func_idx++;?
??? }

??? drvdata->pin_groups = groups; －－－－最終，pin group和function的信息被copy到pin controller

??????????????????????????????????????????????????????????? driver的私有數(shù)據(jù)結(jié)構(gòu)struct samsung_pinctrl_drv_data 中?
??? drvdata->nr_groups = grp_cnt;?
??? drvdata->pmx_functions = functions;?
??? drvdata->nr_functions = func_idx;

??? return 0;?
}

（1）pin controller的device node有若干個child node，每個child node都描述了一個pin configuration。of_get_child_count函數(shù)可以獲取pin configuration的數(shù)目。

（2）根據(jù)pin configuration的數(shù)目分配內(nèi)存。在這里共計分配了兩片內(nèi)存，一片保存了所有pin group的信息（struct samsung_pin_group ），一片保存了pin mux function的信息（struct samsung_pmx_func）。實際上，分配pin configuration的數(shù)目的內(nèi)存有些浪費，因為不是每一個pin control的child node都是和pin group相關(guān)（例如pin bank node就是和pin group無關(guān)）。對于function，就更浪費了，因為有可能多個pin group對應(yīng)一個function。

（3）samsung_pinctrl_parse_dt_pins函數(shù)主要分析samsung,pins這個屬性，并根據(jù)屬性值返回一個pin list，該list中每個entry是一個pin ID。

（4）初始化samsung pin group的描述符。具體的數(shù)據(jù)結(jié)構(gòu)解釋如下：

struct samsung_pin_group {?
??? const char??????? *name;－－－－－－－－－pin group的名字，名字是device tree node name＋-grp?
??? const unsigned int??? *pins;－－－－－－－pin list的信息?
??? u8??????????? num_pins;－－－－－－－－－－pin list中的數(shù)目?
??? u8??????????? func;－－－－－－－－－－－－對應(yīng)samsung,pin-function屬性的值，用來配置pin list中各個pin的功能設(shè)定寄存器?
};

（5）一個pin configuration的device tree node被解析成兩個描述符，一個是samsung pin group的描述符，另外一個是samsung pin mux function描述符。這兩個描述符的名字都是根據(jù)dts file中的pin configuration的device node name生成，只不過pin group的名字附加-grp的后綴，而function描述符的名字后面附加-mux的后綴。

（6）對于samsung pin mux function描述符解釋如下：

struct samsung_pmx_func {?
??? const char??????? *name;－－－－－－pin function的名字，名字是device tree node name＋-mux

??? const char??????? **groups;－－－－－指向pin groups的指針數(shù)組?
??? u8??????????? num_groups;－－－－－－屬于該function的pin group的個數(shù)?
};

在具體的代碼實現(xiàn)中num_groups總是等于1。

?

四、S3C2416 pin controller driver的操作函數(shù)

1、操作函數(shù)概述

pin controller描述符中包括了三類操作函數(shù)：pctlops是一些全局的控制函數(shù)，pmxops是復(fù)用引腳相關(guān)的操作函數(shù)，confops操作函數(shù)是用來配置引腳的特性（例如：pull-up/down）。這些callback函數(shù)都是和具體的底層pin controller的操作相關(guān)。

本章節(jié)主要描述這些call back函數(shù)的邏輯，這些callback的調(diào)用時機不會在這里描述，那些內(nèi)容請參考pin control subsystem的描述。

2、struct pinctrl_ops中各個callback函數(shù)的具體的解釋如下：

（1）samsung_get_group_count

該函數(shù)的代碼如下：

static int samsung_get_group_count(struct pinctrl_dev *pctldev)?
{?
??? struct samsung_pinctrl_drv_data *drvdata;

??? drvdata = pinctrl_dev_get_drvdata(pctldev);?
??? return drvdata->nr_groups;?
}

該函數(shù)主要是用來獲取指定pin control device的pin group的數(shù)目。邏輯很簡單，通過pin control的class device的driver_data成員可以獲得samsung pin control driver的私有數(shù)據(jù)（struct samsung_pinctrl_drv_data），可以nr_groups成員返回group的數(shù)目。

（2）samsung_get_group_name

該函數(shù)的代碼如下：

static const char *samsung_get_group_name(struct pinctrl_dev *pctldev,?
??????????????????????? unsigned selector)?
{?
??? struct samsung_pinctrl_drv_data *drvdata;

??? drvdata = pinctrl_dev_get_drvdata(pctldev);?
??? return drvdata->pin_groups[selector].name;?
}

該函數(shù)主要用來獲取指定group selector的pin group信息。

（3）samsung_get_group_pins

該函數(shù)的代碼如下：

static int samsung_get_group_pins(struct pinctrl_dev *pctldev,?
??????? unsigned selector, const unsigned **pins, unsigned *num_pins)?
{?
??? struct samsung_pinctrl_drv_data *drvdata;

??? drvdata = pinctrl_dev_get_drvdata(pctldev);?
??? *pins = drvdata->pin_groups[selector].pins;?
??? *num_pins = drvdata->pin_groups[selector].num_pins;?
??? return 0;?
}

該函數(shù)的主要功能是給定一個group selector（index），獲取該pin group中pin的信息（該pin group包括多少個pin，每個pin的ID是什么） 。

（4）samsung_dt_node_to_map

該函數(shù)的代碼如下：

static int samsung_dt_node_to_map(struct pinctrl_dev *pctldev,?
??????????? struct device_node *np, struct pinctrl_map **maps,?
??????????? unsigned *nmaps)?
{?
??? struct device *dev = pctldev->dev;?
??? struct pinctrl_map *map;?
??? unsigned long *cfg = NULL;?
??? char *gname, *fname;?
??? int cfg_cnt = 0, map_cnt = 0, idx = 0;

??? /* count the number of config options specfied in the node */?
??? for (idx = 0; idx < ARRAY_SIZE(pcfgs); idx++) {?
??????? if (of_find_property(np, pcfgs[idx].prop_cfg, NULL))?
??????????? cfg_cnt++;?
??? }

??? /*?
???? * Find out the number of map entries to create. All the config options?
???? * can be accomadated into a single config map entry.?
???? */?
??? if (cfg_cnt)?
??????? map_cnt = 1;?
??? if (of_find_property(np, "samsung,pin-function", NULL))?
??????? map_cnt++;?
??? if (!map_cnt) {?
??????? dev_err(dev, "node %s does not have either config or function "?
??????????????? "configurations\n", np->name);?
??????? return -EINVAL;?
??? }

??? /* Allocate memory for pin-map entries */?
??? map = kzalloc(sizeof(*map) * map_cnt, GFP_KERNEL);?
??? if (!map) {?
??????? dev_err(dev, "could not alloc memory for pin-maps\n");?
??????? return -ENOMEM;?
??? }?
??? *nmaps = 0;

??? /*?
???? * Allocate memory for pin group name. The pin group name is derived?
???? * from the node name from which these map entries are be created.?
???? */?
??? gname = kzalloc(strlen(np->name) + GSUFFIX_LEN, GFP_KERNEL);?
??? if (!gname) {?
??????? dev_err(dev, "failed to alloc memory for group name\n");?
??????? goto free_map;?
??? }?
??? sprintf(gname, "%s%s", np->name, GROUP_SUFFIX);

??? /*?
???? * don't have config options? then skip over to creating function?
???? * map entries.?
???? */?
??? if (!cfg_cnt)?
??????? goto skip_cfgs;

??? /* Allocate memory for config entries */?
??? cfg = kzalloc(sizeof(*cfg) * cfg_cnt, GFP_KERNEL);?
??? if (!cfg) {?
??????? dev_err(dev, "failed to alloc memory for configs\n");?
??????? goto free_gname;?
??? }

??? /* Prepare a list of config settings */?
??? for (idx = 0, cfg_cnt = 0; idx < ARRAY_SIZE(pcfgs); idx++) {?
??????? u32 value;?
??????? if (!of_property_read_u32(np, pcfgs[idx].prop_cfg, &value))?
??????????? cfg[cfg_cnt++] =?
??????????????? PINCFG_PACK(pcfgs[idx].cfg_type, value);?
??? }

??? /* create the config map entry */?
??? map[*nmaps].data.configs.group_or_pin = gname;?
??? map[*nmaps].data.configs.configs = cfg;?
??? map[*nmaps].data.configs.num_configs = cfg_cnt;?
??? map[*nmaps].type = PIN_MAP_TYPE_CONFIGS_GROUP;?
??? *nmaps += 1;

skip_cfgs:?
??? /* create the function map entry */?
??? if (of_find_property(np, "samsung,pin-function", NULL)) {?
??????? fname = kzalloc(strlen(np->name) + FSUFFIX_LEN,??? GFP_KERNEL);?
??????? if (!fname) {?
??????????? dev_err(dev, "failed to alloc memory for func name\n");?
??????????? goto free_cfg;?
??????? }?
??????? sprintf(fname, "%s%s", np->name, FUNCTION_SUFFIX);

??????? map[*nmaps].data.mux.group = gname;?
??????? map[*nmaps].data.mux.function = fname;?
??????? map[*nmaps].type = PIN_MAP_TYPE_MUX_GROUP;?
??????? *nmaps += 1;?
??? }

??? *maps = map;?
??? return 0;

free_cfg:?
??? kfree(cfg);?
free_gname:?
??? kfree(gname);?
free_map:?
??? kfree(map);?
??? return -ENOMEM;?
}

具體分析TODO

（5）samsung_dt_free_map

該函數(shù)的代碼如下：

static void samsung_dt_free_map(struct pinctrl_dev *pctldev,?
???????????????? struct pinctrl_map *map, unsigned num_maps)?
{?
??? int idx;

??? for (idx = 0; idx < num_maps; idx++) {?
??????? if (map[idx].type == PIN_MAP_TYPE_MUX_GROUP) {?
??????????? kfree(map[idx].data.mux.function);?
??????????? if (!idx)?
??????????????? kfree(map[idx].data.mux.group);?
??????? } else if (map->type == PIN_MAP_TYPE_CONFIGS_GROUP) {?
??????????? kfree(map[idx].data.configs.configs);?
??????????? if (!idx)?
??????????????? kfree(map[idx].data.configs.group_or_pin);?
??????? }?
??? };

??? kfree(map);?
}

具體分析TODO

3、復(fù)用引腳相關(guān)的操作函數(shù)struct pinmux_ops的具體解釋如下：

（1）samsung_get_functions_count

該函數(shù)的代碼如下：

static int samsung_get_functions_count(struct pinctrl_dev *pctldev)?
{?
??? struct samsung_pinctrl_drv_data *drvdata;

??? drvdata = pinctrl_dev_get_drvdata(pctldev);?
??? return drvdata->nr_functions;?
}

該函數(shù)的主要功能是就是返回pin controller device支持的function的數(shù)目

（2）samsung_pinmux_get_fname

該函數(shù)的代碼如下：

static const char *samsung_pinmux_get_fname(struct pinctrl_dev *pctldev,?
??????????????????????? unsigned selector)?
{?
??? struct samsung_pinctrl_drv_data *drvdata;

??? drvdata = pinctrl_dev_get_drvdata(pctldev);?
??? return drvdata->pmx_functions[selector].name;?
}

該函數(shù)的主要功能是就是：給定一個function selector（index），獲取指定function的name??
??
（3）samsung_pinmux_get_groups

該函數(shù)的代碼如下：

static int samsung_pinmux_get_groups(struct pinctrl_dev *pctldev,?
??????? unsigned selector, const char * const **groups,?
??????? unsigned * const num_groups)?
{?
??? struct samsung_pinctrl_drv_data *drvdata;

??? drvdata = pinctrl_dev_get_drvdata(pctldev);?
??? *groups = drvdata->pmx_functions[selector].groups;?
??? *num_groups = drvdata->pmx_functions[selector].num_groups;?
??? return 0;?
}

該函數(shù)的主要功能是就是：給定一個function selector（index），獲取指定function的pin groups信息?
??
（4）samsung_pinmux_enable和samsung_pinmux_disable

這個兩個callback函數(shù)都是通過samsung_pinmux_setup實現(xiàn)，該函數(shù)的代碼如下：

static void samsung_pinmux_setup(struct pinctrl_dev *pctldev, unsigned selector,?
??????????????????? unsigned group, bool enable)?
{?
??? struct samsung_pinctrl_drv_data *drvdata;?
??? const unsigned int *pins;?
??? struct samsung_pin_bank *bank;?
??? void __iomem *reg;?
??? u32 mask, shift, data, pin_offset, cnt;?
??? unsigned long flags;

??? drvdata = pinctrl_dev_get_drvdata(pctldev);?
??? pins = drvdata->pin_groups[group].pins;

??? /*?
???? * for each pin in the pin group selected, program the correspoding pin?
???? * pin function number in the config register.?
???? */?
??? for (cnt = 0; cnt < drvdata->pin_groups[group].num_pins; cnt++) {?
??????? struct samsung_pin_bank_type *type;

??????? pin_to_reg_bank(drvdata, pins[cnt] - drvdata->ctrl->base,?
??????????????? ?, &pin_offset, &bank);?
??????? type = bank->type;?
??????? mask = (1 << type->fld_width[PINCFG_TYPE_FUNC]) - 1;?
??????? shift = pin_offset * type->fld_width[PINCFG_TYPE_FUNC];?
??????? if (shift >= 32) {?
??????????? /* Some banks have two config registers */?
??????????? shift -= 32;?
??????????? reg += 4;?
??????? }

??????? spin_lock_irqsave(&bank->slock, flags);

??????? data = readl(reg + type->reg_offset[PINCFG_TYPE_FUNC]);?
??????? data &= ~(mask << shift);?
??????? if (enable)?
??????????? data |= drvdata->pin_groups[group].func << shift;?
??????? writel(data, reg + type->reg_offset[PINCFG_TYPE_FUNC]);

??????? spin_unlock_irqrestore(&bank->slock, flags);?
??? }?
}

該函數(shù)主要用來enable一個指定function。具體指定function的時候要給出function selector和pin group的selector 。具體的操作涉及很多底層的寄存器操作（TODO）。?
??
??
（5）samsung_pinmux_gpio_set_direction

該函數(shù)的代碼如下：

static int samsung_pinmux_gpio_set_direction(struct pinctrl_dev *pctldev,?
??????? struct pinctrl_gpio_range *range, unsigned offset, bool input)?
{?
??? struct samsung_pin_bank_type *type;?
??? struct samsung_pin_bank *bank;?
??? struct samsung_pinctrl_drv_data *drvdata;?
??? void __iomem *reg;?
??? u32 data, pin_offset, mask, shift;?
??? unsigned long flags;

??? bank = gc_to_pin_bank(range->gc);?
??? type = bank->type;?
??? drvdata = pinctrl_dev_get_drvdata(pctldev);

??? pin_offset = offset - bank->pin_base;?
??? reg = drvdata->virt_base + bank->pctl_offset +?
??????????????????? type->reg_offset[PINCFG_TYPE_FUNC];

??? mask = (1 << type->fld_width[PINCFG_TYPE_FUNC]) - 1;?
??? shift = pin_offset * type->fld_width[PINCFG_TYPE_FUNC];?
??? if (shift >= 32) {?
??????? /* Some banks have two config registers */?
??????? shift -= 32;?
??????? reg += 4;?
??? }

??? spin_lock_irqsave(&bank->slock, flags);

??? data = readl(reg);?
??? data &= ~(mask << shift);?
??? if (!input)?
??????? data |= FUNC_OUTPUT << shift;?
??? writel(data, reg);

??? spin_unlock_irqrestore(&bank->slock, flags);

??? return 0;?
}

該函數(shù)用來設(shè)定GPIO的方向。?
?

4、配置引腳的特性的struct pinconf_ops數(shù)據(jù)結(jié)構(gòu)的各個成員定義如下：

（1）samsung_pinconf_get?
（2）samsung_pinconf_set?
（3）samsung_pinconf_group_get?
（4）samsung_pinconf_group_set

（1）和（2）是對單個pin的配置進行讀取或者設(shè)定，（3）和（4）是對pin group中的所有pin進行配置進行讀取或者設(shè)定。這些函數(shù)的底層都是samsung_pinconf_rw，該函數(shù)代碼如下：

static int samsung_pinconf_rw(struct pinctrl_dev *pctldev, unsigned int pin,?
??????????????? unsigned long *config, bool set)?
{?
??? struct samsung_pinctrl_drv_data *drvdata;?
??? struct samsung_pin_bank_type *type;?
??? struct samsung_pin_bank *bank;?
??? void __iomem *reg_base;?
??? enum pincfg_type cfg_type = PINCFG_UNPACK_TYPE(*config);?
??? u32 data, width, pin_offset, mask, shift;?
??? u32 cfg_value, cfg_reg;?
??? unsigned long flags;

??? drvdata = pinctrl_dev_get_drvdata(pctldev);?
??? pin_to_reg_bank(drvdata, pin - drvdata->ctrl->base, ?_base,?
??????????????????? &pin_offset, &bank);?
??? type = bank->type;

??? if (cfg_type >= PINCFG_TYPE_NUM || !type->fld_width[cfg_type])?
??????? return -EINVAL;

??? width = type->fld_width[cfg_type];?
??? cfg_reg = type->reg_offset[cfg_type];

??? spin_lock_irqsave(&bank->slock, flags);

??? mask = (1 << width) - 1;?
??? shift = pin_offset * width;?
??? data = readl(reg_base + cfg_reg);

??? if (set) {?
??????? cfg_value = PINCFG_UNPACK_VALUE(*config);?
??????? data &= ~(mask << shift);?
??????? data |= (cfg_value << shift);?
??????? writel(data, reg_base + cfg_reg);?
??? } else {?
??????? data >>= shift;?
??????? data &= mask;?
??????? *config = PINCFG_PACK(cfg_type, data);?
??? }

??? spin_unlock_irqrestore(&bank->slock, flags);

??? return 0;?
}

具體分析TODO

?

原創(chuàng)文章，轉(zhuǎn)發(fā)請注明出處。蝸窩科技。http://www.wowotech.net/linux_kenrel/pin-controller-driver.html

總結(jié)

以上是生活随笔為你收集整理的pin controller driver代码分析的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。