efi_fbcon.c File Reference

EFI frame buffer console. More...

#include <string.h>
#include <strings.h>
#include <ctype.h>
#include <errno.h>
#include <assert.h>
#include <limits.h>
#include <ipxe/efi/efi.h>
#include <ipxe/efi/Protocol/GraphicsOutput.h>
#include <ipxe/efi/Protocol/HiiFont.h>
#include <ipxe/ansicol.h>
#include <ipxe/fbcon.h>
#include <ipxe/console.h>
#include <ipxe/umalloc.h>
#include <ipxe/rotate.h>
#include <config/console.h>

Go to the source code of this file.

Data Structures
struct	efifb
	An EFI frame buffer. More...

Macros
#define	CONSOLE_EFIFB   ( CONSOLE_USAGE_ALL & ~CONSOLE_USAGE_LOG )
#define	EFIFB_ASCII   128
	Number of ASCII glyphs in cache. More...
#define	EFIFB_DYNAMIC   32
	Number of dynamic non-ASCII glyphs in cache. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static int	efifb_draw (unsigned int character, unsigned int index, unsigned int toggle)
	Draw character glyph. More...
static int	efifb_draw_unknown (unsigned int index)
	Draw "unknown character" glyph. More...
static unsigned int	efifb_dynamic (unsigned int character)
	Get dynamic glyph index. More...
static void	efifb_glyph (unsigned int character, uint8_t *glyph)
	Get character glyph. More...
static int	efifb_glyphs (void)
	Get character glyphs. More...
static int	efifb_colour_map_mask (uint32_t mask, uint8_t *scale, uint8_t *lsb)
	Generate colour mapping for a single colour component. More...
static int	efifb_colour_map (EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *info, struct fbcon_colour_map *map)
	Generate colour mapping. More...
static int	efifb_select_mode (unsigned int min_width, unsigned int min_height, unsigned int min_bpp)
	Select video mode. More...
static int	efifb_restore (void)
	Restore video mode. More...
static int	efifb_init (struct console_configuration *config)
	Initialise EFI frame buffer. More...
static void	efifb_fini (void)
	Finalise EFI frame buffer. More...
static void	efifb_putchar (int character)
	Print a character to current cursor position. More...
static int	efifb_configure (struct console_configuration *config)
	Configure console. More...

Variables
struct console_driver	efi_console
struct console_driver efifb_console	__console_driver
	EFI graphics output protocol console driver. More...
static struct efifb	efifb
	The EFI frame buffer. More...

Detailed Description

EFI frame buffer console.

Definition in file efi_fbcon.c.

Macro Definition Documentation

CONSOLE_EFIFB

#define CONSOLE_EFIFB   ( CONSOLE_USAGE_ALL & ~CONSOLE_USAGE_LOG )

Definition at line 62 of file efi_fbcon.c.

EFIFB_ASCII

#define EFIFB_ASCII   128

Number of ASCII glyphs in cache.

Definition at line 66 of file efi_fbcon.c.

EFIFB_DYNAMIC

#define EFIFB_DYNAMIC   32

Number of dynamic non-ASCII glyphs in cache.

Definition at line 69 of file efi_fbcon.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

efifb_draw()

static int efifb_draw ( unsigned int  character, unsigned int  index, unsigned int  toggle  )

static

Draw character glyph.

Parameters

character	Character
index	Index within glyph cache
toggle	Bits to toggle in each bitmask

Return values

height

Character height, or negative error

Definition at line 112 of file efi_fbcon.c.

                                              {
        EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
        EFI_IMAGE_OUTPUT *blt;
        EFI_GRAPHICS_OUTPUT_BLT_PIXEL *pixel;
        unsigned int height;
        unsigned int x;
        unsigned int y;
        uint8_t bitmask;
        size_t offset;
        EFI_STATUS efirc;
        int rc;

        /* Clear existing glyph */
        offset = ( index * efifb.font.height );
        memset_user ( efifb.glyphs, offset, 0, efifb.font.height );

        /* Get glyph */
        blt = NULL;
        if ( ( efirc = efifb.hiifont->GetGlyph ( efifb.hiifont, character,
                                                 NULL, &blt, NULL ) ) != 0 ) {
                rc = -EEFI ( efirc );
                DBGC ( &efifb, "EFIFB could not get glyph %#02x: %s\n",
                       character, strerror ( rc ) );
                goto err_get;
        }
        assert ( blt != NULL );

        /* Sanity check */
        if ( blt->Width > 8 ) {
                DBGC ( &efifb, "EFIFB glyph %#02x invalid width %d\n",
                       character, blt->Width );
                rc = -EINVAL;
                goto err_width;
        }

        /* Convert glyph to bitmap */
        pixel = blt->Image.Bitmap;
        height = blt->Height;
        for ( y = 0 ; ( ( y < height ) && ( y < efifb.font.height ) ) ; y++ ) {
                bitmask = 0;
                for ( x = 0 ; x < blt->Width ; x++ ) {
                        bitmask = rol8 ( bitmask, 1 );
                        if ( pixel->Blue || pixel->Green || pixel->Red )
                                bitmask |= 0x01;
                        pixel++;
                }
                bitmask ^= toggle;
                copy_to_user ( efifb.glyphs, offset++, &bitmask,
                               sizeof ( bitmask ) );
        }

        /* Free glyph */
        bs->FreePool ( blt );

        return height;

 err_width:
        bs->FreePool ( blt );
 err_get:
        return rc;
}

References assert(), _EFI_IMAGE_OUTPUT::Bitmap, EFI_SYSTEM_TABLE::BootServices, copy_to_user(), DBGC, EEFI, efi_systab, EINVAL, efifb::font, EFI_BOOT_SERVICES::FreePool, _EFI_HII_FONT_PROTOCOL::GetGlyph, efifb::glyphs, fbcon_font::height, _EFI_IMAGE_OUTPUT::Height, efifb::hiifont, _EFI_IMAGE_OUTPUT::Image, index, memset_user(), NULL, offset, efifb::pixel, rc, strerror(), and _EFI_IMAGE_OUTPUT::Width.

Referenced by efifb_draw_unknown(), efifb_dynamic(), and efifb_glyphs().

efifb_draw_unknown()

static int efifb_draw_unknown ( unsigned int  index )

static

Draw "unknown character" glyph.

Parameters

index

Index within glyph cache

Return values

rc	Return status code

Definition at line 181 of file efi_fbcon.c.

                                                     {

        /* Draw an inverted '?' glyph */
        return efifb_draw ( '?', index, -1U );
}

References efifb_draw(), and index.

Referenced by efifb_dynamic(), and efifb_glyphs().

efifb_dynamic()

static unsigned int efifb_dynamic ( unsigned int  character )

static

Get dynamic glyph index.

Parameters

character

Unicode character

Return values

index

Glyph cache index

Definition at line 193 of file efi_fbcon.c.

                                                             {
        unsigned int dynamic;
        unsigned int index;
        unsigned int i;
        int height;

        /* Search existing cached entries */
        for ( i = 0 ; i < EFIFB_DYNAMIC ; i++ ) {
                if ( character == efifb.dynamic[i] )
                        return ( EFIFB_ASCII + i );
        }

        /* Overwrite the oldest cache entry */
        dynamic = ( efifb.next++ % EFIFB_DYNAMIC );
        index = ( EFIFB_ASCII + dynamic );
        DBGC2 ( &efifb, "EFIFB dynamic %#02x is glyph %#02x\n",
                dynamic, character );

        /* Draw glyph */
        height = efifb_draw ( character, index, 0 );
        if ( height < 0 )
                efifb_draw_unknown ( index );

        /* Record cached character */
        efifb.dynamic[dynamic] = character;

        return index;
}

References DBGC2, efifb::dynamic, EFIFB_ASCII, efifb_draw(), efifb_draw_unknown(), EFIFB_DYNAMIC, index, and efifb::next.

Referenced by efifb_glyph().

efifb_glyph()

static void efifb_glyph ( unsigned int  character, uint8_t *  glyph  )

static

Get character glyph.

Parameters

character	Unicode character
glyph	Character glyph to fill in

Definition at line 228 of file efi_fbcon.c.

                                                                   {
        unsigned int index;
        size_t offset;

        /* Identify glyph */
        if ( character < EFIFB_ASCII ) {

                /* ASCII character: use fixed cache entry */
                index = character;

        } else {

                /* Non-ASCII character: use dynamic glyph cache */
                index = efifb_dynamic ( character );
        }

        /* Copy cached glyph */
        offset = ( index * efifb.font.height );
        copy_from_user ( glyph, efifb.glyphs, offset, efifb.font.height );
}

References copy_from_user(), EFIFB_ASCII, efifb_dynamic(), efifb::font, efifb::glyphs, fbcon_font::height, index, and offset.

Referenced by efifb_glyphs().

efifb_glyphs()

static int efifb_glyphs ( void  )

static

Get character glyphs.

Return values

rc	Return status code

Definition at line 254 of file efi_fbcon.c.

                                 {
        unsigned int character;
        int height;
        int max;
        size_t len;
        int rc;

        /* Get font height.  The GetFontInfo() call nominally returns
         * this information in an EFI_FONT_DISPLAY_INFO structure, but
         * is known to fail on many UEFI implementations.  Instead, we
         * iterate over all printable characters to find the maximum
         * height.
         */
        efifb.font.height = 0;
        max = 0;
        for ( character = 0 ; character < EFIFB_ASCII ; character++ ) {

                /* Skip non-printable characters */
                if ( ! isprint ( character ) )
                        continue;

                /* Get glyph */
                height = efifb_draw ( character, 0, 0 );
                if ( height < 0 ) {
                        rc = height;
                        goto err_height;
                }

                /* Calculate maximum height */
                if ( max < height )
                        max = height;
        }
        if ( ! max ) {
                DBGC ( &efifb, "EFIFB could not get font height\n" );
                return -ENOENT;
        }
        efifb.font.height = max;

        /* Allocate glyph data */
        len = ( ( EFIFB_ASCII + EFIFB_DYNAMIC ) * efifb.font.height );
        efifb.glyphs = umalloc ( len );
        if ( ! efifb.glyphs ) {
                rc = -ENOMEM;
                goto err_alloc;
        }
        memset_user ( efifb.glyphs, 0, 0, len );

        /* Get font data */
        for ( character = 0 ; character < EFIFB_ASCII ; character++ ) {

                /* Skip non-printable characters */
                if ( ! isprint ( character ) ) {
                        efifb_draw_unknown ( character );
                        continue;
                }

                /* Get glyph */
                height = efifb_draw ( character, character, 0 );
                if ( height < 0 ) {
                        rc = height;
                        goto err_draw;
                }
        }

        /* Clear dynamic glyph character cache */
        memset ( efifb.dynamic, 0, sizeof ( efifb.dynamic ) );

        efifb.font.glyph = efifb_glyph;
        return 0;

 err_draw:
        ufree ( efifb.glyphs );
 err_alloc:
 err_height:
        return rc;
}

References DBGC, efifb::dynamic, EFIFB_ASCII, efifb_draw(), efifb_draw_unknown(), EFIFB_DYNAMIC, efifb_glyph(), ENOENT, ENOMEM, efifb::font, fbcon_font::glyph, efifb::glyphs, fbcon_font::height, isprint(), len, max, memset(), memset_user(), rc, ufree(), and umalloc().

Referenced by efifb_init().

efifb_colour_map_mask()

static int efifb_colour_map_mask ( uint32_t  mask, uint8_t *  scale, uint8_t *  lsb  )

static

Generate colour mapping for a single colour component.

Parameters

mask	Mask value
scale	Scale value to fill in
lsb	LSB value to fill in

Return values

rc	Return status code

Definition at line 339 of file efi_fbcon.c.

                                                  {
        uint32_t check;

        /* Fill in LSB and scale */
        *lsb = ( mask ? ( ffs ( mask ) - 1 ) : 0 );
        *scale = ( mask ? ( 8 - ( fls ( mask ) - *lsb ) ) : 8 );

        /* Check that original mask was contiguous */
        check = ( ( 0xff >> *scale ) << *lsb );
        if ( check != mask )
                return -ENOTSUP;

        return 0;
}

References ENOTSUP, ffs, and fls.

Referenced by efifb_colour_map().

efifb_colour_map()

static int efifb_colour_map ( EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *  info, struct fbcon_colour_map *  map  )

static

Generate colour mapping.

Parameters

info	EFI mode information
map	Colour mapping to fill in

Return values

bpp	Number of bits per pixel, or negative error

Definition at line 362 of file efi_fbcon.c.

                                                             {
        static EFI_PIXEL_BITMASK rgb_mask = {
                0x000000ffUL, 0x0000ff00UL, 0x00ff0000UL, 0xff000000UL
        };
        static EFI_PIXEL_BITMASK bgr_mask = {
                0x00ff0000UL, 0x0000ff00UL, 0x000000ffUL, 0xff000000UL
        };
        EFI_PIXEL_BITMASK *mask;
        uint8_t reserved_scale;
        uint8_t reserved_lsb;
        int rc;

        /* Determine applicable mask */
        switch ( info->PixelFormat ) {
        case PixelRedGreenBlueReserved8BitPerColor:
                mask = &rgb_mask;
                break;
        case PixelBlueGreenRedReserved8BitPerColor:
                mask = &bgr_mask;
                break;
        case PixelBitMask:
                mask = &info->PixelInformation;
                break;
        default:
                DBGC ( &efifb, "EFIFB unrecognised pixel format %d\n",
                       info->PixelFormat );
                return -ENOTSUP;
        }

        /* Map each colour component */
        if ( ( rc = efifb_colour_map_mask ( mask->RedMask, &map->red_scale,
                                            &map->red_lsb ) ) != 0 )
                return rc;
        if ( ( rc = efifb_colour_map_mask ( mask->GreenMask, &map->green_scale,
                                            &map->green_lsb ) ) != 0 )
                return rc;
        if ( ( rc = efifb_colour_map_mask ( mask->BlueMask, &map->blue_scale,
                                            &map->blue_lsb ) ) != 0 )
                return rc;
        if ( ( rc = efifb_colour_map_mask ( mask->ReservedMask, &reserved_scale,
                                            &reserved_lsb ) ) != 0 )
                return rc;

        /* Calculate total number of bits per pixel */
        return ( 32 - ( reserved_scale + map->red_scale + map->green_scale +
                        map->blue_scale ) );
}

References EFI_PIXEL_BITMASK::BlueMask, DBGC, efifb_colour_map_mask(), ENOTSUP, EFI_PIXEL_BITMASK::GreenMask, info, map, PixelBitMask, PixelBlueGreenRedReserved8BitPerColor, PixelRedGreenBlueReserved8BitPerColor, rc, EFI_PIXEL_BITMASK::RedMask, and EFI_PIXEL_BITMASK::ReservedMask.

Referenced by efifb_init(), and efifb_select_mode().

efifb_select_mode()

static int efifb_select_mode ( unsigned int  min_width, unsigned int  min_height, unsigned int  min_bpp  )

static

Select video mode.

Parameters

min_width	Minimum required width (in pixels)
min_height	Minimum required height (in pixels)
min_bpp	Minimum required colour depth (in bits per pixel)

Return values

mode_number

Mode number, or negative error

Definition at line 419 of file efi_fbcon.c.

                                                      {
        EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
        struct fbcon_colour_map map;
        EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *info;
        int best_mode_number = -ENOENT;
        unsigned int best_score = INT_MAX;
        unsigned int score;
        unsigned int mode;
        int bpp;
        UINTN size;
        EFI_STATUS efirc;
        int rc;

        /* Find the best mode */
        for ( mode = 0 ; mode < efifb.gop->Mode->MaxMode ; mode++ ) {

                /* Get mode information */
                if ( ( efirc = efifb.gop->QueryMode ( efifb.gop, mode, &size,
                                                      &info ) ) != 0 ) {
                        rc = -EEFI ( efirc );
                        DBGC ( &efifb, "EFIFB could not get mode %d "
                               "information: %s\n", mode, strerror ( rc ) );
                        goto err_query;
                }

                /* Skip unusable modes */
                bpp = efifb_colour_map ( info, &map );
                if ( bpp < 0 ) {
                        rc = bpp;
                        DBGC ( &efifb, "EFIFB could not build colour map for "
                               "mode %d: %s\n", mode, strerror ( rc ) );
                        goto err_map;
                }

                /* Skip modes not meeting the requirements */
                if ( ( info->HorizontalResolution < min_width ) ||
                     ( info->VerticalResolution < min_height ) ||
                     ( ( ( unsigned int ) bpp ) < min_bpp ) ) {
                        goto err_requirements;
                }

                /* Select this mode if it has the best (i.e. lowest)
                 * score.  We choose the scoring system to favour
                 * modes close to the specified width and height;
                 * within modes of the same width and height we prefer
                 * a higher colour depth.
                 */
                score = ( ( info->HorizontalResolution *
                            info->VerticalResolution ) - bpp );
                if ( score < best_score ) {
                        best_mode_number = mode;
                        best_score = score;
                }

        err_requirements:
        err_map:
                bs->FreePool ( info );
        err_query:
                continue;
        }

        if ( best_mode_number < 0 )
                DBGC ( &efifb, "EFIFB found no suitable mode\n" );
        return best_mode_number;
}

References EFI_SYSTEM_TABLE::BootServices, DBGC, EEFI, efi_systab, efifb_colour_map(), ENOENT, EFI_BOOT_SERVICES::FreePool, efifb::gop, info, INT_MAX, map, EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE::MaxMode, _EFI_GRAPHICS_OUTPUT_PROTOCOL::Mode, _EFI_GRAPHICS_OUTPUT_PROTOCOL::QueryMode, rc, size, and strerror().

Referenced by efifb_init().

efifb_restore()

static int efifb_restore ( void  )

static

Restore video mode.

Parameters

rc	Return status code

Definition at line 491 of file efi_fbcon.c.

                                  {
        EFI_STATUS efirc;
        int rc;

        /* Restore original mode */
        if ( ( efirc = efifb.gop->SetMode ( efifb.gop,
                                            efifb.saved_mode ) ) != 0 ) {
                rc = -EEFI ( efirc );
                DBGC ( &efifb, "EFIFB could not restore mode %d: %s\n",
                       efifb.saved_mode, strerror ( rc ) );
                return rc;
        }

        return 0;
}

References DBGC, EEFI, efifb::gop, rc, efifb::saved_mode, _EFI_GRAPHICS_OUTPUT_PROTOCOL::SetMode, and strerror().

Referenced by efifb_fini(), and efifb_init().

efifb_init()

static int efifb_init ( struct console_configuration *  config )

static

Initialise EFI frame buffer.

Parameters

config

Console configuration, or NULL to reset

Return values

rc	Return status code

Definition at line 513 of file efi_fbcon.c.

                                                               {
        EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
        EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *info;
        void *interface;
        int mode;
        int bpp;
        EFI_STATUS efirc;
        int rc;

        /* Locate graphics output protocol */
        if ( ( efirc = bs->LocateProtocol ( &efi_graphics_output_protocol_guid,
                                            NULL, &interface ) ) != 0 ) {
                rc = -EEFI ( efirc );
                DBGC ( &efifb, "EFIFB could not locate graphics output "
                       "protocol: %s\n", strerror ( rc ) );
                goto err_locate_gop;
        }
        efifb.gop = interface;

        /* Locate HII font protocol */
        if ( ( efirc = bs->LocateProtocol ( &efi_hii_font_protocol_guid,
                                            NULL, &interface ) ) != 0 ) {
                rc = -EEFI ( efirc );
                DBGC ( &efifb, "EFIFB could not locate HII font protocol: %s\n",
                       strerror ( rc ) );
                goto err_locate_hiifont;
        }
        efifb.hiifont = interface;

        /* Locate glyphs */
        if ( ( rc = efifb_glyphs() ) != 0 )
                goto err_glyphs;

        /* Save original mode */
        efifb.saved_mode = efifb.gop->Mode->Mode;

        /* Select mode */
        if ( ( mode = efifb_select_mode ( config->width, config->height,
                                          config->depth ) ) < 0 ) {
                rc = mode;
                goto err_select_mode;
        }

        /* Set mode */
        if ( ( efirc = efifb.gop->SetMode ( efifb.gop, mode ) ) != 0 ) {
                rc = -EEFI ( efirc );
                DBGC ( &efifb, "EFIFB could not set mode %d: %s\n",
                       mode, strerror ( rc ) );
                goto err_set_mode;
        }
        info = efifb.gop->Mode->Info;

        /* Populate colour map */
        bpp = efifb_colour_map ( info, &efifb.map );
        if ( bpp < 0 ) {
                rc = bpp;
                DBGC ( &efifb, "EFIFB could not build colour map for "
                       "mode %d: %s\n", mode, strerror ( rc ) );
                goto err_map;
        }

        /* Populate pixel geometry */
        efifb.pixel.width = info->HorizontalResolution;
        efifb.pixel.height = info->VerticalResolution;
        efifb.pixel.len = ( ( bpp + 7 ) / 8 );
        efifb.pixel.stride = ( efifb.pixel.len * info->PixelsPerScanLine );

        /* Populate frame buffer address */
        efifb.start = efifb.gop->Mode->FrameBufferBase;
        DBGC ( &efifb, "EFIFB using mode %d (%dx%d %dbpp at %#08lx)\n",
               mode, efifb.pixel.width, efifb.pixel.height, bpp, efifb.start );

        /* Initialise frame buffer console */
        if ( ( rc = fbcon_init ( &efifb.fbcon, phys_to_user ( efifb.start ),
                                 &efifb.pixel, &efifb.map, &efifb.font,
                                 config ) ) != 0 )
                goto err_fbcon_init;

        return 0;

        fbcon_fini ( &efifb.fbcon );
 err_fbcon_init:
 err_map:
        efifb_restore();
 err_set_mode:
 err_select_mode:
        ufree ( efifb.glyphs );
 err_glyphs:
 err_locate_hiifont:
 err_locate_gop:
        return rc;
}

References EFI_SYSTEM_TABLE::BootServices, DBGC, console_configuration::depth, EEFI, efi_graphics_output_protocol_guid, efi_hii_font_protocol_guid, efi_systab, efifb_colour_map(), efifb_glyphs(), efifb_restore(), efifb_select_mode(), efifb::fbcon, fbcon_fini(), fbcon_init(), efifb::font, EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE::FrameBufferBase, efifb::glyphs, efifb::gop, console_configuration::height, fbcon_geometry::height, efifb::hiifont, info, EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE::Info, fbcon_geometry::len, EFI_BOOT_SERVICES::LocateProtocol, efifb::map, EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE::Mode, _EFI_GRAPHICS_OUTPUT_PROTOCOL::Mode, NULL, phys_to_user(), efifb::pixel, rc, efifb::saved_mode, _EFI_GRAPHICS_OUTPUT_PROTOCOL::SetMode, efifb::start, strerror(), fbcon_geometry::stride, ufree(), console_configuration::width, and fbcon_geometry::width.

Referenced by efifb_configure().

efifb_fini()

static void efifb_fini ( void  )

static

Finalise EFI frame buffer.

Definition at line 610 of file efi_fbcon.c.

                                {

        /* Finalise frame buffer console */
        fbcon_fini ( &efifb.fbcon );

        /* Restore saved mode */
        efifb_restore();

        /* Free glyphs */
        ufree ( efifb.glyphs );
}

References efifb_restore(), efifb::fbcon, fbcon_fini(), efifb::glyphs, and ufree().

Referenced by efifb_configure().

efifb_putchar()

static void efifb_putchar ( int  character )

static

Print a character to current cursor position.

Parameters

character

Character

Definition at line 627 of file efi_fbcon.c.

                                            {

        fbcon_putchar ( &efifb.fbcon, character );
}

References efifb::fbcon, and fbcon_putchar().

efifb_configure()

static int efifb_configure ( struct console_configuration *  config )

static

Configure console.

Parameters

config

Console configuration, or NULL to reset

Return values

rc	Return status code

Definition at line 638 of file efi_fbcon.c.

                                                                    {
        int rc;

        /* Reset console, if applicable */
        if ( ! efifb_console.disabled ) {
                efifb_fini();
                efi_console.disabled &= ~CONSOLE_DISABLED_OUTPUT;
                ansicol_reset_magic();
        }
        efifb_console.disabled = CONSOLE_DISABLED;

        /* Do nothing more unless we have a usable configuration */
        if ( ( config == NULL ) ||
             ( config->width == 0 ) || ( config->height == 0 ) ) {
                return 0;
        }

        /* Initialise EFI frame buffer */
        if ( ( rc = efifb_init ( config ) ) != 0 )
                return rc;

        /* Mark console as enabled */
        efifb_console.disabled = 0;
        efi_console.disabled |= CONSOLE_DISABLED_OUTPUT;

        /* Set magic colour to transparent if we have a background picture */
        if ( config->pixbuf )
                ansicol_set_magic_transparent();

        return 0;
}

References ansicol_reset_magic(), ansicol_set_magic_transparent(), CONSOLE_DISABLED, CONSOLE_DISABLED_OUTPUT, console_driver::disabled, efi_console, efifb_fini(), efifb_init(), console_configuration::height, NULL, console_configuration::pixbuf, rc, and console_configuration::width.

Variable Documentation

efi_console

struct console_driver efi_console

Definition at line 51 of file efi_fbcon.c.

Referenced by efifb_configure().

__console_driver

struct console_driver efifb_console __console_driver

Initial value:

= {
        .usage = CONSOLE_EFIFB,
        .putchar = efifb_putchar,
        .configure = efifb_configure,
        .disabled = CONSOLE_DISABLED,
}

EFI graphics output protocol console driver.

Definition at line 72 of file efi_fbcon.c.

efifb

struct efifb efifb

static

The EFI frame buffer.

Definition at line 102 of file efi_fbcon.c.