User guide

1
Installing and Configuring Enhanced OS-9
Enhanced OS-9 for X86 PCAT 79
OS9 Software Configuration
Configuring PnP Firmware
The OS9 sp8900 driver will use the PnP (Plug and Play) capability of
the cs8900a. This will only be used if it is enabled in the OS9 device
descriptor. When enabled the OS9 driver will search all possible I/O
locations for a cs8900a device. If found, the first one, starting at the
lowest valid I/O address, will be used. The software will confirm that the
EEPROM is present. The OS9 driver extracts the necessary
configuration details from this device and initializes the cs8900a.
Configuring OS9 Descriptors
The OS9 device descriptor allows the user to override the PnP default
configuration. At this time only a subset of all the possible configuration
parameters may be overridden. To change the PnP values the following
fields must be modified. This should be performed using a text editor
and the OS9 tools provided within the Microware Hawk package.
Once modified the descriptor should be regenerated and tested.
Device Descriptor Fields
The standard device descriptor is as follows. This file may be found in
.../MWOS/OS9000/<processor>/PORTS/<port>/SPF/SP8900/DEFS/spf_desc.h
#define SPF_DIR_NONE0xFF
#define SPF_DIR_IN0x00
#define SPF_DIR_OUT0x01
#include <SPF/item.h>
#ifdef spcs0
/*** Device Descriptor for SPF 8900 ethernet driver */
#define PNPON 1 /* do plug and play */
#define PNPOFF 0 /* Use descriptor values ( see manual ) */
/**************************************************************************
* User configuration defines
/**************************************************************************
* Port configuration defines */
/* Macros that initialize device descriptor common fields */
/* 300/320/340/360 */
#define PORTADDR0x300/* Base address of hardware */
#define LUN0x7F/* logical unit number */