1 /* $NetBSD: cache.h,v 1.6 2003/02/17 11:35:01 simonb Exp $ */ 2 3 /* 4 * Copyright 2001 Wasabi Systems, Inc. 5 * All rights reserved. 6 * 7 * Written by Jason R. Thorpe for Wasabi Systems, Inc. 8 * 9 * Redistribution and use in source and binary forms, with or without 10 * modification, are permitted provided that the following conditions 11 * are met: 12 * 1. Redistributions of source code must retain the above copyright 13 * notice, this list of conditions and the following disclaimer. 14 * 2. Redistributions in binary form must reproduce the above copyright 15 * notice, this list of conditions and the following disclaimer in the 16 * documentation and/or other materials provided with the distribution. 17 * 3. All advertising materials mentioning features or use of this software 18 * must display the following acknowledgement: 19 * This product includes software developed for the NetBSD Project by 20 * Wasabi Systems, Inc. 21 * 4. The name of Wasabi Systems, Inc. may not be used to endorse 22 * or promote products derived from this software without specific prior 23 * written permission. 24 * 25 * THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND 26 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 27 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 28 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL WASABI SYSTEMS, INC 29 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 30 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 31 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 32 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 33 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 34 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 35 * POSSIBILITY OF SUCH DAMAGE. 36 * 37 * $FreeBSD$ 38 */ 39 40 #ifndef _MACHINE_CACHE_H_ 41 #define _MACHINE_CACHE_H_ 42 43 /* 44 * Cache operations. 45 * 46 * We define the following primitives: 47 * 48 * --- Instruction cache synchronization (mandatory): 49 * 50 * icache_sync_all Synchronize I-cache 51 * 52 * icache_sync_range Synchronize I-cache range 53 * 54 * icache_sync_range_index (index ops) 55 * 56 * --- Primary data cache (mandatory): 57 * 58 * pdcache_wbinv_all Write-back Invalidate primary D-cache 59 * 60 * pdcache_wbinv_range Write-back Invalidate primary D-cache range 61 * 62 * pdcache_wbinv_range_index (index ops) 63 * 64 * pdcache_inv_range Invalidate primary D-cache range 65 * 66 * pdcache_wb_range Write-back primary D-cache range 67 * 68 * --- Secondary data cache (optional): 69 * 70 * sdcache_wbinv_all Write-back Invalidate secondary D-cache 71 * 72 * sdcache_wbinv_range Write-back Invalidate secondary D-cache range 73 * 74 * sdcache_wbinv_range_index (index ops) 75 * 76 * sdcache_inv_range Invalidate secondary D-cache range 77 * 78 * sdcache_wb_range Write-back secondary D-cache range 79 * 80 * There are some rules that must be followed: 81 * 82 * I-cache Synch (all or range): 83 * The goal is to synchronize the instruction stream, 84 * so you may need to write-back dirty data cache 85 * blocks first. If a range is requested, and you 86 * can't synchronize just a range, you have to hit 87 * the whole thing. 88 * 89 * D-cache Write-back Invalidate range: 90 * If you can't WB-Inv a range, you must WB-Inv the 91 * entire D-cache. 92 * 93 * D-cache Invalidate: 94 * If you can't Inv the D-cache without doing a 95 * Write-back, YOU MUST PANIC. This is to catch 96 * errors in calling code. Callers must be aware 97 * of this scenario, and must handle it appropriately 98 * (consider the bus_dma(9) operations). 99 * 100 * D-cache Write-back: 101 * If you can't Write-back without doing an invalidate, 102 * that's fine. Then treat this as a WB-Inv. Skipping 103 * the invalidate is merely an optimization. 104 * 105 * All operations: 106 * Valid virtual addresses must be passed to the 107 * cache operation. 108 * 109 * Finally, these primitives are grouped together in reasonable 110 * ways. For all operations described here, first the primary 111 * cache is frobbed, then the secondary cache frobbed, if the 112 * operation for the secondary cache exists. 113 * 114 * mips_icache_sync_all Synchronize I-cache 115 * 116 * mips_icache_sync_range Synchronize I-cache range 117 * 118 * mips_icache_sync_range_index (index ops) 119 * 120 * mips_dcache_wbinv_all Write-back Invalidate D-cache 121 * 122 * mips_dcache_wbinv_range Write-back Invalidate D-cache range 123 * 124 * mips_dcache_wbinv_range_index (index ops) 125 * 126 * mips_dcache_inv_range Invalidate D-cache range 127 * 128 * mips_dcache_wb_range Write-back D-cache range 129 */ 130 131 struct mips_cache_ops { 132 void (*mco_icache_sync_all)(void); 133 void (*mco_icache_sync_range)(vm_offset_t, vm_size_t); 134 void (*mco_icache_sync_range_index)(vm_offset_t, vm_size_t); 135 136 void (*mco_pdcache_wbinv_all)(void); 137 void (*mco_pdcache_wbinv_range)(vm_offset_t, vm_size_t); 138 void (*mco_pdcache_wbinv_range_index)(vm_offset_t, vm_size_t); 139 void (*mco_pdcache_inv_range)(vm_offset_t, vm_size_t); 140 void (*mco_pdcache_wb_range)(vm_offset_t, vm_size_t); 141 142 /* These are called only by the (mipsNN) icache functions. */ 143 void (*mco_intern_pdcache_wbinv_all)(void); 144 void (*mco_intern_pdcache_wbinv_range_index)(vm_offset_t, vm_size_t); 145 void (*mco_intern_pdcache_wb_range)(vm_offset_t, vm_size_t); 146 147 void (*mco_sdcache_wbinv_all)(void); 148 void (*mco_sdcache_wbinv_range)(vm_offset_t, vm_size_t); 149 void (*mco_sdcache_wbinv_range_index)(vm_offset_t, vm_size_t); 150 void (*mco_sdcache_inv_range)(vm_offset_t, vm_size_t); 151 void (*mco_sdcache_wb_range)(vm_offset_t, vm_size_t); 152 153 /* These are called only by the (mipsNN) icache functions. */ 154 void (*mco_intern_sdcache_wbinv_all)(void); 155 void (*mco_intern_sdcache_wbinv_range_index)(vm_offset_t, vm_size_t); 156 void (*mco_intern_sdcache_wb_range)(vm_offset_t, vm_size_t); 157 }; 158 159 extern struct mips_cache_ops mips_cache_ops; 160 161 /* PRIMARY CACHE VARIABLES */ 162 extern u_int mips_picache_size; 163 extern u_int mips_picache_line_size; 164 extern u_int mips_picache_ways; 165 extern u_int mips_picache_way_size; 166 extern u_int mips_picache_way_mask; 167 168 extern u_int mips_pdcache_size; /* and unified */ 169 extern u_int mips_pdcache_line_size; 170 extern u_int mips_pdcache_ways; 171 extern u_int mips_pdcache_way_size; 172 extern u_int mips_pdcache_way_mask; 173 extern int mips_pdcache_write_through; 174 175 extern int mips_pcache_unified; 176 177 /* SECONDARY CACHE VARIABLES */ 178 extern u_int mips_sicache_size; 179 extern u_int mips_sicache_line_size; 180 extern u_int mips_sicache_ways; 181 extern u_int mips_sicache_way_size; 182 extern u_int mips_sicache_way_mask; 183 184 extern u_int mips_sdcache_size; /* and unified */ 185 extern u_int mips_sdcache_line_size; 186 extern u_int mips_sdcache_ways; 187 extern u_int mips_sdcache_way_size; 188 extern u_int mips_sdcache_way_mask; 189 extern int mips_sdcache_write_through; 190 191 extern int mips_scache_unified; 192 193 /* TERTIARY CACHE VARIABLES */ 194 extern u_int mips_tcache_size; /* always unified */ 195 extern u_int mips_tcache_line_size; 196 extern u_int mips_tcache_ways; 197 extern u_int mips_tcache_way_size; 198 extern u_int mips_tcache_way_mask; 199 extern int mips_tcache_write_through; 200 201 extern u_int mips_dcache_align; 202 extern u_int mips_dcache_align_mask; 203 204 extern u_int mips_cache_alias_mask; 205 extern u_int mips_cache_prefer_mask; 206 207 #define __mco_noargs(prefix, x) \ 208 do { \ 209 (*mips_cache_ops.mco_ ## prefix ## p ## x )(); \ 210 if (*mips_cache_ops.mco_ ## prefix ## s ## x ) \ 211 (*mips_cache_ops.mco_ ## prefix ## s ## x )(); \ 212 } while (/*CONSTCOND*/0) 213 214 #define __mco_2args(prefix, x, a, b) \ 215 do { \ 216 (*mips_cache_ops.mco_ ## prefix ## p ## x )((a), (b)); \ 217 if (*mips_cache_ops.mco_ ## prefix ## s ## x ) \ 218 (*mips_cache_ops.mco_ ## prefix ## s ## x )((a), (b)); \ 219 } while (/*CONSTCOND*/0) 220 221 #define mips_icache_sync_all() \ 222 (*mips_cache_ops.mco_icache_sync_all)() 223 224 #define mips_icache_sync_range(v, s) \ 225 (*mips_cache_ops.mco_icache_sync_range)((v), (s)) 226 227 #define mips_icache_sync_range_index(v, s) \ 228 (*mips_cache_ops.mco_icache_sync_range_index)((v), (s)) 229 230 #define mips_dcache_wbinv_all() \ 231 __mco_noargs(, dcache_wbinv_all) 232 233 #define mips_dcache_wbinv_range(v, s) \ 234 __mco_2args(, dcache_wbinv_range, (v), (s)) 235 236 #define mips_dcache_wbinv_range_index(v, s) \ 237 __mco_2args(, dcache_wbinv_range_index, (v), (s)) 238 239 #define mips_dcache_inv_range(v, s) \ 240 __mco_2args(, dcache_inv_range, (v), (s)) 241 242 #define mips_dcache_wb_range(v, s) \ 243 __mco_2args(, dcache_wb_range, (v), (s)) 244 245 /* 246 * Private D-cache functions only called from (currently only the 247 * mipsNN) I-cache functions. 248 */ 249 #define mips_intern_dcache_wbinv_all() \ 250 __mco_noargs(intern_, dcache_wbinv_all) 251 252 #define mips_intern_dcache_wbinv_range_index(v, s) \ 253 __mco_2args(intern_, dcache_wbinv_range_index, (v), (s)) 254 255 #define mips_intern_dcache_wb_range(v, s) \ 256 __mco_2args(intern_, dcache_wb_range, (v), (s)) 257 258 /* forward declaration */ 259 struct mips_cpuinfo; 260 261 void mips_config_cache(struct mips_cpuinfo *); 262 void mips_dcache_compute_align(void); 263 264 #include <machine/cache_mipsNN.h> 265 #endif /* _MACHINE_CACHE_H_ */ 266