nuttx-apps/examples/nxterm/Kconfig
raiden00pl e3dc165ccc examples/nxterm: add serial console fallback
Prevent framebuffer startup failures from leaving the system without NSH.

Signed-off-by: raiden00pl <raiden00@railab.me>
Assisted-by: Claude Code
2026-08-22 17:09:58 -03:00

120 lines
2.9 KiB
Text

#
# For a description of the syntax of this configuration file,
# see the file kconfig-language.txt in the NuttX tools repository.
#
config EXAMPLES_NXTERM
tristate "NxTerm example"
default n
depends on NXTERM
select BOARDCTL
---help---
Enable the NxTerm example
if EXAMPLES_NXTERM
config EXAMPLES_NXTERM_PROGNAME
string "Program name"
default "nxterm"
---help---
This is the name of the program that will be used when the NSH ELF
program is installed.
config EXAMPLES_NXTERM_PRIORITY
int "NxTerm task priority"
default 100
config EXAMPLES_NXTERM_STACKSIZE
int "NxTerm stack size"
default DEFAULT_TASK_STACKSIZE
config EXAMPLES_NXTERM_LISTENERPRIO
int "Listener priority"
default 100
config EXAMPLES_NXTERM_CLIENTPRIO
int "Client priority"
default 100
config EXAMPLES_NXTERM_SERVERPRIO
int "Server priority"
default 120
config EXAMPLES_NXTERM_BPP
int "Pixel width"
default 16
range 1 32
---help---
The only valid selections are 1, 2, 4, 8, 16, and 32. The
corresponding NX disable selection (e.g., CONFIG_NX_DISABLE_16BPP),
must not be set.
config EXAMPLES_NXTERM_BGCOLOR
hex "Background color"
default 0x2211
config EXAMPLES_NXTERM_WCOLOR
hex "Window color"
default 0xcf1f
config EXAMPLES_NXTERM_FULLSCREEN
bool "Full-screen window"
default n
---help---
Size the NXTerm window to cover the complete display instead of
centering it at three quarters of the display size.
config EXAMPLES_NXTERM_PTYCONSOLE
bool "PTY-backed keyboard console"
default n
depends on PSEUDOTERM && INPUT_KEYBOARD
depends on !INPUT_KEYBOARD_BYTESTREAM
depends on !NSH_ALTCONDEV && !NSH_USBKBD
---help---
Route NSH through a pseudo-terminal and bridge an event-mode keyboard
to the terminal master. This gives NXTerm a real TTY, translates
NuttX keyboard special-key codes to VT100 input, and permits terminal
generated signals such as Ctrl-C and Ctrl-Z.
config EXAMPLES_NXTERM_NSH_FALLBACK
bool "Fall back to serial NSH"
default n
depends on NSH_CONSOLE
---help---
Run NSH on the original system console if NX or NXTerm initialization
fails. This is useful on framebuffer systems where display startup
failures would otherwise leave no interactive console.
config EXAMPLES_NXTERM_STARTUP_TIMEOUT
int "NX startup timeout"
default 5
range 1 60
depends on EXAMPLES_NXTERM_NSH_FALLBACK
---help---
Number of seconds to wait for the NX server to accept the client
connection before falling back to NSH on the system console.
config EXAMPLES_NXTERM_KBDDEV
string "Keyboard device"
default "/dev/kbda"
depends on EXAMPLES_NXTERM_PTYCONSOLE
---help---
Path of the keyboard event device bridged to the pseudo-terminal.
config EXAMPLES_NXTERM_TOOLBAR_HEIGHT
int "Toolbar height"
default 16
config EXAMPLES_NXTERM_TBCOLOR
hex "Toolbar color"
default 0xbdf7
config EXAMPLES_NXTERM_FONTID
int "Font ID"
default 16
config EXAMPLES_NXTERM_FONTCOLOR
hex "Font color"
default 0x0000
endif