7.0.2

fixed bugs in QK/QXK ports to ARM Cortex-M

Author: quantum-leaps

examples/arm-cm/dpp_efm32-slstk3401a/qk/armclang/README.txt

@@ -21,7 +21,7 @@ IRQ for that purpose. To choose a given IRQ, you need to define
 the macros QK_USE_IRQ_NUM and QK_USE_IRQ_HANDLER. These macros can
 be provided on the command-line to the compiler.
 
-For example, for the EFM32 CPU, you might dedicate the IRQ
+For example, for the EFM32 MCU, you might dedicate the IRQ
 "CRYPTO_IRQHandler" (see the vector table), with IRQ number 25,
 as follows:
 

examples/arm-cm/dpp_efm32-slstk3401a/qk/gnu/README.txt

@@ -44,6 +44,24 @@ script (.ld file), which provides a template of the recommended GCC linker
 script for QP applications.
 
 
+Selecting QK Exception
+======================
+The QK kernel needs a dedicated exception to return to the thread
+context after preemption. The default is to use the NMI exception
+for that purpose. However, in case NMI is needed for some other
+purpose, the QK port allows you to select a any, otherwise unused
+IRQ for that purpose. To choose a given IRQ, you need to define
+the macros QK_USE_IRQ_NUM and QK_USE_IRQ_HANDLER. These macros can
+be provided on the command-line to the compiler.
+
+For example, for the EFM32 MCU, you might dedicate the IRQ
+"CRYPTO_IRQHandler" (see the vector table), with IRQ number 25,
+as follows:
+
+QK_USE_IRQ_HANDLER=CRYPTO_IRQHandler
+QK_USE_IRQ_NUM=25
+
+
 Startup Code
 ============
 The startup code for the EFM32PG1B200F256GM48 MCU used in this project

examples/arm-cm/dpp_efm32-slstk3401a/qk/iar/README.txt

@@ -36,7 +36,7 @@ IRQ for that purpose. To choose a given IRQ, you need to define
 the macros QK_USE_IRQ_NUM and QK_USE_IRQ_HANDLER. These macros can
 be provided on the command-line to the compiler.
 
-For example, for the EFM32 CPU, you might dedicate the IRQ
+For example, for the EFM32 MCU, you might dedicate the IRQ
 "CRYPTO_IRQHandler" (see the vector table), with IRQ number 25,
 as follows:
 

examples/arm-cm/dpp_efm32-slstk3401a/qxk/armclang/README.txt

@@ -11,6 +11,17 @@ libraries. These relative paths must be modified when the project
 is moved to different relative location.
 
 
+Adjusting Stack and Heap Sizes
+==============================
+The stack and heap sizes are determined in this project by the
+command-line options for the ARM assembler (see the Asm tab in
+the "Options for Target" dialog box in uVision). Specifically,
+you should define symbols: Stack_Size=xxx Heap_Size=yyy, where
+xxx represents a numerical value of stack size and yyy the
+numerical value of the heap size (for most embedded projects
+yyy should be 0, as the using the heap is not recommended).
+
+
 Selecting QXK Exception
 =======================
 The QXK kernel needs a dedicated exception to return to the thread
@@ -21,25 +32,14 @@ otherwise unused IRQ for that purpose. To choose a given IRQ, you
 need to define the macros QXK_USE_IRQ_NUM and QXK_USE_IRQ_HANDLER.
 These macros can be provided on the command-line to the compiler.
 
-For example, for the EFM32 CPU, you might dedicate the IRQ
+For example, for the EFM32 MCU, you might dedicate the IRQ
 "CRYPTO_IRQHandler" (see the vector table), with IRQ number 25,
 as follows:
 
 QXK_USE_IRQ_HANDLER=CRYPTO_IRQHandler
 QXK_USE_IRQ_NUM=25
 
 
-Adjusting Stack and Heap Sizes
-==============================
-The stack and heap sizes are determined in this project by the
-command-line options for the ARM assembler (see the Asm tab in
-the "Options for Target" dialog box in uVision). Specifically,
-you should define symbols: Stack_Size=xxx Heap_Size=yyy, where
-xxx represents a numerical value of stack size and yyy the
-numerical value of the heap size (for most embedded projects
-yyy should be 0, as the using the heap is not recommended).
-
-
 Startup Code
 ============
 The startup code for the EFM32 MCU used in this project is

examples/arm-cm/dpp_efm32-slstk3401a/qxk/gnu/README.txt

@@ -44,6 +44,24 @@ script (.ld file), which provides a template of the recommended GCC linker
 script for QP applications.
 
 
+Selecting QXK Exception
+=======================
+The QXK kernel needs a dedicated exception to return to the thread
+context after preemption by a basic thread. The default is to use
+the NMI exception for that purpose. However, in case NMI is needed
+for some other purpose, the QXK port allows you to select a any,
+otherwise unused IRQ for that purpose. To choose a given IRQ, you
+need to define the macros QXK_USE_IRQ_NUM and QXK_USE_IRQ_HANDLER.
+These macros can be provided on the command-line to the compiler.
+
+For example, for the EFM32 MCU, you might dedicate the IRQ
+"CRYPTO_IRQHandler" (see the vector table), with IRQ number 25,
+as follows:
+
+QXK_USE_IRQ_HANDLER=CRYPTO_IRQHandler
+QXK_USE_IRQ_NUM=25
+
+
 Startup Code
 ============
 The startup code for the EFM32PG1B200F256GM48 MCU used in this project

examples/arm-cm/dpp_efm32-slstk3401a/qxk/iar/README.txt

@@ -15,7 +15,7 @@ relative location.
 Stack Size and Heap Size
 ------------------------
 In this project, the size of the C stack and heap are determined in
-the linker script blinky-qk.icf (see the next section).
+the linker script dpp-qxk.icf (see the next section).
 
 
 Linker Script
@@ -26,6 +26,24 @@ application-specific sizes of the Stack and Heap. This file can be edited
 from the IAR EWARM IDE via the Project Options/Linker settings.
 
 
+Selecting QXK Exception
+=======================
+The QXK kernel needs a dedicated exception to return to the thread
+context after preemption by a basic thread. The default is to use
+the NMI exception for that purpose. However, in case NMI is needed
+for some other purpose, the QXK port allows you to select a any,
+otherwise unused IRQ for that purpose. To choose a given IRQ, you
+need to define the macros QXK_USE_IRQ_NUM and QXK_USE_IRQ_HANDLER.
+These macros can be provided on the command-line to the compiler.
+
+For example, for the EFM32 MCU, you might dedicate the IRQ
+"CRYPTO_IRQHandler" (see the vector table), with IRQ number 25,
+as follows:
+
+QXK_USE_IRQ_HANDLER=CRYPTO_IRQHandler
+QXK_USE_IRQ_NUM=25
+
+
 Startup Code
 ============
 The startup code for the TM4C123GH6PM MCU used in this project is

examples/arm-cm/dpp_nucleo-l053r8/qk/armclang/README.txt

@@ -36,7 +36,7 @@ IRQ for that purpose. To choose a given IRQ, you need to define
 the macros QK_USE_IRQ_NUM and QK_USE_IRQ_HANDLER. These macros can
 be provided on the command-line to the compiler.
 
-For example, for the EFM32 CPU, you might dedicate the IRQ
+For example, for the STM32L053 MCU, you might dedicate the IRQ
 "CRYPTO_IRQHandler" (see the vector table), with IRQ number 25,
 as follows:
 
@@ -85,4 +85,3 @@ on the solder bridge configuration. Please see Chapter 5.7 "OSC clock" in
 the STM32 NUCLEO Boards User Manual (ST document UM1724) for more information.
 ***
 
-  

examples/arm-cm/dpp_nucleo-l053r8/qk/gnu/README.txt

@@ -37,11 +37,22 @@ for ARM Cortex-M projects, due to the support for the hardware FPU
 ***
 
 
-The TRUEStudio Project
+Selecting QK Exception
 ======================
-The project file for the Atollic TRUEStudio-STM32 is provided and can be
-directly imported into the TRUEStudio Eclipse-based IDE. All three build
-configurations are supported (Debug, Release and Spy).
+The QK kernel needs a dedicated exception to return to the thread
+context after preemption. The default is to use the NMI exception
+for that purpose. However, in case NMI is needed for some other
+purpose, the QK port allows you to select a any, otherwise unused
+IRQ for that purpose. To choose a given IRQ, you need to define
+the macros QK_USE_IRQ_NUM and QK_USE_IRQ_HANDLER. These macros can
+be provided on the command-line to the compiler.
+
+For example, for the STM32L053 CPU, you might dedicate the IRQ
+"CRYPTO_IRQHandler" (see the vector table), with IRQ number 25,
+as follows:
+
+QK_USE_IRQ_HANDLER=LCD_IRQHandler
+QK_USE_IRQ_NUM=30
 
 
 Adjusting Stack and Heap Sizes

ports/arm-cm/qxk/armclang/qxk_port.c

@@ -29,7 +29,7 @@
 * @file
 * @brief QXK/C port to ARM Cortex-M, ARM-CLANG toolset
 */
-/* This QXK port is part of the interanl QP implementation */
+/* This QXK port is part of the internal QP implementation */
 #define QP_IMPL 1U
 #include "qf_port.h"
 #include "qf_pkg.h"

ports/arm-cm/qxk/gnu/qxk_port.c

@@ -29,7 +29,7 @@
 * @file
 * @brief QXK/C port to ARM Cortex-M, GNU-ARM toolset
 */
-/* This QXK port is part of the interanl QP implementation */
+/* This QXK port is part of the internal QP implementation */
 #define QP_IMPL 1U
 #include "qf_port.h"
 #include "qf_pkg.h"