Linux下GPIO驅動（三） ----gpio_desc()的分析

?

上篇最后提出的疑問是結構體gpio_chip中的成員函數set等是怎么實現的，在回答之前先介紹下gpio_desc這個結構體。?

?

?

?

???? 如上圖所示，右上方部分為GPIO驅動對其它驅動提供的GPIO操作接口，其對應的右下方部分為GPIO硬件操作接口，也就是說對外提供的接口最終會一一對應的對硬件GPIO進行操作。

?????再來看左邊部分，左上方部分為一全局數組，記錄各個GPIO的描述符，即對應左下方的gpio_desc結構體，其中gpio_chip指向硬件層的GPIO，flags為一標志位，用來指示當前GPIO是否已經占用，當用gpio_request申請GPIO資源時，flags位就會置位，當調用gpio_free釋放GPIO資源時，flags就會清零。label是一個字符串指針，用來作說明。

???? 在軟件上，我們首先通過函數gpiochip_add注冊一個gpio_chip對應的gpio_desc到全局數組gpio描述符中。其中，一個描述符對應一個GPIO，所以如果我們要使用多個GPIO，那么就在gpio_chip結構體的ngpio指定個數，base為起始的GPIO號。

?

//每個引腳分配一個gpio_desc數據結構 struct gpio_desc {struct gpio_chip *chip;unsigned long flags; };

?

/*** struct gpio_chip - abstract a GPIO controller* @label: for diagnostics* @dev: optional device providing the GPIOs* @owner: helps prevent removal of modules exporting active GPIOs* @request: optional hook for chip-specific activation, such as* enabling module power and clock; may sleep* @free: optional hook for chip-specific deactivation, such as* disabling module power and clock; may sleep* @direction_input: configures signal "offset" as input, or returns error* @get: returns value for signal "offset"; for output signals this* returns either the value actually sensed, or zero* @direction_output: configures signal "offset" as output, or returns error* @set: assigns output value for signal "offset"* @to_irq: optional hook supporting non-static gpio_to_irq() mappings;* implementation may not sleep* @dbg_show: optional routine to show contents in debugfs; default code* will be used when this is omitted, but custom code can show extra* state (such as pullup/pulldown configuration).* @base: identifies the first GPIO number handled by this chip; or, if* negative during registration, requests dynamic ID allocation.* @ngpio: the number of GPIOs handled by this controller; the last GPIO* handled is (base + ngpio - 1).* @can_sleep: flag must be set iff get()/set() methods sleep, as they* must while accessing GPIO expander chips over I2C or SPI* @names: if set, must be an array of strings to use as alternative* names for the GPIOs in this chip. Any entry in the array* may be NULL if there is no alias for the GPIO, however the* array must be @ngpio entries long. A name can include a single printk* format specifier for an unsigned int. It is substituted by the actual* number of the gpio.** A gpio_chip can help platforms abstract various sources of GPIOs so* they can all be accessed through a common programing interface.* Example sources would be SOC controllers, FPGAs, multifunction* chips, dedicated GPIO expanders, and so on.** Each chip controls a number of signals, identified in method calls* by "offset" values in the range 0..(@ngpio - 1). When those signals* are referenced through calls like gpio_get_value(gpio), the offset* is calculated by subtracting @base from the gpio number.*/ struct gpio_chip { //這些函數實現在arch\arm\mach-s5pv210\gpiolib.c const char *label;struct device *dev;struct module *owner;int (*request)(struct gpio_chip *chip,unsigned offset);void (*free)(struct gpio_chip *chip,unsigned offset);int (*direction_input)(struct gpio_chip *chip,unsigned offset);int (*get)(struct gpio_chip *chip,unsigned offset);int (*direction_output)(struct gpio_chip *chip,unsigned offset, int value);int (*set_debounce)(struct gpio_chip *chip,unsigned offset, unsigned debounce);void (*set)(struct gpio_chip *chip,unsigned offset, int value);int (*to_irq)(struct gpio_chip *chip,unsigned offset);void (*dbg_show)(struct seq_file *s,struct gpio_chip *chip);int base;u16 ngpio;const char *const *names;unsigned can_sleep:1;unsigned exported:1; };

下面分析gpio_desc中成員chip的成員函數的實現：

__init int s5pv210_gpiolib_init(void)//在Linux初始化期間，此函數就執行了 {struct s3c_gpio_chip *chip = s5pv210_gpio_4bit;int nr_chips = ARRAY_SIZE(s5pv210_gpio_4bit);int i = 0;for (i = 0; i < nr_chips; i++, chip++) {if (chip->config == NULL)chip->config = &gpio_cfg;if (chip->base == NULL)chip->base = S5PV210_BANK_BASE(i);}samsung_gpiolib_add_4bit_chips(s5pv210_gpio_4bit, nr_chips);return 0; }

void __init samsung_gpiolib_add_4bit_chips(struct s3c_gpio_chip *chip,int nr_chips) {for (; nr_chips > 0; nr_chips--, chip++) {samsung_gpiolib_add_4bit(chip);s3c_gpiolib_add(chip);} }

void __init samsung_gpiolib_add_4bit(struct s3c_gpio_chip *chip) {chip->chip.direction_input = samsung_gpiolib_4bit_input;chip->chip.direction_output = samsung_gpiolib_4bit_output;chip->pm = __gpio_pm(&s3c_gpio_pm_4bit); }

__init void s3c_gpiolib_add(struct s3c_gpio_chip *chip) {struct gpio_chip *gc = &chip->chip;int ret;BUG_ON(!chip->base);BUG_ON(!gc->label);BUG_ON(!gc->ngpio);spin_lock_init(&chip->lock);// 初始化s3c_gpio_chip的自旋鎖 if (!gc->direction_input)gc->direction_input = s3c_gpiolib_input;//chip->direction_inputif (!gc->direction_output)gc->direction_output = s3c_gpiolib_output;//chip->direction_outputif (!gc->set)gc->set = s3c_gpiolib_set;//chip->set此處就回答了上篇的疑問if (!gc->get)gc->get = s3c_gpiolib_get;//chip->get#ifdef CONFIG_PMif (chip->pm != NULL) {if (!chip->pm->save || !chip->pm->resume)printk(KERN_ERR "gpio: %s has missing PM functions\n",gc->label);} elseprintk(KERN_ERR "gpio: %s has no PM function\n", gc->label); #endif/* gpiochip_add() prints own failure message on error. */ret = gpiochip_add(gc);if (ret >= 0)s3c_gpiolib_track(chip); }

/*** gpiochip_add() - register a gpio_chip* @chip: the chip to register, with chip->base initialized* Context: potentially before irqs or kmalloc will work** Returns a negative errno if the chip can't be registered, such as* because the chip->base is invalid or already associated with a* different chip. Otherwise it returns zero as a success code.** When gpiochip_add() is called very early during boot, so that GPIOs* can be freely used, the chip->dev device must be registered before* the gpio framework's arch_initcall(). Otherwise sysfs initialization* for GPIOs will fail rudely.** If chip->base is negative, this requests dynamic assignment of* a range of valid GPIOs.*/ int gpiochip_add(struct gpio_chip *chip)?// 在gpio_desc[]中分配空間，并鏈接chip結構；注冊一個gpio_chip對應的gpio_desc到全局數組gpio描述符中 {unsigned long flags;int status = 0;unsigned id;int base = chip->base;if ((!gpio_is_valid(base) || !gpio_is_valid(base + chip->ngpio - 1))&& base >= 0) {status = -EINVAL;goto fail;}spin_lock_irqsave(&gpio_lock, flags);if (base < 0) {base = gpiochip_find_base(chip->ngpio);// 這個函數在gpiolib.c中，在gpio_desc[]中分配chip->ngpio個空間(從最后往前分配)，返回第一個indexif (base < 0) {status = base;goto unlock;}chip->base = base;}/* these GPIO numbers must not be managed by another gpio_chip */for (id = base; id < base + chip->ngpio; id++) {if (gpio_desc[id].chip != NULL) {status = -EBUSY;break;}}if (status == 0) {// 分配到空間，正常情況下for (id = base; id < base + chip->ngpio; id++) {gpio_desc[id].chip = chip;// 這里將gpio_desc與s3c_gpio_chip聯系起來，他們的chip成員指向的是同一個數據結構? /* REVISIT: most hardware initializes GPIOs as* inputs (often with pullups enabled) so power* usage is minimized. Linux code should set the* gpio direction first thing; but until it does,* we may expose the wrong direction in sysfs.*/gpio_desc[id].flags = !chip->direction_input? (1 << FLAG_IS_OUT): 0;}}unlock:spin_unlock_irqrestore(&gpio_lock, flags);if (status == 0)status = gpiochip_export(chip); fail:/* failures here can mean systems won't boot... */if (status)pr_err("gpiochip_add: gpios %d..%d (%s) failed to register\n",chip->base, chip->base + chip->ngpio - 1,chip->label ? : "generic");return status; } EXPORT_SYMBOL_GPL(gpiochip_add);

總結

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

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。