xref: /freebsd/sys/dev/firewire/iec13213.h (revision 77b7cdf1999ee965ad494fddd184b18f532ac91a)
1 /*
2  * Copyright (c) 2003 Hidetoshi Shimokawa
3  * Copyright (c) 1998-2002 Katsushi Kobayashi and Hidetoshi Shimokawa
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  * 3. All advertising materials mentioning features or use of this software
15  *    must display the acknowledgement as bellow:
16  *
17  *    This product includes software developed by K. Kobayashi and H. Shimokawa
18  *
19  * 4. The name of the author may not be used to endorse or promote products
20  *    derived from this software without specific prior written permission.
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  * $FreeBSD$
35  *
36  */
37 
38 #define	STATE_CLEAR	0x0000
39 #define	STATE_SET	0x0004
40 #define	NODE_IDS	0x0008
41 #define	RESET_START	0x000c
42 #define	SPLIT_TIMEOUT_HI	0x0018
43 #define	SPLIT_TIMEOUT_LO	0x001c
44 #define	CYCLE_TIME	0x0200
45 #define	BUS_TIME	0x0204
46 #define	BUSY_TIMEOUT	0x0210
47 #define	PRIORITY_BUDGET 0x0218
48 #define	BUS_MGR_ID	0x021c
49 #define	BANDWIDTH_AV	0x0220
50 #define	CHANNELS_AV_HI	0x0224
51 #define	CHANNELS_AV_LO	0x0228
52 #define	IP_CHANNELS	0x0234
53 
54 #define	CONF_ROM	0x0400
55 
56 #define	TOPO_MAP	0x1000
57 #define	SPED_MAP	0x2000
58 
59 #define CSRTYPE_SHIFT	6
60 #define CSRTYPE_MASK	(3 << CSRTYPE_SHIFT)
61 #define CSRTYPE_I	(0 << CSRTYPE_SHIFT) /* Immediate */
62 #define CSRTYPE_C	(1 << CSRTYPE_SHIFT) /* CSR offset */
63 #define CSRTYPE_L	(2 << CSRTYPE_SHIFT) /* Leaf */
64 #define CSRTYPE_D	(3 << CSRTYPE_SHIFT) /* Directory */
65 
66 #define CSRKEY_MASK	0x3f
67 #define CSRKEY_DESC	0x01 /* Descriptor */
68 #define CSRKEY_BDINFO	0x02 /* Bus_Dependent_Info */
69 #define CSRKEY_VENDOR	0x03 /* Vendor */
70 #define CSRKEY_HW	0x04 /* Hardware_Version */
71 #define CSRKEY_MODULE	0x07 /* Module */
72 #define CSRKEY_NCAP	0x0c /* Node_Capabilities */
73 #define CSRKEY_EUI64	0x0d /* EUI_64 */
74 #define CSRKEY_UNIT	0x11 /* Unit */
75 #define CSRKEY_SPEC	0x12 /* Specifier_ID */
76 #define CSRKEY_VER	0x13 /* Version */
77 #define CSRKEY_DINFO	0x14 /* Dependent_Info */
78 #define CSRKEY_ULOC	0x15 /* Unit_Location */
79 #define CSRKEY_MODEL	0x17 /* Model */
80 #define CSRKEY_INST	0x18 /* Instance */
81 #define CSRKEY_KEYW	0x19 /* Keyword */
82 #define CSRKEY_FEAT	0x1a /* Feature */
83 #define CSRKEY_EROM	0x1b /* Extended_ROM */
84 #define CSRKEY_EKSID	0x1c /* Extended_Key_Specifier_ID */
85 #define CSRKEY_EKEY	0x1d /* Extended_Key */
86 #define CSRKEY_EDATA	0x1e /* Extended_Data */
87 #define CSRKEY_MDESC	0x1f /* Modifiable_Descriptor */
88 #define CSRKEY_DID	0x20 /* Directory_ID */
89 #define CSRKEY_REV	0x21 /* Revision */
90 
91 #define CSRKEY_FIRM_VER	0x3c /* Firemware version */
92 #define CSRKEY_UNIT_CH	0x3a /* Unit characteristics */
93 #define CSRKEY_COM_SPEC	0x38 /* Command set revision */
94 #define CSRKEY_COM_SET	0x39 /* Command set */
95 
96 #define CROM_UDIR	(CSRTYPE_D | CSRKEY_UNIT)  /* 0x81 Unit directory */
97 #define CROM_TEXTLEAF	(CSRTYPE_L | CSRKEY_DESC)  /* 0x81 Text leaf */
98 #define CROM_LUN	(CSRTYPE_I | CSRKEY_DINFO) /* 0x14 Logical unit num. */
99 #define CROM_MGM	(CSRTYPE_C | CSRKEY_DINFO) /* 0x54 Management agent */
100 
101 #define CSRVAL_1394TA	0x00a02d
102 #define CSRVAL_ANSIT10	0x00609e
103 #define CSRVAL_IETF	0x00005e
104 
105 #define CSR_PROTAVC	0x010001
106 #define CSR_PROTCAL	0x010002
107 #define CSR_PROTEHS	0x010004
108 #define CSR_PROTHAVI	0x010008
109 #define CSR_PROTCAM104	0x000100
110 #define CSR_PROTCAM120	0x000101
111 #define CSR_PROTCAM130	0x000102
112 #define CSR_PROTDPP	0x0a6be2
113 #define CSR_PROTIICP	0x4b661f
114 
115 #define CSRVAL_T10SBP2	0x010483
116 #define CSRVAL_SCSI	0x0104d8
117 
118 struct csrreg {
119 #if BYTE_ORDER == BIG_ENDIAN
120 	u_int32_t key:8,
121 		  val:24;
122 #else
123 	u_int32_t val:24,
124 		  key:8;
125 #endif
126 };
127 struct csrhdr {
128 #if BYTE_ORDER == BIG_ENDIAN
129 	u_int32_t info_len:8,
130 		  crc_len:8,
131 		  crc:16;
132 #else
133 	u_int32_t crc:16,
134 		  crc_len:8,
135 		  info_len:8;
136 #endif
137 };
138 struct csrdirectory {
139 	BIT16x2(crc_len, crc);
140 	struct csrreg entry[0];
141 };
142 struct csrtext {
143 	BIT16x2(crc_len, crc);
144 #if BYTE_ORDER == BIG_ENDIAN
145 	u_int32_t spec_type:8,
146 		  spec_id:24;
147 #else
148 	u_int32_t spec_id:24,
149 		  spec_type:8;
150 #endif
151 	u_int32_t lang_id;
152 	u_int32_t text[0];
153 };
154 
155 struct bus_info {
156 #define	CSR_BUS_NAME_IEEE1394	0x31333934
157 	u_int32_t bus_name;
158 	u_int32_t link_spd:3,
159 		  :1,
160 		  generation:4,
161 #define MAXROM_4	0
162 #define MAXROM_64	1
163 #define MAXROM_1024	2
164 		  max_rom:2,
165 		  :2,
166 		  max_rec:4,		/* (2 << max_rec) bytes */
167 		  cyc_clk_acc:8,	/* 0 <= ppm <= 100 */
168 		  :3,
169 		  pmc:1,		/* power manager capable */
170 		  bmc:1,		/* bus manager capable */
171 		  isc:1,		/* iso. operation support */
172 		  cmc:1,		/* cycle master capable */
173 		  irmc:1;		/* iso. resource manager capable */
174 	struct fw_eui64 eui64;
175 };
176 
177 #define CROM_MAX_DEPTH	10
178 struct crom_ptr {
179 	struct csrdirectory *dir;
180 	int index;
181 };
182 
183 struct crom_context {
184 	int depth;
185 	struct crom_ptr stack[CROM_MAX_DEPTH];
186 };
187 
188 void crom_init_context(struct crom_context *, u_int32_t *);
189 struct csrreg *crom_get(struct crom_context *);
190 void crom_next(struct crom_context *);
191 void crom_parse_text(struct crom_context *, char *, int);
192 u_int16_t crom_crc(u_int32_t *r, int);
193 struct csrreg *crom_search_key(struct crom_context *, u_int8_t);
194 int crom_has_specver(u_int32_t *, u_int32_t, u_int32_t);
195 
196 #ifndef _KERNEL
197 char *crom_desc(struct crom_context *, char *, int);
198 #endif
199 
200 /* For CROM build */
201 #if defined(_KERNEL) || defined(TEST)
202 #define CROM_MAX_CHUNK_LEN 20
203 struct crom_src {
204 	struct csrhdr hdr;
205 	struct bus_info businfo;
206 	STAILQ_HEAD(, crom_chunk) chunk_list;
207 };
208 
209 struct crom_chunk {
210 	STAILQ_ENTRY(crom_chunk) link;
211 	struct crom_chunk *ref_chunk;
212 	int ref_index;
213 	int offset;
214 	struct {
215 			u_int32_t crc:16,
216 				  crc_len:16;
217 			u_int32_t buf[CROM_MAX_CHUNK_LEN];
218 	} data;
219 };
220 
221 extern int crom_add_quad(struct crom_chunk *, u_int32_t);
222 extern int crom_add_entry(struct crom_chunk *, int, int);
223 extern int crom_add_chunk(struct crom_src *src, struct crom_chunk *,
224 					struct crom_chunk *, int);
225 extern int crom_add_simple_text(struct crom_src *src, struct crom_chunk *,
226 					struct crom_chunk *, char *);
227 extern int crom_load(struct crom_src *, u_int32_t *, int);
228 #endif
229