Dialogic Computer Accessories DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0 User's Manual
Contents
1. Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 ipmMediaInfo MediaData unCount mediaInfo AudioCoderInfo eCoderType CODER TYPE AMRNB 7 4k ipmMediaInfo MediaData unCount mediaInfo AudioCoderInfo eFrameSize CODER FRAMESIZE 20 ipmMediaInfo MediaData unCount mediaInfo AudioCoderInfo unFramesPerPkt 1 ipmMediaInfo MediaData unCount mediaInfo AudioCoderInfo eVadEnable CODER VAD ENABLE ipmMediaInfo MediaData unCount mediaInfo AudioCoderInfo unCoderPayloadType 96 ipmMediaInfo MediaData unCount mediaInfo AudioCoderInfo unRedPayloadType 0 unCount ipmMediaInfo MediaData unCount eMediaType MEDIATYPE AUDIO LOCAL CODER OPTIONS INFO ipmMediaInfo MediaData unCount mediaInfo AudioCoderOptionsInfo 0 ipmMediaInfo MediaData unCount mediaInfo AudioCoderOptionsInfo unVersion IPM AUDIO CODER OPTIONS INFO VERSION ipmMediaInfo MediaData unCount mediaInfo AudioCoderOptionsInfo unCoderOptions CODER OPT AMR CMR LIMIT CODER OPT AMR EFFICIENT unCount t t ipmMediaInfo MediaData unCount eMediaType MEDIATYPE AUDIO REMOTE CODER OPTIONS INFO ipmMediaInfo MediaData unCount mediaInfo AudioCoderOptionsInfo 0 ipmMediaInfo MediaData unCount mediaInfo AudioCoderOptionsInfo unVersion IPM AUDIO CODER OPTIONS INFO VERSION ipmMediaInfo MediaData unCount mediaInfo AudioCoderOptionsInfo unCoderOptions CODER OPT AMR EFFICIENT unCount ipmM2. SU Product or e Issue Type Defect No No Component Description Resolved IPY00034276 video During video record the recorded file may have missing video RTP packets In a 3 second recording 1 or 2 video RTP packets are dropped about 10 of the time The problem can occur at both low and high densities Resolved IPY00036858 77 voice On a disconnection between two R4 devices up to 30ms of the signal that was received prior to disconnection may show up on the next connection Resolved IPY00036313 77 voice User IO in Dialogic Voice API Library is not supported in this release 18 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation Documentation Updates 3 The documentation updates are divided into the following sections which correspond to the top level categories used on the online documentation navigation page e System Release Documentation 00 eens 19 e Technical Product Specification liliis 19 Programming Libraries Documentation 02 00 eee eee 19 e Remote Control Interfaces Documentation liliis 43 3 1 System Release Documentation This section contains updates to the following documents Dialogic Multimedia Software for AdvancedTCA Release 1 0 Release Guide 3 1 1 Dialogic Multimedia Software for AdvancedTCA Release 1 0 Release Guide There are currently no updates to this document 3 2 T
3. This section describes significant changes to Dialogic Multimedia Software for AdvancedTCA Release 1 0 subsequent to the general availability release date Service Update for Dialogic Multimedia Software for AdvancedTCA Release 1 08 Su rmimary of Features uade koe xxm Ae eS eee PCR Ce ee 9 e Support for MSML Conferencing lisse nm mre ER x RA 9 Support Tor QGCELP Codes iio rue RROR ESO E ERA tieke ratri ioke RR 9 Service Update for Dialogic Multimedia Software for AdvancedTCA Release 1 0 A Service Update for Dialogic Multimedia Software for AdvancedTCA Release 1 0 is available Service Updates provide fixes to known problems and may also introduce new functionality New versions of the Service Update will be released periodically This Release Update documents the features in the Service Updates For the latest service update go to http www dialogic com support helpweb mmpatca Depending on whether you already have a version of the Dialogic Multimedia Software for AdvancedTCA Release 1 0 software on your system you may need to uninstall the existing version before installing the Service Update f you don t have an existing version of the software on your system you can install the Service Update immediately f you have an existing version of the software on your system you must uninstall the existing version before installing the Service Update This Service Update includes global software changes
4. IPY00038147 hardware If the Dialogic Multimedia Blade is deactivated using the shelf manager the kernel panics while shutting down the system services and does not complete the hot swap extraction cycle The craftsperson can then remove and or restart the blade Known IPY00036028 hardware The PSTN Rear Transition Module RTM generates major events to the shelf manager stating that the sensor RTM 1 0 V went over the upper critical limit Known IPY00036026 hardware The Dialogic Multimedia Blade generates major events to the shelf manager stating that the sensor SBC 1 1V SUS went over the upper critical limit Known IPY00032623 MSML audiosamplerate and audiosamplesize must be specified by the MSML application server when playing a WAV file from an offset Known IPY00034143 PSTN call control When using all 496 time slots on 16 E1 trunks there is a 1 failure rate with DTMF digit detection Known permanent IPY00034168 CLI On a CLI shutdown by dlstop the CLI session port is not immediately released If a user does a dlstop followed by a distart too quickly within 20 seconds the distart may not be able to start the CLI session Workaround If the CLI agent start part of dlstart fails then the workaround is to do the following from a terminal window after around 20 seconds dlservices cli start If it doesn t work immedia
5. There are currently no updates to this document 3 4 Remote Control Interfaces Documentation This section contains updates to the following documents MSML Media Server User s Guide 3 4 1 MSML Media Server User s Guide There are currently no updates to this document Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 43 Dialogic Corporation 44 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation
6. Resolved IPY00036386 77 IPML DTMF transfer mode should be set prior to calling dev ReserveResourceEx otherwise it will not take effect Resolved IPY00036314 70 IPML Setting the AMR NB codec option to BWE Bandwidth Efficient Mode results in a fatal error Do not use the BWE mode for the AMR NB codec Resolved IPY0003631 1 70 IPML The EVRC codec does not support SFPP The ipm StartMedia call fails Resolved 1PY00034204 IPML AMR narrow band coder has some CMR options that are not yet supported in the firmware and host libraries Restrictions are The transmit bit rate will follow the remote CMR request The CMR in the outgoing packet will be set to default value of 15 don t care will accept any rate from remote side Resolved IPY00034016 IPML The ipm Listen function fails when the CT Bus PCM encoding type does not match the encoding type of the first trunk or framer when PSTN is enabled Resolved IPY00033771 IPML QoS The application failed to receive RTP and RTCP time out event RTCP events are not working at this time Resolved IPY00033720 IPML Pulling an Ethernet LAN cable from the RTM does not generate a change in line status event RTCP events are not working at this time Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 15 Dialogic Corporation Issue
7. query to check on resource availability prior to issuing a reserve request Otherwise the application will need to query after the reserve fails to identify available unavailable resources prior to re issuing a reserve request 2 Application queries to check on resource availability for this example assume this returns RESOURCE IPM G726 as available 3 Application reserves resource RESOURCE IPM G726 4 Application starts media operation ipm StartMedia 5 Application stops media operation ipm Stop 40 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation 6 Application issues call to release resource RESOURCE_IPM_G726 Application queries to see which is available and which is not dev_ReserveResourceEx ipmH RESOURCE_IPM_G726 RESOURCE IPM G729 The result shows G726 is available and G729 is not i i OMEV_RESERVE_RESOURCE_FAIL dev_GetResourceReservationInfoEx ipmH pResourcainfo ASYNC LI a Xl i DMEV_GET_RESOURCE_RESERVATIONINFO Ile dev ReserveResourceEx ipnH RESOURCE IPM G726 O_o l DMEV_RESERVE_RESOURCE l EI EEEE SE SEE E E e I I I ipm Stop A NS IPMEV_STOP ie ee ee ee Je oe ee eee ee ee ee ee all I I l dev ReleaseResourceEx ipmH RESOURCE_IPM_G726 l l DMEV_RELEASE_RESOURCE l l Rat cipe Di NUN MET I I l I I l Reservation State after a Subsequent Call to
8. 39 Dialogic Corporation 8 Application releases coder by issuing a call to release RESOURCE IPM G723 cades l I dev ReserveResourceEx ipmH RESOURCE IPM G726 RESOURCE IPM G729 i H DMEV RESERVE RESOURCE 1 1 7777772727 pm S riledafipmh G 726 i IPMEV STARTMEDIA fee nee aa act mirc etna i j Application gets a reinvite from the remote side requesting I l a change of coder G723 Application issues call to stop ipm Stopi the media operation IPMEV STOP cce nere nnne pesas ucc Ended This reserve call implicitly releases RESOURCE IPM G726 RESOURCE IPM G729 and replaces with RESOURCE IPM G723 l l Application issues reserve for RESOURCE IPM G723 I as the only reserved coder tS T 1 1 DMEV_RESERVE_RESOURCE j I I i I j i dev_ReserveResourceEx ipmH RESOURCE_IPM_G723 L 77 7 L I i ipm StartMedia ipmh G 723 l amp d 2 222222 222 22 2 d i Uy Stop I IPMEV_STOP I i a aa E p oou tiem ita team 1 I i dev ReleaseResourceEx ipmH RESOURCE IPM G723 Oooo Eee DMEV_RELEASE_RESOURCE Handling a Resource Reservation Failure 1 A call to reserve resources RESOURCE_IPM_G726 RESOURCE IPM G729 fails for lack of available resources Note The reserve fails when one or more of the resources requested is not available The application can
9. Also None Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 29 Dialogic Corporation IPM_AUDIO_CODER_OPTIONS_INFO 30 typedef struct ipm audio coder options info tag unsigned int unVersion unsigned int unCoderOptions unsigned int unParml int nValuel unsigned int unParm2 int nValue2 IPM AUDIO CODER OPTIONS INFO B Description This data structure provides additional options when using AMR EVRC and QCELP audio coders For information about QCELP available as of Service Update 80 see Section 1 5 Support for QCELP Codec on page 9 Note All unused fields in the IPM AUDIO CODER OPTIONS INFO structure must be set to 0 B Field Descriptions The fields of the IPM AUDIO CODER OPTIONS INFO data structure are described as follows Note For EVRC where the media type is MEDIATYPE AUDIO LOCAL CODER OPTIONS INFO all field values are ignored by the firmware unVersion set to IPM AUDIO CODER OPTIONS INFO VERSION unCoderOptions For AMR coders where the media type is MEDIATYPE AUDIO LOCAL CODER OPTIONS INFO valid values are e CODER OPT AMR EFFICIENT Minimize the amount of network bandwidth Or CODER OPT AMR OCTET Make packet parsing easier for the AMR application For AMR coders where the media type is MEDIATYPE AUDIO REMOTE CODER OPTIONS INFO valid values that can be ORed together are CODER OPT AMR EFFICIENT see description a
10. RESOURCE IPM G711 20MS RESOURCE IPM G729 DMEV GET RESOURCE RESERVATIONINFO DMEV RESERVE RESOURCE DMEV RELEASE RESOURCE f DeviceManagement Interface IPML Interface I T dev GetResourceReservationinfoEx ipmH pResourcelnfo ASYNC Application offers the above coders to the remote side in an INVITE The remote side picks G723 G726 I LI I I I I I I I LI I I I I LI LI N 1 i qs SS SS 8S SS 53 SSS 25 gt ia 1 l ipm StartMedia ipmh G 726 E I TPMEV STARTMEDIA m uid cd Emi a d i pm_Stop ee es F j IPMEV STOP i K T e e ee 1 1 dev ReleaseResourceEx ipmH RESOURCE IPM G723 RESOURCE IPM G726 DMEV RELEASE RESOURCE Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation Inbound Call 1 The INVITE from remote side specifies a list of coders 2 Application may choose to reserve all or some of the coders that the remote side offered and then respond to the remote side with local coder capabilities based on the reservation 3 Application proceeds with the call 4 After the call is disconnected the application releases all the reserved coders by either explicitly listing the reserved list or specifying the enum RESOURCE IPM ALL AUDIO CODERS APP DeviceManagement Interface IPML Interface I I I I I I I 1 The INVITE from rem
11. attempts to restore packets arriving at the receive end as close as possible to their original time stamped positions Arriving packets are decomposed into individual frames each with a unique time stamp Each new frame is then stored in a jitter buffer before it is sent to the decoder This is done to allow packets arriving out of order to be inserted in the queue in the correct order The size of this jitter buffer is defined by the number of frames stored and is controlled by the PARMCH LATENCYFRAMEINIT AUDIO PARMCH LATENCYFRAMEMAX AUDIO and PARMCH LATENCYALG AUDIO parameters Type Integer Values 1 to PARMCH LATENCYFRAMEMAX AUDIO frames Default 6 Note While the number of frames to be buffered should be set as high as possible for best quality too high a value will add unnecessary latency to the system Generally the number of frames buffered should be the same size or slightly larger than the number of frames per packet PARMCH LATENCYFRAMEMAX AUDIO Defines the maximum number of frames to be buffered in the Packet Loss Recovery PLR frame list This parameter adds latency only when the buffer is already filled and additional frames arrive before there is space in the buffer This provides for bursts of packets to arrive which would have to be discarded otherwise The PLR module attempts to restore packets arriving at the receive end as close as possible to their original time stamped positions Arriving packets are deco
12. eCAPABILTIY_TYPE CAPABILITY_CODERLIST The ipm_GetCapabilities function is supported in synchronous mode only If asynchronous mode a_usMode EV_ASYNC is specified an error is generated Cautions None Errors If the function returns 1 to indicate failure call ATDV LASTERR or ATDV ERRMSGP to return one of the following errors EIPM_BADPARM Invalid parameter EIPM_INTERNAL Internal error EIPM_INV_MODE Invalid mode EIPM_INV_STATE Invalid state Initial command did not complete before another function call was made EIPM_ERROR System error Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation B Example In this example the first ipm_GetCapabilities call retrieves only the number of capabilities available count That number is then used to allocate the right amount of memory and retrieve details of all the capabilities finclude lt ipmlib h gt Code follows unsigned int count IPM_CODER_INFO caps int i unsigned int count ipm_GetCapabilties dev CAPABILITY CODERLIST 0 NULL SYNC caps IPM CAPABILITIES malloc sizeof IPM CAPABILITIES count check for memory error here count ipm_GetCapabilties dev CAPABILITY CODERLIST count caps SYNC for i 0 i lt count i printf RFC 1890 Coder Type ui supported n caps i Coder unCoderPayloadType Free coder list here free caps B See
13. kbit s via the local audio coder setting 3 The host sets its RTP payload to efficient bandwidth and CMR limit mode 4 The host receives it first packet from the remote side with the CMR value higher than the preferred rate 5 The host leaves the transmitted bit rate at the preferred value 6 The host receives a packet from the remote side with a CMR value less than the preferred rate 7 The host changes the transmitted bit rate to match the received CMR value The following code demonstrates the configuration required to handle this scenario Setup IP address here Local Audio Coder ipmMediaInfo MediaData unCount eMediaType MEDIATYPE AUDIO LOCAL CODER INFO ipmMediaInfo MediaData unCount mediaInfo AudioCoderInfo eCoderType CODER TYPE AMRNB 7 95k ipmMediaInfo MediaData unCount mediaInfo AudioCoderInfo eFrameSize CODER FRAMESIZE 20 ipmMediaInfo MediaData unCount mediaInfo AudioCoderInfo unFramesPerPkt 1 ipmMediaInfo MediaData unCount mediaInfo AudioCoderInfo eVadEnable CODER VAD ENABLE ipmMediaInfo MediaData unCount mediaInfo AudioCoderInfo unCoderPayloadType 96 ipmMediaInfo MediaData unCount mediaInfo AudioCoderInfo unRedPayloadType 0 unCount t t Remote Audio Coder ipmMediaInfo MediaData unCount eMediaType MEDIATYPE AUDIO REMOTE CODER INFO 36 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation
14. 08 Dialogic Corporation eCoderType CODER TYPE EVRC eFrameSize CODER FRAMESIZE 20 unFramesPerPkt 2 eVadEnable CODER VAD DISABLE unCoderPayloadType 96 unRedPayloadType 0 31 3 3 9 32 ipmMediaInfo MediaData unCount eMediaType MEDIATYPE AUDIO REMOTE CODER OPTIONS INFO ipmMediaInfo MediaData unCount mediaInfo AudioCoderOptionsInfo unVersion IPM AUDIO CODER OPTIONS INFO VERSION ipmMediaInfo MediaData unCount mediaInfo AudioCoderOptionsInfo unCoderOptions CODER OPT SIGNALING OFF ipmMediaInfo MediaData unCount mediaInfo AudioCoderOptionsInfo unParml CODER OPT INTERLEAVE LENGTH ipmMediaInfo MediaData unCount mediaInfo AudioCoderOptionsInfo nValuel ipmMediaInfo MediaData unCount mediaInfo AudioCoderOptionsInfo unParm2 uo dw gw on ipmMediaInfo MediaData unCount mediaInfo AudioCoderOptionsInfo nValue2 unCount ipmMediaInfo unCount unCount Dialogic IP Media Library API Programming Guide Using AMR coders for narrow band audio and using enhanced variable rate codecs The following information which is applicable to the ATCA Multimedia Platform should be added to the programming guide possibly as a new chapter Using AMR Coders for Narrow Band Audio Description AMR is an adaptive multi rate speech codec During operation both local and remote sides can request a change in the bit rate and dynamically adjust the bandwidth The protocol uses the followin
15. Blade is shut down with an RTM present the baseboard hotswap blue LED remains in a blinking state and never goes to a steady state as expected to indicate shutdown is complete Workaround Wait for all software services to shut down before extracting the board Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 13 Dialogic Corporation Issues Sorted by Type Dialogic Multimedia Platform Continued Issue Type Defect No SU No Product or Component Description Known IPY00038149 hardware Shut down is not supported by opening of the Dialogic Multimedia Blade latch The blue LED hotswap LED on the blade will blink indefinitely but never turn solid to indicate shut down complete Workaround To shut down the blade log on locally through the serial port or connect over the network and initiate a shutdown The blade can be initialized by removing and reseating in the chassis Known IPY00038148 hardware Activation and de activation via the shelf manager is not supported on the Dialogic Multimedia Blade latch The blue LED hotswap LED on the blade will blink indefinitely but never turn solid to indicate shut down complete Workaround To shut down the blade log on locally through the serial port or connect over the network and initiate a shutdown The blade can be initialized by removing and reseating in the chassis Known
16. DIO LOCAL CODER OPTIONS INFO mediaInfo AudioCoderOptionsInfo unVersion IPM AUDIO CODER OPTIONS INFO VERSION mediaInfo AudioCoderOptionsInfo unCoderOptions CODER OPT AMR EFFICIENT eMediaType MEDIATYPE AUDIO REMOTE CODER OPTIONS INFO mediaInfo AudioCoderOptionsInfo unVersion IPM AUDIO CODER OPTIONS INFO VERSION mediaInfo AudioCoderOptionsInfo unCoderOptions CODER OPT AMR CMR TRACK CODER _OPT AMR EFFICIENT In this example the host application wants to limit the transmitted bit rate to less than the preferred value The following diagram shows this case where the local side is the host application Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 35 Dialogic Corporation Local Side Remote Side FT 4 7 4 kbit s CMR 5 7 95 kbits s Y 9 FT 5 7 95 kbit s CMR 6 10 2 kbit s FT 4 7 4 kbit s CMR 5 7 95 kbits s p FT 5 7 95 kbit s CMR 3 6 7 kbit s FT 3 6 7kbit s CMR 5 7 95 kbit s m 4 Note While the diagram above implies an immediate reaction to a CMR from the other side in reality the other side s response to a CMR may take a few packets The sequence of activities is as follows 1 The host is transmitting at the preferred bit rate set by the host application via the remote audio coder settings in this case 7 4 kbit s 2 The host sets its initial CMR value to 7 95
17. Dialegic Dialogic Multimedia Software for AdvancedTCA Release 1 0 Release Update January 23 2008 05 2548 006 Copyright 2007 2008 Dialogic Corporation All Rights Reserved You may not reproduce this document in whole or in part without permission in writing from Dialogic Corporation All contents of this document are furnished for informational use only and are subject to change without notice and do not represent a commitment on the part of Dialogic Corporation or its subsidiaries Dialogic Reasonable effort is made to ensure the accuracy of the information contained in the document However Dialogic does not warrant the accuracy of this information and cannot accept responsibility for errors inaccuracies or omissions that may be contained in this document INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH DIALOGIC PRODUCTS NO LICENSE EXPRESS OR IMPLIED BY ESTOPPEL OR OTHERWISE TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT EXCEPT AS PROVIDED IN A SIGNED AGREEMENT BETWEEN YOU AND DIALOGIC DIALOGIC ASSUMES NO LIABILITY WHATSOEVER AND DIALOGIC DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY RELATING TO SALE AND OR USE OF DIALOGIC PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE MERCHANTABILITY OR INFRINGEMENT OF ANY INTELLECTUAL PROPERTY RIGHT OF A THIRD PARTY Dialogic products are not intended for use in medical life saving life sustaining critica
18. Dialogic IP Media Library API allows the application to provide a preferred bit rate and a rule to determine how changes in the received CMR value control the transmitted bit rate Preferred bit rate The preferred bit rate is specified by setting the eMediaType in the IPM MEDIA structure to MEDIATYPE_AUDIO_REMOTE_CODER_INFO and setting the CoderInfo eCoderType to the desired transmit bit rate CMR value The transmitted CMR value is specified by setting the eMediaType in the IPM MEDIA structure to MEDIATYPE_AUDIO_LOCAL_CODER_INFO and setting the CoderInfo eCoderType to the desired CMR value The CMR rules are specified by a new media type called MEDIATYPE AUDIO REMOTE CODER OPTIONS INFO A new field AudioCoderOptionsInfo of type IPM AUDIO CODER OPTIONS INFO has been added to the IPM MEDIA union The CMR control is implemented by allowing the host application to specify one of two rules The first rule CMR Tracking indicates that the transmit bit rate should follow the CMR value in the received packet The second rule CMR Limit indicates that the transmit bit rate should follow the CMR value in the received packet with a maximum value specified by the preferred bit rate With both CMR rules it is necessary to specify a preferred rate to avoid the specific case of determining what rate to transmit at before the first CMR value is received The software will transmit at the preferred rate before the first packet is
19. QCELP 13 kbps where unParm12CODER OPT CDMA RATE REDUC possible values are 0 1 2 3 and 4 Default value is 0 unParm2 For QCELP set to 0 nValue2 For QCELP set to O Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation Release Issues 2 The table below lists issues that can affect the hardware and software supported in the Dialogic Multimedia Platform for AdvancedTCA The following information is provided for each issue Issue Type This classifies the type of release issue based on its effect on users and its disposition Known A minor hardware or software issue This category includes interoperability issues and compatibility issues Known issues are still open but may or may not be fixed in the future Known permanent A known hardware or software issue or limitation that will not be fixed in the future Resolved A hardware or software issue that was resolved usually either fixed or documented in this release Defect No A unique identification number that is used to track each issue reported via a formal Change Control System Additional information on defects may be available via the Defect Query tool at http membersresource dialogic com search defects Note that when you select this link you will be asked to either LOGIN or JOIN SU No For defects that were resolved in a Service Update indicates the Service Update numbe
20. Resource Reservation Fails 1 Application issues call to reserve resources RESOURCE_IPM_G726 RESOURCE IPM G729 and it succeeds 2 Application starts media operation using G726 3 Application receives a REINVITE request to use AMR coder 4 Application stops media operation 5 Application attempts to reserve RESOURCE IPM AMR the call fails for lack of available resources The previous successful reserved state is preserved In this case RESOURCE IPM G726 RESOURCE IPM G729 were the previously reserved coders that state is still preserved as the latest call to reserve failed 6 Application may reject the REINVITE from the remote side and continue to use any of the reserved coders at this point 7 Start Media Operation 8 Stop Media Operation Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation APP DeviceManagement Interface IPML Interface 41 9 Application issues call to release resources RESOURCE_IPM_G726 RESOURCE IPM G729 It may also use a single enum RESOURCE IPM ALL AUDIO CODERS to release all the reserved audio coders as opposed to having to list every single one of them APP DeviceManagement Interface IPML Interface l I l dev_ReserveResourceEx ipmH RESOURCE_IPM_G726 RESOURCE IPM G729 DMEV RESERVE RESOURCE I Kc Reseau miei iei ies l ipm_StartMedia ipmh G 726 IPMEV_STARTMEDIA l Applicati
21. alogic Dialogic s trademarks may be used publicly only with permission from Dialogic Such permission may only be granted by Dialogic s legal department at 9800 Cavendish Blvd 5th Floor Montreal Quebec Canada H4M 2V9 Any authorized use of Dialogic s trademarks will be subject to full respect of the trademark guidelines published by Dialogic from time to time and any use of Dialogic s trademarks requires proper acknowledgement Windows is a registered trademark of Microsoft Corporation in the United States and or other countries Other names of actual companies and products mentioned herein are the trademarks of their respective owners Publication Date January 23 2008 Document Number 05 2548 006 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation About This Publication This section contains information about the following topics Purpose Intended Audience How to Use This Publication e Related Information Purpose This Release Update addresses issues associated with Dialogic Multimedia Software for AdvancedTCA Release 1 0 In addition to summarizing issues that were known as of this release the Release Update will continue to be updated to serve as the primary mechanism for communicating new issues that arise after the release date Intended Audience This Release Update is intended for all users of the Dialogic Multimedia Platform for AdvancedTCA Ho
22. boot RtcWriteBEvtDetected error Event type 4605 is out of range max 127 Resolved IPY00034277 TDM bus Receive failures in the DS1 adapter when attempting to add a clock source to the FallBackList table via SNMP The Clock FallBack List is not functional the user can choose a clock but will not be able to rely on a fallback list Resolved IPY00034275 TDM bus When no fallback list is present the TDM clock manager in the firmware will attempt to access the non existent list when the cable is unplugged from a PSTN trunk This causes two identical events to be forwarded to the CLI and SNMP saying that the TDM clock has changed sources twice This is misleading because in actuality the clock source has not changed and red alarms on a particular trunk or trunks should not have any effect on the default internal oscillator clock source The Clock FallBack List is not functional the user can choose a clock but will not be able to rely on a fallback list Resolved IPY00033580 third party support Using RFC2833 with coder type G723 1 63 56 K 30ms 1 2 fop VAD off digits are missed at a rate of 1 to 2 An example of missing digits is received 19d6a expected 159d86a Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 T Dialogic Corporation Issues Sorted by Type Dialogic Multimedia Platform Continued
23. bove or CODER_OPT_AMR_OCTET see description above CODER_OPT_AMR_CMR_TRACK Specify that the transmit bit rate should follow the CMR value in the received packet or CODER OPT AMR CMR LIMIT Specify that the transmit bit rate should follow the CMR value in the received packet with a maximum value specified by the preferred bit rate For EVRC set to CODER OPT SIGNALING OFF Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation unParm1 set to a value from the eIPM_CODER_OPTION_PARMS enumeration For AMR set to 0 For EVRC where the media type is MEDIATYPE AUDIO REMOTE CODER OPTIONS INFO valid value is CODER OPT INTERLEAVE LENGTH Reduce the listener s perception of data loss by spreading such a loss over non consecutive vocoder frames e CODER OPT CDMA RATE REDUC Rate reduction Bit rate is varied to achieve a variety of average bit rates for more flexibility in bandwidth usage nValuel The value set here is for the parameter specified in unParm1 For AMR set to 0 For EVRC where unParm CODER_OPT_INTERLEAVE_LENGTH possible values are in the range 0 to 7 The default value is 0 For EVRC where unParm CODER_OPT_CDMA_RATE_REDUC possible values are 0 and 4 Default value is 0 unParm2 For AMR set to 0 For EVRC set to 0 nValue2 For AMR set to 0 For EVRC set to 0 Example The following code example shows
24. d at 1 Must be CODER VAD ENABLE CODER TYPE AMRNB NONE fixed at 20 fixed at 1 Must be CODER VAD ENABLE CODER TYPE EVRC fixed at 20 1 2 or3 Must be CODER VAD DISABLE Update to the IPM AUDIO CODER INFO data structure Update for the eCoderType field The QCELP 8 kbps and 13 kbps coder type are available as of Service Update 80 For more information see Section 1 5 Support for QCELP Codec on page 9 Update to the IPM MEDIA data structure Replace the IPM MEDIA data structure field description for eMediaType with the following corrected content eMediaType type of media used to start an IP session The eIPM MEDIA TYPE data type is an enumeration which defines the following values Audio Values e MEDIATYPE AUDIO LOCAL CODER INFO local receive coder information MEDIATYPE AUDIO LOCAL CODER OPTIONS INFO options when using AMR and EVRC coders at the local side MEDIATYPE AUDIO LOCAL RTCP INFO local RTCP audio port information MEDIATYPE AUDIO LOCAL RTP INFO local RTP audio port information MEDIATYPE AUDIO REMOTE CODER INFO remote receive coder information MEDIATYPE AUDIO REMOTE CODER OPTIONS INFO options when using AMR and EVRC coders at the remote side MEDIATYPE AUDIO REMOTE RTCP INFO remote RTCP audio port information MEDIATYPE AUDIO REMOTE RTP INFO remote RTP audio port information Video Values MEDIATYPE VIDEO LOCAL CODER INFO local receive video coder information MEDIATYPE VIDEO LOCAL RTCP INFO
25. e API Library Reference e Dialogic Voice API Programming Guide Dialogic Conferencing CNF API Library Reference There are currently no updates to this document Dialogic Conferencing CNF API Programming Guide There are currently no updates to this document Dialogic Device Management API Library Reference There are currently no updates to this document Dialogic Fax Software Reference There are currently no updates to this document Dialogic Global Call API Library Reference There are currently no updates to this document Dialogic Global Call API Programming Guide There are currently no updates to this document Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation 3 3 7 Dialogic Global Call IP Technology Guide Update to Section 4 3 2 Setting Coder Information In Table 2 Coders Supported for Dialogic Host Media Processing HMP Software the following note should be added Global Call supports AMR NB and EVRC coders in third party call control 3PCC mode only These coder types cannot be explicitly set using the Global Call API but can be specified using the IP Media Library PML API See the documentation updates in Section 3 3 9 Dialogic IP Media Library API Programming Guide on page 32 of this Release Update for more information on using these coders in 3PCC mode 3 3 8 Dialogic IP Media Library API L
26. e host application wants to transmit at the bit rate requested by the incoming CMR value The following diagram depicts this use case where the local side is the host application Local Side Remote Side FT 4 7 4 kbit s CMR 5 7 95 kbit s E FT 5 7 95 kbit s CMR 6 10 2 kbit s FT 6 10 2 kbt s CMR 5 7 95 kbit s Note While the diagram above implies an immediate reaction to a CMR from the other side in reality the other side s response to a CMR may take a few packets The sequence of activities is as follows 1 The host is transmitting at the preferred bit rate set by the host application via the remote audio coder settings in this case 7 4 kbit s 2 The host sets its CMR value to 7 95 kbit s via the local audio coder setting 3 The host sets its RTP payload to efficient bandwidth and CMR tracking mode 4 The host receives its first packet from the remote side with the CMR value higher than the preferred rate 5 The host changes the transmitted bit rate to match the CMR value 34 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation The following code demonstrates the configuration required to handle this scenario Setup IP address here Local Audio Coder ipmMediaInfo MediaDat ipmMediaInfo MediaDat ipmMediaInfo MediaDat ipmMediaInfo MediaDat ipmMediaInfo MediaDat ipmMediaInfo MediaDat ip
27. echnical Product Specification This section contains updates to the following documents Dialogic Multimedia Blade for ATCA Technical Product Specification 3 2 1 Dialogic Multimedia Blade for ATCA Technical Product Specification A new version of the technical product specification document 05 2535 002 has been added to the bookshelf available in Service Update 70 See the Revision History section of this document for a description of the changes 3 3 Programming Libraries Documentation This section contains updates to the following documents click the title to jump to the corresponding section Dialogic Conferencing CNF API Library Reference Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 19 Dialogic Corporation 3 3 1 3 3 2 3 3 3 3 3 4 3 3 5 3 3 6 20 Dialogic Conferencing CNF API Programming Guide Dialogic Device Management API Library Reference Dialogic Fax Software Reference Dialogic Global Call API Library Reference e Dialogic Global Call API Programming Guide e Dialogic Global Call IP Technology Guide Dialogic IP Media Library API Library Reference Dialogic IP Media Library API Programming Guide Dialogic Multimedia API Library Reference e Dialogic Multimedia API Programming Guide e Dialogic Standard Runtime Library API Library Reference Dialogic Standard Runtime Library API Programming Guide Dialogic Voic
28. edia type all values are valid except CODEC AUDIO AMRNB NONE Update for the eFrameSize field The only supported value for AMR is CODER FRAMESIZE 20 This is not a technical limitation but part of the protocol Update for the unFramesPerPkt field For AMR the only supported value is 1 frame per packet Update for the eVadEnable field For AMR setting this field to CODER VAD ENABLE is required Update for the unCoderPayloadType field For AMR negotiated by call control Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation Update for the unRedPayloadType field For AMR negotiated by call control Update for the supported audio coders table Table 1 Supported Audio Coder Properties should include the following additional coder information Frame Size Frames per eCoderType eVadEnable Value ms Packet fpp CODER TYPE AMRNB 4 75k fixed at 20 fixed at 1 Must be CODER VAD ENABLE CODER TYPE AMRNB 5 15k fixed at 20 fixed at 1 Must be CODER VAD ENABLE CODER TYPE AMRNB 5 9k fixed at 20 fixed at 1 Must be CODER VAD ENABLE CODER TYPE AMRNB 6 7k fixed at 20 fixed at 1 Must be CODER VAD ENABLE CODER TYPE AMRNB 7 4k fixed at 20 fixed at 1 Must be CODER VAD ENABLE CODER TYPE AMRNB 7 95k fixed at 20 fixed at 1 Must be CODER VAD ENABLE CODER TYPE AMRNB 10 2k fixed at 20 fixed at 1 Must be CODER VAD ENABLE CODER TYPE AMRNB 12 2k fixed at 20 fixe
29. ediaInfo unCount unCount Using Enhanced Variable Rate Codecs Enhanced Variable Rate Codecs EVRCs as specified in RFC 3558 RTP Payload Format for Enhanced Variable Rate Codecs EVRC and Selectable Mode Vocoders SMV are supported When using EVRCs more than one codec data frame may be included in a single interleaved bundled packet by a sender This is accomplished by e Bundling A technique used to spread the transmission overhead of the RTP and payload header over multiple vocoder frames Interleaving A technique used to reduce the listener s perception of data loss by spreading such a loss over non consecutive vocoder frames EVRC and similar vocoders can compensate for an occasional lost frame but speech quality degrades exponentially with consecutive frame loss Bundling is done using the Frames Per Packet field in the MEDIATYPE AUDIO REMOTE CODER INFO structure as is the case with most codecs Frames per packet values of 1 to 3 are allowed Note that the RFC definition of bundle describes the number of additional frames per packet so a frame per packet value of 1 would be the same as a bundle value of 0 Interleaving is accomplished using parameter 1 of the MEDIATYPE AUDIO REMOTE CODER OPTIONS INFO structure This parameter can be set from 0 to 7 0 indicates do not use interleaving Interleaving should only be used when the frames per packet value is 2 or more When using the IP Media Library API inte
30. er For Dialogic IP Media Library API Library Reference indicated that IPM AUDIO CODER INFO structure and IPM AUDIO CODER OPTIONS INFO Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 5 Dialogic Corporation Document Revision History structure have updates for QCELP updated table of supported audio coders in IPM_AUDIO_CODER_INFO section EVRC change updated IPM_AUDIO_CODER_OPTIONS_INFO structure removed CODER_OPT_EVRC_SIGNALLING_OFF CODER_OPT_EVRC_SIGNALLING_DIM_AND_BURST_HALF_RATE CODER OPT EVRC SIGNALLING BLANK added CODER OPT SIGNALING OFF updated example code for IPM AUDIO CODER OPTIONS INFO structure Document Rev 03 published May 1 2007 Updated for Service Update 77 In the new Post Release Developments chapter Added Service Update for Dialogic Multimedia Software for AdvancedTCA Release 1 0 section Added important information on the need to uninstall existing software before installing the new Service Update In the Release Issues chapter e Updated description of Known Defect IPY00034680 e Added the following Known Defects IPY00033349 previously Resolved IPY00033354 previously Resolved IPY00038147 IPY00038148 IPY00038149 Added the following Resolved Defects IPY00035425 IPY00035828 IPY00036058 IPY00036313 IPY00036386 IPY00036831 IPY00036858 IPY00036983 Removed the following Known Permanent Defect IPY00032616 not a de
31. fect Removed the following Known Defects duplicate entries previously resolved in Service Update 70 IPY00036311 IPY0003631 4 In the Documentation Updates chapter e Added a new version of the Dialogic Multimedia Blade for ATCA Technical Product Specification to the bookshelf previously added in Service Update 70 Document Rev 02 published March 30 2007 Updated for Service Update 70 In the Release Issues chapter e Added SU No to the Issues table Revised the description for Known Defect IPY00032623 e Added the following Known Defects IPY00036858 and unnumbered defect for MSML regarding http scheme e Added the following Known Permanent Defect IPY00032616 previously a Known Defect 6 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation Document Revision History e Added the following Resolved Defects IPY00036309 IPY00036311 IPY00036314 IPY00036601 IPY00036911 In the Documentation Updates chapter e Added update to the Dialogic Multimedia API Library Reference for MM_VIDEO_CODEC data structure Document Rev 01 published January 2007 Initial version of document Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 7 Dialogic Corporation Post Release Developments 1 1 1 Caution Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008
32. g A Frame Type FT to indicate the transmitted bit rate A Codec Mode Request CMR value to request a particular bit rate in every packet To control the bit rate AMR assumes that all connections are bi directional This feature is specific to AMR NB and excludes support for AMR WB and AMR WB4 which support wideband audio and some other formats not addressed by AMR The codec supports the following bit rates 122 kbit s GSM EFR e 10 2 kbit s e 7 95 kbit s 7 40 kbit s IS 641 6 70 kbit s PDC EFR e 5 90 kbit s e 5 15 kbit s e 4 75 kbit s 1 80 kbit s assuming SID frames are continuously transmitted The 1 80 kbit s rate is not actually a voice signal but the bit rate consumed when Voice Activation Detection VAD is processing a silence Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation This feature is only supported when using the Session Initiation Protocol SIP None of the available Session Description Protocol SDP options are currently supported through Global Call that is direct first party call control The options are only available using third party call control 3PCC where the application is responsible for interpreting received SDP text strings and for constructing all outbound SDP text strings Dialogic IP Media Library API Support The bit rate can be controlled using a new media type in the IPM_MEDIA structure The
33. how to set options when using an EVRC coder type Setup IP address here Local Audio Coder MediaData MediaData MediaData unCount unCount MediaData unCount unCount ediaInfo ediaInfo ediaInfo ediaInfo ediaInfo ediaInfo ediaInfo ipml ipml ipml ipml MediaData unCount MediaData unCount MediaData unCount ipml ipml ipmi unCount tt Remote Audio Coder MediaData MediaData MediaData unCount unCount MediaData unCount unCount ipmMediaInfo ipmMediaInfo ipmMediaInfo ipmMediaInfo ipmMediaInfo ipmMediaInfo ipmMediaInfo MediaData unCount MediaData unCount MediaData unCount unCount eMediaType mediaInfo mediaInfo mediaInfo mediaInfo mediaInfo mediaInfo eMediaType mediaInfo mediaInfo mediaInfo mediaInfo mediaInfo mediaInfo MEDIATYPE AUDIO LOCAL CODER INFO AudioCoderInfo AudioCoderInfo AudioCoderInfo AudioCoderInfo AudioCoderInfo AudioCoderInfo unCoderPayloadType unRedPayloadType MEDIATYPE AUDIO REMOTE eCoderType eFrameSize CODER TYPE EVRC CODER FRAMESIZE 20 unFramesPerPkt 2 eVadEnable CODER_VAD DISABLE 96 0 CODER INFO AudioCoderInfo AudioCoderInfo AudioCoderInfo AudioCoderInfo AudioCoderInfo AudioCoderInfo Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 20
34. ibrary Reference Update to the ipm_GetCTInfo function For the ATCA Multimedia Platform a value of CT DFHMPATCA is returned in the device family field of the CT DEVINFO data structure Update to the ipm GetLocalMedialnfo function This function returns an invalid state error if a coder is not reserved prior to calling the ipm GetLocalMedialnfo function All audio video coders must be reserved using the dev ReserveResourceEx Dialogic Device Management API library function prior to use of the ipm GetLocalMedialnfo function Note The restriction above does not apply when using a fax T 38 media type The ipm GetLocalMedialnfo can be called successfully to retrieve fax port information without using a preceding call to dev ReserveResourceEx The following information relating to ipm GetLocalMedialnfo should also be included For the audio video media types only RTP information needs to be queried RTCP information is automatically provided when querying for RTP Update to the ipm GetLocalMedialnfo function Remove the first caution of the ipm GetLocalMedialnfo function on page 27 and add the following text to the Description section This clarifies eMediaType and unCount as members of data structures referenced by the pMedialnfo function parameter and enumerates the allowed values for the eMediaType field in the IPM MEDIA data structure and corresponding unCount values To retrieve RTP port informati
35. l control or safety systems or in nuclear facility applications It is possible that the use or implementation of any one of the concepts applications or ideas described in this document in marketing collateral produced by or on web pages maintained by Dialogic may infringe one or more patents or other intellectual property rights owned by third parties Dialogic does not provide any intellectual property licenses with the sale of Dialogic products other than a license to use such product in accordance with intellectual property owned or validly licensed by Dialogic and no such licenses are provided except pursuant to a signed agreement with Dialogic More detailed information about such intellectual property is available from Dialogic s legal department at 9800 Cavendish Blvd 5th Floor Montreal Quebec Canada H4M 2V9 Dialogic encourages all users of its products to procure all necessary intellectual property licenses required to implement any concepts or applications and does not condone or encourage any intellectual property infringement and disclaims any responsibility related thereto These intellectual property licenses may differ from country to country and it is the responsibility of those who develop the concepts or applications to be aware of and comply with different national license requirements Dialogic Diva Eicon Eicon Networks Dialogic Pro EiconCard and SIPcontrol among others are either registered trademarks or trademarks of Di
36. local RTCP video port information MEDIATYPE VIDEO LOCAL RTP INFO local RTP video port information Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 25 Dialogic Corporation MEDIATYPE_VIDEO_REMOTE_CODER_INFO remote receive video coder information MEDIATYPE VIDEO REMOTE RTCP INFO remote RTCP video port information MEDIATYPE VIDEO REMOTE RTP INFO remote RTP video port information Fax Values MEDIATYPE FAX SIGNAL fax signal information to be transmitted towards IP during fax transmissions e MEDIATYPE LOCAL UDPTL T38 INFO local UDP packet T 38 information e MEDIATYPE REMOTE UDPTL T38 INFO remote UDP packet T 38 information Note The following eMediaType equates are also provided for backward compatibility the earlier generic names are equated with audio port values However it is recommended that the AUDIO values be used define MEDIATYPE REMOTE RTP INFO MEDIATYPE AUDIO REMOTE RTP INFO ftdefine MEDIATYPE LOCAL RTP INFO MEDIATYPE AUDIO LOCAL RTP INFO ftdefine MEDIATYPE REMOTE RTCP INFO MEDIATYPE AUDIO REMOTE RTCP INFO ftdefine MEDIATYPE LOCAL RTCP INFO MEDIATYPE AUDIO LOCAL RTCP INFO define MEDIATYPE REMOTE CODER INFO MEDIATYPE AUDIO REMOTE CODER INFO define MEDIATYPE LOCAL CODER INFO MEDIATYPE AUDIO LOCAL CODER INFO The IPM MEDIA data structure also includes a new AudionCoderOptionsinfo field of type IPM AUDIO CODER OPTIONS INFO in the
37. mMediaInfo MediaDat unCount Remote Audio Coder ipmMediaInfo MediaDat ipmMediaInfo MediaDat ipmMediaInfo MediaDat ipmMediaInfo MediaDat ipmMediaInfo MediaDat ipmMediaInfo MediaDat ipmMediaInfo MediaDat unCount tt ipmMediaInfo MediaDat ipmMediaInfo MediaDat ipmMediaInfo MediaDat unCount ipmMediaInfo MediaDat ipmMediaInfo MediaDat ipmMediaInfo MediaDat unCount ipmMediaInfo unCount Example 2 a a a a a a a a a a a a a a a a a a a a unCount unCount unCount unCount unCount unCount unCount unCount unCount unCount unCount unCount unCount unCount unCount unCount unCount unCount unCount unCount unCount eMediaType MEDIATYPE AUDIO LOCAL CODER INFO mediaInfo AudioCoderInfo eCoderType CODER TYPE AMRNB 7 95k mediaInfo AudioCoderInfo eFrameSize CODER FRAMESIZE 20 mediaInfo AudioCoderInfo unFramesPerPkt 1 mediaInfo AudioCoderInfo eVadEnable CODER VAD ENABLE mediaInfo AudioCoderInfo unCoderPayloadType 96 mediaInfo AudioCoderInfo unRedPayloadType 0 eMediaType MEDIATYPE AUDIO REMOTE CODER INFO mediaInfo AudioCoderInfo eCoderType CODER TYPE AMRNB 7 4k mediaInfo AudioCoderInfo eFrameSize CODER FRAMESIZE 20 mediaInfo AudioCoderInfo unFramesPerPkt 1 mediaInfo AudioCoderInfo eVadEnable CODER VAD ENABLE mediaInfo AudioCoderInfo unCoderPayloadType 96 mediaInfo AudioCoderInfo unRedPayloadType 0 eMediaType MEDIATYPE AU
38. mposed into individual frames each with a unique time stamp Each new frame is then stored in a jitter buffer before it is sent to the decoder This is done to allow packets arriving out of order to be inserted in the queue in the correct order The size of this jitter buffer is defined by the number of frames stored and is controlled by the PARMCH LATENCYFRAMEINIT AUDIO PARMCH LATENCYFRAMEMAX AUDIO and PARMCH LATENCYALG AUDIO parameters Type Integer Values 30 to 200 frames Default 100 Note 1 On Windows Systems the upper limit of the value is dependent on the channel density and the kernel memory availability 2 While the number of frames to be buffered should be set as high as possible for best quality too high a value will add unnecessary latency to the system Generally the number of frames buffered should be the same size or slightly larger than the number of frames per packet Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 23 Dialogic Corporation Update to the ipm StartMedia function An invalid state error is returned if a coder is not reserved prior to calling the ipm StartMedia function All audio coders must be reserved using the dev_ReserveResourceEx Dialogic Device Management API library function prior to use in the ipm StartMedia function Update to Chapter 3 Events The IPMEV QOS ALARM event description on page 84 indicates that No data is re
39. on for both audio and video in a multimedia session set the eMediaType fields to MEDIATYPE AUDIO LOCAL RTP INFO and MEDIATYPE VIDEO LOCAL RTP INFO respectively and unCount to 2 See the code example Corrected below To retrieve RTP port information for a video only session set the eMediaType field to MEDIATYPE VIDEO LOCAL RTP INFO and unCount to 1 To retrieve RTP port information for an audio only session set the eMediaType field to MEDIATYPE AUDIO LOCAL RTP INFO and unCount to 1 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 21 Dialogic Corporation To retrieve T 38 fax port information set the eMediaType field to MEDIATYPE LOCAL UDPTL T38 INFO and unCount to 1 Note It is not possible to retrieve T 38 fax port information together with audio and or video port information Note The RTCP port number is the RTP port number 1 Update to the ipm GetLocalMedialnfo function In the code example of the ipm GetLocalMedialnfo function replace the line MediaInfo unCount 1 with MediaInfo unCount 2 Update to the ipm ReceiveDigits function Not supported for the ATCA Multimedia Platform Update to the ipm SendDigits function Not supported for the ATCA Multimedia Platform Updates to the ipm SetParm and ipm GetParm functions In addition to the parameters documented in Table 2 elP_PARM Parameters and Values on the IPM PARM INFO data struc
40. on gets a reinvite from the remote side requesting a change of coder Application issues call to stop the media operation Application issues reserve for RESOURCE IPM AMR fails for lack of available resources RESOURCE IPM G726 RESOURCE IPM G729 were the previously reserved coders that state is still preserved as the latest call to reserve failed l ipm_StartMedia ipmh G 729 _ SA l IPMEV STARTMEDIA Gr rr rr rr rb rr MMMM l I ipm Stop SS ee I IPMEV STOP l be ae oe ee ee ee ee 1 i dev_ReleaseResourceEx ipmH RESOURCE_IPM_ALL_AUDIO_CODERS DMEV_RELEASE_RESOURCE 7z 3 3 10 Dialogic Multimedia API Library Reference Update to MM_VIDEO_CODEC data structure For mm record none of the fields in this data structure may be modified as video transcoding is not currently supported 3 3 11 Dialogic Multimedia API Programming Guide There are currently no updates to this document 42 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation 3 3 12 Dialogic Standard Runtime Library API Library Reference There are currently no updates to this document 3 3 13 Dialogic Standard Runtime Library API Programming Guide There are currently no updates to this document 3 3 14 Dialogic Voice API Library Reference There are currently no updates to this document 3 3 15 Dialogic Voice API Programming Guide
41. ote side specifies a list of coders 2 Application reserves all the coders that the remote side offered i or picks a subset from the list and reserves the chosen coders and 1 responds to the remote side with local coder capabilities l ji l dev_ReserveResourceEx ipmH RESOURCE_IPM_G711_20MS RESOURCE_IPM_G723 RESOURCE_IPM_G726 RESOURCE_IPM_G729 I xs I I DMEV_RESERVE_RESOURCE 1 1 I I After the call is done application releases all the coders by I I either explicitly listing the reserved list or 1 I specifying the eum RESOURCE IPM ALL AUDIO CODERS I I I I dev_ReleaseResourceEx ipmH RESOURCE_IPM_ALL_AUDIO_CODERS DMEV_RELEASE_RESOURCE Implicit Release by a Subsequent Successful Reserve Call 1 Application reserves RESOURCE IPM G726 RESOURCE IPM G729 2 Application uses RESOURCE IPM G726 for a media operation ipm StartMedia 3 Application gets a REINVITE from the remote side requesting a change of coder 4 Application issues call to stop the media operation 5 Application issues reserve for RESOURCE IPM G723 This reserve call implicitly releases RESOURCE IPM G726 RESOURCE IPM G729 and replaces with RESOURCE IPM G723 as the only reserved coder 6 Application uses RESOURCE IPM G723 for a media operation ipm StartMedia 7 Application issues call to stop the media operation Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008
42. port for QCELP Codec on page 9 Support for MSML Conferencing With this Service Update the MSML conferencing feature is supported For more information see the MSML Media Server User s Guide Support for AMR and EVRC in MSML With this Service Update the AMR and EVRC audio codecs are supported in MSML For more information about MSML see the MSML Media Server User s Guide Support for QCELP Codec With this Service Update the QCELP 8 kbps and 13 kbps coder type are now supported for media streaming operations Updates to IPM_AUDIO_CODER_INFO The IPM_AUDIO_CODER_INFO data structure has the following updates eCoderType For QCELP e CODER TYPE QCELP 8K QCELP 8 kbps e CODER TYPE QCELP 13K QCELP 13 kbps Dialogic Corporation 10 The QCELP coder type supports frame size of 20 frames per packet of 1 2 or 3 and eVadEnableValue of CODER_VAD_DISABLE Updates to IPM_AUDIO_CODER_OPTIONS_INFO The IPM_AUDIO_CODER_OPTIONS_INFO data structure has the following additional values unCoderOptions For QCELP set to CODER_OPT_SIGNALING_OFF unParm1 For QCELP where the media type is MEDIATYPE_AUDIO_REMOTE_CODER_OPTIONS_INFO valid values are e CODER OPT CDMA RATE REDUC Rate reduction Bit rate is varied to achieve a variety of average bit rates for more flexibility in bandwidth usage nValue1 For QCELP 8 kbps where unParm12CODER OPT CDMA RATE REDUOC possible values are 0 and 4 Default value is 0 For
43. r For defects that were resolved when the base release was generally available before any Service Updates a is shown For non resolved issues this information is left blank Product or Component The product or component to which the problem relates for example an API Description A summary description of the issue For non resolved issues a workaround is included when available Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 11 Dialogic Corporation Issues Sorted by Type Dialogic Multimedia Platform SU Product or Issue Type Defect No No Component Description Known IPY00035453 call control User cannot select TCP or UDP as mode of transport for SIP on per call basis It can be set for all messages during initialization Known IPY00034680 CLI When accessing the CLI the three built in accounts acctmgr admin and craft are not working After the password is entered the login prompt is returned instead of the cli prompt Workaround 1 Use root public as username password This account will grant access to the CLI 2 Create a new username password combination and renew this combination every 90 days so it does not expire Known IPY00034558 CLI The man page for the adduser command has incorrect usernames and values in the EXAMPLE portion of the page The correct EXAMPLE text is EXAMPLE No 1 adduser userl passi A ne
44. received or when a CMR value of 15 don t care is received from the opposite side The CMR rules are set in the AudioCoderOptionsInfo unCoderOptions field by ORing in either CODER OPT AMR CMR TRACK or CODER OPT AMR CMR LIMIT Specifying a CMR rule is mandatory and the rules are mutually exclusive Note The CMR rules are not used by the MEDIATYPE AUDIO LOCAL CODER OPTIONS INFO eMediaTypes Supported RTP Payload Format AMR supports two different formats for the RTP payload Bandwidth efficient to minimize the amount of network bandwidth Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 33 Dialogic Corporation e Octet aligned to make the packet parsing easier for the AMR application The AMR RTP payload format is specified in the new IPM AUDIO CODER OPTIONS INFO AudioCoderOptionsInfo structure in the IPM MEDIA structure The MEDIATYPE AUDIO LOCAL CODER OPTIONS INFO media type controls the receive side and the MEDIATYPE AUDIO REMOTE CODER OPTIONS INFO media type controls the transmit side The IPM MEDIA structure contains a union with an IPM AUDIO CODER OPTIONS INFO structure The AMR RTP payload format is controlled by ORing in either CODER OPT AMR EFFICIENT or CODER OPT AMR OCTET in the AudioCoderOptionsInfo unCoderOptions field Note Specifying an AMR RTP payload is mandatory and the formats are mutually exclusive Example 1 In this example th
45. rescans the list from the beginning Workaround The user can reset the fallback list manually At a minimum there will always be a valid tx PSTN clock provided by internal oscillator Known IPY00033354 conferencing CNF The cnf GetPartyList function does not return correctly when max parties 240 are entered into the conference Known IPY00033349 conferencing CNF CNFEV_SET_ATTRIBUTE_FAIL is received when attempting to disable tone clamping Known IPY00035617 configuration The RFC2833 payload type is currently set to 101 Even though the user may specify another payload type for RFC2833 the software transmits RFC2833 with payload type of 101 Known IPY00035616 configuration The RTCP port number is not configurable by the user RTCP port will always be RTP 1 Currently this cannot be changed by the user Known IPY00035815 firmware The firmware tries to load the Rear Transition Module RTM PCI driver even when the RTM is not present The firmware displays a KILLTASK message in the var log messages file because the RTM driver failed to initialize Since the RTM is not present the firmware should not try to initialize the RTM driver and should not treat the failure as an error The error can be ignored Known IPY00032953 firmware QERROR_WARNING received during download with Cause Tag 80011 Location Tag 49111 The warning can be ignored Known IPY00037689 hardware If the Dialogic Multimedia
46. rleaving option can be specified in the IPM AUDIO CODER OPTIONS INFO data structure 37 Dialogic Corporation 38 Resource reservation of audio coders The following information which is applicable to the ATCA Multimedia Platform should be added to the programming guide possibly as a new chapter Resource Reservation of Audio Coders The following sections describe the use of the IPML API and Device Management API in various scenarios for resource Outbound Call reservation of audio coders 1 Application reserves coders RESOURCE IPM G711 20MS RESOURCE IPM G723 RESOURCE IPM G726 RESOURCE IPM G729 and offers the reserved coders to the remote side 2 The remote side picks G723 G726 3 Application releases RESOURCE IPM G711 20MS RESOURCE IPM G729 This leaves RESOURCE IPM G723 RESOURCE IPM G726 as the reserved audio coders 4 The application proceeds with the call 5 After the call is done the application releases the coders RESOURCE IPM G723 RESOURCE IPM G726 Alternatively the application can release all the reserved coders by specifying the enum RESOURCE IPM ALL AUDIO CODERS Application queries for availability and then reserves coder resource s T APP I H L I 1 dant dev ReserveResourceEx ipmH RESOURCE IPM G711 20MS RESOURCE IPM G723 RESOURCE IPM G726 RESOURCE IPM G729 L I L 1 1 1 dev ReleaseResourceEx ipmH
47. rrect length of time the file has played it returns O Resolved IPY00036831 77 PSTN call control Turning on NLP causes channel failure 16 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation Issues Sorted by Type Dialogic Multimedia Platform Continued Issue Type Defect No SU No Product or Component Description Resolved IPY00035425 77 PSTN call control The firmware is printing unnecessary logs to the messages file These messages can be ignored The messages are similar to the following Oct 19 11 10 31 pylatcatvl16 CLIAGENT From Component IPMS ShowLinkAlarm LastChange 0 seconds Oct 19 11 13 22 pylatcatvl16 ssp_x86Linux_boot line 3056 file src c tsccomp c Oct 19 11 13 22 pylatcatvl16 ssp x86Linux boot line 1198 file src c tsccomp c Oct 19 11 13 22 pylatcatvl16 ssp x86Linux boot line 3056 file src c tsccomp c Oct 19 11 13 22 pylatcatvl16 ssp x86Linux boot line 1198 file src c tsccomp c Oct 19 11 13 22 pylatcatvl16 OxffffO0O00 TSC 000 Received unexpected message Unknown message type 0x1244 from 0 0 2 b OxffffO000 TSC 001 Received unexpected message Unknown message type 0x1234 from 0 0 2 b OxffffO000 TSC 000 Received unexpected message Unknown message type 0x1244 from 0 0 2 b OxffffO000 TSC 032 Received unexpected message Unknown message type 0x1234 from 0 0 2 b Oct 19 11 14 47 pylatcatvl16 ssp x86Linux
48. s Sorted by Type Dialogic Multimedia Platform Continued SU Product or Issue Type Defect No No Component Description Resolved 1PY0003691 1 70 MSML Failure occurs when running 120 G 711 and 120 G 729 coders on the Dialogic Multimedia Blade Resolved 1PY00036601 70 MSML CMR bits in octet aligned mode are in the wrong location of the AMR NB RTP payload Resolved IPY00036309 70 MSML Density for LBR codecs on Mindspeed is less than what it should be when mixed with PSTN channels or G 711 20ms 30ms 40ms channels on the Mindspeed device Resolved 77 MSML An MSML media_server segmentation fault can occur using the http scheme to play record files on multiple channels at the same time Resolved IPY00036058 77 MSML User may have to re initialize the Dialogic Multimedia Blade if the MSML server does not exit gracefully after C Resolved IPY00035828 77 MSML User needs to manually set the debug state to 1 in the RtfConfigLinux xml for media_svr Resolved IPY00034094 MSML The media section is missing from the rtfconfiglinux xml file In order to perform any media server debug tracing the parameters need to be added and then switched on Resolved IPY00033420 MSML PSTN is not supported through MSML Resolved IPY00033245 MSML Media server does not return correct error code for record tests Resolved IPY00032622 MSML The play amt shadow variable does not return the co
49. s available no capability detail is retrieved e fa num is larger than the number of capabilities available the return value a_CapabilitiesArray is filled with details of all capabilities and the remaining allocated memory is unused e fa numis smaller than the number of capabilities available the return value a_CapabilitiesArray is filled with details of a num capabilities that is as many as will fit details of the remaining capabilities are not retrieved Parameter Description n DeviceHandle handle of the IP Media device a CapType capability type for example CAPABILITY CODERLIST a num the number of entries in the capability array a_CapabilitiesArray the capability array a usMode operation mode Set to EV SYNC for synchronous execution Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 27 Dialogic Corporation The datatype for the a_CapabilitiesArray parameter is a union IPM_CAPABILITIES which is defined as follows typedef struct ipm capabilities tag unsigned int version union IPM_CODER_INFO Coder Future types here IPM_CAPABILITIES In this union the IPM_CODER_INFO data structure provides coder details such as coder type frame size number of frames per packet VAD enable disable information and payload related information The datatype for the a_CapType parameter is eCAPABILITY_TYPE an enumeration that is defined as follows enum
50. tely try again in a few seconds This will start the CLI agent and user will be able to use telnet again 14 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation Issues Sorted by Type Dialogic Multimedia Platform Continued Issue Type Defect No SU No Product or Component Description Known permanent IPY00033953 IPML Calling ipm_SetParm without calling ipm_Open causes the library to crash and the application to exception Workaround Do not call any IPML functions without first opening the device Known permanent IPY00033884 IPML Calling ipm_SetParm asynchronously three times per device sequentially for 360 devices hangs the library The parameters being used in ipm_SetParm are DIMFXFERMODE RFC2833 PARMCH RFC2833EVT TX PLT and PARMCH RFC2833EVT RX PLT Workaround The application should wait for IPMEV SETPARM before issuing the next ipm SetParnm Resolved IPY00033685 CLI SNMP Using SNMP or CLI to start the media results in the media devices not being initialized The command will return and the download will take place but no devices are being initialized Resolved EVRC Use of EVRC has to be specifically enabled Resolved IPY00036983 77 hardware The SDR file for IP only RTM MMBRTMIP01AQ_100 SDR cannot be downloaded using the sbcupdate utility
51. tion Document Revision History This Revision History summarizes the changes made in each published version of the Release Update for the Dialogic Multimedia Platform for AdvancedTCA which is a document that is periodically updated throughout the lifetime of the release Document Rev 06 published January 23 2008 Made global changes to reflect Dialogic Brand and changed title to Dialogic Multimedia Software for AdvancedTCA Release 1 0 Release Update In the Documentation Updates chapter Removed documentation updates in Dialogic Voice API Library Reference as a new version of document 05 2333 004 is available e Removed documentation updates in Dialogic Voice API Programming Guide as a new version of document 05 2332 004 is available Removed documentation updates in MSML Media Server User s Guide as a new version of document 05 2513 001 is available Document Rev 05 published June 22 2007 Updated for Service Update 81 In the Post Release Developments chapter Added Summary of Features e Added Support for MSML Conferencing Added Support for AMR and EVRC in MSML Document Rev 04 published June 8 2007 Updated for Service Update 80 In the Post Release Developments chapter Added Support for QCELP Codec In the Release Issues chapter Updated description of Known Defects IPY00038148 IPY00038149 e Added the following Known Defect IPY00037689 In the Documentation Updates chapt
52. to reflect the new Dialogic brand To uninstall the existing version of the software run the uninstall script d guninstall sh distributed with the existing version of the software located in usr dialogic bin The uninstall script gives you an opportunity to save your configuration settings to a backup location before starting the uninstall After you have saved your configuration settings run the uninstall script again After the uninstall has completed it is not necessary to reboot the system However you must log out and log in to restore the environment settings After successfully uninstalling the existing version of the software you can install the new software Instructions for installing the software are provided in the Technical Product Specification Dialogic Corporation 1 2 1 3 1 4 1 5 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Summary of Features The following table lists the features introduced in service updates after the initial release of Dialogic Multimedia Software for AdvancedTCA Release 1 0 and where to find more information about these features Service Feature For more information Update MSML conferencing 81 see Section 1 3 Support for MSML Conferencing on page 9 and MSML Media Server User s Guide AMR and EVRC in MSML 81 see Section 1 4 Support for AMR and EVRC in MSML on page 9 QCELP codec 80 see Section 1 5 Sup
53. ture reference page the IP Media Library API supports the setting and retrieval of the following parameters relating to Packet Loss Recovery PLR latency elP PARM Define Description and Values PARMCH LATENCYALG AUDIO Defines the mode of operation of the jitter buffer By default the jitter buffer uses adaptive mode which means latency can grow until the available number of frames PARMCH_ LATENCYFRAMEMAX AUDIO is depleted Using fixed mode the number of frames buffered can grow up to 1 5 times the starting value PARMCH LATENCYFRAMEINIT AUDIO Type Integer Values 0 adaptive mode or 1 fixed mode Default 0 Note Use adaptive mode to minimize audio loss due to abnormal packet reception conditions Use fixed mode to minimize latency growth by sacrificing audio quality 22 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation elP PARM Define Description and Values PARMCH LATENCYFRAMEINIT AUDIO Specifies the amount of Packet Loss Recovery PLR latency delay that can be introduced by defining the initial number of frames that can be buffered This parameter defines the starting value for initial latency When fixed mode is enabled see PARMCH LATENCYALG AUDIO the number of frames buffered can grow up to 1 5 times the starting value For example if the parameter value is 6 the maximum number of frames that can be buffered is 9 The PLR module
54. turned in the event This statement is misleading because it implies that it is not possible to determine which alarm triggered the event Replace the description with the following text IPMEV QOS ALARM Unsolicited event enabled via ipm EnableEvents Event is returned when desired QoS alarm gets triggered For information on determining which alarm triggered the event see the code example and specifically the CheckEvent function definition in the Dialogic IP Media Library API Programming Guide section on Example Code for QoS Alarm Handling Update to the IPM AUDIO CODER INFO data structure Update for the eCoderType field The following possible values have been added for specifying the transmit bit rate when using AMR coders CODER TYPE AMRNB 4 75k 4 75 kbit s CMR type 0 CODER TYPE AMRNB 5 15k 5 15 kbit s CMR type 1 CODER TYPE AMRNB 5 9k 5 9 kbit s CMR type 2 CODER TYPE AMRNB 6 7k 6 7 kbit s CMR type 3 CODER TYPE AMRNB 7 4k 7 4 kbit s CMR type 4 CODER TYPE AMRNB 7 95k 7 95 kbit s CMR type 5 CODER TYPE AMRNB 10 2k 10 2 kbit s CMR type 6 CODER TYPE AMRNB 12 2k 12 2 kbit s CMR type 7 CODEC AUDIO AMRNB NONE Don t care CMR type 15 Indicates that the software does not care what bit rate it receives the eCoderType field sets the CMR value in the transmitted packet For the MEDIATYPE AUDIO LOCAL CODER INFO media type all of the above values are valid For the MEDIATYPE AUDIO REMOTE CODER INFO m
55. union that provides option details See details of the IPM AUDIO CODER OPTIONS INFO structure following in this section of the Release Update New function and data structure A new function ipm GetCapabilities and new data structure IPM AUDIO CODER OPTIONS INFO have been added to the IPML API See below for details Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation ipm_GetCapabilities Name ipm GetCapabilities nDeviceHandle a_CapType a num a_CapabilitiesArray a usMode Inputs int nDeviceHandle P Media device handle eCAPABILITY TYPE a CapType capability type to be retrieved unsigned int a num number of entries in the capability array IPM CAPABILITIES a CapabilitiesArray capability array unsigned short a usMode async or sync mode setting Returns number of capabilities available on failure Includes srllib h ipmlib h Category Media Session Mode synchronous B Description The ipm GetCapabilities function returns the number of capabilities of the specified type for example coders and details of each capability supported by an active HMP software license The number of capabilities available may be greater than the number specified by the a num input parameter therefore the following rules apply e If a_num is zero and or a CapabilitiesArray is NULL this function returns only the number of capabilitie
56. w User and his details can be added to the Security table Username and Password are position defined and their values have to be entered with option No 2 adduser userl pass123 a 50 g 50 i ADVENTMAINT Known IPY00034557 CLI The man page for the edituser command shows the wrong command in the EXAMPLE portion of the page it shows adduser instead of edituser The correct EXAMPLE text is EXAMPLE No 1 edituser p userl passl Edit and modify the details of any user in the User table Username is position defined and their values have to be entered with option NO 2 edituser p pass123 g 50 a 50 i ADVENTMAINT userl 12 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corporation Issues Sorted by Type Dialogic Multimedia Platform Continued SU Product or ee Issue Type Defect No No Component Description Known IPY00034601 clocking The TDM clock manager does not switch to a valid clock that is located earlier in the fallback list before the failed entry For example if the last valid trunk clock source fails the firmware chooses the internal oscillator as the clock source instead of a previously recovered trunk that is in the fallback list The correct behavior is that the fallback list should be rescanned from the beginning before choosing internal oscillator Note if any clock recovers while internal oscillator is selected then the firmware
57. w to Use This Publication This Release Update is organized into three sections click the section name to jump to the corresponding section Document Revision History This section summarizes the ongoing changes and additions that are made to this Release Update after its original release This section is organized by document revision and document section Post Release Developments This section describes significant changes to the release subsequent to the general availability release date For example new features provided in service updates are described here Release Issues This section lists issues that may affect the system release hardware and software Documentation Updates This section contains corrections and other changes that apply to the documentation set that were not made to the documents prior to the release The updates are organized by documentation category and by individual document Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 3 Dialogic Corporation About This Publication Related Information See the following for additional information http www dialogic com manuals for Dialogic product documentation e hitp www dialogic com support for Dialogic technical support http www dialogic com for Dialogic product information 4 Dialogic Multimedia Software for ATCA Release 1 0 Release Update Rev 06 January 23 2008 Dialogic Corpora
Download Pdf Manuals
Related Search