Simplifying System IntegrationTM 73M1822/73M1922 Modem CTL Application User Guide December 23, 2009 Rev. 1.
73M1822/73M1922 Modem CTL Application User Guide UG_1x22_056 © 2009 Teridian Semiconductor Corporation. All rights reserved. Teridian Semiconductor Corporation is a registered trademark of Teridian Semiconductor Corporation. Linux is a registered trademark of Linus Torvalds. All other trademarks are the property of their respective owners.
UG_1x22_056 73M1822/73M1922 Modem CTL Application User Guide Table of Contents 1 Introduction ................................................................................................................................... 5 1.1 Modem CTL User Space Application ........................................................................................ 5 1.2 Modem CTL Command Summary ............................................................................................ 6 2 Command Descriptions......
73M1822/73M1922 Modem CTL Application User Guide UG_1x22_056 Figures Figure 1: Conceptual Diagram of the Linux Modem CTL Application ........................................................ 5 Figure 2: Help Command Logging Session .............................................................................................. 7 Figure 3: Register Read Command Logging Session ............................................................................... 8 Figure 4: Register Write Command Logging Session ...
UG_1x22_056 73M1822/73M1922 Modem CTL Application User Guide 1 Introduction This document describes the 73M1822/73M1922 Modem CTL Application, a software tool that is used to demonstrate and evaluate the 73M1822/73M1922 Reference Driver and the 73M1822/73M1922 devices in a system. This user guide applies to both the 73M1922 and 73M1822, which will be collectively referred to as the ® 73M1x22 in this document. The current Modem CTL Application version can be used on Linux 2.4 and 2.6 kernels.
73M1822/73M1922 Modem CTL Application User Guide 1.2 UG_1x22_056 Modem CTL Command Summary Entering tsc_1x22_app at the command line brings up the Modem CTL program. Refer to the individual command descriptions in Section 2 for syntax and usage. When running the Modem CTL program displays the following prompt: 1X22CTL:XX> where: XX is the current active channel. Upon startup the current active channel is defaulted to channel 0.
UG_1x22_056 73M1822/73M1922 Modem CTL Application User Guide 2 Command Descriptions This section provides the details of each Modem CTL command. The command syntax varies based on each command but in general it consists of the command verb follow by its parameters. Some commands are self-contained (no parameter is needed) while others may have optional or mandatory parameter(s). The command verb is auto filled by the program.
73M1822/73M1922 Modem CTL Application User Guide 2.2 UG_1x22_056 1x22 Hardware Register Access The Modem CTL provides access to the 1x22 hardware register via register read and write command as described below. 2.2.1 Register Read Commands The register command can be used to reads the content register(s) on the current active device (NN).
UG_1x22_056 73M1822/73M1922 Modem CTL Application User Guide 2.2.2 Register Write Command The register command can also be used to write a value to the register on the current active device (NN). Syntax 1X22CTL:NN> register rgXX=0xYY Where: XX YY 00 to 25 hexadecimal represent the registers from 00 to 25 hex. Hexadecimal value from 0x00 to 0xFF. NN Shows the current active channel ID. Refer to the chip datasheet for registers, their usage and contents.
73M1822/73M1922 Modem CTL Application User Guide UG_1x22_056 2.3.2 Answer Command The answer command manually answers an incoming call by bringing the FXO channel off-hook. This command is manually issued by the user when the RING event is detected. Syntax 1X22CTL:NN> answer channel) 1X22CTL:NN> answer Where: XX NN (answer call on current active (answer call on channel ID XX) 00 to 15 decimal represent the channel ID. Shows the current active channel ID.
UG_1x22_056 2.5 73M1822/73M1922 Modem CTL Application User Guide Dial Commands The dial is the command for managing pulse dial feature. With this command the user can perform pulse dialing with a numeric digit string, abort or cancel an on-going dial process, or changing or display pulse dial timing parameter. To display the dial timing parameter omit all input after the token “param”.
73M1822/73M1922 Modem CTL Application User Guide 2.6 UG_1x22_056 Exit Command The exit command terminates the Modem CTL program. When issued, the user is prompted and asked to confirm with a Y(es) or N(o). A “yes” terminates the program. Syntax 1X22CTL:NN> exit Where: Shows the current active channel ID. NN The following is a log of the command to exit the Modem CTL program. Modem CTL:00> exit Are you sure you want to quit? (Y or N)y Enter “Y” to confirm.
UG_1x22_056 73M1822/73M1922 Modem CTL Application User Guide 2.7.2 On-Hook Command The onhook command brings the FXO channel on-hook. Syntax 1X22CTL:NN> onhook 1X22CTL:NN> onhook Where: (Bring current channel ID off-hook) (Bring channel XX off-hook) XX Channel ID. NN Show the current active channel ID. The following is a log of commands that bring the current channel ID and channel 4 on-hook. Modem CTL:00> onhook Take current channel (0) on-hook. Channel 0 is ON-hook.
73M1822/73M1922 Modem CTL Application User Guide UG_1x22_056 2.8.1 IET Setting Command The iet (Interval Event Table) is a table of up to 10 entries of interval threshold parameters. The driver can be instructed to monitor the line current and/or voltage and send an appropriate event when the current or voltage falls within active interval threshold. The iet command can be used for managing this IET table.
UG_1x22_056 73M1822/73M1922 Modem CTL Application User Guide 2.8.2 Measure Command The measure command is used to initiate or terminate a monitoring session. A monitoring session can be for line voltage or line current. Both measuring entity (voltage and current) can be active currently. Syntax (Stop) 1X22CTL:NN> measure stop Where: NN Show current active channel ID. Syntax (Start) 1X22CTL:NN> measure start Where: XX Sample time interval (in ms).
73M1822/73M1922 Modem CTL Application User Guide 2.9 UG_1x22_056 GPIO Management The Modem CTL provides three commands for managing the GPIO: 1. Config – configures the GPIO pin for operation. 2. Control – enable/disable the GPIO pin. 3. Data – accessing GPIO data. 2.9.1 GPIO Config Command The GPIO pin must be configured properly before it can be used. Using this command the user can display the GPIO configuration (GET), or configure the GPIO pin for the desired operation (SET).
UG_1x22_056 73M1822/73M1922 Modem CTL Application User Guide 2.9.2 GPIO Data Command Using this data command the GPIO pin can be read (if configured as input) or written into (if configured as output) with signal level of high or low. Syntax (GET) 1X22CTL:NN> gpio data get gpioX Where: gpioX gpio4, gpio5, gpio6, or gpio7. NN Shows the current active channel ID. Syntax (SET) 1X22CTL:NN> gpio data set gpioX [low|high] Where: gpioX gpio4, gpio5, gpio6, or gpio7. NN Shows the current active channel ID.
73M1822/73M1922 Modem CTL Application User Guide UG_1x22_056 2.10 Loopback Management There are six different loopback mode can be set internally by the driver. Using the loopback command the user can disable the loopback, query the loopback status, or enable one of the following loopback modes: 1. 2. 3. 4. 5. Digital loopback – 1 Internal loopback – 1 Digital loopback – 2 Internal loopback – 2 Analog loopback 2.10.1 Loopback Set Command This command enables one of the loopback modes.
UG_1x22_056 73M1822/73M1922 Modem CTL Application User Guide 2.11 Billing Tone Filter Commands This command enables or disables the billing tone filter. If enable the user must specify the Receive Low Pass Notch (RLPN) frequency of 12 or 16 kHz. Syntax 1X22CTL:NN> billingtonefilter [enable|disable] [12khz|16khz] Where: NN Shows the current active channel ID. The following is a log of the billing tone filter commands: Enable billing tone filter with RLPN at 12 kHz.
73M1822/73M1922 Modem CTL Application User Guide UG_1x22_056 3 Related Documentation The following 73M1x22 documents are available from Teridian Semiconductor Corporation: 73M1822/73M1922 Data Sheet 73M1822/73M1922 Layout Guidelines 73M1x22 Worldwide Design Guide 73M1822/73M1922 Control Module User Guide 73M1822/73M1922 Hardware Module for SMDK412 User Guide 73M1822/73M1922 Modem API User Guide 73M1822/73M1922 Modem CTL Application User Guide 73M1822/73M1922 MicroDAA Software Architecture 4 Contact Infor
UG_1x22_056 73M1822/73M1922 Modem CTL Application User Guide Revision History Revision 1.0 Rev. 1.0 Date 12/23/2009 Description First publication.