• State Resolved
  • Locked Locked
  • Replies 1 reply
  • Subscribers 97 subscribers
  • Views 304 views
  • Users 0 members are here
Support feedback
Options
Options
Related

This thread has been locked.

If you have a related question, please click the "Ask a related question" button in the top right corner. The newly created question will be automatically linked to this question.

sysbios missing documentation for ti.sysbios.misc

Brad Griffis
Guru*** 125430 points
Other Parts Discussed in Thread: SYSBIOS

In cdoc we do not have any documentation for ti.sysbios.misc.  The Bios_Legacy_App_Note.pdf lists ti.sysbios.misc.Queue and ti.sysbios.misc.Stats as the replacements for QUE and STS respectively, yet we have no documentation!  I see there's also ti.sysbios.misc.Intrinsics.  Why are none of these documented?

  • 0
    TI__Mastermind 20805 points

    I filed a CQ to update that table in the legacy app note.  CQ id is SDOCM00072869.  We should be able to fix for 6.30.02 (release on/about Aug 9) which will feed into CCSv4.2.

    We recommend 'ti.sdo.utils.List' as the replacement for QUE.  List is a more complete and rational API than QUE and Queue.   All of the List APIs take a handle.  And List_get() returns NULL if list is empty -- whereas QUE_get() would return the QUE_Handle if queue was empty and code had to compare the return value against the QUE_Handle.  We've had debate internally if we should document the Queue module as well, but we would prefer people move to 'ti.sdo.utils.List'.  I suppose if we document Queue, we could have reference to 'ti.sdo.utils.List' as a better and recommended API.

    The STS row should say "None" for "Recommended SYS/BIOS 6 Module"; "Yes" for "Legacy APIs Supported?"; and "No RTA tooling support.  Legacy APIs provided to support rebuild only.  No STS tooling support".

    Intrinsics is an internal module used by the Task and Swi modules.  It only contains single maxbit() API and this module is not useful for general customers.