WinCE Utils 1.00.02 Release Notes

September 2009

This WinCE Utils Release is targetted for the various DaVinci- and OMAP-based platforms running WinCE, but is generally usable for any WinCE-based system.

Introduction, CMEM, Documentation, What's New, Upgrade Info, Compatibility Information, Device Support, Validation Info, Known Issues, Examples, Version Information, Technical Support.

---

Introduction

The WinCE Utils utility package provides the ability for user-mode applications to access the CMEM utility libraries.

CMEM

The CMEM (Contiguous Memory) utility library provides the ability for user-mode applications to allocate and free blocks of physically contiguous memory. This is typically done to manage multimedia data buffers which will be worked on by multimedia algorithms, but the memory provided by this library can be used for any purpose.

The reason multimedia algorithms often require physically contiguous memory is that sometimes they're on another processor which may not contain an MMU (e.g. the C64P processor on a DM644x device), and/or WinCE-based algorithms utilize hardware accelerators (e.g. DMA, image co-processors, etc) which don't access memory through an MMU.

The CMEM module consists of the following packages:

• ti.sdo.winceutils.cmem - The CMEM user-mode library and kernel mode driver.

The CMEM module supports the following devices:

• all supported platforms for this release

---

Documentation

The following documentation is available:

• WinCE Utils Application Programming Interface (API) Reference Guide (HTML | CHM)
• A description of all the packages in this product.

In addition, users are encouraged to monitor (and contribute to!) the TI Embedded Processors Wiki.

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

---

What's New

The following significant changes have been made since 1.00

1.00.02

• General
  • Minor Maintenance Release
• The following defects were resolved:

  ID	Headline
  SDOCM00060863	WinCE CMEM_getPhys() does not work on buffers that were not allocated by CMEM

• The following enhancements were resolved:

  ID

  Headline

1.00.01

• General
  • Minor Maintenance Release
• The following defects were resolved:

  ID	Headline
  SDOCM00059252	CMEM driver for WinCE should use a named mutex

• The following enhancements were resolved:

  ID

  Headline

1.00

• General
  • Initial release - supporting CMEM-based physically contiguous memory allocation

---

Upgrade Information

The WinCE Utils packages are available in the "packages/" subdirectory of the product.

Compatibility Breaks!

None

---

Compatibility Information

N/A, this is the initial WinCE Utils release

Compatibility Key Definitions

Compatibility keys are intentionally independent of Marketing product numbers and are intended to:

1. Enable tooling to identify incompatibilities between components, and
2. Convey a level of compatibility between different releases to set end user expectations.

Compatibility keys are composed of 3 comma-delimited numbers - M,S,R - where:

• M = Major. A difference in M indicates a break in compatibility.
• S = Source. A difference in S indicates source compability. That is, the user's source doesn't require change, but does require rebuilding.
• R = Radix. A difference in R indicates an introduction of new features, but compatibility with previous interfaces has not broken. If libraries are provided by the package, an application must re-link with the new libraries, but not rebuild from source.

---

Device Support

This release supports the following devices:

• DM644x EVM:
  • dual-processor configuration, running WinCE 6.00
• OMAP3530:
  • dual-processor configuration, running WinCE 6.00

---

Validation

This release was validated against using the following components:

• XDCtools 3.10.05.61
• WinCE 6.00 (for DM6446)
• WinCE 6.00 (for OMAP3)

This release was validated in the following configurations:

• DM6446 EVM:
  • dual-processor configuration, running WinCE 6.00
• OMAP3530:
  • dual-processor configuration, running WinCE 6.00

---

Known Issues

None

---

Examples

WinCE Utils example apps and tests are provided in the ti/sdo/winceutils/*/apps directory.

---

Version Information

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, ex. winceutils_1_00_02.

Subsequent releases of patch upgrades will be identified by the patch number, ex. WinCE Utils 1.00.01 with directory winceutils_1_00_01. Typically, these patches only include critical bug fixes.

---

Technical Support

For technical support, contact softwaresupport@ti.com

Check the following web site for updates: https://software-dl.ti.com/dsps/dsps_public_sw/sdo_sb/targetcontent/winceutils/index.html

---

Last updated: September 4, 2009