9-Jule-2000
http://www.smlink.com
Smart Link Ltd.


Smart Link Software Modem for Linux.
====================================

Alpha Release.

Release Notes
-------------

* This is an Alpha release of Smart Linux Modem drivers.

* This release was tested on RedHat-6.1, SuSe 6.4 and XteamLinux 3.0
  distributions.

* This release is provided in "RPM" (standard format for software
  package under RedHat, SuSe and the other major Linux distributions).
  
  RPM gives the ability to install the drivers in a standard way.

* This release is built for driver loading on-demand by the operating
  system. 


HW Pre-Requirements
-------------------

* Mainboard: i810-based.
* Minimum CPU requirement: Intel Pentium 400MHz (or equivalent) or higher.
* Minimum memory required: 64 MB.
* Smart Link HAMR5600-based AMR modem.


OS Pre-requirements
-------------------

* RedHat-6.1 distribution (or SuSe 6.4 or XteamLinux 3.0, etc.)
* Linux kernel version 2.2.16 or higher. 

  NOTE: This driver was tested only with this kernel, but may also work
  with other 2.2.XX versions of the kernel.


Installation
------------
(The "1.0.0-X" in file names corresponds to the driver version)

1. Install a Smart Link HAMR5600-based AMR modem into the AMR slot.
   Restart the machine.

2. Change to the user "root", using the following command:

   $ su -

3. If a previous version of this driver was installed on this machine
   using RPM, remove it using the following command:

   # rpm -e slmdm

4. Compile the drivers, using the following command:

   # rpm --rebuild slmdm-1.0.0-X.src.rpm

   This will create slmdm-1.0.0-X.i386.rpm in the directory:
   /usr/src/.../RPMS/... (observe the output, and look for 
   the "Wrote: ..." line).

   This will build the modem drivers for this kernel.
  
   Note: This process requires kernel headers to be present
   in the directory '/usr/include/linux' (usually, this is the
   default in Linux).

5. Install the drivers, using the following command:

   # rpm -i /usr/src/.../RPMS/.../slmdm-1.0.0-X.i386.rpm


Loading modem
-------------

1. Change to superuser (if you are not already logged in as ):

   $ su

2. Change directory to '/usr/local/slmdm':

   # cd /usr/local/slmdm

3. Select country you are in. Use a text editor (such as 'vi' or 'emacs'),
   open the file 'm.info' and change the following line (number 54):

   "CountryName"="YourCountryName"

   Valid country names can be found in the same file, in section
   'HomologationParameters'. Default country setting is USA.

4. The drivers are supposed to be loaded "On Demand".

   But if it fails you can always load the manually:
   As superuser ('root') run the script 'load_slmdm':

   # ./load_slmdm

5. After using modem, run unload_slmdm script as superuser ('root'):

   # ./unload_slmdm


Using the modem with applications
---------------------------------

Use any modem application (such as 'minicom', 'pppd' or 'chat') as usual.
The modem was tested by us with 'minicom' terminal emulation and 'pppd' 
with 'chat' and 'kppp' dialing-up.

NOTE:  The document ppp-howto.txt provides a basic instructions
       how to configure PPP.


Uninstallation
--------------

To uninstall the modem:

   # su -
   # rpm -e slmdm


Feedback
--------

Please send feedback to Smart Link. See the Smart Link
web site for contact information (www.smlink.com) or to
support@smlink.com.
