SYS/BIOS (TI-RTOS Kernel)

1 SYS/BIOS (TI- rtos Kernel) User's GuideLiterature Number: SPRUEX3 TMay 2017 SPRUEX3T May 2017 Contents2 Submit Documentation Feedback ContentsPreface .. 91 About SYS/BIOS .. is SYS/BIOS ? .. are SYS/BIOS and TI- rtos Related? .. are SYS/BIOS and XDCtools Related? .. as a Set of Packages .. SYS/BIOS Using XDCtools .. Modules and Runtime APIs .. Packages and APIs.. Object Creation .. Thread Support .. C++ with SYS/BIOS .. Management .. Mangling .. Class Methods from the Configuration.. Constructors and Destructors.

2 More Information .. the API Reference Help System .. 252 SYS/BIOS Configuration and Building .. a SYS/BIOS Project with the TI Resource Explorer .. SYS/BIOS Support to an Existing Project.. SYS/BIOS Applications .. a Configuration File with XGCONF .. Tasks with XGCONF .. the Configuration .. the XGCONF views .. the Available Products View .. the Outline View.. the Property View .. the Problems View.. and Fixing Errors.. Accessing the Global Namespace .. SYS/BIOS Applications .. the Build Flow .. for Working with CCS Project Properties.

3 An Application with GCC .. and Debugging an Application in CCS .. and Linker Optimization .. 463 Threading Modules .. Startup Sequence .. of Threading Modules .. 50 SPRUEX3T May 2017 Contents3 Submit Documentation Feedback of Threads .. Which Types of Threads to Use .. Comparison of Thread Characteristics .. Priorities.. and Preemption .. SYS/BIOS on SMP Systems .. Interrupts .. Hwi Objects .. Interrupt Nesting and System Stack Size .. Hooks .. Interrupts .. Swi Objects .. Software Interrupt Priorities.

4 Interrupt Priorities and System Stack Size .. of Software Interrupts .. a Swi Object s Trigger Variable .. and Tradeoffs.. Swi Functions .. Hooks .. Tasks.. Execution States and Scheduling .. Stacks .. for Stack Overflow.. Hooks .. Yielding for Time-Slice Scheduling .. Idle Loop .. Using Hwi, Swi, and Task Threads .. 1034 Synchronization Modules .. Example .. Module .. Posted Events .. Gate Implementations .. Gate Implementations.. Inversion .. the SYS/BIOS Gate Type .. FIFO Operation of a Queue.

5 Over a Queue .. and Removing Queue Elements .. Queue Operations .. 1275 Timing Services .. of Timing Services .. 1294 Contents SPRUEX3T May 2017 Submit Documentation Module .. Module .. Module .. 1346 Support Modules .. for Application Support and Management .. Module .. Module .. Module .. Module .. Module .. Module .. Module .. Module .. Module .. 1427 Memory .. Map .. an Available Platform.. a Custom Platform.. Sections into Memory Segments .. Simple Section Placement .. Section Placement Using a SectionSpec.

6 A Supplemental Linker Command File.. Linker Command File and Customization Options .. and Memory Mapping for MSP430, Stellaris M3, and C28x .. Stack .. Stacks .. Configuration .. Cache Size Registers at Startup .. Parameters to Set MAR Registers .. Runtime APIs .. Memory Allocation .. Policy .. the Default System Heap .. the Module .. a Heap for Module Dynamic Instances .. malloc() and free() .. Implementations .. 1668 Hardware Abstraction Layer .. Abstraction Layer APIs.. Module .. a C Function with a System Interrupt Source.

7 169 SPRUEX3T May 2017 Contents5 Submit Documentation Feedback Instance Configuration Parameters .. a Hwi Object Using Non-Default Instance Configuration Parameters .. and Disabling Interrupts .. Simple Example Hwi Application .. Interrupt Dispatcher .. Saved and Restored by the Interrupt Dispatcher.. Target/Device-Specific Hwi Module Functionality .. Module .. Timer Modules .. Module.. Interface Functions .. Package Organization .. 1829 Instrumentation .. of Instrumentation .. Module .. Module Configuration.

8 Load Statistics .. Handling.. Tools in Code Composer Studio .. Optimization .. Logging.. Diagnostics .. a Heap Manager .. Configuration.. Checking .. 192 ARebuilding SYS/BIOS .. SYS/BIOS Using the Makefile .. Your Project Using a Rebuilt SYS/BIOS .. 197 BTiming Benchmarks .. Benchmarks .. Latency .. Interrupt Benchmarks .. Interrupt Benchmarks .. Benchmarks .. Benchmarks .. 203 CSize Benchmarks .. Application Sizes .. Task Application .. Semaphore Application .. Mutex Application .. Clock Application.

9 Module Application Sizes .. Task Application.. Semaphore Application .. 2126 Contents SPRUEX3T May 2017 Submit Documentation Mutex Application.. Clock Application .. Application Sizes .. Pthread Application .. Semaphore Application .. Mutex Application.. Timer Application .. 214 DMinimizing the Application Footprint .. Data Size .. the malloc Heap .. the Size of Stacks .. the Default Task Stack Size.. Named Modules .. Text Strings Off the Target .. the Number of atexit Handlers .. Code Size .. the Custom Build SYS/BIOS Libraries.

10 Logging .. Memory Policies .. Core Features .. printf() .. RTS Thread Protection .. Task Stack Overrun Checking .. Exception Management .. Size Benchmark Configuration Script .. 220 EDeprecated Input/Output Modules .. Drivers and TI- rtos .. of the GIO Model .. Drivers in the Device Table .. the GIO Module .. GIO APIs .. When Using GIO APIs .. and Deleting GIO Channels .. GIO_read() and GIO_write() The Standard Model .. GIO_issue(), GIO_reclaim(), and GIO_prime() The Issue/Reclaim Model .. () and Error Handling.