SECTION 5
Communications and Device Support
5-18 PEN*KEY
R
6200/6300 Hand-Held Computer Programmer’s Reference Guide
Using PKODI.COM as an NDIS Driver
There is another MAC driver standard called
NDIS
. This standard, developed
by Microsoft and 3COM, is typically used by Microsoft and IBM network
software products, such as LAN Manager, Windows for Workgroups, IBM PC
Support, and some TCP/IP networking packages.
An NDISĆtoĆODI shim is available; this shim is called ODINSUP.DOS. This is
an NDIS driver that runs over an ODI driver instead of talking to hardware
directly.
When to Use a Shim
Most networking products support one of the three major MAC driver
specifications: ODI, Packet, and NDIS. Preferably, use the ODI driver directly if
the networking software can interface with ODI drivers.
If the network software requires a driver type other than ODI, you must install
the appropriate shim. If the software can use either packet drivers or NDIS
drivers, use the ODIPKT shim instead of the ODINSUP shim: ODIPKT has
proven to be simpler to install and more reliable (thus far).
Configuration
ODI drivers are configured by a NET.CFG file. This file contains configuration
strings for each network software component. Each component has its own
section in the NET.CFG file for its configuration strings.
Standard configuration strings for ODI MAC drivers are documented in
Appendix F of the Novell
DOS ODI Developer Guide
. Other Novell user guides
also document the strings.
The PKODI driver should be able to install on a PEN*KEY system with no
configuration settings needed since it defaults to PEN*KEY hardware settings.
However, the following example NET.CFG section shows common standard
configuration settings as well as settings that are specific to the PKODI driver.
These entries are defined by Novell. Enable as many as you need. Lines
starting with #" are comments.
NET.CFG:
Link driver PKODI
Identifies PKODI driver section of NET.CFG
INT 7
. . .
Sets IRQ level to use
PORT 360
. . .
Sets I/O base address in hexadecimal
DMA 3
. . .
Sets DMA channel number to use
# NODE ADDRESS
00001A180EDD
Overrides hardware Ethernet ID
# NODE ADDRESS
00001A180EDDM
Ethernet ID override (noncanonical bit order)
Frame Ethernet_II
#Frame Ethernet_802.2
#Frame Ethernet_SNAP
#Frame Ethernet_802.3
#AudioOn
Turns on audio alerts for various types of driver activity. For debug purposes
only as it does degrade performance!
#NoAPM
Disables APM support for the Ethernet controller. It is for debug purposes only
and does disable Suspend/Resume support. Note this entry also triggers the
NoMediaCheck" entry below.
#NoMediaCheck
Disables media detection, so Ethernet controller is left in a powered state.
Never use this unless you are testing on a hub that does not correctly
implement the 10BASEĆT link pulses. This entry does not need to be included
if the NoAPM" switch is specified.
5. Communications
and Device Support
