QWin GUI Prototyping Toolkit

QWin GUI Prototyping Toolkit

When developing embedded code for devices with non-trivial user interfaces, it often pays off to build a prototype (virtual prototype) of the embedded system on a PC. The strategy is called "dual targeting" because you develop software on one machine (e.g., Windows PC) and run it on a deeply embedded target, as well as on the PC. Dual targeting is the primary strategy for avoiding the "target system bottleneck" in agile embedded software development.

Note

Please note that dual targeting does not mean that the embedded device has anything to do with the PC or Windows. Neither does it mean that the simulation must be cycle-exact with the embedded target CPU. Instead, dual targeting means that from day one, your embedded code (typically in C or C++) is designed to run on at least two platforms: the final target hardware and your PC. All you really need for this is two C/C++ compilers: one for the PC and another for the embedded device.

QWin GUI Prototyping Toolkit

QWin is a free GUI toolkit for prototyping embedded systems on Windows in the C or C++ programming language, including building realistic embedded front panels consisting of LCDs (both graphic and segmented), LEDs, buttons, knobs, sliders, etc. The implementation is based on the raw Win32 API to provide simple direct mapping to C/C++ for easy integration with your embedded code.

Example of a QWIN Prototype with graphic LCD, buttons, LEDs, and segmented display

Remarks

The problem of building GUI prototypes of embedded devices on the desktop is widespread, yet it seems that most developers try to use C#, .NET, Visual Basic, or other such environments to build prototypes of their embedded devices. The main shortcoming of all such solutions is that they don't provide direct binding to C/C++, which complicates the build process and the debugging of the C/C++ code on the host.

QWin Usage

QWin is included in the QTools Collection in the sub-directory qtools/qwin/ and consists of just two files: qwin_gui.h containing the interface and qwin_gui.c providing the implementation. You use QWin by including these files in your projects.

Note

QWin is also already included in the QP/C, QP/C++, and QP-nano frameworks (in the <qp>\ports\win32 and <qp>\ports\win32-qv directories), so if you use any of these frameworks, you don't need to include QWin from the QTools Collection.

QWin Features

Currently, QWin provides the following facilities:

• Graphic displays (pixel-addressable) such as graphical LCDs, OLEDs, etc., with up to 24-bit color.
• Segmented displays such as segment LCDs, and segment LEDs with generic custom bitmaps for the segments.
• Owner-drawn buttons with custom "depressed" and "released" bitmaps, capable of generating separate events when depressed and when released. Additionally, the provided code shows how to handle input sources:
• Keyboard events.
• Mouse move events and mouse-wheel events.

QWin Documentation

The QWin GUI Prototyping Toolkit is described in the Application Note: Application Note: QWIN GUI Kit for Prototyping Embedded Systems on Windows↑.

Application Note: QWIN GUI Kit for Prototyping Embedded Systems on Windows

Regarding the size and complexity of the "QWin GUI Toolkit", the implementation of the aforementioned GUI elements takes only about 250 lines of C. The example with all sources of input and a lot of comments amounts to some 300 lines of C. The toolkit has been tested with the free MinGW compiler (included in the QTools Collection for Windows), the free Visual C++↑.

Customizing & Extending QViewQCalc Programmer's Calculator