diff --git a/doxygen/history.dox b/doxygen/history.dox index 249fc32..73d9d47 100644 --- a/doxygen/history.dox +++ b/doxygen/history.dox @@ -1,9 +1,20 @@ /** @page history Revision History -@section qtools_7_1_1 Version 7.1.1, 2022-08-30 +@section qtools_7_1_1 Version 7.1.1, 2022-09-03 Slightly restructured QSPY source code to better integrate directly with QP applications. Specifically, moved QSPY_cleanup() to qspy.c, so it is available to the applications. +__QSPY host application:__ +- Added pre-defined "Scheduler" records: + + `QS_SCHED_PREEMPT` replaces deprecated `QS_MUTEX_LOCK` + + `QS_SCHED_RESTORE` replaces deprecated `QS_MUTEX_UNLOCK` +- Increased the default version for backwards compatibility from 6.6 to 7.0 +(@ref qspy_command "command-line option -v", now defaults to 7.0) +- Increased the default for QTimeEvt counter size from 2 to 4 +(@ref qspy_command "command-line option -C", now defaults to 4). +This corresponds to the change of the default value +of `QF_TIMEEVT_CTR_SIZE` to 4 in QP/C and QP/C. + @section qtools_7_1_0 Version 7.1.0, 2022-08-22 @@ -32,8 +43,8 @@ QS_MUTEX_UNLOCK, /*!< @deprecated */ @endcode Also, the following new groups for QS global filter have been added: @code{.c} - QS_SEM_RECORDS, /*!< Semaphore QS records */ - QS_MTX_RECORDS, /*!< Mutex QS records */ + QS_SEM_RECORDS, /*!< Semaphore QS records */ + QS_MTX_RECORDS, /*!< Mutex QS records */ @endcode __Changes in QUTest__ diff --git a/doxygen/qspy.dox b/doxygen/qspy.dox index 28ceab4..dcfdcc7 100644 --- a/doxygen/qspy.dox +++ b/doxygen/qspy.dox @@ -37,7 +37,7 @@ Usage: qspy [options] = required, [arg] = optional -h -h (key-h) Help. Prints the summary of options -q [num] -q 99 (key-q) Quiet mode (reduced stdout output) -u [UDP_port|0] -u 7701 UDP socket for "Front-Ends".
`-u0` suppresses opening the UDP socket --v <QS_version> -v 6.2 6.6 Enforce backwards-compatibility with the specific QS version +-v <QS_version> -v 6.2 7.0 Enforce backwards-compatibility with the specific QS version -r <c0|c1|c2> -r c2 c1 Rendering options (c0=no-color|c1-color1|c2-color2) -k -k suppress keyboard input -o -o (key-o) Produce output to the specified file @@ -62,7 +62,7 @@ The Target can **report** its configuration to QSPY, which means that you don't -P <size> -P 4 2 `QF_MPOOL_CTR_SIZE` Pool counter size in bytes. Valid values: 1, 2, 4 -B <size> -B 1 2 `QF_MPOOL_SIZ_SIZE` Block size size in bytes. (i.e., the size of variables that hold memory block size). Valid values 1, 2, 4 --C <size> -C 4 2 `QF_TIMEEVT_CTR_SIZE` Time event counter size. Valid values: 1, 2, 4 +-C <size> -C 2 4 `QF_TIMEEVT_CTR_SIZE` Time event counter size. Valid values: 1, 2, 4 diff --git a/qspy/source/qspy_main.c b/qspy/source/qspy_main.c index 2b7c1d3..20cf59c 100644 --- a/qspy/source/qspy_main.c +++ b/qspy/source/qspy_main.c @@ -23,8 +23,8 @@ * ============================================================================*/ /*! -* @date Last updated on: 2022-08-22 -* @version Last updated for version: 7.1.0 +* @date Last updated on: 2022-09-05 +* @version Last updated for version: 7.1.1 * * @file * @brief main for QSPY host utility @@ -36,11 +36,11 @@ #include #include -#include "safe_std.h" /* "safe" and facilities */ -#include "qspy.h" /* QSPY data parser */ -#include "be.h" /* Back-End interface */ -#include "pal.h" /* Platform Abstraction Layer */ -#include "getopt.h" /* command-line option processor */ +#include "safe_std.h" /* "safe" and facilities */ +#include "qspy.h" /* QSPY data parser */ +#include "be.h" /* Back-End interface */ +#include "pal.h" /* Platform Abstraction Layer */ +#include "getopt.h" /* command-line option processor */ #define Q_SPY 1 /* this is QP implementation */ #define QP_IMPL 1 /* this is QP implementation */ @@ -122,7 +122,7 @@ static char const l_helpStr[] = "-Q 1 queue counter size (bytes)\n" "-P 2 pool counter size (bytes)\n" "-B 2 pool block-size size (bytes)\n" - "-C 2 QTimeEvt counter size (bytes)\n"; + "-C 4 QTimeEvt counter size (bytes)\n"; static char const l_kbdHelpStr[] = "Keyboard shortcuts (valid when -k option is absent):\n" @@ -305,7 +305,7 @@ static QSpyStatus configure(int argc, char *argv[]) { .queueCtrSize = 1U, .poolCtrSize = 2U, .poolBlkSize = 2U, - .tevtCtrSize = 2U, + .tevtCtrSize = 4U, }; int optChar;