mirror of
https://github.com/brain-hackers/u-boot-brain
synced 2024-08-20 00:48:52 +09:00
![Tom Rini](/assets/img/avatar_default.png)
When U-Boot started using SPDX tags we were among the early adopters and there weren't a lot of other examples to borrow from. So we picked the area of the file that usually had a full license text and replaced it with an appropriate SPDX-License-Identifier: entry. Since then, the Linux Kernel has adopted SPDX tags and they place it as the very first line in a file (except where shebangs are used, then it's second line) and with slightly different comment styles than us. In part due to community overlap, in part due to better tag visibility and in part for other minor reasons, switch over to that style. This commit changes all instances where we have a single declared license in the tag as both the before and after are identical in tag contents. There's also a few places where I found we did not have a tag and have introduced one. Signed-off-by: Tom Rini <trini@konsulko.com>
242 lines
6.9 KiB
C
242 lines
6.9 KiB
C
/* SPDX-License-Identifier: GPL-2.0+ */
|
|
/*
|
|
* Copyright (c) 2015 Google, Inc
|
|
*/
|
|
|
|
#ifndef __video_console_h
|
|
#define __video_console_h
|
|
|
|
#include <video.h>
|
|
|
|
#define VID_FRAC_DIV 256
|
|
|
|
#define VID_TO_PIXEL(x) ((x) / VID_FRAC_DIV)
|
|
#define VID_TO_POS(x) ((x) * VID_FRAC_DIV)
|
|
|
|
/*
|
|
* The 16 colors supported by the console
|
|
*/
|
|
enum color_idx {
|
|
VID_BLACK = 0,
|
|
VID_RED,
|
|
VID_GREEN,
|
|
VID_BROWN,
|
|
VID_BLUE,
|
|
VID_MAGENTA,
|
|
VID_CYAN,
|
|
VID_LIGHT_GRAY,
|
|
VID_GRAY,
|
|
VID_LIGHT_RED,
|
|
VID_LIGTH_GREEN,
|
|
VID_YELLOW,
|
|
VID_LIGHT_BLUE,
|
|
VID_LIGHT_MAGENTA,
|
|
VID_LIGHT_CYAN,
|
|
VID_WHITE,
|
|
|
|
VID_COLOR_COUNT
|
|
};
|
|
|
|
/**
|
|
* struct vidconsole_priv - uclass-private data about a console device
|
|
*
|
|
* Drivers must set up @rows, @cols, @x_charsize, @y_charsize in their probe()
|
|
* method. Drivers may set up @xstart_frac if desired.
|
|
*
|
|
* @sdev: stdio device, acting as an output sink
|
|
* @xcur_frac: Current X position, in fractional units (VID_TO_POS(x))
|
|
* @curr_row: Current Y position in pixels (0=top)
|
|
* @rows: Number of text rows
|
|
* @cols: Number of text columns
|
|
* @x_charsize: Character width in pixels
|
|
* @y_charsize: Character height in pixels
|
|
* @tab_width_frac: Tab width in fractional units
|
|
* @xsize_frac: Width of the display in fractional units
|
|
* @xstart_frac: Left margin for the text console in fractional units
|
|
* @last_ch: Last character written to the text console on this line
|
|
* @escape: TRUE if currently accumulating an ANSI escape sequence
|
|
* @escape_len: Length of accumulated escape sequence so far
|
|
* @escape_buf: Buffer to accumulate escape sequence
|
|
*/
|
|
struct vidconsole_priv {
|
|
struct stdio_dev sdev;
|
|
int xcur_frac;
|
|
int ycur;
|
|
int rows;
|
|
int cols;
|
|
int x_charsize;
|
|
int y_charsize;
|
|
int tab_width_frac;
|
|
int xsize_frac;
|
|
int xstart_frac;
|
|
int last_ch;
|
|
/*
|
|
* ANSI escape sequences are accumulated character by character,
|
|
* starting after the ESC char (0x1b) until the entire sequence
|
|
* is consumed at which point it is acted upon.
|
|
*/
|
|
int escape;
|
|
int escape_len;
|
|
char escape_buf[32];
|
|
};
|
|
|
|
/**
|
|
* struct vidconsole_ops - Video console operations
|
|
*
|
|
* These operations work on either an absolute console position (measured
|
|
* in pixels) or a text row number (measured in rows, where each row consists
|
|
* of an entire line of text - typically 16 pixels).
|
|
*/
|
|
struct vidconsole_ops {
|
|
/**
|
|
* putc_xy() - write a single character to a position
|
|
*
|
|
* @dev: Device to write to
|
|
* @x_frac: Fractional pixel X position (0=left-most pixel) which
|
|
* is the X position multipled by VID_FRAC_DIV.
|
|
* @y: Pixel Y position (0=top-most pixel)
|
|
* @ch: Character to write
|
|
* @return number of fractional pixels that the cursor should move,
|
|
* if all is OK, -EAGAIN if we ran out of space on this line, other -ve
|
|
* on error
|
|
*/
|
|
int (*putc_xy)(struct udevice *dev, uint x_frac, uint y, char ch);
|
|
|
|
/**
|
|
* move_rows() - Move text rows from one place to another
|
|
*
|
|
* @dev: Device to adjust
|
|
* @rowdst: Destination text row (0=top)
|
|
* @rowsrc: Source start text row
|
|
* @count: Number of text rows to move
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int (*move_rows)(struct udevice *dev, uint rowdst, uint rowsrc,
|
|
uint count);
|
|
|
|
/**
|
|
* set_row() - Set the colour of a text row
|
|
*
|
|
* Every pixel contained within the text row is adjusted
|
|
*
|
|
* @dev: Device to adjust
|
|
* @row: Text row to adjust (0=top)
|
|
* @clr: Raw colour (pixel value) to write to each pixel
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int (*set_row)(struct udevice *dev, uint row, int clr);
|
|
|
|
/**
|
|
* entry_start() - Indicate that text entry is starting afresh
|
|
*
|
|
* Consoles which use proportional fonts need to track the position of
|
|
* each character output so that backspace will return to the correct
|
|
* place. This method signals to the console driver that a new entry
|
|
* line is being start (e.g. the user pressed return to start a new
|
|
* command). The driver can use this signal to empty its list of
|
|
* positions.
|
|
*/
|
|
int (*entry_start)(struct udevice *dev);
|
|
|
|
/**
|
|
* backspace() - Handle erasing the last character
|
|
*
|
|
* With proportional fonts the vidconsole uclass cannot itself erase
|
|
* the previous character. This optional method will be called when
|
|
* a backspace is needed. The driver should erase the previous
|
|
* character and update the cursor position (xcur_frac, ycur) to the
|
|
* start of the previous character.
|
|
*
|
|
* If not implement, default behaviour will work for fixed-width
|
|
* characters.
|
|
*/
|
|
int (*backspace)(struct udevice *dev);
|
|
};
|
|
|
|
/* Get a pointer to the driver operations for a video console device */
|
|
#define vidconsole_get_ops(dev) ((struct vidconsole_ops *)(dev)->driver->ops)
|
|
|
|
/**
|
|
* vidconsole_putc_xy() - write a single character to a position
|
|
*
|
|
* @dev: Device to write to
|
|
* @x_frac: Fractional pixel X position (0=left-most pixel) which
|
|
* is the X position multipled by VID_FRAC_DIV.
|
|
* @y: Pixel Y position (0=top-most pixel)
|
|
* @ch: Character to write
|
|
* @return number of fractional pixels that the cursor should move,
|
|
* if all is OK, -EAGAIN if we ran out of space on this line, other -ve
|
|
* on error
|
|
*/
|
|
int vidconsole_putc_xy(struct udevice *dev, uint x, uint y, char ch);
|
|
|
|
/**
|
|
* vidconsole_move_rows() - Move text rows from one place to another
|
|
*
|
|
* @dev: Device to adjust
|
|
* @rowdst: Destination text row (0=top)
|
|
* @rowsrc: Source start text row
|
|
* @count: Number of text rows to move
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int vidconsole_move_rows(struct udevice *dev, uint rowdst, uint rowsrc,
|
|
uint count);
|
|
|
|
/**
|
|
* vidconsole_set_row() - Set the colour of a text row
|
|
*
|
|
* Every pixel contained within the text row is adjusted
|
|
*
|
|
* @dev: Device to adjust
|
|
* @row: Text row to adjust (0=top)
|
|
* @clr: Raw colour (pixel value) to write to each pixel
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int vidconsole_set_row(struct udevice *dev, uint row, int clr);
|
|
|
|
/**
|
|
* vidconsole_put_char() - Output a character to the current console position
|
|
*
|
|
* Outputs a character to the console and advances the cursor. This function
|
|
* handles wrapping to new lines and scrolling the console. Special
|
|
* characters are handled also: \n, \r, \b and \t.
|
|
*
|
|
* The device always starts with the cursor at position 0,0 (top left). It
|
|
* can be adjusted manually using vidconsole_position_cursor().
|
|
*
|
|
* @dev: Device to adjust
|
|
* @ch: Character to write
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int vidconsole_put_char(struct udevice *dev, char ch);
|
|
|
|
/**
|
|
* vidconsole_position_cursor() - Move the text cursor
|
|
*
|
|
* @dev: Device to adjust
|
|
* @col: New cursor text column
|
|
* @row: New cursor text row
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
void vidconsole_position_cursor(struct udevice *dev, unsigned col,
|
|
unsigned row);
|
|
|
|
#ifdef CONFIG_DM_VIDEO
|
|
|
|
/**
|
|
* vid_console_color() - convert a color code to a pixel's internal
|
|
* representation
|
|
*
|
|
* The caller has to guarantee that the color index is less than
|
|
* VID_COLOR_COUNT.
|
|
*
|
|
* @priv private data of the console device
|
|
* @idx color index
|
|
* @return color value
|
|
*/
|
|
u32 vid_console_color(struct video_priv *priv, unsigned int idx);
|
|
|
|
#endif
|
|
|
|
#endif
|