Skip to content

graphics/microwindows: add Nano-X client/server support and examples for NuttX - #3689

Draft
Acfboy wants to merge 4 commits into
apache:masterfrom
Acfboy:add-microwindows
Draft

graphics/microwindows: add Nano-X client/server support and examples for NuttX#3689
Acfboy wants to merge 4 commits into
apache:masterfrom
Acfboy:add-microwindows

Conversation

@Acfboy

@Acfboy Acfboy commented Aug 1, 2026

Copy link
Copy Markdown
Contributor

Summary

This PR ports the Nano-X windowing system from Microwindows to NuttX so that X11-style client/server applications can run in a flat build. It contains three logical parts:

  1. graphics/microwindows: build the Nano-X client library and server from the bundled Microwindows tree, with two new Kconfig options:
    • MICROWINDOWS_NANOX: build the Nano-X client library and server.
    • MICROWINDOWS_NANOX_NANOWM: optionally link the Microwindows window manager into the server so the server task draws and decorates windows itself.
  2. examples/nanoxcalc: port of the nxcalc demo. It connects to the running Nano-X server and shows a calculator keypad.
  3. examples/nanoxterm: port of the nxterm demo. It is a terminal emulator that opens a pseudo terminal, forks, and runs an NSH instance (nsh_consolemain) in the child instead of exec'ing /bin/sh, since flat builds have no filesystem binaries. It starts the Nano-X server as a separate task before connecting, so it can be used as the init entry point: booting sim:nanox opens the nxterm window directly, and typing nanoxcalc in it opens the calculator.

Note

There are still some remaining issues, for example, have some problem when running on qemu, so this is just a draft PR. When it is fully ready, I will add the documentation and open it up for review.

Acfboy added 4 commits July 30, 2026 00:04
Without this Make variable, Objects.rules does not add font_fnt.o
to the build, causing undefined reference to fnt_createfont at link time.

Signed-off-by: Acfboy <AcfboyU@outlook.com>
…support for NuttX

Build the Nano-X client library, server and (optional) built-in window manager
from the bundled Microwindows tree

Signed-off-by: Acfboy <AcfboyU@outlook.com>
* Port the nxcalc demo from Microwindows
* Connects to the Nano-X server started by examples/nanoxterm
* Requires CONFIG_LIBC_FLOATINGPOINT for the result formatting

Signed-off-by: Acfboy <AcfboyU@outlook.com>
* Port the nxterm demo from Microwindows
* Starts the Nano-X server as a separate task before connecting
* Runs an NSH shell instance on a pseudo terminal in the forked child
  instead of exec /bin/sh (no filesystem binaries in flat builds)

Signed-off-by: Acfboy <AcfboyU@outlook.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant