Home | History | Annotate | Line # | Download | only in cardbus
cardbusvar.h revision 1.28
      1 /*	$NetBSD: cardbusvar.h,v 1.28 2004/08/23 17:52:45 drochner Exp $	*/
      2 
      3 /*
      4  * Copyright (c) 1998, 1999 and 2000
      5  *       HAYAKAWA Koichi.  All rights reserved.
      6  *
      7  * Redistribution and use in source and binary forms, with or without
      8  * modification, are permitted provided that the following conditions
      9  * are met:
     10  * 1. Redistributions of source code must retain the above copyright
     11  *    notice, this list of conditions and the following disclaimer.
     12  * 2. Redistributions in binary form must reproduce the above copyright
     13  *    notice, this list of conditions and the following disclaimer in the
     14  *    documentation and/or other materials provided with the distribution.
     15  * 3. All advertising materials mentioning features or use of this software
     16  *    must display the following acknowledgement:
     17  *	This product includes software developed by the author.
     18  * 4. The name of the author may not be used to endorse or promote products
     19  *    derived from this software without specific prior written permission.
     20  *
     21  *
     22  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
     23  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
     24  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
     25  * DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
     26  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
     27  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
     28  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     29  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     30  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
     31  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     32  * POSSIBILITY OF SUCH DAMAGE.
     33  */
     34 
     35 #ifndef _DEV_CARDBUS_CARDBUSVAR_H_
     36 #define _DEV_CARDBUS_CARDBUSVAR_H_
     37 
     38 #include <dev/cardbus/cardbusreg.h>
     39 #if 1
     40 #include <dev/cardbus/rbus.h>
     41 #endif
     42 
     43 
     44 
     45 typedef void *cardbus_chipset_tag_t;
     46 typedef int cardbus_intr_handle_t;
     47 
     48 
     49 #if rbus
     50 /*
     51  * struct cardbus_functions contains the pointers for basic cardbus
     52  * functions.  Those functions must be provided by cardbus bridge.
     53  * The child devices can use those functions.  The contained functions
     54  * are: cardbus_space_alloc, cardbus_space_free,
     55  * cardbus_intr_establish, cardbus_intr_disestablish, cardbus_ctrl,
     56  * cardbus_power, cardbus_make_tag, cardbus_free_tag and
     57  * cardbus_conf_write.
     58  *
     59  *	int (*cardbus_space_alloc)(cardbus_chipset_tag_t ct, rbus_tag_t rb,
     60  *	    bus_addr_t addr, bus_size_t size,
     61  *	    bus_addr_t mask, bus_size_t align,
     62  *	    int flags, bus_addr_t *addrp,
     63  *	    bus_space_handle_t *bshp);
     64  *
     65  *	int (*cardbus_space_free)(cardbus_chipset_tag_t ct, rbus_tag_t rb,
     66  *	    bus_space_handle_t, bus_size_t);
     67  *
     68  * cardbus_space_alloc and cardbus_space_free allocates and
     69  * disallocate bus space for the requesters.
     70  *
     71  *	void *(*cardbus_intr_establish)(cardbus_chipset_tag_t ct, int irq,
     72  *	     int level, int (*ih)(void *), void *sc);
     73  *
     74  *	void (*cardbus_intr_disestablish)(cardbus_chipset_tag_t ct, void *ih);
     75  *	int (*cardbus_ctrl)(cardbus_chipset_tag_t ct, int command);
     76  *	int (*cardbus_power)(cardbus_chipset_tag_t ct, int voltage);
     77  *
     78  *	cardbustag_t (*cardbus_make_tag)(cardbus_chipset_tag_t ct,
     79  *	    int busno, int devno, int functionno);
     80  *	void (*cardbus_free_tag)(cardbus_chipset_tag_t ct, cardbustag_t tag);
     81  *	cardbusreg_t (*cardbus_conf_read)(cardbus_chipset_tag_t ct,
     82  *	    cardbustag_t tag, int offs);
     83  *	void (*cardbus_conf_write)(cardbus_chipset_tag_t ct,
     84  *	    cardbustag_t tag, int offs, cardbusreg_t val);
     85  */
     86 typedef struct cardbus_functions {
     87 	int (*cardbus_space_alloc) __P((cardbus_chipset_tag_t, rbus_tag_t,
     88 	    bus_addr_t, bus_size_t, bus_addr_t, bus_size_t,
     89 	    int, bus_addr_t *, bus_space_handle_t *));
     90 	int (*cardbus_space_free) __P((cardbus_chipset_tag_t, rbus_tag_t,
     91 	    bus_space_handle_t, bus_size_t));
     92 	void *(*cardbus_intr_establish) __P((cardbus_chipset_tag_t, int, int,
     93 	    int (*)(void *), void *));
     94 	void (*cardbus_intr_disestablish) __P((cardbus_chipset_tag_t, void *));
     95 	int (*cardbus_ctrl) __P((cardbus_chipset_tag_t, int));
     96 	int (*cardbus_power) __P((cardbus_chipset_tag_t, int));
     97 
     98 	cardbustag_t (*cardbus_make_tag) __P((cardbus_chipset_tag_t, int, int,
     99 	    int));
    100 	void (*cardbus_free_tag) __P((cardbus_chipset_tag_t, cardbustag_t));
    101 	cardbusreg_t (*cardbus_conf_read) __P((cardbus_chipset_tag_t,
    102 	    cardbustag_t, int));
    103 	void (*cardbus_conf_write) __P((cardbus_chipset_tag_t, cardbustag_t,
    104 	    int, cardbusreg_t));
    105 } cardbus_function_t, *cardbus_function_tag_t;
    106 
    107 #else
    108 
    109 typedef struct cardbus_functions {
    110 	int (*cardbus_ctrl) __P((cardbus_chipset_tag_t, int));
    111 	int (*cardbus_power) __P((cardbus_chipset_tag_t, int));
    112 	int (*cardbus_mem_open) __P((cardbus_chipset_tag_t, int, u_int32_t,
    113 	    u_int32_t));
    114 	int (*cardbus_mem_close) __P((cardbus_chipset_tag_t, int));
    115 	int (*cardbus_io_open) __P((cardbus_chipset_tag_t, int, u_int32_t,
    116 	    u_int32_t));
    117 	int (*cardbus_io_close) __P((cardbus_chipset_tag_t, int));
    118 	void *(*cardbus_intr_establish) __P((cardbus_chipset_tag_t, int, int,
    119 	    int (*)(void *), void *));
    120 	void (*cardbus_intr_disestablish) __P((cardbus_chipset_tag_t, void *));
    121 
    122 	cardbustag_t (*cardbus_make_tag) __P((cardbus_chipset_tag_t, int, int,
    123 	    int));
    124 	cardbusreg_t (*cardbus_conf_read) __P((cardbus_chipset_tag_t,
    125 	    cardbustag_t, int));
    126 	void (*cardbus_conf_write) __P((cardbus_chipset_tag_t, cardbustag_t,
    127 	    int, cardbusreg_t));
    128 } cardbus_function_t, *cardbus_function_tag_t;
    129 #endif /* rbus */
    130 
    131 /*
    132  * struct cbslot_attach_args is the attach argument for cardbus card.
    133  */
    134 struct cbslot_attach_args {
    135 	char *cba_busname;
    136 	bus_space_tag_t cba_iot;	/* cardbus i/o space tag */
    137 	bus_space_tag_t cba_memt;	/* cardbus mem space tag */
    138 	bus_dma_tag_t cba_dmat;		/* DMA tag */
    139 
    140 	int cba_bus;			/* cardbus bus number */
    141 
    142 	cardbus_chipset_tag_t cba_cc;	/* cardbus chipset */
    143 	cardbus_function_tag_t cba_cf; /* cardbus functions */
    144 	int cba_intrline;		/* interrupt line */
    145 
    146 #if rbus
    147 	rbus_tag_t cba_rbus_iot;	/* CardBus i/o rbus tag */
    148 	rbus_tag_t cba_rbus_memt;	/* CardBus mem rbus tag */
    149 #endif
    150 
    151 	int cba_cacheline;		/* cache line size */
    152 	int cba_lattimer;		/* latency timer */
    153 };
    154 
    155 
    156 #define cbslotcf_dev  cf_loc[0]
    157 #define cbslotcf_func cf_loc[1]
    158 #define CBSLOT_UNK_DEV -1
    159 #define CBSLOT_UNK_FUNC -1
    160 
    161 
    162 struct cardbus_devfunc;
    163 
    164 /*
    165  * struct cardbus_softc is the softc for cardbus card.
    166  */
    167 struct cardbus_softc {
    168 	struct device sc_dev;		/* fundamental device structure */
    169 
    170 	int sc_bus;			/* cardbus bus number */
    171 	int sc_device;			/* cardbus device number */
    172 	int sc_intrline;		/* CardBus intrline */
    173 
    174 	bus_space_tag_t sc_iot;		/* CardBus I/O space tag */
    175 	bus_space_tag_t sc_memt;	/* CardBus MEM space tag */
    176 	bus_dma_tag_t sc_dmat;		/* DMA tag */
    177 
    178 	cardbus_chipset_tag_t sc_cc;	/* CardBus chipset */
    179 	cardbus_function_tag_t sc_cf;	/* CardBus function */
    180 
    181 #if rbus
    182 	rbus_tag_t sc_rbus_iot;		/* CardBus i/o rbus tag */
    183 	rbus_tag_t sc_rbus_memt;	/* CardBus mem rbus tag */
    184 #endif
    185 
    186 	int sc_cacheline;		/* cache line size */
    187 	int sc_lattimer;		/* latency timer */
    188 	int sc_volt;			/* applied Vcc voltage */
    189 #define PCCARD_33V  0x02
    190 #define PCCARD_XXV  0x04
    191 #define PCCARD_YYV  0x08
    192 	int sc_poweron_func;
    193   struct cardbus_devfunc *sc_funcs[8];	/* list of cardbus device functions */
    194 };
    195 
    196 
    197 /*
    198  * struct cardbus_devfunc:
    199  *
    200  *   This is the data deposit for each function of a CardBus device.
    201  *   This structure is used for memory or i/o space allocation and
    202  *   disallocation.
    203  */
    204 typedef struct cardbus_devfunc {
    205 	cardbus_chipset_tag_t ct_cc;
    206 	cardbus_function_tag_t ct_cf;
    207 	struct cardbus_softc *ct_sc;	/* pointer to the parent */
    208 	int ct_bus;			/* bus number */
    209 	int ct_dev;			/* device number */
    210 	int ct_func;			/* function number */
    211 
    212 #if rbus
    213 	rbus_tag_t ct_rbus_iot;		/* CardBus i/o rbus tag */
    214 	rbus_tag_t ct_rbus_memt;	/* CardBus mem rbus tag */
    215 #endif
    216 
    217 	u_int32_t ct_bar[6];		/* Base Address Regs 0 to 6 */
    218 	u_int32_t ct_lc;		/* Latency timer and cache line size */
    219 	/* u_int32_t ct_cisreg; */	/* CIS reg: is it needed??? */
    220 
    221 	struct device *ct_device;	/* pointer to the device */
    222 
    223 	/* some data structure needed for tuple??? */
    224 } *cardbus_devfunc_t;
    225 
    226 
    227 /* XXX various things extracted from CIS */
    228 struct cardbus_cis_info {
    229 	int32_t		manufacturer;
    230 	int32_t		product;
    231 	char		cis1_info_buf[256];
    232 	char*		cis1_info[4];
    233 	struct cb_bar_info {
    234 		unsigned int flags;
    235 		unsigned int size;
    236 	} bar[7];
    237 	unsigned int	funcid;
    238 	union {
    239 		struct {
    240 			int uart_type;
    241 			int uart_present;
    242 		} serial;
    243 		struct {
    244 			char netid[6];
    245 			char netid_present;
    246 			char __filler;
    247 		} network;
    248 	} funce;
    249 };
    250 
    251 struct cardbus_attach_args {
    252 	cardbus_devfunc_t ca_ct;
    253 
    254 	bus_space_tag_t ca_iot;		/* CardBus I/O space tag */
    255 	bus_space_tag_t ca_memt;	/* CardBus MEM space tag */
    256 	bus_dma_tag_t ca_dmat;		/* DMA tag */
    257 
    258 	u_int ca_bus;
    259 	u_int ca_device;
    260 	u_int ca_function;
    261 	cardbustag_t ca_tag;
    262 	cardbusreg_t ca_id;
    263 	cardbusreg_t ca_class;
    264 
    265 	/* interrupt information */
    266 	cardbus_intr_line_t ca_intrline;
    267 
    268 #if rbus
    269 	rbus_tag_t ca_rbus_iot;		/* CardBus i/o rbus tag */
    270 	rbus_tag_t ca_rbus_memt;	/* CardBus mem rbus tag */
    271 #endif
    272 
    273 	struct cardbus_cis_info ca_cis;
    274 };
    275 
    276 
    277 #define CARDBUS_ENABLE  1	/* enable the channel */
    278 #define CARDBUS_DISABLE 2	/* disable the channel */
    279 #define CARDBUS_RESET   4
    280 #define CARDBUS_CD      7
    281 #  define CARDBUS_NOCARD 0
    282 #  define CARDBUS_5V_CARD 0x01	/* XXX: It must not exist */
    283 #  define CARDBUS_3V_CARD 0x02
    284 #  define CARDBUS_XV_CARD 0x04
    285 #  define CARDBUS_YV_CARD 0x08
    286 #define CARDBUS_IO_ENABLE    100
    287 #define CARDBUS_IO_DISABLE   101
    288 #define CARDBUS_MEM_ENABLE   102
    289 #define CARDBUS_MEM_DISABLE  103
    290 #define CARDBUS_BM_ENABLE    104 /* bus master */
    291 #define CARDBUS_BM_DISABLE   105
    292 
    293 #define CARDBUS_VCC_UC  0x0000
    294 #define CARDBUS_VCC_3V  0x0001
    295 #define CARDBUS_VCC_XV  0x0002
    296 #define CARDBUS_VCC_YV  0x0003
    297 #define CARDBUS_VCC_0V  0x0004
    298 #define CARDBUS_VCC_5V  0x0005	/* ??? */
    299 #define CARDBUS_VCCMASK 0x000f
    300 #define CARDBUS_VPP_UC  0x0000
    301 #define CARDBUS_VPP_VCC 0x0010
    302 #define CARDBUS_VPP_12V 0x0030
    303 #define CARDBUS_VPP_0V  0x0040
    304 #define CARDBUS_VPPMASK 0x00f0
    305 
    306 
    307 #include "locators.h"
    308 
    309 /*
    310  * Locators devices that attach to 'cardbus', as specified to config.
    311  */
    312 #define cardbuscf_dev cf_loc[CARDBUSCF_DEV]
    313 #define CARDBUS_UNK_DEV CARDBUSCF_DEV_DEFAULT
    314 
    315 #define cardbuscf_function cf_loc[CARDBUSCF_FUNCTION]
    316 #define CARDBUS_UNK_FUNCTION CARDBUSCF_FUNCTION_DEFAULT
    317 
    318 int cardbus_attach_card __P((struct cardbus_softc *));
    319 void cardbus_detach_card __P((struct cardbus_softc *));
    320 void *cardbus_intr_establish __P((cardbus_chipset_tag_t, cardbus_function_tag_t,
    321     cardbus_intr_handle_t, int, int (*) (void *), void *arg));
    322 void cardbus_intr_disestablish __P((cardbus_chipset_tag_t,
    323     cardbus_function_tag_t, void *));
    324 
    325 int cardbus_mapreg_map __P((struct cardbus_softc *, int, int, cardbusreg_t,
    326     int, bus_space_tag_t *, bus_space_handle_t *, bus_addr_t *, bus_size_t *));
    327 int cardbus_mapreg_unmap __P((struct cardbus_softc *, int, int,
    328     bus_space_tag_t, bus_space_handle_t, bus_size_t));
    329 
    330 int cardbus_save_bar __P((cardbus_devfunc_t));
    331 int cardbus_restore_bar __P((cardbus_devfunc_t));
    332 
    333 int cardbus_function_enable __P((struct cardbus_softc *, int));
    334 int cardbus_function_disable __P((struct cardbus_softc *, int));
    335 
    336 int cardbus_get_capability __P((cardbus_chipset_tag_t, cardbus_function_tag_t,
    337     cardbustag_t, int, int *, cardbusreg_t *));
    338 int cardbus_powerstate __P((cardbus_devfunc_t, pcitag_t, const int *, int *));
    339 int cardbus_setpowerstate __P((const char *, cardbus_devfunc_t, pcitag_t, int));
    340 
    341 #define Cardbus_function_enable(ct) cardbus_function_enable((ct)->ct_sc, (ct)->ct_func)
    342 #define Cardbus_function_disable(ct) cardbus_function_disable((ct)->ct_sc, (ct)->ct_func)
    343 
    344 
    345 
    346 #define Cardbus_mapreg_map(ct, reg, type, busflags, tagp, handlep, basep, sizep) \
    347 	cardbus_mapreg_map((ct)->ct_sc, (ct->ct_func), (reg), (type),\
    348 			   (busflags), (tagp), (handlep), (basep), (sizep))
    349 #define Cardbus_mapreg_unmap(ct, reg, tag, handle, size) \
    350 	cardbus_mapreg_unmap((ct)->ct_sc, (ct->ct_func), (reg), (tag), (handle), (size))
    351 
    352 #define Cardbus_make_tag(ct) (*(ct)->ct_cf->cardbus_make_tag)((ct)->ct_cc, (ct)->ct_bus, (ct)->ct_dev, (ct)->ct_func)
    353 #define cardbus_make_tag(cc, cf, bus, device, function) ((cf)->cardbus_make_tag)((cc), (bus), (device), (function))
    354 
    355 #define Cardbus_free_tag(ct, tag) (*(ct)->ct_cf->cardbus_free_tag)((ct)->ct_cc, (tag))
    356 #define cardbus_free_tag(cc, cf, tag) (*(cf)->cardbus_free_tag)(cc, (tag))
    357 
    358 #define Cardbus_conf_read(ct, tag, offs) (*(ct)->ct_cf->cardbus_conf_read)((ct)->ct_cf, (tag), (offs))
    359 #define cardbus_conf_read(cc, cf, tag, offs) ((cf)->cardbus_conf_read)((cc), (tag), (offs))
    360 #define Cardbus_conf_write(ct, tag, offs, val) (*(ct)->ct_cf->cardbus_conf_write)((ct)->ct_cf, (tag), (offs), (val))
    361 #define cardbus_conf_write(cc, cf, tag, offs, val) ((cf)->cardbus_conf_write)((cc), (tag), (offs), (val))
    362 
    363 #endif /* !_DEV_CARDBUS_CARDBUSVAR_H_ */
    364