Add a new 'video' command with 'setcursor' and 'puts' subcommands that provide an alternative interface to the existing setcurs and lcdputs commands. Update the test is updated to test both the legacy commands and the new 'video' command. Series-changes: 2 - Correct confusing output text which should be 16 instead of 10 - Improve docs for row and col Co-developed-by: Claude <noreply@anthropic.com> Signed-off-by: Simon Glass <sjg@chromium.org>
58 lines
1.0 KiB
ReStructuredText
58 lines
1.0 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0-or-later
|
|
|
|
.. index::
|
|
single: setcurs (command)
|
|
|
|
setcurs command
|
|
===============
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
::
|
|
|
|
setcurs <col> <row>
|
|
|
|
Description
|
|
-----------
|
|
|
|
The setcurs command sets the cursor position on the video console.
|
|
|
|
col
|
|
Column position in hex, with 0 being the left side. Note that this is the
|
|
text-column position, so the number of pixels per position depends on the
|
|
font size.
|
|
|
|
row
|
|
Row position in hex, with 0 being the top edge. Note that this is the
|
|
text-row position, so the number of pixels per position depends on the
|
|
font size.
|
|
|
|
|
|
Examples
|
|
--------
|
|
|
|
Set cursor to column 0x10, row 5::
|
|
|
|
=> setcurs 10 5
|
|
|
|
Move cursor to top left::
|
|
|
|
=> setcurs 0 0
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
The setcurs command is available if CONFIG_CMD_VIDEO=y.
|
|
|
|
See also
|
|
--------
|
|
|
|
* :doc:`video` - video command with subcommands
|
|
* :doc:`lcdputs` - print string on video framebuffer
|
|
|
|
Return value
|
|
------------
|
|
|
|
The return value $? is 0 (true) on success, 1 (false) on failure.
|