pinctrl與gpio子系統(tǒng)下的字符設(shè)備驅(qū)動框架

點亮Linux驅(qū)動開發(fā)路上的第一個燈一文中將與外設(shè)有關(guān)的寄存器信息，定義到驅(qū)動代碼中，直接操作寄存器來控制外設(shè)。缺點是當芯片的寄存器發(fā)了變動，就要對底層的驅(qū)動進行重寫。

設(shè)備樹下的字符設(shè)備驅(qū)動框架一文中將與外設(shè)有關(guān)的寄存器信息，寫到了設(shè)備樹文件中，通過設(shè)備樹API函數(shù)獲取外設(shè)信息。當外設(shè)的信息有變化時，只需要修改設(shè)備樹文件即可，無需修改底層驅(qū)動，提高了驅(qū)動代碼的復(fù)用能力，但仍需要直接操作寄存器來控制外設(shè)。

本文介紹的pinctrl和gpio子系統(tǒng)實現(xiàn)了對寄存器的操作，我們只需要使用子系統(tǒng)提供的API函數(shù)即可，而無需再直接操作寄存器了。

1. pinctrl與gpio子系統(tǒng)介紹

1.1 pinctrl子系統(tǒng)

pinctrl子系統(tǒng)就是管理PIN引腳的一個系統(tǒng)，在設(shè)備樹里設(shè)置PIN的配置信息，pinctrl會根據(jù)提供的信息來配置PIN功能。其主要工作內(nèi)容如下：

• 獲取設(shè)備樹中的PIN信息
• 設(shè)置獲取到的PIN的復(fù)用功能
• 設(shè)置獲取到的PIN的電氣特性

打開設(shè)備樹文件imx6ull-andyxi-emmc.dts，其中iomuxc節(jié)點就是I.MX6ULL的外設(shè)節(jié)點。代碼中的pinctrl_hog_1子節(jié)點就是和熱插拔有關(guān)的PIN集合

&iomuxc {
    pinctrl-names = "default";
    pinctrl-0 = <&pinctrl_hog_1>;
    imx6ul-evk {
        pinctrl_hog_1: hoggrp-1 {
            fsl,pins = <
                MX6UL_PAD_UART1_RTS_B__GPIO1_IO19        0x17059 
                MX6UL_PAD_GPIO1_IO05__USDHC1_VSELECT     0x17059 
                MX6UL_PAD_GPIO1_IO09__GPIO1_IO09         0x17059 
                MX6UL_PAD_GPIO1_IO00__ANATOP_OTG1_ID     0x13058
           >;
        };
        ......
    };
};

下面以UART1_RTS_B這個PIN為例，介紹如何添加PIN的配置信息：

MX6UL_PAD_UART1_RTS_B__GPIO1_IO19     0x17059

前半部分：設(shè)置UART1_RTS_B引腳的復(fù)用功能

//MX6UL_PAD_UART1_RTS_B__GPIO1_IO19宏定義在文件arch/arm/boot/dts/imx6ul-pinfunc.h中
#define MX6UL_PAD_UART1_RTS_B__UART1_DCE_RTS          0x0090 0x031C 0x0620 0x0 0x3
#define MX6UL_PAD_UART1_RTS_B__UART1_DTE_CTS          0x0090 0x031C 0x0000 0x0 0x0
#define MX6UL_PAD_UART1_RTS_B__ENET1_TX_ER            0x0090 0x031C 0x0000 0x1 0x0
#define MX6UL_PAD_UART1_RTS_B__USDHC1_CD_B            0x0090 0x031C 0x0668 0x2 0x1
#define MX6UL_PAD_UART1_RTS_B__CSI_DATA05             0x0090 0x031C 0x04CC 0x3 0x1
#define MX6UL_PAD_UART1_RTS_B__ENET2_1588_EVENT1_OUT  0x0090 0x031C 0x0000 0x4 0x0
#define MX6UL_PAD_UART1_RTS_B__GPIO1_IO19             0x0090 0x031C 0x0000 0x5 0x0
#define MX6UL_PAD_UART1_RTS_B__USDHC2_CD_B            0x0090 0x031C 0x0674 0x8 0x2

上面代碼中共有8個UART1_RTS_B引腳的宏定義，分別對應(yīng)該引腳的8個復(fù)用IO。宏定義的值，被分為了5段，每段的值都有具體的含義：

• mux_reg：mux_reg寄存器偏移地址 (見下圖1)
• conf_reg：conf_reg寄存器偏移地址 (見下圖2)
• input_reg：input_reg寄存器偏移地址 (此處無效)
• mux_mode：mux_reg寄存器的值，用于設(shè)置復(fù)用功能 (見下圖3)
• input_val：input_reg寄存器值 (此處無效)

后半部分：此值就是conf_reg寄存器的值，用于設(shè)置UART1_RTS_B引腳的電氣特性

1.2 gpio子系統(tǒng)

gpio子系統(tǒng)就是管理gpio功能的一個系統(tǒng)，其作用是初始化gpio，并提供對外的API接口。使用gpio子系統(tǒng)后，就無需自己操作寄存器，通過調(diào)用相關(guān)API函數(shù)即可實現(xiàn)對gpio的控制。

仍以熱插拔節(jié)點為例，pinctrl子系統(tǒng)已經(jīng)將UART1_RTS_B復(fù)用為GPIO1_IO19，并設(shè)置好了電氣屬性。驅(qū)動程序通過讀取其高低電平來判斷SD卡有沒有插入。

那驅(qū)動程序怎么知道CD引腳連接的是GPIO1_IO19呢 ？這就需要設(shè)備樹來告訴驅(qū)動了，在設(shè)備樹的SD卡節(jié)點下添加一個描述CD引腳的屬性：

&usdhc1 {
    pinctrl-names = "default", "state_100mhz", "state_200mhz";
    pinctrl-0 = <&pinctrl_usdhc1>;
    pinctrl-1 = <&pinctrl_usdhc1_100mhz>;
    pinctrl-2 = <&pinctrl_usdhc1_200mhz>;
    pinctrl-3 = <&pinctrl_hog_1>;
    cd-gpios = <&gpio1 19 GPIO_ACTIVE_LOW>;
    keep-power-in-suspend;
    enable-sdio-wakeup;
    vmmc-supply = <®_sd1_vmmc>;
    status = "okay";
};

上面代碼中pinctrl-3指定了CD引腳的pinctrl信息，cd-gpios屬性描述了CD引腳使用哪個IO，屬性值共有三個，具體含義如下：

• &gpio1 表示CD引腳所使用的IO屬于GPIO1組
• 19 表示GPIO1組的第19號IO
• GPIO_ACTIVE_LOW 表示低電平有效

設(shè)置好設(shè)備樹后就可使用gpio子系統(tǒng)提供的API函數(shù)來操作指定的GPIO，gpio子系統(tǒng)向開發(fā)人員屏蔽了具體的讀寫寄存器過程。下圖中有常用的API函數(shù)介，此外還有pinctrl和gpio子系統(tǒng)的使用模板：

**2. **pinctrl與gpio子系統(tǒng)字符設(shè)備驅(qū)動框架

下圖為pinctrl與gpio子系統(tǒng)下的字符設(shè)備驅(qū)動框架：

接下來根據(jù)上面的框架圖，以驅(qū)動LED (GPIO1_IO03) 為例，分步介紹具體的代碼編寫流程

2.1 修改設(shè)備樹文件

添加pinctrl節(jié)點：在iomuxc節(jié)點的imx6ul-evk子節(jié)點下創(chuàng)建pinctrl_led節(jié)點，復(fù)用GPIO1_IO03

pinctrl_led: ledgrp {
    fsl,pins = <
        MX6UL_PAD_GPIO1_IO03__GPIO1_IO03    0x10B0
    >;
};
//MX6UL_PAD_GPIO1_IO03__GPIO1_IO03 復(fù)用GPIO1_IO03
//0x10B0 設(shè)置pin的電氣特性

添加LED設(shè)備節(jié)點：在根節(jié)點下創(chuàng)建LED設(shè)備節(jié)點，指定對應(yīng)的pinctrl節(jié)點，指定所使用的GPIO

gpioled {
    #address-cells = <1>;
    #size-cells = <1>;
    compatible = "alpha-gpioled";
    pinctrl-names = "default";
    pinctrl-0 = <&pinctrl_led>;
    led-gpio = <&gpio1 3 GPIO_ACTIVE_LOW>;
    status = "okay";
};

檢查PIN是否沖突：檢查pinctrl和設(shè)備節(jié)點中指定的引腳有沒有被別的外設(shè)占用

//檢查GPIO_IO03這個PIN有沒有被其他的pinctrl節(jié)點使用
pinctrl_tsc: tscgrp {
    fsl,pins = <
        MX6UL_PAD_GPIO1_IO01__GPIO1_IO01 0xb0
        MX6UL_PAD_GPIO1_IO02__GPIO1_IO02 0xb0
        //GPIO_IO03被pinctrl_tsc節(jié)點占用，因此需要屏蔽掉
        /* MX6UL_PAD_GPIO1_IO03__GPIO1_IO03 0xb0 */ 
        MX6UL_PAD_GPIO1_IO04__GPIO1_IO04 0xb0
    >;
};

//檢查"gpio1 3"有沒有被其他設(shè)備節(jié)點占用
&tsc {
    pinctrl-names = "default";
    pinctrl-0 = <&pinctrl_tsc>;
    //"gpio1 3"被tsc設(shè)備節(jié)點占用，因此需要屏蔽掉
    /* xnur-gpio = <&gpio1 3 GPIO_ACTIVE_LOW>; */
    measure-delay-time = <0xffff>;
    pre-charge-time = <0xfff>;
    status = "okay";
};

編譯設(shè)備樹：使用make dtbs命令編譯設(shè)備樹，并使用該設(shè)備樹啟動Linux系統(tǒng)

#在內(nèi)核根目錄下
make dtbs                #編譯設(shè)備樹
#啟動Linux系統(tǒng)后
cd /proc/device-tree     #查看"gpioled"節(jié)點是否存在

2.2 編寫驅(qū)動程序

創(chuàng)建驅(qū)動程序文件gpioled.c，添加如下代碼

宏定義及設(shè)備結(jié)構(gòu)體定義

struct gpioled_dev{
    dev_t devid;                //設(shè)備號
    struct cdev cdev;           //cdev字符設(shè)備
    struct class *class;        //類
    struct device *device;      //設(shè)備
    int major;                  //主設(shè)備號
    int minor;                  //次設(shè)備號
    struct device_node *nd;     //設(shè)備節(jié)點
    int led_gpio;               //所使用的gpio編號
};

struct gpioled_dev gpioled;     //定義led設(shè)備

編寫設(shè)備操作函數(shù)：write函數(shù)中，直接使用gpio子系統(tǒng)提供的API函數(shù)操作GPIO

static ssize_t led_write(struct file *filp, char __user *buf, size_t cnt, loff_t *offt){
    int retvalue;
    unsigned char databuf[1];
    unsigned char ledstat;
    struct gpioled_dev *dev = filp->private_data;
    retvalue = copy_from_user(databuf, buf, cnt); 
    if(retvalue < 0){
        printk("kernel write failed!\\r\\n");
        return -EFAULT;
    }

    ledstat = databuf[0];
    if(ledstat == LEDON){
        gpio_set_value(dev->led_gpio, 0);
    }else if(ledstat == LEDOFF){
        gpio_set_value(dev->led_gpio, 1);
    }
    return 0;
}

驅(qū)動入口函數(shù)中：獲取GPIO編號后初始化

/* 設(shè)置 LED 所使用的 GPIO */
/* 1、獲取設(shè)備節(jié)點：gpioled */
gpioled.nd = of_find_node_by_path("/gpioled");
if(gpioled.nd == NULL) {
    printk("gpioled node cant not found!\\r\\n");
    return -EINVAL;
} else {
    printk("gpioled node has been found!\\r\\n");
}
/* 2、 獲取設(shè)備樹中的 gpio 屬性，得到 LED 所使用的 LED 編號 */
gpioled.led_gpio = of_get_named_gpio(gpioled.nd, "led-gpio", 0);
if(gpioled.led_gpio < 0) {
    printk("can't get led-gpio");
    return -EINVAL;
}
printk("led-gpio num = %d\\r\\n", gpioled.led_gpio);
/* 3、設(shè)置 GPIO1_IO03 為輸出，并且輸出高電平，默認關(guān)閉 LED 燈 */
ret = gpio_direction_output(gpioled.led_gpio, 1);
if(ret < 0) {
    printk("can't set gpio!\\r\\n");
}

驅(qū)動入口函數(shù)中：注冊字符設(shè)備驅(qū)動，代碼與Linux點燈中一樣

驅(qū)動出口函數(shù)中：注銷設(shè)備驅(qū)動，刪除類和設(shè)備，代碼可參考Linux點燈一文

2.3 編寫測試程序

實現(xiàn)操作驅(qū)動文件對外設(shè)進行控制的功能。創(chuàng)建測試程序文件gpioledApp.c，代碼內(nèi)容與Linux點燈一文中的測試程序代碼一致，此處不再贅述

2.4 編譯測試

編譯驅(qū)動程序：當前目錄下創(chuàng)建Makefile文件，并make編譯

KERNELDIR := /home/andyxi/linux/kernel/linux-imx-rel_imx_4.1.15_2.1.0_ga_andyxi
CURRENT_PATH := $(shell pwd)
obj-m := gpioled.o

build: kernel_modules

kernel_modules:
$(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) modules
clean:
$(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) clean

編譯測試程序：無需內(nèi)核參與，直接編譯即可

arm-linux-gnueabihf-gcc gpioledApp.c -o gpioledApp

運行測試：啟動開發(fā)板后，加載驅(qū)動模塊，之后使用應(yīng)用程序測試驅(qū)動是否正常工作

depmod                         #第一次加載驅(qū)動的時候需要運行此命令
modprobe gpioled.ko            #加載驅(qū)動
./gpioledApp /dev/gpioled 1    #打開LED燈
./gpioledApp /dev/gpioled 0    #關(guān)閉LED燈
rmmod gpioled.ko               #卸載驅(qū)動模塊