mirror of
https://github.com/u-boot/u-boot.git
synced 2024-12-05 10:33:42 +08:00
84e63abfff
Show the U-Boot logo by default. This is only 7KB in size so seems like a useful default for boards that enable a display. If SPLASH_SCREEN is enabled, it is not enabled by default, so as not to conflict with that feature. Also disable it for tests, since we don't want to complicate the output. Signed-off-by: Simon Glass <sjg@chromium.org>
361 lines
9.4 KiB
C
361 lines
9.4 KiB
C
/*
|
|
* Video uclass and legacy implementation
|
|
*
|
|
* Copyright (c) 2015 Google, Inc
|
|
*
|
|
* MPC823 Video Controller
|
|
* =======================
|
|
* (C) 2000 by Paolo Scaffardi (arsenio@tin.it)
|
|
* AIRVENT SAM s.p.a - RIMINI(ITALY)
|
|
*
|
|
*/
|
|
|
|
#ifndef _VIDEO_H_
|
|
#define _VIDEO_H_
|
|
|
|
#include <stdio_dev.h>
|
|
|
|
struct udevice;
|
|
|
|
/**
|
|
* struct video_uc_plat - uclass platform data for a video device
|
|
*
|
|
* This holds information that the uclass needs to know about each device. It
|
|
* is accessed using dev_get_uclass_plat(dev). See 'Theory of operation' at
|
|
* the top of video-uclass.c for details on how this information is set.
|
|
*
|
|
* @align: Frame-buffer alignment, indicating the memory boundary the frame
|
|
* buffer should start on. If 0, 1MB is assumed
|
|
* @size: Frame-buffer size, in bytes
|
|
* @base: Base address of frame buffer, 0 if not yet known
|
|
* @copy_base: Base address of a hardware copy of the frame buffer. See
|
|
* CONFIG_VIDEO_COPY.
|
|
* @hide_logo: Hide the logo (used for testing)
|
|
*/
|
|
struct video_uc_plat {
|
|
uint align;
|
|
uint size;
|
|
ulong base;
|
|
ulong copy_base;
|
|
bool hide_logo;
|
|
};
|
|
|
|
enum video_polarity {
|
|
VIDEO_ACTIVE_HIGH, /* Pins are active high */
|
|
VIDEO_ACTIVE_LOW, /* Pins are active low */
|
|
};
|
|
|
|
/*
|
|
* Bits per pixel selector. Each value n is such that the bits-per-pixel is
|
|
* 2 ^ n
|
|
*/
|
|
enum video_log2_bpp {
|
|
VIDEO_BPP1 = 0,
|
|
VIDEO_BPP2,
|
|
VIDEO_BPP4,
|
|
VIDEO_BPP8,
|
|
VIDEO_BPP16,
|
|
VIDEO_BPP32,
|
|
};
|
|
|
|
/*
|
|
* Convert enum video_log2_bpp to bytes and bits. Note we omit the outer
|
|
* brackets to allow multiplication by fractional pixels.
|
|
*/
|
|
#define VNBYTES(bpix) (1 << (bpix)) / 8
|
|
|
|
#define VNBITS(bpix) (1 << (bpix))
|
|
|
|
enum video_format {
|
|
VIDEO_UNKNOWN,
|
|
VIDEO_X8B8G8R8,
|
|
VIDEO_X8R8G8B8,
|
|
VIDEO_X2R10G10B10,
|
|
};
|
|
|
|
/**
|
|
* struct video_priv - Device information used by the video uclass
|
|
*
|
|
* @xsize: Number of pixel columns (e.g. 1366)
|
|
* @ysize: Number of pixels rows (e.g.. 768)
|
|
* @rot: Display rotation (0=none, 1=90 degrees clockwise, etc.)
|
|
* @bpix: Encoded bits per pixel (enum video_log2_bpp)
|
|
* @format: Pixel format (enum video_format)
|
|
* @vidconsole_drv_name: Driver to use for the text console, NULL to
|
|
* select automatically
|
|
* @font_size: Font size in pixels (0 to use a default value)
|
|
* @fb: Frame buffer
|
|
* @fb_size: Frame buffer size
|
|
* @copy_fb: Copy of the frame buffer to keep up to date; see struct
|
|
* video_uc_plat
|
|
* @line_length: Length of each frame buffer line, in bytes. This can be
|
|
* set by the driver, but if not, the uclass will set it after
|
|
* probing
|
|
* @colour_fg: Foreground colour (pixel value)
|
|
* @colour_bg: Background colour (pixel value)
|
|
* @flush_dcache: true to enable flushing of the data cache after
|
|
* the LCD is updated
|
|
* @fg_col_idx: Foreground color code (bit 3 = bold, bit 0-2 = color)
|
|
* @bg_col_idx: Background color code (bit 3 = bold, bit 0-2 = color)
|
|
*/
|
|
struct video_priv {
|
|
/* Things set up by the driver: */
|
|
ushort xsize;
|
|
ushort ysize;
|
|
ushort rot;
|
|
enum video_log2_bpp bpix;
|
|
enum video_format format;
|
|
const char *vidconsole_drv_name;
|
|
int font_size;
|
|
|
|
/*
|
|
* Things that are private to the uclass: don't use these in the
|
|
* driver
|
|
*/
|
|
void *fb;
|
|
int fb_size;
|
|
void *copy_fb;
|
|
int line_length;
|
|
u32 colour_fg;
|
|
u32 colour_bg;
|
|
bool flush_dcache;
|
|
u8 fg_col_idx;
|
|
u8 bg_col_idx;
|
|
};
|
|
|
|
/**
|
|
* struct video_ops - structure for keeping video operations
|
|
* @video_sync: Synchronize FB with device. Some device like SPI based LCD
|
|
* displays needs synchronization when data in an FB is available.
|
|
* For these devices implement video_sync hook to call a sync
|
|
* function. vid is pointer to video device udevice. Function
|
|
* should return 0 on success video_sync and error code otherwise
|
|
*/
|
|
struct video_ops {
|
|
int (*video_sync)(struct udevice *vid);
|
|
};
|
|
|
|
#define video_get_ops(dev) ((struct video_ops *)(dev)->driver->ops)
|
|
|
|
/**
|
|
* video_reserve() - Reserve frame-buffer memory for video devices
|
|
*
|
|
* Note: This function is for internal use.
|
|
*
|
|
* This uses the uclass plat's @size and @align members to figure out
|
|
* a size and position for each frame buffer as part of the pre-relocation
|
|
* process of determining the post-relocation memory layout.
|
|
*
|
|
* gd->video_top is set to the initial value of *@addrp and gd->video_bottom
|
|
* is set to the final value.
|
|
*
|
|
* @addrp: On entry, the top of available memory. On exit, the new top,
|
|
* after allocating the required memory.
|
|
* @return 0
|
|
*/
|
|
int video_reserve(ulong *addrp);
|
|
|
|
#ifdef CONFIG_DM_VIDEO
|
|
/**
|
|
* video_clear() - Clear a device's frame buffer to background color.
|
|
*
|
|
* @dev: Device to clear
|
|
* @return 0
|
|
*/
|
|
int video_clear(struct udevice *dev);
|
|
#endif /* CONFIG_DM_VIDEO */
|
|
|
|
/**
|
|
* video_sync() - Sync a device's frame buffer with its hardware
|
|
*
|
|
* @vid: Device to sync
|
|
* @force: True to force a sync even if there was one recently (this is
|
|
* very expensive on sandbox)
|
|
*
|
|
* @return: 0 on success, error code otherwise
|
|
*
|
|
* Some frame buffers are cached or have a secondary frame buffer. This
|
|
* function syncs these up so that the current contents of the U-Boot frame
|
|
* buffer are displayed to the user.
|
|
*/
|
|
int video_sync(struct udevice *vid, bool force);
|
|
|
|
/**
|
|
* video_sync_all() - Sync all devices' frame buffers with there hardware
|
|
*
|
|
* This calls video_sync() on all active video devices.
|
|
*/
|
|
void video_sync_all(void);
|
|
|
|
/**
|
|
* video_bmp_display() - Display a BMP file
|
|
*
|
|
* @dev: Device to display the bitmap on
|
|
* @bmp_image: Address of bitmap image to display
|
|
* @x: X position in pixels from the left
|
|
* @y: Y position in pixels from the top
|
|
* @align: true to adjust the coordinates to centre the image. If false
|
|
* the coordinates are used as is. If true:
|
|
*
|
|
* - if a coordinate is 0x7fff then the image will be centred in
|
|
* that direction
|
|
* - if a coordinate is -ve then it will be offset to the
|
|
* left/top of the centre by that many pixels
|
|
* - if a coordinate is positive it will be used unchnaged.
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int video_bmp_display(struct udevice *dev, ulong bmp_image, int x, int y,
|
|
bool align);
|
|
|
|
/**
|
|
* video_get_xsize() - Get the width of the display in pixels
|
|
*
|
|
* @dev: Device to check
|
|
* @return device frame buffer width in pixels
|
|
*/
|
|
int video_get_xsize(struct udevice *dev);
|
|
|
|
/**
|
|
* video_get_ysize() - Get the height of the display in pixels
|
|
*
|
|
* @dev: Device to check
|
|
* @return device frame buffer height in pixels
|
|
*/
|
|
int video_get_ysize(struct udevice *dev);
|
|
|
|
/**
|
|
* Set whether we need to flush the dcache when changing the image. This
|
|
* defaults to off.
|
|
*
|
|
* @param flush non-zero to flush cache after update, 0 to skip
|
|
*/
|
|
void video_set_flush_dcache(struct udevice *dev, bool flush);
|
|
|
|
/**
|
|
* Set default colors and attributes
|
|
*
|
|
* @dev: video device
|
|
* @invert true to invert colours
|
|
*/
|
|
void video_set_default_colors(struct udevice *dev, bool invert);
|
|
|
|
#ifdef CONFIG_VIDEO_COPY
|
|
/**
|
|
* vidconsole_sync_copy() - Sync back to the copy framebuffer
|
|
*
|
|
* This ensures that the copy framebuffer has the same data as the framebuffer
|
|
* for a particular region. It should be called after the framebuffer is updated
|
|
*
|
|
* @from and @to can be in either order. The region between them is synced.
|
|
*
|
|
* @dev: Vidconsole device being updated
|
|
* @from: Start/end address within the framebuffer (->fb)
|
|
* @to: Other address within the frame buffer
|
|
* @return 0 if OK, -EFAULT if the start address is before the start of the
|
|
* frame buffer start
|
|
*/
|
|
int video_sync_copy(struct udevice *dev, void *from, void *to);
|
|
|
|
/**
|
|
* video_sync_copy_all() - Sync the entire framebuffer to the copy
|
|
*
|
|
* @dev: Vidconsole device being updated
|
|
* @return 0 (always)
|
|
*/
|
|
int video_sync_copy_all(struct udevice *dev);
|
|
#else
|
|
static inline int video_sync_copy(struct udevice *dev, void *from, void *to)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
static inline int video_sync_copy_all(struct udevice *dev)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
#endif
|
|
|
|
/**
|
|
* video_is_active() - Test if one video device it active
|
|
*
|
|
* @return true if at least one video device is active, else false.
|
|
*/
|
|
bool video_is_active(void);
|
|
|
|
#ifndef CONFIG_DM_VIDEO
|
|
|
|
/* Video functions */
|
|
|
|
/**
|
|
* Display a BMP format bitmap on the screen
|
|
*
|
|
* @param bmp_image Address of BMP image
|
|
* @param x X position to draw image
|
|
* @param y Y position to draw image
|
|
*/
|
|
int video_display_bitmap(ulong bmp_image, int x, int y);
|
|
|
|
/**
|
|
* Get the width of the screen in pixels
|
|
*
|
|
* @return width of screen in pixels
|
|
*/
|
|
int video_get_pixel_width(void);
|
|
|
|
/**
|
|
* Get the height of the screen in pixels
|
|
*
|
|
* @return height of screen in pixels
|
|
*/
|
|
int video_get_pixel_height(void);
|
|
|
|
/**
|
|
* Get the number of text lines/rows on the screen
|
|
*
|
|
* @return number of rows
|
|
*/
|
|
int video_get_screen_rows(void);
|
|
|
|
/**
|
|
* Get the number of text columns on the screen
|
|
*
|
|
* @return number of columns
|
|
*/
|
|
int video_get_screen_columns(void);
|
|
|
|
/**
|
|
* Set the position of the text cursor
|
|
*
|
|
* @param col Column to place cursor (0 = left side)
|
|
* @param row Row to place cursor (0 = top line)
|
|
*/
|
|
void video_position_cursor(unsigned col, unsigned row);
|
|
|
|
/* Clear the display */
|
|
void video_clear(void);
|
|
|
|
#if defined(CONFIG_FORMIKE)
|
|
int kwh043st20_f01_spi_startup(unsigned int bus, unsigned int cs,
|
|
unsigned int max_hz, unsigned int spi_mode);
|
|
#endif
|
|
#if defined(CONFIG_LG4573)
|
|
int lg4573_spi_startup(unsigned int bus, unsigned int cs,
|
|
unsigned int max_hz, unsigned int spi_mode);
|
|
#endif
|
|
|
|
/*
|
|
* video_get_info_str() - obtain a board string: type, speed, etc.
|
|
*
|
|
* This is called if CONFIG_CONSOLE_EXTRA_INFO is enabled.
|
|
*
|
|
* line_number: location to place info string beside logo
|
|
* info: buffer for info string (empty if nothing to display on this
|
|
* line)
|
|
*/
|
|
void video_get_info_str(int line_number, char *info);
|
|
|
|
#endif /* !CONFIG_DM_VIDEO */
|
|
|
|
#endif
|