SYS/BIOS 6.30.02.42 Patch Release Notes

This release note is divided into the following sections:

Introduction, Documentation, What's New, Upgrading And Compatibility Information, Host Support, Dependencies, Device Support, Validation Information, Known Issues, Benchmarks, Versioning, Technical Support And Product Updates,


Introduction

SYS/BIOS 6.30.02.42 is a Patch release of SYS/BIOS 6.30.

SYS/ BIOS is a real-time operating system that provides pre-emptive deterministic multithreading. The SYS/BIOS 6.x releases introduce a completely new SYS/BIOS kernel and toolset. The SYS/BIOS 6.x releases include numerous major enhancements, including completely new kernel APIs. They also include compatibility layers and tooling to facilitate easy porting of applications developed on DSP/BIOS 5.x releases.

A number of tools and libraries that were provided as an integrated part of DSP/BIOS 5.x releases must now be downloaded separately to obtain a functional solution. It is essential for even experienced DSP/BIOS users to refer to the Getting Started Guide and to the Upgrading and Compatibility Information section for further details.

Please read the Getting Started Guide for help installing and setting up your environment to use SYS/BIOS 6.30.02.42.

back to top

Documentation

The following documentation is provided with this release:

Release notes from previous releases are also available in the release notes archive directory.

back to top

What's New

SYS/BIOS 6.30.02.42 Patch Release (this release).

This release is based on DSP/BIOS 6.30.01. 

Notes on this release:

Defects Fixed:
    ID                               Headline
    SDOCM00073239    BIOS 6: move Queue module into knl package, deprecate misc.Queue
    SDOCM00073179    BIOS 6: logic for binding the TimestampProvider in ti.sysbios.xdcruntime.Settings is flawed
    SDOCM00073115    Hwi_getFunc is broken - uses incorrect Handle to get to function
    SDOCM00073064    update Mailbox to remove dependancy on HeapBuf
    SDOCM00072947    BIOS 6: unicache Cache APIs don't wait for completion properly on OMAP4430 Tesla core
    SDOCM00072946    (OMAP4 and DM8168 dual-M3 issue) BIOS 6 unicache Cache_wbAll() API is broken -- other Cache APIs OK.
    SDOCM00072869    legacy app note module map table (table 1 in section 4.1) needs some modifications
    SDOCM00072815    Update BIOS to use 3.3.0 codegen for MSP430
    SDOCM00072647    Need Swi_getFunc
    SDOCM00072569    need to document Semaphore_reset() which is currently a hidden API (remove @nodoc tag)
    SDOCM00072352    add support for DM355 (Arm9) for BIOS 6.x
    SDOCM00072337    AMMU module endianness configuration option is not supported in hardware.
    SDOCM00072238    BIOS UG erroneously refers to Task_checkstacks()
    SDOCM00072079    add support for C6A8168
    SDOCM00071906    update C6x/ELF targets to use 7.1.0B2 codegen for ELF targets (not COFF)
    SDOCM00071804    BIOS UG should explain that Swis can be created from main()
    SDOCM00071586    Updates needed to Memory chapter in BIOS UG
    SDOCM00071539    add BIOS support for DM8148
    SDOCM00071153    Need examples for 28x
    SDOCM00070411    Unicache module should have ROV view
    SDOCM00070088    BIOS dispatcher should set TSR.XEN so that exceptions that happen during ISR context will be caught immediately
    SDOCM00046879    GateAll should call Swi_disable() so that it disables all scheduling and allows scheduler calls within the gate
    SDOCM00046393    BIOS 6 Task_delete() has restrictions that BIOS 5 TSK_delete() doesn't
    SDOCM00046269    Tesla and Ducati BIOS exception handlers should dump register set.
    SDOCM00046161    BIOS 6 hal.Hwi module hooks array should be meta-only so as not to take up target footprint
    SDOCM00046101    Timer_setPeriod,Timer_extFreq,Timer_setPeriodMicrosec doesn't take user defined frequency   
back to top

Upgrading and Compatibility Information

SYS/BIOS 6.x releases have many significant changes from DSP/BIOS 5.x.  It is important to understand the information below in order to successfully use SYS/BIOS 6.x and to migrate applications from DSP/BIOS 5.x.

DA830 ROM

BIOS 6.30 cannot be used with the DA830 ROM.  BIOS 6.21 is the preferred version for DA830 ROM.

The 'ti.sdo.io' and 'ti.sdo.utils' packages are no longer provided with SYS/BIOS

These packages are now provided in a separate "IPC" product.  Users of these packages simply need to add this other product directory to their package path (XDCPATH) to build their applications.

The ti.sysbios.ipc package and its modules have been deprecated

The Semaphore, Event, and Mailbox modules were moved from the ti.sysbios.ipc package into the ti.sysbios.knl package. Please update your applications to use the ti.sysbios.knl package versions of the Semaphore, Event, and Mailbox modules. Using the ipc package versions of these modules will result in build warnings. In a subsequent release of BIOS, using any module within the ipc package will result in a build error.
   
The ti.sysbios.family.arm.m3.Exception module has been deprecated

The ti.sysbios.family.arm.m3.Exception module functionality has been enhanced and merged into the ti.sysbios.family.arm.m3.Hwi module. Please update your applications to use the ti.sysbios.family.arm.m3.Hwi module to configure exception handling. By default, exceptions will be reported to CIO with an Error message. Details of the exception can be seen using Hwi module's "Exception" ROV view. At the expense of additonal code size, some of this detailed information can ALSO be routed to the CIO console by setting the Hwi.enableException configuration flag to true.

Placing of sections using MEM configs is no longer supported (ie MEM.TEXTSEG is unsupported)

All of the legacy MEM memory segment placment functionality has been removed. Legacy BIOS users must use Program.sectMap to place memory sections.

The ti.sysbios.family.c64p.Cache.initSize configuration item is no longer supported

The ti.sysbios.family.c64p.Cache module no longer supports setting the Cache sizes. These settings are now managed within a platform and can be configured using the platform wizard.

SYS/BIOS no longer contains all the tools and objects you will need

The XDC tools now provide the SYS/BIOS configuration tools and Platform support. XDC also includes a minimal run-time environment that provides the LOG, System, Asserts, Error handling, Timestamp, and Memory Allocation APIs that will be used by SYS/BIOS applications.  Please refer to the Getting Started Guide on where to download the XDC tools and run-time.

Migrating DSP/BIOS 5.x applications to SYS/BIOS 6.x

SYS/BIOS 6.x has different APIs compared to those in DSP/BIOS 5.x. Configuration scripts are also incompatible between the two releases.  To provide easy migration of DSP/BIOS 5.x applications, an API compatibility layer is provided along with a conversion tool that converts configuration scripts to work with XDC and SYS/BIOS 6.x.  The API compatibility layer provides 100% C source code compatibility with the exception of a few APIs that are no longer supported.  For more complete details of migrating DSP/BIOS 5.x applications and configuration scripts, please refer to Migrating a DSP/BIOS 5 Application to SYS/BIOS 6.

As mentioned above, some APIs previously supported in DSP/BIOS 5.x releases will no longer be supported in this release or the compatibility layer.  Complete details are provided in the Migration document referenced above.

back to top

Host Support

back to top

Dependencies

back to top

Device Support

Click here  for the list of supported devices.
 
back to top

Validation Information

Click here for the list of compilers used to build and validate this release (scroll down to Supported Targets section).

back to top

Known Issues

The following issues are known to affect this release:

    ID                               Headline
    SDOCM00071397    Review supported device list in release notes - msp430 device list is missing
    SDOCM00071153    Need examples for 28x
    SDOCM00069680    BIOS legacy app note updates for 6.30
    SDOCM00070088    BIOS dispatcher should set TSR.XEN so that exceptions that happen during ISR context will be caught immediately
    SDOCM00068360    No data displayed in RTA Exec Graph when attaching to running target
    SDOCM00064397    RTA crashes CCS 4.1 after a few reset/reload with USB emulator
    SDOCM00046756    BIOS6 doesn't have MPC module

back to top

Benchmarks

    For a full description of Benchmarks please see the appendices in the SYS/BIOS 6 User's Guide. back to top

Versioning

All releases have 4 digits (M.mm.pp.bb). This includes GA and pre-releases (engineering, alpha/EA, beta, etc.). Pre-releases are denoted with a suffix (e.g. 6.30.00.00-eng or 6.30.00.10-beta).


This product's version follows a version format, M.mm.pp.bb, where M is a single digit Major number, mm is 2 digit minor number, pp is a 2 digit patch number, and b is an unrestricted set of digits used as an incrementing build counter.

To support multiple side-by-side installations of the product, the product version is encoded in the top level directory (e.g. bios_6_30_00_00).

Subsequent releases of patch upgrades will be identified by the patch number, ex. SYS/BIOS 6.30.01.15 with directory bios_6_30_01_15. Typically, these patches only include critical bug fixes.

Please note that version numbers and compatibility keys are NOT the same. For an explanation of compatibility keys, please refer to the 'Upgrade and Compatibility Information' section.

back to top

Technical Support and Product Updates

back to top

Last updated: August 09, 2010 Build Ver: 6.30.02.42 Rev: f42