Benutzeranleitung / Produktwartung IXP400 des Produzenten Intel
Zur Seite of 52
Intel ® IXP400 Digit al Signal Processing (DSP) Sof tware Ve r s i o n 2 . 5 API Reference Manual December 2004 Document Number: 273811-00 7a.
2 API Reference Manual INFORMA TI ON IN THIS DOCUME NT IS PROVIDE D IN CONNECTION W ITH INTEL ® PRODUCTS. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSU.
API Reference Manual 3 Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Contents 1.0 Introduction ............... ............. ................ ............. ............. ................ ............. ......... 7 1.1 General.
4 API Reference Manual Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 6.8 Tone Detector Receive-FSK Message ... ... ................ ............. ............. ........... 32 6.9 Tone Detector FSK-Receive-Complete d Message ..
API Reference Manual 5 Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Revision History Date Revision Description December 2004 008 Updated product branding. September 2004 007 Further updates for the release of Intel ® IXP400 DSP Software v2.
6 API Reference Manual Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 This p age intentionally lef t blank..
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Introduction API Reference Manual 7 1.0 Introduction The Intel ® IXP400 DSP Soft ware v2.5 is a software module that provi des the basic voice processing functionalities for V oIP residential gateway applicat ions.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Introduction 8 API Reference Manual NLP Non-linear Pro cessing (for EC) SP Signal Processing V AD V oice Activity Detection.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Architectural Ov erview API Reference Manual 9 2.0 Architectural Overview Intel ® IXP400 DSP So ft ware is implemented as an indep endent module havi ng its own t asks and runtime environmen t.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Media Processing Resource Compon ent s 10 API Reference Manual 3.0 Media Processing Resource Component s As shown in Figure 1 , t.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Media Processing Re source Component s API Reference Manual 11 Parameters Event s • XEVT_NET_HOOK_STATE — Hook state ch ange detected. • XEVT_NET_TIMER — T imer expired. 3.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Media Processing Resource Compon ent s 12 API Reference Manual Media Processing Functions • Decoding • Automatic leve l contr.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Media Processing Re source Component s API Reference Manual 13 Event s • XEVT_LOST_PACKET – Bad or lo st p acket . • XEVT_DEC_PACKET_CHNG – R TP pay load ty pe changed. 3.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Media Processing Resource Compon ent s 14 API Reference Manual Parameters Event s • XEVT_LOST_PACKET — Bad packet. • XEVT_DEC_PACKET_CHNG — Received R TP payload type changed.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Media Processing Re source Component s API Reference Manual 15 3.4 T one Generation Resource Component Resource T ype: XMPR_TNGE.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Media Processing Resource Compon ent s 16 API Reference Manual 3.5 T one Detection Resource Component Resource T ype: XMPR_TNDET .
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Media Processing Re source Component s API Reference Manual 17 Event s • XEVT_CODE_TD_TONEON – tone on event for an individu.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Media Processing Resource Compon ent s 18 API Reference Manual Media Processing Functions Mixing multiple audio streams for three-way call or small audio conference. The maximum number of parties to the mixer is currently five.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Media Processing Re source Component s API Reference Manual 19 Event s XEVT_T38_END — End of the T .
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Message Format and Delivery Mech anism 20 API Reference Manual 4.0 Message Format and Delivery Mechanism There are two message queues (in-bound and out-bound ) fo r the user application to send control messages and to receive response and event message s, respectively .
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Message Forma t and Delivery Mecha nism API Reference Manual 21 4.2 Message Header Format Return • XSUCC — If successful • XERROR — If errors Caution Message buffer requires 4-byte alignment.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Message Format and Delivery Mech anism 22 API Reference Manual 4.3 Message T ype List All message types are pre-defin e d as: Typ.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Common Control Message API Reference Manual 23 5.0 Common Control Message This section defines the control messages that can be applied to all the resources.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Common Control Message 24 API Reference Manual 5.3 Stop Message 5.4 Ping Messa ge 5.5 Set-Parameter Message Ty p e XMSG_ST OP Direction Inbound Description S tops the current action.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Common Control Message API Reference Manual 25 5.6 Set-Multiple-P arameter Message Format typedef struct{ XMsgHdr_t head; /* mes.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Common Control Message 26 API Reference Manual 5.7 Get-Parameter Message 5.8 Get-Parameter Acknowledge Message 5.9 Get-All-Parameters Message Ty p e XMSG_GET_P ARM Direction Inbound Description Get s a parameter from a resource.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Common Control Message API Reference Manual 27 5.10 Get-All-Parameters Acknowledge Message 5.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Common Control Message 28 API Reference Manual 5.12 Error Message 5.13 Event Message Ty p e XMSG_ERROR Direction Outbound Description Resource reports an error condition. (See constant data section for error codes.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Resource-S pecific Co ntrol Message s API Reference Manual 29 6.0 Resource-S pecific Control Messages This section defines the resource-specific messages. 6.1 CODEC S t art Message 6.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Resource-Specifi c Co n tro l Me ss ag e s 30 API Reference Manual 6.3 T o ne Gen erator Play Message 6.4 T one Generator Play-FSK Message Ty p e XMSG_TG_PLA Y Direction Inbound Description R equires T one Generator to play a tone string .
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Resource-S pecific Co ntrol Message s API Reference Manual 31 6.5 T one Generator Play-Completed Message 6.6 T one Detector R eceive-Digit Message Ty p e XMSG_TG_PLA Y_CMPL T Direction Outbound Description T one Ge nerator indicates the completion of playing tones.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Resource-Specifi c Co n tro l Me ss ag e s 32 API Reference Manual 6.7 T one Detector Receive-Completed Message 6.8 T one Detector Receive-FSK Message Ty p e XMSG_TD_RCV_CMPL T Direction Outbound Description T one d etector indicates the completion of receiving DTMF tones.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Resource-S pecific Co ntrol Message s API Reference Manual 33 6.9 T one Detector FSK-Rece ive-Completed Message 6.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Resource-Specifi c Co n tro l Me ss ag e s 34 API Reference Manual 6.1 1 Player Play-C ompleted Message Format typedef struct{ XM.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Resource-S pecific Co ntrol Message s API Reference Manual 35 6.12 Get-Jitter-Buffer -St atistics Message 6.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Packet Data Interface 36 API Reference Manual 7.0 Packet Dat a Interface The packet data interface is a protocol for the Intel ® IXP400 DSP Software to exchange the encoded data packets with IP stack.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Packet Data Interface API Reference Manual 37 The corresponding data structure is defined as: In ingress, the header in formation of Remote Ti me Stamp, Payload T ype and Marker bi t are directly copied from a R TP packet.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Configuration and Initialization 38 API Reference Manual 8.0 Configuration and Initialization The Intel ® IXP400 DSP Software is.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Configuration and Initializat ion API Reference Manual 39 The configuration informatio n in this function is defined as: The pChanTsMap field is an array that specifies how the instances of Network Endpoint are linked with the time slots of HSS.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Configuration and Initialization 40 API Reference Manual Then the array that describes su ch configuration is given as: If the pC.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Configuration and Initializat ion API Reference Manual 41 Wa r n i n g : New tone definition must be added during t he initialization after xDspSysInit() . The pre- defined country-specific call progress tone will be ov erwritten if a new tone is add ed with the same tone ID.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Configuration and Initialization 42 API Reference Manual Wa r n i n g : New tone detection criterion must be added during the initi al izati on before xDspSysInit() .
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Configuration and Initializat ion API Reference Manual 43 data structure XDSPResConfig_t is defined as: The stream ID i nformation is used for the application to connect the T -Ports and L-Ports of the re- sources.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Complement ary Functions 44 API Reference Manual 9.0 Complement ary Functions 9.1 Direct Parameter Access The user ’ s applications can bypass the message and directly access the D SP parameters.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Complement ary Functions API Reference Manual 45 The hook states are defined as: 9.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 Complement ary Functions 46 API Reference Manual 9.4 Get V ersio n N umber Prototype char * xDspGetVersion(voi d ); Input None Output None Return Pointer to the version string.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Const ant Dat a API Reference Manual 47 10.0 Const ant Dat a This section lists up the defi nitions for consta nt data such as error codes and event codes. 10.1 Error Codes Errors are re po rted via XMSG_ERROR message with an error code and two error data.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 C o n s ta n t D a ta 48 API Reference Manual 10.2 Event Codes Events are reported via XMSG_EVENT message with an event code an d two event data. The resource specific event codes are defined as: 10.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Const ant Dat a API Reference Manual 49 The general call-progress tone IDs used by the T one Generator are defined as: Currently.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 C o n s ta n t D a ta 50 API Reference Manual United St ates Ca ll-Progress T ones China Call-Progress T ones #define COUNTRY_COD.
Intel ® IXP400 Digital Signal Proce ssing (DSP) Softwar e V ersion 2.5 Const ant Dat a API Reference Manual 51 10.4 Other Const ants The coder types used in the XPARMID_DEC_CTYPE and XPARMID_ENC_CTYP.
Intel ® IXP400 Digital Signal Processin g (DSP) Software V ersion 2.5 C o n s ta n t D a ta 52 API Reference Manual Mask bits used to specify th e termination digits in the XMSG_TD_RCV message are de.
Ein wichtiger Punkt beim Kauf des Geräts Intel IXP400 (oder sogar vor seinem Kauf) ist das durchlesen seiner Bedienungsanleitung. Dies sollten wir wegen ein paar einfacher Gründe machen:
Wenn Sie Intel IXP400 noch nicht gekauft haben, ist jetzt ein guter Moment, um sich mit den grundliegenden Daten des Produkts bekannt zu machen. Schauen Sie zuerst die ersten Seiten der Anleitung durch, die Sie oben finden. Dort finden Sie die wichtigsten technischen Daten für Intel IXP400 - auf diese Weise prüfen Sie, ob das Gerät Ihren Wünschen entspricht. Wenn Sie tiefer in die Benutzeranleitung von Intel IXP400 reinschauen, lernen Sie alle zugänglichen Produktfunktionen kennen, sowie erhalten Informationen über die Nutzung. Die Informationen, die Sie über Intel IXP400 erhalten, werden Ihnen bestimmt bei der Kaufentscheidung helfen.
Wenn Sie aber schon Intel IXP400 besitzen, und noch keine Gelegenheit dazu hatten, die Bedienungsanleitung zu lesen, sollten Sie es aufgrund der oben beschriebenen Gründe machen. Sie erfahren dann, ob Sie die zugänglichen Funktionen richtig genutzt haben, aber auch, ob Sie keine Fehler begangen haben, die den Nutzungszeitraum von Intel IXP400 verkürzen könnten.
Jedoch ist die eine der wichtigsten Rollen, die eine Bedienungsanleitung für den Nutzer spielt, die Hilfe bei der Lösung von Problemen mit Intel IXP400. Sie finden dort fast immer Troubleshooting, also die am häufigsten auftauchenden Störungen und Mängel bei Intel IXP400 gemeinsam mit Hinweisen bezüglich der Arten ihrer Lösung. Sogar wenn es Ihnen nicht gelingen sollte das Problem alleine zu bewältigen, die Anleitung zeigt Ihnen die weitere Vorgehensweise – den Kontakt zur Kundenberatung oder dem naheliegenden Service.
