| CMSIS-RTOS RTX Version 4.75 CMSIS-RTOS RTX: Real-Time Operating System for Cortex-M processor-based devices

- RTX

- Main Page
- Usage and Description
- Reference

SVC Functions

Software Interrupt (SVC) functions run in Privileged Handler Mode of the Cortex-M core. SVC functions accept arguments and can return values. The functions are used in the same way as other functions; however, differences are hidden to the user. The ARMCC compiler handles the differences and generates code instructions to call SVC functions. SVC functions are called by executing the SVC instruction. When executing SVC instructions, the controller changes to the Privileged Handler Mode.

Interrupts are not disabled in this mode. To protect SVC function from interrupts, you need to include the disable/enable intrinsic functions __disable_irq() and __enable_irq() in your code.

You can use SVC functions to access protected peripherals, for example, to configure NVIC and interrupts. This is required if you run tasks in unprivileged (protected) mode and you need to change interrupts from the task.

To implement SVC functions in your CMSIS-RTOS RTX kernel project, you need to:

1. Copy the file SVC_Table.s to your project folder and include it into your project. This file is available as a source code template.
2. Declare a function with a __svc(x) attribute. Use the first SVC number, starting from 1, that is free.
   void __svc(1) inc_5bit (U32 *cp);
3. Write a function implementation and convert the function name into a __SVC_x function name. Later, this name is referenced by the linker from the SVC_Table.s module. You also need to disable/enable interrupts.
   void __SVC_1 (U32 *cp) {
   // A protected function to increment a 5-bit counter.
   __disable_irq();
   *cp = (*cp + 1) & 0x1F;
   __enable_irq();
   }
4. Add the function __SVC_x to the SVC function table in the SVC_Table.s module. First import it from other modules:
   ; Import user SVC functions here.
   IMPORT __SVC_1
   Then, add a reference to it into the table:
   ; Insert user SVC functions here. SVC 0 used by RTL Kernel.
   DCD __SVC_1 ; user SVC function
5. Your SVC function should now look like this:
   void __svc(1) inc_5bit (U32 *cp);
   void __SVC_1 (U32 *cp) {
   // A protected function to increment a 5-bit counter.
   __disable_irq();
   *cp = (*cp + 1) & 0x1F;
   __enable_irq();
   }

Note
  - SVC function 0 is reserved for the CMSIS-RTOS RTX kernel.
  - Do not leave gaps when numbering SVC functions. They must occupy a continuous range of numbers starting from 1.
  - SVC functions can still be interrupted.
  - CMSIS-RTOS RTX must not be called before the main() function.