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 follow

ing 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 re

moval. This subcommand corresponds to pccard_beep in rc.conf(5). Al

lowed 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 EEP

ROM of a PCCARD 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 pa

rameters 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 eth

ernet 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 con

troller(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 subcom

mand 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 un

stable 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 sys

tem 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 in

serted).

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 win

dows of a PCCARD slot are mapped to on the host. If slot is not

supplied, it

displays the information for all of slots in the sys

tem.

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 <an

drew@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.

BSD November 14, 1998

BSD