d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
6b7ba54456
freebsd-dev/sys/dev/pccard/card_if.m

162 lines
3.7 KiB
Mathematica
Raw Normal View History

Start each of the license/copyright comments with /*-, minor shuffle of lines
2005-01-06 01:43:34 +00:00
#-
Add resource activation routines to pcic driver. Minor cleanup of socket attach code. We now have at least a chance for pccard devices appearing in the future. This is a snapshot of ongoing work. Proceed at your own risk.
1999-11-28 21:11:13 +00:00
# Copyright (c) 1999 M. Warner Losh.
# 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.
#
# 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$
#
Include <sys/bus.h>, which is needed after Doug's latest object changes.
2000-04-16 06:04:13 +00:00
#include <sys/bus.h>
Include required machine/bus.h
2004-05-28 02:23:10 +00:00
#include <machine/bus.h>
Make oldcard and newcard kernel module work.
2002-05-30 17:38:00 +00:00
#include <dev/pccard/pccardvar.h>
Include <sys/bus.h>, which is needed after Doug's latest object changes.
2000-04-16 06:04:13 +00:00
Add resource activation routines to pcic driver. Minor cleanup of socket attach code. We now have at least a chance for pccard devices appearing in the future. This is a snapshot of ongoing work. Proceed at your own risk.
1999-11-28 21:11:13 +00:00
INTERFACE card;
#
# Companion interface for pccard. We need to set attributes for memory
# and i/o port mappings (as well as other types of attributes) that have
# a well defined meaning inside the pccard/cardbus system. The bus
# methods are inadequate for this because this must be done at the time the
# resources are set for the device, which predates their activation. Also,
# the driver activating the resources doesn't necessarily know or need to know
# these attributes.
#
checkpoint latest pccard/pcic hacking: o Eliminate cross calls between the devices. Instead move to using the newbus messaging system. Added three new card calls: attach_card, detach_card, get_type. o Eliminate interrupt routine in pccard we never use. o Move from deactivate to detach for removing cards. o Start mapping CIS memory, but it is broken and causes panics. At least it is closer to working than before. o Eliminate struct device everywhere. It was bogus. o Initialize softc for pccard device so we have valid pointers to ourselves. o Implement routine to find the pcic ivar for a child device of the pccard so we can use it to talk to the pcic hardware. o Lots of minor tiding up. This version now panics when we try to read the CIS. The next batch of work to make this work is what was outlined in my posting to mobile about resource allocation and such.
2000-04-13 06:42:58 +00:00
METHOD int set_res_flags {
Add resource activation routines to pcic driver. Minor cleanup of socket attach code. We now have at least a chance for pccard devices appearing in the future. This is a snapshot of ongoing work. Proceed at your own risk.
1999-11-28 21:11:13 +00:00
device_t dev;
device_t child;
checkpoint latest pccard/pcic hacking: o Eliminate cross calls between the devices. Instead move to using the newbus messaging system. Added three new card calls: attach_card, detach_card, get_type. o Eliminate interrupt routine in pccard we never use. o Move from deactivate to detach for removing cards. o Start mapping CIS memory, but it is broken and causes panics. At least it is closer to working than before. o Eliminate struct device everywhere. It was bogus. o Initialize softc for pccard device so we have valid pointers to ourselves. o Implement routine to find the pcic ivar for a child device of the pccard so we can use it to talk to the pcic hardware. o Lots of minor tiding up. This version now panics when we try to read the CIS. The next batch of work to make this work is what was outlined in my posting to mobile about resource allocation and such.
2000-04-13 06:42:58 +00:00
int restype;
Minor changes to some of the interfaces. Remove RF_PCCARD_ATTR in anticipation of removing it from sys/rman.h Add interface for setting "attributes" of pccard/cardbus devices. Minor formatting nits.
2000-03-26 07:01:52 +00:00
int rid;
checkpoint latest pccard/pcic hacking: o Eliminate cross calls between the devices. Instead move to using the newbus messaging system. Added three new card calls: attach_card, detach_card, get_type. o Eliminate interrupt routine in pccard we never use. o Move from deactivate to detach for removing cards. o Start mapping CIS memory, but it is broken and causes panics. At least it is closer to working than before. o Eliminate struct device everywhere. It was bogus. o Initialize softc for pccard device so we have valid pointers to ourselves. o Implement routine to find the pcic ivar for a child device of the pccard so we can use it to talk to the pcic hardware. o Lots of minor tiding up. This version now panics when we try to read the CIS. The next batch of work to make this work is what was outlined in my posting to mobile about resource allocation and such.
2000-04-13 06:42:58 +00:00
u_long value;
Add resource activation routines to pcic driver. Minor cleanup of socket attach code. We now have at least a chance for pccard devices appearing in the future. This is a snapshot of ongoing work. Proceed at your own risk.
1999-11-28 21:11:13 +00:00
};
checkpoint latest pccard/pcic hacking: o Eliminate cross calls between the devices. Instead move to using the newbus messaging system. Added three new card calls: attach_card, detach_card, get_type. o Eliminate interrupt routine in pccard we never use. o Move from deactivate to detach for removing cards. o Start mapping CIS memory, but it is broken and causes panics. At least it is closer to working than before. o Eliminate struct device everywhere. It was bogus. o Initialize softc for pccard device so we have valid pointers to ourselves. o Implement routine to find the pcic ivar for a child device of the pccard so we can use it to talk to the pcic hardware. o Lots of minor tiding up. This version now panics when we try to read the CIS. The next batch of work to make this work is what was outlined in my posting to mobile about resource allocation and such.
2000-04-13 06:42:58 +00:00
METHOD int get_res_flags {
Add resource activation routines to pcic driver. Minor cleanup of socket attach code. We now have at least a chance for pccard devices appearing in the future. This is a snapshot of ongoing work. Proceed at your own risk.
1999-11-28 21:11:13 +00:00
device_t dev;
device_t child;
checkpoint latest pccard/pcic hacking: o Eliminate cross calls between the devices. Instead move to using the newbus messaging system. Added three new card calls: attach_card, detach_card, get_type. o Eliminate interrupt routine in pccard we never use. o Move from deactivate to detach for removing cards. o Start mapping CIS memory, but it is broken and causes panics. At least it is closer to working than before. o Eliminate struct device everywhere. It was bogus. o Initialize softc for pccard device so we have valid pointers to ourselves. o Implement routine to find the pcic ivar for a child device of the pccard so we can use it to talk to the pcic hardware. o Lots of minor tiding up. This version now panics when we try to read the CIS. The next batch of work to make this work is what was outlined in my posting to mobile about resource allocation and such.
2000-04-13 06:42:58 +00:00
int restype;
Add resource activation routines to pcic driver. Minor cleanup of socket attach code. We now have at least a chance for pccard devices appearing in the future. This is a snapshot of ongoing work. Proceed at your own risk.
1999-11-28 21:11:13 +00:00
int rid;
checkpoint latest pccard/pcic hacking: o Eliminate cross calls between the devices. Instead move to using the newbus messaging system. Added three new card calls: attach_card, detach_card, get_type. o Eliminate interrupt routine in pccard we never use. o Move from deactivate to detach for removing cards. o Start mapping CIS memory, but it is broken and causes panics. At least it is closer to working than before. o Eliminate struct device everywhere. It was bogus. o Initialize softc for pccard device so we have valid pointers to ourselves. o Implement routine to find the pcic ivar for a child device of the pccard so we can use it to talk to the pcic hardware. o Lots of minor tiding up. This version now panics when we try to read the CIS. The next batch of work to make this work is what was outlined in my posting to mobile about resource allocation and such.
2000-04-13 06:42:58 +00:00
u_long *value;
Add resource activation routines to pcic driver. Minor cleanup of socket attach code. We now have at least a chance for pccard devices appearing in the future. This is a snapshot of ongoing work. Proceed at your own risk.
1999-11-28 21:11:13 +00:00
};
checkpoint latest pccard/pcic hacking: o Eliminate cross calls between the devices. Instead move to using the newbus messaging system. Added three new card calls: attach_card, detach_card, get_type. o Eliminate interrupt routine in pccard we never use. o Move from deactivate to detach for removing cards. o Start mapping CIS memory, but it is broken and causes panics. At least it is closer to working than before. o Eliminate struct device everywhere. It was bogus. o Initialize softc for pccard device so we have valid pointers to ourselves. o Implement routine to find the pcic ivar for a child device of the pccard so we can use it to talk to the pcic hardware. o Lots of minor tiding up. This version now panics when we try to read the CIS. The next batch of work to make this work is what was outlined in my posting to mobile about resource allocation and such.
2000-04-13 06:42:58 +00:00
Add new functions. Also add comments to existing functions. These are needed for the pccard changes I've just committed.
2000-06-18 05:02:09 +00:00
#
# Sets the memory offset of the pccard bridge's window into attribute
# or common memory space.
#
checkpoint latest pccard/pcic hacking: o Eliminate cross calls between the devices. Instead move to using the newbus messaging system. Added three new card calls: attach_card, detach_card, get_type. o Eliminate interrupt routine in pccard we never use. o Move from deactivate to detach for removing cards. o Start mapping CIS memory, but it is broken and causes panics. At least it is closer to working than before. o Eliminate struct device everywhere. It was bogus. o Initialize softc for pccard device so we have valid pointers to ourselves. o Implement routine to find the pcic ivar for a child device of the pccard so we can use it to talk to the pcic hardware. o Lots of minor tiding up. This version now panics when we try to read the CIS. The next batch of work to make this work is what was outlined in my posting to mobile about resource allocation and such.
2000-04-13 06:42:58 +00:00
METHOD int set_memory_offset {
device_t dev;
device_t child;
Non-functional changes to NEWCARD stuff. This is the first part of a two-part update to NEWCARD. Changes in this commit are non-functional, and includes the following: * indentation and other changes to meet style(9). * other minor style consistancy changes * addition of comments * renaming of device_t variables to be consistant across all of NEWCARD. (note that not all style violations are fixed in this commit -- those that aren't will be clobbered by the next commit.)
2001-08-26 23:56:49 +00:00
int rid;
u_intXX_t -> uintXX_t
2005-01-24 06:48:26 +00:00
uint32_t cardaddr;
uint32_t *deltap;
checkpoint latest pccard/pcic hacking: o Eliminate cross calls between the devices. Instead move to using the newbus messaging system. Added three new card calls: attach_card, detach_card, get_type. o Eliminate interrupt routine in pccard we never use. o Move from deactivate to detach for removing cards. o Start mapping CIS memory, but it is broken and causes panics. At least it is closer to working than before. o Eliminate struct device everywhere. It was bogus. o Initialize softc for pccard device so we have valid pointers to ourselves. o Implement routine to find the pcic ivar for a child device of the pccard so we can use it to talk to the pcic hardware. o Lots of minor tiding up. This version now panics when we try to read the CIS. The next batch of work to make this work is what was outlined in my posting to mobile about resource allocation and such.
2000-04-13 06:42:58 +00:00
}
Define get_memory_offset method
2000-08-11 15:51:51 +00:00
METHOD int get_memory_offset {
device_t dev;
device_t child;
Non-functional changes to NEWCARD stuff. This is the first part of a two-part update to NEWCARD. Changes in this commit are non-functional, and includes the following: * indentation and other changes to meet style(9). * other minor style consistancy changes * addition of comments * renaming of device_t variables to be consistant across all of NEWCARD. (note that not all style violations are fixed in this commit -- those that aren't will be clobbered by the next commit.)
2001-08-26 23:56:49 +00:00
int rid;
u_intXX_t -> uintXX_t
2005-01-24 06:48:26 +00:00
uint32_t *offset;
Define get_memory_offset method
2000-08-11 15:51:51 +00:00
}
Add new functions. Also add comments to existing functions. These are needed for the pccard changes I've just committed.
2000-06-18 05:02:09 +00:00
#
# pccard bridges call this method to initate the attachment of a card
#
checkpoint latest pccard/pcic hacking: o Eliminate cross calls between the devices. Instead move to using the newbus messaging system. Added three new card calls: attach_card, detach_card, get_type. o Eliminate interrupt routine in pccard we never use. o Move from deactivate to detach for removing cards. o Start mapping CIS memory, but it is broken and causes panics. At least it is closer to working than before. o Eliminate struct device everywhere. It was bogus. o Initialize softc for pccard device so we have valid pointers to ourselves. o Implement routine to find the pcic ivar for a child device of the pccard so we can use it to talk to the pcic hardware. o Lots of minor tiding up. This version now panics when we try to read the CIS. The next batch of work to make this work is what was outlined in my posting to mobile about resource allocation and such.
2000-04-13 06:42:58 +00:00
METHOD int attach_card {
device_t dev;
}
Add new functions. Also add comments to existing functions. These are needed for the pccard changes I've just committed.
2000-06-18 05:02:09 +00:00
#
# pccard bridges call this to detach a card.
#
checkpoint latest pccard/pcic hacking: o Eliminate cross calls between the devices. Instead move to using the newbus messaging system. Added three new card calls: attach_card, detach_card, get_type. o Eliminate interrupt routine in pccard we never use. o Move from deactivate to detach for removing cards. o Start mapping CIS memory, but it is broken and causes panics. At least it is closer to working than before. o Eliminate struct device everywhere. It was bogus. o Initialize softc for pccard device so we have valid pointers to ourselves. o Implement routine to find the pcic ivar for a child device of the pccard so we can use it to talk to the pcic hardware. o Lots of minor tiding up. This version now panics when we try to read the CIS. The next batch of work to make this work is what was outlined in my posting to mobile about resource allocation and such.
2000-04-13 06:42:58 +00:00
METHOD int detach_card {
device_t dev;
Oops, broke newcard because I forgot to commit this in my last round of changes to pccbb.c
2000-11-28 15:50:13 +00:00
}
Eliminate the need for pccard_common.c by moving the function inline in the .h file. Make it static __inline to make sure that it doesn't wind up defined in any files. Also, fix a typo that said null_do_attach instead of null_do_probe.
2002-07-17 05:20:43 +00:00
#
# Find "dev" in the passed table of devices. Return it or NULL.
#
Make oldcard and newcard kernel module work.
2002-05-30 17:38:00 +00:00
METHOD struct pccard_product * do_product_lookup {
device_t bus;
device_t dev;
const struct pccard_product *tab;
size_t ent_size;
pccard_product_match_fn matchfn;
}
Eliminate the need for pccard_common.c by moving the function inline in the .h file. Make it static __inline to make sure that it doesn't wind up defined in any files. Also, fix a typo that said null_do_attach instead of null_do_probe.
2002-07-17 05:20:43 +00:00
Implement indirection in the pccard probe/attach. This should make it possible to have different probe/attach semantics between the two systems and yet still use the same driver for both. Compatibility methods for OLDCARD drivers. We use these routines to make it possible to call the OLDCARD driver's probe routine in the context that it expects. For OLDCARD these are implemented as pass throughs to the device_{probe,attach} routines. For NEWCARD they are implemented such such that probe becomes strictly a matching routine and attach does both the old probe and old attach. compat devices should use the following: /* Device interface */ DEVMETHOD(device_probe), pccard_compat_probe), DEVMETHOD(device_attach), pccard_compat_attach), /* Card interface */ DEVMETHOD(card_compat_match, foo_match), /* newly written */ DEVMETHOD(card_compat_probe, foo_probe), /* old probe */ DEVMETHOD(card_compat_attach, foo_attach), /* old attach */ This will allow a single driver binary image to be used for both OLDCARD and NEWCARD. Drivers wishing to not retain OLDCARD compatibility needn't do this. ep driver minorly updated. sn driver updated more than minorly. Add module dependencies to allow module to load. Also change name to if_sn. Add some debugging code. attempt to fix the cannot allocate memory problem I'd been seeing. Minor formatting nits.
2000-09-19 04:39:20 +00:00
#
# Helper method for the above. When a compatibility driver is converted,
# one must write a match routine. This routine is unused on OLDCARD but
# is used as a discriminator for NEWCARD.
#
METHOD int compat_match {
device_t dev;
}
Add a much-requested feature: The ability for pccard attachments to scan the CIS for interesting tuples. 95% of what can be obtained from the CIS is harvested by the pccard layer and presented to the user in standard function calls. However, there are special needs at times where the standard stuff doesn't suffice. This is for those special cases. CARD_SCAN_CIS(device_get_parent(dev), function, argp) scans the CIS of the card, passing each tuple to function with the tuple and argp as its arguments. Returning 0 continues the scan, while returning 1 terminates the scan. The value of the last invocation of function is returned from this function. int (*pccard_scan_t)(struct pccard_tuple *tuple, void *argp) function called for each tuple. Elements of the CIS tuple can be read with pccard_tuple_read_{1,2,3,4,n}(). You are reading the actual tuple memory each time, in case your card has registers in the CIS. # I suppose these things should be documented in pccard(4) or something like # that. # I plan on unifying cardbus CIS support in a similar way. Approved by: re (scottl)
2005-07-01 03:40:28 +00:00
#
# Scanning function for accessing the CIS of a card in its driver.
#
METHOD int cis_scan {
device_t bus;
Add a few new functions interfaces to allow reading/writing attribute memory, the CCR and a tweak to cis_scan.
2005-09-13 17:56:36 +00:00
device_t dev;
Add a much-requested feature: The ability for pccard attachments to scan the CIS for interesting tuples. 95% of what can be obtained from the CIS is harvested by the pccard layer and presented to the user in standard function calls. However, there are special needs at times where the standard stuff doesn't suffice. This is for those special cases. CARD_SCAN_CIS(device_get_parent(dev), function, argp) scans the CIS of the card, passing each tuple to function with the tuple and argp as its arguments. Returning 0 continues the scan, while returning 1 terminates the scan. The value of the last invocation of function is returned from this function. int (*pccard_scan_t)(struct pccard_tuple *tuple, void *argp) function called for each tuple. Elements of the CIS tuple can be read with pccard_tuple_read_{1,2,3,4,n}(). You are reading the actual tuple memory each time, in case your card has registers in the CIS. # I suppose these things should be documented in pccard(4) or something like # that. # I plan on unifying cardbus CIS support in a similar way. Approved by: re (scottl)
2005-07-01 03:40:28 +00:00
pccard_scan_t fnp;
void *argp;
};
Add a few new functions interfaces to allow reading/writing attribute memory, the CCR and a tweak to cis_scan.
2005-09-13 17:56:36 +00:00
#
# Convenience function to read attribute memory.
#
METHOD int attr_read {
device_t bus;
device_t dev;
uint32_t offset;
uint8_t *val;
}
#
# Convenience function to write attribute memory.
#
METHOD int attr_write {
device_t bus;
device_t dev;
uint32_t offset;
uint8_t val;
}
#
# Read the CCR register
#
METHOD int ccr_read {
device_t bus;
device_t dev;
uint32_t offset;
uint8_t *val;
}
#
# Write the CCR register
#
METHOD int ccr_write {
device_t bus;
device_t dev;
uint32_t offset;
uint8_t val;
}
Reference in New Issue Copy Permalink