card_if.m revision 66058
153855Simp# 253855Simp# Copyright (c) 1999 M. Warner Losh. 353855Simp# All rights reserved. 453855Simp# 553855Simp# Redistribution and use in source and binary forms, with or without 653855Simp# modification, are permitted provided that the following conditions 753855Simp# are met: 853855Simp# 1. Redistributions of source code must retain the above copyright 953855Simp# notice, this list of conditions and the following disclaimer. 1053855Simp# 2. Redistributions in binary form must reproduce the above copyright 1153855Simp# notice, this list of conditions and the following disclaimer in the 1253855Simp# documentation and/or other materials provided with the distribution. 1353855Simp# 1453855Simp# THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 1553855Simp# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 1653855Simp# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 1753855Simp# ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 1853855Simp# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 1953855Simp# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 2053855Simp# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 2153855Simp# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 2253855Simp# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 2353855Simp# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 2453855Simp# SUCH DAMAGE. 2553855Simp# 2653855Simp# $FreeBSD: head/sys/dev/pccard/card_if.m 66058 2000-09-19 04:39:20Z imp $ 2753855Simp# 2853855Simp 2959272Simp#include <sys/bus.h> 3059272Simp 3153855SimpINTERFACE card; 3253855Simp 3353855Simp# 3453855Simp# Companion interface for pccard. We need to set attributes for memory 3553855Simp# and i/o port mappings (as well as other types of attributes) that have 3653855Simp# a well defined meaning inside the pccard/cardbus system. The bus 3753855Simp# methods are inadequate for this because this must be done at the time the 3853855Simp# resources are set for the device, which predates their activation. Also, 3953855Simp# the driver activating the resources doesn't necessarily know or need to know 4053855Simp# these attributes. 4153855Simp# 4259193SimpMETHOD int set_res_flags { 4353855Simp device_t dev; 4453855Simp device_t child; 4559193Simp int restype; 4658581Simp int rid; 4759193Simp u_long value; 4853855Simp}; 4953855Simp 5059193SimpMETHOD int get_res_flags { 5153855Simp device_t dev; 5253855Simp device_t child; 5359193Simp int restype; 5453855Simp int rid; 5559193Simp u_long *value; 5653855Simp}; 5759193Simp 5861779Simp# 5961779Simp# Sets the memory offset of the pccard bridge's window into attribute 6061779Simp# or common memory space. 6161779Simp# 6259193SimpMETHOD int set_memory_offset { 6359193Simp device_t dev; 6459193Simp device_t child; 6559193Simp int rid; 6659193Simp u_int32_t offset; 6759193Simp} 6859193Simp 6964544SimpMETHOD int get_memory_offset { 7064544Simp device_t dev; 7164544Simp device_t child; 7264544Simp int rid; 7364544Simp u_int32_t *offset; 7464544Simp} 7564544Simp 7661779Simp# 7761779Simp# pccard bridges call this method to initate the attachment of a card 7861779Simp# 7959193SimpMETHOD int attach_card { 8059193Simp device_t dev; 8159193Simp} 8259193Simp 8361779Simp# 8461779Simp# pccard bridges call this to detach a card. 8561779Simp# 8659193SimpMETHOD int detach_card { 8759193Simp device_t dev; 8859193Simp int flags; 8959193Simp} 9059193Simp 9161779Simp# 9261779Simp# Returns the type of card this is. Maybe we don't need this. 9361779Simp# 9459193SimpMETHOD int get_type { 9559193Simp device_t dev; 9659193Simp int *type; 9759193Simp} 9861779Simp 9961779Simp# 10061779Simp# Returns the function number for this device. 10161779Simp# 10261779SimpMETHOD int get_function { 10361779Simp device_t dev; 10461779Simp device_t child; 10561779Simp int *func; 10661779Simp} 10761779Simp 10861779Simp# 10961779Simp# Activates (and powers up if necessary) the card's nth function 11061779Simp# since each function gets its own device, there is no need to 11161779Simp# to specify a function number 11261779Simp# 11361779SimpMETHOD int activate_function { 11461779Simp device_t dev; 11561779Simp device_t child; 11661779Simp} 11761779Simp 11861779SimpMETHOD int deactivate_function { 11961779Simp device_t dev; 12061779Simp device_t child; 12161779Simp} 12266058Simp 12366058Simp# 12466058Simp# Compatibility methods for OLDCARD drivers. We use these routines to make 12566058Simp# it possible to call the OLDCARD driver's probe routine in the context that 12666058Simp# it expects. For OLDCARD these are implemented as pass throughs to the 12766058Simp# device_{probe,attach} routines. For NEWCARD they are implemented such 12866058Simp# such that probe becomes strictly a matching routine and attach does both 12966058Simp# the old probe and old attach. 13066058Simp# 13166058Simp# compat devices should use the following: 13266058Simp# 13366058Simp# /* Device interface */ 13466058Simp# DEVMETHOD(device_probe), pccard_compat_probe), 13566058Simp# DEVMETHOD(device_attach), pccard_compat_attach), 13666058Simp# /* Card interface */ 13766058Simp# DEVMETHOD(card_compat_match, foo_match), /* newly written */ 13866058Simp# DEVMETHOD(card_compat_probe, foo_probe), /* old probe */ 13966058Simp# DEVMETHOD(card_compat_attach, foo_attach), /* old attach */ 14066058Simp# 14166058Simp# This will allow a single driver binary image to be used for both 14266058Simp# OLDCARD and NEWCARD. 14366058Simp# 14466058Simp# Drivers wishing to not retain OLDCARD compatibility needn't do this. 14566058Simp# 14666058SimpMETHOD int compat_probe { 14766058Simp device_t dev; 14866058Simp} 14966058Simp 15066058SimpMETHOD int compat_attach { 15166058Simp device_t dev; 15266058Simp} 15366058Simp 15466058Simp# 15566058Simp# Helper method for the above. When a compatibility driver is converted, 15666058Simp# one must write a match routine. This routine is unused on OLDCARD but 15766058Simp# is used as a discriminator for NEWCARD. 15866058Simp# 15966058SimpMETHOD int compat_match { 16066058Simp device_t dev; 16166058Simp} 162