Enhancment to Segger Ozone allowing kernel awarness debugging for Micrium μC/OS-III.
- Project Status
- Getting Started
- Release Process
- How to Get Help
- Further Reading
- Contributing
- License
- Authors
- Acknowledgements
Plugin currently supports displaying information for the following
- Task(s)
- Timers(s)
- Queue(s)
- Mutex(s)
- Semaphore(s)
- Memory Partition(s)
- Flag Group(s)
- System Information
The following section will discuss the steps required to get started setting up Segger Ozone and how to install the μC/OS-III kernel awareness plugin.
A recent version of Segger Ozone is required for using μC/OS-III kernel awareness plugin. The latest version can be obtained directly from Segger's website. Select a version of Ozone compatible with your operating system.
Two methods are provided to obtain the kernel awareness plugin.
The latest stable release can always be found on GiHub Release page. Simply download and extract the zip to a location on your computer.
The development version is hosted on GitHub and can be cloned directly using the following command:
git clone git@github.com:SDA-Labs/uC-OS3-Ozone.git
To use μC/OS-III kernel awareness plugin within Segger Ozone, first Ozone must be installed followed by placing μC/OS-III kernel awareness plugin in a specific installation directly.
After downloading Segger Ozone, follow the platform specific instructions for installing Ozone.
After Segger Ozone is installed, μC/OS-III kernel awareness plugin can be installed.
First close Segger Ozone if it is open. Next copy uC-OS3Plugin.js from the extracted zip file or cloned repository to Ozone's OS plugin folder. For Microsoft Windows this is normally found at <USER INSTALL PATH>\SEGGER\Ozone\Plugins\OS.
Enabling kernel awareness debugging in Ozone requires first to load the plugin into Ozone, followed by enabling the plugin. Start Segger Ozone and enter the following into the console
Project.SetOSPlugin("uC-OS3Plugin")
Then press enter. If successful the console will output something similar to the following
Project.SetOSPlugin ("uC-OS3Plugin");
File name resolved: "uC-OS3Plugin.js" was found at "<USER INSTALL PATH>/SEGGER/Ozone/Plugins/OS/uC-OS3Plugin.js"
RTOS awareness plugin loaded: <USER INSTALL PATH>/SEGGER/Ozone/Plugins/OS/uC-OS3Plugin.js.
Next to enable the plugin, select uC-OS3 under the view menu.
View > Advanced > uC/OS-III
Upon selecting uC/OS-III, Ozone will default to displaying the task list within kernel awareness window.
μC/OS-III kernel awareness plugin is designed to show detailed information of the runtime performance of μC/OS-III when paused. Currently the following displays are supported
- Task(s)
- Timers(s)
- Queue(s)
- Mutex(s)
- Semaphore(s)
- Memory Partition(s)
- Flag Group(s)
- System Information
By default when activated only the task display will be shown. To enable additional displays, or remove a display, right click within the kernel awareness window and select one of the available options. If the option is enabled it will be disabled, otherwise the option will be enabled.
New releases will be made as bugs are fixed or new features are added. New releases will be tagged and made available through GitHub.
This project uses the following format for versioning
MAJOR.MINOR
MAJOR will be update after addition of a new feature or enhancement and MINOR will be updated after a bug fix. An update to MAJOR will always reset MINOR to 0. Available versions can be viewed at the repository tag list.
To request help, open a issue through GitHub Issues.
New enhancements, features, and bug reports should be reported using GitHub Issues.
Copyright (c) 2021 SDA Labs
This project is licensed under the MIT License - see LICENSE.md file for details.
- Sean Alling - Initial work - SDA Labs