freebsd-dev/stand/common/isapnp.h
2017-11-14 23:02:19 +00:00

308 lines
10 KiB
C

/*
* Copyright (c) 1996, Sujal M. Patel
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* 3. All advertising materials mentioning features or use of this software
* must display the following acknowledgement:
* This product includes software developed by Sujal M. Patel
* 4. Neither the name of the author nor the names of any co-contributors
* may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*
* $FreeBSD$
*/
#ifndef _I386_ISA_PNP_H_
#define _I386_ISA_PNP_H_
/* Maximum Number of PnP Devices. 8 should be plenty */
#define MAX_PNP_CARDS 8
/*
* the following is the maximum number of PnP Logical devices that
* userconfig can handle.
*/
#define MAX_PNP_LDN 20
/* Static ports to access PnP state machine */
#ifndef _KERNEL
#define _PNP_ADDRESS 0x279
#define _PNP_WRITE_DATA 0xa79
#endif
/* PnP Registers. Write to ADDRESS and then use WRITE/READ_DATA */
#define SET_RD_DATA 0x00
/***
Writing to this location modifies the address of the port used for
reading from the Plug and Play ISA cards. Bits[7:0] become I/O
read port address bits[9:2]. Reads from this register are ignored.
***/
#define SERIAL_ISOLATION 0x01
/***
A read to this register causes a Plug and Play cards in the Isolation
state to compare one bit of the boards ID.
This register is read only.
***/
#define CONFIG_CONTROL 0x02
/***
Bit[2] Reset CSN to 0
Bit[1] Return to the Wait for Key state
Bit[0] Reset all logical devices and restore configuration
registers to their power-up values.
A write to bit[0] of this register performs a reset function on
all logical devices. This resets the contents of configuration
registers to their default state. All card's logical devices
enter their default state and the CSN is preserved.
A write to bit[1] of this register causes all cards to enter the
Wait for Key state but all CSNs are preserved and logical devices
are not affected.
A write to bit[2] of this register causes all cards to reset their
CSN to zero .
This register is write-only. The values are not sticky, that is,
hardware will automatically clear them and there is no need for
software to clear the bits.
***/
#define WAKE 0x03
/***
A write to this port will cause all cards that have a CSN that
matches the write data[7:0] to go from the Sleep state to the either
the Isolation state if the write data for this command is zero or
the Config state if the write data is not zero. Additionally, the
pointer to the byte-serial device is reset. This register is
writeonly.
***/
#define RESOURCE_DATA 0x04
/***
A read from this address reads the next byte of resource information.
The Status register must be polled until bit[0] is set before this
register may be read. This register is read only.
***/
#define STATUS 0x05
/***
Bit[0] when set indicates it is okay to read the next data byte
from the Resource Data register. This register is readonly.
***/
#define SET_CSN 0x06
/***
A write to this port sets a card's CSN. The CSN is a value uniquely
assigned to each ISA card after the serial identification process
so that each card may be individually selected during a Wake[CSN]
command. This register is read/write.
***/
#define SET_LDN 0x07
/***
Selects the current logical device. All reads and writes of memory,
I/O, interrupt and DMA configuration information access the registers
of the logical device written here. In addition, the I/O Range
Check and Activate commands operate only on the selected logical
device. This register is read/write. If a card has only 1 logical
device, this location should be a read-only value of 0x00.
***/
/*** addresses 0x08 - 0x1F Card Level Reserved for future use ***/
/*** addresses 0x20 - 0x2F Card Level, Vendor Defined ***/
#define ACTIVATE 0x30
/***
For each logical device there is one activate register that controls
whether or not the logical device is active on the ISA bus. Bit[0],
if set, activates the logical device. Bits[7:1] are reserved and
must return 0 on reads. This is a read/write register. Before a
logical device is activated, I/O range check must be disabled.
***/
#define IO_RANGE_CHECK 0x31
/***
This register is used to perform a conflict check on the I/O port
range programmed for use by a logical device.
Bit[7:2] Reserved and must return 0 on reads
Bit[1] Enable I/O Range check, if set then I/O Range Check
is enabled. I/O range check is only valid when the logical
device is inactive.
Bit[0], if set, forces the logical device to respond to I/O reads
of the logical device's assigned I/O range with a 0x55 when I/O
range check is in operation. If clear, the logical device drives
0xAA. This register is read/write.
***/
/*** addr 0x32 - 0x37 Logical Device Control Reserved for future use ***/
/*** addr 0x38 - 0x3F Logical Device Control Vendor Define ***/
#define MEM_CONFIG 0x40
/***
Four memory resource registers per range, four ranges.
Fill with 0 if no ranges are enabled.
Offset 0: RW Memory base address bits[23:16]
Offset 1: RW Memory base address bits[15:8]
Offset 2: Memory control
Bit[1] specifies 8/16-bit control. This bit is set to indicate
16-bit memory, and cleared to indicate 8-bit memory.
Bit[0], if cleared, indicates the next field can be used as a range
length for decode (implies range length and base alignment of memory
descriptor are equal).
Bit[0], if set, indicates the next field is the upper limit for
the address. - - Bit[0] is read-only.
Offset 3: RW upper limit or range len, bits[23:16]
Offset 4: RW upper limit or range len, bits[15:8]
Offset 5-Offset 7: filler, unused.
***/
#define IO_CONFIG_BASE 0x60
/***
Eight ranges, two bytes per range.
Offset 0: I/O port base address bits[15:8]
Offset 1: I/O port base address bits[7:0]
***/
#define IRQ_CONFIG 0x70
/***
Two entries, two bytes per entry.
Offset 0: RW interrupt level (1..15, 0=unused).
Offset 1: Bit[1]: level(1:hi, 0:low),
Bit[0]: type (1:level, 0:edge)
byte 1 can be readonly if 1 type of int is used.
***/
#define DRQ_CONFIG 0x74
/***
Two entries, one byte per entry. Bits[2:0] select
which DMA channel is in use for DMA 0. Zero selects DMA channel
0, seven selects DMA channel 7. DMA channel 4, the cascade channel
is used to indicate no DMA channel is active.
***/
/*** 32-bit memory accesses are at 0x76 ***/
/* Macros to parse Resource IDs */
#define PNP_RES_TYPE(a) (a >> 7)
#define PNP_SRES_NUM(a) (a >> 3)
#define PNP_SRES_LEN(a) (a & 0x07)
#define PNP_LRES_NUM(a) (a & 0x7f)
/* Small Resource Item names */
#define PNP_VERSION 0x1
#define LOG_DEVICE_ID 0x2
#define COMP_DEVICE_ID 0x3
#define IRQ_FORMAT 0x4
#define DMA_FORMAT 0x5
#define START_DEPEND_FUNC 0x6
#define END_DEPEND_FUNC 0x7
#define IO_PORT_DESC 0x8
#define FIXED_IO_PORT_DESC 0x9
#define SM_RES_RESERVED 0xa-0xd
#define SM_VENDOR_DEFINED 0xe
#define END_TAG 0xf
/* Large Resource Item names */
#define MEMORY_RANGE_DESC 0x1
#define ID_STRING_ANSI 0x2
#define ID_STRING_UNICODE 0x3
#define LG_VENDOR_DEFINED 0x4
#define _32BIT_MEM_RANGE_DESC 0x5
#define _32BIT_FIXED_LOC_DESC 0x6
#define LG_RES_RESERVED 0x7-0x7f
/*
* pnp_cinfo contains Configuration Information. They are used
* to communicate to the device driver the actual configuration
* of the device, and also by the userconfig menu to let the
* operating system override any configuration set by the bios.
*
*/
struct pnp_cinfo {
u_int vendor_id; /* board id */
u_int serial; /* Board's Serial Number */
u_long flags; /* OS-reserved flags */
u_char csn; /* assigned Card Select Number */
u_char ldn; /* Logical Device Number */
u_char enable; /* pnp enable */
u_char override; /* override bios parms (in userconfig) */
u_char irq[2]; /* IRQ Number */
u_char irq_type[2]; /* IRQ Type */
u_char drq[2];
u_short port[8]; /* The Base Address of the Port */
struct {
u_long base; /* Memory Base Address */
int control; /* Memory Control Register */
u_long range; /* Memory Range *OR* Upper Limit */
} mem[4];
};
#ifdef _KERNEL
struct pnp_device {
char *pd_name;
char * (*pd_probe ) (u_long csn, u_long vendor_id);
void (*pd_attach ) (u_long csn, u_long vend_id, char * name,
struct isa_device *dev);
u_long *pd_count;
u_int *imask ;
};
struct _pnp_id {
u_long vendor_id;
u_long serial;
u_char checksum;
} ;
struct pnp_dlist_node {
struct pnp_device *pnp;
struct isa_device dev;
struct pnp_dlist_node *next;
};
typedef struct _pnp_id pnp_id;
extern struct pnp_dlist_node *pnp_device_list;
extern pnp_id pnp_devices[MAX_PNP_CARDS];
extern struct pnp_cinfo pnp_ldn_overrides[MAX_PNP_LDN];
extern int pnp_overrides_valid;
/*
* these two functions are for use in drivers
*/
int read_pnp_parms(struct pnp_cinfo *d, int ldn);
int write_pnp_parms(struct pnp_cinfo *d, int ldn);
int enable_pnp_card(void);
/*
* used by autoconfigure to actually probe and attach drivers
*/
void pnp_configure(void);
#endif /* _KERNEL */
#endif /* !_I386_ISA_PNP_H_ */