Codec Engine 安装和设置

本文翻译自TI的手册，该手册是学习GPP＋DSP开发的金典文档，希望对各位入门有所帮助，有理解不当之处望请赐教。Codec Engine Application Developer User's GuideLiterature Number: SPRUE67D《Codec Engine 应用开发使用手册》原文参见：http://blog.csdn.net/dyzok88/article/details/42154487《第一章 Codec Engine 概要》http://blog.csdn.net/dyzok88/article/details/42214813后期会更新《第三章 使用示例应用程序》

Chapter 2 Installation and Setup

第二章 Codec Engine安装和设置 

This chapter describes steps you may need to perform for installation and setup.

2.1 Installing Codec Engine

2.2 Packages and Repositories

2.3 Directory Structure

本章介绍了您可能需要执行安装和设置 Codec Engine 步骤。

2.1 安装 Codec Engine

2.2 软件包和库

2.3 目录结构

2.1 Installing Codec Engine

2.1 安装 Codec Engine

The Codec Engine may have already been installed on your system as part of a larger installation. For example, the DVSDK software installation installs the Codec Engine in the codec_engine_#_## subdirectory of the main DVSDK software directory.

Codec Engine 作为一个较大安装的一部分，可能已经被安装在你的系统。例如，DVSDK 软件包安装 Codec Engine 在DVSDK软件主目录的子目录codec_engine_#_##。

 

If you have downloaded the Codec Engine as a standalone piece of software, follow these instructions: 

1) Copy the codec_engine_#_##.tar.gz file to the directory where you want to install the software (where #_## is the version number).
2) Unzip the file with an unzip utility.
3) Open the release_notes*.html file at the top level of the installation.
4) Follow the steps to build and run Codec Engine examples.

如果您已经下载了单独的 Codec Engine 软件包，按照以下步骤安装：

1) 复制 codec_engine_#_##.tar.gz 文件到你要安装的软件目录（其中 #_## 为版本号）。

2) 用解压缩工具解压文件。

3) 在安装的顶层目录下，打开 release_notes*.html 文件。

4) 按照步骤来建立和运行 Codec Engine 的例子。

 

2.2 Packages and Repositories

2.2 软件包和库

 

Codec Engine is delivered as a set of "packages". A package corresponds to a directory that contains all the files required for an independent component plus metadata about that component.

Codec Engine 作为一组“软件包”，一个软件包对应于一个包含所有需要的有关该组件的独立组件加元数据文件的目录。

 

Each package has a unique name that reflects its directory name. For example, "ti.sdo.ce.audio" is the name of a package that must be in a directory whose path ends with "/ti/sdo/ce/audio". Packages may be nested within another package. "Package repositories" are directories that contain one or more packages.

每个软件包都有反映其目录名的唯一名称，例如，"ti.sdo.ce.audio" 是以路径 "/ti/sdo/ce/audio" 结束的名字，而且该软件包必须在该目录中。每个软件包可嵌套在另一个包中，“软件包仓库”是包含一个或多个软件包的目录。

 

A package places its metadata in a sub-directory named "package". This sub-directory contains metadata files that you do not need to be concerned with unless you are creating your own packages. A package also always contains a file named “package.xdc”, which declares the package’s name and an optional compatibility key. This key is used to ensure compatibility between packages.

一个软件包把它的元数据放在名为该“软件包”命名的子目录，该子目录包含您不需要关注的元数据文件，除非你正在创建自己的软件包。一个软件包也总是包含一个名为“ package.xdc ”的文件，该文件声明软件包的名称和一个可选的兼容性钥匙，该钥匙是用来确保包之间的兼容性。

 

As an application developer using the Codec Engine, the main reason you should be aware of packages is to understand the #include paths you need to use for header files. These paths are relative to a package repository. The package repositories used by the Codec Engine are part of the "package path", which matches the sequence of –I options you need to pass to the compiler when compiling source files that use a module in the Codec Engine. Since packages all have unique names, even if they are in different repositories, the #include statement tells you which package contains a particular header file.

作为应用程序开发人员使用 Codec Engine,你应该知道软件包的主要原因是了解你需要使用头文件中的 #include 路径，这些路径是相对于一个包存储库（package repository）。Codec Engine 所使用的软件包存储库是“package path”的一部分，编译 Codec Engine 中的一个模块源文件时需要传递给编译器 –I 选项匹配头文件的序列。因为软件包都有唯一的名称,即使他们是在不同的存储库, #include 语句告诉你哪个软件包包含一个特定的头文件。

 

The Codec Engine distribution contains several package repositories:

❏ The core set of Codec Engine packages are in a repository named "packages". This corresponds to the CE_INSTALL_DIR/packages directory.

❏ The examples are distributed in a separate repository named "examples". This corresponds to the CE_INSTALL_DIR/examples directory.

❏ Some distributions of Codec Engine include a third repository containing a collection of dependant packages for convenience. This repository is named "cetools.packages", which corresponds to the CE_INSTALL_DIR/cetools/packages directory.

The XDC Tools provide an xdcpkg command (in the XDC_INSTALL_DIR/bin directory) that identifies all the packages in a directory. For example:

xdcpkg –a –l .

Codec Engine 发行版包含以下几个包存储库:

1. Codec Engine 的核心软件包存储在以 "packages" 命名的存储库中。对应于CE_INSTALL_DIR/packages目录中。

2. 示例是分布在一个单独的以 "examples" 命名的存储库中。 对应于 CE_INSTALL_DIR/examples 目录中。

3. Codec Engine 的一些发行版包含第三方的含有依赖包的集合库，这个库被命名为 "cetools.packages",对应于 CE_INSTALL_DIR/cetools/packages 目录中。

XDC工具提供一个 xdcpkg 命令(在 XDC_INSTALL_DIR/bin 目录中),用来识别一个目录中的所有包。例如:

xdcpkg –a –l .

 

2.3 Directory Structure

2.3 目录结构

 

The top-level directories within the Codec Engine installation are as follows:
❏ cetools. Contains DSP Link and other TI tools used by the Codec Engine. Some distributions of the Codec Engine contain dependent components in this location. Other distributions expect the dependent components to have been installed separately.
❏ docs. Contains documentation files.
❏ examples. Contains a number of example applications.
❏ package. Contains package-related metadata files. You do not need to use this directory unless you are creating packages.
❏ packages. The Codec Engine packages. The /ti/sdo/ce subdirectory (that is, the ti.sdo.ce package) contains the VISA APIs and the stubs and skeletons that enable remote invocation of the VISA APIs. The /ti/sdo/ce/osal subdirectory contains the OS abstraction layer.
❏ xdoc. Contains documentation files for the packages in the Codec Engine distribution.

Codec Engine 内的顶级目录安装如下:

1. cetools。包含 Codec Engine 所使用的 DSP 链接等 TI 工具，Codec Engine 的一些发行版的赖的相关组件包含在 cetools 这个目录中，另一些发行版本预计单独安装依赖的组件。

2. docs。包含文档文件。

3. examples。包含一些示例应用程序。

4. package。编解码引擎（ Codec Engine ）包。/ti/sdo/ce 子目录(即 ti.sdo.ce 包)包含 VISA API 和 stubs 和 skeletons，这些组件使远程调用 VISA API成为可能。/ti/sdo/ce/osa 子目录包含操作系统抽象层。

5. xdoc。包含 Codec Engine 分布的软件包的文档文件。