IntelメーカーIXP400の使用説明書/サービス説明書
ページ先へ移動 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.
デバイスIntel IXP400の購入後に(又は購入する前であっても)重要なポイントは、説明書をよく読むことです。その単純な理由はいくつかあります:
Intel IXP400をまだ購入していないなら、この製品の基本情報を理解する良い機会です。まずは上にある説明書の最初のページをご覧ください。そこにはIntel IXP400の技術情報の概要が記載されているはずです。デバイスがあなたのニーズを満たすかどうかは、ここで確認しましょう。Intel IXP400の取扱説明書の次のページをよく読むことにより、製品の全機能やその取り扱いに関する情報を知ることができます。Intel IXP400で得られた情報は、きっとあなたの購入の決断を手助けしてくれることでしょう。
Intel IXP400を既にお持ちだが、まだ読んでいない場合は、上記の理由によりそれを行うべきです。そうすることにより機能を適切に使用しているか、又はIntel IXP400の不適切な取り扱いによりその寿命を短くする危険を犯していないかどうかを知ることができます。
ですが、ユーザガイドが果たす重要な役割の一つは、Intel IXP400に関する問題の解決を支援することです。そこにはほとんどの場合、トラブルシューティング、すなわちIntel IXP400デバイスで最もよく起こりうる故障・不良とそれらの対処法についてのアドバイスを見つけることができるはずです。たとえ問題を解決できなかった場合でも、説明書にはカスタマー・サービスセンター又は最寄りのサービスセンターへの問い合わせ先等、次の対処法についての指示があるはずです。