Home

Embedded SDK (Software Development Kit)

1. include mem h ifdef USEPARSER include cidparser h fendif ifdef USEGEC include gec h fendif struct teldefs tsSamples LinelSamples struct cid tsData pcidlData struct teldefs tsControl LinelControl ifdef USEPARSER teldefs sParser ParserControl fendif ifdef USEGEC struct gec tsData pgeclData fendif int main void Initialize some necessary structure elements and call create function LinelControl messageDone 0 LinelControl cidByteReady 0 LinelControl ExtUseCheck 0 LinelControl NoExtFound 1 LinelControl FrameErrors 0 LinelControl dtmfRequest 0 LinelControl dtmfComplete 0 LinelControl hookSwitch 0 LinelControl flashCommand 0 LinelControl cwdCommand 0 pcidlData Typel2CIDcreate amp LinelControl ifdef USEPARSER ParserControl FskMessageIndex 0 ParserControl FskParserLength 0 endif 6 2 Type 1 and 2 Telephony Features Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Ing jication Using cid12 lib ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 ifdef USEGEC initialize all process variables for GEC LinelControl gecLengthIndex 0 pgeclData gecEchoCancellerCreate amp LinelControl endif while 1 Wait for 5 8KHz samples to be
2. A line interface is needed to detect the presence of a power ringing signal The line interface can be a Data Access Arrangement DAA or any line interface that can pass FSK signals from the telephone network and has a ring detect circuit that can indicate to the DSP that a power ringing signal has been received The line interface circuitry may vary depending on the individual case For the Type 1 and 2 Telephony Features Library to comply with Telcordia SR 3004 requirements the user must supply a suitable line interface that meets the following requirements e Frequency Response The received signal must be within voice also called line bandwidth which ranges from 300 to 3400Hz MOTOROLA Introduction 1 3 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 e Attenuation Distortion Front End Range The Type 1 and 2 Telephony Features Library is designed to interoperate with an Analog to Digital Converter ADC with an analog signal input range of 2 73dBm 3dB In other words the ADC in the line front end should have a 3V peak to peak analog input voltage range Introduction In one possible implementation using the Motorola DSP56858EVM board the ring signal indication from the line interface must pass to the DSP56858EVM on one of the DSP s GPIOB pins The signal from the line interface can be pass
3. mm dsp568xxevm EH nos i applications bsp an config __ include HJ modem H multimedia E security HC signal speech pa sys _ telephony aec am caller id E cas detect JJ cidparse H cidtypet m cidtype12 5 Debug H cpt H 4 H H H Figure 2 2 cidtype12 Directory The telephony directory shown in Figure 2 3 includes specific vocoder algorithms such as G 726 as well as cidtypel2 the directory that includes the Type 1 Telephony Features Library for receiving off hook Caller ID and other services The cidtype 2 directory includes Type 1 and 2 interface algorithms EH cidtype12 Debug EE configintram Figure 2 3 cidtype12 Directory Structure 2 2 Type 1 and 2 Telephony Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semicondustor ING in Specitic Directories ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 The cidtype12 directory shown in Figure 2 3 includes e Debug contains the library file cid lib for the prebuilt Type 1 Telephony Features Library e test contains the test project cid test mcp for the prebuilt Type 1 Telephony Features Library contains C source for the test application configint
4. 2 Functionality The Type 2 Caller ID service is also known as Calling Identity Delivery on Call Waiting CIDCW Dur ing a conversation between two parties CIDCW occurs if a third party calls one of the two parties If the 1 6 Type 1 and 2 Telephony Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semicanductor I9Gphony Features Library ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 party called is using a Type 2 CPE an SAS or call waiting tone will be received along with the dual tone CAS If the Type 2 CPE detects no other extensions in use it will acknowledge the CAS with a DTMF D signal used by Type 2 CPE for handshaking purposes with the Central Office CO upon reception of a CAS signal The PSTN will send the Caller ID information via FSK transmission If the CPE receives the FSK data correctly the CPE will display the Caller ID information The following paragraph describes the handshaking sequence for a Type 2 CPE receiving FSK data in the off hook state The SAS is sent to the called party along with the CAS from the PSTN CO i e the call terminating switching system to request that the line be cleared of conversation to allow the delivery of the FSK data The CO switch has momentarily muted the far end party before sending the SAS and CAS Upon receiving a CAS the Type 2 CPE will test to determine if parallel handsets are in use If so n
5. 51 amp 3 SDK Configuration 220 138 m B appconfig c 5 De x B appcontig h 0 0 m B config c 85 8 m B const c 0 0e x B vector c 130 Q x B pramdata c 0 130 m B linker cmd n a nia zm EC Sources 217 EK xi B main c 217 8239 m 20 files 107K 12K LZ Figure 4 1 Example of a cid12 Library Link to a Project MOTOROLA Building the Type 1 and 2 Telephony Features Library 4 1 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Building the Type 1 and 2 Ersescals 2amigonductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 4 2 Type 1 and 2 Telephony Features Library For More Information On This Product Go to www freescale com MOTOROLA ARCHIVED 3Y FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 5 Linking Applications with the Type 1 and 2 Telephony Features Library 5 1 Type 1 and 2 Telephony Features Library The Type 1 and 2 Telephony Features Library consists of an initialization and processing function The Type 1 and 2 Telephony Features Library can be initialized and created by the Type12CIDinit and TypelI2CIDcreate functions Their functionality and arguments are described in Section 3 3 3 and Section 3 3 1 respectively The library contains APIs which provide the interface between the user application and the Type 1
6. Telephony Solution 1 2 Sequence for Delivery of FSK Data During a Call Using Type 2 CPE 2d Core DECIES Las o ARD ee eh ee es ee ee ees 2 Peel 2 PUG kik ie dae eeecknedaks eek Cassa cee gdseaechdheenrincaaes D Qidiypel2 ey SUMME erroa QUA E ERA QUOI Rea RETE REP qe RR d seed adiri l Example of acidl2 Library Link to a Project oseeeeeekseecsoczksesteseceseesess MOTOROLA List of Figures For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 vi Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Type 1 and 2 Telephony Features Library For More Information On This Product Go to www freescale com MOTOROLA ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 List of Code Examples 3 1 teldefs h Reference Definition for Typel2C ID 2sssaseaessu stare rr mea 42 0124 Reterence Definition for Type LAC ID iuusaues s nk stb RR REGRESAR 5 1 Example of a linker cmd File for Type 1 and 2 Telephony Features Library 28 o0 ea uo PR MOTOROLA List of Code Examples For More Information On This Product Go to www freescale com vii ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 viii Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Type 1 and 2 Telephony Features Library For More Information On This Pr
7. Type 1 and 2 Telephony Features Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Ing snos Using cid12 lib ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Code Example 6 1 shows a basic application using the cid 2 lib module This module is designed to interact with the Type 1 and 2 Telephony Parser Library cidparser lib however independent use of the cid12 lib module is supported When receiving Type 2 Caller ID it is recommended that an echo canceller be incorporated to attenuate network echo most easily accomplished by using the gec lib module When implementing a full duplex speakerphone the cid 2 lib module is intended to be used with the fdspk lib and gec lib modules however custom line echo canceller and full duplex speakerphone software can also interface with the cid 2 lib module This example shows how to manage Caller ID information using either the Type 1 and 2 Telephony Parser Library or a custom parser When a custom parser is desired the definition USEPARSER is undefined When using a custom parser the application must transfer the input bytes into a buffer then process them This is done automatically when using the Type 1 and 2 Telephony Parser Library While this module is primarily intended to be used for Caller ID reception other convenient features are added to allow for simple integration into a Caller ID telep
8. and 2750Hz so two filters are needed for detecting the frequencies one bandpass filter for 2130Hz and one bandpass filter for 27750Hz Signals passed by these two bandpass filters are estimated for power level In order to define that a CAS has been detected the power level must exceed a pre defined threshold When the CAS is detected if no extensions are found to be in use the Type 1 and 2 Telephony Features Library mutes the voice path and keypad sends a DTMF D signal to the PSTN to request FSK data deliv ery then enables the Module s FSK receiver The FSK data received is processed in the FSK receiver The operation of the FSK receiver parser and display functions are identical to Type 1 Caller ID reception described in Section 1 3 1 1 3 3 Features and Performance Table 1 1 details the memory and MIPS requirements for the Type 1 and 2 Telephony Features Library Table 1 1 Type 1 and 2 Telephony Features Library Memory and MIPS Requirements Program Data RAM Memory Data ROM D PAM Additional MIFS 1st Instance When all program ROM 16 bit p Instance xf 16 bit and data is internal 16 bit words 16 bit words words words memory Type 1 and 2 Telephony 28K 20 257 192 9 6 Features Library 1 8 Type 1 and 2 Telephony Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARC
9. can receive VMWI without power ringing If receiving Caller ID power ringing will be signaled to the DSP to disable the FSK receiver during the ringing The digital samples must be collected with an ADC at the sampling rate of 8KHz with a minimum of 14 bit linear precision 8 bit u law The ADC is not part of this solution and must be supplied separately by the application developer however the DSP56858EVM board contains an ADC The FSK receiver starts processing the digital samples received as soon as the ADC sends them The FSK receiver accepts an FSK signal transmitting at a baud rate of 1200bps accord ing to Telcordia Technologies SR 3004 MOTOROLA Introduction 1 5 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 The digital samples from the ADC will first pass through a bandpass filter BPF as shown in Figure 1 1 where only the signals within line bandwidth 300 3400Hz can be passed The BPF output will be pro cessed in an Automatic Gain Control AGC function The AGC estimates the signal level to compensate for the amplitude distortions introduced by the telephone network In addition the estimated power level is used for signal detection The AGC output sample is then sent to a software demodulator Introduction The demodulator will introduce a double frequency component The following
10. freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Type 1 and 2 Telephony rareesgale ADRS nductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Go onhook go_onhook else if LinelControl ExtUseCheck 2 Detect extension in use here if poll extension in use check here LinelControl NoExtFound 0 else LinelControl NoExtFound 1 else if LinelControl ExtUseCheck 3 Go offhook go offhook LinelControl ExtUseCheck 0 Process command for line flash if LinelControl flashCommand LinelControl flashCommand 0 if LinelControl flashPolarity 1 go offhook else go onhook ifdef USEPARSER Use Type 1 and 2 Telephony Parser Library CIDMessageParser amp ParserControl amp LinelControl if ParserControl FskParserLength 0 Parsed Message Ready Send to Output Device if ParserControl ErrorType 0 for i 0 i lt ParserControl FskParserLength i printf c Parsercontrol FskParserBuffer i ParserControl FskParserLength 0 elseif Use Custom Parser if LinelControl cidByteReady Buffer cid bytes here cid message buffer cid message index LinelControl cidByte if LinelControl messageDone if LinelControl FrameErrors 0 Call custom Parser here else LinelControl FrameErrors 0 endif 6 4
11. received and transmitted by the Codec Interrupt Service Routine while SamplesReady CalleridAppMain Typel2CIDdestroy pcidlData amp LinelControl ifdef USEGEC gecEchoCancellerDestroy pgeclData amp LinelControl fendif return 0 void CalleridAppMain int i copy samples from Codec buffers for i 0 i lt 5 itt codecBufferLeftout i LinelSamples audio i codecBufferRightout i LinelSamples line i LinelSamples line i codecBufferLeftin i LinelSamples audio i codecBufferRightin i Get Ring Signal from DAA if Poll Ring Detect Bit Here else ifdef USEGEC Call Generic Echo Canceller do nothing LinelControl cidRingPolarity 1 Ring present LinelControl cidRingPolarity 0 Ring not present for 1 0 1 lt 5 it t gecEchoCanceller pgeclData amp LinelControl amp LinelSamples else for i 0 1 lt 5 i LinelSamples leccid i LinelSamples line i fendif Call Type 1 and 2 Telephony Features Library Type12CID pcidlData amp LinelControl amp LinelSamples Do extension in use check If no detection circuit is present always set LinelControl NoExtFound 1 if LinelControl ExtUseCheck 1 MOTOROLA Type 1 and 2 Telephony Features Library Applications 6 3 For More Information On This Product Go to www
12. structure instances for the Type 1 and 2 Telephony Features Library is described in header file cid12 h shown in Code Example 3 2 Code Example 3 2 cid12 h Reference Definition for Type12CID difndef CID12 H define CID12 H RR KK KK kk ke kj kk ke ke kk oko k kk eek Foundational Include Files FI AKA A A A A I I IK include cid_typel2 h ifndef _ TELDEFS H include teldefs h endif S EE KK K K KKK KKK KK ke kk I k k k k k k k k k k A ke k k k kk k IKK Structures that must be defined befor accessing Type 1 and 2 Caller_ID pointer Examples are shown below FARK ke ko A A I AAA AA A koe ke ke eee e k teldef sControl LinelControl cid sData pCID12Data teldef_sSample LinelSamples hy MOTOROLA Type 1 and 2 Telephony Features Library Interfaces 3 3 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Type 1 and 2 Telephony FEreescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 BRK KKK kk kk kk ke ke ko ko I AKA ke ko ke ke k k koe ke ke ke ek Function Prototypes for Type 1 and 2 Interface Library Fe KARA ke A A I AAA AAA kk eee e ke k f cid sData Typel2CIDcreate teldef tsControl pControl int Typel2CIDdestroy cid sData pData teldef tsControl pControl void Typel2CIDinit cid sData pData teldef tsControl pControl void Typel2CID cid sData pData teldef tsControl pControl teldef tsS
13. such as Visual Message Waiting Indicator VMWT or Call Qualifier CQ as well as future services that would use the on hook GR 30 CORE Voiceband Data Transmission Interface from the Public Switched Telephone Network PSTN Type 1 CPE supports on hook signaling with or without power ringing and can decode data frames packaged in the GR 30 CORE Single Data Message Format SDMF or Multiple Data Message Format MDMF depending on the needs of the spe cific telephony service supported as described in Telcordia SR 3004 and other referenced service specific documents While this module is primarily intended to be used for Caller ID reception other convenient features have been added to allow for simple integration into a Caller ID telephone While the module is in an on hook state ring generator samples may be created during power ringing These samples may be output to an audio channel for example to be played to a speaker While the module is in an off hook state DTMF samples may be generated for dialing digits Timing for a line flash is also provided The Caller ID is received between the first and second ring The content displayed should include date time and the directory telephone number and or the name of the caller Other existing service specific con tent may also be displayed such as Call Qualifier displays The service specific content of future services may be displayed when these become deployed in the PSTN VMWI may be transmit
14. that Motorola was negligent regarding the design or manufacture of the part Motorola and the Stylized M Logo are registered trademarks of Motorola Inc Motorola Inc is an Equal Opportunity Affirmative Action Employer MOTOROLA and the Stylized M Logo are registered in the US Patent amp Trademark Office All other product or service names are the property of their respective owners Motorola Inc 2002 How to reach us USA EUROPE Locations Not Listed Motorola Literature Distribution P O Box 5405 Denver Colorado 80217 1 303 675 2140 or 1 800 441 2447 JAPAN Motorola Japan Ltd SPS Technical Information Center 3 20 1 Minami Azabu Minato ku Tokyo 106 8573 Japan 81 3 3440 3569 ASIA PACIFIC Motorola Semiconductors H K Ltd Silicon Harbour Centre 2 Dai King Street Tai Po Industrial Estate Tai Po N T Hong Kong 852 26668334 Technical Information Center 1 800 521 6274 HOME PAGE http www motorola com semiconductors MOTOROLA For More Information On This Product SDK140 D Go to www freescale com
15. A A I KA A IA A IK n ECTIONS JE A Re I A AA eA A A eA A A AA A A A A A A A I KA A I KKK KKK ApplicationInterruptVector vector c text gt pInterruptVector EA He I A AA A A A EA A A AA A A A A A A A I A I KA A Kk KKK Kk K ApplicationCode Place all code into Program RAM text rtlib text fp engine text user text Place all data into Program RAM F Pdata start addr in ROM 0 F Pdata start addr in RAM 5 2 Type 1 and 2 Telephony Features Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor MOGs phony Features Library ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 pramdata c data F_Pdata_ROMtoRAM_length 0 F Pbss start addr P BSS ADDR pramdata c bss F Pbss length _P_BSS_ADDR pExtRAM Ee kk Ck kk kk kk kkk kk Ck Ck Ck kk Ck Ck kk CK ck kk ke k kk K kk ko kk kk Ck CK kkk ke kk Ck kk kk kkk kkk kkk kk kkk ke CID12LibrayCode ies ide code into Program Internal RAM cidl2 text gt pIntRAM KKEKKKKKKKKKKKKKKKKKKKKKK KK KKK KKK ckck ck ck ck ck ck ck ck ck ck ckck ck ck ck ck kckckckckck ck ck ck ckck ck ck ck ck ck ck kk kk kk ko kk ApplicationData Define variables for C initialization code F Xdata start addr in ROM F StackAddr ADDR xStack F StackEndAddr ADDR xStack SI
16. CTOR INC 2005 In this example there are two GPIO pins one output pin which places the telephone interface on hook or off hook and one input pin which indicates the ring detect from the telephone interface The ring detect pin is polled in the application and its polarity is placed in the variable Line Control cidRingPolarity This information is necessary for the Type 1 and 2 Telephony Features Library even when disableRinger is set disabling the ring tone generator and should be polled at a rate of 1600 sec as shown in the application However slower polling rates may be tolerated It is assumed that the functions go onhook and go offhook which are not shown in Code Example 6 1 would simply set or clear the output pin connected to the telephone interface However note that these are not the same as when the application actually puts the module into an on hook or off hook state In this situation the application must also set or clear the Line Control hookSwitch variable then call Type12CIDinit The Codec Interrupt Service Routine is also not shown in this example This routine is assumed to transmit and receive 8KHz samples from a codec and read write to the buffers codecBufferLeftin and codecBufferLeftout This codec is connected to the telephone line interface This routine is also assumed to transmit and receive 8KHz samples from a codec and to read write to the buffers codecBufferRightin and codecBufferRightout T
17. D BY FREESCALE SEMICONDUCTOR INC 2005 Type 1 and 2 Telephony FEreescale Semiconductor Inc 3 12 ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Type 1 and 2 Telephony Features Library For More Information On This Product Go to www freescale com MOTOROLA ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 4 Building the Type 1 and 2 Telephony Features Library 4 1 Building the Type 1 and 2 Telephony Features Library The Type 1 and 2 Telephony Features Library combines all components described in the previous section into one library cid12 lib The library is prebuilt for the user so a project for building the library is not provided The library is located in the telephony cidtype12 lib directory of the SDK directory structure Figure 4 1 shows how the cid 2 lib is linked to the Type 1 and 2 test project cid12test mcp The header file teldefs h also must be linked when using the Type 1 and 2 Telephony Features Library cid 2 lib p cid12test mcp iof x External RAM ig x A P Files Link Order Targets g File ode Daa J amp amp Sq Dependencies 107K EK x 3 MSL 56800E 43K 5K zi amp 3 SDK Libs 63K 1K a bsp lib 9536 715 a dspfunc lib 40328 100 x sys lib 5574 283 a tools lib 3438 58 a cid12 lib 5564 0 a SDK Projects D n a
18. DSP56800E Reference Manual DSP56800ERM D Motorola DSP568xx User s Manual for the DSP device you re implementing Inside CodeWarrior Core Tools Metrowerks Corp MOTOROLA Preface ix For More Information On This Product Go to www freescale com Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Conventions This document uses the following notational conventions Typeface Symbol or Term Meaning Examples IED BY FREESCALE SEMICONDUCTOR INC 2005 ARCHN Courier Code examples Process command for line flash Monospaced Type Italic Directory names and contains these core directories Project names applications contains applications software Calls Functions CodeWarrior project 3des mcp is Statements Procedures the pConfig argument Routines Arguments defined in the C header file aec h File names Applications Variables Directives Code snippets in text Bold Reference sources efer to the Targeting DSP5685x Platform Paths manual Emphasis See C Program FilesMotorola Embedded SDK help tutorials ALL CAPITAL defines define INCLUDE STACK CHECK LETTERS Defined constants Brackets Function keys by pressing function key F7 bol to signify a negative value Quotation Returned messages he message Test Passed is displayed marks if uns
19. EVM board 1 4 DSP5685x User s Manual xi DTMF xi 1 7 3 1 Dual Tone Multiple Frequency DTMF xi 1 7 3 1 E Embedded SDK Programmer s Guide xi F Frequency Response 1 3 Frequency Shift Keying FSK xi 1 3 1 6 FSK xi 1 3 1 6 G G 726 2 2 GR 1188 CORE LSSGR CLASS Feature Calling Name Delivery Generic Requirements xii GR 1401 CORE LSSGR CLASS Feature Visual Message Waiting Indicator Generic Requirements xii GR 30 CORE 1 2 GR 30 CORE LSSGR Voiceband Data Transmission Interface xii Index For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 GR 31 CORE LSSGR CLASS Feature Calling Number Delivery xii GR 416 CORE CLASS Feature Call Waiting Deluxe xii GR 575 CORE LSSGR CLASS Feature Calling Identity Delivery on Call Waiting xii IDE xi Integrated Development Environment IDE xi ITU T Recommendation V 23 xii 1 3 L LEC xi 1 8 Line Echo Canceller LEC xi 1 8 linker cmd 2 3 5 2 Low Pass Filter LPF xi LPF xi MDME xi 1 2 Memory and MIPS Requirements 1 8 Million Instructions Per Second MIPS xi MIPS xi Multiple Data Message Format MDMF xi 1 2 O off hook Caller ID 1 2 OnCE xi On Chip Emulation OnCE xi on hook Caller ID 1 2 Open Switching Intervals OSI 1 3 OSI 1 3 P PC xi PCM xi Personal Computer PC xi PSTN xi 1 2 1 7
20. Freescale Semiconductor Inc Q MOTOROLA Embedded SDK Software Development Kit Type 1 and 2 Telephony Features Library DK140 D Rev 1 07 23 2002 t Ti MOTOROLA Teli Motorola Inc 2002 All rights reserved intelligence everywhere digital dna For More Information On This Product o to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Contents About This Document it Ma P rrr ix DEA a e E E ide d OR oo e OE I0 E e EO GC e ix Suggested Bandi iis4hadax ts bbsRARAd botepi roor ETA EDs A Reha EA ix a o 6 45 5685 49s EE A E E E E E es 6685 X Definitions Acronyms and Abbreviations 2 4424 0620dseieaseracivnaeenss X o 0 PO c rrr xi Chapter 1 Introduction NEST 05 TOTP rPR OEN 1 1 LIS Telephony Features Librai Lec hd LER RIEN VOR COEUR HOC RR SECURE es 1 1 1 3 Overview of the Type 1 and 2 Telephony Features Library 1 2 1 3 1 Overview of Type 1 Funcom seio uud Dakine tope area Rar EKE 1 2 1 3 1 1 Background of the Type Functionality 2 644 ieccecacsceweoees nn 1 3 132 Overview oi Type 2 Pinay ouod Go y bEX Xe REPE A3 Ped 1 6 1 3 2 1 Background of the Type 2 Functionali
21. HIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 2 Directory Structure Note DSP568xx refers to the specific device for which you re developing as shown in Chapter 1 Introduction 2 1 Required Core Directories Figure 2 1 details required platform directories E sre EH dsp568xxevm pa __ nos __ applications J bsp __ config include H sys Eg tools Figure 2 1 Core Directories As shown in Figure 2 1 DSP56858EVM has no operating system support nos and includes the follow ing core directories applications contains applications software that can be exercised on this platform e bsp contains board support package specific for this platform config contains default hardware and software configurations for this platform include contains SDK header files which define the Application Programming Interface e Sys contains required system components tools contains utilities used by system components There are also optional directories that include domain specific libraries MOTOROLA Directory Structure 2 1 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc l ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 2 2 Optional Domain Specific Directories Directory Structure Figure 2 2 shows the domain specific directory cidtype12
22. NC 2005 Type 1 and 2 Telephony Features Library For More Information On This Product Go to www freescale com MOTOROLA ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Index A ACK x 1 7 Acknowledgement signal ACK x 1 7 ADC xi 1 4 1 5 AGC xi American Standard Code for Information Interchange ASCII xi 3 1 Analog to Digital Converter ADC xi 1 4 1 5 API xi 5 1 appconfig c 2 3 appconfig h 2 3 Application Programming Interface API xi 5 1 ASCII xi 3 1 Attenuation Distortion 1 4 Automatic Gain Control AGC xi Bandpass Filter BPF xi BPF xi C CQxi Call Qualifier CQ xi 1 2 Call Waiting Deluxe 1 6 3 5 CWD xi Call Waiting Tone 1 7 Call Waiting with Call Disposition 1 6 Caller ID 1 2 CID xi Calling Identity Delivery on Call Waiting CIDCW xi 1 6 Calling Name Delivery 1 2 Calling Number Delivery 1 2 call terminating switching system 1 7 CAS xi 1 6 CAS Detector 1 8 Central Office CO xi 1 7 CID xi cid12 h 3 3 cid12 lib 2 3 4 1 6 2 MOTOROLA cid12test mcp 2 3 4 1 6 1 CIDCW xi 1 6 CO xi 1 7 CPE xi 1 2 CPE Alerting Signal CAS 1 6 CQ 1 2 Customer Premises Equipment CPE xi 1 2 Customer premises equipment Alerting Signal CAS xi CWD xi D DAA xi 1 3 Data Access Arrangement DAA xi 1 3 Digital Signal Processor DSP xi 1 1 DSP xi 1 1 DSP56800E Reference Manual xi DSP56858EVM 2 1 DSP56858
23. NDUCTOR INC 2005 Linking Applications with Freescale Remicqnductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Code Example 5 1 Example of a linker cmd File for Type 1 and 2 Telephony Features Library JE CK CkCkCk A kk kk ck kk k Ck kk Ck koc kk kk kk ko kk kk KKK KKK KKK KKK KKK Kk kk ko kc A A kc ko kc ke kc KKK KKK KKK Linker cmd file for DSP56858 External RAM using only external program and data memory P Ke A kk kk kk kk A kk koc k kk kk kk kk ko kk kk kk kk KKK KKK KKK Kk KKK K A KKK KKK KKK KKK KKK KKK EMORY pInterruptVector RWX ORIGIN 0x000000 LENGTH 0x00008C pIntRAl RWX ORIGIN 0x00008C LENGTH 0x009F74 PEXtRAI RWX ORIGIN 0x00A000 LENGTH Ox1E6000 pIntRO RX ORIGIN Ox1F0000 LENGTH 0x000400 XIntRAl RW ORIGIN 0x000000 LENGTH 0x005000 XIntRAM DynamicMem RW ORIGIN 0x005000 LENGTH 0x001000 Stack RW ORIGIN 0x006000 LENGTH 0x000800 XEXxtRAM DynamicMem RW ORIGIN 0x006800 LENGTH 0x001000 XEXCRAI RW ORIGIN 0x000000 LENGTH 0x005000 xPeripherals RW ORIGIN 0x1FFC00 LENGTH 0x000400 XExtRAM2 RW ORIGIN 0x200000 LENGTH OxDFFFO00 xCoreRegisters RW ORIGIN OxFFFF00 LENGTH 0x000100 fA A Re A AA eA A A A A A A A AA A A A A A A A A I I KA A IA I IK FORCE_ACTIVE FconfigInterruptVector JE ke A A A A A eA A A A A A A A A A A
24. Public Switched Telephone Network PSTN xi 1 2 1 7 Pulse Code Modulation PCM xi ji Type 1 and 2 Telephony Features Library S SAS 1 6 1 7 SDK xi 1 1 SDMF xi 1 2 Sensitivity 1 6 Single Data Message Format SDMF xi 1 2 Software Development Kit SDK xi 1 1 Source SRC xi SR 3004 Testing Guidelines for Analog Type 1 2 and 3 CPE xi SRC xi Subscriber Alerting Signal SAS 1 6 1 7 T Targeting Motorola DSP5685x Platform xi Telcordia SR 3004 1 2 3 1 teldefs h 3 1 4 1 6 2 Twist 1 3 1 6 Type 1 and 2 Telephony Features Library 1 1 1 6 Type 1 and 2 Test Project 4 1 Type 1 services 1 2 Type 12 Module 1 6 Type 2 CPE 1 6 Type 2 services 1 2 Type12CID 5 1 6 2 Type12CID Module 1 6 Type12CID lib 3 1 Type12CIDcreate 5 1 Type12CIDdestroy 5 1 Type12CIDinit 5 1 V Visual Message Waiting Indicator VMWI xi 1 2 3 1 VMWI xi 1 2 3 1 Voiceband Data Transmission Interface 1 2 MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Motorola reserves the right to make changes without further notice to any products herein Motorola makes no warranty representat
25. Type 1 Telephony Features Library which is described in Section 1 3 1 However in the off hook state when Type 2 CPE provides CIDCW functional ity an extension in use check is performed to determine if there are any parallel extensions off hook before acknowledging back to the CO with a DTMF D signal To support off hook FSK data reception the Triple Data Encryption Standard 3DES Library requires an indication from the Line Interface to indicate the on hook or off hook state of any extensions in parallel with the Type 2 CPE The following text describes additional functions needed for Type 2 CPE supporting off hook Caller ID MOTOROLA Introduction 1 7 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Supporting off hook Caller ID requires a CAS detector and Line Echo Canceller LEC The LEC cancels the side tone to the line input so that CPE can receive a clear CAS signal and accurately detect the FSK data For details see the Generic Echo Canceller Library which contains a description of the LEC Introduction When the Type 1 and 2 Telephony Features Library is running in the off hook state every sample must be tested for detection of the CAS The process of CAS detection includes frequency filtering power estima tion and threshold detection The CAS is the combination of two frequencies 2130Hz
26. ZEOF xStack 1 F Xdata start addr in RAM Define variables for SDK mem library Data X Memory Layout _EX_BIT 0 Internal Memory Partitions for mem h partitions NUM IM PARTITIONS 0 IM ADDR 1 no IM ADDR 2 f External Memory Partition for mem h partitions NUM EM PARTITIONS 1 EM ADDR 1 FmemEXbit WRITEH EX BIT FmemNumIMpartitions WRITEH NUM IM PARTITIONS FmemNumEMpartitions e b H WRITEH NUM EM PARTITIONS FmemIMpartitionList MOTOROLA Linking Applications with the Type 1 and 2 Telephony Features Library 5 3 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Linking Applications with Freescale Pemicqnductor Inc po ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 WRITEH ADDR xIntRAM DynamicMem 1 WRITEH SIZEOF xIntRAM_DynamicMem 1 FmemEMpartitionList WRITEH ADDR xExtRAM_DynamicMem 1 WRITEH SIZEOF xExtRAM_DynamicMem 1 Add rest of the data into External RAM const data data fp_state data rtlib data F_Xdata_ROMtoRAM_length 0 F_Xbss_start_addr X BSS ADDR rtlib bss lo rtlib bss bss F Xbss length X BSS ADDR Copy DATA EXtRAM Ee A A A A kK kK A KKK KKK K kk kk kkk kkk kk
27. ample pSample Local variables for Type 1 and 2 Telephony Features size of 127 Structure sData details are defined in header file cid typel2 h which also contains various space allocators and housekeeping variables However since these variables are not manipulated by the application the contents of cid typel2 h are not documented in this SDK endif 3 2 1 Variable Definition This section includes a more detailed explanation of the variables in structure teldefs_tsControl that an application using the Type 1 and 2 Telephony Features Library must set Also included in teldefs h are the data structures for the Type 1 and 2 Telephony Parser Library needed to help display the received FSK message For additional information see the document Type 1 and 2 Telephony Parser Library hookSwitch Set by the application to indicate to the Type 1 and Type 1 and 2 Libraries whether the phone is on hook or off hook On hook 0 Off hook 1 handsFreeLayer1 Set by the application to indicate to the Type 1 and Type 1 and 2 Libraries whether the handset or handsfree is enabled intpdata Set and allocated by Typel2create to identify the address of the modulo buffer for FSK cidRingPolarity Set by the application to indicate to the Type 1 and Type 1 and 2 Libraries when a ringing signal is detected on the ringing detect circuit The ringing detect circuit should be capable of detecting either the envelope of the ringing signal itse
28. and 2 Telephony Features Library To use the Type 1 and 2 Telephony Features Library APIs must be called in the following order Type12CIDcreate The user must call this function once for every instance Type12CIDdestroy The user must call this function to deallocate memory ypel2CIDinit The user must call this function for hook switch change Typel2CID The user must call this function to display Caller ID in on hook and off hook states 5 1 1 Library Sections An example of the memory section for the Type 1 and 2 Telephony Features Library is shown in this section The data memory requirement for the Type 1 and 2 Telephony Features Library is 127 words The size of the program space requires 1 2K words All program and data memory may reside in internal or external memory A dynamic memory section of at least 127 words plus 16 words aligned on a 16 word boundary is required All program memory for this library resides in section cid 2 text of the code An example inker cmd file is shown in Code Example 5 1 The program and data memory for the Type 1 and 2 Telephony Features Library are in the FSK section of the code This text and data section contains all the code and data necessary to execute the Type12CID function MOTOROLA Linking Applications with the Type 1 and 2 Telephony Features Library 5 1 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICO
29. conductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 3 3 2 Typet12CIDdestroy Call s Specifications int Typel2CIDdestroy cid sData pData teldef tsControl pControl Required Headers teldefs h cid 12 h Arguments Table 3 2 Type12CiDdestroy Arguments pData in Points to the structure where FSK static data is stored pControl in Points to the structure where input and output control information is stored Description This function deallocates any memory that was used by the current Type12CID instance The prototype of the Type 2CIDdestroy function is defined in cid 2 h Returns None Special Issues None Code Example None MOTOROLA Type 1 and 2 Telephony Features Library Interfaces 3 9 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Type 1 and 2 Telephony F Ereescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 3 3 3 Typet2ClDinit Call s void Typel2CIDinit cid sData pData teldef tsControl pControl Required Headers teldefs h cid 12 h Arguments Table 3 3 Type12CiIDinit Arguments pData inout Points to the structure where FSK static data is stored pControl inout Points to the structure where input and output control information is stored Description The Type 2ClIDinit function initializes all of the constants variables and counters contained in the cid sData str
30. de Example 3 1 teldefs h Reference Definition for Type12CID difndef TELDEFS H define TELDEFS H Lr typedef struct teldefs tsControl phone state int hookSwitch on hook or off hook int handsFreeLlayerl speaker phone on or off Caller ID int intpdata pointer for modular buffer int cidRingPolarity ring signal high or low int cidByteReady flag for a byte when ready int cidByte contents of the byte int messageDone flag for a message when ready int messageLength length of the message int ExtUseCheck set by the library for an ext in use check int NoExtFound set by the application for an ext in use check int FrameErrors indicates if frame error occurred during fsk int flashCommand indicates line should be flashed int flashPolarity indicates the direction of flashing int cwdCommand begin a Call Waiting deluxe pulse dial int disableRinger disable ring generator DTMF dialer int dtmfRequest to dial a dtmf ON 1 OFF 0 int dtmfDigit the dtmf digit to be dialed int dtmfComplete flag for a dtmf when dialing complete Generic Echo Canceller Generic Echo Canceller related variables are declared her Full Duplex Speakerphon Full Duplex Speakerphone related variables are declared her teldefs_sControl typedef struct teldef
31. e 1 and 2 Telephony Features Library e Type 1 and 2 Telephony Parser Library e Full Duplex Speakerphone Library MOTOROLA Introduction 1 1 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 e Generic Echo Canceller Library e Feature Phone Application Software Introduction These modules are designed to interoperate providing all software necessary to implement a feature phone with full duplex speakerphone and Type 1 and 2 Caller ID functionality By using some or all of these modules several other types of telephony applications are also possible Each module may also be used independently 1 3 Overview of the Type 1 and 2 Telephony Features Library The Type 1 and 2 Telephony Features Library can handle both on hook Caller ID and related information reception services known as Type 1 services and off hook Caller ID and related services known as Type 2 services The following sections provide an overview first of the Type 1 functionality of the Type 1 and 2 Telephony Features Library then of its Type 2 functionality 1 3 1 Overview of Type 1 Functionality Customer Premises Equipment CPE using the Type 1 and 2 Telephony Features Library has the features to support existing on hook Caller ID services such as Calling Number Delivery and Calling Name Deliv ery other existing on hook services
32. e of LSSGR FR 64 Telcordia Technologies December 1998 GR 31 CORE LSSGR CLASS Feature Calling Number Delivery FSD 01 02 1051 a module of LSSGR FR 64 Telcordia Technologies June 2000 GR 1188 CORE LSSGR CLASS Feature Calling Name Delivery Generic Requirements FSD 01 02 1070 a module of LSSGR FR 64 Telcordia Technologies December 2000 GR 1401 CORE LSSGR CLASS Feature Visual Message Waiting Indicator Generic Requirements FSD 01 02 2000 a module of LSSGR FR 64 Telcordia Technologies June 2000 GR 575 CORE LSSGR CLASS Feature Calling Identity Delivery on Call Waiting FSD 01 02 109 a module of LSSGR FR 64 Telcordia Technologies June 2000 GR 416 CORE CLASS Feature Call Waiting Deluxe FSD 01 02 1215 a module of LSSGR FR 64 Telcordia Technologies December 1999 ITU T Recommendation V 23 11 88 600 1200 baud modem standardized for use in the general switched telephone network Type 1 and 2 Telephony Features Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 1 Introduction Welcome to Motorola s family of Digital Signal Processors or DSPs This document describes the Type 1 and 2 Telephony Features Library which is a part of Motorola s comprehensive Software Development Kit SDK for its DSPs In this document you will f
33. ed to the DSP56858EVM using a stereo jack Details of required jumper settings are contained in the DSP56858 Evaluation Module User s Manual The rest of this section describes the system level operation of a generic FSK receiver the major compo nent of this Library Figure 1 1 provides a high level example of a generic FSK receiver used in the Type 1 and 2 Telephony Features Library The FSK receiver is shown inside the dashed lines in Figure 1 1 The components shown outside the dashed lines are not supplied with the Type 1 and 2 Telephony Features Library 1 4 Type 1 and 2 Telephony Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor MOGs phony Features Library ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Tip Ring BPF Y AGC Functional y Blocks of a Generic FSK Receiver Demodulator Y LPF Y Slicer Y Decision Maker Y Framing Y Parser Y Screen Hour Minute Month Day Number Name Figure 1 1 The Functional Blocks of a Generic Type 1 and 2 Telephony Solution The FSK receiver performs noise filtering signal detection demodulation and framing then passes Caller ID or VMWI etc to the application layer to display on the CPE The FSK receiver is always enabled so it
34. ephony Equipment CQ Call Qualifier CWD Call Waiting Deluxe DAA Data Access Arrangement DSP Digital Signal Processor or Digital Signal Processing DTMF Dual Tone Multiple Frequency signal FSK Frequency Shift Keying modulation IDE Integrated Development Environment LEC Line Echo Canceller LPF Low Pass Filter MDMF Multiple Data Message Format of GR 30 CORE MIPS Million Instructions Per Second OnCE On Chip Emulation PC Personal Computer PCM Pulse Code Modulation PSTN Public Switched Telephone Network SDK Software Development Kit SDMF Single Data Message Format of GR 30 CORE SRC Source VMWI Visual Message Waiting Indicator References The following sources were referenced to produce this book Motorola DSP56800E Reference Manual DSP56800ERM D Motorola DSP568xx User s Manual for the DSP device you re implementing Targeting Motorola DSP568xx Platform for the DSP device you re implementing Motorola Embedded SDK Programmer s Guide SDKI01 D SR 3004 Testing Guidelines for Analog Type 1 2 and 3 CPE as Described in SR INS 002726 a module of ADSI FR 12 Telcordia Technologies January 1995 M ops qae MOTOROLA Preface xi For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Xii 10 11 12 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 GR 30 CORE LSSGR Voiceband Data Transmission Interface Section 6 6 a modul
35. etector are taken from the leccid sample buffer When using gec lib this buffer will be filled automatically with echo cancelled line samples If no echo canceller is used copy the five samples from the line buffer into the leccid buffer prior to calling Type12CILDX The Type 1 and 2 Telephony Features Library supports all necessary timing and logic needed for the application to easily check if an extension phone is off hook following reception of a CAS tone as specified in SR 3004 Upon reception of a CAS tone if an extension phone is found to be off hook the Type 1 and 2 Telephony Features Library will not send back a DTMF acknowledgement therefore no FSK Caller ID signal will be sent By simply monitoring ExtUseCheck the application will know when to go on hook when to monitor line voltage to determine if an extension is found and set NoExtFound accordingly and when to go back off hook For more information regarding monitoring line voltage to determine if an extension is off hook see SR 3004 When taking the phone on hook or off hook as a result of a ExtUseCheck command the application should not change the Line Control hookSwitch variable or call Typel2CIDinit MOTOROLA Type 1 and 2 Telephony Features Library Applications 6 5 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Type 1 and 2 Telephony rareesgale SRI Mo nductor Inc ARCHIVED BY FREESCALE SEMICONDU
36. ge format per Telcordia SR 3004 In the on hook state the actual FSK message is received between the first and second ring If an FSK message is not detected during this period no information will be available until the next call Other services such as VMWI may not involve power ringing at all In the off hook state the Type 1 and 2 Telephony Features Library detects CAS tones and generates the DTMF D acknowledgement signal to the PSTN switching system for Caller ID delivery FSK data received in the off hook state uses the multiple data message format MDMBP as described in Telcordia SR 3004 and other references describing CIDCW and CWD 3 2 Interface The Type 1 and 2 Telephony Features Library can be called by an application program in C Code Example 3 1 contains structure definitions of teldef_sControl and teldef_sSamples which are used by the Type 1 and 2 Telephony Features Library to receive information from the application and then to output results to the application A listing of the variables in teldefs h that are related to the Type 1 and 2 Telephony Features Library only is included other variables are described in their respective library documents MOTOROLA Type 1 and 2 Telephony Features Library Interfaces 3 1 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Type 1 and 2 Telephony FEreeecale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Co
37. his codec 1s connected to an audio interface When the ISR has received transmitted five samples the buffers are full empty and the SamplesReady flag is set indicating to the application that it should call CalleridAppMain The calling rate of this routine should be 1600 calls second In the beginning of the CalleridAppMain routine the codec samples are copied into the module s sample structure Note that for the output samples the line samples are copied into the right audio codec channel and the audio samples are copied into the left line codec channel This sample criss cross is indicative of the natural signal flow for a telephone 6 6 Type 1 and 2 Telephony Features Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 7 License 7 1 Limited Use License Agreement This software is available under a separate license agreement from Motorola Incorporated Licensing information can be obtained from your Motorola sales representative or authorized distributor For additional product information see http www motorola com semiconductors MOTOROLA License For More Information On This Product Go to www freescale com 7 1 ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 License 7 2 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR I
38. hone While the module is in an on hook state Linel Control hookSwitch 0 the line samples buffer will be filled with ring generator samples during power ringing Otherwise the ine samples will be filled with zeros These samples may act as an output to an audio channel for example to be played to a speaker While the module is in an off hook state Linel Control hookSwitch 1 the audio samples buffer will be overwritten with DTMF samples when a DTMF digit is requested for dialing or to acknowledge the reception of a CAS tone and will remain unchanged otherwise The ine samples remain unchanged during the off hook state unless Line Control handsFreeLayerl is set a condition which is not shown in this example In this case the gec samples will be copied to the ine samples structure In addition during off hook FSK reception both the ine and audio samples will be muted set equal to zero regardless of the value of Line Control handsFreeLayer1 This is required since no signal should be transmitted by the CPE onto the telephone line or played on the speaker during data reception as specified by the CIDCW standard The gec samples can be obtained by using the gec lib module or by using a separate custom echo canceller The audio samples will be modified by the fdspk lib module or custom full duplex speakerphone software in this case The input samples to the Type 1 and 2 Telephony Features Library CAS d
39. ind all the information required to use and maintain the Type 1 and 2 Telephony Features Library interface and algorithms Motorola provides these algorithms to you under license for use with Motorola DSPs to expedite your application development and reduce the time it takes to bring your own products to market Motorola s Type 1 and 2 Telephony Features Library is a licensed software library for use on Motorola DSP56800E series processors Please refer to the Software License Agreement in Chapter 7 for license terms and conditions 1 1 Quick Start Motorola s Embedded SDK is targeted to a large variety of hardware platforms To take full advantage of a particular hardware platform use Quick Start from the Targeting Motorola DSP5685x Platform doc umentation For example the Targeting Motorola DSP5685x Platform manual provides more specific information and examples about this hardware architecture If you are developing an application for the DSP56858EVM board or any other DSP56858 development system refer to the Targeting Motorola DSP5685x Platform manual for Quick Start or other DSP56858 specific information Note DSP568xx refers to the specific device for which you re developing as shown in the preceding example 1 2 Telephony Features Libraries The Type 1 and 2 Telephony Features Library is one of a set of Motorola Embedded SDK modules and applications consisting of the following e Type 1 Telephony Features Library e Typ
40. ion or guarantee regarding the suitability of its products for any particular purpose nor does Motorola assume any liability arising out of the application or use of any product or circuit and specifically disclaims any and all liability including without limitation consequential or incidental damages Typical parameters which may be provided in Motorola data sheets and or specifications can and do vary in different applications and actual performance may vary over time All operating parameters including Typicals must be validated for each customer application by customer s technical experts Motorola does not convey any license under its patent rights nor the rights of others Motorola products are not designed intended or authorized for use as components in systems intended for surgical implant into the body or other applications intended to support or sustain life or for any other application in which the failure of the Motorola product could create a situation where personal injury or death may occur Should Buyer purchase or use Motorola products for any such unintended or unauthorized application Buyer shall indemnify and hold Motorola and its officers employees subsidiaries affiliates and distributors harmless against all claims costs damages and expenses and reasonable attorney fees arising out of directly or indirectly any claim of personal injury or death associated with such unintended or unauthorized use even if such claim alleges
41. is also an output from the function Typically inout parameters are input pointer variables in which the caller passes the address of a pre allocated data structure to a function The function stores its results within that data structure The actual value of the inout pointer parameter is not changed MOTOROLA Type 1 and 2 Telephony Features Library Interfaces 3 7 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Type 1 and 2 Telephony FEreescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 3 3 1 Typet2ClIDcreate Call s cid sData Typel2CIDcreate teldef tsControl pControl Required Headers teldefs h cid 12 h Arguments Table 3 1 Type12CiDcreate Arguments pControl in Points to the structure where input and output control information is stored Description The Type 2CIDcreate function allocates the data memory structure and modulo buffer for the Type12CID function then calls the Type12CIDinit function This function is to be called once before using the Type 2CID function The prototype of this function is defined in cid 2 h Returns The functionType12CIDcreate returns a pointer to the data structure Special Issues None Code Example None 3 8 Type 1 and 2 Telephony Features Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semi
42. k ke kkk kkk kkk kkk kkk kk kkk K FArchIO 0x0000 FArchCore ADDR xCoreRegisters FArchInterrupts ADDR pInterruptVector Type 1 and 2 Telephony Features Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 6 Type 1 and 2 Telephony Features Library Applications 6 1 Type 2 Verification Test To verify the functionality of the Type 1 and 2 Telephony Features Library an individual test application is provided The test processes the samples that are precaptured from a nominal FSK transmission The corresponding Caller ID will be printed on screen The test application is located in the telephony cidtype12 Test directory The name of the test project is cid12test mcp 6 1 1 Test Set up and Procedure The test application runs in the simulator mode and does not require external equipment Before executing the test application select Simulator as the Target Setting Protocol It can be set in the Protocol option of the M56800 Target Settings The test project for Type 2 is cid 2test mcp Before loading the executable project the project must be compiled with no errors This is done by choosing the Make option in the Project menu or by pressing F7 To load the executable project choose the Debug option in the Project menu or pres
43. lf or of a square wave whose fundamental frequency is the ring frequency For purposes of ringing detection the envelope of a signal is either the amplitude of a signal or some more slowly varying amplitude detected by less sensitive circuitry cidByteReady Set by the Type 1 and Type 1 and 2 Libraries to indicate to the application or to the Type 1 and 2 Telephony Parser Library that one byte is ready from the FSK receiver cidByte Set by the Type 1 and Type 1 and 2 Libraries it holds the actual byte messageDone Set by the Type 1 and Type 1 and 2 Libraries to indicate to the application or Type 1 and 2 Telephony Parser Library that an FSK message is completed 3 4 Type 1 and 2 Telephony Features Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 messageLength int ExtUseCheck int NoExtFound FrameErrors flashCommand flashPolarity cwdCommand disableRinger dtmfRequest MOTOROLA Freescale Semiconductor Inc interiace ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Set by the Type 1 and Type 1 and 2 Libraries to indicate the length of the FSK message to the application Set by the library to indicate to the application to do the following ExtUseCheck 0 Do nothing ExtUseCheck 1 Go on hook but do not change the Control hookswitch variable ExtUseCheck 2 The application should test whether an extension phone is off hook and se
44. low pass filter LPF is used to remove the double frequency component and pass signals within the sample frequency range The outputs of the demodulator are sent to the Slicer where timing recovery is performed and a decision for a symbol is made The symbols are then framed to form an ASCII word The ASCII words are passed to upper layer functionality external to the Type 1 and 2 Telephony Features Library for parsing and display ing Caller ID information or for activating deactivating the VMWI The user must supply a parser algorithm external to this Type 1 and 2 Telephony Features Library to decode the message layer ASCII words according to the appropriate service dependent GR 30 CORE for mat either SDMF or MDMF in a manner compliant with the message layer requirements of SR 3004 See References for the format applicable to each service that uses the GR 30 CORE protocol supported by the Type 1 and 2 Telephony Features Library The Parser Library supplied with the Embedded SDK is the preferred method for interoperating with the Type 1 and 2 Telephony Features Library to achieve both transmission layer and message layer SR 3004 compliance 1 3 2 Overview of Type 2 Functionality Type 2 CPE has all the features of Type 1 plus the feature of supporting off hook Caller ID In other words Type 2 CPE can also process Caller ID during a call Unlike Type 1 Type 2 CPE can receive mul tiple Caller IDs one at a time during a call Type 2 CPE therefo
45. mand 9 forward cwdCommand 10 answer or standard flash Set by the application to disable the ring generator when on hook Set by the application when it requires the module to dial a DTMF digit On 1 Off 0 Type 1 and 2 Telephony Features Library Interfaces 3 5 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Type 1 and 2 Telephony FEreescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 dtmfDigit The particular digit to be dialed possible entries range from integer values of 0 to 11 which correspond to the nine digits and in that order dtmfComplete Flag set by the module for the application s information on completion of a single DTMF request 3 6 Type 1 and 2 Telephony Features Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 3 3 Specifications Specifications The following sections describe the Type 1 and 2 Telephony Features Library functions Function arguments for each routine are described as in out or inout An in argument means that the parameter value is an input only to the function An out argument means that the parameter value is an output only from the functions An inout argument means that a parameter value is an input to the function but the same parameter
46. mples are inputs to this function and are decoded into data bytes when Caller ID is present e pSample line samples are outputs from this function and are ringer generator samples when ringing is present otherwise these samples are filled with zeros e pSample audio samples are ignored and filled with zeros hookSwitch 1 off hook If handsFreeLayerl is set pSample gec are copied into pSample line samples otherwise pSample line samples are unchanged During FSK reception pSample line samples are always muted set equal to zero regardless of the value of handsFreeLayerl e The input samples to the Type 1 and 2 Telephony Features Library CAS detector are taken from pSample leccid buffer When using the Generic Echo Canceller Library the pSample leccid buffer will be filled automatically If no echo canceller is used copy the five pSample line samples into pSample leccid before calling this function The pSample leccid samples are unchanged by this function e IfaDTMF digit has been requested by setting dtmfRequest in the application or if the library needs to transmit an acknowledge signal upon reception of a CAS tone pSample audio is filled with DTMF samples Otherwise pSample audio samples are unchanged Returns None Special Issues None Code Example None MOTOROLA Type 1 and 2 Telephony Features Library Interfaces 3 11 For More Information On This Product Go to www freescale com ARCHIVE
47. o acknowledgement signal ACK will be returned to the CO and the FSK data will not be delivered If no parallel handsets are in use the Type 2 CPE will mute the CPE handset and send an ACK consisting of a DTMF D to the CO Muting the handset prevents noise or side tones from interfering with the receipt of FSK data and prevents the user from hearing the FSK transmission Upon receiving the DTMF D tone the CO sends the FSK data to the CPE and reconnects the far end upon conclusion After receiving the FSK data the CPE unmutes the handset Figure 1 2 shows the sequence of handshakes between the CO and the Type 2 CPE Type 2 CPE in CO off hook CO sends CAS to CPE for Caller ID delivery CAS Check parallel handset if not in use mute handset and send ACK back ACK Upon received ACK Caller ID signal CO sends Lae Caller ID After the complet Caller ID is received the handset is unmuted Figure 1 2 Sequence for Delivery of FSK Data During a Call Using Type 2 CPE The main difference between the Type 1 and 2 Telephony Features Library and the separate Type 1 Tele phony Features Library is that the Type 1 and 2 Telephony Features Library supports both on and off hook FSK data reception while the Type 1 Telephony Features Library supports only on hook FSK data recep tion The processing and requirements of the Type 1 and 2 Telephony Features Library to support Type 1 on hook FSK data reception are the same as that of the
48. oduct Go to www freescale com MOTOROLA ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 About This Document This manual describes the Type 1 and 2 Telephony Features Library for use with Motorola s Embedded Software Development Kit SDK Audience This document targets software developers implementing communication features for analog telephone lines Organization This manual is arranged in the following sections Chapter 1 Introduction provides a brief overview of this document Chapter 2 Directory Structure provides a description of the required core directories Chapter 3 Type 1 and 2 Telephony Features Library Interfaces describes all of the Type 1 and 2 Telephony Features Library functions Chapter 4 Building the Type 1 and 2 Telephony Features Library tells how to build a test application project with the pre built Type 1 and 2 Telephony Features Library Chapter 5 Linking Applications with the Type 1 and 2 Telephony Features Library describes linking projects with the Type 1 and 2 Telephony Features Library Chapter 6 Type 1 and 2 Telephony Features Library Applications describes the use of the Type 1 and 2 Telephony Features Library through test demo applications Chapter 7 License provides the license required to use this product Suggested Reading We recommend that you have a copy of the following references Motorola
49. ram contains the linker cmd file for the test application and also contains appconfig c and appconfig h to override the SDK s config h for this particular project MOTOROLA Directory Structure 2 3 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Directory Structure 2 4 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Type 1 and 2 Telephony Library For More Information On This Product Go to www freescale com MOTOROLA I ARCHN ED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 3 Type 1 and 2 Telephony Features Library Interfaces The Type 1 and 2 Telephony Features Library is defined as Type12CID lib The service interface and function calls included are described in this chapter 3 1 Type 1 and 2 Telephony Features Library Interface Services The Type 1 and 2 Telephony Features Library interface provides Caller ID Visual Message Waiting Indicator VMWIL and other related services which occur in the on hook or off hook state The Type 1 and 2 Telephony Features Library supports FSK signals with a baud rate of 1200bps The library demodulates the FSK into ASCII words and passes the data payload to the application program for processing and presentation The FSK message can be in single or multiple data messa
50. re has the features to support existing off hook Caller ID services such as Calling Identity Delivery on Call Waiting CIDCW and Call Waiting Deluxe sometimes called Call Waiting with Call Disposition These services use the GR 30 CORE MDMF over FSK The Caller ID contents should include date time number and or the name of the caller The Type 2 performance of CPE that incorporate this Type 1 and 2 Telephony Features Library also called the Type12CID Module or just the Type 12 Module is compliant with the Type 1 transmission layer requirements of Telcordia SR 3004 mentioned in Section 1 3 1 and with the Type 2 transmission layer requirements of Telcordia SR 3004 including those for e Frequency Shift Keying FSK modulation sensitivity e Twist or level differences between FSK signal tones e FSK frequencies and variation from their nominal values In addition to complying with the FSK modulation frequencies of SR 3004 the Type 1 and 2 Telephony Features Library can also able detect FSK transmitted using the slightly different frequencies specified by the ITU T V 23 modem recommendation e Robust detection of incoming Caller ID or VMWI signals in the presence of significant noise impairments on the telephone line e All Subscriber Alerting Signal SAS CPE Alerting Signal CAS DTMF signal FSK signal and inter signal timings required in SR 3004 which will be described in more detail in the next section 1 3 2 1 Background of the Type
51. s F5 To run the test application use the mouse to click the green arrow button or manually press F5 on the keyboard After the application starts running the application initializes and automatically processes the precaptured samples The functionality of the Type 1 and 2 Telephony Features Library will be verified and a Caller ID message will be printed on the console window The application stops after completing the process and prints PASS on the console window Should the application print FAIL the Type 1 and 2 Telephony Features Library is not operating correctly This is not expected to happen for this test application however if it does please report the failure and test conditions to Motorola for resolution MOTOROLA Type 1 and 2 Telephony Features Library Applications 6 1 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Type 1 and 2 Telephony FErgeseale SRI Mo nductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 6 2 Example Application Using cid12 lib An example using the Type 1 and 2 Telephony Features Library to illustrate how to set the library variables for Type12CID in the Control structure of teldefs h is shown in Code Example 6 1 This code does not exist in the actual cidtype 2 directory in the SDK Code Example 6 1 Use of Type12CID Interface include lt stdio h gt include lt stdlib h gt include teldefs h include cid12 h
52. s_tsSamples line input or audio output int line 5 int audio 5 audio input or line output int gec 5 generic echo canceller s output int aec 5 fdspk s output int voipinput 5 third port s input int voipoutput 5 third port s output 3 2 Type 1 and 2 Telephony Features Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 int leccid 5 used by type 2 to receive line echo cancelled samples Interface teldefs sSamples endif The structure defined in cid 2 h cid_sData is allocated by the Type12CIDcreate function but is accessed only by the Type 1 and 2 Caller ID functions It is essential that memory be allocated for this structure for the Type 1 and 2 Caller ID functions to use and that no other function or the application itself access the memory space reserved for this structure The Type 1 and 2 Caller ID function stores values for reuse so tampering with the contents of the structure will cause the function to give erroneous results As shown in Code Example 3 2 and Code Example 6 1 the code must statically allocate both a teldef sControl and teldef_sSample structure for each instance of a Caller ID channel while using a call to Typel2CIDcreate to dynamically allocate the data structure The use of function prototypes and
53. t NoExtFound accordingly If an extension CPE is found to be off hook clear NoExtFound 0 otherwise set NoExtFound 1 ExtUseCheck 3 Go off hook but do not change the Control hookswitch variable Set by the application when ExtUseCheck 2 and indicates whether an extension phone is off hook this indication is used by the CID Module Set by the Type 1 and Type 1 and 2 Telephony Features Libraries to indicate to the application whether a framing error occurred during reception of the last FSK message this must be cleared by the application upon reception A message sent from the module to the application indicating that the line is to be flashed according to flash polarity this must be cleared by the application upon reception Line is to be flashed 1 Do nothing 0 Set by the module to indicate the polarity of the flash When flashCommand is set flashPolarity 0 go on hook flashPolarity 1 go off hook Note Do not change the hookSwitch variable when executing a flash Set by the application to instruct the module to begin a Call Waiting Deluxe pulse dial TheType 1 and 2 Telephony Features Library will automatically generate the necessary DTMF and pulse dial signals to support the desired command This feature is only supported in the off hook state cwdCommand 0 do nothing cwdCommand 3 conference cwdCommand 5 drop first cwdCommand 6 hold cwdCommand 7 drop cwdCommand 8 announcement cwdCom
54. ted with or without power ringing but must be received without power ringing The CPE is instructed by the data received in GR 30 CORE format to turn a light or other visual indicator on or off indicating that new messages have been received at a voice mail system or other messaging ser vice The performance of CPE incorporating the Type 1 and 2 Telephony Features Library will comply with the transmission layer performance requirements of Telcordia SR 3004 including those for 1 2 Type 1 and 2 Telephony Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semicanductor I9Gephony Features Library ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 e Frequency Shift Keying FSK modulation sensitivity e Twist or level differences between FSK signal tones e FSK frequencies and variation from their nominal values In addition to complying with the FSK modulation frequencies of SR 3004 the Type 1 and 2 Telephony Features Library can also detect FSK transmitted using the slightly different frequencies specified by the ITU T V 23 modem recommendation However the Type 1 and 2 Telephony Features Library cannot be used directly in equipment for international telephone networks with V 23 since the timing protocols are likely different e Robust detection of incoming FSK signals in the presence of significant noise impairments on the telephone line e All signal and in
55. ter signal timings required in SR 3004 with or without power ringing e The ability to receive FSK after detecting power ringing signals which have any of the various cadences required by SR 3004 in addition to the Normal ringing pattern 1 3 1 1 Background of the Type 1 Functionality The on hook Type 1 Library is basically a Frequency Shift Keying FSK receiver with the following addi tional abilities e to detect power ringing e to recognize and remain immune to various other voltage level shifts identified in SR 3004 that may precede FSK data with or without power ringing e to recognize the start of FSK data reception following various other voltage level shifts identified in SR 3004 and power ringing following only various other voltage level shifts identified in SR 3004 power ringing does not precede FSK data if not preceded by any of the various other voltage level shifts identified in SR 3004 Thus required inputs to this Library are Indication of power ringing Usually present before reception of Caller ID in FSK data Usually absent before reception of VMWI in FSK data Used by the Library to disable the FSK receiver during power ringing e Indication of Open Switching Intervals OSIs or other voltage level shifts that may precede the FSK data e The FSK data in the GR 30 CORE format appropriate for Calling Number Delivery Calling Name Delivery VMWI or other existing or future telephony service
56. ty 00 4 1 6 13 5 Feabiesond FeO sirroriiocrtrad RP ra onn R era ER ERE 4 dd 1 8 Chapter 2 Directory Structure Ll Weed Cor Drede cus Luededanesubd Q adu ss seb d ed d oec opa d cec 2 1 22 Optional Domain Specific Directories s 24si44 seen hen eased ee davaecea 2 2 Chapter 3 Type 1 and 2 Telephony Features Library Interfaces 3 Type 1 and 2 Telephony Features Library Interface Services 3 1 2a 0o 0 PEUT 3 1 A41 WVadsbis De i6o2issekeyeoGs shes e EESREYeqEPrE RITE ENSE ETE 3 4 2o DOOR iade ober eee bee eh Olea pd PE dud e Ra d dde d 3 7 XS Tuypell IDOEIBEIB cc ct cede chee rp IE ERERA ESEREERTAAP Rr RTRAszER AR PAS 3 8 AO eg se ib da bo HOO PG ERR ER UH HI ER doa 3 9 LX x E y wlr os See 5 oh oe c PTT 3 10 XT CUL jUo r c rrr 3 11 Chapter 4 Building the Type 1 and 2 Telephony Features Library 4 Building the Type 1 and 2 Telephony Features Library 4 1 MOTOROLA Table of Contents For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 5 Linking Applications with the Type 1 and 2 Telephony Features Library 5 1 Type 1 and 2 Telephony Features Library 22 25 06cce0 00e2ieuseoee m tees 5 1 SL EA ee I sh SUE CREW Eq ed d d ac Ode dude and aci bcn dup bcr 5 1 Chapter 6 Type 1 and 2 Telephony Features Library Applications Dl T
57. uccessful for any reason it will return NULL Blue Text Linkable on line refer to Chapter 7 License Number Any number is considered 3V a positive value unless 10 preceded by a minus sym pgs Definitions Acronyms and Abbreviations The following list defines the acronyms and abbreviations used in this document As this template develops this list will be generated from the document As we develop more group resources these acronyms will be easily defined from a common acronym dictionary Please note that while the acronyms are in solid caps terms in the definition should be initial capped ONLY IF they are trademarked names or proper nouns ACK Acknowledgement signal Type 1 and 2 Telephony Features Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 ADC Analog to Digital Converter AGC Automatic Gain Control API Application Programming Interface ASCII American Standard Code for Information Interchange BPF Bandpass Filter CAS Customer premises equipment Alerting Signal CID Caller ID Calling Party Name and or Number Identification CIDCW Calling Identity Delivery on Call Waiting CO Central Office CO often refers to the PSTN switching system less often refers to other equipment at the central Office location CPE Customer Premises tel
58. ucture for the Type 2CID function This function is to be called once before using the function Type 2CID This action is performed by calling Type 2CIDcreate function The function Typel2CIDcreate should also be called when going on hook or off hook after changing the hookSwitch variable The prototype of this function is defined in cid 2 h Returns None Special Issues None Code Example None 3 10 Type 1 and 2 Telephony Features Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 3 3 4 Type12CID Call s Specifications void Typel2CID cid sData pData teldef tsControl pControl teldef tsSample pSample Required Headers teldefs h cid 12 h Arguments Table 3 4 Type12CID Arguments pData inout Points to the structure where FSK static data is stored pControl inout Points to the structure where input and output control information is stored pSample inout Points to the structure where the voice samples are stored Description The 7ype 2CID function performs on hook and off hook FSK reception According to the control information from its arguments it enables the FSK receiver and passes the FSK to the upper layer process to display the data This function should be called 1600 times per second hookSwitch 0 on hook e pSample line sa
59. yped VenDEanoa Tollaseosaszenasksddstsqbbsexhtesededsuaqude aequ 6 1 AGLI Ted Sera ai FIO Lat ddp 3ac toes XO E et dee e UR REC dl 6 1 6 2 Example Application Using eig M os sayeth eevee nt ae orient Peewee bags 6 2 Chapter 7 License Tl Lamited Use License Agreement 54 6246250 che4s n Edu RRAR ERE REPARARE 7 1 ii Type 1 and 2 Telephony Features Library MOTOROLA For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 List of Tables 1 1 Type 1 and 2 Telephony Features Library Memory and MIPS Requirements LINE JE Dire Ue oo RENE O 2 Tune DN Ly FU Co 4 ipu WI HKU sred IH OUR ANE SHOE GRIP Ie CR OPAC CER 23 Type ZC IDinit AGPWIBODIS Lia snasknadebaer d Rh RR EREAREAR E RITARA RE ERA Qu DEIADAR a soe ike beset bird dioe d qoaa pP rend ebd bir sce oie MOTOROLA List of Tables For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Type 1 and 2 Telephony Features Library For More Information On This Product Go to www freescale com MOTOROLA ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 List of Figures 1 1 The Functional Blocks of a Generic Type 1 and 2

Embedded SDK (Software Development Kit)

Contents

Download Pdf Manuals

Related Search

Related Contents