card_if.m revision 61779
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 61779 2000-06-18 05:02:09Z 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 6961779Simp# 7061779Simp# pccard bridges call this method to initate the attachment of a card 7161779Simp# 7259193SimpMETHOD int attach_card { 7359193Simp device_t dev; 7459193Simp} 7559193Simp 7661779Simp# 7761779Simp# pccard bridges call this to detach a card. 7861779Simp# 7959193SimpMETHOD int detach_card { 8059193Simp device_t dev; 8159193Simp int flags; 8259193Simp} 8359193Simp 8461779Simp# 8561779Simp# Returns the type of card this is. Maybe we don't need this. 8661779Simp# 8759193SimpMETHOD int get_type { 8859193Simp device_t dev; 8959193Simp int *type; 9059193Simp} 9161779Simp 9261779Simp# 9361779Simp# Returns the function number for this device. 9461779Simp# 9561779SimpMETHOD int get_function { 9661779Simp device_t dev; 9761779Simp device_t child; 9861779Simp int *func; 9961779Simp} 10061779Simp 10161779Simp# 10261779Simp# Activates (and powers up if necessary) the card's nth function 10361779Simp# since each function gets its own device, there is no need to 10461779Simp# to specify a function number 10561779Simp# 10661779SimpMETHOD int activate_function { 10761779Simp device_t dev; 10861779Simp device_t child; 10961779Simp} 11061779Simp 11161779SimpMETHOD int deactivate_function { 11261779Simp device_t dev; 11361779Simp device_t child; 11461779Simp} 115