Este documento descreve a rvore referncia STMicroelectronics FAE .

A rvore STFAE fornece um nvel de aplicao de software capaz de

controlar a interface de software Stapi padro .
Por padro, uma interface de testtool est presente para agradar a chamar /
controle e verifique Stapi chama .
Este apoio til para FAE local.
Ele oferece a possibilidade de criar demonstraes de software e tambm
um bom conjunto de exemplos de software de referncia para
clientes que no esto familiarizados com testapps Stapi .
Alm disso, o STFAE atinge muitas plataformas , no nodedicated
STFAE rvore para um chip ou plataforma especfica .
STFAE genrico e portado por padro para todas as plataformas de
referncias ST .
A rvore tem a seguinte estrutura :
apilib / contm todos os drivers Stapi
bin / contm o arquivo de configurao setenv + ferramentas ( gmake /
BINTOC ....)
Stapp / contm toda a inicializao e configurao dos drivers Stapi
stdebug / contm todos os comandos interativos testtool
stgui / contm o aplicativo (no fornecido por padro)
modules / contm alguns pacotes estendidos (no fornecidos por padro )

2.2 Glossrio
API Aplicao Programvel interface
ATA AT Attachment
Advanced Television Systems Committee ATSC
CA Acesso Condicional
CAT Quadro de Acesso Condicional
CRC verificao de redundncia cclica
DTV Digital Television
DVB Digital Video Broadcasting
Mensagem ECM direito de controle
EIT Informaes sobre o evento Mesa
EMM direito de gerenciamento da mensagem
Guia Electrnico de Programao EPG
ES Fluxo Elementar
HDD Disco Rgido
MPEG Moving Pictures Experts Group
NIT Network Information Table
Tabela PAT Associao Programa
PCR Programa de Referncia do Relgio
PES empacotados Fluxo Elementar
PID Packet IDentifier
PIO Programmed Input / Output para transferncia de dados HDD
Tabela PMT Programa Mapa
PSI Programa de Informao Especfica
Programa PSIP Sistema de Informao e Protocolo
PTI Programmable Transporte interface
PTI1 Programmable Transporte arquitetura de interface verso 1 -
ST20TP3 , ST20TP4 ,
STx5510 , STx5512 .
PTI3 Programmable Transporte arquitetura de interface verso 3 - STx5514
, STx5516 ,
STx5517
PTI4 Programmable Transporte arquitetura de interface verso 4 -
STx5528 , STx5100 , STx520x , STx710x , STx7200
Verso PTI4L Programmable Transporte arquitetura de interface 4 Lite -
STx5105 , STx7710
PTS Presentation Time Stamp
Informaes SI System ( ATSC) , Information Service ( DVB)
Filosofia Stapi ST Aplicao Programvel interface
Relgio STC Time System
TC Controle de Transporte
Transport Stream TS


A instalao da rvore muito simples, basta descompactar o arquivo
fornecido em qualquer local.
Abra o arquivo bin / setenv.bat e modificar os seguintes caminhos :
SETSTFAEROOT=C:\Code\STFAE
SETST20ROOT=C:\Code\ST_Tools\ST20\R2.2.1
SETST40ROOT=C:\Code\ST_Tools\ST40\R4.0.2
SETST200ROOT=C:\Code\ST_Tools\ST200\R4.1
SETOSPLUSROOT=C:\Code\ST_Tools\OS+\R2.1.1

Somente o conjunto de ferramentas (s) exigido para a sua plataforma
precisa ser instalado .
Em 5528/7100/7109 , a rvore STFAE est a funcionar e foi testado com
ST40 conjunto de ferramentas , mas ainda R4.0.2
compatvel com ST40 ferramentas R3.1.1 Patch 1 .
Em 7200, o conjunto de ferramentas a ser utilizada ST40 R4.0.2 .
Para 5301 , a rvore STFAE est funcionando bem , mas por favor note que
este no est no escopo em STFAE para apoiar esta
chipset para aplicaes DVB.
/! \ Por favor, note que, para 5301 , " gmake " deve ser substituda por "
fazer ", que fornecido com o pacote Cygwin
ao compilar a rvore em PCs
/! \ Por favor , note que para " STFAE para Linux" , voc precisa ir para o
captulo 8!

Configurao da placa
A configurao da placa feita atravs do arquivo bin / setenv.bat . Voc
precisa executar este arquivo de lote , a fim de configurar o
Ambiente STFAE .
Ao chamar bin / setenv.bat ou bin / setenv.sh (para sol ou linux, o arquivo
de lote lhe dar a lista atual de placas
suportada .
PC: [ c: \ code \ stfae ] bin \ setenv.bat
UNIX / LINUX : [root @ localhost stfae ] source bin / setenv.sh
Lista de configurao disponveis
---------------------
MB390_5100
MB390_5301
MB391_7710
MB411_7100
MB411_7109
COCOREF_7100
COCOREF_V2_7100

Para selecionar uma configurao da placa , basta fazer bin / setenv
<plataforma > _ < Backend > onde < plataforma> o nome do
placa que voc deseja usar e < Backend > o chip soldado na placa.
Por exemplo, aqui o conselho DTT5100 selecionado :
PC: [ c: \ code \ stfae ] bin \ setenv.bat DTT5100_5100
UNIX / LINUX : [root @ localhost stfae ] source bin / setenv.sh
DTT5100_5100
Configurao DTT5100_5100 selecionado!

Descrio Configurao do ambiente
O arquivo de lote " bin \ setenv.bat " ir configurar as variveis de
ambiente global . Voc pode personalizar sua prpria plataforma
alterando essas variveis de ambiente . Aqui est uma descrio ofthese
variveis de ambiente.

SETSTFAE=1
This variable should always be set to 1 when compiling the STFAE tree. In
order to
get an apilib library without any dependencies with stapp/ or stdebug/, this
flag
should be set to 0.
SETSTB7100ROOT=%STFAEROOT%/apilib
This variable gives the path to the apilib/ directory.
SETDVD_MAKE=%STB7100ROOT%/make
This variable gives the path to the apilib/make directory.
SETDVD_ROOT=%STB7100ROOT%/src
This variable gives the path to the apilib/src directory.
SETDVD_EXPORTS=%STB7100ROOT%/lib
This variable gives the path to the apilib/lib directory.
SETDVD_INCLUDE=%STB7100ROOT%/include
This variable gives the path to the apilib/include directory.
SETDVD_CONFIG=%STB7100ROOT%/config
This variable gives the path to the apilib/config directory.
SETDVD_TRANSPORT=stpti4
This variable gives the hardware transport interface used (always set to
stpti4).
SETDVD_PLATFORM=cocoref
This variable gives the name of the hardware platform.
SETDVD_BACKEND=7100
This variable gives the name of the backend chipset used
It could be 5105, 5100, 5301, 5528, 7710, 7100, 7109...
SETDVD_FRONTEND_TUNER=NIM_360,NIM_299_6000,NONE,NIM
_297
This variable gives the name of the front-end hardwares used on the
platform.
It could be STEM_299, NIM_299, NIM_299_6000,
NIM_899_6100, NIM_399,
NIM_360, NIM_361, NIM_297, NIM_TS, CUSTOM.
You can define a list of tuners in this variable if you have many tuners on
the
board.
SETDVD_SERVICE=DVB
This variable defines the broadcast service used. Only DVB is working
in STFAE.
SETDVD_DISPLAY_SD=[D_PAL,D_NTSC]
This variable is set to D_PAL or D_NTSC to setup the SD output format of
the decoder.
SETDVD_DISPLAY_HD=[NONE,D_1080I50HZ,D_720P50HZ,D_1080I
60HZ,D_720P60HZ]
This variable is set to the appropriate format needed for the HD output. If
we want
to work in SD only, this variable should be set to NONE.
SETMODULES=0
This variable should be set to 1 if you want to use the modules/ services.
SETGUI=0
This variable should be set to 1 to run the STFAE tree with the STGUI
application.
SETDVR=1
This variable should be set to 1 to enable DVR functionalities.
Please note that you need to recompile all the tree (even the apilib/) when
switching this flag from 0<-->1 or 1<-->0.
SETOSPLUS=1
This variable should be set to 1 if you have the OS+ stack. Please note that
OS+ is
mandatory if DVR=1 (only for OS20/OS21).
SETUSB=0
This variable should be set to 1 if you want to enable the USB interface.
Please note
that you need OSPLUS=1 + the usblink librairies provided by OS+. These
libraries are
not free of charge (only for OS20/OS21).
SETTCPIP=0
This variable should be set to 1 if you want to enable TCPIP support.
Please note
that you need OSPLUS=1 + the nexgen libraries provided by OS+. These
libraries are
not free of charge.
SETDEBUG=1
This variable should be set to 1 to compile STFAE in debug mode.
SETHEAP_WITH_STFAE=0
This variable should be set to 1 to let STFAE manage the heap memory. In
this case
the heap is managed as a simple OS memory partition (only for 0S20).
SETRUN_FROM_FLASH=0
This variable should be set to 1 when compiling the rom image.
SETTARGET=usb
This variable contains the name of the microconnect target to be used. It
could be
usb to use the USB microconnect connection or an IP address or a name
of a
microconnect which is translated into an IP address by your local DHCP
server.
SET ARCHITECTURE=ST40
This variables defines the architecture type of the backend chipset. It could
be
ST20, ST40 or ST200.
SET DVD_PLATFORM_ROOT=<Pathname>
This variable is not setup by default in the STFAE tree release. This
variable could
be used when you want to use an another directory for the platforms
definitions. By
default (when this DVD_PLATFORM_ROOT is not defined), the platform
directory is
always in stapp/platform/.
SETSTFAE_EXTERNAL_MAIN=1
This variable is not setup by default in the STFAE tree release. This
variable could
be used in order to link the STFAE application with an external main
symbol. In this
case STFAE could be used as a reference of driver initializations + an
external
application (like HDI for example).
SETDVD_START_SCRIPT_EXTENDED=<Filename>
This variable is not setup by default in the STFAE tree release. This
variable could
be used in order to add a script to be loaded when running the application
on the
target. The Filename provided in this variable is then loaded dynamically
when
uploading the code to the microconnect. You can customize your debug
script
commands. Please note this is working for ST20/ST40 toolset only.
STFAE - Release NotesSTFAE - 7
SETOS_MODE=<Pathname>
This variable is not setup by default in the STFAE tree release. This applies
only
for ST40 Toolset/OS21 : when linking the STFAE application, the
stapp/makefile will
check first if you have recompiled your own OS21 libraries by checking if
%ST40ROOT%/sh-superh-elf/src/os21/lib/st40/$(OS_MODE) is present or
not. If not,
the applicatoin will be linked with the default libraries provided in the
toolset
release. If the path exists, the application will be linked with the
appropriate
librairies. A typical usage of this is for example to define
OS_MODE=encoded or
OS_MODE=non_encoded to use OS21 libraries with interrupts in encoded
or non encoded
mode.

Como compilar a rvore
Para compilar a rvore STFAE , h duas etapas . O primeiro passo
compilar as bibliotecas Stapi e passo dois
compilar e linkar o prprio aplicativo stfae ( Stapp / & stdebug / diretrios )
.
A compilao do apilib / foi separado da aplicao, pois leva algum tempo
para recompilar o
Motoristas Stapi .
Toda a compilao da rvore feito a partir do Stapp / diretrio. Mude para
este diretrio , em seguida, s chamar " gmake " .
A ferramenta " gmake " fornecido no diretrio / bin e adicionado
automaticamente para o caminho se voc executar o
Arquivo " bin / setenv " batch.
Ao chamar " gmake " sem nenhum parmetro , voc tem uma pequena lista
de comandos GCertifique disponveis .

[c:\code\stfae\stapp]gmake
"*********************"
"*** Makefile help ***"
"*********************"
"gmake : Display this help"
"gmake help : Display this help"
"gmake all : Compile STDEBUG - STAPP and link with stapi"
"gmake apilib : Compile only APILIB directory"
"gmake apilib MODULE=stvid : Compile a specific module into APILIB
directory"
"gmake stapp : Compile only STAPP directory"
"gmake stdebug : Compile only STDEBUG directory"
"gmake purge_all : Clean all the tree for a specific platform"
"gmake purge : Clean only STAPP directory"
"gmake purge_apilib : Clean only APILIB directory"
"gmake purge_apilib MODULE=stvid : Clean a specific module into
APILIB directory"
"gmake purge_stdebug : Clean only STDEBUG directory"
"gmake run : Run the application without debug"
"gmake debug : Run the application with debug"
"gmake rom : Generate ROM image of the application"
"gmake blower : Compile the flash blower application"
"gmake run_blower : Run the flash blower application"

Ento , para compilar o diretrio / apilib :
Primeiro, v para o diretrio / Stapp
Em seguida, para compilar o apilib / diretrio completo , basta fazer :
[ c: \ code \ stfae \ Stapp ] gmake apilib
STMicroelectronics Confidencial STFAE - Notas sobre o Release
STFAE - 8
Se voc deseja limpar o diretrio / apilib , basta fazer :
c: \ code \ stfae \ Stapp ] gmake purge_apilib
Se voc deseja compilar um driver Stapi especfico ( exemplo stvid aqui) ,
basta fazer :
[ c: \ code \ stfae \ Stapp ] gmake apilib MDULE = stvid
Se voc quiser limpar um motorista Stapi especfico ( exemplo stvid aqui) ,
basta fazer :
[ c: \ code \ stfae \ Stapp ] gmake purge_apilib MDULE = stvid

Vinculao da aplicao
Para compilar a aplicao stfae , voc precisa primeiro de compilar as
bibliotecas Stapi como acima.
! / \ Para 5301 plataformas, voc precisa primeiro para gerar os arquivos
objeto alvo plataforma , fazendo isso :
[ c: \ code \ stfae \ Stapp ] plataforma cd / $ ( DVD_PLATFORM ) / $ (
DVD_BACKEND ) / target
[ c: \ code \ stfae \ Stapp \ platform \ $ ( DVD_PLATFORM ) \ $ (
DVD_BACKEND ) \ target ] fazer tudo
Para compilar e ligar o aplicativo, v para o diretrio / Stapp , ento:
[ c: \ code \ stfae \ Stapp ] gmake tudo
O arquivo executvel resultante para o alvo ser:
principal _ $ ( DVD_PLATFORM ) _ $ ( DVD_BACKEND ) .lku para
plataformas ST20
principal _ $ ( DVD_PLATFORM ) _ $ ( DVD_BACKEND ) .out para
plataformas ST40
A vantagem disso que voc pode compilar para 5100/5105 ou 7100 sem
expurgar qualquer coisa quando se muda
5100-7100 por exemplo . STFAE multi- plataforma.
O mesmo mtodo aplicado quando a gerao de imagens ROM ou
librairies Stapi
Para limpar a rvore completamente :
[ c: \ code \ stfae \ Stapp ] gmake purge_all
Por favor, note que, neste caso , Stapp / & stdebug / & apilib / ser limpo .
No entanto, apenas os arquivos objeto para a plataforma especificada e
backend sero excludos. Por exemplo, se voc estiver
fazer um expurgo onde DVD_PLATFORM = mb411 & DVD_BACKEND
= 7100 , todos os arquivos para 5100 ( se voc tiver
alguns arquivos objetos) no sero tocados .
Para compilar apenas o diretrio / stdebug :
[ c: \ code \ stfae \ Stapp ] gmake stdebug
Para limpar apenas o diretrio / stdebug :
[ c: \ code \ stfae \ Stapp ] gmake purge_stdebug
Para compilar apenas o diretrio / Stapp :
[ c: \ code \ stfae \ Stapp ] gmake Stapp
Para limpar apenas o diretrio / Stapp :
[ c: \ code \ stfae \ Stapp ] gmake purge

Como executar a rvore na minha plataforma
Antes de executar o aplicativo , compile a rvore STFAE conforme
descrito no captulo 4.
Tal como acontece com a compilao, para executar o software voc tem
que ficar no diretrio / Stapp .
H duas maneiras de executar o aplicativo , basta executar o cdigo sem
debug orrun o software com a grfica
depurador.
Primeiro voc precisa configurar o tipo de conexo (ip usbor ) eo endereo
IP do seu ST- MICROCONNECT .
O mesmo ST - MICROCONNECT pode ser utilizado para objectivos de
ST20 , ST40 e ST200 . Sem atualizao de firmware especfico
necessrio, mas o firmware mais recente est disponvel atravs de seu
FAE se o seu desejo.
5,1 Configurao dos microconnects
Voc s precisa definir corretamente a varivel $ TARGET environnement
para configurar a conexo com o
Microconnect .
Por favor, defina a varivel $ TARGET para "usb" ( por favor, respeitem
minsculas) se voc quiser carregar o cdigo atravs do
Conexo USB do Microconnect .
set TARGET = usb
Caso contrrio, defina a varivel de destino com um endereo de IP como
(ou um nome traduzido por um servidor DHCP) :
set TARGET = 192.168.1.101
, a fim de carregar o cdigo atravs da ligao do TCPIP Microconnect

5.2 A execuo do software

Antes de executar o software, necessrio configurar a conexo com o ST-
MICROCONNECT , como
descrito no captulo 5.1.
V ao diretrio / o Stapp ...
Para executar o aplicativo sem depurao:
[ c: \ code \ stfae \ Stapp ] gmake prazo
/! \ Com depurador ST40 , voc deve pressionar "c" uma vez. O comando
"c" dbg (que significa " c'ontinue ) simplesmente
executar o aplicativo de software.
Para executar o aplicativo com a interface depurador grfico :
[ c: \ code \ stfae \ Stapp ] gmake debug
/! \ Com depurador ST40 , voc deve pressionar "c" duas vezes , a primeira
"c" (que significa " c'ontinue ) vai entrar no principal
da aplicao STFAE , em seguida, o segundo "c" ir executar o software.
Release Notes STFAE
STMicroelectronics Confidencial STFAE - Notas sobre o Release

6 Como inicializar a partir de flash

A gerao da imagem rom STFAE feito a partir da Stapp / diretrio.
Por favor, note que voc precisa recompilar toda a rvore com
RUN_FROM_FLASH = 1, ento, por favor , verifique se:
SETRUN_FROM_FLASH = 1
6.1 Criando uma imagem de rom
Para criar a imagem rom do arquivo , a partir do diretrio / Stapp
[ c: \ code \ stfae \ Stapp ] gmake rom

6.1 Criando uma imagem de rom
Para criar a imagem rom do arquivo , a partir do diretrio / Stapp
[ c: \ code \ stfae \ Stapp ] gmake rom
-------------------------------------------------- ------------------------------ INFO:
Voc est tentando executar uma imagem de ROM.
INFO: Por favor, certifique-se de que voc tem compil toda a aplicao
com RUN_FROM_FLASH = 1
INFO: Boa sorte ....
-------------------------------------------------- -------------------------------- a
sada da imagem da ROM um arquivo chamado :
Flash _ $ ( DVD_PLATFORM ) _ $ ( DVD_BACKEND ) .hex para
plataformas ST20
Flash _ $ ( DVD_PLATFORM ) _ $ ( DVD_BACKEND ) .bin para
plataformas ST20 e ST40
onde $ ( DVD_PLATFORM ) o nome ofthe plataforma e $ (
DVD_BACKEND ) o nome do chip , para
exemplo :
flash_mb390_5100.hex
flash_mb411_7100.bin
/! \ Por favor, note que ns fornecemos dois formatos de imagem ROM no
ST20 , hexadecimal e binrio . No entanto , recomendamos que voc use
o arquivo hex . Usando o arquivo .hex ir apagar apenas os blocos de flash
que precisam ser modificados , por isso, se voc tiver qualquer outra
blocos de dados em flash , eles sero preservados .
6.2 A queima a imagem rom na placa
Para queimar a aplicao STFAE , voc precisa de uma ferramenta
toprogram o flash. Este Toolis disponvel no STFAE
rvore e chamada a ferramenta soprador. uma aplicao rodando sobre
a plataforma que voc deseja gravar .
6.2.1 Compilando a ferramenta gravador (chamado Blower)
Para compilar o ventilador, ir ao diretrio / Stapp e fazer:
[ c: \ code \ stfae \ Stapp ] gmake blower
A sada desta chamada ser gerado um arquivo executvel chamado :
blower _ $ ( DVD_PLATFORM ) _ $ ( DVD_BACKEND ) .lku para
plataformas ST20
blower _ $ ( DVD_PLATFORM ) _ $ ( DVD_BACKEND ) .out para
plataformas ST40
onde $ ( DVD_PLATFORM ) o nome ofthe plataforma e $ (
DVD_BACKEND ) o nome do chip , para
exemplo :
blower_mb390_5100.lku
blower_mb411_7100.out

6.2.2 A execuo da ferramenta queimador / ventilador
Antes de executar a ferramenta ventilador , voc precisa compil-lo , por
favor, consulte o captulo 6.2.1 .
Para executar a ferramenta ventilador , v para o diretrio / Stapp e fazer:
[ c: \ code \ stfae \ Stapp ] gmake run_blower
! / \ Por favor, note que para as plataformas ST40 , voc precisa modificar a
configurao micronnect em :
Stapp / platform / $ ( DVD_PLATFORM ) / $ ( DVD_BACKEND ) /
$ ( DVD_PLATFORM ) _ $ ( DVD_BACKEND ) _blower_script.cmd
/! \ Por favor use o mesmo mtodo descrito no captulo 5.1.2
Ao executar o ventilador, voc tem um menu interativo simples como isto:

================================================
STFAE - Flash programmer
(c) 2005 - ST MicroElectronics
================================================
Please, type :
1 - Program the flash, from file flash_mb411_7100.hex
2 - Program the flash, from file flash_mb411_7100.bin
3 - Compare flash and file flash_mb411_7100.hex
4 - Compare flash and file flash_mb411_7100.bin
5 - Erase content of all flash
6 - Dump the content of the flash into flash_mb411_7100_dump.bin
7 - Quit
Choice ?

Utilize 1 ou 2 para gravar o software , dependendo de ST20 / ST40 /
escolha plataformas ST200 .
O queimador ir desligar -se da plataforma quando terminar. Voc deve,
ento, redefinir a plataforma para verificar se
a aplicao arrancar a partir de flash.
/! \ Por favor, note que voc precisa para conectar um terminal RS232
porta UART correta, a fim de ter o testtool
interface de linha de comando .
/! \ Por favor, note tambm que recomendvel desligar o micronnect do
tabuleiro. O Microconnect pode
impedir a aplicao inicializao a partir de flash em algumas placas

7 Como criar ou modificar a minha plataforma
7.1 Platform conceito
O conceito de " plataforma " em STFAE centralizado no diretrio Stapp /
plataforma.
Todas as plataformas suportadas pela rvore so descritos neste diretrio.
possvel alterar o caminho raiz padro da plataforma , definindo a
seguinte varivel de ambiente
$ ( DVD_PLATFORM_ROOT ) (ver captulo 3.3).
Em seguida , o caminho de acesso para a plataforma sempre o mesmo :
$ ( DVD_PLATFORM_ROOT ) / $ ( DVD_PLATFORM ) / $ (
DVD_BACKEND )
o caso OS20 / OS21 / LINUX .
A plataforma descrito com quatro partes principais :
- A $ ( DVD_PLATFORM ) _ $ ( DVD_BACKEND ) .hfile que define o
mapeamento de memria , prioridade de
Tarefas Stapi , o nvel das interrupes , ... quando compilar a rvore
STFAE .
- A $ ( DVD_PLATFORM ) _ $ ( DVD_BACKEND ) .makfile que contm
todas as opes Compil especficos
ligado plataforma . Estas opes Compil so fornecidos para motoristas
Stapi e aplicao stfae quando
compilao da rvore STFAE . recommanded purgethe completo rvore
e reconstru-lo quando mudar de um
parmetro no arquivo .Mak .
- A $ ( DVD_PLATFORM ) _ $ ( DVD_BACKEND ) [ cfg | cmd ] arquivo
que contm o arquivo de configurao.
quando arrancar a rvore STFAE usando o Microconnect . Ele configura o
sistema : relgios, memria , EPLDs ...
- A $ ( DVD_PLATFORM ) _ $ ( DVD_BACKEND ) / diretrio bootrom
que contm todo o cdigo necessrio
para arrancar a rvore STFAE de flash.
H tambm outros arquivos que esto ligadas ao conjunto de ferramentas e
ambiente utilizado para a plataforma .
Como voc pode imaginar , todos esses arquivos so muito ligados entre si
.... Normalmente mudar um parmetro em um desses
arquivos pode resultar de mudar alguns parmetros nos outros arquivos.
Este normalmente o caso quando queremos mudar
o mapeamento da memria ...

7.2 A criao de uma nova plataforma
Se voc quer criar uma nova plataforma (digamos que " PLATFORM_B "
o nome da nova plataforma ) , por favor
realizar as seguintes operaes :
Por favor, olhar primeiro para as plataformas atuais j suportados. Em
seguida , tentar encontrar o nome do mais prximo existente
plataforma para a pessoa que voc deseja criar ( em termos de chipset /
memria / recursos ... )
Assumindo a plataforma mais prxima " PLATFORM_A " , ento ,
procure o nome " PLATFORM_A " em todos os arquivos
Stapp / stdebug / diretrios apilib e adicionar seu novo nome da plataforma
dentro do cdigo .
Em seguida, copie o Stapp / platform / " PLATFORM_A " para Stapp /
platform / " PLATFORM_B " e renomear todos os arquivos em
" PLATFORM_B " e atualizar corretamente todos os arquivos de
configurao [ .h / .cfg / cmd / .Mak / bootrom ]
Quando voc tiver concludo e testado sua nova plataforma e quero que
seja no prximo estalo ou liberao de STFAE ,
voc precisa nos enviar todos os arquivos modificados para fundi-los no
principal ramo da rvore stfae .

9 Testtool
9.1 Sobre a interface
A interface testtool como uma concha (com um prompt) que d muita
flexibilidade . Voc pode executar dinamicamente
todas as caractersticas que voc quer apenas digitando o nome do comando
correto e parmetros.
possvel tambm criar scripts e funes dinmicas (olhe para definir
comando ) .
importante dizer que obrigatrio o uso de interface UART para todos os
sistemas OS21 . Na verdade a interface jtag
muito lento e por ST40 / ST200 , que congela o cpu corefor um curto
espao de tempo que suficiente para introduzir algum
latncia no interior dos fios em tempo real .
Normalmente, se voc decodificar um fluxo de vdeo e voc usar testtool
interface de throug jtag , voc deve ver alguns congelamento
a tela se voc pressionar Enter no prompt de testtool .
por isso que absolutamente necessrio para trabalhar com a interface
UART em sistemas OS21 (significando
RUN_FROM_FLASH = 1 ) .
Este problema no existe para sistemas OS20 .. No entanto usando testtool
via UART d muita advtanges .
Na verdade, utilizando a interface UART, o cdigo do aplicativo tem a
capacidade tocatch cada personagem e nestes
condio , voc pode ter acesso aos seguintes recursos:
tecla para cima : mover -se na histria de comandos .
tecla para baixo : mover para baixo na histria de comandos .
guia -chave : a concluso da comandos / macros / ficheiros (arquivos
apenas se o sistema de arquivos montado ) .
tecla ctrl -a: voltar a comear de linha
tecla ctrl- k: apagar caracteres de fim de linha
insero chave : alternar entre o modo de insero / substituio .
comando '!! ': executar o comando anterior
"histria" de comando : a histria dos comandos de exibio
comando 'n !': executar histria nmero de comando 'n'

9.2 STFAE comandos testtool
A lista TestTools de comandos descrita neste captulo. Este trabalho
provavelmente no est terminado e ser
melhorado em futuros lanamentos documentos . Desculpe por isso, mas
por favor, pergunte se voc precisa de alguns detalhes .
Antes de comear , cada comando pode ter um ou mais parmetros .
Alguns dos parmetros so obrigatrios , alguns
eles so opcionais . Ns diferenci-los com esta semntica : < Parmetros>
[ < parmetro opcional >].
9.2.1 ATAPI_BENCH
Uso: ATAPI_BENCH < Id >
Descrio:
Este comando usado para executar alguma referncia bsica ler e escrever
testes da
De interface PATA ou SATA . Ele exibe os resultados de largura de banda
dos testes .
Por favor , note que esta funo no funciona se o sistema de arquivos
virtual iniciado.
Este o caso , por padro na rvore STFAE . Voc precisa comentar
VFS_Init ()
chamar o Stapp / main.c principal / para ser capaz de realizar o teste de
bancada atapi .
parmetros:
< Id > Este parmetro utilizado para determinado interface ATA para
testar [0,1 , ...] .
limites:
Software = OS20 / no OS21 LINUX .
Hardware = Disponvel para todas as plataformas que tm um PATA ou
unidade de disco SATA .
Release Notes STFAE
STFAE - Lanamento NotesSTFAE - 21
9.2.2 ATAPI_INFO
Uso: ATAPI_INFO
Descrio:
Este comando retorna a verso do driver STATAPI .
parmetros:
Nenhum .
limites:
Software = Disponvel em OS20 / OS21 no LINUX .
Hardware = Disponvel para todas as plataformas que tm um PATA ou
unidade de disco SATA .
9.2.3 AUD_DISABLE
Uso: AUD_DISABLE < Id > [< Tipo >]
Descrio:
Este comando usado para silenciar a sada de udio .
parmetros:
< Id > Este parmetro o ID de dispositivo de udio para ser silenciado
[0,1 ... ] .
< Tipo > Este parmetro usado para silenciar uma sada especfica do
dispositivo de udio .
- Se <tipo> no for especificado , mudo todas as sadas
- Se <Type == A_STEREO > , apenas sadas pcm mudos .
- Se <Type == A_SPDIF > , apenas sada digital muda.
- Para STx710x / STx520x / STx7200 s :
- Se <Type == A_PCMP0 > , s a produo pcm0 mudo.
- Se <Type == A_PCMP1 > , s a produo pcm1 mudo.
limites:
Software = None .
Hardware = None .

9.2.4 AUD_ENABLE
Uso: AUD_ENABLE < Id > [< Tipo >]
Descrio:
Este comando usado para ativar a sada de udio.
Parmetros: un
< Id > Este parmetro o ID de dispositivo de udio para ser mudos [0,1 ...
] .
< Tipo > Este parmetro usado para ativar o udio de uma sada
especfica do dispositivo de udio.
- Se <Type> no especificado, no silenciar todas as sadas
- Se <Type == A_STEREO > , apenas sadas pcm UNMUTE .
- Se <Type == A_SPDIF > , apenas sada digital unmute .
- Para STx710x / STx520x / STx7200 s :
- Se <Type == A_PCMP0 > , s a produo pcm0 unmute .
- Se <Type == A_PCMP1 > , s a produo pcm1 unmute .
limites:
Software = None .
Hardware = None .
Release Notes STFAE
STMicroelectronics Confidencial STFAE - Notas sobre o Release
STFAE - 22
9.2.5 AUD_GETCAPABILITY
Uso: AUD_GETCAPABILITY < Id >
Descrio:
Este comando usado para obter recursos do dispositivo de udio < Id >
Ele exibe algumas informaes dos recursos do decodificador .
parmetros:
< Id > Este parmetro o ID de dispositivo de udio a ser usado [0,1 ... ] .
limites:
Software = None .
Hardware = None .
9.2.6 AUD_INFO
Uso: AUD_INFO
Descrio:
Este comando retorna a verso do driver Staud .
Para STx710x / STx520x / STx7200 , ele retorna tambm algumas
informaes sobre o udio
firmware .
parmetros:
Nenhum .
limites:
Software = None .
Hardware = None .

9.2.8 AUD_INJSTOP
Uso: AUD_INJSTOP < Id >
Descrio:
Este comando usado para interromper a injeo fluxo de dispositivo de
udio.
parmetros:
< Id > Este parmetro o ID de dispositivo de udio a ser usado para
interromper a reproduo [0,1 ... ] .
limites:
Software = None .
Hardware = None .
9.2.9 AUD_PAUSE
Uso: AUD_PAUSE < Id >
Descrio:
Este comando usado para interromper um dispositivo de udio .
parmetros:
< Id > Este parmetro o ID de dispositivo de udio para ser pausado [0,1
... ] .
limites:
Software = None .
Hardware = None .
9.2.10 AUD_RESUME
Uso: AUD_RESUME < Id >
Descrio:
Este comando usado para retomar um dispositivo de udio .
parmetros:
< Id > Este parmetro o ID de dispositivo de udio para ser retomado [0,1
... ] .
limites:
Software = None .
Hardware = None .
Release Notes STFAE
STMicroelectronics Confidencial STFAE - Notas sobre o Release
STFAE - 24
9.2.11 AUD_SETEFFECT
Uso: AUD_SETEFFECT < Id > < Effect>
Descrio:
Este comando usado para definir um efeito de udio .
parmetros:
< Id > Este parmetro o ID de dispositivo de udio a ser usado [0,1 ... ] .
< Efeito > Este parmetro o efeito para ser aplicada no dispositivo de
udio
Ele pode ter os seguintes valores :
- A_EFFECT_SRS3D : efeito Surround 3D
- A_EFFECT_SRSTS : efeito Trusurround
- A_EFFECT_SRSTB : efeito Trubass
- A_EFFECT_SRSF : Efeito Foco
- A_EFFECT_SRSTSXT : efeito XT Trusurround
- A_EFFECT_NONE : Nenhum efeito
limites:
Software = None .
Hardware = None .
9.2.12 AUD_SETOFFSET
Uso: AUD_SETOFFSET < Id > < offset >
Descrio:
Este comando usado para adicionar um deslocamento em milissegundos
no algoritmo de sincronizao udio
para o lipsync .
parmetros:
< Id > Este parmetro o ID de dispositivo de udio a ser usado [0,1 ... ] .
< Offset > Este parmetro um valor inteiro (neg ou valor pos) para ser
usado
como uma compensao para o sincronismo . O parmetro em
milissegundos.
Por exemplo, definir < offset > at -1000 ir bufferize 1s de udio em
o sistema para garantir a sincronizao labial .
limites:
Software = None .
Hardware = None .

9.2.13 AUD_SETLATENCY
Uso: AUD_SETLATENCY <id> <tipo> < Latncia >
Descrio:
Este comando usado para adicionar um atraso de latncia ou em
milissegundos para uma especfica
tipo de sada de udio.
Pode ser utilizado , de facto, para ajustar os atrasos exemplo udio e entre
spdif
HDMI ou sadas SCART para ter udio em fase em todas as sadas .
parmetros:
< Id > Este parmetro o ID de dispositivo de udio a ser usado [0,1 ... ] .
< Tipo > Este parmetro usado para especificar o tipo de sada de ser
adiada .
Ele pode ter os seguintes valores :
- A_PCMP0 para sada pcm0
- A_PCMP1 para sada pcm1
- A_SPDIF para sada SPDIF
< Latncia > Este parmetro contm o valor de latncia em milissegundos
para ser
aplicada sada de udio apropriado .
limites:
Software = None .
Hardware = Disponvel apenas para STx710x / STx520x / STx7200 .
9.2.14 AUD_SETSTEREO
Uso: AUD_SETSTEREO < Id > < Mode>
Descrio:
Este comando usado para controlar o modo de produo de som . Por
exemplo, podemos selecionar
canal ou ambos esquerda ou direita com este comando .
parmetros:
< Id > Este parmetro o ID de dispositivo de udio a ser usado [0,1 ... ] .
< Mode> Este parmetro usado para especificar o modo de sada de som.
Ele pode ter os seguintes valores :
- A_STEREO_DL : Modo de esquerda dupla
- A_STEREO_DR : Modo de direito duplo
- A_STEREO_DM : modo Dual mono
- A_STEREO_SS : Modo Stereo
- A_STEREO_2S : Modo Segundo stereo
- A_STEREO_PL : modo estreo Prologic
limites:
Software = None .
Hardware = None .

9.2.15 AUD_SETVOLUME
Uso: AUD_SETVOLUME < Id > < Volume% >
Descrio:
Este comando usado para mudar a variao de volume de udio
volume.The aplicado a todos
sadas , neste caso . No entanto, possvel , em alguns casos especficos o
volume para
cada sada .
Este comando ir ser melhorada mais tarde ser capaz de executar esta
operao .
parmetros:
< Id > Este parmetro o ID de dispositivo de udio a ser usado [0,1 ... ] .
<Volume % > Este parmetro o volume em porcentagem.
0 o silncio
100 o volume mximo que podemos alcanar.
limites:
Software = None .
Hardware = None .
9.2.16 AUD_SPDIF
Uso: AUD_SPDIF < Id > < Mode>
Descrio:
Este comando usado para alterar a configurao de sada SPDIF.
Podemos usar isso
funo para alternar entre a sada comprimido comprimido ou no ou
simplesmente para
desativar a sada SPDIF . Alterar o modo SPDIF na mosca no possvel
para
Famlias STx710x / STx520x / STx7200 , o udio deve ser interrompido
em primeiro lugar.
parmetros:
< Id > Este parmetro o ID de dispositivo de udio a ser usado [0,1 ... ] .
< Mode> Este parmetro o modo SPDIF para ser configurado
Ele pode ter os seguintes valores :
- A_COMPRESSED : sada SPDIF est no modo comprimido ( 5.1)
- A_NONCOMPRESSED : sada SPDIF no comprimido ( PCM 2
canais)
- A_OFF : sada SPDIF est fora
limites:
Software = None .
Hardware = None .
9.2.17 AUD_STATUS
Uso: AUD_STATUS < Id > [ <Reset >]
Descrio:
Este comando usado para verificar o status do dispositivo de udio ,
exibindo alguns
Estatsticas informaes , como o nmero de quadros de udio
decodificado ....
parmetros:
< Id > Este parmetro o ID de dispositivo de udio a ser usado [0,1 ... ] .
<Reset > Este parmetro uma bandeira que poderia ser definido como 1
para redefinir o atual
estatsticas e colocar todos os campos a 0.
limites:
Software = None .
Hardware = None .