1*4882a593Smuzhiyun /* 2*4882a593Smuzhiyun * Copyright (c) 2014 Google, Inc 3*4882a593Smuzhiyun * 4*4882a593Smuzhiyun * From Coreboot file of the same name 5*4882a593Smuzhiyun * 6*4882a593Smuzhiyun * SPDX-License-Identifier: GPL-2.0+ 7*4882a593Smuzhiyun */ 8*4882a593Smuzhiyun 9*4882a593Smuzhiyun #ifndef _ASM_MTRR_H 10*4882a593Smuzhiyun #define _ASM_MTRR_H 11*4882a593Smuzhiyun 12*4882a593Smuzhiyun /* MTRR region types */ 13*4882a593Smuzhiyun #define MTRR_TYPE_UNCACHEABLE 0 14*4882a593Smuzhiyun #define MTRR_TYPE_WRCOMB 1 15*4882a593Smuzhiyun #define MTRR_TYPE_WRTHROUGH 4 16*4882a593Smuzhiyun #define MTRR_TYPE_WRPROT 5 17*4882a593Smuzhiyun #define MTRR_TYPE_WRBACK 6 18*4882a593Smuzhiyun 19*4882a593Smuzhiyun #define MTRR_TYPE_COUNT 7 20*4882a593Smuzhiyun 21*4882a593Smuzhiyun #define MTRR_CAP_MSR 0x0fe 22*4882a593Smuzhiyun #define MTRR_DEF_TYPE_MSR 0x2ff 23*4882a593Smuzhiyun 24*4882a593Smuzhiyun #define MTRR_CAP_SMRR (1 << 11) 25*4882a593Smuzhiyun #define MTRR_CAP_WC (1 << 10) 26*4882a593Smuzhiyun #define MTRR_CAP_FIX (1 << 8) 27*4882a593Smuzhiyun #define MTRR_CAP_VCNT_MASK 0xff 28*4882a593Smuzhiyun 29*4882a593Smuzhiyun #define MTRR_DEF_TYPE_EN (1 << 11) 30*4882a593Smuzhiyun #define MTRR_DEF_TYPE_FIX_EN (1 << 10) 31*4882a593Smuzhiyun 32*4882a593Smuzhiyun #define MTRR_PHYS_BASE_MSR(reg) (0x200 + 2 * (reg)) 33*4882a593Smuzhiyun #define MTRR_PHYS_MASK_MSR(reg) (0x200 + 2 * (reg) + 1) 34*4882a593Smuzhiyun 35*4882a593Smuzhiyun #define MTRR_PHYS_MASK_VALID (1 << 11) 36*4882a593Smuzhiyun 37*4882a593Smuzhiyun #define MTRR_BASE_TYPE_MASK 0x7 38*4882a593Smuzhiyun 39*4882a593Smuzhiyun /* Number of MTRRs supported */ 40*4882a593Smuzhiyun #define MTRR_COUNT 8 41*4882a593Smuzhiyun 42*4882a593Smuzhiyun #define NUM_FIXED_MTRRS 11 43*4882a593Smuzhiyun #define RANGES_PER_FIXED_MTRR 8 44*4882a593Smuzhiyun #define NUM_FIXED_RANGES (NUM_FIXED_MTRRS * RANGES_PER_FIXED_MTRR) 45*4882a593Smuzhiyun 46*4882a593Smuzhiyun #define MTRR_FIX_64K_00000_MSR 0x250 47*4882a593Smuzhiyun #define MTRR_FIX_16K_80000_MSR 0x258 48*4882a593Smuzhiyun #define MTRR_FIX_16K_A0000_MSR 0x259 49*4882a593Smuzhiyun #define MTRR_FIX_4K_C0000_MSR 0x268 50*4882a593Smuzhiyun #define MTRR_FIX_4K_C8000_MSR 0x269 51*4882a593Smuzhiyun #define MTRR_FIX_4K_D0000_MSR 0x26a 52*4882a593Smuzhiyun #define MTRR_FIX_4K_D8000_MSR 0x26b 53*4882a593Smuzhiyun #define MTRR_FIX_4K_E0000_MSR 0x26c 54*4882a593Smuzhiyun #define MTRR_FIX_4K_E8000_MSR 0x26d 55*4882a593Smuzhiyun #define MTRR_FIX_4K_F0000_MSR 0x26e 56*4882a593Smuzhiyun #define MTRR_FIX_4K_F8000_MSR 0x26f 57*4882a593Smuzhiyun 58*4882a593Smuzhiyun #define MTRR_FIX_TYPE(t) ((t << 24) | (t << 16) | (t << 8) | t) 59*4882a593Smuzhiyun 60*4882a593Smuzhiyun #if !defined(__ASSEMBLER__) 61*4882a593Smuzhiyun 62*4882a593Smuzhiyun /** 63*4882a593Smuzhiyun * Information about the previous MTRR state, set up by mtrr_open() 64*4882a593Smuzhiyun * 65*4882a593Smuzhiyun * @deftype: Previous value of MTRR_DEF_TYPE_MSR 66*4882a593Smuzhiyun * @enable_cache: true if cache was enabled 67*4882a593Smuzhiyun */ 68*4882a593Smuzhiyun struct mtrr_state { 69*4882a593Smuzhiyun uint64_t deftype; 70*4882a593Smuzhiyun bool enable_cache; 71*4882a593Smuzhiyun }; 72*4882a593Smuzhiyun 73*4882a593Smuzhiyun /** 74*4882a593Smuzhiyun * mtrr_open() - Prepare to adjust MTRRs 75*4882a593Smuzhiyun * 76*4882a593Smuzhiyun * Use mtrr_open() passing in a structure - this function will init it. Then 77*4882a593Smuzhiyun * when done, pass the same structure to mtrr_close() to re-enable MTRRs and 78*4882a593Smuzhiyun * possibly the cache. 79*4882a593Smuzhiyun * 80*4882a593Smuzhiyun * @state: Empty structure to pass in to hold settings 81*4882a593Smuzhiyun */ 82*4882a593Smuzhiyun void mtrr_open(struct mtrr_state *state); 83*4882a593Smuzhiyun 84*4882a593Smuzhiyun /** 85*4882a593Smuzhiyun * mtrr_open() - Clean up after adjusting MTRRs, and enable them 86*4882a593Smuzhiyun * 87*4882a593Smuzhiyun * This uses the structure containing information returned from mtrr_open(). 88*4882a593Smuzhiyun * 89*4882a593Smuzhiyun * @state: Structure from mtrr_open() 90*4882a593Smuzhiyun */ 91*4882a593Smuzhiyun void mtrr_close(struct mtrr_state *state); 92*4882a593Smuzhiyun 93*4882a593Smuzhiyun /** 94*4882a593Smuzhiyun * mtrr_add_request() - Add a new MTRR request 95*4882a593Smuzhiyun * 96*4882a593Smuzhiyun * This adds a request for a memory region to be set up in a particular way. 97*4882a593Smuzhiyun * 98*4882a593Smuzhiyun * @type: Requested type (MTRR_TYPE_) 99*4882a593Smuzhiyun * @start: Start address 100*4882a593Smuzhiyun * @size: Size 101*4882a593Smuzhiyun * 102*4882a593Smuzhiyun * @return: 0 on success, non-zero on failure 103*4882a593Smuzhiyun */ 104*4882a593Smuzhiyun int mtrr_add_request(int type, uint64_t start, uint64_t size); 105*4882a593Smuzhiyun 106*4882a593Smuzhiyun /** 107*4882a593Smuzhiyun * mtrr_commit() - set up the MTRR registers based on current requests 108*4882a593Smuzhiyun * 109*4882a593Smuzhiyun * This sets up MTRRs for the available DRAM and the requests received so far. 110*4882a593Smuzhiyun * It must be called with caches disabled. 111*4882a593Smuzhiyun * 112*4882a593Smuzhiyun * @do_caches: true if caches are currently on 113*4882a593Smuzhiyun * 114*4882a593Smuzhiyun * @return: 0 on success, non-zero on failure 115*4882a593Smuzhiyun */ 116*4882a593Smuzhiyun int mtrr_commit(bool do_caches); 117*4882a593Smuzhiyun 118*4882a593Smuzhiyun #endif 119*4882a593Smuzhiyun 120*4882a593Smuzhiyun #if ((CONFIG_XIP_ROM_SIZE & (CONFIG_XIP_ROM_SIZE - 1)) != 0) 121*4882a593Smuzhiyun # error "CONFIG_XIP_ROM_SIZE is not a power of 2" 122*4882a593Smuzhiyun #endif 123*4882a593Smuzhiyun 124*4882a593Smuzhiyun #if ((CONFIG_CACHE_ROM_SIZE & (CONFIG_CACHE_ROM_SIZE - 1)) != 0) 125*4882a593Smuzhiyun # error "CONFIG_CACHE_ROM_SIZE is not a power of 2" 126*4882a593Smuzhiyun #endif 127*4882a593Smuzhiyun 128*4882a593Smuzhiyun #define CACHE_ROM_BASE (((1 << 20) - (CONFIG_CACHE_ROM_SIZE >> 12)) << 12) 129*4882a593Smuzhiyun 130*4882a593Smuzhiyun #endif 131