FR
Texas Instruments logo
Notice d'utilisation officielle

Texas Instruments Codec Engine Server

36 pages·205 KB·Logiciels·PDF·ENDEFRITNLJA
Texas Instruments Codec Engine Server
Table des matières 34 sections Guide de l'utilisateur pour intégrateur de serveur moteur Codec · Préface · Sommaire · Aperçu du moteur Codec · … AfficherMasquer
Page 1 of the Texas Instruments Codec Engine Server user manual — Intégration du serveur moteur Codec
Page 1 · cliquer pour agrandir
Page 1

Intégration du serveur moteur Codec

Guide de l'utilisateur

Numéro de littératureENSEMENCÉ5B

Septembre 2007

Page 2 of the Texas Instruments Codec Engine Server user manual — AVIS IMPORTANT
Page 2 · cliquer pour agrandir
Page 2

AVIS IMPORTANT

Texas Instruments Incorporated et ses filiales (TI) se réservent le droit de procéder à des corrections, modifications, améliorations, améliorations et autres changements à tout moment dans leurs produits et services et d'interrompre tout produit ou service sans préavis. Les clients devraient obtenir les dernières informations pertinentes avant de passer des commandes et vérifier que ces informations sont à jour et complètes. Tous les produits sont vendus selon les conditions de vente fournies par TI au moment de la commande.

TI garantit la performance de ses produits matériels selon les spécifications applicables au moment de la vente conformément à la garantie standard de TI. Les essais et autres techniques de contrôle de la qualité sont utilisés dans la mesure où TI le juge nécessaire pour soutenir cette garantie. Sauf si les exigences du gouvernement le prescrivent, l'essai de tous les paramètres de chaque produit n'est pas nécessairement effectué.

TI n'assume aucune responsabilité pour l'assistance aux applications ou la conception de produit client. Les clients sont responsables de leurs produits et applications en utilisant des composants TI. Afin de réduire au minimum les risques associés aux produits et applications des clients, ceux-ci devraient fournir des garanties adéquates en matière de conception et d'exploitation.

TI ne garantit pas ou ne signifie pas qu'une licence, expresse ou implicite, est accordée en vertu d'un droit de brevet TI, d' un droit d'auteur, d 'un droit sur le travail masque ou d'autres droits de propriété intellectuelle TI relatifs à toute combinaison, machine ou procédé dans lequel des produits ou services TI sont utilisés. Les informations publiées par TI concernant des produits ou services tiers ne constituent pas une licence de TI pour utiliser ces produits ou ces services, ni une garantie ou un aval. L'utilisation de ces informations peut exiger une licence d'un tiers en vertu des brevets ou autres droits de propriété intellectuelle du tiers, ou une licence de TI en vertu de brevets ou d'autres droits de PI.

La reproduction des informations TI dans les livres de données ou les fiches techniques ne peut être autorisée que si la reproduction est sans modification et accompagnée de toutes garanties, conditions, limitations et avis associés. La reproduction de ces renseignements avec modification est une pratique commerciale injuste et trompeuse. TI n'est pas responsable de ces documents modifiés. Les informations fournies par des tiers peuvent faire l'objet de restrictions supplémentaires.

La revente de produits ou services TI avec des déclarations différentes ou au-delà des paramètres énoncés par TI pour ce produit ou service vide toutes garanties expresses et implicites pour le produit ou le service TI associé et est une pratique commerciale injuste et trompeuse. TI n'est pas responsable de ces déclarations.

Les produits TI ne sont pas autorisés à être utilisés dans des applications critiques pour la sécurité (comme le soutien de vie) lorsqu'on peut raisonnablement s'attendre à ce qu'une défaillance du produit TI cause une blessure grave ou un décès, sauf si les agents des parties ont conclu une entente régissant expressément cette utilisation. Les acheteurs affirment avoir toute l'expertise nécessaire dans les ramifications de sécurité et de réglementation de leurs applications, et reconnaissent et conviennent qu'ils sont responsables uniquement de toutes les exigences légales, réglementaires et liées à la sécurité concernant leurs produits et de toute utilisation des produits TI dans ces applications critiques en matière de sécurité, nonobstant toute information ou tout soutien liés aux applications qui pourrait être fourni par TI. De plus, les acheteurs doivent indemniser pleinement TI et ses représentants contre tout dommage découlant de l'utilisation des produits TI dans ces applications critiques pour la sécurité.

Les produits TI ne sont ni conçus ni destinés à être utilisés dans des applications ou des environnements militaires/aérospatials, sauf si les produits TI sont spécifiquement désignés par TI comme étant de qualité militaire ou « plastique amélioré ». Seuls les produits désignés par l'IT comme étant militaires satisfont aux spécifications militaires. Les acheteurs reconnaissent et conviennent que toute utilisation de produits TI que TI n'a pas désigné comme étant de qualité militaire est uniquement aux risques de l'acheteur, et qu'ils sont seuls responsables du respect de toutes les exigences légales et réglementaires relatives à cette utilisation.

Les produits TI ne sont ni conçus ni destinés à être utilisés dans des applications ou des environnements automobiles, sauf si les produits TI spécifiques sont désignés par la technologie de l'information comme conformes aux exigences ISO/TS 16949. Les acheteurs reconnaissent et conviennent que, s'ils utilisent des produits non désignés dans les applications automobiles, TI ne sera pas responsable de tout manquement à ces exigences.

Voici les URLs où vous pouvez obtenir des informations sur d'autres produits Texas Instruments et solutions d'application:

Amplificateurs.ti.com Audio Le site Web de l'OMPI www.ti.com/audio

Convertisseur de données Data Converters.ti.com Automobile www.ti.com/automotive

DSP dsp.ti.com Haut débit Le système de gestion des risques est utilisé pour la mise en place d'un réseau de surveillance et de contrôle.

Interface.ti.com Contrôle numérique www.ti.com/numériquecontrol

Logique logique.ti.com Militaire www.ti.com/militaire

Puissance Mgmt.ti.com Réseautage optique www.ti.com/réseau optique

Microcontrôleurs microcommandeurs.ti.com Sécurité www.ti.com/sécurité

RFID Le site www.ti-rfid.com Téléphonie www.ti.com/téléphonie

Sans fil à faible puissance www.ti.com/lpw Imagerie et vidéo www.ti.com/vidéo

Sans fil www.ti.com/sans fil

Adresse postaleTexas Instruments, Boîte postale 655303, Dallas, Texas 75265

Copyright © 2007, Texas Instruments Incorporated

Produits Applications

Page 3 of the Texas Instruments Codec Engine Server user manual — Documents et ressources supplémentaires
Page 3 · cliquer pour agrandir
Page 3

Préface

A propos de ce livre

L'audience prévue pour ce document est l'intégrateur de serveur, qui crée un Serveur Codec à utiliser par l'integrateur de moteur et donc l'Auteur d'application.

Ce manuel indique les étapes que l'intégrateur de serveur devrait prendre pour configurer DSP/BIOS et d'autres composants pour créer un Serveur Codec.

Documents et ressources supplémentaires

Vous pouvez utiliser les sources suivantes pour compléter ce guide utilisateur:

-Référence de l'API du moteur Codec. CE INSTALL DIR/docs/html/index.html

❏ Guide de référence SPI du moteur Codec- Oui. CE INSTALL DIR/docs/spi/html/index.html

- Référence de configuration. CE INSTALL DIR/packages/xdoc/index.html

- Exemple de construction et d'exécution des instructions. CE INSTALL DIR/exemples/build instructions.html

❏ Codec Moteur Application Developer -Guide (PRÉCITÉ67)

❏ Codec Moteur Algorithme Créateur User Utilisateurs Guide (SPARU6)

❏ xDAIS-DM (médias numériques) Guide de l'utilisateur (SPRUC8)

❏ TMS320 Règles et lignes directrices normalisées sur l'algorithme DSP (SPRU352)

❏ Référence de l'API standard d'algorithme DSP TMS320 (SPRU360)

❏ TMS320 DSP Algorithm Standard Developer -Guide (SPRU424)

❏ TMS320 Application de démonstration standard pour l'algorithme DSP (SPRU361)

❏ Guide de l'utilisateur XDC et d'autres documents du XDC. XDC INSTALL DIR/doc/index.html

Page 4 of the Texas Instruments Codec Engine Server user manual — GPP+DSP
Page 4 · cliquer pour agrandir
Page 4

Conventions relatives à la notation

Ce document utilise les conventions suivantes:

- Les listes de programmes, les exemples de programmes et les affichages interactifs sont affichés dans une police spéciale. Exemples utilisent un Version en gras de la face spéciale pour l'accent; les affichages interactifs utilisent Version en gras de la police spéciale pour distinguer les commandes que vous entrez des éléments affichés par le système (p. ex., invites, sortie de commande, messages d'erreur, etc.).

- Les crochets ( [ et ] ) identifient un paramètre optionnel. Si vous utilisez un paramètre optionnel, vous spécifiez les informations entre parenthèses. Sauf si les crochets sont placés dans une gras n'entrez pas les crochets eux-mêmes.

- Ce manuel utilise une icône comme celle à gauche pour identifier les informations spécifiques à un type de système particulier. Par exemple, cette icône identifie les informations qui s'appliquent si vous utilisez Codec Engine sur un système GPP+DSP à double processeur.

GPP+DSP

Marques

Le logo Texas Instruments et Texas Instruments sont des marques déposées de Texas Instruments. Les marques de commerce des instruments du Texas comprennent : TI, DaVinci, XDS, Compositeur de code, Compositrice de code Studio, Probe Point, Code Explorer, DSP/BIOS, RDTX, Laboratoire DSP en ligne, DaVinci, TMS320C54x, T MS320 C55x, GSM320c62x, MGS320-C64x, TMS320 c67x, MTS330C5000 et TMS32C6000.

MS-DOS, Windows et Windows NT sont des marques de commerce de Microsoft Corporation.

UNIX est une marque déposée de The Open Group aux États-Unis et dans d'autres pays.

Linux est une marque déposée de Linus Torvalds.

Solaris, SunOS et Java sont des marques déposées ou des marques de commerce de Sun Microsystems, Inc.

Tous les autres noms de marque, de produit et de service sont des marques ou des marques déposées de leurs sociétés ou organisations respectives.

Page 5 of the Texas Instruments Codec Engine Server user manual — Table des matières
Page 5 · Table des matières
Table des matières

Table des matières

Page 7 of the Texas Instruments Codec Engine Server user manual — Chapitre 1
Page 7 · cliquer pour agrandir
Page 7

Chapitre 1

Aperçu du moteur Codec

Ce chapitre introduit le moteur Codec.

1.1 Qu'est-ce que le moteur Codec? 1–2

1.2 Pourquoi devrais-je l'utiliser? 1–3

1.3 Où le moteur Codec s'intègre-t-il dans mon architecture? 1 à 4

1.4 Quels sont les rôles de l'utilisateur? 1–6

1.5 Où puis-je obtenir plus d'informations? 1 à 9

Sujet Page

Page 8 of the Texas Instruments Codec Engine Server user manual — GPP+DSP
Page 8 · cliquer pour agrandir
Page 8

Qu'est-ce que le moteur Codec?

1.1 Qu'est-ce que le moteur Codec?

Du point de vue du développeur d'applications, le moteur Codec est un ensemble d'API que vous utilisez pour activer et exécuter des algorithmes xDAIS. Une interface VISA est également fournie pour interagir avec les algorithmes xDAIS conformes aux XDM.

L'API est la même pour toutes les situations suivantes :

- L'algorithme peut fonctionner localement (sur le GPP) ou à distance (sur la DSP).

-Le système peut être un seul GPP+DSP, DSP ou GPP.

- Tous les GPP et DSP pris en charge ont la même API.

- Tous les systèmes d'exploitation pris en charge ont la même API. Par exemple, Linux, PrOS, VxWorks, DSP/BIOS et WinCE.

GPP+DSP

Ce manuel utilise une icône comme celle de gauche pour identifier les informations spécifiques à un type particulier de système. Par exemple, cette icône identifie les informations qui s'appliquent si vous utilisez Codec Engine sur un système GPP+DSP à double processeur.

xDM est la norme d'interface eXpressDSP Algorithm pour les médias numériques. Il est parfois appelé xDAIS-DM.

Tout algorithme xDM est conforme à la norme eXpressDSP Algorithm Interface Standard (xDAIS). De plus, il implémente l'interface xDAIS-DM (xDM), une extension à la norme xDais qui fournit un support pour les encodeurs de médias numériques, décodeurs et codecs. La spécification xDM définit les API pour les codecs numériques par classe, avec des extensions définies pour les classes de vidéo, d'imagerie, de parole et de codec audio.

Les interfaces xDM divisent les algorithmes de codec en quatre classes : Vidéo, Image, Speech et Audio (VISA). VISA reflète cette interface xDM. Un ensemble d'API est fourni par classe de codec. Ainsi, MP3 peut être remplacé par WMA sans changer le code source de l'application. Seule la configuration doit être modifiée.

Le moteur Codec prend également en charge la visibilité non intrusive en temps réel dans l'exécution du codec. Il fournit des API pour accéder à la mémoire et les statistiques d'utilisation du processeur global et l'information de trace exécution.

Le moteur Codec est fourni sous forme binaire. Ainsi, les bibliothèques d'applications construites avec la même version Codec Engine sont toujours compatibles.

Page 9 of the Texas Instruments Codec Engine Server user manual — GPP+DSP
Page 9 · cliquer pour agrandir
Page 9

Pourquoi devrais-je l'utiliser?

1.2 Pourquoi devrais-je l'utiliser?

Le moteur Codec est conçu pour résoudre certains problèmes communs associés au développement d'applications système sur puce (SoC). Les problèmes les plus importants sont notamment les suivants :

-Le débogage dans un environnement de processeur hétérogène peut être douloureux. Il y a plusieurs débogueurs et des bootstraping complexes.

- Différentes implémentations du même algorithme, comme MP3, ont des API différentes. Le passage à un algorithme plus efficace implique une recodage importante.

- Les problèmes de transférabilité sont aggravés par deux processeurs. Vous pouvez vouloir transférer vers un autre tableau avec un nouveau DSP ou un nouveau GPP.

- Certains algorithmes peuvent fonctionner soit sur le GPP, soit sur la DSP. Pour équilibrer la charge du système, les algorithmes -Low complexité peuvent fonctionner sur un GPP, mais la définition de -Lelow=C change au fil du temps. Si changer l'emplacement où l'algorithme fonctionne était facile, vous n'auriez pas à peser les problèmes de performance contre la difficulté de modifier l'application.

- Pour réussir sur le marché, la plupart des applications doivent prendre en charge plusieurs codecs pour gérer le même type de média. Par exemple, une application peut avoir besoin de prendre en charge trois ou quatre formats audio.

GPP+DSP

- Les programmeurs avec un processeur généraliste ne veulent pas avoir à apprendre à être des programmeurs DSP. Ils ne veulent pas avoir à s'inquiéter d'un DSP , la gestion de mémoire complexe et les problèmes en temps réel DSP.

Le moteur Codec répond à ces problèmes en fournissant une architecture logicielle standard et des interfaces pour l'exécution d'algorithmes. Le moteur Codec est:

❏ Facile à utiliser. Les développeurs d'applications spécifient quel algorithme doit être exécuté, pas comment ou où.

❏ Extensible et configurable. De nouveaux algorithmes peuvent être ajoutés par n'importe qui, en utilisant des outils et des techniques standard.

❏ Portable. Les API sont des cibles, une plate-forme et même un codec indépendant.

Aperçu du moteur Codec 1-3

Page 10 of the Texas Instruments Codec Engine Server user manual — API VISA APIs de base APIs moteur
Page 10 · cliquer pour agrandir
Page 10

Où le moteur Codec s'intègre-t-il dans mon architecture?

1.3 Où le moteur Codec s'intègre-t-il dans mon architecture?

Le code d'application (ou le middleware qu'il utilise) appelle les API du moteur Codec. Dans le moteur Codec, les API VISA utilisent des stubs et des squelettes pour accéder au moteur de base et aux codecs réels, qui peuvent être locaux ou à distance.

La figure suivante montre l'architecture générale d'une application utilisant le moteur Codec. Il montre également les rôles d'utilisateur impliqués dans la création de différentes parties de l'application. Voir section 1.4. Quels sont les rôles de l'utilisateur? pour plus de détails sur les rôles des utilisateurs.

Rôle 4Demande

Codec Durée de fonctionnement du moteur

API VISA APIs de base APIs moteur

Rôle 3:

Noyau En Durée de fonctionnement du moteur principalIGP de gine

Rôle 2:

VISA SPIS VISA SPIS VISA SPUS

Rôle 1Algorithme

VC1 Encode MP4 Encodage

L'application (ou intergiciel qu'elle utilise) appelle les API moteur de base et les API VISA. Les API VISA utilisent des stubs pour accéder aux SPI (System Programming Interfaces) du moteur de base et aux squelettes. Les squelettes accèdent aux SPI du moteur et aux SPG VISA. Les SPI VISA accèdent aux algorithmes sous-jacents.

Afficher 16 autres étiquettes / texte court sur cette page
Demande · Demande · Auteur · média intergiciel · média intergiciel · Intégrateur de moteur · Encodage vidéo · stubs Encode vidéo · les talons · Encodage vidéo · squelette Encode vidéo · squelette · Intégrateur de serveur · Encoder MP4 · Encode VC1 · Créateur
Page 11 of the Texas Instruments Codec Engine Server user manual — …
Page 11 · cliquer pour agrandir
Page 11

Où le moteur Codec s'intègre-t-il dans mon architecture?

La figure suivante est une modification du diagramme précédent qui montre comment cette architecture est distribuée dans un système GPP+DSP. Dans cet exemple, les portions jaunes sont utilisées pour le PGP et les parties grises pour le DSP. C'est le squelette du codeur vidéo et les codes encodeurs vidéo sont sur le DSP et les talons de l'application et du coder vidéo sont dans le GPP.

GPP+DSP

Codec Durée de fonctionnement du moteur

API VISA APIs moteur de base APIs VISA APIs moteurs de base

Texas Instruments Codec Engine Server — GPP+DSP diagram (page 11)
Fig. 1

Moteur de base SPI Moteur de référence

…

VISA SPIS VISA SPIS

VC1 Encode MP4 Encodage

Comme le moteur Codec est flexible, d'autres diagrammes peuvent être affichés pour les systèmes GPP seulement et DSP uniquement.

Aperçu du moteur Codec 1-5

Afficher 17 autres étiquettes / texte court sur cette page
Demande · média intergiciel · Encodage vidéo · stubs Encode vidéo · les talons · Moteur de base · Durée · Encodage vidéo · squelette Encode vidéo · squelette · processeur app · processeur app · Encoder MP4 · Serveur DSP · Serveur DSP · Encode VC1 · local seulement
Page 12 of the Texas Instruments Codec Engine Server user manual — 1.4.1 Créateur d'algorithme
Page 12 · cliquer pour agrandir
Page 12

Quels sont les rôles de l'utilisateur?

1.4 Quels sont les rôles de l'utilisateur?

Le moteur Codec a plusieurs cas d'utilisation client, des développeurs d'applications côté GPP aux auteurs de codec côté DSP. Dans certains cas, ces rôles peuvent être joués par une seule personne. Dans d'autres environnements de développement, un développeur différent peut se voir attribuer chaque rôle. Ce sujet décrit les rôles principaux que joueront les utilisateurs de Codec Engine.

Parce que le moteur Codec est très portable et configurable et peut fonctionner dans de nombreux environnements différents, les descriptions de ces rôles sont intentionnellement généralisées. Le cas échéant, des environnements matériels et logiciels spécifiques sont décrits après les descriptions générales.

Ce document décrit les API disponibles pour l'auteur de la demande. D'autres documents sont cités pour les autres rôles.

1.4.1 Créateur d'algorithme

Le Créateur Algorithme est responsable de la création d'un algorithme xDAIS, et fournit l'emballage nécessaire pour permettre à ces algorithmes d'être consommés et configurés par Codec Engine.

Si le codec est compatible avec xDM, les API VISA du moteur Codec supportent l'exécution à distance sans prise en charge supplémentaire. Cependant, si le codec n'est pas conforme à xDM et que les codescs supportent l'exécution à distance, le Créateur d'Algorithme devrait fournir des squelettes et des stubs Codec Engine.

Le Créateur Algorithm utilise xDAIS et les outils XDC, qui comprennent un kit de configuration. En utilisant ces derniers, le Créateur Algorithm génère une bibliothèque de codec avec les symboles iAlg et l'interface optionnelle iDMA3 exportés. Cette personne implémente également l'interface ti.sdo.ce.ICodec, en se référant aux symboles exportés de la bibliothèque codec.

Le Créateur Algorithm remet un paquet Codec libéré à l'intégrateur serveur. Cela inclut probablement une ou plusieurs bibliothèques et les métadonnées du paquet XDC.

Le Créateur de l'algorithme utilise les ressources suivantes:

❏ Guide de l'utilisateur pour le créateur d'algorithme moteur Codec (SPARU6)

❏ xDAIS-DM (médias numériques) Guide de l'utilisateur (SPRUC8)

❏ Référence de l'API xDM. XDAIS INSTALL DIR/docs/html/index.html

❏ TMS320 Règles et lignes directrices normalisées sur l'algorithme DSP (SPRU352)

❏ Référence de l'API standard d'algorithme DSP TMS320 (SPRU360)

❏ TMS320 DSP Algorithm Standard Developer -Guide (SPRU424)

- Exemple de codecs

Page 13 of the Texas Instruments Codec Engine Server user manual — 1.4.2 Intégrateur de serveur
Page 13 · cliquer pour agrandir
Page 13

Quels sont les rôles de l'utilisateur?

1.4.2 Intégrateur de serveur

Pour soutenir les moteurs avec codecs distants, un serveur Codec doit être créé. Le serveur Codec intègre les différents composants nécessaires pour héberger les codecs (par exemple : DSP/BIOS, Composants de cadre, pilotes de liaison, codecs, moteur Codec, etc.) et génère un exécutable.

Il y a deux étapes de configuration que l'intégrateur du serveur Codec doit effectuer, une pour configurer DSP/BIOS (par un script Tconf) et une pour configurer le reste des composants (via la configuration XDC des composants Framework, Link, Codec Engine, etc.).

L'intégrateur serveur reçoit les différents paquets Codec de Algorithm Creators. Cette personne utilise Codec Engine et ses paquets dépendants (DSP/BIOS, DSKT2, etc.) avec les outils XDC pour créer ce qui suit :

- Un fichier de configuration du serveur (.cfg)

- Un fichier de configuration DSP/BIOS du serveur (.tcf)

- Une simple routine main() pour effectuer une initialisation minimale

- Un exécutable DSP créé en exécutant les scripts de configuration et en compilant la sortie. Cet exécutable est un serveur Codec.

L'intégrateur serveur transmet l'exécutable DSP à l'intégrateurs moteur (de préférence sous forme de paquetage Codec Server). L'intégrateur de serveur devrait également fournir une liste des codecs du serveur Codec.

L'intégrateur de serveur utilise les ressources suivantes:

- Référence de configuration. CE INSTALL DIR/packages/xdoc/index.html

- Exemple de serveurs Codec

Pour les applications qui n'utilisent que des algorithmes locaux, le serveur Codec n'est pas utilisé, donc ce rôle n'a pas à être exigé.

Aperçu du moteur Codec 1-7

- Ce manuel · local seulement

Page 14 of the Texas Instruments Codec Engine Server user manual — 1.4.4 Auteur de la demande
Page 14 · cliquer pour agrandir
Page 14

Quels sont les rôles de l'utilisateur?

1.4.3 Intégrateur du moteur

L'intégrateur de moteurs définit différentes configurations du moteur. Cela peut inclure les noms des moteurs, ainsi que les codecs et leurs noms dans chaque moteur, que chaque codec soit local ou distant par rapport à l'application, quels groupes chaque codeC devrait être intégré dans (pour les environnements qui supportent le partage de ressources), le nom de l'image du serveur Codec si un moteur particulier contient des codecs distants, etc. Ceci est fait via un script de configuration XDC (*.cfg).

Ce script, lorsqu'il est exécuté, génère du code et crée des instructions appropriées pour la configuration.

L'intégrateur de moteurs reçoit le nom d'un serveur Codec et une liste des codecs qu'il contient à partir du intégrateur de serveurs. À l'aide de ces données, cette personne crée un fichier de configuration du moteur (.cfg) qui peut renvoyer à un serveur Codec. (Sur les plateformes locales seulement, le serveur Codec n'est pas utilisé.)

L'intégrateur de moteurs transmet le fichier de configuration du moteur à l'auteur de l'application.

L'intégrateur de moteurs utilise les ressources suivantes:

Chapitre 5 Codec Moteur Application Developer -Guide (PRÉCITÉ67)

- Référence de configuration. CE INSTALL DIR/packages/xdoc/index.html

- Exemple de construction et d'exécution des instructions. CE INSTALL DIR/exemples/build instructions.html

- Exemple de scripts de configuration (*.cfg)

1.4.4 Auteur de la demande

L'application utilise les API de moteur Codec (Engine , VISA et autres API utilitaires) pour créer/supprimer des instances de moteurs préconfigurées, créer/détruire et interagir avec les codecs, acquérir des tampons appropriés aux codescs, etc.

Puisque Codec Engine n'effectue aucune E/S, l'application est responsable de la gestion des E/s. Cela inclut l'accès aux fichiers (par exemple, open/read/write/seek/close) et l'interaction des pilotes (p. ex. open/closer/ioctl et gestion du tampon).

L'auteur de la demande est responsable de l'élaboration du code d'application et de la liaison entre le « contenu approprié » et l'image exécutable.

L'auteur de la demande reçoit les renseignements suivants :

Page 15 of the Texas Instruments Codec Engine Server user manual — 1.5 Où puis-je obtenir plus d'informations?
Page 15 · cliquer pour agrandir
Page 15

Où puis-je obtenir plus d'informations?

- Divers paquets Codec de créateurs d'algorithmes

- Un serveur Codec DSP exécutable à partir de l'intégrateur du serveur si codec fonctionne sur un DSP

- Un fichier de configuration du moteur (.cfg) à partir de l'intégrateur de moteurs

Le code d'application de l'Auteur de l ́Application, génère la sortie à partir du fichier de configuration du moteur (fichier de sortie.c et .xdl) en utilisant les outils XDC, compile le code d ́application et généré des fichiers. Cette personne lie ensuite les fichiers, y compris le fichier de commande de lien généré (.xdl) dans un exécutable. Le résultat final est l'exécutable de l'application.

Le processus de production d'une application exécutable dépend fortement du système d'exploitation de l'application. Si l'application fonctionne sur le DSP en utilisant DSP/BIOS, par exemple, un fichier .tcf est nécessaire pour configurer également le noyau DSP / BIOS. Si l'application fonctionne sous Linux, l' application n'a pas besoin de configurer le système d'exploitation.

L'auteur de la demande utilise les ressources suivantes :

❏ Codec Moteur Application Developer -Guide (PRÉCITÉ67)

-Référence de l'API du moteur Codec. CE INSTALL DIR/docs/html/index.html

- Exemple de construction et d'exécution des instructions. CE INSTALL DIR/exemples/build instructions.html

1.5 Où puis-je obtenir plus d'informations?

Le fichier release notes.html en haut de l'installation du moteur Codec fournit des informations générales, des informations sur les changements dans la dernière version, des données sur les appareils pris en charge et la validation, des problèmes connus et des liens vers la documentation en ligne fournie avec le moteur CodeC. La documentation en ligne fournie avec le moteur Codec est la suivante:

❏ Référence de l'API moteur Codec. CE INSTALL DIR/docs/html/index.html

❏ Référence de configuration. CE INSTALL DIR/packages/xdoc/index.html

❏ Exemple de construction et d'exécution des instructions. CE INSTALL DIR/exemples/build instructions.html

Pour plus d'informations sur xDM, voir le xDAIS-DM (médias numériques) Guide de l'utilisateur (SPRUEC8).

Aperçu du moteur Codec 1-9

Page 16 of the Texas Instruments Codec Engine Server user manual — 1.5 Où puis-je obtenir plus d'informations?
Page 16 · cliquer pour agrandir
Page 16
Page 16 of the Texas Instruments Codec Engine Server user manual — 1.5 Où puis-je obtenir plus d'informations?
Page 17 of the Texas Instruments Codec Engine Server user manual — Chapitre 2
Page 17 · cliquer pour agrandir
Page 17

Chapitre 2

Configuration d'un serveur Codec

Ce chapitre décrit comment l'intégrateur de serveur doit configurer un serveur Codec pour utilisation par l' intégrateur moteur.

2.1 Aperçu général 2-2

2.3 Livraison d'un serveur Codec 2–16

Sujet Page

Page 18 of the Texas Instruments Codec Engine Server user manual — 2.1 Aperçu général
Page 18 · cliquer pour agrandir
Page 18

2.1 Aperçu général

Comme indiqué à la section 1.4.2, Intégrateur de serveur, l'intégrateur de serveur fournit un Serveur Codec à l'integrateur moteur. Dans la pratique, ces rôles peuvent être partagés par une seule personne.

Il y a deux étapes de configuration que l'intégrateur serveur effectue :

- Configurer DSP/BIOS par un script Tconf

- Configurer "le reste" des composants par la configuration XDC de composants cadres, DSP/BIOS Link, le moteur Codec, etc.

L'intégrateur serveur reçoit divers paquets Codec de Algorithm Creators, ainsi que des paquets d'autres composants du système (par exemple, les composants Framework et le moteur Codec).

L'intégrateur de serveurs utilise le moteur Codec et ses paquets dépendants (DSP/BIOS, DSKT2, etc.) avec les outils XDC pour créer ce qui suit :

- Un fichier de configuration du serveur (.cfg)

- Un fichier de configuration DSP/BIOS du serveur (.tcf)

- Une simple routine main() pour effectuer une initialisation minimale

- Un exécutable DSP créé en exécutant les scripts de configuration et combinant les différents paquets. Cet exécutable est un serveur Codec.

L'intégrateur de serveur devrait également fournir une liste des codecs du serveur Codec.

L'intégrateur serveur transmet l'exécutable DSP à l'intégrateurs moteur, qui le fait référence dans le fichier de configuration du moteur. Par exemple, le fichier ceapp.cfg peut contenir une configuration du moteur et la ligne suivante pour identifier le serveur Codec utilisé par le moteur.

vcr.server = "./video copy.x64P";

Aperçu général

Page 19 of the Texas Instruments Codec Engine Server user manual — 2.1.2 Qu'est-ce que le flux d'exécution?
Page 19 · cliquer pour agrandir
Page 19

2.1.1 Qu'est-ce qu'un serveur Codec?

Un serveur Codec est un binaire qui intègre les codecs, les composants framework et le code système. Lorsque le serveur Codec est sur un DSP, il utilise DSP/BIOS comme noyau DSP.

GPP+DSP

Dans le contexte des plateformes DaVinci DM644x (et d'autres plates-formes GPP+DSP), un serveur Codec est un binaire DSP. Il comprend un thread de tâches DSP/BIOS qui répond aux demandes d'un client pour créer des codecs, fournir des informations sur le rendement (utilisation du MIPS et du MEM).

Un serveur Codec fonctionne de la même manière qu'un serveur web. Tout comme le terme "serveur web" peut se référer au matériel réel, au logiciel configuré ou au démon d'exécution, le terme « Serveur Codec » peut se rapporter au DSP, à l'image configurée chargée sur le DSP ou à la tâche d' exécution.

L'application GPP utilise les API VISA pour invoquer des codecs distants sur le DSP. Du point de vue de l'application GPP, l'exécution du codec est complètement transparente et se comporte de la même manière que les codescs sont locaux (sur le GPP) ou distants (sur la DSP). Lorsque vous êtes à distance, Codec Engine gère automatiquement la création nécessaire, la communication, l'invocation et éventuellement la suppression des codecs du DSP.

2.1.2 Qu'est-ce que le flux d'exécution?

Comme exemple de flux d'exécution, sur un système double processeur, comme le périphérique DM644x, les étapes suivantes résument le flux d ́exécution lorsqu'une application GPP utilise un codec à distance pour effectuer l'encodage audio sur le DSP. Après avoir ouvert le moteur, l'application fait des appels aux API VISA qui gèrent les trois phases d'exécution de codec à distance comme suit:

1. L'application appelle l'API de création VISA (par exemple, AUDENC create() ) pour créer une instance d'algorithme sur le DSP:
  • Premièrement, un objet d'instance générique est créé sur le GPP pour tenir l'état nécessaire, les poignées, les pointeurs de fonction, etc.
  • Un objet local "noeud" est créé pour recevoir la communication du nœud "à distance".
  • Un message « create » est formé pour signaler le répartiteur de fonctions sur le DSP afin de créer l'instance du noeud distant.
  • Le message de création est envoyé au régulateur sur le DSP.
  • Sur le DSP, le répartiteur reçoit le message « créer ». Certaines vérifications d'erreurs sont effectuées, et les objets DSP-side State sont créés et initialisés.

Configuration d'un serveur Codec 2-3

Aperçu général

Page 20 of the Texas Instruments Codec Engine Server user manual — 2.1.1 Qu'est-ce qu'un serveur Codec?
Page 20 · cliquer pour agrandir
Page 20
  • Une file d'attente de message est créée pour permettre au noeud distant de recevoir des commandes du GPP.
  • La fonction "create" spécifique au noeud (par exemple, AUDENC create() ) est appelée à initialiser l'état du nœud et la mémoire et les ressources spécifiques à un algorithme. (Notez que cet appel est fait dans le contexte de l'exécution du régulateur.)
  • Un thread d'exécution dédié (task) est créé pour le nœud. Le nouveau fil ne fonctionne pas encore, mais il est en état de suspension.
  • Dans le thread du régulateur, les données de l'exemple pour le nouveau noeud sont enregistrées et ensuite le répartiteur envoie une réponse d'état au GPP.
  • En cas de succès, l'objet GPP-side instance est mis à jour avec des poignées et des données appropriées pour le nouveau nœud "à distance".
  • Un message de "démarrage" est alors formé et envoyé au régulateur sur le DSP pour commencer l'exécution du noeud distant.
  • Dès réception de la commande « start », le régulateur côté DSP change la priorité du fil du noeud de suspendu à sa priorité d'exécution configurée. Ce changement de priorité entraîne l'exécution de la fonction "execute" du nœud dans le contexte d'exécution du noeud nouvellement créé. Cette fonction bloque, en attendant les commandes du GPP.
2. L'application appelle l'API du processus VISA (par exemple, AUDENC process() ) qui donne lieu à un appel de procédure distant vers le DSP:
  • Le talon de l'algorithme côté GPP est invoqué et effectue une validation d'arguments basiques.
  • Une structure de message est attribuée et remplie avec des arguments triés, y compris les adresses physiques traduites (DSP) pour les tampons.
  • Le message « process » est envoyé à la file d'attente du noeud distant sur le DSP pour invoquer l'algorithme distant.
  • Du côté DSP, le fil du noeud se réveille à la réception du message « process », et appelle le squelette de l'algorithme.
  • Le squelette démarshallise les arguments et les tampons d'entrée et de sortie, puis invalide les tampon de la cache DSP.
  • Toute mémoire de grattage d'algorithme est alors "activée".
  • La fonction "processus" de l'algorithme est invoquée pour effectuer le codage.

Aperçu général

Page 21 of the Texas Instruments Codec Engine Server user manual — 2.1.3 Que dire des systèmes monoprocesseur?
Page 21 · cliquer pour agrandir
Page 21
  • Toute mémoire de grattage d'algorithme est alors "désactivée".
  • Le squelette writebacks tampons de sortie pour s'assurer que le processeur écrit au cache sont rincées vers la mémoire externe.
  • Le fil du noeud répond alors avec le statut de retour au GPP et bloque ensuite l'attente du prochain message.
  • Retour sur le GPP, le stub unmarshalls outArgs, le message retourné est libéré et un statut est renvoyé à l'application
3. Lorsque le traitement est terminé, l'application appelle l'API de suppression VISA (par exemple, AUDENC delete() ), ce qui fait supprimer l'instance algorithme du DSP :
  • Le formulaire côté GPP et envoie ensuite un message au nœud distant du DSP avec une commande de sortie.
  • Sur le DSP, le noeud distant se réveille à la réception du message « sortie » et envoie un accusé de réception au GPP.
  • Sur le GPP, un message de "supprimer" du noeud est formé et ensuite envoyé au régulateur sur le DSP.
  • Le répartiteur se réveille et supprime le fil d'exécution du noeud distant.
  • La fonction "delete" spécifique au noeud (par exemple, AUDENC deletete() ) est invoquée pour libérer les ressources de l'algorithme et pour effectuer tout nettoyage propre au nœud. (Notez que cet appel vient du contexte d'exécution de l'expéditeur.)
  • L'objet restant côté DSP est supprimé, et une réponse est renvoyée au GPP.
  • Les autres objets de l'instance côté GPP sont supprimés, la file d'attente des messages du noeud distant est fermée et un statut est alors retourné à l'application.

2.1.3 Que dire des systèmes monoprocesseur?

Sur les systèmes où il n'y a pas de codecs "à distance", il n ́est pas nécessaire de configurer un serveur Codec.

Configuration d'un serveur Codec 2-5

Aperçu général

Page 22 of the Texas Instruments Codec Engine Server user manual — 2.1.6 Qu'est-ce que le kit de configuration?
Page 22 · cliquer pour agrandir
Page 22

2.1.4 Quels algorithmes un serveur Codec peut-il intégrer ?

Vous pouvez utiliser n'importe quel algorithme qui est compatible avec xDM dans un serveur Codec.

De plus, si vous voulez utiliser un algorithme non conforme à xDAIS, vous pouvez d'abord implémenter vos propres stubs et squelettes pour cet algorithme, puis l'utiliser dans un serveur Codec. Voir Codec Moteur Algorithme Créateur User Utilisateurs Guide (SPRUED6) pour plus de détails.

Le moteur Codec ne fournit pas d'API pour les algorithmes de chaîne. Cependant, vous pouvez utiliser un algorithme compatible xDM- ou xDAIS qui, derrière son interface exposée, chaînes des algorithmes ensemble.

La spécification xDM définit une API uniforme pour chaque classe d'algorithmes. Du point de vue des applications, cela signifie que la même API sera utilisée pour un codeur H.264 et MPEG-4.

L'algorithme est identifié par une chaîne unique dans la fonction « créer ». Tout le reste devrait rester inchangé. Notez que l'application doit être consciente des restrictions de l'algorithme qu'elle tente d'invoquer. Par exemple, les décodeurs vidéo TI s'attendent à ce qu'une image de données fonctionne correctement.

2.1.5 Quels exemples existent?

Vous pouvez utiliser les serveurs Codec comme exemples pour créer vos propres serveurs CodeC. Ces serveurs sont fournis dans le cadre de la distribution Codec Engine.

2.1.6 Qu'est-ce que le kit de configuration?

Le kit de configuration XDC est un ensemble de paquets et d'outils de configuration qui peuvent être utilisés pour configurer et construire un exécutable. Voici quelques exemples de ces exécutables :

- Un DSP exécutable qui contient des codecs distants (par exemple, un serveur Codec)

- Un DSP exécutable qui contient une application et des codecs locaux (par exemple, un seul processeur Application Codec Engine plus les codecs régionaux)

- Un exécutable GPP qui contient un moteur Codec, impliquant des codecs locaux et/ou distants (par exemple une application de moteur CodeC)

Aperçu général · - INSTALL CE INSTALL DIR/exemples/serveurs/tous codecs · . -CE INStALL DRI/examples/Servers/vidéo copie

Page 23 of the Texas Instruments Codec Engine Server user manual — 2.2.1 Création d'un paquet
Page 23 · cliquer pour agrandir
Page 23

Pour créer un serveur Codec, vous effectuez les étapes de configuration suivantes :

- Configurer DSP/BIOS par un script Tconf

-Configurer le reste des composants par la configuration XDC (par exemple, les composants de cadre, DSP/BIOS Link, le moteur Codec, etc.).

Vous modifierez les fichiers suivants :

❏ paquet.xdc. Le fichier de définition du paquet.

❏ - Je suis désolé. Le script de construction.

❏ nom du serveur.cfg. Le script de configuration du serveur Codec.

❏ nom du serveur.cf. Le script de configuration DSP/BIOS.

Vous pouvez modifier les fichiers supplémentaires suivants:

❏ link.cmd. Un fichier de commande optionnel pour linker.

❏ C. Contient la fonction main() des applications.

Pour commencer à créer un serveur Codec, utilisez les étapes des sous-sections suivantes. Les exemples de cette section utilisent l'exemple CE INSTALL DIR/examples/serveurs/video copy.

Tant que les algorithmes que vous souhaitez utiliser implémentent l'interface xDM, le codage nécessaire est limité à une simple routine main() en code C pour initialiser le moteur Codec. Le reste de l'intégration est en fournissant des informations de configuration pour créer le serveur Codec.

2.2.1 Création d'un paquet

Suivez ces étapes pour configurer des variables d'environnement afin de pointer vers différents outils utilisés dans le processus de construction et pour créer un répertoire avec des fichiers que vous modifierez pour créer votre serveur.

1. Copier en option l'arborescence CE INSTALL DIR/exemples dans un répertoire de travail. Cette étape est facultative mais recommandée afin que vous ayez une copie de sauvegarde.
2. Modifier le fichier examples/user.bld, qui définit les emplacements du contenu sur votre système de développement. Assurez-vous que les chemins de ce fichier correspondent à vos chemins avec les outils TI codegen et d'autres compilateurs et outils OS référencés dans le fichier. Voir exemples/build instructions.html pour plus de détails.

Configuration d'un serveur Codec 2-7

Page 24 of the Texas Instruments Codec Engine Server user manual — 2.2.3 Modification du script de configuration du serveur Codec
Page 24 · cliquer pour agrandir
Page 24
3. Modifier le fichier examples/xdcpaths.mak avec un éditeur de texte pour spécifier les variables CE INSTALL DIR, XDC ROOT et BIOS ROot. Encore une fois, voir exemples/build instructions.html pour plus de détails.
4. Faites un duplicata de l'un des exemples Codec Server dans le répertoire examples/servers. Chacun de ces répertoires est un "paquet". Les paquets doivent avoir des noms qui correspondent à leur emplacement de répertoire. Donc, vous devriez donner à votre répertoire duplicata un chemin qui suit les exemples/ my company / my project / my server nommage convention. Vous nommerez le paquet correspondant à cet emplacement dans la section suivante.

2.2.2 Modifier la définition du paquet

Le fichier package.xdc est le fichier de définition du paquet, qui définit votre nom Codec Server et ses dépendances.

Suivez ces étapes pour nommer votre paquet serveur.

1. Modifier le fichier package.xdc avec un éditeur de texte. Renommer le paquet serveur. Par exemple, pour appeler votre serveur "my server", modifiez la partie en gras comme suit :

colis mon nom de la société.mon projet.my serveur

Le nom du paquet doit refléter la structure de répertoire dans le dossier des exemples. Par exemple, un paquet dans le répertoire example/my company/my project/my/server doit avoir un nom de my companie.my projet.my server. Vous devriez utiliser cette convention de nom d'entreprise pour vous assurer que votre serveur a un nom de paquet unique.

2.2.3 Modification du script de configuration du serveur Codec

Un fichier nommé nom du serveur.cfg configure les aspects non DSP/BIOS du serveur Codec. Pour créer ce fichier pour votre propre serveur, il est préférable de modifier un fichier d'exemple existant.

La syntaxe utilisée dans les configurations de ce serveur est basée sur JavaScript, qui est également utilisé pour le langage Tconf utilisé pour configurer statiquement DSP/BIOS. (Voir SPRU007 pour plus de détails.)

Contrairement au JavaScript utilisé dans les pages Web, un modèle objet est fourni pour répondre aux besoins de configuration du moteur. Ce modèle d'objet est documenté dans la référence de configuration, disponible sur CE INSTALL DIR/xdoc/index.html.

Page 25 of the Texas Instruments Codec Engine Server user manual — 2.2.2 Modifier la définition du paquet
Page 25 · cliquer pour agrandir
Page 25

Pour voir la documentation des attributs du module Serveur, suivez les étapes suivantes :

1. Ouvrez CE INSTALL DIR/xdoc/index.html pour voir la référence de configuration. Selon votre navigateur, vous devrez peut-être activer le contenu actif pour afficher la liste des nœuds à gauche.
2. Cliquez sur le lien vers le paquet ti.sdo.ce.
3. Cliquez sur le lien vers le module Serveur.
4. Vous voyez les paramètres de configuration que vous pouvez définir pour ce module.

Par exemple, vous voyez que la structure threadAttrs a plusieurs champs. Les instructions suivantes font que le module serveur du paquet ti.sdo.ce est disponible dans le script de configuration. Il définit ensuite l'attribut threadAttrs.priority du module Server sur Server.MINPRI. Cela indique que les threads de tâches créés par le serveur Codec doivent être exécutés au niveau minimum de priorité.

Serveur var = xdc.useModule('ti.sdo.ce.Server'); Server.threadAttrs.priority = Server.MINPRI;

Pour créer votre propre fichier *.cfg pour votre serveur, suivez les étapes suivantes :

1. Renommer le fichier *.cfg dans votre répertoire serveur pour correspondre au nom de votre serveur. Par exemple, votre fichier peut s'appeler "my server.cfg".
2. Modifiez le fichier .cfg avec un éditeur de texte.
3. Afin de permettre aux développeurs d'applications d'utiliser le module TraceUtil du côté GPP pour recueillir les informations de log DSP/BIOS, vous devez activer la connexion DSP / BIOS dans votre image serveur DSP. Si la ligne suivante n'est pas déjà dans le script de configuration de votre serveur, vous devriez l'ajouter pour activer la connexion DSP/BIOS :

var LogServer = xdc.useModule('ti.sdo.ce.bioslog.LogServer');

4. Modifier les instructions qui obtiennent des modules codec pour référencer les modules codeC que vous souhaitez utiliser. Utilisez le nom du paquet de votre fournisseur de codec. Exemple de codecs est disponible dans le dépôt "exemples" commençant par l'espace de noms "codecs" (c.-à-d., le répertoire examples\codecs). Vos codecs devraient être "bien nommés" commençant par votre nom de compagnie pour produire des noms uniques de paquets.

Configuration d'un serveur Codec 2-9

Page 26 of the Texas Instruments Codec Engine Server user manual — 2.2.2 Modifier la définition du paquet
Page 26 · cliquer pour agrandir
Page 26

Par exemple, ces instructions du fichier video copy.cfg ont été modifiées (texte gras) pour référencer l'encodeur/décodeur de la parole.

/* obtenir différents modules de codec; c'est-à-dire implémentations de codec */ var SPHDEC_COPY = xdc.useModule('codecs.sphcopier.SPHDEC COPY»); var SPHENC_COPY = xdc.useModule('codecs.sphenc copie.SPHENC_COPY');

5. Modifier les attributs de la structure threadAttrs comme désiré. Voir CE INSTALL DIR/xdoc/index.html pour plus de détails sur ces attributs.

Server.threadAttrs.stackTaille = 2048; Server. threadAtrs.priority = Server.MINPRI;

Ces paramètres configurent le thread Server, qui est utilisé pour créer et supprimer des codecs ainsi que pour soutenir les requêtes d'utilisation dynamique de la ressource. Nous vous recommandons d'utiliser Server.MINPRI pour que vous ne préemptez pas les threads en temps réel.

6. Spécifiez les algorithmes à être disponibles dans ce serveur Codec en modifiant le tableau Server.algs. Par exemple, des instructions du fichier video copy.cfg ont été ajoutées et modifiées (texte gras) pour renvoyer l'encodeur/décodeur de la parole et donner une priorité plus élevée au traitement audio que le traitement vidéo.

Server.algs = [ {nom: "viddec copy", mod: VIDDEC COPY, threadAttrs: { stackTaille: 4096, smackMemId: 0, priorité: Server.MINPRI + 1} }, { nom: "videnc copie", mod : VIDENC COPy, thindAttrs: { StackTimum: 4095, smpMemIId:0, priorité : Server. MINPRI +1} ¢, {nom : "sphdec copie", mod: SPHDEC COPY, threadAttrs: { stackTaille: 4096, smackMemId: 0, priorité: Server.MINPRI + 2}, {nom: "sphenc copie", mod: SPHENC COPY, threadAttrs: { stackTaille: 4096, smackMemId: 0, priorité: Server.MINPRI + 2} }, ];

7. Les fichiers exemple *.cfg configurent également les modules ti.sdo.fc.dskt2.DSKT2 et ti.Sdo. fc.dman3.DMAN3, qui font partie des composants de cadre. DSKT2 est le gestionnaire d'allocation de mémoire de l'algorithme xDAIS, et DMAN3 est le responsable DMA. Voir la documentation des composants du cadre dans CE INSTALL DIR/xdoc/index.html pour plus de détails sur la configuration de ces modules.
Page 27 of the Texas Instruments Codec Engine Server user manual — 2.2.2 Modifier la définition du paquet
Page 27 · cliquer pour agrandir
Page 27

2.2.3.1 Contrôle de la cache tampon E/S pour xDM 0,9 Codecs

Le support du serveur DSP, les "skeletons", pour l'exécution à distance des codecs écrits pour xDM 0.9 gère toujours le cache de tous les tampons I/O de codec échangés avec l'application ARM.

Cela peut être un problème de performance pour certains codecs vidéo, où le codec accède aux tampons exclusivement via DMA, mais le squelette générique invalide et chasse ces tampons de toute façon, gaspillant ainsi jusqu'à quelques millisecondes pour chaque cadre. (Dans les codecs xDM 1.0, cette gestion du cache est négociée automatiquement.)

Pour désactiver la gestion de tampons spécifiques, vous devez déterminer le type de buffer et son nombre, puis définir le champ de gestion du cache pour le tampon à "faux", comme indiqué dans l'exemple suivant.

La première étape consiste à déterminer le type de tampon. Les types de tampons pris en charge sont : "in" et "out" pour les codeurs vidéo et les décodeurs vidéo, "recon" (courte pour la reconstruction) pour les codes vidéo et "display" pour le décoder.

Ensuite, déterminez le nombre de tampons que vous voulez gérer. Les tampons sont numérotés de 0 à 15. Vous recherchez généralement le tampon numéro 0 ou 1.

Enfin, définissez le champ de gestion du cache du tampon à "faux" comme indiqué dans cet exemple:

var H264ENC = xdc.loadModule( "ti.sdo.coDecs.h264enc.H264ENC" ); // ne pas gérer le cache-manage inbuf #0: H264EnC.manageInBufsCache[0] = false; // n'acheminent pas le cache‐manage outbuf no1: H264ENC.maniageOutBufSCache[1] = fallo; / / ne gèrent aucun des tampons de reconstruction: H244EN C.managesReconBufesCache = [ faux, faux, fals, faux, fal, fau, fall, ffals, faux , fald, fold, found, flood, fair, fight, flip, f6, falsed, fant, fonge, fault, foly ];

Les noms de tableaux de gestion du cache sont :

❏ Pour les modules d'encodeur vidéo. gérezInBufsCache[], gérezOutBufSCache [], gérezReconBufesCache(]), chacun avec des éléments 0.15.

❏ Pour les modules de décodeur vidéo. gérezInBufsCache[], gérezOutBufSCache [], makeDisplayBufesCache(), chacun avec des éléments 0,15.

Vérifiez toujours avec un producteur de codec d'abord pour déterminer s'il est sûr d'éteindre la gestion du cache pour certains tampons. En ce qui concerne la mauvaise gestion du cache, les choses peuvent sembler fonctionner sur votre système pour certaines données et dans certaines configurations, mais ne fonctionneront pas pour d'autres données et configurations (que votre client peut utiliser).

Configuration d'un serveur Codec 2-11

Page 28 of the Texas Instruments Codec Engine Server user manual — 2.2.2 Modifier la définition du paquet
Page 28 · cliquer pour agrandir
Page 28

2.2.3.2 Spécifier "Groupe Scratch" et les ressources DMA pour un Codec

Lorsque vous avez assemblé plusieurs codecs dans un seul serveur DSP, il se peut que vous ayez besoin de les faire partager des ressources mémoire et DMA.

Deux codecs peuvent partager ce qu'on appelle une mémoire "rayure". C'est une zone de mémoire de travail, généralement en mémoire interne rapide, qui est initialisée avant qu'un cadre de données soit traité et jeté par la suite. Les codecs ne peuvent partager cette mémoire que s'ils courent à la même priorité. Autrement dit, on ne peut pas en prévenir une autre et détruire ainsi la zone de scratch de l'autre codec au milieu de son travail.

Le partage de zone de scratch est géré par le gestionnaire de mémoire d'algorithme DSP appelé DSKT2, mais vous pouvez modifier la façon dont il gère les zones de sratking en définissant le champ groupId optionnel pour chaque algorithme dans le tableau de configuration Server.algs[].

Si vous ne définissez pas le champ groupId, aucun partage n'aura lieu. C'est bien si vous avez assez de mémoire interne/externe. Sinon, vous pouvez le définir par algorithme, comme c'est le cas dans l'exemple du serveur video copy :

/* Le tableau des algorithmes que ce serveur peut servir. * Ce tableau configure également les détails sur les threads * qui seront créés pour exécuter les algorithmes * (par exemple : taille des piles, priorités, etc.). */ Server.algs = [ { nom: "viddec copy", // C nom pour le mod de codec: VIDDEC COPY, // VIDDec COPI défini ci-dessus threadAttrs: { smackMemId: 0, / // BIOS MEM seg ID pour la priorité de la pile des tâches: Server.MINPRI + 1 // task priority }, groupeId: 0, // identification de groupe de rayures (voir DSKT2 ci-dessous) }, { nom: "videnc copy", mod: VIDENC COPY, threadAttrs: { stackMemId: 0, priorité: Server.MINPRI + 1 } GroupeId: 0, }, ];

Page 29 of the Texas Instruments Codec Engine Server user manual — 2.2.2 Modifier la définition du paquet
Page 29 · cliquer pour agrandir
Page 29

Comment définir le champ groupId peut affecter les performances ou si un codec peut être créé. Pour obtenir des renseignements détaillés sur la mémoire partagée de rayures, consultez la documentation des composants du cadre. Vous pouvez économiser un peu de temps en lisant le commentaire du script de configuration du serveur dans l'exemple video copy, qui se trouve dans /exemples /ti/sdo/ce/examples/serveurs/video copy/vidéo copie.cfg.

Ce qui est vrai pour le partage de la mémoire est également vrai pour partager les ressources DMA entre codecs. Encore une fois, pour plus de détails, veuillez consulter la documentation des composants du cadre ou les commentaires concernant la théorie et la pratique de la configuration DMA dans l'exemple de configuration vidéo copie dans le script mentionné ci-dessus.

2.2.3.3 Plus d'infos sur le champ groupId

Serveur.algs[].groupId

Pour chaque algorithme du tableau algs[] respectif, si le groupeId optionnel n'est pas initialisé, l'algorithme sera configuré en un groupe avec d'autres algorithmes qui ont leur champ groupId non initialisé et exécuté à la même priorité. Si aucun algorithme n'a ces deux attributs, il sera dans un groupeId unique.

Le groupe dans lequel il sera affecté n'est pas déterministe. Il n'est donc pas possible de configurer des ressources de scratch (par exemple, la mémoire de strip DSKT2 et les ressources DMAN3 DMA) pour ce groupeId non déterministe. Il est donc important que, si l'intégrateur de système entend partager les ressources d'un algorithme, le champ groupId soit configuré comme il se doit.

Aussi, si le groupeId est assigné de façon non déterministe et que l'algorithme demande des ressources de grattage, ces ressources seront accordées à partir (probablement non configurées) des pools de ressources !

Par exemple, dans les systèmes basés sur DSKT2, DSKt2 accorde de telles requêtes de mémoire en utilisant le (probablement non configuré) DSK T2.DARAM SCRATH SIZES[] ET DSKT2.SARAM SCHRACH SIZES[] blocs de mémoire. Cela peut conduire à un comportement étrange du système, y compris des algorithmes qui peuvent parfois être créés mais d'autres fois échouent.

Configuration d'un serveur Codec 2-13

Page 30 of the Texas Instruments Codec Engine Server user manual — 2.2.4 Modifier le script de configuration DSP/BIOS
Page 30 · cliquer pour agrandir
Page 30

Moteur.algs[].groupId

Pour chaque algorithme local, si le champ optionnel groupId n'est pas initialisé, l'algorithme est configuré en son propre group-Id unique. C'est parce que nous ne savons pas à quelle priorité l'algorithme va fonctionner, donc nous le plaçons dans un groupe unique pour empêcher la préemption par tout autre algorithme.

2.2.4 Modifier le script de configuration DSP/BIOS

Le serveur Codec fonctionne comme une application DSP/BIOS sur le DSP. En tant que tel, il a une configuration DSP/BIOS statique. Ceci est créé avec un fichier .tcf tel que décrit dans le Guide de l'utilisateur du DSP/BIOS (SPRU007) et dans l'aide en ligne DSP/BIOS. La syntaxe utilisée dans les configurations Tconf est basée sur JavaScript.

Pour créer votre propre fichier .tcf pour votre serveur, suivez les étapes suivantes :

1. Copiez all.tcf depuis CE INSTALL DIR/examples/servers/all codecs dans votre répertoire serveur. Renommer pour correspondre au nom de votre serveur. Par exemple, votre fichier peut être appelé "my server.tcf".
2. Modifier le fichier du nom de serveur .tcf avec un éditeur de texte.
3. Faites les modifications que votre serveur Codec nécessite et enregistrez le fichier.

Pour le serveur Codec, les threads de tâches utilisés pour traiter des algorithmes sont créés dynamiquement au moment d'exécution. Ce fichier de configuration configure statiquement plusieurs aspects du noyau DSP/BIOS, notamment :

-Le noyau de base DSP/BIOS

- Noms, tailles et emplacements de la section Mémoire

-Les attributs spécifiques à la plate-forme tels que les taux d'horloge

-Active le gestionnaire de tâches et l'allocation dynamique du tas

- Configure le cache C64+ L1 et le segment de mémoire correspondant

Vous pouvez en apprendre davantage sur tous ces modules et attributs dans l'aide en ligne DSP/BIOS ou le C6000 Référence API DSP/BIOS (SPRU403).

Vous pouvez ajouter vos propres éléments de configuration moteur non-Codec ici si vous devez ajouter votre propre fonctionnalité au serveur. Les réglages ont été testés pour utilisation avec le moteur Codec tel quel. Vous devriez être prudent à changer les paramètres.

Page 31 of the Texas Instruments Codec Engine Server user manual — 2.2.5 Modifier le script de construction
Page 31 · cliquer pour agrandir
Page 31

2.2.4.1 DSP/BIOS Threads et utilisation de modules

Chaque instance d'algorithme -remote= qui fonctionne sur le DSP exécute dans un thread DSP/BIOS dont la priorité est spécifiée par un paramètre de configuration statique (voir ti.sdo.ce.Server). La taille de la pile du thread qui exécute un algorithme -remote est spécifiée par l'implémentation de l'algorithme de l ́interface ICodec (voir ti.sdo.ce.ICodec).

La première sortie du moteur Codec démarre un thread séparé pour chaque instance d'algorithme -. Ainsi, deux instances du même algorithme fonctionnent en deux threads séparés (même si ces thread ont la même taille de pile et la même priorité). Les futures versions peuvent exécuter ces instances en un seul thread. Cependant, les instances d'algorithmes qui nécessitent des priorités différentes seront toujours exécutées dans des threads séparés.

La création et la suppression de threads d'instance algorithme est gérée par un thread du gestionnaire des ressources (RMS). Ce thread fait partie du cycle de moteur Codec et, par défaut, fonctionne à la plus faible priorité possible afin d'éviter d'affecter le traitement en temps réel effectué par des instances algorithmes -remote. Le fil RMS fournit également des services de surveillance des ressources pour le cycle moteur Codec. Par exemple, il rapporte la charge globale du processeur DSP au GPP, transfère les données de trace d'exécution du DSP vers le GPP et contrôle l'acquisition des informations de traces DSP en fonction des commandes GPP.

Bien que le moteur Codec utilise les services DSP/BIOS CLK, la version initiale ne nécessite pas d'interruptions de minuterie et configure l'interruption DSP / BIOS CLk pour fonctionner une fois toutes les 5 secondes. À l'avenir, le moteur Codec pourrait exiger des taux d'interruption allant jusqu'à 1/seconde pour soutenir les chronomètres de surveillance et la récupération à partir de défaillances de CIB.

Pour supporter la surveillance de charge du CPU, le moteur Codec ajoute une fonction de ralenti à la boucle de ralenti DSP/BIOS. L'implémentation actuelle permet également à d'autres fonctions de ralenti spécifiées par l'application. Cependant, pour supporter les modes de faible puissance du DSP, les futures implémentations peuvent faire tourner le processeur, ce qui empêche d'autres fonctions de ralenti.

2.2.5 Modifier le script de construction

Modifier le fichier package.bld avec un éditeur de texte. Ce script de construction est exécuté par le makefile. En plus de compiler le code, le script build exécute les scripts de configuration DSP/BIOS et XDC et relie les exécutables ensemble.

Configuration d'un serveur Codec 2-15

Page 32 of the Texas Instruments Codec Engine Server user manual — 2.3 Livraison d'un serveur Codec
Page 32 · cliquer pour agrandir
Page 32

Livraison d'un serveur Codec

Modifier le texte en gras dans la ligne suivante pour correspondre au nom de votre serveur :

var serverName = "mon serveur";

Lorsque vous aurez terminé le développement, vous voudrez peut-être changer « débogage » dans la ligne suivante pour « libérer » :

Profile de Pkg.attrs = "libération";

Ne modifiez pas package.mak, aucun fichier qui commence par une période, ou quelque chose dans le répertoire "package". Ces fichiers sont générés lorsque vous construisez. Toute modification de ces fichiers est écrasée chaque fois que vous rebâtissez.

2.2.6 Modifier le fichier de commande du Linker

Si vous voulez spécifier d'autres commandes de linker DSP, ajoutez ces commandes au fichier de commande link.cmd linkers.

2.2.7 Modifier le fichier main.c

Vous pouvez ajouter au fichier source main.c si nécessaire. Puisque DSP/BIOS exécute ses threads après main(), vous ne devriez mettre les instructions d'initialisation que dans main() et main( ) doit tourner à la fin plutôt qu'en boucle.

2.2.8 Modifier le fichier makefile

Le fichier makefile ne devrait pas nécessiter de modifications. Cependant, vous pouvez avoir besoin d'ajouter des dépôts à la XDC PATH utilisée dans le fichier makefile en modifiant le fichier xdcpaths.mak.

2.3 Livraison d'un serveur Codec

Pour distribuer un serveur Codec, vous devez livrer le paquet utilisé pour produire le serveur, y compris l'exécutable du serveur. Le paquet contient les scripts de configuration qui ont produit le serveur. Les informations du paquet spécifient également la version du compilateur utilisé pour faire le serveur et les versions des codecs utilisés pour faire du serveur.

Lorsque vous distribuez un serveur Codec, vous devez fournir la documentation qui comprend les informations suivantes:

- Nom du serveur Codec

-Les options de construction utilisées pour compiler et relier

- Liste des algorithmes disponibles dans le serveur Codec

Page 33 of the Texas Instruments Codec Engine Server user manual — 2.3.2 Livraison de paquets serveur pour serveurs construits avec des makefiles basés sur configuration
Page 33 · cliquer pour agrandir
Page 33

Livraison d'un serveur Codec

En plus d'inclure l'exécutable serveur dans le paquetage serveur, vous devez également ajouter les fichiers de paquets/info/* générés au paquetage. Ces fichiers contiennent des informations sous forme de texte sur les codecs inclus dans le serveur, la carte mémoire du serveur et d'autres informations pertinentes.

Pour créer un paquet livrable, nous vous recommandons d'utiliser la méthode intégrée dans XDC pour créer une archive de paquets .tar, comme indiqué dans la section suivante.

2.3.1 Livraison de paquets serveur pour serveurs construits avec XDC

Si vous avez construit votre serveur via XDC (c'est-à-dire qu'il y a un fichier "package.bld" et que le makefile est très court), vous devez ajouter le répertoire "packages/info" à Pkg.otherFiles comme suit pour inclure les fichiers d'information du serveur dans la version:

Pkg.otherFiles = [ , "package/info", ... [];

Aussi, modifiez le makefile pour exécuter l'étape "xdc release" comme objectif principal (les différences sont indiquées en gras):

EXEMPLES ROOTDIR := $(CURDIR)/.././.../. /...

inclure $(EXAMPLES ROOTDIR)/xdcpaths.mak

# ajouter le répertoire des exemples à la liste des chemins vers les paquets XDC PATH := $(EXAMPLES ROOTDIR);$(XDC PATH)

# include $(EXAMPLES ROOTDIR)/buildutils/xdcrules.mak # run "XDC release" pour créer un fichier tar avec le ou les serveurs tout:

$(XDC INSTALL DIR)/XDC RELEASE XDCPATH="$(X DC PATH)" \ XDCOPTIONS=$(XDCOPIONS) $@ -PD .

Lorsque vous tapez "make", un fichier .tar sera créé. C'est votre serveur qui est livrable.

Voir ti/sdo/ce/examples/serveurs/all codecs/package.bld pour un exemple.

2.3.2 Livraison de paquets serveur pour serveurs construits avec des makefiles basés sur configuration

Si vous avez construit votre serveur via Configuro (un utilitaire qui génère des fichiers objet et linker à partir d'un script utilisateur .cfg) qui est conduit depuis un makefile (qui n'est alors pas très court), vous devez ajouter une étape au makeFile pour créer un paquet de serveurs et une archives à partir de celui-ci.

Configuration d'un serveur Codec 2-17

Page 34 of the Texas Instruments Codec Engine Server user manual — 2.3.1 Livraison de paquets serveur pour serveurs construits avec XDC
Page 34 · cliquer pour agrandir
Page 34

Livraison d'un serveur Codec

Les serveurs DSP construits avec Configuro n'ont pas besoin d'un paquet pour construire le serveur lui-même, mais vous devez en créer un pour produire un serveur livrable. Dans ce paquet, vous devez inclure à la fois l'exécutable serveur et les fichiers Configuro générés par "package/info/*".

Alors que chaque fichier makefile Configuro est différent, voici un exemple de la façon dont la génération de paquets serveur peut paraître. Ici nous générons automatiquement un paquet XDC à partir du nom de paquet donné $(SERVER PKG), avec le nom exécutable du serveur $(server EXE) et le nom de configuration $(CONFIGPK G), sachant que les fichiers générés par Configuro sont dans le répertoire $(configpKG):

SERVER PKG := ti.sdo.ce.examples.servers.video copy.evmDM6446

SERVER PKG ARCHIVE := $(subst ., ,$(SERVER PK G)).tar

# créez le paquet de version du serveur et l'archivez-le; le paquet # contient le paquet exécutable et quelques fichiers méta-info $(SERVER PKG ARCHIVE): $(server EXE) @echo "Création du paquet de paquets du serveur:" @rm -rf.* @e Cho "package $(Server PkG) {}" > package.xdc @e cho "Pkg.otherFiles = ['./$(SERVer ExE)",'paquet/info']" \ > packages.bld @mkdir package ; cp -R $(CONFIGPKB)/package/info package @$(XDC INSTALL DIR)/xdci XDCPATH="$ (XDC/PATH)" relase @rm-f package,blid package .mak .[idle]*

Pour que cet exemple fonctionne, le makefile et l'exécutable du serveur doivent être dans un répertoire dont le chemin se termine par "ti/sdo/ce/examples/servers/video copy/evmDM6446", car c'est le nom que nous avons donné au paquet serveur.

Voir ti/sdo/ce/examples/serveurs/video copy/evmDM6446/makefile pour un exemple.

Page 36 of the Texas Instruments Codec Engine Server user manual — S
Page 36 · cliquer pour agrandir
Page 36

configuration du serveur 2-9 Serveur Integrator 1-7, 2-2 nom de serveur 2-16 Serveur, Codec 2-3 Server.algs array 2-10 servername.cfg fichier 2-8 systèmes monoprocesseur 2-5 squelettes 1-4, 2-6 stubs 1-4, 2-6

link.cmd fichier 2-7, 2-16 commandes de lien 2-16 Linux 1-2 codecs locaux 2-5

M

fichier principal.c 2-7, 2-16 makefile 2-15, 2-16 intergiciel 1-4 attribut MINPRI 2-9

T

threads 2-3, 2-14, 2-15 .tcf fichier 2-7, 214 Tconf 2-8 configuration 2-7 threadAttrs structure 2-9 ti.sdo.ce paquet 2-9 tip.s do.fc paquet 2-10 type de tampon 2-11

N

nom du serveur 2-16

O

U

rôle de l'utilisateur 1-6 fichier user.bld 2-7

P

créer 2-7 chemin de répertoire 2-8 faire une copie 2-8 nom 2-8 répertoire de paquets 2-16 fichier package.bld 2-7, 2-15 fichier packeting.mak 2-16 paquet.xdc 2-7 et 2-8 définitions de chemins 2-7 PrOS 1-2

API VISA 1-2, 2-3 VxWorks 1-2

W

serveur web vs. Serveur Codec 2-3 WinCE 1-2

R

recon tampon 2-11 version de sortie 2-16 release notes.html fichier 1-9 rôles 1-6 Algorithme Créateur 1-6, 2-2 Auteur d'application 1-8 Intégrateur moteur 1-8, 2-2 intégrateur serveur 1-7, 2-1 outils RTSC 2-6

xDAIS 1-2 conformité 2-6 documents connexes 1-6 xDIAS-DM 1-2 Outils XDC 1-6 outils XDC 2-6 variable XDC PATH 2-16 variable d'environnement XDC ROOT 2-8 fichier xdcpaths.mak 2-8, 2-16 xDM

conformité 2-6 défini 1-2 documents connexes 1-6 version 0.9 vs. 1,0 2-11

S

Afficher 5 autres étiquettes / texte court sur cette page
Sommaire · aide en ligne 1-9 · paquet · mémoire de rayures 2-12 · Index-2
Sources

Références et liens

Pages mentionnées dans ce manuel — fabricant, assistance et téléchargements.

Poser une question sur : Texas Instruments Codec Engine Server

Les utilisateurs et notre équipe répondent généralement sous 24 h — et votre question servira aussi aux suivants.

Add your email to get notified when it’s answered — no spam, ever.

0 questions
Aucune question pour l'instant sur le Texas Instruments Codec Engine Server

Soyez le premier à poser une question — d'autres utilisateurs ou notre équipe y répondront.

Document d'origine

Texas Instruments Codec Engine Server manuel PDF

36 pages·205 KB·Logiciels·PDF
Cliquez sur une page ci-dessus pour l'ouvrir ici
Page 1 / …
100%
Chargement des pages…