7.1.1

increased default for QF_TIMEEVT_CTR_SIZE to 4

Author: quantum-leaps

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__

doxygen/qspy.dox

@@ -37,7 +37,7 @@ Usage: qspy [options]     <arg> = required, [arg] = optional
 <tr><td>-h                    <td>-h           <td>(key-h) <td> <td>Help. Prints the summary of options
 <tr><td>-q [num]              <td>-q 99        <td>(key-q) <td> <td>Quiet mode (reduced stdout output)
 <tr><td>-u [UDP_port|0]       <td>-u           <td>7701    <td> <td>UDP socket for "Front-Ends".<br>`-u0` suppresses opening the UDP socket
-<tr><td>-v &lt;QS_version&gt; <td>-v 6.2       <td>6.6     <td> <td>Enforce backwards-compatibility with the specific QS version
+<tr><td>-v &lt;QS_version&gt; <td>-v 6.2       <td>7.0     <td> <td>Enforce backwards-compatibility with the specific QS version
 <tr><td>-r &lt;c0|c1|c2&gt;   <td>-r c2        <td>c1      <td> <td>Rendering options (c0=no-color|c1-color1|c2-color2)
 <tr><td>-k                    <td>-k           <td>        <td> <td>suppress keyboard input
 <tr><td>-o                    <td>-o           <td>(key-o) <td> <td>Produce output to the specified file
@@ -62,7 +62,7 @@ The Target can **report** its configuration to QSPY, which means that you don't
 <tr><td>-P &lt;size&gt;       <td>-P 4         <td>2       <td>`QF_MPOOL_CTR_SIZE`  <td>Pool counter size in bytes. Valid values: 1, 2, 4
 <tr><td>-B &lt;size&gt;       <td>-B 1         <td>2       <td>`QF_MPOOL_SIZ_SIZE`  <td>Block size size in bytes. (i.e., the size of variables that hold
         memory block size). Valid values 1, 2, 4
-<tr><td>-C &lt;size&gt;       <td>-C 4         <td>2       <td>`QF_TIMEEVT_CTR_SIZE` <td>Time event counter size. Valid values: 1, 2, 4
+<tr><td>-C &lt;size&gt;       <td>-C 2         <td>4       <td>`QF_TIMEEVT_CTR_SIZE` <td>Time event counter size. Valid values: 1, 2, 4
 </table>
 
 

qspy/source/qspy_main.c

@@ -23,8 +23,8 @@
 * <[email protected]>
 ============================================================================*/
 /*!
-* @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 <stdbool.h>
 #include <time.h>
 
-#include "safe_std.h" /* "safe" <stdio.h> and <string.h> 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" <stdio.h> and <string.h> 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 <counter_size> 1       queue counter size    (bytes)\n"
     "-P <counter_size> 2       pool counter size     (bytes)\n"
     "-B <block_size>   2       pool block-size size  (bytes)\n"
-    "-C <counter_size> 2       QTimeEvt counter size (bytes)\n";
+    "-C <counter_size> 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;