1 /***********************license start***************
2  * Author: Cavium Networks
3  *
4  * Contact: support@caviumnetworks.com
5  * This file is part of the OCTEON SDK
6  *
7  * Copyright (c) 2003-2009 Cavium Networks
8  *
9  * This file is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License, Version 2, as
11  * published by the Free Software Foundation.
12  *
13  * This file is distributed in the hope that it will be useful, but
14  * AS-IS and WITHOUT ANY WARRANTY; without even the implied warranty
15  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, TITLE, or
16  * NONINFRINGEMENT.  See the GNU General Public License for more
17  * details.
18  *
19  * You should have received a copy of the GNU General Public License
20  * along with this file; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
22  * or visit http://www.gnu.org/licenses/.
23  *
24  * This file may also be available under a different license from Cavium.
25  * Contact Cavium Networks for more information
26  ***********************license end**************************************/
27 
28 /**
29  * Typedefs and defines for working with Octeon physical addresses.
30  *
31  */
32 #ifndef __CVMX_ADDRESS_H__
33 #define __CVMX_ADDRESS_H__
34 
35 #if 0
36 typedef enum {
37 	CVMX_MIPS_SPACE_XKSEG = 3LL,
38 	CVMX_MIPS_SPACE_XKPHYS = 2LL,
39 	CVMX_MIPS_SPACE_XSSEG = 1LL,
40 	CVMX_MIPS_SPACE_XUSEG = 0LL
41 } cvmx_mips_space_t;
42 #endif
43 
44 typedef enum {
45 	CVMX_MIPS_XKSEG_SPACE_KSEG0 = 0LL,
46 	CVMX_MIPS_XKSEG_SPACE_KSEG1 = 1LL,
47 	CVMX_MIPS_XKSEG_SPACE_SSEG = 2LL,
48 	CVMX_MIPS_XKSEG_SPACE_KSEG3 = 3LL
49 } cvmx_mips_xkseg_space_t;
50 
51 /* decodes <14:13> of a kseg3 window address */
52 typedef enum {
53 	CVMX_ADD_WIN_SCR = 0L,
54 	/* see cvmx_add_win_dma_dec_t for further decode */
55 	CVMX_ADD_WIN_DMA = 1L,
56 	CVMX_ADD_WIN_UNUSED = 2L,
57 	CVMX_ADD_WIN_UNUSED2 = 3L
58 } cvmx_add_win_dec_t;
59 
60 /* decode within DMA space */
61 typedef enum {
62 	/*
63 	 * Add store data to the write buffer entry, allocating it if
64 	 * necessary.
65 	 */
66 	CVMX_ADD_WIN_DMA_ADD = 0L,
67 	/* send out the write buffer entry to DRAM */
68 	CVMX_ADD_WIN_DMA_SENDMEM = 1L,
69 	/* store data must be normal DRAM memory space address in this case */
70 	/* send out the write buffer entry as an IOBDMA command */
71 	CVMX_ADD_WIN_DMA_SENDDMA = 2L,
72 	/* see CVMX_ADD_WIN_DMA_SEND_DEC for data contents */
73 	/* send out the write buffer entry as an IO write */
74 	CVMX_ADD_WIN_DMA_SENDIO = 3L,
75 	/* store data must be normal IO space address in this case */
76 	/* send out a single-tick command on the NCB bus */
77 	CVMX_ADD_WIN_DMA_SENDSINGLE = 4L,
78 	/* no write buffer data needed/used */
79 } cvmx_add_win_dma_dec_t;
80 
81 /*
82  *   Physical Address Decode
83  *
84  * Octeon-I HW never interprets this X (<39:36> reserved
85  * for future expansion), software should set to 0.
86  *
87  *  - 0x0 XXX0 0000 0000 to	 DRAM	      Cached
88  *  - 0x0 XXX0 0FFF FFFF
89  *
90  *  - 0x0 XXX0 1000 0000 to	 Boot Bus     Uncached	(Converted to 0x1 00X0 1000 0000
91  *  - 0x0 XXX0 1FFF FFFF	 + EJTAG			   to 0x1 00X0 1FFF FFFF)
92  *
93  *  - 0x0 XXX0 2000 0000 to	 DRAM	      Cached
94  *  - 0x0 XXXF FFFF FFFF
95  *
96  *  - 0x1 00X0 0000 0000 to	 Boot Bus     Uncached
97  *  - 0x1 00XF FFFF FFFF
98  *
99  *  - 0x1 01X0 0000 0000 to	 Other NCB    Uncached
100  *  - 0x1 FFXF FFFF FFFF	 devices
101  *
102  * Decode of all Octeon addresses
103  */
104 typedef union {
105 
106 	uint64_t u64;
107 #ifdef __BIG_ENDIAN_BITFIELD
108 	/* mapped or unmapped virtual address */
109 	struct {
110 		uint64_t R:2;
111 		uint64_t offset:62;
112 	} sva;
113 
114 	/* mapped USEG virtual addresses (typically) */
115 	struct {
116 		uint64_t zeroes:33;
117 		uint64_t offset:31;
118 	} suseg;
119 
120 	/* mapped or unmapped virtual address */
121 	struct {
122 		uint64_t ones:33;
123 		uint64_t sp:2;
124 		uint64_t offset:29;
125 	} sxkseg;
126 
127 	/*
128 	 * physical address accessed through xkphys unmapped virtual
129 	 * address.
130 	 */
131 	struct {
132 		uint64_t R:2;	/* CVMX_MIPS_SPACE_XKPHYS in this case */
133 		uint64_t cca:3; /* ignored by octeon */
134 		uint64_t mbz:10;
135 		uint64_t pa:49; /* physical address */
136 	} sxkphys;
137 
138 	/* physical address */
139 	struct {
140 		uint64_t mbz:15;
141 		/* if set, the address is uncached and resides on MCB bus */
142 		uint64_t is_io:1;
143 		/*
144 		 * the hardware ignores this field when is_io==0, else
145 		 * device ID.
146 		 */
147 		uint64_t did:8;
148 		/* the hardware ignores <39:36> in Octeon I */
149 		uint64_t unaddr:4;
150 		uint64_t offset:36;
151 	} sphys;
152 
153 	/* physical mem address */
154 	struct {
155 		/* technically, <47:40> are dont-cares */
156 		uint64_t zeroes:24;
157 		/* the hardware ignores <39:36> in Octeon I */
158 		uint64_t unaddr:4;
159 		uint64_t offset:36;
160 	} smem;
161 
162 	/* physical IO address */
163 	struct {
164 		uint64_t mem_region:2;
165 		uint64_t mbz:13;
166 		/* 1 in this case */
167 		uint64_t is_io:1;
168 		/*
169 		 * The hardware ignores this field when is_io==0, else
170 		 * device ID.
171 		 */
172 		uint64_t did:8;
173 		/* the hardware ignores <39:36> in Octeon I */
174 		uint64_t unaddr:4;
175 		uint64_t offset:36;
176 	} sio;
177 
178 	/*
179 	 * Scratchpad virtual address - accessed through a window at
180 	 * the end of kseg3
181 	 */
182 	struct {
183 		uint64_t ones:49;
184 		/* CVMX_ADD_WIN_SCR (0) in this case */
185 		cvmx_add_win_dec_t csrdec:2;
186 		uint64_t addr:13;
187 	} sscr;
188 
189 	/* there should only be stores to IOBDMA space, no loads */
190 	/*
191 	 * IOBDMA virtual address - accessed through a window at the
192 	 * end of kseg3
193 	 */
194 	struct {
195 		uint64_t ones:49;
196 		uint64_t csrdec:2;	/* CVMX_ADD_WIN_DMA (1) in this case */
197 		uint64_t unused2:3;
198 		uint64_t type:3;
199 		uint64_t addr:7;
200 	} sdma;
201 
202 	struct {
203 		uint64_t didspace:24;
204 		uint64_t unused:40;
205 	} sfilldidspace;
206 #else
207 	struct {
208 		uint64_t offset:62;
209 		uint64_t R:2;
210 	} sva;
211 
212 	struct {
213 		uint64_t offset:31;
214 		uint64_t zeroes:33;
215 	} suseg;
216 
217 	struct {
218 		uint64_t offset:29;
219 		uint64_t sp:2;
220 		uint64_t ones:33;
221 	} sxkseg;
222 
223 	struct {
224 		uint64_t pa:49;
225 		uint64_t mbz:10;
226 		uint64_t cca:3;
227 		uint64_t R:2;
228 	} sxkphys;
229 
230 	struct {
231 		uint64_t offset:36;
232 		uint64_t unaddr:4;
233 		uint64_t did:8;
234 		uint64_t is_io:1;
235 		uint64_t mbz:15;
236 	} sphys;
237 
238 	struct {
239 		uint64_t offset:36;
240 		uint64_t unaddr:4;
241 		uint64_t zeroes:24;
242 	} smem;
243 
244 	struct {
245 		uint64_t offset:36;
246 		uint64_t unaddr:4;
247 		uint64_t did:8;
248 		uint64_t is_io:1;
249 		uint64_t mbz:13;
250 		uint64_t mem_region:2;
251 	} sio;
252 
253 	struct {
254 		uint64_t addr:13;
255 		cvmx_add_win_dec_t csrdec:2;
256 		uint64_t ones:49;
257 	} sscr;
258 
259 	struct {
260 		uint64_t addr:7;
261 		uint64_t type:3;
262 		uint64_t unused2:3;
263 		uint64_t csrdec:2;
264 		uint64_t ones:49;
265 	} sdma;
266 
267 	struct {
268 		uint64_t unused:40;
269 		uint64_t didspace:24;
270 	} sfilldidspace;
271 #endif
272 
273 } cvmx_addr_t;
274 
275 /* These macros for used by 32 bit applications */
276 
277 #define CVMX_MIPS32_SPACE_KSEG0 1l
278 #define CVMX_ADD_SEG32(segment, add) \
279 	(((int32_t)segment << 31) | (int32_t)(add))
280 
281 /*
282  * Currently all IOs are performed using XKPHYS addressing. Linux uses
283  * the CvmMemCtl register to enable XKPHYS addressing to IO space from
284  * user mode.  Future OSes may need to change the upper bits of IO
285  * addresses. The following define controls the upper two bits for all
286  * IO addresses generated by the simple executive library.
287  */
288 #define CVMX_IO_SEG CVMX_MIPS_SPACE_XKPHYS
289 
290 /* These macros simplify the process of creating common IO addresses */
291 #define CVMX_ADD_SEG(segment, add) ((((uint64_t)segment) << 62) | (add))
292 #ifndef CVMX_ADD_IO_SEG
293 #define CVMX_ADD_IO_SEG(add) CVMX_ADD_SEG(CVMX_IO_SEG, (add))
294 #endif
295 #define CVMX_ADDR_DIDSPACE(did) (((CVMX_IO_SEG) << 22) | ((1ULL) << 8) | (did))
296 #define CVMX_ADDR_DID(did) (CVMX_ADDR_DIDSPACE(did) << 40)
297 #define CVMX_FULL_DID(did, subdid) (((did) << 3) | (subdid))
298 
299   /* from include/ncb_rsl_id.v */
300 #define CVMX_OCT_DID_MIS 0ULL	/* misc stuff */
301 #define CVMX_OCT_DID_GMX0 1ULL
302 #define CVMX_OCT_DID_GMX1 2ULL
303 #define CVMX_OCT_DID_PCI 3ULL
304 #define CVMX_OCT_DID_KEY 4ULL
305 #define CVMX_OCT_DID_FPA 5ULL
306 #define CVMX_OCT_DID_DFA 6ULL
307 #define CVMX_OCT_DID_ZIP 7ULL
308 #define CVMX_OCT_DID_RNG 8ULL
309 #define CVMX_OCT_DID_IPD 9ULL
310 #define CVMX_OCT_DID_PKT 10ULL
311 #define CVMX_OCT_DID_TIM 11ULL
312 #define CVMX_OCT_DID_TAG 12ULL
313   /* the rest are not on the IO bus */
314 #define CVMX_OCT_DID_L2C 16ULL
315 #define CVMX_OCT_DID_LMC 17ULL
316 #define CVMX_OCT_DID_SPX0 18ULL
317 #define CVMX_OCT_DID_SPX1 19ULL
318 #define CVMX_OCT_DID_PIP 20ULL
319 #define CVMX_OCT_DID_ASX0 22ULL
320 #define CVMX_OCT_DID_ASX1 23ULL
321 #define CVMX_OCT_DID_IOB 30ULL
322 
323 #define CVMX_OCT_DID_PKT_SEND	    CVMX_FULL_DID(CVMX_OCT_DID_PKT, 2ULL)
324 #define CVMX_OCT_DID_TAG_SWTAG	    CVMX_FULL_DID(CVMX_OCT_DID_TAG, 0ULL)
325 #define CVMX_OCT_DID_TAG_TAG1	    CVMX_FULL_DID(CVMX_OCT_DID_TAG, 1ULL)
326 #define CVMX_OCT_DID_TAG_TAG2	    CVMX_FULL_DID(CVMX_OCT_DID_TAG, 2ULL)
327 #define CVMX_OCT_DID_TAG_TAG3	    CVMX_FULL_DID(CVMX_OCT_DID_TAG, 3ULL)
328 #define CVMX_OCT_DID_TAG_NULL_RD    CVMX_FULL_DID(CVMX_OCT_DID_TAG, 4ULL)
329 #define CVMX_OCT_DID_TAG_CSR	    CVMX_FULL_DID(CVMX_OCT_DID_TAG, 7ULL)
330 #define CVMX_OCT_DID_FAU_FAI	    CVMX_FULL_DID(CVMX_OCT_DID_IOB, 0ULL)
331 #define CVMX_OCT_DID_TIM_CSR	    CVMX_FULL_DID(CVMX_OCT_DID_TIM, 0ULL)
332 #define CVMX_OCT_DID_KEY_RW	    CVMX_FULL_DID(CVMX_OCT_DID_KEY, 0ULL)
333 #define CVMX_OCT_DID_PCI_6	    CVMX_FULL_DID(CVMX_OCT_DID_PCI, 6ULL)
334 #define CVMX_OCT_DID_MIS_BOO	    CVMX_FULL_DID(CVMX_OCT_DID_MIS, 0ULL)
335 #define CVMX_OCT_DID_PCI_RML	    CVMX_FULL_DID(CVMX_OCT_DID_PCI, 0ULL)
336 #define CVMX_OCT_DID_IPD_CSR	    CVMX_FULL_DID(CVMX_OCT_DID_IPD, 7ULL)
337 #define CVMX_OCT_DID_DFA_CSR	    CVMX_FULL_DID(CVMX_OCT_DID_DFA, 7ULL)
338 #define CVMX_OCT_DID_MIS_CSR	    CVMX_FULL_DID(CVMX_OCT_DID_MIS, 7ULL)
339 #define CVMX_OCT_DID_ZIP_CSR	    CVMX_FULL_DID(CVMX_OCT_DID_ZIP, 0ULL)
340 
341 #endif /* __CVMX_ADDRESS_H__ */
342