If your systems' real-time behavior would be noticeably affected by the tracing when using J-Link RTT streaming, this is most likely caused by insufficient throughput, causing the J-Link RTT transfer to block execution. If it works good in snapshot mode, the streaming mode should normally be even faster, otherwise there is blocking in the streaming channel. [...]
The improved trace recorder library is the biggest change in Tracealyzer v3.1, at least for FreeRTOS, Micrium and SafeRTOS. We have merged snapshot and streaming support into a single recorder module that support both modes, and improved the API and documentation to make it easier to use. If you are using an older version of the [...]
Software-based tracing always means some processing overhead, where the exact amount is f x e, where f is the average event frequency and e is the average execution time for storing an event. This is very dependent on your application and processor. The more RTOS calls, the larger overhead. The faster processor, the less overhead. Let's put in some [...]
Floating network licenses offer a flexible licensing solution for most development teams. With a floating license, you can install the tool on any number of computers, but the number of concurrent users is limited by the license server. Our floating licenses have a linger time, i.e., a minimum session time during which the license is [...]
If asserts are enabled the recorder configuration (trcConfig.h), this error is generated in uiTraceGetPriorityProperty when a task has an "object handle" value larger than expected. Our FreeRTOS recorder assignes each task an 8-bit "object handle" (the "id" parameter in uiTraceGetPriorityProperty), which should be in the range [1..NTask]. The NTask constant is defined in trcConfig.h and [...]
Our Tracealyzer versions for microcontroller RTOS uses Percepio's own recorder library, which uses separate definitions for critical sections within the recorder. This since the standard critical sections offered by some RTOS kernels, like portENTER_CRITICAL/portEXIT_CRITICAL in FreeRTOS, might not safe to use from interrupt (kernel) context. Some recorder functions are called both from task-level and interrupt-level [...]
The upcoming version 2.7 of FreeRTOS+Trace contains a demo project for Keil µVision and the STM32F400. Related to this, we like to highlight a smart solution for how to save the trace data in Keil µVision, provided by our partner Antycip. Many thanks, Julien! If you don't have a J-Link or Atmel SAM-ICE debugger (for [...]
To trace the execution of exception/interrupt handlers (ISRs), you need to call vTraceStoreISRBegin and vTraceStoreISREnd in the beginning and in the end of the handler function. The vTraceStoreISREnd routine normally assumes a return to the previously executing task. But sometimes another ISR is pending and executes in direct sequence, making this assumption incorrect. For instance, ARM Cortex-M devices [...]
If you get this error when compiling the recorder, you are probably using an older version of FreeRTOS (v7.5.x or earlier) together with a newer version of the recorder library. The FreeRTOS variable 'uxPendedTicks' was before v7.5.2 named 'uxMissedTicks', so you need to replace uxPendedTicks with uxMissedTicks in the definition of traceTASK_INCREMENT_TICK in trcKernelPort.h Update: [...]
This means that something that appears to be trace data was found in the RAM dump, but with some difference in the expected data format. This typically occurs if you are using an older version of the application (e.g, FreeRTOS+Trace or µC/Trace) with a newer version of the recorder. We have received several questions about [...]
If you have a node-locked license for a Percepio Tracealyzer software and wish to move it to another computer, please complete Percepio License Migration Request and send a signed copy to support@percepio.com.
Tracealyzer for Linux displays the scheduling priority reported by LTTng. For Linux processed with "normal" dynamic scheduling, this value is typically not meaningful. This is mainly intended for processes with static real-time priorities.
Tracealyzer for VxWorks uses the same data source as System Viewer in Wind River Workbench, but provides a more powerful visualization featuring over 20 different views that all are interconnected in clever ways. Tracealyzer is more intuitive to use and gives a much better understanding of your system. Some unique features of Tracealyzer are: Trace [...]
The recorder library can be used on any 32-bit microcontroller system that meets the following requirements: Contains a high resolution time source (a timer/counter or similar). Only read access is required, so the OS tick timer can be used. 16 KB of Flash available (can be scaled down to 6 KB in minimum configuration) At [...]
If you have a J-Link debug probe, the viewer application can access this directly to download the trace. In other case, most debugger are able to store RAM contents to a file that can be read by FreeRTOS+Trace, SafeRTOS+Trace and µC/Trace. Binary (".bin"), Intel Hex (".hex") and ".mch" formats are supported. These can be generated [...]
It depends if you are using snapshot recording or streaming. Snapshot recording requires a decent RAM buffer, if you want a long trace. A RAM buffer of 5-10 KB can give a trace of 50-200 ms, depending on the rate of events in you system. If you have more RAM available, you can get traces of a [...]
The below table shows an example, using version 2.5.1 of the recorder library, compiled for ARM Cortex M4 (Atmel SAM4S16C) using ARM GCC v4.7.3. Recorder configuration Compiler optimization Flash usage Basic features -Os (minimum size) 5,788 byte Basic features -O3 (maximum speed) 6,840 byte All features -Os (minimum size) 13,368 byte All features -O3 (maximum [...]
Interrupt handlers (ISRs) are not recorded by default. To record ISRs, you need to add two calls in the interrupt handlers you wish to record, vTraceStoreISRBegin in the very beginning and vTraceStoreISREnd in the very end. See trcUser.h for further information. The parameter of vTraceStoreISRBegin is a unique numeric ISR ID that you select yourself, [...]
You need to set a name for the ISR using vTraceSetISRProperties, otherwise the numeric ID stored using vTraceStoreISRBegin is displayed.
If you have interrupt handlers using interrupt-level kernel functions, but are not calling vTraceStoreISRBegin and vTraceStoreISREnd, the recorder assumes that the kernel call was made from an interrupt handler, but does not know the identity of the interrupt handler. In this case, the name is set to "ISR using ", where is the queue or [...]
Use vTraceSetQueueName, vTraceSetSemaphoreName or vTraceSetMutexName, as in the below example: actuatorQ = xQueueCreate(3, sizeof(QueueMessage) ); if (actuatorQ != NULL) { vTraceSetQueueName(actuatorQ, "ActuatorQueue"); // Set the name ... } else { ... // Error handling }
Check the following things: 0) Are you using an updated OS kernel with the instrumentation needed by the recorder? 1) Has the trace initialization function been called? This must be called early, before calling any kernel or recorder function. 2) Has the trace recorder been started/triggered? 3) Have you integrated the recorder properly in your [...]
If using memory protection (MPU) on ARM Cortex-R4 devices, the debugger can't read kernel-space data (including the trace data) when in user-space code. If this is the case, your trace file (RAM dump) will only contain the byte pattern 0xBAD0BAD0 instead of the trace data. If you experience this problem, make sure to break the [...]
Our Trace Recorder Library used for FreeRTOS+Trace, SafeRTOS+Trace and Micrium µC/Trace is quite easy to port, as we have made a significant effort to generalize it. All kernel-specific definitions are located in trcKernelPort.c/.h, but you need to insert instrumentation in the kernel and add new fields to the kernel object data types. We welcome new [...]
There is a comprehensive guide in the FreeRTOS+Trace User Manual, Section 2. If you have any questions after reading this, do not hesitate to contact support@percepio.com.
Percepio is a member of the FreeRTOS+ program, intended for commercial add-ons to FreeRTOS. The name FreeRTOS+Trace is a trademark of Percepio AB and is used with permission from Richard Barry at FreeRTOS.org/Real Time Engineers, Ltd.
Wittenstein High Integrity Systems (formally Wittenstein Aerospace and Simulation Ltd.) is a partner of Percepio and exclusive distributor for SafeRTOS+Trace. SafeRTOS+Trace is a trademark of Wittenstein Aerospace and Simulation Ltd.
Micrium is a partner of Percepio and exclusive distributor for the µC/Trace product. µC/Trace is a trademark of Micrium, Inc.
The first version of Tracealyzer was created in 2004, during Dr. Kraft's PhD work at Mälardalen University. A simple trace visualization was needed to verify schedling simulations, but when ABB Robotics began using the tool systematically in 2005 (on VxWorks), the project started its evolution into something much larger. Between 2005 and 2008, the tool [...]
The name is latin and means "to percieve", i.e., to see, understand or sense.