dwgpio.c File Reference

Synopsys DesignWare GPIO driver. More...

#include <stdlib.h>
#include <string.h>
#include <errno.h>
#include <ipxe/devtree.h>
#include <ipxe/fdt.h>
#include <ipxe/gpio.h>
#include "dwgpio.h"

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static int	dwgpio_group_probe (struct dt_device *dt, unsigned int offset)
	Probe port group.
static void	dwgpio_group_remove (struct dt_device *dt)
	Remove port group.
static void	dwgpio_dump (struct dwgpio *dwgpio)
	Dump GPIO port status.
static int	dwgpio_in (struct gpios *gpios, struct gpio *gpio)
	Get current GPIO input value.
static void	dwgpio_out (struct gpios *gpios, struct gpio *gpio, int active)
	Set current GPIO output value.
static int	dwgpio_config (struct gpios *gpios, struct gpio *gpio, unsigned int config)
	Configure GPIO pin.
static int	dwgpio_probe (struct dt_device *dt, unsigned int offset)
	Probe port.
static void	dwgpio_remove (struct dt_device *dt)
	Remove port.

Variables
static const char *	dwgpio_group_ids []
	DesignWare GPIO port group compatible model identifiers.
struct dt_driver dwgpio_group_driver	__dt_driver
	DesignWare GPIO port group devicetree driver.
static struct gpio_operations	dwgpio_operations
	GPIO operations.
static const char *	dwgpio_ids []
	DesignWare GPIO port compatible model identifiers.

Detailed Description

Synopsys DesignWare GPIO driver.

Definition in file dwgpio.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

dwgpio_group_probe()

int dwgpio_group_probe ( struct dt_device * dt, unsigned int offset )

static

Probe port group.

Parameters

dt	Devicetree device
offset	Starting node offset

Return values

rc	Return status code

Definition at line 54 of file dwgpio.c.

                                                                            {
        struct dwgpio_group *group;
        int rc;
 
        /* Allocate and initialise structure */
        group = zalloc ( sizeof ( *group ) );
        if ( ! group ) {
                rc = -ENOMEM;
                goto err_alloc;
        }
        dt_set_drvdata ( dt, group );
 
        /* Map registers */
        group->regs = dt_ioremap ( dt, offset, 0, 0 );
        if ( ! group->regs ) {
                rc = -ENODEV;
                goto err_ioremap;
        }
 
        /* Probe child ports */
        if ( ( rc = dt_probe_children ( dt, offset ) ) != 0 )
                goto err_children;
 
        return 0;
 
        dt_remove_children ( dt );
 err_children:
        iounmap ( group->regs );
 err_ioremap:
        free ( group );
 err_alloc:
        return rc;
}

References dt_ioremap(), dt_probe_children(), dt_remove_children(), dt_set_drvdata(), ENODEV, ENOMEM, free, group, iounmap(), offset, rc, and zalloc().

dwgpio_group_remove()

void dwgpio_group_remove ( struct dt_device * dt )

static

Remove port group.

Parameters

dt	Devicetree device

Definition at line 93 of file dwgpio.c.

                                                         {
        struct dwgpio_group *group = dt_get_drvdata ( dt );
 
        /* Remove child ports */
        dt_remove_children ( dt );
 
        /* Unmap registers */
        iounmap ( group->regs );
 
        /* Free device */
        free ( group );
}

References dt_get_drvdata(), dt_remove_children(), free, group, and iounmap().

dwgpio_dump()

void dwgpio_dump ( struct dwgpio * dwgpio )

inlinestatic

Dump GPIO port status.

Parameters

dwgpio

DesignWare GPIO port

Definition at line 133 of file dwgpio.c.

                                                         {
 
        DBGC2 ( dwgpio, "DWGPIO %s dr %#08x ddr %#08x ctl %#08x\n",
                dwgpio->name, readl ( dwgpio->swport + DWGPIO_SWPORT_DR ),
                readl ( dwgpio->swport + DWGPIO_SWPORT_DDR ),
                readl ( dwgpio->swport + DWGPIO_SWPORT_CTL ) );
}

References DBGC2, DWGPIO_SWPORT_CTL, DWGPIO_SWPORT_DDR, DWGPIO_SWPORT_DR, dwgpio::name, readl, and dwgpio::swport.

Referenced by dwgpio_config(), dwgpio_out(), and dwgpio_probe().

dwgpio_in()

int dwgpio_in ( struct gpios * gpios, struct gpio * gpio )

static

Get current GPIO input value.

Parameters

gpios	GPIO controller
gpio	GPIO pin

Return values

active

Pin is in the active state

Definition at line 148 of file dwgpio.c.

                                                                {
        struct dwgpio *dwgpio = gpios->priv;
        uint32_t ext;
 
        /* Read external port status */
        ext = readl ( dwgpio->ext );
        return ( ( ( ext >> gpio->index ) ^ gpio->config ) & 1 );
}

References gpio::config, dwgpio::ext, ext, gpio::index, gpios::priv, and readl.

dwgpio_out()

void dwgpio_out ( struct gpios * gpios, struct gpio * gpio, int active )

static

Set current GPIO output value.

Parameters

gpios	GPIO controller
gpio	GPIO pin
active	Set pin to active state

Definition at line 164 of file dwgpio.c.

                                                                              {
        struct dwgpio *dwgpio = gpios->priv;
        uint32_t mask = ( 1UL << gpio->index );
        uint32_t dr;
 
        /* Update data register */
        dr = readl ( dwgpio->swport + DWGPIO_SWPORT_DR );
        dr &= ~mask;
        if ( ( ( !! active ) ^ gpio->config ) & 1 )
                dr |= mask;
        writel ( dr, ( dwgpio->swport + DWGPIO_SWPORT_DR ) );
        dwgpio_dump ( dwgpio );
}

References gpio::config, dr, dwgpio_dump(), DWGPIO_SWPORT_DR, gpio::index, gpios::priv, readl, dwgpio::swport, and writel.

dwgpio_config()

int dwgpio_config ( struct gpios * gpios, struct gpio * gpio, unsigned int config )

static

Configure GPIO pin.

Parameters

gpios	GPIO controller
gpio	GPIO pin
config	Configuration

Return values

rc	Return status code

Definition at line 186 of file dwgpio.c.

                                                 {
        struct dwgpio *dwgpio = gpios->priv;
        uint32_t mask = ( 1UL << gpio->index );
        uint32_t ddr;
        uint32_t ctl;
 
        /* Update data direction and control registers */
        ddr = readl ( dwgpio->swport + DWGPIO_SWPORT_DDR );
        ctl = readl ( dwgpio->swport + DWGPIO_SWPORT_CTL );
        ctl &= ~mask;
        ddr &= ~mask;
        if ( config & GPIO_CFG_OUTPUT )
                ddr |= mask;
        writel ( ctl, ( dwgpio->swport + DWGPIO_SWPORT_CTL ) );
        writel ( ddr, ( dwgpio->swport + DWGPIO_SWPORT_DDR ) );
        dwgpio_dump ( dwgpio );
 
        return 0;
}

References dwgpio::ctl, dwgpio::ddr, dwgpio_dump(), DWGPIO_SWPORT_CTL, DWGPIO_SWPORT_DDR, GPIO_CFG_OUTPUT, gpio::index, gpios::priv, readl, dwgpio::swport, and writel.

dwgpio_probe()

int dwgpio_probe ( struct dt_device * dt, unsigned int offset )

static

Probe port.

Parameters

dt	Devicetree device
offset	Starting node offset

Return values

rc	Return status code

Definition at line 221 of file dwgpio.c.

                                                                      {
        struct dt_device *parent;
        struct dwgpio_group *group;
        struct dwgpio *dwgpio;
        struct gpios *gpios;
        uint32_t count;
        uint64_t port;
        int rc;
 
        /* Get number of GPIOs */
        if ( ( rc = fdt_u32 ( &sysfdt, offset, "nr-gpios-snps",
                              &count ) ) != 0 ) {
                goto err_count;
        }
        assert ( count <= DWGPIO_MAX_COUNT );
 
        /* Allocate and initialise device */
        gpios = alloc_gpios ( count, sizeof ( *dwgpio ) );
        if ( ! gpios ) {
                rc = -ENOMEM;
                goto err_alloc;
        }
        dt_set_drvdata ( dt, gpios );
        gpios->dev = &dt->dev;
        gpios_init ( gpios, &dwgpio_operations );
        dwgpio = gpios->priv;
        dwgpio->name = dt->name;
 
        /* Identify group */
        parent = dt_parent ( dt );
        if ( parent->driver != &dwgpio_group_driver ) {
                DBGC ( dwgpio, "DWGPIO %s has invalid parent %s\n",
                       dwgpio->name, parent->name );
                rc = -EINVAL;
                goto err_parent;
        }
        group = dt_get_drvdata ( parent );
 
        /* Identify port */
        if ( ( rc = fdt_reg ( &sysfdt, offset, &port ) ) != 0 ) {
                DBGC ( dwgpio, "DWGPIO %s could not get port number: %s\n",
                       dwgpio->name, strerror ( rc ) );
                goto err_port;
        }
        dwgpio->port = port;
        DBGC ( dwgpio, "DWGPIO %s is %s port %d (%d GPIOs)\n",
               dwgpio->name, parent->name, dwgpio->port, gpios->count );
 
        /* Map registers */
        dwgpio->swport = ( group->regs + DWGPIO_SWPORT ( port ) );
        dwgpio->ext = ( group->regs + DWGPIO_EXT_PORT ( port ) );
        dwgpio_dump ( dwgpio );
 
        /* Record original register values */
        dwgpio->dr = readl ( dwgpio->swport + DWGPIO_SWPORT_DR );
        dwgpio->ddr = readl ( dwgpio->swport + DWGPIO_SWPORT_DDR );
        dwgpio->ctl = readl ( dwgpio->swport + DWGPIO_SWPORT_CTL );
 
        /* Register GPIO controller */
        if ( ( rc = gpios_register ( gpios ) ) != 0 ) {
                DBGC ( dwgpio, "DWGPIO %s could not register: %s\n",
                       dwgpio->name, strerror ( rc ) );
                goto err_register;
        }
 
        return 0;
 
        gpios_unregister ( gpios );
 err_register:
 err_port:
 err_parent:
        gpios_nullify ( gpios );
        gpios_put ( gpios );
 err_alloc:
 err_count:
        return rc;
}

References alloc_gpios(), assert, count, gpios::count, dwgpio::ctl, DBGC, dwgpio::ddr, dt_device::dev, gpios::dev, dwgpio::dr, dt_device::driver, dt_get_drvdata(), dt_parent(), dt_set_drvdata(), dwgpio_dump(), DWGPIO_EXT_PORT, DWGPIO_MAX_COUNT, dwgpio_operations, DWGPIO_SWPORT, DWGPIO_SWPORT_CTL, DWGPIO_SWPORT_DDR, DWGPIO_SWPORT_DR, EINVAL, ENOMEM, dwgpio::ext, fdt_reg(), fdt_u32(), gpios_init(), gpios_nullify(), gpios_put(), gpios_register(), gpios_unregister(), group, dt_device::name, dwgpio::name, offset, dwgpio::port, port, gpios::priv, rc, readl, strerror(), dwgpio::swport, and sysfdt.

dwgpio_remove()

void dwgpio_remove ( struct dt_device * dt )

static

Remove port.

Parameters

dt	Devicetree device

Definition at line 304 of file dwgpio.c.

                                                   {
        struct gpios *gpios = dt_get_drvdata ( dt );
        struct dwgpio *dwgpio = gpios->priv;
 
        /* Unregister GPIO controller */
        gpios_unregister ( gpios );
 
        /* Restore original register values */
        writel ( dwgpio->ctl, ( dwgpio->swport + DWGPIO_SWPORT_CTL ) );
        writel ( dwgpio->ddr, ( dwgpio->swport + DWGPIO_SWPORT_DDR ) );
        writel ( dwgpio->dr, ( dwgpio->swport + DWGPIO_SWPORT_DR ) );
 
        /* Free GPIO device */
        gpios_nullify ( gpios );
        gpios_put ( gpios );
}

References dwgpio::ctl, dwgpio::ddr, dwgpio::dr, dt_get_drvdata(), DWGPIO_SWPORT_CTL, DWGPIO_SWPORT_DDR, DWGPIO_SWPORT_DR, gpios_nullify(), gpios_put(), gpios_unregister(), gpios::priv, dwgpio::swport, and writel.

Variable Documentation

dwgpio_group_ids

const char* dwgpio_group_ids[]

static

Initial value:

= {
        DT_ID ( "snps,dw-apb-gpio", "DesignWare GPIO" ),
}

DesignWare GPIO port group compatible model identifiers.

Definition at line 107 of file dwgpio.c.

                                         {
        DT_ID ( "snps,dw-apb-gpio", "DesignWare GPIO" ),
};

__dt_driver

struct dt_driver dwgpio_driver __dt_driver

Initial value:

= {
        .name = "dwgpio-group",
        .ids = dwgpio_group_ids,
        .id_count = ( sizeof ( dwgpio_group_ids ) /
                      sizeof ( dwgpio_group_ids[0] ) ),
        .probe = dwgpio_group_probe,
        .remove = dwgpio_group_remove,
}

DesignWare GPIO port group devicetree driver.

DesignWare GPIO port devicetree driver.

Definition at line 112 of file dwgpio.c.

                                                   {
        .name = "dwgpio-group",
        .ids = dwgpio_group_ids,
        .id_count = ( sizeof ( dwgpio_group_ids ) /
                      sizeof ( dwgpio_group_ids[0] ) ),
        .probe = dwgpio_group_probe,
        .remove = dwgpio_group_remove,
};

dwgpio_operations

struct gpio_operations dwgpio_operations

static

Initial value:

= {
        .in = dwgpio_in,
        .out = dwgpio_out,
        .config = dwgpio_config,
}

GPIO operations.

Definition at line 208 of file dwgpio.c.

                                                  {
        .in = dwgpio_in,
        .out = dwgpio_out,
        .config = dwgpio_config,
};

Referenced by dwgpio_probe().

dwgpio_ids

const char* dwgpio_ids[]

static

Initial value:

= {
        DT_ID ( "snps,dw-apb-gpio-port", "DesignWare GPIO port" ),
}

DesignWare GPIO port compatible model identifiers.

Definition at line 322 of file dwgpio.c.

                                   {
        DT_ID ( "snps,dw-apb-gpio-port", "DesignWare GPIO port" ),
};