QP/C++ Revision History

Version 4.0.02 (Product) Release date: Nov 15, 2008

This maintenance release does not change the QP/C API in any way, so the release has NO IMPACT on the QP/C++ applications.

The main changes in QP v4.0.02 with respect to earlier version are as follows:

• in qep.h file, added comments to macros Q_TRAN() and Q_SUPER() to suppress the PC-lint warining about using the comma-operator (MISRA rule 42).
• in qhsm_in.cpp file, fixed a bug in the QHsm::isIn() function. - fixed a bug in tunnel.cpp file ("Fly 'n' Shoot" game). The constant event HIT_WALL was not declared static.

Version 4.0.01 (Product) Release date: June 09, 2008

This maintenace release is made to allow using QS software tracing with the GNU compiler for AVR (WinAVR). Specifically, the output of the strings residing in ROM has been fixed.

This maintenance release does not change the QP/C++ API in any way, so the release has NO IMPACT on the QP/C++ applications.

The main changes in QP v4.0.01 with respect to earlier version are as follows:

• in qs_.cpp file, updated the function QS::str_ROM_().
• in qs_str.cpp file, updated the function QS::str_ROM().
• in qvanilla.cpp file, funciton QF::run(), declared the temporary variables as static to save stack space, because QF::run() never returns and is not reentrant.

Version 4.0.00 (Product) Release date: Apr 07, 2008

This milestone release is made for the book Practical UML Statecharts in C/C++, Second Edition. The book describes in great detail this new release. The older "QP Programmer's Manual" is now phased out and is replaced with this hyper-linked QP/C++ Reference Manual, which provides very detailed, easily searchable reference to the software. The book Practical UML Statecharts in C/C++, Second Edition provies in-depth discussion of the relevant concepts as well as the design study of QP v4.0.

The main changes in QP v4.0 with respect to earlier versions are as follows:

• the coding techniques for hierarchical state machines (HSMs) and the simpler finite state machines (FSMs) have changed. While the changes are quite simple, the backward compatibility with QEP 3.x has been broken, meaning that some manual changes to the state machines implemented with earlier versions are necessary. Please refer to the "QP/C++ Tutorial" Section 7. Coding Hierarchical State Machines for more information about coding state machines with QEP 4.x.
  • The main change is the signature of a state-handler function, which now returns simply a byte. This return type (typedef'ed as QState) is the status of the event-handling that the state handler conveys to the QEP event processor.
  • The macro Q_TRAN() must now always follow the return statement.
  • The new macro Q_SUPER() designates the superstate of the given state. Again, this macro must follow the return statement.
  • Then two new macros Q_HANDLED() and Q_IGNORED() have been added to return the status of event handled and event ignored, respectively.

• all callback functions are now consistently called XXX_onYYY() or XXX::onYYY():
  • Q_assert_handler() is now Q_onAssert()
  • QF::start() is now QF::onStartup()
  • QF::cleanup() is now QF::onCleanup()

• the new header file qevent.h has been broken off the qep.h header file. qevent.h contains the QEvent class and other basic facilities used in the whole QP. This new file allows easier replacement of the entire QEP event processor with custom event processors, if you wish do so.
• the macro QEP_SIGNAL_SIZE is renamed to Q_SIGNAL_SIZE.
• the data type QSTATE is now deprecated. Please use QState.
• the QF_FSM_ACTIVE macro is now deprecated. Instead, please define QF_ACTIVE_SUPER_ to the base class of QActive and QF_ACTIVE_STATE_ to the data type represented state. By default, these macros are defined to use the QHsm base class from the QEP hierarchical event processor, but you can replace the event processor, if you wish.
• the internal macro QACTIVE_OSOBJECT_WAIT_() is now QACTIVE_EQUEUE_WAIT_().
• the internal macro QACTIVE_OSOBJECT_SIGNAL_() is now QACTIVE_EQUEUE_SIGNAL_().
• the internal macro QACTIVE_OSOBJECT_ONIDLE_() is now QACTIVE_EQUEUE_ONEMPTY_().
• the data mebers QActive::m_osObject and QActive::m_thread are now present only if the macros QF_OS_OBJECT_TYPE and QF_THREAD_TYPE are defined.
• the QPSet class has been renamed to QPSet64.
• the QPSet::hasElements() has been renamed QPSet64::notEmpty()
• the QS software tracing is now better integrated with all QP components. You no longer need to explicitly include qs_port.h, because it is automatically included when you define the macro Q_SPY. Also the file qs_dummy.h is included automatically when the macro Q_SPY is not defined.
• the new header file qvanilla.h now replaces the file qsched.h.
• the macros QF_SCHED_LOCK() and QF_SCHED_UNLOCK() are now obsolete.
• the native QF event queues (both the active object event queues and the "raw" thread-safe queues) are slightly more efficient by counting down the head and tail pointers rather than up. This leads to wrap-around at zero, which is easier (faster) to test than any other wrap-around point. Also the native QF event queues maintain the minimum of the free events in the queue rather the maximum of used events.
• the data member of QEQueue::nTot class is removed.
• the QF::publish() function has been re-written so that QF no does not need to lock the scheduler. The QF::publish() function posts events to active objects with scheduler unlocked starting from the highest-priority active objects. However, the event is protected from inadvertent recycling by incrementing its reference counter before the publish operation. After the event is posted to all subscribers, the garbage collector QF::gc() is called to decrement the reference counter and recycle the event, if necessary.
• the qf_run.cpp file is obsolete. The QF::run() function for the cooperative "vanilla" kernel is now implemented in the file qvanilla.cpp.
• the QF::tick() function has been rewritten to allow calling QF::tick() from the task context as well as from the interrupt context. The nested critical section around QF::tick() is no longer needed when it is called from the task level. Among others, this re-design eliminates the need for the recursive mutex in the POSIX QF port.
• the QMPool::init() function has been re-designed to optimally align the memory buffer in a portable and platform-independent way. This should bring some performance improvements on some CPUs (e.g., 80x86).
• the extended QK scheduler has been re-designed to save stack space. The extended context (e.g., coprocessor registers) are no longer saved on the precious stack, but rather in the active object.
• a bug has been fixed in handling of Thread-Local Storage (TLS) in the QK scheduler and extended scheduler.

• the -q (quiet) flag has been added to the QSPY host application.
• the support for two new compilers for Windows has been added for the QSPY host application. The application can now be build with the MinGW GNU compiler for Windows as well as the Microsoft Visual C++ 2005.

• the QP port to Linux has been improved by eliminating the need for recursive P-Thread mutex.

• the QP port to MicroC/OS-II has been upgraded to the latest version 2.86.

• all examples in the standard QP distribution have been cleaned up and updated to the latest QP API changes.
• all examples that use QF now contain the QS software tracing support.

Version 3.4.01 (Product)

Release date: Sep 25, 2007

This product release adds the backward-compatibility layer so that previous QP/C++ ports continue to work with the new version.

This product release also comes with the updated "QP Programmer's Manual", which now includes the QS target component and the QSpy host application.

Version 3.4.00 (Beta)

Release date: Sep 03, 2007

This release brings several changes with the overall goal of simplifying and improving consistency across the whole QP family of frameworks (QP/C, QP/C++, and QP-nano).

The main changes are made to the QEP component. The "static transition optimization" has been removed altogether. This simplifies significantly the state machine structure (which now contains just the currently active state). Also, the efficiency is improved for processing the dynamic transitions and the stack usage is lower. This change brings the QEP/C++ implementation much closer to QEP-nano.

The other big change in this release is including the Quantum Spy (QS) component in the distribution. Previously, the QS component was available only under the commercial licensing. It is now open source, just as the rest of QP.

In, the QF/C++ component, the QTimerEvt::publishIn() and QTimeEvt::publishEvery() have been removed, because they introduced a coupling between time events and publish-subscribe. This is undesirable for projects that do not want to include the publish-subscribe facilty.

Finally, the revision history for individual QP/C++ components has been moved from the header files and is now consolidated in the header file doxygen/qpcpp_rev.h.

The updated "QP Programmer's Manual" is in the works...

Version 3.3.00 (Product)

Release date: Jan 23, 2007

The main change in this release is removing include <stdint.h> from the qep.h header file. This has been done becasue vast majority of embedded compilers for small MCUs actually do not provide the C-99 Standard header file <stdint.h>. Worse, compilers such as Freescale HC(S)08 C/C++ compiler will not include <stdint.h> unless it's in the compilers's include directory, even though the "stdint.h" file might be in the compiler include path.

Removing the "#include <stdint.h>" from qep.h header file allows more flexibility in the way the standard exact-width integer types are defined. For compilers that do not provide the <stdint.h> file, you provide the typedef's in the qep_port.h file before including qep.h. For compilers that do provide the <stdint.h> header file, you simply include this file in the qep_port.h header file before including qep.h.

The changes in release 3.3.00 have impact on all QP ports, because you need to modify the qep_port.h file in all these ports.

The other significant change in this release is adding the macro Q_ROM_VAR for all constant objects allocated in ROM. The Q_ROM_VAR macro has been added for the compilers like Freescale HC(S)08, which require far pointers to access the objects in ROM. Please note that specifying the pointer size for accessing a ROM objects is syntactically different than specifying that the object is allocated in ROM (see macro Q_ROM).

QS is now better integrated with the rest of QP. This is achieved by using the QP macros Q_ROM, Q_ROM_VAR, QF_INT_KEY_TYPE, QF_INT_LOCK, and QF_INT_UNLOCK. By simply including the header file "qf_port.h" before "qs.h" in the "qs_port.h" include, you no longer need to manually ensure that QS implements the same policies as the rest of QP. This change still allows using QS standalone (without any other QP components), but then the QP macros must be explicitly defined in the qs_port.h header file. Also the macro QS_ROM_VAR has been added for all constant objects allocated in ROM (see also macro Q_ROM_VAR added to QEP). The QS_ROM_VAR macro has been added for the compilers like Freescale HC(S)08, which require far pointers to access the objects in ROM. Please note that specifying the pointer size for accessing a ROM objects is syntactically different than specifying that the object is allocated in ROM (see macro Q_ROM).

Finally, in release 3.3.00 the build strategy for QP ports has been simplified as well. Instead of separate Makefile for every QP component, such as QEP, QF, QK, and QS, not the "ports" directory contains a batch file "make.bat" that builds all the libraries at once.

1. in file qep.h removed "#include <stdint.h>".
2. in file qassert.h added macro Q_ROM_VAR for objects allocated in ROM and to signatures of functions accessing these objects.
3. in file qep.h added macro Q_ROM_VAR for objects allocated in ROM and to signatures of functions accessing these objects.
4. in file qep.h added default empty definitions and Doxygen comments for macros Q_ROM and Q_ROM_VAR.
5. in file qep.cpp added macro Q_ROM_VAR for objects allocated in ROM and to signatures of functions accessing these objects.
6. in file qf.cpp added macro Q_ROM_VAR for objects allocated in ROM and to signatures of functions accessing these objects.
7. in file qk.cpp added macro Q_ROM_VAR for objects allocated in ROM and to signatures of functions accessing these objects.
8. in file qep.cpp added Q_ROM_VAR to the signature of QEP::getVersion().
9. in file qep.cpp changed the version number to "3.3.00".
10. in file qf.h added macro Q_ROM_VAR for objects allocated in ROM and to signatures of functions accessing these objects.
11. in file qf.h removed method QF::getTime() and deleted external variable QF::tickCtr.
12. deleted obsolete file qa_fifo_.cpp
13. deleted obsolete file qa_lifo_.cpp
14. deleted obsolete file qf_time.cpp
15. in file qf_act.cpp added Q_ROM_VAR to the signature of QF::getVersion()
16. in file qf_log2.cpp added Q_ROM_VAR to the definition of the lookup.
17. in file qf_pwr2.cpp added Q_ROM_VAR to the definition of the lookups.
18. in file qf_tick.cpp removed incrementing QF::tickCtr.
19. In file qf_act.cpp updated version number to 3.3.00
20. Updated the "QP Programmer's Manaul" to Revision E
21. in file qk.h added macro Q_ROM_VAR for objects allocated in ROM and to signatures of functions accessing these objects.
22. In file qk.cpp added Q_ROM_VAR to the signature of QK::getVersion().
23. In file qk.cpp updated version number to 3.3.00
24. in file qs.h added macro QS_ROM_VAR for objects allocated in ROM and to signatures of functions accessing these objects.
25. In file qs.h added default definitions of the QS macros Q_ROM, Q_ROM_VAR, and Q_ROM_BYTE.
26. In file qs.h added declaration of QS_tickCtr_.
27. In file qs.cpp added Q_ROM_VAR to the signature of QS::getVersion().
28. In file qs_.cpp added Q_ROM_VAR to the signature of QS::str_ROM_().
29. In file qs_.cpp added definition of QS_tickCtr_.
30. In file qs_str.cpp added Q_ROM_VAR to the signature of QS::str_ROM().
31. In file qs.cpp updated version number to 3.3.00
32. Updated the "QP Programmer's Manaul" to Revision E

Version 3.2.05

Release date: Dec 08, 2006

This QF release rolls back the changes made to the reference-counting policy. The reference count of a dynamic event is incremented when the event is posted, but is NOT decremented when the event is retreived from the queue. The reference count is decremented only later, in the garbage collector (QF::gc()).

This release adds direct support for event deferral (the "Deferred Event" state pattern) through methods QActive::defer() and QActive::recall().

1. In file qf.h added methods QActive::defer() and QActive::recall().
2. In file qa_get_.cpp removed decrementing the reference count of a dynamic event.
3. In file qeq_get.cpp removed decrementing the reference count of a dynamic event.
4. In file qf_gc.cpp restored decrementing of the reference count of a dynamic event.
5. Added new file qa_defer.cpp that implements QActive::defer() and QActive::recall().
6. In file qf_act.cpp updated version number to 3.2.05
7. Updated the "QP Programmer's Manaul" to Revision D

Version 3.2.04 (Beta)

Release date: Dec 01, 2006

This QF release changes the internal policy of reference-counting for dynamic events. The reference count of a dynamic event is now incremented when the event is posted to a queue and decremented when the event is later retreived from the queue. This policy pertains to both active object queues and native QF thread-safe queues (QEQueue).

Previously, the reference count of a dynamic event was not decremented upon retreival of the event from the event queue, but rather in the garbage collector (QF::gc()).

This QK release adds two new features in QK. The first feature added is the extended context switch for CPUs with co-processors, such as the x87 FPU accompanying the x86 CPU. As a fully- preemptive kernel, QK needs to save and restore the context of the co- processor accrosss the asynchronous preemption. This QK release adds a generic mechanism for saving and restoring extened context in the extended scheduler (QK_scheduleExt_()), which is used only at the exit from the interrupts (asynchronous preemptions).

The second feature added is the Thread-Local Storage (TLS) for reentrant libraries, such as the NewLib. This feature allows assigning per-thread memory and providing a hook (callback) activated at every context switch.

1. In file qf.h eliminated methods QActive::postFIFO_() and QActive::postLIFO_().
2. In file qf.h promoted method QActive::get_() to the public scope to make it available to various thread-run routines.
3. In file qf.h promoted method QActive::unsubscribeAll() to the public scope to make it available to various thread-run routines.
4. In file qf.h promoted method QF::remove_() to the public scope to make it available to various thread-run routines.
5. In file qf.h added friendship between class QActive and QK_scheduleExt_() and QK_isrExit_().
6. In file qa_fifo.cpp changed the implementation of QActive::postFIFO() to represent the native QF event queue of an active object.
7. In file qa_fifo_.cpp removed the implementation of QActive::postFIFO_() and declared the file obsolete (will be removed in future releases).
8. In file qa_lifo.cpp changed the implementation of QActive::postLIFO() to represent the native QF event queue of an active object.
9. In file qa_lifo_.cpp removed the implementation of QActive::postLIFO_() and declared the file obsolete (will be removed in future releases).
10. In file qa_get_.cpp added decrementing the reference count of a dynamic event.
11. In file qf_gc.cpp removed decrementing of the reference count of a dynamic event. Also changed the test for recycling an event (reference count of zero).
12. In file qf_pspub.cpp removed incrementing the reference count of a dynamic event.
13. Removed all uses of the macros QACTIVE_POST_FIFO_, QACTIVE_POST_LIFO_ and QACTIVE_GET_. These macros are made now obsolete.
14. In file qsched.h removed definitions of the obsolete macros QACTIVE_POST_FIFO_, QACTIVE_POST_LIFO_, and QACTIVE_GET_.
15. In file qf_pspub.cpp replaced the macro QACTIVE_POST_FIFO_() with the direct method invocation active_[p]->postFIFO(e).
16. In file qf_tick.cpp replaced the macro QACTIVE_POST_FIFO_() with the direct method invocation active_[p]->postFIFO(e).
17. In file qa_run.cpp replaced the macro QACTIVE_POST_GET_() with the direct method invocation get_().
18. Changed the uC/OS-II port to reflect new policy of handling reference counters inside the dynamic events. Also removed files qa_fifo.cpp and qa_lifo.cpp from the uC/OS-II build.
19. In file qf_act.cpp updated version number to 3.2.04
20. In file qk.h updated revision history and added the prototype for the extended scheduler QK_scheduleExt_(). This scheduler implements the generic extended context via macros QK_EXT_TYPE, QK_EXT_SAVE, and QK_EXT_RESTORE.
21. In file qk.h removed definitions of the obsolete macros QACTIVE_POST_FIFO_, QACTIVE_POST_LIFO_, and QACTIVE_GET_.
22. In file qk_sched.cpp added logic for handling the TLS via the macro QK_TLS.
23. Added new file qk_ext.cpp with the definition of the extended scheduler QK_scheduleExt_().
24. Added the file qk_ext.cpp to the Makefile for QK port to 80x86 with Turbo C++ 1.01.
25. Extended the QK port to 80x86 with Turbo C++ 1.01 to handle the x87 FPU context.
26. Extended the QDPP example for QK with Turbo C++ 1.01 to demonstrate threads that use the FPU and require the extended context switch.
27. In file qk.cpp updated version number to 3.2.04
28. Updated the "QP Programmer's Manaul" to Revision C

Version 3.2.03 (Product)

Release date: Nov 15, 2006

The main purpose of this release is to adapt the code to the shortcomings of the gcc compiler for handling data in program ROM for Harvard architecture CPUs, such as the Atmel's AVR or the 8051. In such machines, the data space (RAM) and program space (ROM) are accessed with different instructions. The gcc compiler does not automatically synthesize the correct code for accessing data placed in the program ROM, even though __attribute__((__progmem__)) is used. The workaround for the gcc is to add special assembly instructions to transfer the data from the program space to the data space. This version of QP-nano adds macros for each data element allocated to the program space (delcared with the Q_ROM attribute) Please note that commercial compilers, such as IAR, handle data allocated in the program space (ROM) correctly and do not need any workarounds.

This release also fixes a few minor inconsistencies in the code (see the list below):

1. In file qf.h added default definition of macro Q_ROM_BYTE
2. In file qf_set.h added macro Q_ROM_BYTE to access the lookup tables allocated in ROM (several places).
3. In file qf_sched.h changed types QF_OS_OBJECT_TYPE and QF_THREAD_TYPE to uint8_t from int8_t
4. In file qs_dummy.h added dummy definitions of some missing QS macros
5. In file qa_sub.cpp added macro Q_ROM_BYTE to access the lookup tables allocated in ROM (several places).
6. In file qa_usub.cpp added macro Q_ROM_BYTE to access the lookup tables allocated in ROM (several places).
7. In file qf_usuba.cpp added macro Q_ROM_BYTE to access the lookup tables allocated in ROM (several places).
8. In file qf_pspub.cpp added macro Q_ROM_BYTE to access the lookup tables allocated in ROM (several places).
9. In file qf_tick.cpp replaced QF_tickCtr_ with QS::tickCtr_. allocated in ROM (several places).
10. In file qf_act.cpp updated version number to 3.2.03

Version 3.2.02 (Product)

Release date: Oct 30, 2006

1. In file qs.h replaced macro Q_ROM with QS_ROM
2. In file qs.h added methods QS::str_ROM_() and QS::str_ROM()
3. In file qs.h added macros QS_STR_ROM_() and QS_STR_ROM()
4. In file qs.h modified macros QS_???_DICTIONARY() to use ROM strings
5. In file qs.h included qs_dummy.h instead of the dummy definitions of the QS macros
6. In file qs_pkg.h added ifndef Q_SPY before definition of macro Q_SPY
7. In file qs_.cpp added definition of the function QS::str_ROM_()
8. In file qs_str.cpp added definition of the function QS::str_ROM()
9. In file qs.cpp updated version number to 3.2.02

Version 3.2.01 (Product)

Release date: Sep 01, 2006

1. In file qep.cpp updated version number to 3.2.01
2. Added makefiles for building ports of all QP/C++ libraries at once.
3. In file qf_act.cpp updated version number to 3.2.01
4. Added makefiles for building ports of all QP/C++ libraries at once.
5. Created the consolidated manual "QP/C++ Programmer's Manual".
6. In file qk.cpp updated version number to 3.2.01
7. Added makefiles for building ports of all QP/C++ libraries at once.
8. Created the consolidated manual "QP/C++ Programmer's Manual".
9. In file qs.cpp updated version number to 3.2.01
10. In file qs.cpp removed superfluous semicolons after QS_INSERT...()
11. In file qs_.cpp removed superfluous semicolons after QS_INSERT...()
12. In file qs_str.cpp removed superfluous semicolons after QS_INSERT...()
13. In file qs_mem.cpp removed superfluous semicolons after QS_INSERT...()
14. In file qs_f32.cpp removed superfluous semicolons after QS_INSERT...()
15. In file qs_f64.cpp removed superfluous semicolons after QS_INSERT...()
16. Added makefiles for building ports of all QP/C++ libraries at once.
17. Created the consolidated manual "QP/C++ Programmer's Manual".

Version 3.2.00 (Product)

Release date: Aug 07, 2006

1. In file qep.h added the default definition of Q_ROM in case it's not defined by the user.
2. In file qassert.h added the macro Q_ROM to allocate constant strings to ROM.
3. In file qep.cpp updated version number to 3.2.00 # Updated the "QEP/C++ Programmer's Manual".
4. In file qf.h added function QF_stop() to be called from the application code to stop the framework.
5. In file qf.h added callback function QF_cleanup() to be called from the QF port to cleanup before exiting to the OS.
6. In file qf.h deprecated the function QF_exit().
7. In file qf.h changed the semantics of the QF::onIdle() callback. This callback is now invoked with interrupts LOCKED from the non-preemptive scheduler used in the "vanilla" QF ports to "bare metal" target boards.
   
   The modification changes the responsibilities of QF::onIdle(), which now MUST at least unlock interrupts. A failure to unlock interrupts in QF::onIdle() will leave the interrupts locked all the time and would prevent the application from running.
   
   Also, the signature of QF::onIdle() now depends on the interrupt locking policy. In case of the "save and restore interrupt status" policy, the QF::onIdle() callback takes the interrupt lock key as parameter (to be able to unlock the interrups correctly).
8. In file qf.h used the macro Q_ROM to allocate constant objects to ROM (

   See also:

   qep.h). Objects allocated to ROM are: the version strings, and the lookup tables (QF::log2Lkup[], QF::pwr2Lkup[], QF::invPwr2Lkup[], and QF::div8Lkup[].

9. Added new platform-independent header file qsched.h to provide the interface to the simple non-preemptive scheduler used in the "vanilla" ports of QF to "bare metal" targets. This header file is only applicable to the "vanilla" ports.
10. Added new platform-independent implementation file qf_run.cpp to implement the simple non-preemptive scheduler used in the "vanilla" ports of QF to "bare metal" targets. This implementation file eliminates the need for qf_port.cpp file in the "vanilla" ports of QF. Also, the qf_run.cpp module should only be placed in the QF library in the vanilla QF ports.
11. Simplified all "vanilla" ports of QF to use the common platform- independent implementation provided in qf_run.cpp.
12. Updated QF::onIdle() callback in all examples of "vanilla" ports of QF to unlock interrupts.
13. Updated the "QF/C++ Programmer's Manual".
14. in file qk.h added new idle callback QK::onIdle(), which in contrast to QF::onIdle() is invoked with interrupts unlocked.
15. in file qk.h removed QK_schedLock()/QK_schedUnlock() and replaced them with QK_mutexLock()/QK_mutexUnlock(), with the semantics of returning the mutex.
16. in file qk.h changed the definitions of macros QF_SCHED_LOCK/ QF_SCHED_UNLOCK to use the new QK mutex API.
17. In file qk.h used the macro Q_ROM to allocate constant objects to ROM (

    See also:

    qep.h).

18. in file qk.h added the typedef for QMutex.
19. in file qk.cpp replaced the callback QF::onIdle() with the new one QK::onIdle().
20. removed source file qk_lock.cpp
21. added source file qk_mutex.cpp
22. in file qk.cpp changed the version number to 3.2.00
23. in all QK/C++ examples replaced callback QF::onIdle() with QK::onIdle()
24. Updated "QK/C++ Programmer's Manual"
25. In file qs.h replaced QS_QK_SCHED_LOCK/UNLOCK with QS_QK_MUTEX_LOCK/ QS_QK_MUTEX_UNLOCK. Also, changed data accompanying the trace records QS_QK_MUTEX_LOCK/UNLOCK.
26. In file qs.h used the macro Q_ROM to allocate constant objects to ROM (

    See also:

    qep.h).

27. in file qs.cpp changed the version number to 3.2.00
28. Updated "QS Programmer's Manual" in PDF.

Version 3.1.06 (Product)

Release date: May 11, 2006

1. In file qk_sched.cpp removed unlocking of interrupts upon exit from QK::schedule_(). Now QK_schedule_() enters and exits with interrupts LOCKED.
2. In file qk.h modified macro QACTIVE_OSOBJECT_SIGNAL_() to always unlock the interrupts, regardless if QK_schedule_() has been called or not.
3. In file qk.cpp added unlocking interrupts after the call to QK_SCHEDULE_() in the function QF::run().
4. In file qk_lock.cpp modified the function QK::schedUnlock() to always unlock the interrupts upon exit.
5. Updated licensing information.
6. Updated "QS/C++ Programmer's Manual" in PDF.

Version 3.1.03 (Product)

Release date: Feb 10, 2006

1. In file qep.cpp added the Revision History Doxygen comment, which was previously in doxygen/qp.h
2. In file qf_act.cpp added the Revision History Doxygen comment, which was previously in doxygen/qp.h
3. In file qf.h augmented comment for QF_run() to cover the case when QF is used with QK.
4. In file qf.h added the extern declarations of QF_tickCtr_, QF_intLockNest, and QF_isrNest_, which were previously declared in qf_pkg.h.
5. In file qf.h added macros QF_QS_INT_LOCK, QF_QS_INT_UNLOCK(), QF_QS_ISR_ENTRY, and QF_QS_ISR_EXIT, which were previously declared in qs_port.h.
6. In file ports/linux/gcc/qf_port.h added extern uint8_t QF_running_.
7. In file qf/80x86/dos/tcpp101/l/qf_port.cpp replaced deprecated QPSet::hasElements() to QPSet::isEmpty().
8. In file qf/80x86/linux/gcc/qf_port.cpp added QF::run()
9. In file qeq_init.cpp changed QS_OBJ(this) to QS_OBJ(qSto) to consistently refer to a queue by the ring buffer object
10. In file qf_pkg.h removed extern QF_tickCtr_.
11. In file qk.h removed extern QK_intLockNest_ and QK_isrNest_. These counters have been moved to QF and renamed in the process to QF_intLockNest_ and QF_isrNest_, respectively.
12. In file qk.h added QS instrumentatin to QF_INT_LOCK and QF_INT_UNLOCK macros for tracing interrupt locking/unlocking. The QS interrupt locking/ unlocking instrumentation has been previously added at the QK port level.
13. In file qk.h removed macros QK_QS_INT_LOCK()/ QK_QS_INT_UNLOCK(), QK_QS_ISR_ENTRY()/ QK_QS_ISR_EXIT(). These macros have been moved to QF and renamed in the process to QF_QS_INT_LOCK()/ QF_QS_INT_UNLOCK(), QF_QS_ISR_ENTRY()/ QF_QS_ISR_EXIT(), respectively.
14. In file ports/80x86/qk/tcpp101/l/qk_port.h simplified the definition of the macros QK_INT_LOCK/ QK_INT_UNLOCK to NOT contain the QS instrumenation.
15. In file ports/80x86/qk/tcpp101/l/qk_port.h changed the definitions of QK_ISR_ENTRY and QK_ISR_EXIT to use QF_QS_ISR_ENTRY/ QF_QS_ISR_EXIT.
16. In file qk.cpp added the Revision History Doxygen comment
17. In file qk_pkg.h changed the definition of internal QK macros QK_INT_LOCK_/ QK_INT_UNLOCK_ to use the QS-instrumented QF_INT_LOCK/ QF_INT_UNLOCK.
18. In file qk_lock.cpp corrected a comment
19. In file qk_sched.cpp corrected a comment
20. Provided "QS/C++ Programmer's Manual" in PDF.
21. In file qs.h changed around the pre-defined records. Added records: QS_QF_INT_LOCK, QS_QF_INT_UNLOCK, QS_QF_ISR_ENTRY, QS_QF_ISR_EXIT. Removed records QS_QK_INT_LOCK, QS_QK_INT_UNLOCK, QS_QK_ISR_ENTRY, QS_QK_ISR_EXIT.
22. In file qs.h renamed functions QS::filterIn()/ QS::filerOut() to QS::filterOn()/ QS::filerOff(). Correspondingly, changed macros QS_FILTER_IN(), QS_FILTER_OUT(), to QS_FILTER_ON(), QS_FILTER_OFF().
23. In file qs.h changed the signature and semantics of QS::getByte() to return QS_EOD (End-Of-Data).
24. In file qs.h changed the signature of QS::getBlock() to take a pointer to uint16_t rather than uint32_t.
25. In file qs.h eliminated the callback QS::newRecord()
26. In file qs.h added new callback QS::flush()
27. In file qs.h added application-level local filter object QS::apObj_. Consistently, added macro QS_FILTER_AP_OBJ() to set the new local filter. Consistently, added object argument to macros QS_BEGIN() and QS_BEGIN_NOLOCK().
28. In files qs.cpp, qs_.cpp, qs_blk.cpp, qs_byte.cpp, qs_pkg.h renamed some variables and adjusted comments.
29. Ported the QSpy host applicatoin to Linux. Added TCP/IP input to QSpy. Added new options.
30. Added redesigned QS port to Linux with TCP/IP data link.

Version 3.1.02 (Product)

Release date: Jan 29, 2006

1. Removed Quantum Spy (QS) dependency from the QCalc and QHsmTst examples
2. In file qk.h removed callbacks QK::init(), QK::start(), QK::idle(), and QK::exit(), because they duplicate the QF callbacks.
3. Modified qk.cpp to define the following QF "callbacks": QF::getPortVersion(), QF::run(), QActive::start(), and QActive::stop_().
4. Added an argument to the signature of QK::schedLock() to allow selective QK scheduler locking up to the specified priority level.
5. Changed the implementation of QK::schedLock() in file qk_lock.cpp.
6. Eliminated the need for qf_port.cpp in the QF/C++ ports for QK.
7. Simplified elements that go into qk_port.cpp in the QK/C++ ports.
8. Added the ARM-Simulator port to the standard QK/C++ distribution.
9. Cleaned-up the 80x86 QK port.
10. Provided "QK/C++ Programmer's Manual" in PDF.

Version 3.1.01 (Snapshot)

Release date: Oct 18, 2005

1. Removed Quantum Spy (QS) dependency from the examples
2. Added Doxygen documentation to the source code
3. Added running__ member to the QActive structure
4. Added QF_EVENT_SIZ_SIZE configuration macro and related data type QEventSize. Made the following changes to the signatures: void QF::poolInit(void *poolSto, uint32_t poolSize, QEventSize evtSize); QEvent *QFnew_(QEventSize evtSize, QSignal sig);
5. In file qmpool.h changed the definition of the QF_MPOOL_SIZ_SIZE macro to remove the dependency on the QF_EVENT_SIZ_SIZE. Macro QF_EVENT_SIZ_SIZE might not be defined by the time qmpool.h is included.
6. Added explicit definition of the configuration macro QF_EVENT_SIZ_SIZE to all qf_port.h files.
7. Fixed a bug in function QMPool::init() (file qmp_init.cpp) by changing the type of variable n from uint8_t to QMPoolCtr. The uint8_t data type was failing for bigger block sizes.
8. Added the QF::onIdle() callback to qf.h
9. Improved comments in qpset.h
10. Corrected dependencies in the Makefile for QDPP example (directory 80x86 and 80x86)
11. Added Linux QF port to the standard QF/C++ distribution.
12. Released the "QF/C++ Programmer's Manual"

Version 3.1.00 (Beta)

Release date: Oct 03, 2005

1. Applied new directory structure desribed in Application Note: QP Directory Structure
2. Added Quantum Spy instrumentation.
3. Removed file qfsm_tra.cpp.
4. Introduced file qfsm_dis.cpp.
5. Applied new directory structure desribed in Application Note: QP Directory Structure
6. Added Quantum Spy instrumentation.

Version 3.0.11 (Beta)

Release date: Aug 14, 2005

1. Fixed potential race condition for static transitions
2. Added assertion in QHsm::execTran() to catch potential path[] array overrun that previously could go undetected.

Version 3.0.10 (Beta)

Release date: Aug 06, 2005

This release contains completely redesigned Quantum Event Processor (QEP). The main focus is on compliance with standards (MISRA, Lint, Coding Standard), better portability, stack-use efficiency.

1. This release includes a comprehensive "QEP/C++ v3.0 Programmer's Manual" in PDF.
2. This release contains in-source comments for automatic generation of this Reference Manual with doxygen.
3. This release includes re-packaging the code into much larger numberof modules (.cpp files) with typically one function per module. This fine-granularity packaging allows for better automatic elimination of unused code at link time and fine-tuning by applying different compiler options to different files.
4. Although this is a C++ version, it has been still thoroughly checked against the Motor Industry Software Reliability Association (MISRA) "Guidelines for the Use of the C Language in Vehicle Based Software", April 1998, ISBN 0-9524156-9-0 (see also http://www.misra.org.uk). A separate Application Note "QEP/C++ MISRA Compliance Matrix" contains detailed account how QEP/C++ compiles with the 127 MISRA rules (See http://www.state-machine.com/doc/AN_QP_Cpp_MISRA.pdf).
5. This release is now "lint-free". The source code has been thoroughly checked with the latest version of PC-lint(TM) (version 8.00q) from Gimpel Software (www.gimpel.com). The PC-lint configuration files and output files are included in the distribution. A separate Application Note "QEP/C++ PC-Lint Compliance" contains detailed account how QEP/C++ compiles with PC-Lint. (See http://www.state-machine.com/doc/AN_QP_Cpp_PC-Lint.pdf).
6. This release is compliant with the "Quantum Leaps Coding Standard" (http://www.state-machine.com/resources/QL_coding_standard.pdf). Among others, all public names are prefixed by "Q_", or "QEP_" to minimize compile-time and link-time name conflicts. In addition, QEP/C++ uses the C99 standard include file <stdint.h> (C99 Standard, Section 7.18). Pre-standard compilers are still supported by placing <stdint.h> in the compiler's header file directory.
7. The QEvent class has been redesigned to use memory more efficiently. QEvent takes up only 2 bytes now.
8. The QHsm class now derives from the QFsm class, which promotes better code re-use. In particular, macros Q_INIT() and Q_TRAN() are now common for both traditional non-hierarchical FSMs and for HSMs.
9. The QFsm class has been redesigned to allow using entry and exit actions. Now the QFsm class strictly avoids recursion, just as QHsm does (MISRA rule 70).
10. The QPseudoState type has been eliminated and replaced by QState.
11. The central QHsm class in QEP has been completely redesigned. The basic transition algorithm is essentially the same as described in "PSiCC", however the implementation is very different. The redesign was necessary to comply with the MISRA rules and to eliminate Lint warnings.
12. The event processor is now strictly non-recursive (MISRA rule 70), that is, event handlers never call themselves, even indirectly. (Previous algorithm required one-level of indirect recursion.)
13. Dynamic state transition is now default. Static transition optimization is still supported, but considered optional for performance tuning.
14. The artificial limitation of initial transitions targeting only immediate substate of a composite state has been removed (see "PSiCC" Figure 5.4[a]). Initial transitions can now target any substate, arbitrarily nested within the composite state.
15. This distribution uses the legacy Borland Turbo C++ 1.01 as the default compiler. Port to DOS with Turbo C++ 1.01 is provided along with GNU-compatible makefiles for the QEP library and sample applications. This compiler is not C99-compliant and does not provide the <stdint.h> header file. However, the port of QEP includes a minimal <stdint.h>, which should be placed into the INCLUDE directory of the Borland Turbo C++ 1.01 installation.
16. This distribution contains three sample applications: A simple time bomb (QBomb) to demonstrate use of QFsm, a calculator (QCalc), and an exhaustive test of the QHsm class (QHsmTst). All examples are implemented as text-only application compiled with Turbo C++ 1.01. The QHsmTst sample application supports interactive and batch mode for exhaustive testing of the event processor. The source code for QHsmTst demonstrates also how QEP/C++ application code can be MISRA-compliant.
17. This distribution contains make files for the Turbo C++ 1.01 make utility, as well as GNU-compatible Makefiles.

---