PCCARDC(8) MidnightBSD System Manager’s Manual PCCARDC(8)

NAME

pccardc — PC-CARD (PCMCIA) management and monitoring tool

SYNOPSIS

pccardc subcommand [arg ...]

DESCRIPTION

The pccardc utility controls PC-CARD slots and configures and displays information about PCMCIA cards. It understands the following subcommands:

beep

Set beep type

dumpcis

Print card CIS(s)

dumpcisfile

Print card CIS(s) from files

enabler

Device driver enabler

help

Print command summary

pccardmem

Allocate memory for pccard driver

power

Power on/off slots and leaves them disabled

rdattr

Read attribute memory

rdmap

Read pcic mappings

rdreg

Read pcic register

wrattr

Write byte to attribute memory

wrreg

Write pcic register

1.

beep beep_mode

Specifies the sound made upon card insertion or removal. This subcommand corresponds to pccard_beep in rc.conf(5). Allowed values for beep_mode are:

0

silent mode

1

simple beep mode

2

melody mode

2.

dumpcis [slot]

Displays CIS (Card Information Structure) tuple in EEPROM of a PC-CARD card. Slot specifies which slot to read. When no option is supplied, it displays the CIS of all of the available cards.

3.

dumpcisfile file ...

Displays CIS(s) in the same format as dumpcis, but does so using one or more files as the input CIS data instead of physical PC-CARD cards.

4.

enabler slot driver [−m card addr size] [−a iobase] [−i irq]

This is a "point enabler" which can be used to set parameters manually to enable a card when pccardd(8) cannot allocate drivers to a PC-CARD card properly. Specify a PC-CARD slot in slot and a device name (such as "ed0" or "sio2") in driver, along with some or all of the following options:

−m card addr size

maps the shared-memory window of the card to host address. card is the starting address of shared-memory (hex) in the card’s address space, addr is the address (hex) to map the memory to in the computer’s address space, and size is the size of memory window (kb).

−a iobase

iobase specifies the port a number to be mapped to the I/O window (hex)

−i irq

irq specifies the IRQ (decimal from 1 to 15) the card will use for interrupts.

For example,

enabler 0 ed0 -m 2000 d4000 16 -a 300 -i 3

assigns the card in slot zero to the first NE2000 ethernet card driver at port 0x300 and IRQ 3, mapping the 16KB memory region at 0x2000 in the card to 0xd4000.

This allows use of some unrecognized cards with broken CIS tuples, and is also useful for testing a card that has not yet reported. However, beware that it frequently cannot recognize new cards properly.

5.

help

Prints help for pccardc.

6.

pccardmem addr

Specifies the host address using PC-CARD controller(PCIC) will use to map cards to. Because the PCIC needs a contiguous 16KB memory, and most machines have other ROMs or devices at other places in the ISA I/O memory address range, generally you can only use the following four addresses:

0xd0000

0xd0000-0xd3fff (default)

0xd4000

0xd4000-0xd7fff

0xd8000

0xd8000-0xdbfff

0xdc000

0xdc000-0xdffff

You can use "DEFAULT" instead of 0xd0000. This subcommand corresponds to pccard_mem in rc.conf(5).

7.

power slot power_mode

Changes the state of the power supply of the card in the specified slot:

0

Turn off a power supply. If a card becomes unstable when it is removed at activate state, this can force it into inactive state first and remove it safely. The slot will remain disabled until you eject the card with the system running or reenable the card with another pccardc power power command. The slot will even remain disabled when you suspend and resume the computer.

1

Turn on a power supply and set it into active state (the system treats the card as if it was just inserted).

8.

rdattr slot offs length

Prints a hex dump length bytes long of the EEPROM of the card in slot slot starting at offs. All parameters are in hex.

9.

rdmap [slot]

Displays where the four memory windows and two I/O windows of a PC-CARD slot are mapped to on the host. If slot is not supplied, it displays the information for all of slots in the system.

10.

rdreg [slot]

Displays the 64 registers of the card in slot (all slots by default).

11.

wrattr slot offs value

Writes a single byte to the card’s EEPROM at an offset address from the top specified in offs (hex), with a value specified in value (hex). This is preserved after the card is removed.

12.

wrreg slot reg value

Writes a register of a PC-CARD. Specify a PC-CARD slot number in slot, a register number in reg (hex) and a value in value (hex).

FILES
/etc/rc.conf

configuration file

SEE ALSO

rc.conf(5), pccardd(8)

AUTHORS

The original version was written by Andrew McRae 〈andrew@mega.com.au〉. Tatsumi Hosokawa 〈hosokawa@mt.cs.keio.ac.jp〉 fixed bugs and added some features. This man page was written by Toshihiko ARAI 〈toshi@jp.FreeBSD.org〉.

BUGS

Be careful when using enabler and wrattr. Misuse can make the system unstable or damage the card.

MidnightBSD 0.3 November 14, 1998 MidnightBSD 0.3