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