Reference Driver

UG_1x66B_015 73M1866B/73M1966B Reference Driver User Guide
Rev. 2.7 3
Table of Contents
1
Introduction ................................................................................................................................... 7
1.1 Purpose and Scope ................................................................................................................. 7
1.2 Conventions Used in this Guide ............................................................................................... 8
1.3 Acronyms................................................................................................................................. 8
2 Overview ........................................................................................................................................ 9
2.1 Driver Architecture ................................................................................................................... 9
2.2 Functional Overview .............................................................................................................. 10
2.2.1 Event Generation ...................................................................................................... 10
2.2.2 FXO Channel Config and Management ..................................................................... 10
2.2.3 Line State Analysis via Current and Voltage Measurements....................................... 10
2.2.4 GPIO Support ............................................................................................................ 11
2.2.5 Loopback and Testing Modes .................................................................................... 12
2.2.6 Call Progress Monitor ................................................................................................ 12
2.2.7 Billing Tone Filter....................................................................................................... 12
3 Driver Service Interface ............................................................................................................... 13
3.1 Linux Operating System ......................................................................................................... 13
3.2 Other Operating Systems ....................................................................................................... 13
4 Country Specific Settings ........................................................................................................... 14
5 FXO Events .................................................................................................................................. 15
5.1 M1966_FXO_EVENT_t .......................................................................................................... 15
5.2 Event Identification................................................................................................................. 16
5.2.1 M1966_BATTERY_DROPPED .................................................................................. 16
5.2.2 M1966_BATTERY_FEEDED ..................................................................................... 16
5.2.3 M1966_ONH_APOH_DETECT.................................................................................. 16
5.2.4 M1966_ONH_NOPOH_DETECT ............................................................................... 17
5.2.5 M1966_ONH_POLARITY_CHG ................................................................................ 17
5.2.6 M1966_OFH_POLARITY_CHG ................................................................................. 17
5.2.7 M1966_RING_DETECT_START ............................................................................... 18
5.2.8 M1966_RING_DETECT_END ................................................................................... 18
5.2.9 M1966_DEVICE_FAILURE_DETECT........................................................................ 18
5.2.10 M1966_OV_DETECT ................................................................................................ 19
5.2.11 M1966_OI_DETECT ................................................................................................. 19
5.2.12 M1966_OL_DETECT ................................................................................................ 19
5.2.13 M1966_LINE_STATE ................................................................................................ 20
5.2.14 M1966_DIAL_COMPLETE ........................................................................................ 20
5.2.15 M1966_DIAL_ABORTED .......................................................................................... 20
5.2.16 M1966_DEVICE_RECOVERED ................................................................................ 21
5.2.17 M1966_GPIO_INTERRUPT ...................................................................................... 21
5.2.18 M1966_ONH_DETECT ............................................................................................. 21
6 IOCTL Commands Description ................................................................................................... 22
6.1 Initialization and Configuration IOCTLs................................................................................... 23
6.1.1 M1966_CH_INIT ....................................................................................................... 24
6.1.2 M1966_PCM_IF_CSET_OPMODE_SET ................................................................... 25
6.1.3 M1966_PCM_IF_CSET_FREQUENCY_SET............................................................. 26
6.1.4 M1966_PCM_IF_CSET_RPOL_SET ......................................................................... 27
6.1.5 M1966_PCM_IF_CSET_TPOL_SET ......................................................................... 27
6.1.6 M1966_PCM_IF_CSET_RCS_SET ........................................................................... 28
6.1.7 M1966_PCM_IF_CSET_TCS_SET ........................................................................... 28
6.1.8 M1966_PCM_CSET_TSLOT_RX_SET ..................................................................... 29
6.1.9 M1966_PCM_CSET_TSLOT_TX_SET ...................................................................... 29
6.1.10 M1966_PCM_CSET_COMPRESSION_SET ............................................................. 30
6.1.11 M1966_PCM_ACTIVATION_SET .............................................................................. 30