Information On using the SMC OS/2 NDIS Device Driver ___________________________________________________ Date: Oct. 28, 1996 Version: 2.72 How to Install the OS/2 NDIS driver with OS/2 Warp: ___________________________________________________ * For ISA bus and Fast Ethernet LAN cards, proceed directly to Section III. * For Lan/Modem (dual-function)and LAN-only (single- function) PCMCIA cards, continue reading and go to the appropriate sections when indicated. ___________________________________________________ In order to install your Lan/Modem PC-Card with IBM's OS/2 Warp Connect, you will need to have the following installed prior to installing network support: * OS/2's PCMCIA Card support (Card & Socket Services) with support for serial devices. * SMC9000 Lan/Modem Card enabler OS/2 PCMCIA Support: If you have OS/2's PCMCIA and serial device support already installed, please proceed to the section "Installing the SMC9000 Enabler". If you do not have PCMCIA (or serial device) support installed, please proceed first to the section "Installing PCMCIA Support for OS/2". SMC9000 Lan/Modem Card Enabler: If you have both PCMCIA support and the SMC9000 Lan/Modem Card enabler already installed, please proceed to the section "Installing the SMC9000 Driver with OS/2 Network Support". If you do not have both PCMCIA support and the SMC9000 Lan/Modem Card enabler already installed, please proceed to the appropriate section(s) as it applies to your current OS/2 setup. NOTE: Before proceeding, we recommend that you back-up any of the files which may be altered during installation. Those files include the Config.Sys, Autoexec.Bat, Startup.Cmd and Proto- col.Ini files. You can determine the location of these files by typing dir \[filename] /s /p at the command prompt. We also recommend that additional and separate back-up files be created after each successful step in the installation process. You will then be able to restore the most recent working versions if the entire installation is not successful on your first attem- pt. Create separate subdirectories for the back-up files, and be sure each has a unique filename. You will then be able to use these files by copying them to their original directories using their original names. I) Installing PCMCIA (and Serial Device) Support for OS/2: __________________________________________________________ Important! Before proceeding to install serial device support, at least one of your computer's existing COM ports must be enabled. This is usually done through your system's BIOS setup utility. a) Click on the 'OS/2 System' icon located on your desktop. b) Select the 'OS/2 WARP Connect Install/Remove' folder and open the folder. c) Select the icon 'OS/2 Warp Selective Install' and double click on it. d) When the system configuration screen appears, click on the 'PCMCIA Support' button. e) A window will appear offering a variety of PC system selections. Choose the appropriate model that matches your system and high- light your selection by clicking on it once. Next, select the 'PCMCIA Modem/Fax' option. This option is suitable for LAN-only and LAN/Modem cards. Click on 'OK' to return to the 'System Configuration' window. NOTE: Select flash memory and/or hard disk support only if you use these types of PCMCIA products, otherwise do not select these options. f) Serial Device Support _____________________ (LAN/Modem Card users) : If serial device support is not yet installed, you must install it at this time. (LAN-only Card users) : It is not essential to install serial device support to use your single-function Ethernet card, however if you will be using other modems or serial devices, serial device support should be installed. Be sure to use the SMC Enabler's /COM=0 switch if you are installing serial support. If you are NOT installing serial device support, omit the SMC Enabler's COM switch parameter. Click on the button labeled 'Serial Device Support'. The 'Serial Support' window will appear. Click on the 'Install Support' radio button, then click on 'OK'. NOTE: It is essential that your computer's COM ports are enabled while installing serial device/PCMCIA support. If they are disabled, OS/2 will not detect any COM ports and therefore will not install the required COM.SYS and VCOM.SYS device drivers. Your modem needs the drivers in order to operate under OS/2. You may disable the COM port(s), if necessary, after support has been installed to allow the modem to use the resources normally assigned to these ports and/or to resolve potential IRQ or I/O Base Address conflicts. g) Click on the 'Install' button. Installation will now begin, and your Config.Sys file will be updated to include PCMCIA support. h) Please proceed to Section II. II) Installing the SMC9000 Lan/Modem Enabler: _____________________________________________ NOTE: You will need to determine which I/O Port addresses and IRQ settings are available for the SMC LAN/Modem. It is important that these selections do not conflict with existing hardware settings. At this time, you may wish to use a diagnostic utility to assist you, and then continue with the installation. a) Open the Config.Sys file for editing using a plain-text editor. If you wish, you may use the built-in editor provide by OS/2 by opening a OS/2 window and typing the following at the command prompt: [drive:path]e.exe \config.sys (Be sure that you're at the default drive for OS/2). b) Once PCMCIA support for OS/2 has been installed you should have the following statements, in the order illustrated, in the config.sys file. You will need to add line 6 (SMC Enabler) : ...... (Card Services )- BASEDEV=PCMCIA.SYS DEVICE=C:\OS2\MDOS\VPCMCIA.SYS (OS\2 COM device)- DEVICE=C:\OS2\BOOT\COM.SYS (support. ) DEVICE=C:\OS2\MDOS\VCOM.SYS - DEVICE=C:\OS2\BOOT\AUTODRV2.SYS C:\OS2\AUTODRV2.INI (SMC enabler )- DEVICE=C:\SMC\SMCENAB.OS2 (Socket Services)- BASEDEV=IBM2SS01.SYS /S0=n (n is the total number) (of card slots available) ...... Details for the SMC Enabler parameter list are listed below in the section "SMC Enabler Options". c) Add the optional parameters to the enabler's device statement as required. Once again, it is important that these selections do not conflict with existing hardware settings. SMC Enabler Options: in the above statements are the switches supported in the command line to specify which socket to use and what the configuration parameters are. These parameters are not 'case-sensit- ive'. You may leave out IO, INT and SOC switches; they will then be automatically assigned by OS/2's card and socket services. The following switches may be used with the SMC enabler: i) Socket selection switch: It specifies the socket will be avail- able to the enabler. The default setting is socket 1 - the first socket. /socN : socket N can be used by the enabler, where N ranging from 1 to 2. If this switch is absent, socket 1 is used. ii) Port Address switch: /io=yyy : port address. Default setting is 0x280. yyy is assumed as a hex number. iii) Interrupt switch: /int=yy : IRQ level. Default setting is 11. The supported values are from 1 to 15. This number can be either decimal or hexadecimal. iv) Memory switch: /mem=0xyyyyy :Starting memory address for 4k-byte attribute memory. Supported values are from 0xC0000 to 0xDFFFF in 4k-byte boundaries. The default setting is 0xD0000, where yyyyy is assumed to be a hexadecimal value. This memory window is only opened during initializ- ation and each time the card is re-inserted. Attribute memory address can be set as following, 0xD0000 0xC1000, 0xC2000, ...., 0xDE000, 0xDF000. v) Modem COM port switch: /com=yy: COM port number. Supported values 0 to 6 /com=0 no COM port selected. /com=1 port address 0x3F8-3FF; IRQ -- 4 /com=2 port address 0x2F8-2FF; IRQ -- 3 /com=3 port address 0x3220-3227; IRQ -- 4 /com=4 port address 0x3228-322F; IRQ -- 3 /com=5 port address 0x3E8-3EF; IRQ -- 4 /com=6 port address 0x2E8-2EF; IRQ -- 3 The default setting is 0. If the keyword is missing, the enabler will disable the modem function to support LAN-only functionality. Please refer to the "COM PORT MAPPING" section for suggestions on how to select com port settings. vi) No-checking switch: /n : disable tuple checking, if this switch is detected in the command line. EXAMPLES: _________ Here are some examples to help give you an idea about how the SMC9000 enabler works. 1) To enable LAN only, each of these examples would work: device=c:\OS2\smcenab.os2 /com=0 or device=c:\OS2\smcenab.os2 /com=0 /io=0x300 /int=11 /mem=0xd0000 /soc1 or device=c:\OS2\smcenab.os2 /io=0x300 /int=11 /mem=0xd0000 /soc1 2) To enable modem only, you might type: device=c:\OS2\smcenab.os2 /com=2 /io=0x300 /int=0 /mem=0xd0000 /soc1 or device=c:\OS2\smcenab.os2 /com=2 /io=0x300 /int=0 /mem=0xd0000 or device=c:\OS2\smcenab.os2 /com=2 /int=0 3) To enable LAN/Modem, all of these examples would work: device=c:\OS2\smcenab.os2 /com=2 /io=0x300 /int=11 /mem=0xd0000 /soc1 or device=c:\OS2\smcenab.os2 /com=2 or device=c:\OS2\smcenab.os2 /com=2 /io=0x300 /mem=0xd0000 /soc1 or device=c:\OS2\smcenab.os2 /com=2 /int=11 /mem=0xd0000 /soc1 or device=c:\OS2\smcenab.os2 /com=2 /io=0x300 /int=11 /soc1 or device=c:\OS2\smcenab.os2 /com=2 /mem=0xd0000 /soc1 etc COM PORT MAPPING Recommendations: The /COM=xx switch supports six com port selections. In some fax/modem applications, such as HyperACCESS Lite, choose the com port mapping as recommended in the following table: Enabler Command Line COM Selection /COM= 1 1 2 2 3 3 4 4 5 3 6 4 d) Please proceed to Section III III) Installing the SMC9000 Driver with OS/2 Network Support: ____________________________________________________________ a) Click on the 'OS/2 System' icon located on your desktop. b) Select the 'OS/2 WARP Connect Install/Remove' folder and open the folder. c) Select the icon 'OS/2 Selective Install for Networking' and double click on it. d) After the 'Install' screen has appeared, a window will appear asking if you will be installing remotely or locally. Select 'Local Installation' by clicking on the radio button labeled 'On This Workstation'. e) The menus which follow will prompt you for the type of installation you wish to perform (i.e. "Easy" or "Advanced") and your installa- tion path. You may select either type of installation in order to set up your client configuration. f) After you have selected your workstation's network client options, a menu titled 'Select Network Adapter' will appear. Click on 'Other Adapter... '. The 'Network Driver Adapter Disk' window will appear. g) Enter the drive and path that OS/2's install utility will use to find the SMC drivers. Click on 'OK'. The directory should include the following files: * SMC9000.OS2 OS/2 NDIS Driver * SMCENAB.OS2 Card Enabler * SMC9000.NIF Card-Driver information file h) 'SMC9000 Ethernet PC Card' will then appear in the "Drivers Found" window along with the names of any other network adapter whose drivers are present in the specified path. Highlight the SMC9000 Ethernet pc-card entry and select "Ethernet" to specify the type of LAN topology you will be using. Then select 'OK'. The 'Select Network Adapter' menu will re-appear. i) You must now configure the adapter; click on 'Settings'. At least two options will appear in the table display - * 'Select Media Type' * 'Select Alternate MAC Address'. To configure the adapter, click on 'Select Media Type', and then click on the 'Change' button. The 'Modify Parameter' window will appear. You can select the media-type option for your adapter by clicking on the button located next to the strip-window. The following options should appear: * Automatic * 10BaseT * BNC The default is 'Automatic', however, if the strip window is blank you will need to select one of the three options. Select the appropriate setting, then click 'OK'. [optional] Next, highlight 'Select Alternate MAC Address', and click on 'Change'. Click on the strip-window button and select your alternate Ethernet node address from the available options, then click on 'OK'. (If no alternate node addresses are available, the default value specified in the card's attribute memory will be used.) j) After modifying the adapter's parameters, the 'ISA Network Adapter Software Configuration' window will reappear. If you will be inst- alling other adapters (including network adapters), click on 'Other Adapters' and proceed to install them according to the manufactur- er's recommendations. When all adapter cards have been selected and properly configured, click on the 'OK' button. k) Installation will now proceed to copy all of the necessary files and update your \config.sys and \IBMCOM\protocol.ini files. l) When the installation process has completed, you will need to re- start your computer. You may use the Netware Tools provided in the 'Novell' folder to log into Netware servers and set drive mappings after the system has rebooted. m) Important: If you are using IBM's Peer to Peer Client software, you must be sure that all of your I/O Port and IRQ settings are also properly configured in OS/2's MPTS configuration utility. MPTS will appear as an icon on your desktop or as an icon located inside your "OS/2 Peer" folder (or both). Be sure to select the SMC 9000 driver and "edit" the configuration. The settings here must match the actual hardware and enabler settings. You will need to identify the media-type you will be using from within this utility as well, and make any other appropriate selections that match your setup (for 100Mbs cards, choose MII as your media-type). Additionally, before using IBM's Peer to Peer Client software for the first time, you must click on the 'NetBIOS' radio button and configure it, too. Please consult your OS/2 documentation for further information. ---------------------------------------------------------------------- Miscellaneous: ______________ The format of the procotocol.ini file is as follows: [SMC9000_nif] DriverName = "SMC9X$" Transceiver = "10BaseT" NetworkAddress = "02-00-00-12-34-56" Note: The SMC9000 OS/2 NDIS driver gets the Ethernet Node Address from the card's attribute memory when there is no node address over- ride in the protocol.ini file. If the enabler command line reads DEVICE=C:\SMC\SMCENAB.OS2 /COM=2 /INT=11 /IO=300 /MEM=D8000 then the final configuration would be (for the above example) interrupt 11 IO port 0x300 attribute mem 0xD8000 Node Address 020000123456