7.4.0

Author: quantum-leaps

README.md

@@ -24,7 +24,8 @@ This repository can be used in several ways:
 +---cmsis-packs    <=== standalone examples
 |   +---dpp_nucleo-c031c6-qk-gcc
 |   +---dpp_nucleo-c031c6-qk-keil
-|   \---dpp_nucleo-c031c6-qk-stm32cube
+|   +---dpp_nucleo-c031c6-qk-stm32cube
+|   \---dpp_nucleo-u545re-qk-stm32cube
 |
 ```
 
@@ -73,13 +74,16 @@ This repository can be used in several ways:
 +---emwin
 |   +---demo_no_wm
 |   \---demo_with_wm
+|
 +---freertos
 |   \---arm-cm
 |       +---dpp_ek-tm4c123gxl
 |       \---dpp_nucleo-h743zi
+|
 +---lwip
 |   \---arm-cm
 |       \---lwip_ek-lm3s6965
+|
 +---msp430
 |   +---blinky_msp-exp430f5529lp
 |   +---blinky_msp-exp430g2
@@ -152,16 +156,18 @@ computer. The interfaces created by QView can visualize the data produced
 by [QP/Spy software tracing system](https://www.state-machine.com/qtools/qpspy.html)
 and can also interact with the embedded target by sending various commands.
 
+> **NOTE** You need to **install** the `qview` package in your Python setup.<br>
+`pip install qview`
+
 The python scripts `qview-dpp/dpp.py` and `qview-dpp/dpp1.py` will allow
 monitoring of all DPP examples running on any supported board (or on the
 host computer). Here is how you can launch the QView monitoring for DPP:
 
 ```
-python %QTOOLS%\qview\qview.py dpp.py
-```
+pythonw dpp.py
 
-> **NOTE** You need the `qview.py` Python script, which in the command-line
-above is assumed to be located in `%QTOOLS%\qview`.
+pythonw dpp1.py
+```
 
 The following screen shot shows QView for the DPP (Dining Philosophers Problem)
 application with the QSPY ouptut in the background.

arm-cm/dpp_nucleo-u545re/README.md

@@ -1,12 +1,12 @@
 > **NOTE**
 This file is best viewed in a **markdown viewer**, such as the one built into GitHub. Markdown viewers are also available as plug-ins to popular Internet browsers.
 
-# DPP on NUCLEO-C031C6
-This example demonstrates the [Dining Philosophers Problem (DPP) application](https://www.state-machine.com/qpc/tut_dpp.html) on the STM32 NUCLEO-C031C6 board (ARM Cortex-M0+).
+# DPP on NUCLEO-U545RE
+This example demonstrates the [Dining Philosophers Problem (DPP) application](https://www.state-machine.com/qpc/tut_dpp.html) on the STM32 NUCLEO-U545RE board (ARM Cortex-__M33__).
 
 <p align="center">
-<img src="./stm32-nucleo-c031c6.jpg"/><br>
-<b>STM32 NUCLEO-C031C6</b>
+<img src="./stm32-nucleo-u545re.jpg"/><br>
+<b>STM32 NUCLEO-U545RE</b>
 </p>
 
 > **NOTE**
@@ -43,42 +43,42 @@ This example can be used as a starting point for any other ARM Cortex-M MCU, inc
 
 # Code Organization
 ```
-examples\arm-cm\dpp_nucleo-c031c6
+examples\arm-cm\dpp_nucleo-u545re
 |
-+---qk             // preemptive QK kernel
-|   +---gnu        // GNU-ARM toolchain
++---qk                        // preemptive QK kernel
+|   +---gnu                   // GNU-ARM toolchain
 |   |   \---targetConfigs
 |   |       Makefile          // Makefile for GNU-ARM
-|   +---armclang   // ARM/KEIL toolchain with Compiler 6 (ARM/CLANG)
-|   |       dpp-qk.uvprojx // uVision project
-|   \---iar        // IAR EWARM
-|           dpp-qk.eww     // IAR EW-ARM workspace
+|   +---armclang              // ARM/KEIL toolchain with Compiler 6 (ARM/CLANG)
+|   |       dpp-qk.uvprojx    // uVision project
+|   \---iar                   // IAR EWARM
+|           dpp-qk.eww        // IAR EW-ARM workspace
 |
-\---qv             // cooperative QK kernel
-|   +---gnu        // GNU-ARM toolchain
+\---qv                        // cooperative QK kernel
+|   +---gnu                   // GNU-ARM toolchain
 |   |   \---targetConfigs
 |   |       Makefile          // Makefile for GNU-ARM
-|   +---armclang   // ARM/KEIL toolchain with Compiler 6 (ARM/CLANG)
-|   |       dpp-qv.uvprojx // uVision project
-|   \---iar        // IAR EWARM
-|           dpp-qv.eww     // IAR EW-ARM workspace
+|   +---armclang              // ARM/KEIL toolchain with Compiler 6 (ARM/CLANG)
+|   |       dpp-qv.uvprojx    // uVision project
+|   \---iar                   // IAR EWARM
+|           dpp-qv.eww        // IAR EW-ARM workspace
 |
-+---qxk            // preemptive, dual-mode QXK kernel
-|   +---gnu        // GNU-ARM toolchain
++---qxk                       // preemptive, dual-mode QXK kernel
+|   +---gnu                   // GNU-ARM toolchain
 |   |   \---targetConfigs
 |   |       Makefile          // Makefile for GNU-ARM
-|   +---armclang   // ARM/KEIL toolchain with Compiler 6 (ARM/CLANG)
-|   |       dpp-qxk.uvprojx // uVision project
-|   \---iar        // IAR EWARM
-|           dpp-qxk.eww     // IAR EW-ARM workspace
+|   +---armclang              // ARM/KEIL toolchain with Compiler 6 (ARM/CLANG)
+|   |       dpp-qxk.uvprojx   // uVision project
+|   \---iar                   // IAR EWARM
+|           dpp-qxk.eww       // IAR EW-ARM workspace
 |
 ```
 
 # Building the example
 
 ### GNU/ARM
 - open terminal window
-- change to the desired directory (either `examples\arm-cm\dpp_nucleo-c031c6\qk\gnu`, `examples\arm-cm\dpp_nucleo-c031c6\qv\gnu`, or `examples\arm-cm\dpp_nucleo-c031c6\qxk\gnu`)
+- change to the desired directory (either `examples\arm-cm\dpp_nucleo-u545re\qk\gnu`, `examples\arm-cm\dpp_nucleo-u545re\qv\gnu`, or `examples\arm-cm\dpp_nucleo-u545re\qxk\gnu`)
 - to build the default Debug configuration, type:
 
 ```

arm-cm/dpp_nucleo-u545re/qk/armclang/README.txt

@@ -0,0 +1,2 @@
+This version of IAR does not support STM32U545RETQ.
+Therefore, the selected device is: STM32U575RQ

arm-cm/dpp_nucleo-u545re/qk/iar/README.txt

@@ -0,0 +1,2 @@
+This version of IAR does not support STM32U545RETQ.
+Therefore, the selected device is: STM32U575RQ

arm-cm/dpp_nucleo-u545re/qv/iar/README.txt

@@ -44,7 +44,7 @@
 #
 # NOTE:
 # To use this Makefile on Windows, you will need the GNU make utility, which
-# is included in the Qtools collection for Windows, see:
+# is included in the QTools collection for Windows, see:
 #    https://github.com/QuantumLeaps/qtools
 
 #-----------------------------------------------------------------------------

arm-cm/dpp_nucleo-u545re/qxk/gnu/Makefile

@@ -0,0 +1,2 @@
+This version of IAR does not support STM32U545RETQ.
+Therefore, the selected device is: STM32U575RQ

arm-cm/dpp_nucleo-u545re/qxk/iar/README.txt

@@ -9,9 +9,13 @@
 # trace record QS_USER_00 (PHILO_STAT) produced when the status of
 # a Philo changes.
 
-class DPP:
-    def __init__(self):
+from qview import QView
+from tkinter import *
+from tkinter.ttk import * # override the basic Tk widgets with Ttk widgets
 
+class DPP(QView):
+    # on_init() callback
+    def on_init(self):
         # add commands to the Custom menu...
         QView.custom_menu.add_command(label="Custom command",
                                       command=self.cust_command)
@@ -22,9 +26,9 @@ def __init__(self):
 
         # tuple of activity images (correspond to self._philo_state)
         self._act_img = (
-            PhotoImage(file=HOME_DIR + "/img/thinking.gif"),
-            PhotoImage(file=HOME_DIR + "/img/hungry.gif"),
-            PhotoImage(file=HOME_DIR + "/img/eating.gif"),
+            PhotoImage(file="img/thinking.gif"),
+            PhotoImage(file="img/hungry.gif"),
+            PhotoImage(file="img/eating.gif"),
         )
         # tuple of philo canvas images (correspond to self._philo_obj)
         self._philo_img = (\
@@ -36,8 +40,8 @@ def __init__(self):
         )
 
         # button images for UP and DOWN
-        self.img_UP  = PhotoImage(file=HOME_DIR + "/img/BTN_UP.gif")
-        self.img_DWN = PhotoImage(file=HOME_DIR + "/img/BTN_DWN.gif")
+        self.img_UP  = PhotoImage(file="img/BTN_UP.gif")
+        self.img_DWN = PhotoImage(file="img/BTN_DWN.gif")
 
         # images of a button for pause/serve
         self.btn = QView.canvas.create_image(200, 120, image=self.img_UP)
@@ -46,22 +50,27 @@ def __init__(self):
         # request target reset on startup...
         # NOTE: Normally, for an embedded application you would like
         # to start with resetting the Target, to start clean with
-        # Qs dictionaries, etc.
-        reset_target()
+        # QS dictionaries, etc.
+        QView.reset_target()
 
-    # on_reset() callback
+
+    # on_reset() callback invoked when Target-reset packet is received
+    # NOTE: the QS dictionaries are not known at this time yet, so
+    # this callback shouild generally not set filters or current objects
     def on_reset(self):
         # clear the lists
         self._philo_obj   = [0, 0, 0, 0, 0]
         self._philo_state = [0, 0, 0]
 
-    # on_run() callback
+    # on_run() callback invoked when the QF_RUN packet is received
+    # NOTE: the QS dictionaries are typically known at this time yet, so
+    # this callback can set filters or current objects
     def on_run(self):
-        glb_filter("QS_USER_00")
+        QView.glb_filter("QS_USER_00")
 
         # NOTE: the names of objects for current_obj() must match
         # the QS Object Dictionaries produced by the application.
-        current_obj(OBJ_AO, "Table_inst")
+        QView.current_obj(QView.OBJ_AO, "Table_inst")
 
         # turn lists into tuples for better performance
         self._philo_obj = tuple(self._philo_obj)
@@ -70,17 +79,17 @@ def on_run(self):
 
     # example of a custom command
     def cust_command(self):
-        command(1, 12345)
+        QView.command(1, 12345)
 
     # example of a custom interaction with a canvas object (pause/serve)
     def cust_pause(self, event):
         if QView.canvas.itemcget(self.btn, "image") != str(self.img_UP):
             QView.canvas.itemconfig(self.btn, image=self.img_UP)
-            post("SERVE_SIG")
+            QView.post("SERVE_SIG")
             QView.print_text("Table SERVING")
         else:
             QView.canvas.itemconfig(self.btn, image=self.img_DWN)
-            post("PAUSE_SIG")
+            QView.post("PAUSE_SIG")
             QView.print_text("Table PAUSED")
 
     # Intercept the QS_USER_00 application-specific trace record.
@@ -89,7 +98,7 @@ def cust_pause(self, event):
     #    format-byte, Zero-terminated string (status)
     def QS_USER_00(self, packet):
         # unpack: Timestamp->data[0], Philo-num->data[1], status->data[3]
-        data = qunpack("xxTxBxZ", packet)
+        data = QView.qunpack("xxTxBxZ", packet)
         i = data[1]
         j = ("t", "h", "e").index(data[2][0]) # the first letter
 
@@ -100,4 +109,5 @@ def QS_USER_00(self, packet):
         QView.print_text("%010d Philo %1d is %s"%(data[0], i, data[2]))
 
 #=============================================================================
-QView.customize(DPP()) # set the QView customization
+if __name__ == "__main__":
+    QView.main(DPP())