Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ wdnsetup(ADM) — OpenDesktop 1.1.1g

Media Vault

Software Library

Restoration Projects

Artifacts Sought


     WDNSETUP(ADM)                        UNIX System V


     Name
          wdnsetup - configuration program for WD LAN adapter boards


     Syntax
          wdnsetup [options]


     Description
          wdnsetup configures boards that use the WD83C583, as  listed
          below:

           ⊕   EtherCard PLUS with ROM socket (WD8003EB)

           ⊕   EtherCard Express (WD8023E)

          wdnsetup can be run only by the superuser and should be  run
          only while in single-user mode (see Notes).

          Up to four boards are suppported on the same  bus,  assuming
          that  each  board  uses  a  583,  and  has a unique base I/O
          address.  At power-up, the contents of EEROM are loaded into
          the  internal  registers on the 583.  These registers occupy
          the first 16 I/O addresses starting at the  base  I/O  of  a
          specific board.

          wdnsetup  allows  you  to  display  or  change  the  current
          configuration.    The   configuration   can  be  changed  by
          specifying the options on the command line, or  through  the
          interactive  mode.   You  can  choose  the board you want to
          query or configure by specifying the base I/O address of the
          board, or the node address of the board.


     Options
          The following options are available:

          -io:baseaddress
               specifies base address of the board to be displayed  or
               altered.

          -node:nodeaddress
               specifies node address of the board to be displayed  or
               altered.

          -inter
               specifies interactive  mode.  Each  parameter  and  its
               current value is displayed and prompted for change.

          -newio:baseaddress
               specifies the new base I/O address. Range: 200-3E0  The
               address  baseaddress will be a hex value, and must be a
               multiple of 20 hex.

          -irq:n
               specifies  the  interrupt  level  (IRQ)  that  the  LAN
               adapter  board will use to notify the PC.  The possible
               values of n are 2, 3, 4, and 7 for the old boards.  For
               the new boards : 2, 3, 5, and 7.

          -enairq:x
               specifies whether the interrupt is enabled or disabled.
               Possible values for x are y (yes) and n (no).

          -ram:baseaddress
               specifies the base physical address of  the  on-  board
               memory that is shared with the PC.  The address will be
               a hex address in the range of C0000 - DE000,  and  must
               be on a boundary of the RAM size (that is, it must be a
               multiple of 8K for an 8K RAM).

          -ramsize:n
               specifies  the  size  of  the  RAM  window  in  Kbytes.
               Acceptable  values  for n are 8 or 32.  Note: 32 Kbytes
               is only available on certain custom boards.

          -6mhzat:x
               specifies the type of machine the adapter is installed,
               either  a  6 MHz AT or not.  Possible values of x are y
               (yes) and n (no).

          -rom:baseaddress
               specifies the  base  address  of  the  boot  ROM.   The
               address  will  be  a hex address in the range of C0000-
               DE000, and must be on a boundary of the ROM size.

          -romsize:n
               specifies the size of the ROM  in  Kbytes.   Acceptable
               values for n are 16, 32 or 64.

          -factory
               forces  the  adapter  to  the   factory   configuration
               (overrides   other   command  line  options,  including
               -auto).  Factory defaults are:
                            Base I/O:   240 (hex)
                            IRQ:        3 Disabled
                            RAM:        8K at D0000 (hex)
                            ROM:        Disabled
                            6 Mhz AT:   No

          -auto
               automatically select  a  new  configuration  (overrides
               other command line options, but overridden by - factory
               option).  Auto configuration values are:
                            Base I/O:   280 (hex)
                            IRQ:        3 Enabled
                            RAM:        8K at D0000 (hex)
                            6 Mhz AT:   No

          -v   displays  the  program  name,  version,  and  copyright
               information only.

          -h   displays HELP information (the list  of  valid  command
               line parameters) only.


     Examples
          To display configurations, enter the following:
          wdnsetup
          The program tries to find all 583-based boards (up to  four)
          on  the machine with the range of I/O address 200-3E0 (hex),
          and display each board's configurations.

          To display the configuration of a specific board, enter  the
          following:
          wdnsetup -io:baseaddress [-node:nodeaddress]
          or
          wdnsetup -node:nodeaddres
          The program finds the board with specified base I/O  address
          or node address, and displays its configuration.

          To change the configuration of boards in the  command  mode,
          use:
          wdnsetup -io:baseaddress [-node:nodeaddress] [..] ...
          or
          wdnsetup -node:nodeaddress [..] ...
          The program takes the  options  specified,  prints  out  the
          configuration  to  be  saved  and, if confirmed, changes the
          current configured value.

          To change the configuration of a board  in  the  interactive
          mode, use the following:
          wdnsetup -inter -io:baseaddress [node:nodeaddress]
          or
          wdnsetup -inter -node:nodeaddress

          The program finds the specified board, and goes through each
          option.  The  current  configured  option  is  shown.  If no
          change is to be made, pressing ENTER will leave  the  option
          as is.


     Notes
          wdnsetup should be run only in single user mode because:

           ⊕   it is possible that the  adapter  card  uses  the  same
               address as another device, it might cause unpredictable
               results if the device is being accessed.

           ⊕   wdnsetup uses direct I/O mode to  the  device  and  may
               behave  incorrectly  if  a WD LAN adapter is not at the
               specified address.


     (printed 11/8/90)                              WDNSETUP(ADM)


Typewritten Software • bear@typewritten.org • Edmonds, WA 98026