OMAP35x DVSDK Beta2 to GA Migration Guide

From Texas Instruments Embedded Processors Wiki

Introduction

This document walks you through component-level modifications in the DVSDK v3.00.00.40 release from DVSDK v3.00.00.29 and serves as an aid for migrating existing applications.

Overall Package Related Changes

The DVSDK v3.00.00.40 has been modified from the previous build. The main modifications are as given below:

1. DVSDK v3.00.00.40 Getting started Guide is removed from the installer and is present as a wiki page. It can be accessed in the following link: OMAP35x DVEVM Getting Started Guide
2. Codec Servers : The build does not contain the Codec servers in the package. It is a separate download which is present in the download link which you could install in the dvsdk as mentioned in point five in section Installing the DVSDK Software of Getting Started Guide.
3. MP3 decoder : Mp3 decode is not part of the Codec server package. If you need the MP3, it has to be downloaded separately. Refer to How_do_I_Integrate_new_codecs_into_DVSDK to download and integrate the MP3 Codecs with the existing Codec Combos.
4. Pre-Built target Filesystem : The pre-built target filesystem is also removed from the DVSDK installation. It is now present under collateral in the OMAP35x DVSDK software download page.

Component Level Changes

PSP Related Changes

PSP has migrated from OMAP35x_SDK_setuplinux_1_0_2(Linux kernel version 2.6.22 open source Linux kernel) to OMAP35x Linux PSP GIT v2.01.02 (Linux kernel version 2.6.29-rc3). For installation please refer Installing the Target Linux Software in GSG.

The interface level changes with respect to the 2.6.22 kernel based Linux PSP releases is mentioned in migration guide which is present in OMAP35x Linux PSP GIT v2.01.02.09/docs/MigrationGuide-02.01.02.09.pdf.

NOTE: The new linux kernel requires u-boot and x-loader to be updated. Please refer OMAP35x Linux PSP GIT v2.01.02.09/docs/UserGuide-02.01.02.09.pdf for re-flashing the x-loader as well as u-boot. (For re-flashing x-loader Refer Section 2.4.Flashing x-loader and for flashing u-boot refer Section 3.2.Flashing U-Boot.)

Codec Server Related Changes

The Codec Servers are not part of the DVSDK installation. They are contained in a separate product which can be downloaded from the OMAP35x DVSDK software download page and installed as mentioned in point 5 in section Installing the DVSDK Software of the GSG.

The Codec Servers are merged into a single Server that contains both encode and decode functionalities.

Note : The server naming convention has changed in the new standalone Server (cs.x64P). If you were using a pre-release Server, you will have to modify your .cfg file from either "./decodeCombo.x64P" or "./encodeCombo.x64P" to "./bin/cs.x64P" when using the new Server product.

As an example, the modifications made to the decode demo's decode.cfg file to consume this new Codec Server product follow (createFromServer() details are available here):

/*
 *  ======== Engine Configuration ========
 */
var Engine = xdc.useModule('ti.sdo.ce.Engine');
var demoEngine = Engine.createFromServer(
  "decode",
  "./decodeCombo.x64P",
  "ti.sdo.servers.decode"
);

Has been modified to

/*
 *  ======== Engine Configuration ========
 */
var Engine = xdc.useModule('ti.sdo.ce.Engine');
var demoEngine = Engine.createFromServer(
  "decode",
  "./bin/cs.x64P",    // new executable Server file name
  "ti.sdo.server.cs"  // new package name
);

Changes to Bootargs

The bootargs have been modified as below:

NOTE: The below commands should be entered as a single line.

For Ramdisk:

setenv bootargs 'mem=88M console=ttyS0,115200n8 root=/dev/ram0 initrd=0x81600000,16M ramdisk_size=40960 omapfb.rotate=1
                 omapfb.rotate_type=1 omap_vout.vid1_static_vrfb_alloc=y'

For JFFS filesystem:

setenv bootargs 'mem=88M console=ttyS0,115200n8 noinitrd root=/dev/mtdblock4 rw rootfstype=jffs2 omapfb.rotate=1 
                 omapfb.rotate_type=1 omap_vout.vid1_static_vrfb_alloc=y'

For NFS Filesystem

setenv bootargs 'mem=88M console=ttyS0,115200n8 noinitrd ip=dhcp rw root=/dev/nfs
                 nfsroot=<nfsserver_ip>:/home/<useracct>/workdir/filesys,nolock omapfb.rotate=1 
                 omapfb.rotate_type=1 omap_vout.vid1_static_vrfb_alloc=y'

Tool chain changes

CodeSourcery tool chain has been changed from arm2007q3 to arm2008q1. Please refer section Installing the toolchain of GSG for download and installation.

Version differences

See the OMAP35x DVSDK Version Log for details on component version changes throughout the development cycle of the DVSDK.

Note: All components are modified to work with the OMAP35x Linux PSP GIT v2.01.02(Linux kernel version 2.6.29-rc3)