View source

This page provides a description of [[MicroWindows]] and instructions on how to build it and use it in your application.

<?plugin CreateToc jshide||=1 with_toclink||=1 ?>

==Description==

[http://www.nanogui.org/ Nano-X ] is an Open Source project aimed at bringing the features of modern graphical windowing environments to smaller devices and platforms.  The Win32/WinCE API implementation is known as Microwindows, and the Xlib-like API implementation is known as Nano-X.  (The project was renamed from MicroWindows to Nano-X in 2005 to avoid any trademark disputes with Microsoft's Windows.)

The [[TCB-2]], [[Fonix7000]] and [[AMV_Technic_I|AMV TECHNIC I]] are three examples of RTEMS-based products also using Microwindows and Nano-X.

[[http://www.nanogui.org/images/Nano-X-PopupKbd.gif]]

The list of [[Open_Projects#Nano-X_.28formerly_MicroWindows.29 | Open Projects]] contains additional resources for Nano-X on RTEMS.

==Building [[MicroWindows]]==

Checkout latest sources from MicroWindows/Nano-X repository
 cvs -z9 -d:pserver:anoncvs@cvs.microwindows.org:/usr/cvs co microwin

Configure for RTEMS
 cd src
 cp Configs/config.rtems config

Select tool-chain and directories for desired RTEMS target system in config file.
There is example of changes used for [[csb336|ARM CSB336 BSP]]
 RTEMSTOOLSPREFIX         = arm-rtems4.9-
 GRAYPALETTE              = Y
 FBVGA                    = N
 HAVETEXTMODE             = N
 NOMOUSE                  = Y
 RTEMS_BUILD              = /opt/rtems4.9
 RTEMS_BSP                = csb336
 RTEMS_TARGET             = arm-rtems4.9

Then regular make clean and make all can be used to build libraries.

Unfortunately, MicroWindows/Nano-X CVS has not been updated for long time and we have not luck
with attempt to integrate our changes and fixes back to mainline yet. The patches used
[[AMV_Technic_I|AMV TECHNIC I]] build, correcting native build under X for 64-bit Linux systems
and cleaning some 16-bit integer incompatibilities for H8S targets can be found in next archive

 [http://cmp.felk.cvut.cz/~pisa/rtems/microwin-081202-patches.tar.gz http://cmp.felk.cvut.cz/~pisa/rtems/microwin-081202-patches.tar.gz]

The patch series includes even implementation of minimal screen driver (mwin-driver-mx1sl.patch) for
frame-buffer accessible directly at fixed address in application memory map.

==Using [[MicroWindows]] in an Application==

TBD - include configuration details and hints on where to start