Hayes Microcomputer Products Mwave User's Manual
Contents
1. EITO_SPECIFIC_TRACE 1 Mwave Modem application trace points WMLW32_TRACE za ll fe 4 Debugging Tips 10 Linux ACP Modem Mwave mini HOWTO MWMPW32_TRACE 1 MWMUTIL_TRACE 1 MWWTT32_TRACE 1 Trace information is logged using the syslog utility 4 Debugging Tips 11 5 Test Claims This driver has been tested using the ThinkPad 600E The same chipset is integrated on the 600 and 770 models and should work 5 Test Claims 12 6 List of Supported Countries The following countries are supported by the ACP Modem driver Table 1 List of Supported Countries Country Name Country Access Code ANTIGUA_BARBUDA 102 ARGENTINA ARMENIA 374 ARUBA 297 AUSTRALIA AUSTRIA AZERBAIJAN BAHAMAS BARBADOS BELARUS BELGIUM BERMUDA BOLIVIA BRAZIL BRUNEI BULGARIA CANADA CAYMAN_ISLANDS CHILE COLOMBIA COSTA_RICA CUBA CYPRUS CZECHREPUBLIC DENMARK ECUADOR EGYPT nn p On o gt oO w X io Nn i nN J W Nn Nn oo i Nn Nn O W E N i 6 List of Supported Countries Linux ACP Modem Mwave mini HOWTO pemaos fa i 6 List of Supported Countries N T EN RE 14 Linux ACP Modem Mwave mini HOWTO PHILIPPINES 63 snom soan h soma h 3 SPAIN 4 ST_KITTS_NEVIS 115 ST_LUCIA ST_VINCENT 116 SURINAME 597 SWEDEN SWITZERLAND TAIWAN THAILAND TRINIDAD_TOBAGO TURKEY TURKS_CAICOS 5 21 86 72. 2 Change directories with cd mnwavem yyyymmdd 3 Use the configure command to configure the build options Issue configure help to view all of the options The defaults are probably okay though a NOTE As of mwavem 1 0 3 you must give configure the enable mwavedd argument in order to build the driver with the user space application 4 Use the make command to build all of the ACP Modem binaries g NOTE Your gcc package should be at least at the 2 7 x level Check your usr src linux Documentation Changes file for the minimum version information 5 Use make install to install the mwavem binary mwavem conf configuration the extra binary mostly dsp files and module device driver if you specified that it must be built and to create the dev modems mwave device node 2 3 Setting Things Up In the WORLDTRADE section of your mwavem conf file set the Country parameter to your country access code g NOTE The mwavem conf file is installed in the usr local etc directory unless you specified otherwise during the build process 2 Compilation Installation and Startup 3 Linux ACP Modem Mwave mini HOWTO Country information including access codes are listed in the mwavem conf file For example for France the following section is present Telephony Country List 33 Count ryCode 00000021 Name France SameAreaRule 0FG LongDistanceRule 0FG InternationsalRule 00EFG To set France
3. E EO E RR ENE 10 E E PE E E T ONENE ENAA EE ENN E AE N E EA E EAA 10 ST T a 12 6 Listor Supported ComiirieS orisii aniston ieee Maa 13 Frade nor anan rA AAEE EASRA EE EA ea a adn 16 1 General Information and Hardware Requirements 1 1 Introduction The ACP Modem for Linux is a software based modem Support software for the ACP modem is composed of a loadable kernel module and a user level application Together these components support direct connection to public switched telephone networks PSTNs and support selected countries world wide Refer to Section 6 of this document for the supported country list The modem also supports the standard communications port interface ttySx and is compatible with the Hayes AT Command Set ACP Modem software is continually under development If you encounter bugs or usability issues please contact us and we ll work to correct them 1 2 Credits This Linux ACP Modem driver was ported from the Windows NT version of the driver available from IBM Many thanks to Keith Frechette Charles Ball and Frank Novak for their technical and support efforts in making this project possible 1 3 Where Can I Get the Latest Version of this Driver The latest version of this driver is available from http www ibm com linux Itc 1 4 Are There Any Other Resources Thomas Hood s Debian GNU Linux on IBM ThinkPad 600 and 600x page contains lots of useful information 1 5 Copyright Notice and Disclaime
4. In the above example the formula used to arrive at the proper number was 1024 nMB 576 nK If you forget to run the Thinkpad utility to enable the ACP Modem and you didn t specify any command line arguments when inserting the mwave module or it didn t work you will receive a message in the syslog similar to the one below ACP Modem UART settings IRQ 0x3 TORO ES tp3780 EnableDSP pSettings gt bDSPEnabled 0 failed Mwave Modem ERROR cannot Enable DSP error fffffffb Mwave Modem ERROR cannot perform Mwave Initialization retval fffffffb If you receive a message like the one above check the command line arguments you provided to insmod 3 2 Resource Conflicts The ACP Modem requires the use of system resources for both the DSP and the UART provided by the ACP chip For Linux systems you will specify parameters to use for the duration of the boot with the insmod mwave command line parameters listed in Section 2 4 1 Typically the configured resources are For the DSP IRO 10 I O address 0x130 O0x13 For the UART IRQ 3 il Omadedre ss T02 feom RS NEES 3 Resolving Installation and Configuration Problems 7 Linux ACP Modem Mwave mini HOWTO Om mes Ondediacc sm Oss omml ClmmSHenc mieten O For dual boot systems we recommeded that you use the Thinkpad Configuration Utility on Windows NT or DOS to configure these system resources Windows NT Thinkpad Configuration Utility Notes Under t
5. N N i AW F P JKRAINE JNITED_ARAB_EMIRATES JRUGUAY H n gt VENEZUELA VIETNAM VIRGIN_IS_BRITISH VIRGIN_IS_USA YEMAN YUGOSLAVIA oo x aj o0 wo ola eee i 6 List of Supported Countries 15 7 Trademarks Hayes is a trademark of Hayes Microcomputer Products Inc MNP Microcom Network Protocol is a trademark of Microcom Inc IBM is a trademark of International Business Machines Inc 7 Trademarks 16
6. Linux ACP Modem Mwave mini HOWTO Mike Sullivan sullivam us ibm com Paul Schroeder paulsch us ibm com Joy Yokley Edited document and coverted to DocBook v4 1 SGML 2001 01 12 Revision History Revision 11 2002 07 18 Revised by PBS Revision 10 2001 07 18 Revised by PBS Revision 09 2001 05 21 Revised by PBS Revision 08 2001 05 09 Revised by JEY Revision 07 2001 04 30 Revised by JEY This document describes how to build setup and use the driver and user space application necessary for using the ACP Mwave Modem in the IBM Thinkpad 600 600E and 770 models which include the on board ACP modem hardware The latest version of this document can always be found at http www ibm com linux Itc Linux ACP Modem Mwave mini HOWTO Table of Contents 1 General Information and Hardware Requirements ccccssscsssscssssccsssscssccssssecsssscssssccssssssssssssessssesseess 1 Li TaD SETI tiOn cones cccccianidecteep eladcap E O seecavesseuaeieen Goutenideedsasaneenee 1 US IU casos cu boss ev oekaki sks EAE ek E A ENIE A mec Wea en lane RRR OAA NO URES 1 1 3 Where Can I Get the Latest Version of this Driver ccccccceeessesssesseseeseessscssceseeeeeeeaeececececeseeees 1 1a Are There A0 Other KRESo Oca ioan ienee Ea EE EAE ETEA Ot 1 13 Copyriht Notice and Disc Mier sssisccssedesecarsecccasncsesesdeacsianrathaivorateiseecan emer eae aes eae 1 Lei Which Systema are OTL ivari airn EAN aunts ied aa Re ma
7. be supplied with the insmod command g NOTE ENS 2 4 Runtime Linux ACP Modem Mwave mini HOWTO The following arguments are not persistent from boot to boot i e We are not saving them in the BIOS e mwave_3780i_irq 5 7 10 11 15 This parameter allows you to configure the IRQ used by the DSP if the DSP IRQ was not set and stored in BIOS by the Thinkpad configuration utility e mwave_3780i_i0 0x130 0x350 0x0070 0xDBO This parameter allows you to configure the I O range used by the DSP if the DSP I O range was not set and stored in the BIOS by the Thinkpad configuration utility e mwave_uart_irq 3 4 This parameter allows you to configure the IRQ used by the ACP UART if the Mwave s UART IRQ was not set and stored in BIOS by the Thinkpad configuration utility e mwave_uart_10 0x3f8 0x2f8 0x3E8 0x2E8 This parameter allows you to configure the I O range used by the ACP UART if the UART I O range was not set and stored in BIOS by the Thinkpad configuration utility The following code is an example of how to run DSP using ttyS1 resources y Z Q lez The mwave is unable to check for resource conflicts It is your responsibility to ensure that none of the resources specified conflict with other commonly PCMCIA devices You can use the tpctl package on Linux or the Thinkpad configuration utility on Windows NT or DOS to manage the configuration of Thinkpad related resources 2 4 2 Running ACP Modem Applicatio
8. he Internal Modem gt Advanced selection 1 Set IRQ sharing to disabled 2 Set Ist IRQ to your DSP IRQ 10 is recommened 3 Set 2nd IRQ to your UART IRQ i e ttyS1 is equivalent to COM2 4 Set the DSP I O address 0x130 is recommended 5 Set the internal modem I O address to the UART I O address i e 0x2f8 for COM2 6 The DMA address is unused and can be set to anything g NOTE You may also specify parameters to use for the duration of the boot by using the insmod mwave line parameters listed in section Section 2 4 1 3 3 Not Connecting at Specified Starting Speed The configured initial connection speed is set to 64000 The modem should start there and negotiate down to a connection speed based on target modem and line capabilities If the modem is unable to connect it may be having difficulty negotiating with the target modem Try setting the SPEED parameter in mwavem conf to a lower initial starting speed Supported speeds include e 64000 e 33600 e 14400 e 9600 e 2400 3 4 Dialer Application Cannot Detect Serial Port The startup script that executes the serial port setup works well with Red Hat Debian Slackware and SuSE If you are not running one of these distributions you may need to perform the following steps in order to set up After inserting the mwave o module and starting the mwavem application you must run the setserial command in order for the serial port configuration to discover the UART on
9. n 1 Once the ACP device driver is loaded successfully use the mwavem command to execute the application g NOTE The location of the mwavem conf file can be specified as an argument to the mwavem application If not specified the default location is assumed to be usr local etc mwavem conf unless otherwise changed 2 4 2 Running ACP Modem Application 5 Linux ACP Modem Mwave mini HOWTO during the build process 2 Setup the serial driver to recognize the UART provided by the ACP driver g NOTE Substitute dev ttySO to match the serial port you have configured the DSP to use B NOTE You may wish to create a symbolic link from your modem device to your serial device for convenience Example In s dev ttyS0 dev modem The ACP Modem is now available for use by your favorite dialing application 2 4 2 Running ACP Modem Application 3 Resolving Installation and Configuration Problems The following sections list solutions to possible problems you may experience 3 1 DSP Does Not Start In order to recognize memory above 64 Meg it may be necessary to append the mem option to the kernel command line If you are using LILO for your boot loader you would do this in the Lilo conf file For example if you had a machine with 128 Meg you would type append mem 130496K B NOTE Your statement must reflect 576K less than you actually have Specifying the full amount of memory will prevent the DSP from starting
10. or up to 4x data compression e Adaptive Rate Negotiation which provides for Fallback Fallforward as line quality deteriorates or improves Your modem contains 56K technology To take advantage of this technology you must first make sure that your Internet Service Provider ISP supports a 56K modem protocol Significantly higher modem connection speeds up to 56kbps require all digital transmission connections from your ISP to the line card in the central office from which your phone line is connected The actual connection rate may be limited by the quality of your telephone lines Telephone line quality may vary from location to location Current regulations limit maximum trasfer rates to 53K While your modem contains 56K technology typical maximum connection rates in the receive direction may be significantly less than 56K Currently 56K capability is for the receive direction only The transmit direction uses V 34 technology 1 6 Which Systems are Supported 2 2 Compilation Installation and Startup 2 1 Prerequisites e A 2 2 16 series or later Linux kernel source tree e An appropriate set of module utilities e gcc version 2 7 x or later If you are building the ACP Modem driver along with the user space application you need to have a complete Linux source tree for your kernel not just an up to date kernel image 2 2 Building and Installing Source 1 Use tar xzvf mwavem yyyymmdd tar gz to unpack the distribution
11. p running with 2 4 0 One of the most prevelant errors we received was Can t locate module tty ldisc 3 However we had no problems once we rebuilt the kernel with the following options CONF IG_PPP y CONF IG_PPP_ASYNC m CONFIG_PPP_SYNC_TTY m CONFIG _PPP_DEFLATE m CONF IG_PPP_BSDCOM m 3 5 PPP Errors Using 2 4 0 Version of the Kernel lt o 4 Debugging Tips 4 1 Error Logs Errors encountered by the ACP Modem device driver or application are logged using the syslog utility 4 2 Tracing The ACP device driver supports a debug argument to enable the generation of trace information The command for this debug is listed below You can also access several of the variables listed below in the mwaved script insmod mwave mwave_debug 0x0f Where the following debug trace information is selectable 0x01 ACP Modem Device driver entry points 0x02 Systems Management API SMAPT 0x04 Hardware Interface 37801 0x08 Thinkpad Interface tp3780i Trace information is logged using the syslog utility The ACP application supports tracing through the use of flags configured in the STARTUP section of the mwavem conf file Mwave Manager API trace points AANAGER_API_TRACE 1 AANAGER_API_DATA_TRACE 1 ANAGER_CORE_TRACE 1 AANAGER_SPECIFIC_TRACE 1 MEIO Manager trace points EIO_API_ TRACE ira ll pan FE TO_CORE_TRACE 1
12. r Copyright c 2002 IBM Corporation This document may be reproduced or distributed in any form without prior permission Modified versions of this document may be freely distributed provided that they are clearly identified as such and this copyright is included intact This document is provided AS IS with no express or implied warranties Use the information in this document at your own risk 1 General Information and Hardware Requirements 1 Linux ACP Modem Mwave mini HOWTO 1 6 Which Systems are Supported This version of the ACP Modem driver supports the IBM Thinkpad 600E 600 and 770 that include on board ACP modem hardware 1 7 Features of the Modem The ACP Modem provides the following features e Standard asynchronous COM port interface NS16550A UART compatible operation e Bell 103 212A CCITT V 21 V 22 V 22bis protocols with data from 300 to 2400 bps e CCITT V 32 protocols with data rates of 4800 9600 uncoded and 9600 bps Trellis coded Optional e CCITT V 32bis protocols with data rates of 4800 9600 12000 and 14400 bps optional e ITU T V 34 protocols with data rates from 2400 to 33600 bps e 56K capable modem e Hayes AT Command Set compatibility e DTMF and pulse dialing e Asynchronous error recovery protocol e Error correction via Microcom Network Protocol MNP classes 1 4 e Error correction via the V 42 error correction standard e MNP class 5 for up to 2x data compression e V 42bis f
13. rion 2 1 Paes of he Modei ais cs sisvines sansncs sundausseaeneiadinedajdidyseeisupyaes pax amas ee nian bes Maan es 2 2 Compilation Installation And Stari soiirci nean oona a aaa a aa E naV aaa aaa 3 r A WA A EEE E e E AA AON O OE AOE A Aa EENE A A A E NS 3 22 Bwiling and Msalina SOC E ain cg sects eiae pues ceed ea yes aud aa mad aT eed EEA EEEN EE A a TTS 3 ARS ie Te HCY ale TL cod eer ne octet reer ere eer nT re ee ener ener ree eee one 3 PAE AI IIN ote tice ch E PE Steers cae E EEA SAPE passe E acannon Gouda seta sae ear piace ace eee ae 4 22 Eoddme he ACP ice ait of aca nih unt N N eee 4 24 2 Running ACP Modem Application siasccd ccs secssusiess sets scsantecavysivennsniarseendessecs aud nes aiias 5 3 Resolving Installation and Configuration Probleme csccssscssssscsssscsssscssssssssscsssscssssscsssssssssssssssssssens 7 21 BSF Doci NOA eE E denn vero oberg wis A wae wan Swichers ace EAE ek co a sea 7 Te Resour A TON eaea a a A ESE Praa AA ss ee eee 7 3 3 Not Connecting at Speciiied Staring Speed ccsscsssescsvavsernasatenceiviaasgaieiasnedavsecesaadartesaieaccertearncianaress 8 34 Dialer Application Cannot Detect Serial Pott ccsis cscausdenccceserisnavsousnaioocscaatesiauessescaasibsvaceioasueatvesaastves 8 33 PPP Erroi Using 24 0 Version ofthe Kennich eraon nnise oain orir EErEE E OARA NT 9 4 eR ONG TiDi a r AAA NAANA EAE KAA E aAA EA E EE aes NONE 10 dl Emor Lise desssaccune sexeeneiendnsan os E aE E NOR SEE S
14. the mwave hardware setserial dev ttySx autoconfig Replace ttySx with the serial port you have configured the ACP driver to use To test whether the serial port is setup correctly run 3 3 Not Connecting at Specified Starting Speed 8 Linux ACP Modem Mwave mini HOWTO setserial dev ttySx The above command should return the following for serial port 1 Mevlevi VART IGSS5OA POTES Ox 2s ROS 3 The port and IRQ numbers should match the information placed in the syslog by the ACP module when it was loaded kernel Mwave Modem UART settings IRQ 0x3 IO 0x2f8 If the information returned by setserial indicates that the UART is unknown or if the IRQ and I O resources do not match what you have in the syslog you will need to reconfigure Check the setserial man pages to learn how to setup the resources on your ttySx to match what appears in the syslog output If you have problems running setserial you may have a resource conflict Before using insmod mwave check proc ioportsand proc interrupts to make sure the resources you intend to claim are not already in use 3 5 PPP Errors Using 2 4 0 Version of the Kernel When upgrading to the 2 4 0 version of the kernel be sure to read the Documentation Changes file Kernel 2 4 0 requires an upgraded version of the pppd gcc and modutils amoung other things Follow the instructions for setting up the new pppd daemon carefully You may experience some initial problems getting pp
15. to be your configured country in the WORLDTRADE section of mwavem conf set Country 33 2 4 Runtime An initialization script has been provided which may be used to to start stop or check the status of the ACP Modem driver and application It has been successfully run on the Debian Slackware SuSE and Red Hat distributions and should run on any of their derivitives If you are using the runtime script it will load the mwave device driver module configure the serial port and start the mwave manager for you All of the options which can be passed to the device driver module along with some options for the script itself can be configured by uncommenting and editing the appropriate variables at the beginning of the script The mwaved startup script can be found in the src mwavem directory of the source distribution If you are running the Red Hat distribution you can copy the script to your etc rc d init d directory and issue the ntsysv command in order to enable it at boot time If not using Red Hat see the documentation for your distribution for information on how to set this up to run at boot time It is recommended that you use the provided mwaved script If you are not using the script however the following sections will describe how to manually start the device driver and application 2 4 1 Loading the ACP device driver To load the mwave device driver use insmod mwave or modprobe mwave The following arguments may
Download Pdf Manuals
Related Search