fdtcon.c File Reference

Flattened Device Tree serial console. More...

#include <string.h>
#include <ipxe/serial.h>
#include <ipxe/devtree.h>
#include <ipxe/fdt.h>

Go to the source code of this file.

Macros
#define	SERIAL_PREFIX_fdt   __fdt_
#define	colour   &fdtcon_parent
	Colour for debug messages. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static struct uart *	fdtcon_default (void)
	Identify default serial console. More...
	PROVIDE_SERIAL (fdt, default_serial_console, fdtcon_default)

Variables
static struct device	fdtcon_parent
	FDT console parent device. More...

Detailed Description

Flattened Device Tree serial console.

Definition in file fdtcon.c.

Macro Definition Documentation

SERIAL_PREFIX_fdt

#define SERIAL_PREFIX_fdt   __fdt_

Definition at line 40 of file fdtcon.c.

colour

#define colour   &fdtcon_parent

Colour for debug messages.

Definition at line 51 of file fdtcon.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

fdtcon_default()

static struct uart* fdtcon_default ( void  )

static

Identify default serial console.

Return values

uart	Default serial console UART, or NULL

Definition at line 58 of file fdtcon.c.

                                             {
        unsigned int chosen;
        unsigned int stdout;
        const char *path;
        struct uart *prev;
        struct uart *uart;
        int rc;

        /* Record existing UART, if any */
        prev = list_last_entry ( &uarts, struct uart, list );

        /* Locate "/chosen" node */
        if ( ( rc = fdt_path ( &sysfdt, "/chosen", &chosen ) ) != 0 ) {
                DBGC ( colour, "FDTCON could not locate \"/chosen\": %s\n",
                       strerror ( rc ) );
                return NULL;
        }

        /* Get console device path (or alias) */
        path = fdt_string ( &sysfdt, chosen, "stdout-path" );
        if ( ! path ) {
                DBGC ( colour, "FDTCON has no console device\n" );
                return NULL;
        }
        DBGC ( colour, "FDTCON console device is \"%s\"\n", path );

        /* Locate device */
        if ( ( ( rc = fdt_path ( &sysfdt, path, &stdout ) ) != 0 ) &&
             ( ( rc = fdt_alias ( &sysfdt, path, &stdout ) ) != 0 ) ) {
                DBGC ( colour, "FDTCON could not locate \"/%s\": %s\n",
                       path, strerror ( rc ) );
                return NULL;
        }

        /* Probe device */
        if ( ( rc = dt_probe_node ( &fdtcon_parent, stdout ) ) != 0 ) {
                DBGC ( colour, "FDTCON could not probe \"%s\": %s\n",
                       path, strerror ( rc ) );
                return NULL;
        }

        /* Use newly added UART, if any */
        uart = list_last_entry ( &uarts, struct uart, list );
        if ( uart == prev )
                return NULL;

        DBGC ( colour, "FDTCON using UART %s\n", uart->name );
        return uart;
}

References colour, DBGC, dt_probe_node(), fdt_alias(), fdt_path(), fdt_string(), fdtcon_parent, uart::list, list_last_entry, uart::name, NULL, rc, strerror(), sysfdt, and uarts.

PROVIDE_SERIAL()

PROVIDE_SERIAL	(	fdt	,
		default_serial_console	,
		fdtcon_default
	)

Variable Documentation

fdtcon_parent

struct device fdtcon_parent

static

Initial value:

= {
        .name = "fdtcon",
        .siblings = LIST_HEAD_INIT ( fdtcon_parent.siblings ),
        .children = LIST_HEAD_INIT ( fdtcon_parent.children ),
}

FDT console parent device.

Definition at line 44 of file fdtcon.c.

Referenced by fdtcon_default().