Date: Sat, 24 Apr 1999 11:13:30 +0900 From: Jun Kuriyama <kuriyama@sky.rim.or.jp> To: FreeBSD Mobile <freebsd-mobile@FreeBSD.ORG> Subject: Re: First draft of pccardc.8 Message-ID: <372128CA.8B00E7E9@sky.rim.or.jp> References: <372121F9.D6256518@sky.rim.or.jp>
next in thread | previous in thread | raw e-mail | index | archive | help
This is a multi-part message in MIME format.
--------------F889854A684D3E7EA1DE99E6
Content-Type: text/plain; charset=iso-2022-jp
Content-Transfer-Encoding: 7bit
Jun Kuriyama wrote:
> Can someone review this?
I don't know why I can mistake like this. :-) File is attached, now.
--
Jun Kuriyama // kuriyama@sky.rim.or.jp
// kuriyama@FreeBSD.ORG
--------------F889854A684D3E7EA1DE99E6
Content-Type: text/plain; charset=iso-2022-jp; name="pccardc.8"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline; filename="pccardc.8"
.\"
.\" Copyright (c) 1998 Toshihiko ARAI <toshi@jp.FreeBSD.org>
.\" 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. The name of the author may not be used to endorse or promote products
.\" derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 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.
.\"
.\" Translated to English by Hiroki Sato <hrs@geocities.co.jp>
.\"
.\" $Id: pccardc.8,v 1.1 1999/04/17 11:12:47 kuriyama Exp $
.\"
.Dd November 14, 1998
.Dt PCCARDC 8
.Os FreeBSD
.Sh NAME
.Nm pccardc
.Nd PC-CARD (PCMCIA) management and monitoring tool
.Sh SYNOPSIS
.Nm pccardc Ar subcommand
.Op Ar arg ...
.Sh DESCRIPTION
.Nm
controls PC-CARD slots, configures and displays information about PCMCIA cards.
The features of
.Nm
follow:
.Bd -literal
Subcommands:
beep : Beep type
dumpcis : Prints CIS for all cards
enabler : Device driver enabler
help : Prints command summary
pccardmem : Allocate memory for pccard driver
rdattr : Read attribute memory
rdmap : Read pcic mappings
rdreg : Read pcic register
wrattr : Write byte to attribute memory
wrreg : Write pcic register
.Ed
.Bl -enum
.It
.Nm beep Ar 0|1|2
.Pp
specifies sound at a card insertion or removal.
This corresponds to pccard_beep in
.Xr rc.conf 5 .
.Pp
.Bl -tag -width Ds -compact
.It Ar 0
silent mode
.It Ar 1
simple beep mode
.It Ar 2
melody mode
.El
.It
.Nm dumpcis
.Op Ar slot
.Pp
displays
.Em CIS
(Card Information Structure) tuple in EEPROM of a PC-CARD card.
Slots to read can be specified in
.Ar slot
option. When no option supplied, it displays
all of the available cards in the slots.
.It
.Nm enabler Ar slot driver
.Op Fl m Ar card addr size
.Op Fl a Ar iobase
.Op Fl i Ar irq
.Pp
This is "point enabler" that can set
parameters manually in order to enable a card, when
.Xr pccardd 8
cannot allocate drivers to a PC-CARD card properly.
Specify a PC-CARD slot in
.Ar slot
and a device name in
.Ar driver .
It probably needs some following options together.
.Bl -tag -width Ds
.It Fl m Ar card addr size
maps shared-memory window of the card to host address.
.Ar card
is start address of shared-memory (hex),
.Ar addr
is address mapped to host-side (hex) and
.Ar size
is size of memory window (Kb).
.It Fl a Ar iobase
.Ar iobase
specifies port number mapped to I/O window(hex)
.It Fl i Ar irq
.Ar irq
specifies an IRQ used by an interruption from a card.
Set an unused IRQ(between 1 and 15).
.Pp
Example: enabler 0 ed0 -m 2000 d4000 16 -a 300 -i 3
.El
.Pp
This probably has enabled to use some unrecognized cards with broken CIS tuple,
and also useful for testing a card that has not reported yet.
However, be careful that it frequently cannot manage to recognize it properly.
.It
.Nm help
.Pp
print help this command.
.It
.Nm pccardmem Ar addr
.Pp
specifies host address using PC-CARD controller(PCIC) as scratch-memory.
Because PCIC needs continuous 16KB memory area,
you can use following four addresses only.
.Pp
.Bl -tag -width 0xd0000 -compact
.It Ar 0xd0000
0xd0000-0xd3fff (default)
.It Ar 0xd4000
0xd4000-0xd7fff
.It Ar 0xd8000
0xd8000-0xdbfff
.It Ar 0xdc000
0xdc000-0xdffff
.El
.Pp
You can write "DEFAULT" as 0xd0000.
This feature corresponds to pccard_mem in
.Xr rc.conf 5 .
.It
.Nm rdattr Ar slot offs length
.Pp
print hexdump of the card's EEPROM in the slot specified in
.Ar slot .
An offset address from the top and length in byte are specified in
.Ar offs
(hex) and
.Ar length
(hex).
.It
.Nm rdmap
.Op Ar slot
.Pp
displays the configuration for PC-CARD slots, that are
eight shared-memories and two addresses of I/O window mapped to the host.
When
.Ar slot
option does not supplied, it displays information of all of slots in the system.
.It
.Nm rdreg
.Op Ar slot
.Pp
displays 64 registers of a PC-CARD slot.
When
.Ar slot
option does not supplied, it displays information of all of slots in the system.
.It
.Nm wrattr Ar slot offs value
.Pp
writes 1-byte to the card's EEPROM at
an offset address from the top specified in
.Ar offs
(hex),
with a value specified in
.Ar value
(hex).
This is preserved after the card is removed.
.It
.Nm wrreg Ar slot reg value
.Pp
writes a register of a PC-CARD slot.
Specify a PC-CARD slot in
.Ar slot ,
a register number in
.Ar reg
(hex) and
a value in
.Ar value
(hex).
.El
.Pp
.Sh FILES
.Bl -tag -width /etc/rc.conf -compact
.It Pa /etc/rc.conf
configuration file
.El
.Sh SEE ALSO
.Xr rc.conf 5 ,
.Xr pccardd 8
.Sh AUTHORS
Original version was written by
.An Andrew McRae Aq andrew@mega.com.au .
.An Tatsumi Hosokawa Aq hosokawa@mt.cs.keio.ac.jp
fixed bugs and added some features.
.Sh BUGS
Have a enough care of using
.Nm enabler
and
.Nm wrattr .
It is possible that
they make the system instable or damage the card.
--------------F889854A684D3E7EA1DE99E6--
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-mobile" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?372128CA.8B00E7E9>