Infineon XMC1000 ARM Cortex-M0 Demo
Supporting IAR, Keil and GCC compilers
[RTOS Ports]
The XMC1300 boot kit
Introduction
This page describes a demo application for the Infineon XMC1000 range of ARM Cortex-M0
microcontrollers.
Pre-configured projects are provided for each of the following ARM Cortex-M0 compilers:
Each project contains three build configurations, with a a build configuration
for each of the following three XMC1000 evaluation boards:
Each build configuration can be further configured through the use of a #define
to create either a simply blinky style application, or a comprehensive test and demo
application.
Screen shot of the FreeRTOS state viewer plug-in
that ships with the IAR IDE
Note: If the IAR project fails to build then it is likely the version of IAR
Embedded Workbench being used is too old. If this is the case, then it is also
likely that the project file has been (silently) corrupted and will need to be
restored to its original state from the main FreeRTOS zip file download before it
can be built even after the EWARM version has been updated.
IMPORTANT! Notes on using the XMC1000 ARM Cortex-M0 Demo
Please read all the following points before using this RTOS port.
- Source Code Organisation
- The Demo Application
- RTOS Configuration and Usage Details
See also the FAQ My application does
not run, what could be wrong?
Source Code Organisation
The FreeRTOS download contains the source code for all the FreeRTOS ports, so
contains many more files than are needed by the XMC1000 demo.
See the Source Code Organization
section for a description of the downloaded files and information on creating a
new project.
Project files for all three supported compilers are located in the
FreeRTOS/Demo/CORTEX_M0_Infineon_XMC1000_IAR_Keil_GCC directory.
-
The IAR Embedded Workspace project is called RTOSDemo.eww.
-
The Keil project is called RTOSDemo.uvproj.
-
The Atollic project has the usual Eclipse project name .project.
Building and Running the ARM Cortex-M0 RTOS Application
The RTOS demo projects can be configured to run
a simple blinky style project, or a more comprehensive test and demo application. The
mainCREATE_SIMPLE_BLINKY_DEMO_ONLY setting at the top of main.c is used to select
between the two.
Set mainCREATE_SIMPLE_BLINKY_DEMO_ONLY to one to create the
basic Blinky demo. Set mainCREATE_SIMPLE_BLINKY_DEMO_ONLY to 0 to create
the more comprehensive test and demo application. Ensure to set the
mainCREATE_SIMPLE_BLINKY_DEMO_ONLY constant before building the project.
The demo uses the LEDs that are built onto the boot kit's PCB, so no
hardware setup is required. Any jumpers and switches should be left in their
default position.
The following sub-sections provide instructions on using each of the three
supported ARM Cortex-M0 compilers and tool chains.
-
Building with the IAR Embedded Workbench
-
Building with ARM Keil
-
Building with ARM GCC with the Atollic Eclipse IDE
-
Open FreeRTOS/Demo/CORTEX_M0_Infineon_XMC1000_IAR_Keil_GCC/RTOSDemo.eww in the
IAR Embedded Workbench IDE.
-
Set the build configuration to the correct option for your target hardware.
Build configurations are provided for the XMC1100, XMC1200 and XMC1300
boot kits. The active build configuration is set using the drop down list
at the top of the EWARM IDE's Workspace window.
-
Select "Rebuild All" from the IAR Embedded Workbench "Project" menu (or press F7) to build
the demo project.
-
Connect a USB cable between the USB port on the selected XMC1000 boot kit and the host computer.
-
Select "Download and Debug" from the IAR Embedded Workbench "Project"
menu to program the microcontroller flash memory and start a debug
session.
-
Open FreeRTOS/Demo/CORTEX_M0_Infineon_XMC1000_IAR_Keil_GCC/RTOSDemo.uvproj in the
Keil IDE.
-
Set the build configuration (called the Target in the Keil IDE)
to the correct option for your target hardware.
Build configurations are provided for the XMC1100, XMC1200 and XMC1300
boot kits. The active build configuration is normally shown in a drop
down list in the IDE's menu tool bar.
-
Select "Rebuild Target" from the Keil "Project" menu (or press F7) to build
the demo project.
-
Connect a USB cable between the USB port on the selected XMC1000 boot kit and the host computer.
-
Select "Start/Stop Debug Session" from the Keil "Project"
menu to program the microcontroller flash memory and start a debug
session.
Note the Eclipse project uses file references that are relative to the project's location.
The project, or any files it references, must not be
moved from their default positions in the FreeRTOS directory structure
(the directory structure that is created when the FreeRTOS download is unzipped).
-
Start the Eclipse IDE and either create a new or select an existing
workspace when prompted.
-
Select "Import" from the IDE's "File" menu. The dialogue box shown below
will appear. Select "General->Existing Project into Workspace", as shown below.
The dialogue box that appears when "Import" is first clicked
-
In the next dialogue box, select FreeRTOS/Demo/CORTEX_M0_Infineon_XMC1000_IAR_Keil_GCC
as the root directory. Make sure the RTOSDemo project is checked in the "Projects" area,
and that the Copy Projects Into
Workspace box is not checked, before clicking
the Finish button (see the image below for the correct check box states).
Make sure RTOSDemo is checked, and "Copy projects into workspace" is not checked
-
After the project has been imported, right click on the project name in the Eclipse project explorer window,
then use the "Build Configurations->Set Active" pop up menu item to set
the build configuration to the correct option for your target hardware.
Build configurations are provided for the XMC1100, XMC1200 and XMC1300
boot kits.
-
Select "Rebuild Project" from the Eclipse "Project" menu to build
the demo project.
-
Connect a USB cable between the USB port on the selected XMC1000 boot kit and the host computer.
-
Select "Debug" from the Eclipse "Run"
menu to configure a launch configuration that can be used to program the
microcontroller flash memory and start a debug session.
Demo Application Functionality
Functionality with mainCREATE_SIMPLE_BLINKY_DEMO_ONLY set to 1
Building with mainCREATE_SIMPLE_BLINKY_DEMO_ONLY set to 1 causes main() to call
main_blinky(). main_blinky() sets up a very simple demo, as
described below.
-
The main_blinky() Function:
main_blinky() creates one queue, and two tasks. It then starts the
scheduler.
-
The Queue Send Task:
The queue send task is implemented by the prvQueueSendTask() function in main_blinky.c.
prvQueueSendTask() sits in a loop that causes it to repeatedly block for
200 milliseconds before sending the value 100 to the queue that was created
within main_blinky().
-
The Queue Receive Task:
The queue receive task is implemented by the prvQueueReceiveTask() function
in main_blinky.c. prvQueueReceiveTask() sits in a loop repeatedly blocking on
an attempt to read data from the queue that was created within main_blinky(). When data
arrives the task automatically unblocks, checks the value of the data, and if the value equals
the expected 100, toggles an LED.
The 'block time' parameter passed to
the queue receive function specifies that the task should be held in the Blocked
state indefinitely to wait for data to be available on the queue. The queue
receive task will only leave the Blocked state when the queue send task writes
to the queue. As the queue send task writes to the queue every 200
milliseconds, the queue receive task leaves the Blocked state every 200
milliseconds, and therefore toggles the LED every 200 milliseconds.
Functionality with mainCREATE_SIMPLE_BLINKY_DEMO_ONLY set to 0
Building with mainCREATE_SIMPLE_BLINKY_DEMO_ONLY set to 0 causes main() to call
main_full(). main_full() sets up a more comprehensive test and demo application,
as described below.
-
The main_full() Function:
main_full() creates a set of standard demo tasks, some application specific
test tasks, and a timer. It then starts the
scheduler.
-
The "Reg Test" Tasks:
These fill the registers with known values, then check
that each register maintains its expected value for the lifetime of the
task. Each task uses a different set of values. The reg test tasks execute
with a very low priority, so get preempted very frequently. A register
containing an unexpected value is indicative of an error in the context
switching mechanism.
-
The "Interrupt Semaphore Take" Task
This task does nothing but block on a semaphore that
is 'given' from the tick hook function (which is defined in main.c). It
toggles LED 4 each time it receives the semaphore. The Semaphore is
given every 50ms, so LED 4 toggles every 50ms.
-
The "Check" software Timer:
The check software timer period is initially set to three
seconds. Its callback function checks that all the standard demo tasks, and
the register check tasks, are not only still executing, but are executing
without reporting any errors. If the check timer callback discovers that a
task has either stalled, or reported an error, then it changes the period of
the check timer from the initial three seconds, to just 200ms. The callback
function also toggles LED 5 each time it is called. This provides a visual
indication of the system status: If LED 5 toggles every three seconds,
then no issues have been discovered. If the LED toggles every 200ms, then
an issue has been discovered with at least one task.
Interrupt service routines
Interrupt service routines that cause a context switch have
no special requirements.
The macro portEND_SWITCHING_ISR() can be used to request a context switch from within an ISR.
Note that portEND_SWITCHING_ISR() will leave interrupts enabled.
A dummy interrupt handler
called Dummy_IRQHandler() is provided at the end of main.c as a reference implementation.
Dummy_IRQHandler() is also replicated below.
void Dummy_IRQHandler(void)
{
long lHigherPriorityTaskWoken = pdFALSE;
/* Clear the interrupt if necessary. */
Dummy_ClearITPendingBit();
/* This interrupt does nothing more than demonstrate how to synchronise a
task with an interrupt. A semaphore is used for this purpose. Note
lHigherPriorityTaskWoken is initialised to zero. Only FreeRTOS API functions
that end in "FromISR" can be called from an ISR! */
xSemaphoreGiveFromISR( xTestSemaphore, &lHigherPriorityTaskWoken );
/* If there was a task that was blocked on the semaphore, and giving the
semaphore caused the task to unblock, and the unblocked task has a priority
higher than the current Running state task (the task that this interrupt
interrupted), then lHigherPriorityTaskWoken will have been set to pdTRUE
internally within xSemaphoreGiveFromISR(). Passing pdTRUE into the
portEND_SWITCHING_ISR() macro will result in a context switch being pended to
ensure this interrupt returns directly to the unblocked, higher priority,
task. Passing pdFALSE into portEND_SWITCHING_ISR() has no effect. */
portEND_SWITCHING_ISR( lHigherPriorityTaskWoken );
}
Note that the following lines are included in FreeRTOSConfig.h to map the FreeRTOS
interrupt handler function names onto the CMSIS interrupt handler function names.
This allows the linker scripts provided by the compiler tool vendors to be used
without modification.
#define vPortSVCHandler SVC_Handler
#define xPortPendSVHandler PendSV_Handler
#define xPortSysTickHandler SysTick_Handler
RTOS port specific configuration
Configuration items specific to these demos are contained in FreeRTOS/Demo/CORTEX_M0_Infineon_XMC1000_IAR_Keil_GCC/FreeRTOSConfig.h. The
constants defined in FreeRTOSConfig.h can be edited to meet the needs of your application. In particular -
Each port #defines 'BaseType_t' to equal the most efficient data type for that
processor. All ARM Cortex-M0 ports define BaseType_t to be of type long.
Note that vPortEndScheduler() has not been implemented.
Switching between the pre-emptive and co-operative RTOS kernels
Set the definition configUSE_PREEMPTION within FreeRTOS/Demo/CORTEX_M0_Infineon_XMC1000_IAR_Keil_GCC/FreeRTOSConfig.h to 1 to use pre-emption or 0
to use co-operative.
Memory allocation
Source/Portable/MemMang/heap_4.c is included in the ARM Cortex-M0 demo application project to provide the memory
allocation required by the RTOS kernel.
Please refer to the Memory Management section of the API documentation for
full information.
Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.
|