QP and Win32 - Quantum Leaps

More documents

Recommendations

Info

Table of Contents1 Introduction ..................................................................................................................................................... 11.1 About QP ............................................................................................................................................. 21.2 About QM ............................................................................................................................................. 21.3 Key Features of this QP on Windows ...................................................................................................... 31.4 About the Tools ........................................................................................................................................ 41.5 Licensing the QP .................................................................................................................................. 41.6 Licensing QM ....................................................................................................................................... 42 Getting Started ................................................................................................................................................ 52.1 Installing QP ............................................................................................................................................ 52.2 Building the QP Libraries ......................................................................................................................... 72.2.1 Building QP libraries with Visual Studio Express ............................................................................ 72.2.2 Building QP libraries with MinGW ................................................................................................... 82.3 Building the Examples ............................................................................................................................. 82.4 Running the DPP-GUI Example ............................................................................................................... 92.5 Running the “Fly 'n' Shoot” Game Simulation .......................................................................................... 92.6 Generating the QP Application Code with the QM Modeling Tool ........................................................103 The QP Port to Win32 ..................................................................................................................................... 123.1 The qep_port.h Header File ..................................................................................................................... 123.1.1 The Fixed-Width Integer Types ...................................................................................................... 123.2 The qf_port.h Header File ........................................................................................................................ 133.3 The qf_port.c Source File ........................................................................................................................ 153.4 The win32_gui.h Header File ................................................................................................................... 193.5 The win32_gui.c Source File ................................................................................................................... 214 Console Applications ..................................................................................................................................... 234.1 Board Support Package (BSP) ................................................................................................................ 235 GUI Applications ............................................................................................................................................. 255.1 General Structure of the QP Application with GUI ................................................................................... 255.2 Main Steps for Creating QP Applications with GUI .................................................................................. 255.3 WinMain() ................................................................................................................................................ 265.4 Window Procedure (WndProc) ................................................................................................................ 295.5 Developing Realistic Embedded Front Panels ......................................................................................... 345.5.1 The dialog box resource ................................................................................................................. 345.5.2 The background image ................................................................................................................... 345.5.3 Owner-drawn buttons ..................................................................................................................... 355.5.4 Graphic displays ............................................................................................................................. 375.5.5 Segment displays ........................................................................................................................... 385.5.6 LEDs .............................................................................................................................................. 406 Related Documents and References ............................................................................................................. 417 Contact Information ........................................................................................................................................ 42Legal DisclaimersInformation in this document is believed to be accurate and reliable. However, Quantum Leaps does not give anyrepresentations or warranties, expressed or implied, as to the accuracy or completeness of such information and shallhave no liability for the consequences of use of such information.Quantum Leaps reserves the right to make changes to information published in this document, including without limitationspecifications and product descriptions, at any time and without notice. This document supersedes and replaces allinformation supplied prior to the publication hereof.All designated trademarks are the property of their respective owners.Copyright © Quantum Leaps, LLC. All Rights Reserved.i
1 IntroductionThis Application Note describes how to use QP state machine frameworks version 5.x.x or higher withthe Microsoft Windows operating system including desktop Windows (e.g., Windows 7) as well asembedded Windows (Windows CE). This document covers console-style applications (without the GUI),as well as Windows GUI applications built with the raw Win32 API.Integrating QP with the Win32 GUI API is interesting for at least two reasons. First, you might use QP tobuild highly modular, well structured, multithreaded Windows applications based on the concept of activeobjects (a.k.a. Actors) and hierarchical state machines. In this use case, QP complements Windows byproviding the high-level structure, while Windows API renders the GUI and provides various services.Also, the QP port to Windows enables developers to build efficient, multithreaded Windows applicationsat a much higher level than Win32 threads and without fiddling directly with the troublesome low-levelmechanisms such as Win32 critical sections, Win32 event objects, and so on.The second compelling reason for using QP on Windows is rapid prototyping (virtual prototyping),simulation, and testing of deeply embedded software on the desktop, including building realistic userinterfaces consisting of buttons, LEDs, and LCD displays (both segmented and graphic). Movingembedded software development from an embedded target to the desktop eliminates the target systembottleneck and dramatically shortens the development time while improving the quality of the software.The Windows-based desktop systems often make excellent platforms to develop, test, and debugembedded applications. This Application Note has been specifically designed to provide a completetoolkit with all the needed graphical components tested with the powerful free tools (such as the freeVisual C++ Express Edition and the free ResEdit resource editor).All these options get especially attractive if you consider using the QM modeling tool for designing QPapplications graphically and generating code automatically.NOTE: This Application Note pertains both to C and C++ versions of the QP state machineframeworks. Most of the code listings in this document refer to the C version. Occasionally the Ccode is followed by the equivalent C++ implementation to show the C++ differences whenever suchdifferences become important.Copyright © Quantum Leaps, LLC. All Rights Reserved.1 of 42
Page 4 and 5: Application Note:QP/QM and Win32 (W
Page 44: Application Note:QP/QM and Win32 (W

QP and Win32 - Quantum Leaps

Create successful ePaper yourself

Delete template?

Save as template?