1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 #ifndef _ASM_X86_UV_BIOS_H 3 #define _ASM_X86_UV_BIOS_H 4 5 /* 6 * UV BIOS layer definitions. 7 * 8 * Copyright (c) 2008-2009 Silicon Graphics, Inc. All Rights Reserved. 9 * Copyright (c) Russ Anderson <rja@sgi.com> 10 */ 11 12 #include <linux/rtc.h> 13 14 /* 15 * Values for the BIOS calls. It is passed as the first * argument in the 16 * BIOS call. Passing any other value in the first argument will result 17 * in a BIOS_STATUS_UNIMPLEMENTED return status. 18 */ 19 enum uv_bios_cmd { 20 UV_BIOS_COMMON, 21 UV_BIOS_GET_SN_INFO, 22 UV_BIOS_FREQ_BASE, 23 UV_BIOS_WATCHLIST_ALLOC, 24 UV_BIOS_WATCHLIST_FREE, 25 UV_BIOS_MEMPROTECT, 26 UV_BIOS_GET_PARTITION_ADDR, 27 UV_BIOS_SET_LEGACY_VGA_TARGET 28 }; 29 30 /* 31 * Status values returned from a BIOS call. 32 */ 33 enum { 34 BIOS_STATUS_MORE_PASSES = 1, 35 BIOS_STATUS_SUCCESS = 0, 36 BIOS_STATUS_UNIMPLEMENTED = -ENOSYS, 37 BIOS_STATUS_EINVAL = -EINVAL, 38 BIOS_STATUS_UNAVAIL = -EBUSY, 39 BIOS_STATUS_ABORT = -EINTR, 40 }; 41 42 /* Address map parameters */ 43 struct uv_gam_parameters { 44 u64 mmr_base; 45 u64 gru_base; 46 u8 mmr_shift; /* Convert PNode to MMR space offset */ 47 u8 gru_shift; /* Convert PNode to GRU space offset */ 48 u8 gpa_shift; /* Size of offset field in GRU phys addr */ 49 u8 unused1; 50 }; 51 52 /* UV_TABLE_GAM_RANGE_ENTRY values */ 53 #define UV_GAM_RANGE_TYPE_UNUSED 0 /* End of table */ 54 #define UV_GAM_RANGE_TYPE_RAM 1 /* Normal RAM */ 55 #define UV_GAM_RANGE_TYPE_NVRAM 2 /* Non-volatile memory */ 56 #define UV_GAM_RANGE_TYPE_NV_WINDOW 3 /* NVMDIMM block window */ 57 #define UV_GAM_RANGE_TYPE_NV_MAILBOX 4 /* NVMDIMM mailbox */ 58 #define UV_GAM_RANGE_TYPE_HOLE 5 /* Unused address range */ 59 #define UV_GAM_RANGE_TYPE_MAX 6 60 61 /* The structure stores PA bits 56:26, for 64MB granularity */ 62 #define UV_GAM_RANGE_SHFT 26 /* 64MB */ 63 64 struct uv_gam_range_entry { 65 char type; /* Entry type: GAM_RANGE_TYPE_UNUSED, etc. */ 66 char unused1; 67 u16 nasid; /* HNasid */ 68 u16 sockid; /* Socket ID, high bits of APIC ID */ 69 u16 pnode; /* Index to MMR and GRU spaces */ 70 u32 unused2; 71 u32 limit; /* PA bits 56:26 (UV_GAM_RANGE_SHFT) */ 72 }; 73 74 #define UV_SYSTAB_SIG "UVST" 75 #define UV_SYSTAB_VERSION_1 1 /* UV1/2/3 BIOS version */ 76 #define UV_SYSTAB_VERSION_UV4 0x400 /* UV4 BIOS base version */ 77 #define UV_SYSTAB_VERSION_UV4_1 0x401 /* + gpa_shift */ 78 #define UV_SYSTAB_VERSION_UV4_2 0x402 /* + TYPE_NVRAM/WINDOW/MBOX */ 79 #define UV_SYSTAB_VERSION_UV4_3 0x403 /* - GAM Range PXM Value */ 80 #define UV_SYSTAB_VERSION_UV4_LATEST UV_SYSTAB_VERSION_UV4_3 81 82 #define UV_SYSTAB_TYPE_UNUSED 0 /* End of table (offset == 0) */ 83 #define UV_SYSTAB_TYPE_GAM_PARAMS 1 /* GAM PARAM conversions */ 84 #define UV_SYSTAB_TYPE_GAM_RNG_TBL 2 /* GAM entry table */ 85 #define UV_SYSTAB_TYPE_MAX 3 86 87 /* 88 * The UV system table describes specific firmware 89 * capabilities available to the Linux kernel at runtime. 90 */ 91 struct uv_systab { 92 char signature[4]; /* must be UV_SYSTAB_SIG */ 93 u32 revision; /* distinguish different firmware revs */ 94 u64 function; /* BIOS runtime callback function ptr */ 95 u32 size; /* systab size (starting with _VERSION_UV4) */ 96 struct { 97 u32 type:8; /* type of entry */ 98 u32 offset:24; /* byte offset from struct start to entry */ 99 } entry[1]; /* additional entries follow */ 100 }; 101 extern struct uv_systab *uv_systab; 102 /* (... end of definitions from UV BIOS ...) */ 103 104 enum { 105 BIOS_FREQ_BASE_PLATFORM = 0, 106 BIOS_FREQ_BASE_INTERVAL_TIMER = 1, 107 BIOS_FREQ_BASE_REALTIME_CLOCK = 2 108 }; 109 110 union partition_info_u { 111 u64 val; 112 struct { 113 u64 hub_version : 8, 114 partition_id : 16, 115 coherence_id : 16, 116 region_size : 24; 117 }; 118 }; 119 120 enum uv_memprotect { 121 UV_MEMPROT_RESTRICT_ACCESS, 122 UV_MEMPROT_ALLOW_AMO, 123 UV_MEMPROT_ALLOW_RW 124 }; 125 126 /* 127 * bios calls have 6 parameters 128 */ 129 extern s64 uv_bios_call(enum uv_bios_cmd, u64, u64, u64, u64, u64); 130 extern s64 uv_bios_call_irqsave(enum uv_bios_cmd, u64, u64, u64, u64, u64); 131 132 extern s64 uv_bios_get_sn_info(int, int *, long *, long *, long *, long *); 133 extern s64 uv_bios_freq_base(u64, u64 *); 134 extern int uv_bios_mq_watchlist_alloc(unsigned long, unsigned int, 135 unsigned long *); 136 extern int uv_bios_mq_watchlist_free(int, int); 137 extern s64 uv_bios_change_memprotect(u64, u64, enum uv_memprotect); 138 extern s64 uv_bios_reserved_page_pa(u64, u64 *, u64 *, u64 *); 139 extern int uv_bios_set_legacy_vga_target(bool decode, int domain, int bus); 140 141 extern int uv_bios_init(void); 142 143 extern unsigned long sn_rtc_cycles_per_second; 144 extern int uv_type; 145 extern long sn_partition_id; 146 extern long sn_coherency_id; 147 extern long sn_region_size; 148 extern long system_serial_number; 149 #define uv_partition_coherence_id() (sn_coherency_id) 150 151 extern struct kobject *sgi_uv_kobj; /* /sys/firmware/sgi_uv */ 152 153 /* 154 * EFI runtime lock; cf. firmware/efi/runtime-wrappers.c for details 155 */ 156 extern struct semaphore __efi_uv_runtime_lock; 157 158 #endif /* _ASM_X86_UV_BIOS_H */ 159