README.TXT file for Lava SETADDR.EXE & SETIRQ.EXE

(c) Copyright 2008 Lava Computer MFG

*** ATTENTION: THIS SOFTWARE INTENDED FOR USE IN DOS ONLY. WILL NOT FUNCTION FROM A COMMAND PROMPT IN WINDOWS 95/98/NT/XP/2000 ETC.

*** THIS SOFTWARE IS PROVIDED AS IS. NO WARRANTIES ARE EXPRESSED OR IMPLIED. USE AT YOUR OWN RISK.

SETADDR.EXE may be used to detect and reset I/O ranges used by a Lava PCI card.
SETIRQ.EXE may be used to reset the IRQ of any PCI card.

**** NOTE:  See end of document for additional information for the SP-PCI.
**** -----

PART 1.	SETADDR.EXE

>>argument<<

syntax:

setaddr (list|set|reg) [location,port[,addr[,name]]] [-v[v[v]]] [-h]

-v 	= verbosity
-vv 	= more verbosity
-vvv	= most verbosity
-h	= help

>>argument<<

list (no arguments required) [-v] [-h]
returns a list of Lava PCI devices found on the local system providing location, port, address, and device type

E.G.
C:>setaddr list
SETADDR v.0.32a -- Copyright (C) 2004 by Lava Computer (www.lavalink.com)
Lava PCI devices:

Location   Port  Address                Device
  0xA0      0    0x2E8         Lava Quattro 550 PCI A/B
  0xA0      1    0x6200        Lava Quattro 550 PCI A/B
  0xA1      0    0x6300        Lava Quattro 550 PCI C/D
  0xA1      1    0x6400        Lava Quattro 550 PCI C/D

The verbose mode switch [-v] also provides detailed information of registered DOS devices and current mappings to legacy I/O ranges.

>>argument<<

set location,port,addr[,name] [-v] [-h]
resets the current address of the port on the Lava card to the address specified where:

location	= current PCI location of the Lava card
port		= current port on the Lava card at the location identified above
addr		= target PCI address of the port on the Lava card (this is the address you want to change to see table below)
name		= device name to register in DOS (COMx or LPTx must be specified for port to function normally)

E.G.
C:>setaddr set 0xA0,1,0x2F8,com4
 will reset port-1 of any Lava card at PCI location 0xA0 to 02f8h and register the DOS name COM4.

>>argument<<

reg addr,name [-v] [-h]
will register the DOS name for the given address without changing the address. This is the safest way to use SETADDR.EXE because it avoids any potential I/O range conflicts. However, few DOS programs actually made calls to the logical name COMx; instead software writers usually made calls directly to the default I/O ranges.

TABLE-1: Typical DOS address ranges
=============================
COM1	03F8h
COM2	02F8h
COM3	03E8h
COM4	02E8h
LPT1	0378h if two printers, 03BCh if three printers
LPT2	0278h if two printers, 0378h if three printers
LPT3	0278h if three printers


PART 2.	SETIRQ.EXE

syntax:
setirq [-v] [-h] [-f] (license|list|set) [link,irq]

-v 	= verbosity
-vv 	= more verbosity
-vvv	= most verbosity
-h	= help
-f	= disable conflict warning

>>argument<<

license (no parameters required)
Displays license terms.

E.G.
C:>setirq license

License:
This utility is Copyright (C) 2004 by Lava Computer MFG Inc.
All rights reserved.
It is distributed WITHOUT ANY WARRANTY. Use at YOUR OWN RISK.
You may use and copy it UNMODIFIED free of charge.

	Lava Computer MFG Inc.
	2 Vulcan St.,
	Toronto, ON,
	M9W 1L2 Canada.
	Tel:+1(416)674-5942,
	Fax:+1(416)674-8262,
	http://www.lavalink.com

>>argument<<

list (no parameters required)
Display list of all PCI devices, its PCI LINK number, its IRQ (interrupt request line), its slot location, and any available IRQs.

E.G.
C:>setirq list

Link IRQ Slot Device name                     Possible IRQ
 60  11    1  Compatible VGA Display          3 4 5 7 9 10 11 12 14 15
 63  12    4  Lava Quattro 550 PCI A/B        3 4 5 7 9 10 11 12 14 15
 63  12    4  Lava Quattro 550 PCI C/D        3 4 5 7 9 10 11 12 14 15

>>argument<<

set link,irq
Resets the IRQ of the Lava card. Requires input of correct LINK number from PCI table and desired IRQ. If the IRQ is already in use, it will return an error unless the -f switch is set.

E.G. 
C:>setirq set 63,9 -f
will reset any PCI card found on PCI Link #60 to use IRQ 9 and will ignore any IRQ conflicts.

Please note, the SETIRQ.EXE program permits resetting the IRQ for any card, not just Lava cards. However, multiple devices found on the same card (probably) use the same IRQ. In such a case, the individual devices cannot be reset to use differing IRQ's. For example, if a Lava DSERIAL-PCI was placed in SLOT2, and the PCI bus assigned LINK #61 and IRQ7, you could not reset the card to have port-A using COM1 IRQ4 and port-B using COM2 IRQ3 (original IBM PC implementation). Both ports on the Lava card must use the same IRQ. This is a hardware requirement of the PCI bus.

SP-PCI Notes:

  Newer SP-PCI cards (P.N. MOKO L87.2_S3) will list as 2 Unknown Lava PCI devices.
  The first will be the Parallel port, the second the serial port.  Rest of configuration goes as normal.
  
  Parallel port example:  setaddr set 0x70,0,0x278,LPT2
  