xref: /freebsd/sys/dev/pccard/pccard_cis.h (revision 59c8e88e72633afbc47a4ace0d2170d00d51f7dc)
1 
2 /*-
3  * SPDX-License-Identifier: BSD-4-Clause
4  *
5  * Copyright (c) 1997 Marc Horowitz.  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 Marc Horowitz.
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  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
26  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
30  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 /*
34  * CIS Tuples */
35 
36 /* Layer 1 Basic Compatibility Tuples */
37 #define	CISTPL_NULL			0x00
38 #define	CISTPL_DEVICE			0x01
39 #define	PCCARD_DTYPE_MASK			0xF0
40 #define	PCCARD_DTYPE_NULL				0x00
41 #define	PCCARD_DTYPE_ROM				0x10
42 #define	PCCARD_DTYPE_OTPROM				0x20
43 #define	PCCARD_DTYPE_EPROM				0x30
44 #define	PCCARD_DTYPE_EEPROM				0x40
45 #define	PCCARD_DTYPE_FLASH				0x50
46 #define	PCCARD_DTYPE_SRAM				0x60
47 #define	PCCARD_DTYPE_DRAM				0x70
48 #define	PCCARD_DTYPE_FUNCSPEC				0xD0
49 #define	PCCARD_DTYPE_EXTEND				0xE0
50 #define	PCCARD_DSPEED_MASK			0x07
51 #define	PCCARD_DSPEED_NULL				0x00
52 #define	PCCARD_DSPEED_250NS				0x01
53 #define	PCCARD_DSPEED_200NS				0x02
54 #define	PCCARD_DSPEED_150NS				0x03
55 #define	PCCARD_DSPEED_100NS				0x04
56 #define	PCCARD_DSPEED_EXT				0x07
57 
58 /*
59  * the 2.1 docs have 0x02-0x07 as reserved, but the linux drivers list the
60  * follwing tuple code values.  I have at least one card (3com 3c562
61  * lan+modem) which has a code 0x06 tuple, so I'm going to assume that these
62  * are for real
63  */
64 
65 #define	CISTPL_LONGLINK_CB		0x02
66 #define	CISTPL_INDIRECT			0x03
67 #define	CISTPL_CONFIG_CB		0x04
68 #define	CISTPL_CFTABLE_ENTRY_CB		0x05
69 #define	CISTPL_LONGLINK_MFC		0x06
70 #define	PCCARD_MFC_MEM_ATTR				0x00
71 #define	PCCARD_MFC_MEM_COMMON				0x01
72 #define	CISTPL_BAR			0x07
73 #define	CISTPL_PWR_MGMNT		0x08
74 #define CISTPL_EXTDEVICE		0x09
75 
76 #define	CISTPL_CHECKSUM			0x10
77 #define	CISTPL_LONGLINK_A		0x11
78 #define	CISTPL_LONGLINK_C		0x12
79 #define	CISTPL_LINKTARGET		0x13
80 #define	CISTPL_NO_LINK			0x14
81 #define	CISTPL_VERS_1			0x15
82 #define	CISTPL_ALTSTR			0x16
83 #define	CISTPL_DEVICE_A			0x17
84 #define	CISTPL_JEDEC_C			0x18
85 #define	CISTPL_JEDEC_A			0x19
86 #define	CISTPL_CONFIG			0x1A
87 #define	PCCARD_TPCC_RASZ_MASK				0x03
88 #define	PCCARD_TPCC_RASZ_SHIFT				0
89 #define	PCCARD_TPCC_RMSZ_MASK				0x3C
90 #define	PCCARD_TPCC_RMSZ_SHIFT				2
91 #define	PCCARD_TPCC_RFSZ_MASK				0xC0
92 #define	PCCARD_TPCC_RFSZ_SHIFT				6
93 #define	CISTPL_CFTABLE_ENTRY		0x1B
94 #define	PCCARD_TPCE_INDX_INTFACE			0x80
95 #define	PCCARD_TPCE_INDX_DEFAULT			0x40
96 #define	PCCARD_TPCE_INDX_NUM_MASK			0x3F
97 #define	PCCARD_TPCE_IF_MWAIT				0x80
98 #define	PCCARD_TPCE_IF_RDYBSY				0x40
99 #define	PCCARD_TPCE_IF_WP				0x20
100 #define	PCCARD_TPCE_IF_BVD				0x10
101 #define	PCCARD_TPCE_IF_IFTYPE				0x0F
102 #define	PCCARD_IFTYPE_MEMORY					0
103 #define	PCCARD_IFTYPE_IO					1
104 #define	PCCARD_TPCE_FS_MISC				0x80
105 #define	PCCARD_TPCE_FS_MEMSPACE_MASK			0x60
106 #define	PCCARD_TPCE_FS_MEMSPACE_NONE				0x00
107 #define	PCCARD_TPCE_FS_MEMSPACE_LENGTH				0x20
108 #define	PCCARD_TPCE_FS_MEMSPACE_LENGTHADDR			0x40
109 #define	PCCARD_TPCE_FS_MEMSPACE_TABLE				0x60
110 #define	PCCARD_TPCE_FS_IRQ				0x10
111 #define	PCCARD_TPCE_FS_IOSPACE				0x08
112 #define	PCCARD_TPCE_FS_TIMING				0x04
113 #define	PCCARD_TPCE_FS_POWER_MASK			0x03
114 #define	PCCARD_TPCE_FS_POWER_NONE				0x00
115 #define	PCCARD_TPCE_FS_POWER_VCC				0x01
116 #define	PCCARD_TPCE_FS_POWER_VCCVPP1				0x02
117 #define	PCCARD_TPCE_FS_POWER_VCCVPP1VPP2			0x03
118 #define	PCCARD_TPCE_TD_RESERVED_MASK			0xE0
119 #define	PCCARD_TPCE_TD_RDYBSY_MASK			0x1C
120 #define	PCCARD_TPCE_TD_WAIT_MASK			0x03
121 #define	PCCARD_TPCE_IO_HASRANGE				0x80
122 #define	PCCARD_TPCE_IO_BUSWIDTH_16BIT			0x40
123 #define	PCCARD_TPCE_IO_BUSWIDTH_8BIT			0x20
124 #define	PCCARD_TPCE_IO_IOADDRLINES_MASK			0x1F
125 #define	PCCARD_TPCE_IO_RANGE_LENGTHSIZE_MASK		0xC0
126 #define	PCCARD_TPCE_IO_RANGE_LENGTHSIZE_NONE			0x00
127 #define	PCCARD_TPCE_IO_RANGE_LENGTHSIZE_ONE			0x40
128 #define	PCCARD_TPCE_IO_RANGE_LENGTHSIZE_TWO			0x80
129 #define	PCCARD_TPCE_IO_RANGE_LENGTHSIZE_FOUR			0xC0
130 #define	PCCARD_TPCE_IO_RANGE_ADDRSIZE_MASK		0x30
131 #define	PCCARD_TPCE_IO_RANGE_ADDRSIZE_NONE			0x00
132 #define	PCCARD_TPCE_IO_RANGE_ADDRSIZE_ONE			0x10
133 #define	PCCARD_TPCE_IO_RANGE_ADDRSIZE_TWO			0x20
134 #define	PCCARD_TPCE_IO_RANGE_ADDRSIZE_FOUR			0x30
135 #define	PCCARD_TPCE_IO_RANGE_COUNT			0x0F
136 #define	PCCARD_TPCE_IR_SHARE				0x80
137 #define	PCCARD_TPCE_IR_PULSE				0x40
138 #define	PCCARD_TPCE_IR_LEVEL				0x20
139 #define	PCCARD_TPCE_IR_HASMASK				0x10
140 #define	PCCARD_TPCE_IR_IRQ				0x0F
141 #define	PCCARD_TPCE_MS_HOSTADDR				0x80
142 #define	PCCARD_TPCE_MS_CARDADDR_SIZE_MASK		0x60
143 #define	PCCARD_TPCE_MS_CARDADDR_SIZE_SHIFT		5
144 #define	PCCARD_TPCE_MS_LENGTH_SIZE_MASK			0x18
145 #define	PCCARD_TPCE_MS_LENGTH_SIZE_SHIFT		3
146 #define	PCCARD_TPCE_MS_COUNT				0x07
147 #define	PCCARD_TPCE_MI_EXT				0x80
148 #define	PCCARD_TPCE_MI_RESERVED				0x40
149 #define	PCCARD_TPCE_MI_PWRDOWN				0x20
150 #define	PCCARD_TPCE_MI_READONLY				0x10
151 #define	PCCARD_TPCE_MI_AUDIO				0x08
152 #define	PCCARD_TPCE_MI_MAXTWINS				0x07
153 #define	CISTPL_DEVICE_OC			0x1C
154 #define	CISTPL_DEVICE_OA			0x1D
155 #define	CISTPL_DEVICE_GEO			0x1E
156 #define	CISTPL_DEVICE_GEO_A			0x1F
157 #define	CISTPL_MANFID				0x20
158 #define	CISTPL_FUNCID				0x21
159 #define	PCCARD_FUNCTION_UNSPEC		-1
160 #define	PCCARD_FUNCTION_MULTIFUNCTION	0
161 #define	PCCARD_FUNCTION_MEMORY		1
162 #define	PCCARD_FUNCTION_SERIAL		2
163 #define	PCCARD_FUNCTION_PARALLEL	3
164 #define	PCCARD_FUNCTION_DISK		4
165 #define	PCCARD_FUNCTION_VIDEO		5
166 #define	PCCARD_FUNCTION_NETWORK		6
167 #define	PCCARD_FUNCTION_AIMS		7
168 #define	PCCARD_FUNCTION_SCSI		8
169 #define	PCCARD_FUNCTION_SECURITY	9
170 #define	PCCARD_FUNCTION_INSTRUMENT	10
171 #define CISTPL_FUNCE				0x22
172 #define	PCCARD_TPLFE_TYPE_LAN_TECH			0x01
173 #define	PCCARD_TPLFE_TYPE_LAN_SPEED			0x02
174 #define	PCCARD_TPLFE_TYPE_LAN_MEDIA			0x03
175 #define	PCCARD_TPLFE_TYPE_LAN_NID			0x04
176 #define	PCCARD_TPLFE_TYPE_LAN_CONN			0x05
177 #define	PCCARD_TPLFE_TYPE_DISK_DEVICE_INTERFACE		0x01
178 #define	PCCARD_TPLFE_DDI_PCCARD_ATA				0x01
179 #define	CISTPL_END				0xFF
180 
181 /* Layer 2 Data Recording Format Tuples */
182 
183 #define	CISTPL_SWIL				0x23
184 /* #define	CISTPL_RESERVED		0x24-0x3F */
185 #define	CISTPL_VERS_2				0x40
186 #define	CISTPL_FORMAT				0x41
187 #define	CISTPL_GEOMETRY				0x42
188 #define	CISTPL_BYTEORDER			0x43
189 #define	CISTPL_DATE				0x44
190 #define	CISTPL_BATTERY				0x45
191 #define	CISTPL_FORAMT_A				0x47
192 
193 /* Layer 3 Data Organization Tuples */
194 
195 #define	CISTPL_ORG				0x46
196 /* #define	CISTPL_RESERVED		0x47-0x7F */
197 
198 /* Layer 4 System-Specific Standard Tuples */
199 
200 /* #define	CISTPL_RESERVED		0x80-0x8F */
201 #define	CISTPL_SPCL				0x90
202 /* #define	CISTPL_RESERVED		0x90-0xFE */
203 
204 #define CISTPL_GENERIC		-1
205