cs1omapl138 Codec Server 1.00.00 Release Notes
Oct 15, 2009
Summary:
|
NAME |
cs1omapl38 |
|
VERSION |
1.00.00 |
|
PLATFORM(S) SUPPORTED |
OMAPL138 |
|
USE CASE(S) |
General purpose
audio/video/speech/image |
|
SERVER PACKAGE |
cs1omapl138_1_00_00 |
|
SERVER START ADDRESS |
0xc3200000 |
|
SERVER END ADDRESS |
0xc4000000 |
|
TOTAL SERVER SIZE |
14 Mbytes |
The following release notes are
applicable to the cs1omapl138 codec server.
The release notes are divided into the following sections:
Upgrade and Compatibility Information
Codec, Test Environment, Use Case Test Result Details
Technical Support and Contact Information
LICENSE
INFORMATION
·
The codec server
is bound to the TSPA
License Agreement(Note1)
RELEASES
- The most recent release 1.00.00.01 provides the following.
This is the “Early Adaptor 1” release of the codec server
·
New features
o Single codec server executable is
built for encode, decode and encodedecode operations.
o
Removed
MPEG2DEC video codec from the codec server package for the EA release due to SDOCM00057731,
SDOCM00062310 and SDOCM00062310. (Please refer to the Known Issues Section)
o
Removed
MEPG4ENC video codec from the codec server package for the EA release due to SDOCM00062791 (Please refer to the Known
Issues Section).
The detailed performance results for this release can be
located in the cs1omapl138_master_build_specification.xls(Note1) master
build sheet. Please refer to “DSP Codec Server Performance Summary” section
documented under the “cs1omapl138_data_sheet.htm
(Note1)”
data sheet for the codec server performance summary table.
·
IRs Fixed in
this Release
o
None
INSTALLATION
This codec
server installation produces the following structure.
The
directory structure is as follows:
cs1omapl138_1_00_xx
|----------- packages
|----------- cs1omapl138_release_notes.htm
|----------- config.bld
|----------- Makefile
|----------- package.xdc
packages directory is a place holder for the
codecs, servers.
config.bld file specifies the compiler tools
path and target platform.
Makefile is the ‘make’ utility file to build
the codecs and server.
packages contains the following directory
structure
ti
|----------- sdo
|----------- codecs
|----------- server
codecs directory is the place holder for
all the codecs that the codec server supports.
server contains the following directory
structure
|----------- cs
|----------- bin
|----------- docs
The bin directory gets populated with the
codec server binary cs.x64P, when building the codec server. The released
version already contains the pre-built DSP binary under this directory.
The docs directory contains the following
files.
o
TILAW-209991-v5
FORM_TSPA_Source_and_Object_Code_Software_License_Agreement.txt -TSPA license document for the codec
server
o
logocorp.gif -
Texas Instruments Logo
o
cs1omapl138_master_build_specification.xls -
Codec Server Master Build Sheet
o
cs1omapl138_software_manifest.pdf -
Codec Server Software manifest document
o
producttable.xml
- the product table for the codec server
o
cs1omapl138_data_sheet.htm -
Data Sheet describing the link to the generated server data sheet and links to
the codec documents.
The “cs”
directory contains the following files.
o
codec.cfg - Codec Configuration
files for the codec server
o
server.cfg - Codec Server Configuration
files
o
server.tcf - Codec Server tconf
script for the DSP binary
o
main.c - Codec Server source
main file
o
link.cmd
- Any additions to
the linker command files should be placed here
o
package.bld - RTSC package file
o
package.xdc - RTSC package file
o
package.xs - RTSC package file
BUILDING
THE CODEC SERVER
·
Follow these
steps to build the codec server.
o
If the
environment variables are defined using ..\Rules.make
1.
goto
cs1omapl138_1_00_xx directory
2.
type make clean or gmake clean, to make sure any metadata and server
executables are cleaned.
3.
type make or
gmake under the cs1omapl138_1_00_xx directory (make sure that the path
includes the GNU make).
o
If the
environment variables are not defined using ..\Rules.make
1.
Please make sure
you set or export all the environment variables mentioned in the sample
csRules.mak for Linux/Windows environment before executing step 2 mentioned as
below.
2.
goto
cs1omapl138_1_00_xx directory
3.
type make clean or gmake clean, to make sure any metadata and server
executables are cleaned
4.
type make or
gmake under the cs1omapl138_1_00_xx directory (make sure that the path
includes the GNU make).
UPGRADE AND COMPATIBILITY INFORMATION
This product's version follows a version format, M.m.p.b,
where M is a single digit Major number, m is single digit minor number, p is a
single digit patch number and b is the build number.
DEVICE SUPPORT
This release supports the
following device families:
- OMAPL138
KNOWN ISSUES
|
Sl.No. |
SDOCM ID |
Description |
Issues/Workaround |
|
1 |
SDOCM00058809 |
JPEG Image Decode - output
file is often overwritten by an earlier output |
Issue
seems to be with certain 422P encoded files. Codec is returning an error
(this still needs to be root causes to see if it is really a unsupported
format issue or a bug in the codec). But the non fatal error was being
ignored by the DMAI app and an output was being generated from a buffer that
was not updated by the decoder. The output content would have been whatever
was in the output buffer (previous successful decode). So it was giving the
impression that an erroneous output was being generated. Adding a check in
the DMAI app so that if there is an error, an error message will be generated
and no output file will be generated should eliminate this issue. |
|
2 |
SDOCM00059735 |
The g711enc and g711dec
RTSC packages share a common symbol (mentioned below). When a codec server is
built with both the libraries, the below warning is seen. Warning 1 >>
package/cfg/bin/cs_x64P.xdl, line 313: warning: multiple definitions of
SECTION named '.const:_G711_TII_CODER_version' |
This does not impact
any functionality of G711. This can be safely ignored. |
|
3 |
SDOCM00057731 |
MPEG2D:Flicker is
observed at top of the display while decoding Mpeg2 streams of resolution
352x240 with video decode |
The codec is removed
from the codec server package for the EA release |
|
4 |
SDOCM00062310 |
MPEG2-D:Generated yuv
resolution is not same as the input stream resolution for some MP streams |
The codec is removed
from the codec server package for the EA release |
|
5 |
SDOCM00060533 |
MPEG-2 Decoder is
unable to decode clips @ QCIF resolution |
The codec is removed
from the codec server package for the EA release |
|
6 |
SDOCM00062791 |
MPEG4 Encoder Does work
when max Resolution set is not same as input resolution |
The codec is removed
from the codec server package for the EA release |
CODEC,
TEST ENVIRONMENT AND USE CASE TEST RESULT DETAILS
Please refer to the excel sheet cs1omapl138_master_build_specification.xls(Note1) for versions of the list of multimedia
codecs integrated in the codec server, test environment and the use cases for
which the server is designed.
TECHNICAL SUPPORT AND CONTACT INFORMATION
Send an e-mail to support@ti.com or contact local TI Field Application
Engineer for any support on cs1omapl138.
SPECIAL NOTES
Note1
The following links
referred in this document will not function properly, when this document is not
opened from the cs1omapl138_1_00_xx installation directory.
·
cs1omapl138_master_build_specification.xls
·
cs1omapl138_data_sheet.htm
·
TSPA License Agreement
·
Top level “
Copyright
2009, Texas Instruments Incorporated