dwuart.c File Reference

DesignWare UART. More...

#include <errno.h>
#include <ipxe/uart.h>
#include <ipxe/ns16550.h>
#include <ipxe/devtree.h>
#include <ipxe/fdt.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static int	dwuart_probe (struct dt_device *dt, unsigned int offset)
	Probe devicetree device.
static void	dwuart_remove (struct dt_device *dt)
	Remove devicetree device.

Variables
static const char *	dwuart_ids []
	DesignWare UART compatible model identifiers.
struct dt_driver dwuart_driver	__dt_driver
	DesignWare UART devicetree driver.

Detailed Description

DesignWare UART.

Definition in file dwuart.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

dwuart_probe()

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

static

Probe devicetree device.

Parameters

dt	Devicetree device
offset	Starting node offset

Return values

rc	Return status code

Definition at line 45 of file dwuart.c.

                                                                      {
        struct ns16550_uart *ns16550;
        struct uart *uart;
        uint32_t shift;
        uint32_t clock;
        int rc;
 
        /* Allocate and initialise UART */
        uart = alloc_uart ( sizeof ( *ns16550 ) );
        if ( ! uart ) {
                rc = -ENOMEM;
                goto err_alloc;
        }
        uart->name = dt->name;
        uart->op = &ns16550_operations;
        ns16550 = uart->priv;
        dt_set_drvdata ( dt, uart );
 
        /* Map registers */
        ns16550->base = dt_ioremap ( dt, offset, 0, 0 );
        if ( ! ns16550->base ) {
                rc = -ENODEV;
                goto err_ioremap;
        }
 
        /* Get register shift */
        if ( ( rc = fdt_u32 ( &sysfdt, offset, "reg-shift", &shift ) ) != 0 )
                shift = 0;
        ns16550->shift = shift;
 
        /* Get clock rate */
        if ( ( rc = fdt_u32 ( &sysfdt, offset, "clock-frequency",
                              &clock ) ) != 0 ) {
                clock = NS16550_CLK_DEFAULT;
        }
        ns16550->clock = clock;
 
        /* Register UART */
        if ( ( rc = uart_register ( uart ) ) != 0 )
                goto err_register;
 
        return 0;
 
        uart_unregister ( uart );
 err_register:
        iounmap ( ns16550->base );
 err_ioremap:
        uart_nullify ( uart );
        uart_put ( uart );
 err_alloc:
        return rc;
}

References alloc_uart(), ns16550_uart::base, ns16550_uart::clock, dt_ioremap(), dt_set_drvdata(), ENODEV, ENOMEM, fdt_u32(), iounmap(), dt_device::name, uart::name, NS16550_CLK_DEFAULT, ns16550_operations, offset, uart::op, uart::priv, rc, ns16550_uart::shift, sysfdt, uart_register(), and uart_unregister().

dwuart_remove()

void dwuart_remove ( struct dt_device * dt )

static

Remove devicetree device.

Parameters

dt	Devicetree device

Definition at line 103 of file dwuart.c.

                                                   {
        struct uart *uart = dt_get_drvdata ( dt );
        struct ns16550_uart *ns16550 = uart->priv;
 
        /* Unregister UART */
        uart_unregister ( uart );
 
        /* Free UART */
        iounmap ( ns16550->base );
        uart_nullify ( uart );
        uart_put ( uart );
}

References ns16550_uart::base, dt_get_drvdata(), iounmap(), uart::priv, and uart_unregister().

Variable Documentation

dwuart_ids

const char* dwuart_ids[]

static

Initial value:

= {
        DT_ID ( "snps,dw-apb-uart", "DesignWare UART" ),
        DT_ID ( "ns16550a", "NS16550-compatible" ),
}

DesignWare UART compatible model identifiers.

Definition at line 117 of file dwuart.c.

                                   {
        DT_ID ( "snps,dw-apb-uart", "DesignWare UART" ),
        DT_ID ( "ns16550a", "NS16550-compatible" ),
};

__dt_driver

struct dt_driver dwuart_driver __dt_driver

Initial value:

= {
        .name = "dwuart",
        .ids = dwuart_ids,
        .id_count = ( sizeof ( dwuart_ids ) / sizeof ( dwuart_ids[0] ) ),
        .probe = dwuart_probe,
        .remove = dwuart_remove,
}

DesignWare UART devicetree driver.

Definition at line 123 of file dwuart.c.

                                             {
        .name = "dwuart",
        .ids = dwuart_ids,
        .id_count = ( sizeof ( dwuart_ids ) / sizeof ( dwuart_ids[0] ) ),
        .probe = dwuart_probe,
        .remove = dwuart_remove,
};