7.1.0

Author: quantum-leaps

LICENSES/LICENSE-LMFlash.txt

@@ -1,20 +1,20 @@
-License Agreement  
+License Agreement
 
-Important - This is a legally binding agreement. Read it carefully. After you read the following terms, you will be asked whether you are authorized to commit your company to abide by the following terms. THIS AGREEMENT IS DISPLAYED FOR YOU TO READ PRIOR TO DOWNLOADING OR USING THE "LICENSED MATERIALS". 
+Important - This is a legally binding agreement. Read it carefully. After you read the following terms, you will be asked whether you are authorized to commit your company to abide by the following terms. THIS AGREEMENT IS DISPLAYED FOR YOU TO READ PRIOR TO DOWNLOADING OR USING THE "LICENSED MATERIALS".
 
-DO NOT DOWNLOAD OR INSTALL the software programs unless you agree on behalf of yourself and your company to be bound by the terms of this License Agreement. 
+DO NOT DOWNLOAD OR INSTALL the software programs unless you agree on behalf of yourself and your company to be bound by the terms of this License Agreement.
 
-DO NOT CLICK "I AGREE" UNLESS : 
+DO NOT CLICK "I AGREE" UNLESS :
 
-1. YOU ARE AUTHORIZED TO AGREE TO THE TERMS OF THIS LICENSE ON BEHALF OF YOURSELF AND YOUR COMPANY; AND 
+1. YOU ARE AUTHORIZED TO AGREE TO THE TERMS OF THIS LICENSE ON BEHALF OF YOURSELF AND YOUR COMPANY; AND
 
-2. YOU INTEND TO ENTER THIS LEGALLY BINDING AGREEMENT ON BEHALF OF YOURSELF AND YOUR COMPANY. 
+2. YOU INTEND TO ENTER THIS LEGALLY BINDING AGREEMENT ON BEHALF OF YOURSELF AND YOUR COMPANY.
 
 Important - Read carefully: This software license agreement ("Agreement") is a legal agreement between you (either an individual or entity) and Texas Instruments Incorporated ("TI"). The "Licensed Materials" subject to this Agreement include the software programs TI has granted you access to download and any "on-line" or electronic documentation associated with these programs, or any portion thereof, and may also include hardware, reference designs and associated documentation. The Licensed Materials are specifically designed and licensed for use solely and exclusively with microprocessor/microcontroller devices manufactured by or for TI ("TI Devices"). By installing, copying or otherwise using the Licensed Materials you agree to abide by the provisions set forth herein. This Agreement is displayed for you to read prior to using the Licensed Materials. If you choose not to accept or agree with these provisions,do not download or install the Licensed Materials .
 
 1. Delivery. TI may deliver the Licensed Materials, or portions thereof, to you electronically.
 
-2. License Grant and Use Restrictions. 
+2. License Grant and Use Restrictions.
 
 a. Limited Source Code License. Subject to the terms of this Agreement, and commencing as of the Effective Date and continuing for the term of this Agreement, TI hereby grants to you a limited, free, non-transferable, non-exclusive, non-assignable, non-sub-licensable license to make copies, prepare derivative works, display internally and use internally the Licensed Materials provided to you in source code for the sole purposes of designing and developing object and executable versions of such Licensed Materials or any derivative thereof, that execute solely and exclusively on TI Devices used in Customer Product(s), and maintaining and supporting such Licensed Materials, or any derivative thereof, and Customer Product(s). "Customer Product" means a final product distributed by or for you that consists of both hardware, including one or more TI Devices, and software components, including only executable versions of the Licensed Materials that execute solely and exclusively on or with such TI Devices and not on devices manufactured by or for an entity other than TI.
 
@@ -40,7 +40,7 @@ h. Termination. This Agreement is effective until terminated. You may terminate
 
 3. Licensed Materials Ownership. The Licensed Materials are licensed, not sold to you, and can only be used in accordance with the terms of this Agreement. Subject to the licenses granted to you pursuant to this Agreement, TI and TI's licensors own and shall continue to own all right, title, and interest in and to the Licensed Materials, including all copies thereof. The parties agree that all fixes, modifications and improvements to the Licensed Materials conceived of or made by TI that are based, either in whole or in part, on your feedback, suggestions or recommendations are the exclusive property of TI and all right, title and interest in and to such fixes, modifications or improvements to the Licensed Materials will vest solely in TI. Moreover, you acknowledge and agree that when your independently developed software or hardware components are combined, in whole or in part, with the Licensed Materials, your right to use the Licensed Materials embodied in such resulting combined work shall remain subject to the terms and conditions of this Agreement.
 
-4. Intellectual Property Rights. 
+4. Intellectual Property Rights.
 
 a. The Licensed Materials contain copyrighted material, trade secrets and other proprietary information of TI and TI's licensors and are protected by copyright laws, international copyright treaties, and trade secret laws, as well as other intellectual property laws. To protect TI's and TI's licensors' rights in the Licensed Materials, you agree, except as specifically permitted by statute by a provision that cannot be waived by contract, not to "unlock", decompile, reverse engineer, disassemble or otherwise translate any portions of the Licensed Materials to a human-perceivable form nor to permit any person or entity to do so. You shall not remove, alter, cover, or obscure any confidentiality, trade secret, proprietary, or copyright notices, trade-marks, proprietary, patent, or other identifying marks or designs from any component of the Licensed Materials and you shall reproduce and include in all copies of the Licensed Materials the copyright notice(s) and proprietary legend(s) of TI and TI's licensors as they appear in the Licensed Materials. TI reserves all rights not specifically granted under this Agreement.
 
@@ -74,7 +74,7 @@ a. Registration Requirements. You shall be solely responsible for performing all
 
 b. Governing Language. This Agreement is written and executed in the English language. If a translation of this Agreement is required for any purpose, including but not limited to registration of the Agreement pursuant to any governmental laws, regulations or rules, you shall be solely responsible for creating such translation. Any translation of this Agreement into a language other than English is intended solely in order to comply with such laws or for reference purposes, and the English language version shall be authoritative and controlling.
 
-c. Export Control. 
+c. Export Control.
 
 (i). Diversions of Technology. You hereby agree that unless prior authorization is obtained from the U.S. Department of Commerce, neither you nor your subsidiaries or affiliates shall knowingly export, re-export, or release, directly or indirectly, any technology, software, or software source code (as defined in Part 772 of the Export Administration Regulations of the U.S. Department of Commerce ("EAR")), received from TI or any of its affiliated companies, or export, directly or indirectly, any direct product of such technology, software, or software source code (as defined in Part 734 of the EAR), to any destination or country to which the export, re-export, or release of the technology, software, software source code, or direct product is prohibited by the EAR.
 

README.md

@@ -1,7 +1,7 @@
 ![QTools Collection](https://www.state-machine.com/img/qtools_banner.jpg)
 
 # What's New?
-View QTools Revision History at: 
+View QTools Revision History at:
 https://www.state-machine.com/qtools/history.html
 
 
@@ -90,7 +90,7 @@ Alternatively, you can download QTools **separately** as described below:
 On Windows, installation of QTools consists of unzipping the
 `qtools-windows_<ver>.zip` archive into a directory of your choice,
 although the recommended default is `C:\qp`.
- 
+
 After unzipping the archive, you need to add the following directories
 to the PATH:
 

bin/qspy

@@ -7,7 +7,7 @@
 #---------------------------------------------------------------------------
 DOXYFILE_ENCODING      = UTF-8
 PROJECT_NAME           = "QTools"
-PROJECT_NUMBER         = 7.0.0
+PROJECT_NUMBER         = 7.1.0
 PROJECT_BRIEF          = "Collection of Host-Based Tools"
 PROJECT_LOGO           = ../../ql-doxygen/images/logo_ql.png
 OUTPUT_DIRECTORY       =

doxygen/Doxyfile

@@ -1,8 +1,53 @@
 /**
 @page history Revision History
 
-@section qtools_7_0_0 Version 7.0.0, 2022-01-31
+@section qtools_7_1_0 Version 7.1.0, 2022-08-22
 
+__Changes in QSpy__
+- QSpy 7.1.0 has been updated for QP version 7.1.0. Specifically new predefined QS trace records have been added:
+@code{.c}
+/* [71] Semaphore (SEM) records */
+QS_SEM_TAKE,          /*!< a semaphore was taken by a thread */
+QS_SEM_BLOCK,         /*!< a semaphore blocked a thread */
+QS_SEM_SIGNAL,        /*!< a semaphore was signaled*/
+QS_SEM_BLOCK_ATTEMPT, /*!< a semaphore blocked was attempted */
+
+/* [75] Mutex (MTX) records */
+QS_MTX_LOCK,          /*!< a mutex was locked */
+QS_MTX_BLOCK,         /*!< a mutex blocked a thread */
+QS_MTX_UNLOCK,        /*!< a mutex was unlocked */
+QS_MTX_LOCK_ATTEMPT,  /*!< a mutex lock was attempted */
+QS_MTX_BLOCK_ATTEMPT, /*!< a mutex blocking was attempted */
+QS_MTX_UNLOCK_ATTEMPT,/*!< a mutex unlock was attempted */
+@endcode
+the following QS trace records are now deprecated:
+@code{.c}
+/* [48] old Mutex records, deprecated in QP 7.1.0 */
+QS_MUTEX_LOCK,        /*!< @deprecated */
+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 */
+@endcode
+
+__Changes in QUTest__
+- `qutest.py` has been updated to include new QS trace records and global filters for them. The following QS record groups have been added to the "QUTest DSL":
+@code{.c}
+GRP_SEM - Semaphore QS records
+GRP_MTX - Mutex QS records
+@endcode
+
+__Changes in QUView__
+- `qview.py` has been updated to include new QS trace records and global filters for them. The following QS record groups have been added to QView:
+@code{.c}
+GRP_SEM - Semaphore QS records
+GRP_MTX - Mutex QS records
+@endcode
+
+
+@section qtools_7_0_0 Version 7.0.0, 2022-01-31
 __Changes in QSpy__
 - The QSpy 7.0.0 implementation has been re-factored to modularize it in order to better support building host-based applications for executing embedded code on the host. Specifically, the new QSpy design better separates the "QSpy parser" of the QS records from the rendering engine and from other functionality of the QSpy host application.
 - Also, this release introduces semantic coloring of the @ref qspy "QSPY output", which improves its readability. This feature is now controlled by the added @ref qspy_command "command-line option" `-r<c0|c1|c2>`.

doxygen/history.dox

@@ -158,6 +158,8 @@ def __init__(self):
             "GRP_TE": QSpy._GRP_TE,
             "GRP_QF": QSpy._GRP_QF,
             "GRP_SC": QSpy._GRP_SC,
+            "GRP_SEM": QSpy._GRP_SEM,
+            "GRP_MTX": QSpy._GRP_MTX,
             "GRP_U0": QSpy._GRP_U0,
             "GRP_U1": QSpy._GRP_U1,
             "GRP_U2": QSpy._GRP_U2,

qutest/qutest.py

@@ -23,15 +23,15 @@
 # <[email protected]>
 #=============================================================================
 ##
-# @date Last updated on: 2022-01-27
-# @version Last updated for version: 7.0.0
+# @date Last updated on: 2022-08-22
+# @version Last updated for version: 7.1.0
 #
 # @file
 # @brief QUTest Python scripting support (documentation)
 # @ingroup qutest
 
 ## @brief current version of the Python QUTest interface
-VERSION = 700
+VERSION = 710
 
 ## @brief include python code in a test script
 # @description
@@ -188,6 +188,8 @@ def ensure(bool_expr):
 # GRP_TE # Time Events Record-Types
 # GRP_QF # Framework Record-Types (e.g., post/publish/..)
 # GRP_SC # Scheduler Record-Types (e.g., scheduler lock/unlock)
+# GRP_SEM # Semaphore Record-Types (e.g., Semaphore take/signal)
+# GRP_MTX # Mutex Record-Types (e.g., Mutex lock/unlock)
 # GRP_U0 # User group 0 (Record-Types 100-104)
 # GRP_U1 # User group 1 (Record-Types 105-109)
 # GRP_U2 # User group 2 (Record-Types 110-114)

qutest/qutest_dsl.py

@@ -1544,12 +1544,14 @@ def _sendEvt(ao_prio, signal, params = None):
 GRP_TE = 0xF5
 GRP_QF = 0xF6
 GRP_SC = 0xF7
-GRP_U0 = 0xF8
-GRP_U1 = 0xF9
-GRP_U2 = 0xFA
-GRP_U3 = 0xFB
-GRP_U4 = 0xFC
-GRP_UA = 0xFD
+GRP_SEM= 0xF8
+GRP_MTX= 0xF9
+GRP_U0 = 0xFA
+GRP_U1 = 0xFB
+GRP_U2 = 0xFC
+GRP_U3 = 0xFD
+GRP_U4 = 0xFE
+GRP_UA = 0xFF
 GRP_ON = GRP_ALL
 GRP_OFF= -GRP_ALL
 
@@ -1635,14 +1637,20 @@ def _apply(mask, is_neg):
             _apply(QSpy._GLB_FLT_MASK_SM, is_neg)
         elif arg == GRP_AO:
             _apply(QSpy._GLB_FLT_MASK_AO, is_neg)
-        elif arg == GRP_QF:
-            _apply(QSpy._GLB_FLT_MASK_QF, is_neg)
-        elif arg == GRP_TE:
-            _apply(QSpy._GLB_FLT_MASK_TE, is_neg)
-        elif arg == GRP_EQ:
-            _apply(QSpy._GLB_FLT_MASK_EQ, is_neg)
         elif arg == GRP_MP:
             _apply(QSpy._GLB_FLT_MASK_MP, is_neg)
+        elif arg == GRP_EQ:
+            _apply(QSpy._GLB_FLT_MASK_EQ, is_neg)
+        elif arg == GRP_TE:
+            _apply(QSpy._GLB_FLT_MASK_TE, is_neg)
+        elif arg == GRP_QF:
+            _apply(QSpy._GLB_FLT_MASK_QF, is_neg)
+        elif arg == GRP_SC:
+            _apply(QSpy._GLB_FLT_MASK_SC, is_neg)
+        elif arg == GRP_SEM:
+            _apply(QSpy._GLB_FLT_MASK_SEM, is_neg)
+        elif arg == GRP_MTX:
+            _apply(QSpy._GLB_FLT_MASK_MTX, is_neg)
         elif arg == GRP_U0:
             _apply(QSpy._GLB_FLT_MASK_U0, is_neg)
         elif arg == GRP_U1:

qview/qview.py

@@ -8,5 +8,5 @@ Adjusting the CPU Clock Speed
 =============================
 The current setting is to run at 20MHz from the PLL, but the CPU
 clock speed can be modified by editing the "Clock Configuration"
-section in the file system_LM3S811.c. 
+section in the file system_LM3S811.c.