1 /* 2 * CDDL HEADER START 3 * 4 * The contents of this file are subject to the terms of the 5 * Common Development and Distribution License (the "License"). 6 * You may not use this file except in compliance with the License. 7 * 8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9 * or http://www.opensolaris.org/os/licensing. 10 * See the License for the specific language governing permissions 11 * and limitations under the License. 12 * 13 * When distributing Covered Code, include this CDDL HEADER in each 14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15 * If applicable, add the following below this CDDL HEADER, with the 16 * fields enclosed by brackets "[]" replaced with your own identifying 17 * information: Portions Copyright [yyyy] [name of copyright owner] 18 * 19 * CDDL HEADER END 20 */ 21 22 /* 23 * Copyright 2015 OmniTI Computer Consulting, Inc. All rights reserved. 24 * Copyright (c) 2018, Joyent, Inc. 25 * Copyright 2023 Oxide Computer Company 26 * Copyright 2010 Sun Microsystems, Inc. All rights reserved. 27 * Use is subject to license terms. 28 */ 29 30 /* 31 * This header file defines the implementation structures for the SMBIOS access 32 * library, libsmbios, and an equivalent kernel module. Clients should use 33 * the <smbios.h> or <sys/smbios.h> header files to access DMTF SMBIOS 34 * information, NOT these underlying implementation structures from the spec. 35 * In short, do not user this header file or these routines for any purpose. 36 */ 37 38 #ifndef _SYS_SMBIOS_IMPL_H 39 #define _SYS_SMBIOS_IMPL_H 40 41 #include <sys/smbios.h> 42 #include <sys/sysmacros.h> 43 44 #ifdef _KERNEL 45 #include <sys/systm.h> 46 #else 47 #include <strings.h> 48 #include <stddef.h> 49 #endif 50 51 #ifdef __cplusplus 52 extern "C" { 53 #endif 54 55 /* 56 * Definitions required to interpret the BIOS type information. 57 */ 58 #define SMB_BIOSXB_EXTROM 6 59 60 #define SMB_BIOS_EXTROM_VALUE_MASK(x) ((x) & 0x3fff) 61 #define SMB_BIOS_EXTROM_SHIFT_MASK(x) (((x) & 0xc000) >> 14) 62 63 #pragma pack(1) 64 65 typedef struct smb_header { 66 uint8_t smbh_type; /* structure type (SMB_TYPE_* value) */ 67 uint8_t smbh_len; /* length in bytes of formatted area */ 68 uint16_t smbh_hdl; /* structure handle */ 69 } smb_header_t; 70 71 /* 72 * SMBIOS implementation structure for SMB_TYPE_BIOS. 73 */ 74 typedef struct smb_bios { 75 smb_header_t smbbi_hdr; /* structure header */ 76 uint8_t smbbi_vendor; /* bios vendor string */ 77 uint8_t smbbi_version; /* bios version string */ 78 uint16_t smbbi_segment; /* segment location of bios address */ 79 uint8_t smbbi_reldate; /* bios release date */ 80 uint8_t smbbi_romsize; /* bios rom size (64k * (n + 1)) */ 81 uint64_t smbbi_cflags; /* bios characteristics */ 82 uint8_t smbbi_xcflags[1]; /* bios characteristics extensions */ 83 } smb_bios_t; 84 85 /* 86 * SMBIOS implementation structure for SMB_TYPE_SYSTEM. 87 */ 88 typedef struct smb_system { 89 smb_header_t smbsi_hdr; /* structure header */ 90 uint8_t smbsi_manufacturer; /* manufacturer */ 91 uint8_t smbsi_product; /* product name */ 92 uint8_t smbsi_version; /* version */ 93 uint8_t smbsi_serial; /* serial number */ 94 uint8_t smbsi_uuid[16]; /* UUID */ 95 uint8_t smbsi_wakeup; /* wake-up type */ 96 uint8_t smbsi_sku; /* SKU number */ 97 uint8_t smbsi_family; /* family */ 98 } smb_system_t; 99 100 /* 101 * SMBIOS implementation structure for SMB_TYPE_BASEBOARD. 102 */ 103 typedef struct smb_bboard { 104 smb_header_t smbbb_hdr; /* structure header */ 105 uint8_t smbbb_manufacturer; /* manufacturer */ 106 uint8_t smbbb_product; /* product name */ 107 uint8_t smbbb_version; /* version */ 108 uint8_t smbbb_serial; /* serial number */ 109 uint8_t smbbb_asset; /* asset tag */ 110 uint8_t smbbb_flags; /* feature flags */ 111 uint8_t smbbb_location; /* location in chassis */ 112 uint16_t smbbb_chassis; /* chassis handle */ 113 uint8_t smbbb_type; /* board type */ 114 uint8_t smbbb_cn; /* number of contained handles */ 115 uint16_t smbbb_cv[1]; /* array of contained handles */ 116 } smb_bboard_t; 117 118 /* 119 * SMBIOS implementation structure for SMB_TYPE_CHASSIS. 120 */ 121 typedef struct smb_chassis { 122 smb_header_t smbch_hdr; /* structure header */ 123 uint8_t smbch_manufacturer; /* manufacturer */ 124 uint8_t smbch_type; /* type */ 125 uint8_t smbch_version; /* version */ 126 uint8_t smbch_serial; /* serial number */ 127 uint8_t smbch_asset; /* asset tag */ 128 uint8_t smbch_bustate; /* boot-up state */ 129 uint8_t smbch_psstate; /* power supply state */ 130 uint8_t smbch_thstate; /* thermal state */ 131 uint8_t smbch_security; /* security state */ 132 uint32_t smbch_oemdata; /* OEM-specific data */ 133 uint8_t smbch_uheight; /* enclosure height */ 134 uint8_t smbch_cords; /* number of power cords */ 135 uint8_t smbch_cn; /* number of contained records */ 136 uint8_t smbch_cm; /* size of contained records */ 137 uint8_t smbch_cv[]; /* array of contained records */ 138 } smb_chassis_t; 139 140 #define SMB_CHT_LOCK 0x80 /* lock bit within smbch_type */ 141 142 typedef struct smb_chassis_entry { 143 uint8_t smbce_type; /* Containing Element and Type */ 144 uint8_t smbce_min; /* minimum number of elt */ 145 uint8_t smbce_max; /* minimum number of elt */ 146 } smb_chassis_entry_t; 147 148 #define SMB_CHE_TYPE_IS_SMB(x) (((x) & 0x80) == 0x80) 149 #define SMB_CHE_TYPE_TYPE(x) (((x) & 0x7f)) 150 151 /* 152 * SMBIOS implementation structure for SMB_TYPE_PROCESSOR. 153 */ 154 typedef struct smb_processor { 155 smb_header_t smbpr_hdr; /* structure header */ 156 uint8_t smbpr_socket; /* socket designation */ 157 uint8_t smbpr_type; /* processor type (see <smbios.h>) */ 158 uint8_t smbpr_family; /* processor family (see <smbios.h>) */ 159 uint8_t smbpr_manufacturer; /* manufacturer */ 160 uint64_t smbpr_cpuid; /* processor cpuid information */ 161 uint8_t smbpr_version; /* version */ 162 uint8_t smbpr_voltage; /* voltage */ 163 uint16_t smbpr_clkspeed; /* external clock speed in MHz */ 164 uint16_t smbpr_maxspeed; /* maximum speed in MHz */ 165 uint16_t smbpr_curspeed; /* current speed in MHz */ 166 uint8_t smbpr_status; /* status (see <smbios.h>) */ 167 uint8_t smbpr_upgrade; /* upgrade */ 168 uint16_t smbpr_l1cache; /* L1 cache handle (if any) */ 169 uint16_t smbpr_l2cache; /* L2 cache handle (if any) */ 170 uint16_t smbpr_l3cache; /* L3 cache handle (if any) */ 171 uint8_t smbpr_serial; /* serial number */ 172 uint8_t smbpr_asset; /* asset tag */ 173 uint8_t smbpr_part; /* part number */ 174 uint8_t smbpr_corecount; /* number of cores per socket */ 175 uint8_t smbpr_coresenabled; /* number of enabled cores per socket */ 176 uint8_t smbpr_threadcount; /* number of threads per socket */ 177 uint16_t smbpr_cflags; /* cpu characteristics (see <smbios.h>) */ 178 uint16_t smbpr_family2; /* processor family2 (see <smbios.h>) */ 179 uint16_t smbpr_corecount2; /* second number of cores per socket */ 180 uint16_t smbpr_coresenabled2; /* second number of enabled cores */ 181 uint16_t smbpr_threadcount2; /* second number of enabled threads */ 182 uint16_t smpbr_threaden; /* enabled thread count */ 183 } smb_processor_t; 184 185 /* 186 * SMBIOS implementation structure for SMB_TYPE_CACHE. 187 */ 188 typedef struct smb_cache { 189 smb_header_t smbca_hdr; /* structure header */ 190 uint8_t smbca_socket; /* socket designation */ 191 uint16_t smbca_config; /* cache configuration */ 192 uint16_t smbca_maxsize; /* maximum installed size */ 193 uint16_t smbca_size; /* installed size */ 194 uint16_t smbca_stype; /* supported SRAM type */ 195 uint16_t smbca_ctype; /* current SRAM type */ 196 uint8_t smbca_speed; /* speed in nanoseconds */ 197 uint8_t smbca_etype; /* error correction type */ 198 uint8_t smbca_ltype; /* logical cache type */ 199 uint8_t smbca_assoc; /* associativity */ 200 uint32_t smbca_maxsize2; /* maximum installed size 2 */ 201 uint32_t smbca_size2; /* installed size 2 */ 202 } smb_cache_t; 203 204 /* 205 * Convert encoded cache size to bytes: DSP0134 Section 7.8 explains the 206 * encoding. The highest bit is 0 for 1k units, 1 for 64k units, and this 207 * macro decodes the value into bytes for exporting to our clients. 208 */ 209 #define SMB_CACHE_SIZE(s) (((s) & 0x8000) ? \ 210 ((uint32_t)((s) & 0x7FFF) * 64 * 1024) : ((uint32_t)(s) * 1024)) 211 212 #define SMB_CACHE_EXT_SIZE(s) (((s) & 0x80000000U) ? \ 213 ((uint64_t)((s) & 0x7FFFFFFFULL) * 64ULL * 1024ULL) : \ 214 ((uint64_t)(s) * 1024ULL)) 215 216 #define SMB_CACHE_CFG_MODE(c) (((c) >> 8) & 3) 217 #define SMB_CACHE_CFG_ENABLED(c) (((c) >> 7) & 1) 218 #define SMB_CACHE_CFG_LOCATION(c) (((c) >> 5) & 3) 219 #define SMB_CACHE_CFG_SOCKETED(c) (((c) >> 3) & 1) 220 #define SMB_CACHE_CFG_LEVEL(c) (((c) & 7) + 1) 221 222 /* 223 * SMBIOS implementation structure for SMB_TYPE_PORT. 224 */ 225 typedef struct smb_port { 226 smb_header_t smbpo_hdr; /* structure header */ 227 uint8_t smbpo_iref; /* internal reference designator */ 228 uint8_t smbpo_itype; /* internal connector type */ 229 uint8_t smbpo_eref; /* external reference designator */ 230 uint8_t smbpo_etype; /* external connector type */ 231 uint8_t smbpo_ptype; /* port type */ 232 } smb_port_t; 233 234 /* 235 * SMBIOS implementation structure for SMB_TYPE_SLOT. 236 */ 237 typedef struct smb_slot_peer { 238 uint16_t smbspb_group_no; /* segment group number */ 239 uint8_t smbspb_bus; /* bus number */ 240 uint8_t smbspb_df; /* device/function number */ 241 uint8_t smbspb_width; /* electrical width */ 242 } smb_slot_peer_t; 243 244 typedef struct smb_slot { 245 smb_header_t smbsl_hdr; /* structure header */ 246 uint8_t smbsl_name; /* reference designation */ 247 uint8_t smbsl_type; /* slot type */ 248 uint8_t smbsl_width; /* slot data bus width */ 249 uint8_t smbsl_usage; /* current usage */ 250 uint8_t smbsl_length; /* slot length */ 251 uint16_t smbsl_id; /* slot ID */ 252 uint8_t smbsl_ch1; /* slot characteristics 1 */ 253 uint8_t smbsl_ch2; /* slot characteristics 2 */ 254 uint16_t smbsl_sg; /* segment group number */ 255 uint8_t smbsl_bus; /* bus number */ 256 uint8_t smbsl_df; /* device/function number */ 257 /* Added in SMBIOS 3.2+ */ 258 uint8_t smbsl_dbw; /* Data bus width */ 259 uint8_t smbsl_npeers; /* Peer bdf groups */ 260 smb_slot_peer_t smbsl_peers[]; /* bifurcation peers */ 261 /* There are later additions in 3.4+, see smbios_slot_cont_t */ 262 } smb_slot_t; 263 264 /* 265 * After the variable number of smbsl_peers, the smbios_slot has continued in 266 * size and has the following members defined as of version 3.4. These occur 267 * starting at byte 14 + 5 * smbsl_npeers. 268 */ 269 typedef struct smb_slot_cont { 270 uint8_t smbsl_info; /* slot info */ 271 uint8_t smbsl_pwidth; /* slot physical width */ 272 uint16_t smbsl_pitch; /* slot pitch */ 273 /* Added in SMBIOS 3.5 */ 274 uint8_t smbsl_height; /* slot height */ 275 } smb_slot_cont_t; 276 277 /* 278 * The first byte that the smb_slot_cont_t is defined to start at. Note, this 279 * was originally indicated to be 0x14 in the SMBIOS 3.4 specification. This has 280 * been noted as an errata. Right now we assume that most things have the 281 * updated behavior in SMBIOS 3.5. However, if we encounter things in the wild 282 * that have the other offset then we will need to condition this on 3.4. 283 */ 284 #define SMB_SLOT_CONT_START 0x13 285 286 /* 287 * SMBIOS implementation structure for SMB_TYPE_OBDEVS. 288 */ 289 typedef struct smb_obdev { 290 uint8_t smbob_type; /* encoded type and enable bit */ 291 uint8_t smbob_name; /* description string */ 292 } smb_obdev_t; 293 294 #define SMB_OBT_ENABLED 0x80 /* enable bit within smbob_type */ 295 296 /* 297 * SMBIOS implementation structure for SMB_TYPE_OEMSTR, SMB_TYPE_SYSCONFSTR, 298 * and SMB_TYPE_LANG. 299 */ 300 typedef struct smb_strtab { 301 smb_header_t smbtb_hdr; /* structure header */ 302 uint8_t smbtb_count; /* number of strings */ 303 } smb_strtab_t; 304 305 /* 306 * SMBIOS implementation structure for SMB_TYPE_LANG. 307 */ 308 typedef struct smb_lang { 309 smb_header_t smblang_hdr; /* structure header */ 310 uint8_t smblang_num; /* number of installed languages */ 311 uint8_t smblang_flags; /* flags */ 312 uint8_t smblang_resv[15]; /* reserved for future use */ 313 uint8_t smblang_cur; /* current language string */ 314 } smb_lang_t; 315 316 /* 317 * SMBIOS implementation structure for SMB_TYPE_EVENTLOG. 318 */ 319 typedef struct smb_sel { 320 smb_header_t smbsel_hdr; /* structure header */ 321 uint16_t smbsel_len; /* log area length */ 322 uint16_t smbsel_hdroff; /* header offset */ 323 uint16_t smbsel_dataoff; /* data offset */ 324 uint8_t smbsel_method; /* access method */ 325 uint8_t smbsel_status; /* status flags */ 326 uint32_t smbsel_token; /* change token */ 327 uint32_t smbsel_addr; /* access method address */ 328 uint8_t smbsel_format; /* header format */ 329 uint8_t smbsel_typec; /* number of type descriptors */ 330 uint8_t smbsel_typesz; /* size of each type descriptor */ 331 uint8_t smbsel_typev[1]; /* array of type descriptors */ 332 } smb_sel_t; 333 334 /* 335 * SMBIOS implementation structure for SMB_TYPE_MEMARRAY. 336 */ 337 typedef struct smb_memarray { 338 smb_header_t smbmarr_hdr; /* structure header */ 339 uint8_t smbmarr_loc; /* location */ 340 uint8_t smbmarr_use; /* use */ 341 uint8_t smbmarr_ecc; /* error detect/correct mechanism */ 342 uint32_t smbmarr_cap; /* maximum capacity */ 343 uint16_t smbmarr_err; /* error handle */ 344 uint16_t smbmarr_ndevs; /* number of slots or sockets */ 345 uint64_t smbmarr_extcap; /* extended maximum capacity */ 346 } smb_memarray_t; 347 348 /* 349 * SMBIOS implementation structure for SMB_TYPE_MEMARRAYMAP. 350 */ 351 typedef struct smb_memarrmap { 352 smb_header_t smbamap_hdr; /* structure header */ 353 uint32_t smbamap_start; /* starting address in kilobytes */ 354 uint32_t smbamap_end; /* ending address in kilobytes */ 355 uint16_t smbamap_array; /* physical memory array handle */ 356 uint8_t smbamap_width; /* partition width */ 357 uint64_t smbamap_extstart; /* extended starting address in bytes */ 358 uint64_t smbamap_extend; /* extended ending address in bytes */ 359 } smb_memarrmap_t; 360 361 /* 362 * SMBIOS implementation structure for SMB_TYPE_MEMDEVICE. 363 */ 364 typedef struct smb_memdevice { 365 smb_header_t smbmdev_hdr; /* structure header */ 366 uint16_t smbmdev_array; /* array handle */ 367 uint16_t smbmdev_error; /* error handle */ 368 uint16_t smbmdev_twidth; /* total width */ 369 uint16_t smbmdev_dwidth; /* data width */ 370 uint16_t smbmdev_size; /* size in either K or MB */ 371 uint8_t smbmdev_form; /* form factor */ 372 uint8_t smbmdev_set; /* device set */ 373 uint8_t smbmdev_dloc; /* device locator */ 374 uint8_t smbmdev_bloc; /* bank locator */ 375 uint8_t smbmdev_type; /* memory type */ 376 uint16_t smbmdev_flags; /* detail flags */ 377 uint16_t smbmdev_speed; /* speed in MT/s */ 378 uint8_t smbmdev_manufacturer; /* manufacturer */ 379 uint8_t smbmdev_serial; /* serial number */ 380 uint8_t smbmdev_asset; /* asset tag */ 381 uint8_t smbmdev_part; /* part number */ 382 uint8_t smbmdev_attrs; /* attributes */ 383 uint32_t smbmdev_extsize; /* extended size */ 384 uint16_t smbmdev_clkspeed; /* configured clock speed */ 385 uint16_t smbmdev_minvolt; /* minimum voltage */ 386 uint16_t smbmdev_maxvolt; /* maximum voltage */ 387 uint16_t smbmdev_confvolt; /* configured voltage */ 388 /* Added in SMBIOS 3.2 */ 389 uint8_t smbmdev_memtech; /* memory technology */ 390 uint16_t smbmdev_opmode; /* memory operating mode capability */ 391 uint8_t smbmdev_fwver; /* firmware version */ 392 uint16_t smbmdev_modulemfgid; /* module manufacturer ID */ 393 uint16_t smbmdev_moduleprodid; /* module product ID */ 394 uint16_t smbmdev_memsysmfgid; /* memory controller manufacturer id */ 395 uint16_t smbmdev_memsysprodid; /* memory controller product id */ 396 uint64_t smbmdev_nvsize; /* non-volatile memory size */ 397 uint64_t smbmdev_volsize; /* volatile memory size */ 398 uint64_t smbmdev_cachesize; /* cache size */ 399 uint64_t smbmdev_logicalsize; /* logical size */ 400 /* Added in SMBIOS 3.3 */ 401 uint32_t smbmdev_extspeed; /* Extended device speed */ 402 uint32_t smbmdev_extclkspeed; /* Extended clock speed */ 403 /* Added in SMBIOS 3.7 */ 404 uint16_t smbmdev_pmic0mfgid; /* PMIC0 Manufacturer ID */ 405 uint16_t smbmdev_pmic0rev; /* PMIC0 Revision */ 406 uint16_t smbmdev_rcdmfgid; /* RCD Manufacturer ID */ 407 uint16_t smbmdev_rcdrev; /* RCD Revision */ 408 } smb_memdevice_t; 409 410 #define SMB_MDS_KBYTES 0x8000 /* size in specified in kilobytes */ 411 412 /* 413 * SMBIOS implementation structure for SMB_TYPE_MEMDEVICEMAP. 414 */ 415 typedef struct smb_memdevmap { 416 smb_header_t smbdmap_hdr; /* structure header */ 417 uint32_t smbdmap_start; /* starting address in kilobytes */ 418 uint32_t smbdmap_end; /* ending address in kilobytes */ 419 uint16_t smbdmap_device; /* memory device handle */ 420 uint16_t smbdmap_array; /* memory array mapped address handle */ 421 uint8_t smbdmap_rpos; /* row position */ 422 uint8_t smbdmap_ipos; /* interleave position */ 423 uint8_t smbdmap_idepth; /* interleave depth */ 424 uint64_t smbdmap_extstart; /* extended starting address */ 425 uint64_t smbdmap_extend; /* extended ending address */ 426 } smb_memdevmap_t; 427 428 typedef struct smb_pointdev { 429 smb_header_t smbpdev_hdr; /* structure header */ 430 uint8_t smbpdev_type; /* device type */ 431 uint8_t smbpdev_iface; /* device interface */ 432 uint8_t smbpdev_nbuttons; /* number of buttons */ 433 } smb_pointdev_t; 434 435 /* 436 * SMBIOS implementation structure for SMB_TYPE_BATTERY. 437 */ 438 typedef struct smb_battery { 439 smb_header_t smbbat_hdr; /* structure header */ 440 uint8_t smbbat_loc; /* location */ 441 uint8_t smbbat_manufacturer; /* manufacturer */ 442 uint8_t smbbat_date; /* manufacture date */ 443 uint8_t smbbat_serial; /* serial number */ 444 uint8_t smbbat_devname; /* device name */ 445 uint8_t smbbat_chem; /* device chemistry */ 446 uint16_t smbbat_cap; /* design capacity in mW hours */ 447 uint16_t smbbat_volt; /* design voltage in mV */ 448 uint8_t smbbat_version; /* SBDS version string */ 449 uint8_t smbbat_err; /* error percentage */ 450 uint16_t smbbat_ssn; /* SBDS serial number */ 451 uint16_t smbbat_sdate; /* SBDS manufacture date */ 452 uint8_t smbbat_schem; /* SBDS chemistry string */ 453 uint8_t smbbat_mult; /* design capacity multiplier */ 454 uint32_t smbbat_oemdata; /* OEM-specific data */ 455 } smb_battery_t; 456 457 /* 458 * SMBIOS implementation structure for SMB_TYPE_SECURITY. 459 */ 460 typedef struct smb_hwsec { 461 smb_header_t smbhs_hdr; /* structure header */ 462 uint8_t smbhs_settings; /* settings byte */ 463 } smb_hwsec_t; 464 465 #define SMB_HWS_PWR_PS(x) (((x) & 0xC0) >> 6) 466 #define SMB_HWS_KBD_PS(x) (((x) & 0x30) >> 4) 467 #define SMB_HWS_ADM_PS(x) (((x) & 0x0C) >> 2) 468 #define SMB_HWS_PAN_PS(x) (((x) & 0x03) >> 0) 469 470 /* 471 * SMBIOS implementation structure for SMB_TYPE_VPROBE. 472 */ 473 typedef struct smb_vprobe { 474 smb_header_t smbvpr_hdr; /* structure header */ 475 uint8_t smbvpr_descr; /* description string */ 476 uint8_t smbvpr_locstat; /* location and status */ 477 uint16_t smbvpr_maxval; /* maximum voltage */ 478 uint16_t smbvpr_minval; /* minimum voltage */ 479 uint16_t smbvpr_resolution; /* probe resolution */ 480 uint16_t smbvpr_tolerance; /* probe tolerance */ 481 uint16_t smbvpr_accuracy; /* probe accuracy */ 482 uint32_t smbvpr_oem; /* vendor-specific data */ 483 uint16_t smbvpr_nominal; /* nominal value */ 484 } smb_vprobe_t; 485 486 #define SMB_VPROBE_MINLEN 0x14 487 #define SMB_VPROBE_NOMINAL_MINLEN 0x16 488 489 #define SMB_VPROBE_LOCATION(x) ((x) & 0x1f) 490 #define SMB_VPROBE_STATUS(x) (((x) >> 5) & 0x7) 491 492 /* 493 * SMBIOS implementation structure for SMB_TYPE_COOLDEV. 494 */ 495 typedef struct smb_cooldev { 496 smb_header_t smbcdev_hdr; /* structure header */ 497 uint16_t smbcdev_tprobe; /* temperature probe */ 498 uint8_t smbcdev_typstat; /* type and status */ 499 uint8_t smbcdev_group; /* group identifier */ 500 uint32_t smbcdev_oem; /* vendor-specific data */ 501 uint16_t smbcdev_nominal; /* nominal value */ 502 uint8_t smbcdev_descr; /* description string */ 503 } smb_cooldev_t; 504 505 #define SMB_COOLDEV_MINLEN 0x0c 506 #define SMB_COOLDEV_NOMINAL_MINLEN 0x0e 507 #define SMB_COOLDEV_DESCR_MINLEN 0x0f 508 509 #define SMB_COOLDEV_TYPE(x) ((x) & 0x1f) 510 #define SMB_COOLDEV_STATUS(x) (((x) >> 5) & 0x7) 511 512 /* 513 * SMBIOS implementation structure for SMB_TYPE_TPROBE. 514 */ 515 typedef struct smb_tprobe { 516 smb_header_t smbtpr_hdr; /* structure header */ 517 uint8_t smbtpr_descr; /* description string */ 518 uint8_t smbtpr_locstat; /* location and status */ 519 uint16_t smbtpr_maxval; /* maximum temperature */ 520 uint16_t smbtpr_minval; /* minimum temperature */ 521 uint16_t smbtpr_resolution; /* probe resolution */ 522 uint16_t smbtpr_tolerance; /* probe tolerance */ 523 uint16_t smbtpr_accuracy; /* probe accuracy */ 524 uint32_t smbtpr_oem; /* vendor-specific data */ 525 uint16_t smbtpr_nominal; /* nominal value */ 526 } smb_tprobe_t; 527 528 #define SMB_TPROBE_MINLEN 0x14 529 #define SMB_TPROBE_NOMINAL_MINLEN 0x16 530 531 #define SMB_TPROBE_LOCATION(x) ((x) & 0x1f) 532 #define SMB_TPROBE_STATUS(x) (((x) >> 5) & 0x7) 533 534 /* 535 * SMBIOS implementation structure for SMB_TYPE_IPROBE. 536 */ 537 typedef struct smb_iprobe { 538 smb_header_t smbipr_hdr; /* structure header */ 539 uint8_t smbipr_descr; /* description string */ 540 uint8_t smbipr_locstat; /* location and status */ 541 uint16_t smbipr_maxval; /* maximum current */ 542 uint16_t smbipr_minval; /* minimum current */ 543 uint16_t smbipr_resolution; /* probe resolution */ 544 uint16_t smbipr_tolerance; /* probe tolerance */ 545 uint16_t smbipr_accuracy; /* probe accuracy */ 546 uint32_t smbipr_oem; /* vendor-specific data */ 547 uint16_t smbipr_nominal; /* nominal value */ 548 } smb_iprobe_t; 549 550 #define SMB_IPROBE_MINLEN 0x14 551 #define SMB_IPROBE_NOMINAL_MINLEN 0x16 552 553 #define SMB_IPROBE_LOCATION(x) ((x) & 0x1f) 554 #define SMB_IPROBE_STATUS(x) (((x) >> 5) & 0x7) 555 556 /* 557 * SMBIOS implementation structure for SMB_TYPE_BOOT. 558 */ 559 typedef struct smb_boot { 560 smb_header_t smbbo_hdr; /* structure header */ 561 uint8_t smbbo_pad[6]; /* reserved for future use */ 562 uint8_t smbbo_status[1]; /* variable-length status buffer */ 563 } smb_boot_t; 564 565 /* 566 * SMBIOS implementation structure for SMB_TYPE_IPMIDEV. 567 */ 568 typedef struct smb_ipmi { 569 smb_header_t smbipm_hdr; /* structure header */ 570 uint8_t smbipm_type; /* interface type */ 571 uint8_t smbipm_spec; /* specification revision */ 572 uint8_t smbipm_i2c; /* i2C slave address */ 573 uint8_t smbipm_bus; /* NV storage device bus ID */ 574 uint64_t smbipm_addr; /* base address */ 575 uint8_t smbipm_info; /* base address modifier/intr info */ 576 uint8_t smbipm_intr; /* interrupt number */ 577 } smb_ipmi_t; 578 579 #define SMB_IPM_SPEC_MAJOR(x) (((x) & 0xF0) >> 4) 580 #define SMB_IPM_SPEC_MINOR(x) ((x) & 0x0F) 581 582 #define SMB_IPM_ADDR_IO 1ULL 583 584 #define SMB_IPM_INFO_REGS(x) (((x) & 0xC0) >> 6) 585 #define SMB_IPM_INFO_LSB(x) (((x) & 0x10) >> 4) 586 #define SMB_IPM_INFO_ISPEC(x) (((x) & 0x08) >> 3) 587 #define SMB_IPM_INFO_IPOL(x) (((x) & 0x02) >> 1) 588 #define SMB_IPM_INFO_IMODE(x) (((x) & 0x01) >> 0) 589 590 #define SMB_IPM_REGS_1B 0 591 #define SMB_IPM_REGS_4B 1 592 #define SMB_IPM_REGS_16B 2 593 594 #define SMB_IPM_IPOL_LO 0 595 #define SMB_IPM_IPOL_HI 1 596 597 #define SMB_IPM_IMODE_EDGE 0 598 #define SMB_IPM_IMODE_LEVEL 1 599 600 /* 601 * SMBIOS implementation structure for SMB_TYPE_POWERSUP. 602 */ 603 typedef struct smb_powersup { 604 smb_header_t smbpsup_hdr; /* structure header */ 605 uint8_t smbpsup_group; /* group id */ 606 uint8_t smbpsup_loc; /* location tag */ 607 uint8_t smbpsup_devname; /* device name */ 608 uint8_t smbpsup_manufacturer; /* manufacturer */ 609 uint8_t smbpsup_serial; /* serial number */ 610 uint8_t smbpsup_asset; /* asset tag */ 611 uint8_t smbpsup_part; /* part number */ 612 uint8_t smbpsup_rev; /* revision string */ 613 uint16_t smbpsup_max; /* max output in milliwatts */ 614 uint16_t smbpsup_char; /* characteristics */ 615 uint16_t smbpsup_vprobe; /* voltage probe handle */ 616 uint16_t smbpsup_cooldev; /* cooling device handle */ 617 uint16_t smbpsup_iprobe; /* current probe handle */ 618 } smb_powersup_t; 619 620 #define SMB_PSU_CHARS_ISHOT(x) ((x) & 0x01) 621 #define SMB_PSU_CHARS_ISPRES(x) ((x) & 0x02) 622 #define SMB_PSU_CHARS_ISUNPLUG(x) ((x) & 0x04) 623 #define SMB_PSU_CHARS_IVRS(x) (((x) >> 3) & 0xf) 624 #define SMB_PSU_CHARS_STATUS(x) (((x) >> 7) & 0x7) 625 #define SMB_PSU_CHARS_TYPE(x) (((x) >> 10) & 0xf) 626 627 /* 628 * SMBIOS implementation structure for SMB_TYPE_OBDEVEXT. 629 */ 630 typedef struct smb_obdev_ext { 631 smb_header_t smbobe_hdr; /* structure header */ 632 uint8_t smbobe_name; /* reference designation */ 633 uint8_t smbobe_dtype; /* device type */ 634 uint8_t smbobe_dti; /* device type instance */ 635 uint16_t smbobe_sg; /* segment group number */ 636 uint8_t smbobe_bus; /* bus number */ 637 uint8_t smbobe_df; /* device/function number */ 638 } smb_obdev_ext_t; 639 640 /* 641 * SMBIOS implementation structure for SMB_TYPE_PROCESSOR_INFO 642 */ 643 typedef struct smb_processor_info { 644 smb_header_t smbpai_hdr; /* structure handle */ 645 uint16_t smbpai_proc; /* processor handle */ 646 uint8_t smbpai_len; /* length of processor specific data */ 647 uint8_t smbpai_type; /* processor type */ 648 uint8_t smbpai_data[]; /* processor-specific block */ 649 } smb_processor_info_t; 650 651 typedef struct smb_processor_info_riscv { 652 uint16_t smbpairv_vers; /* structure revision */ 653 uint8_t smbpairv_len; /* length of structure */ 654 uint8_t smbpairv_hartid[16]; /* id of the hart */ 655 uint8_t smbpairv_boot; /* boot hart */ 656 uint8_t smbpairv_vendid[16]; /* machine vendor id */ 657 uint8_t smbpairv_archid[16]; /* arch vendor id */ 658 uint8_t smbpairv_machid[16]; /* machine impl id */ 659 uint32_t smbpairv_isa; /* supported ISA */ 660 uint8_t smbpairv_privlvl; /* supported privilege levels */ 661 uint8_t smbpairv_metdi[16]; /* Machine exception trap delegation */ 662 uint8_t smbpairv_mitdi[16]; /* Machine interrupt trap delegation */ 663 uint8_t smbpairv_xlen; /* Register width */ 664 uint8_t smbpairv_mxlen; /* Machine register width */ 665 uint8_t smbpairv_rsvd; /* Reserved */ 666 uint8_t smbpairv_sxlen; /* Supervisor register width */ 667 uint8_t smbpairv_uxlen; /* User register width */ 668 } smb_processor_info_riscv_t; 669 670 /* 671 * SMBIOS implementation structure for SMBIOS_TYPE_FWINFO. 672 */ 673 typedef struct smb_fwinfo { 674 smb_header_t smbfwii_hdr; /* structure handle */ 675 uint8_t smbfwii_name; /* Firmware component name */ 676 uint8_t smbfwii_vers; /* Firmware version */ 677 uint8_t smbfwii_vers_fmt; /* Version format */ 678 uint8_t smbfwii_id; /* Firmware ID */ 679 uint8_t smbfwii_id_fmt; /* Firmware ID format */ 680 uint8_t smbfwii_reldate; /* Release Date */ 681 uint8_t smbfwii_mfg; /* Manufacturer */ 682 uint8_t smbfwii_lsv; /* Lowest supported version */ 683 uint64_t smbfwii_imgsz; /* Image size */ 684 uint16_t smbfwii_chars; /* Characteristics */ 685 uint8_t smbfwii_state; /* State */ 686 uint8_t smbfwii_ncomps; /* Number of associated components */ 687 uint16_t smbfwii_comps[]; /* Variable handles */ 688 } smb_fwinfo_t; 689 690 /* 691 * SMBIOS implementation structure for SMBIOS_TYPE_STRPROP. 692 */ 693 typedef struct smb_strprop { 694 smb_header_t smbstrp_hdr; /* structure handle */ 695 uint16_t smbstrp_prop_id; /* string property ID */ 696 uint8_t smbstrp_prop_val; /* string property value */ 697 uint16_t smbstrp_phdl; /* parent handle */ 698 } smb_strprop_t; 699 700 /* 701 * SMBIOS implementation structure for SUN_OEM_EXT_PROCESSOR. 702 */ 703 typedef struct smb_processor_ext { 704 smb_header_t smbpre_hdr; /* structure header */ 705 uint16_t smbpre_processor; /* processor handle */ 706 uint8_t smbpre_fru; /* FRU indicator */ 707 uint8_t smbpre_n; /* number of APIC IDs */ 708 uint16_t smbpre_apicid[1]; /* strand initial apic id */ 709 } smb_processor_ext_t; 710 711 /* 712 * SMBIOS implementation structure for SUN_OEM_EXT_PORT. 713 */ 714 typedef struct smb_port_ext { 715 smb_header_t smbpoe_hdr; /* structure header */ 716 uint16_t smbpoe_chassis; /* chassis handle */ 717 uint16_t smbpoe_port; /* port connector handle */ 718 uint8_t smbpoe_dtype; /* device type */ 719 uint16_t smbpoe_devhdl; /* device handle */ 720 uint8_t smbpoe_phy; /* PHY number */ 721 } smb_port_ext_t; 722 723 /* 724 * SMBIOS implementation structure for SUN_OEM_PCIEXRC. 725 */ 726 typedef struct smb_pciexrc { 727 smb_header_t smbpciexrc_hdr; /* structure header */ 728 uint16_t smbpciexrc_bboard; /* base board handle */ 729 uint16_t smbpciexrc_bdf; /* PCI Bus/Dev/Func */ 730 } smb_pciexrc_t; 731 732 /* 733 * SMBIOS implementation structure for SUN_OEM_EXT_MEMARRAY. 734 */ 735 typedef struct smb_memarray_ext { 736 smb_header_t smbmarre_hdr; /* structure header */ 737 uint16_t smbmarre_ma; /* memory array handle */ 738 uint16_t smbmarre_component; /* component parent handle */ 739 uint16_t smbmarre_bdf; /* PCI bus/dev/funct */ 740 } smb_memarray_ext_t; 741 742 /* 743 * SMBIOS implementation structure for SUN_OEM_EXT_MEMDEVICE. 744 */ 745 typedef struct smb_memdevice_ext { 746 smb_header_t smbmdeve_hdr; /* structure header */ 747 uint16_t smbmdeve_mdev; /* memory device handle */ 748 uint8_t smbmdeve_dchan; /* DRAM channel */ 749 uint8_t smbmdeve_ncs; /* number of chip select */ 750 uint8_t smbmdeve_cs[]; /* chip selects */ 751 } smb_memdevice_ext_t; 752 753 #pragma pack() 754 755 typedef struct smb_struct { 756 const smb_header_t *smbst_hdr; /* address of raw structure data */ 757 const uchar_t *smbst_str; /* address of string data (if any) */ 758 const uchar_t *smbst_end; /* address of 0x0000 ending tag */ 759 struct smb_struct *smbst_next; /* next structure in hash chain */ 760 uint16_t *smbst_strtab; /* string index -> offset table */ 761 uint_t smbst_strtablen; /* length of smbst_strtab */ 762 } smb_struct_t; 763 764 struct smbios_hdl { 765 smbios_entry_point_t sh_ent_type; /* structure table entry point type */ 766 smbios_entry_t sh_ent; /* structure table entry point */ 767 uint_t sh_ent_stnum; /* number of structure table entries */ 768 const void *sh_buf; /* structure table buffer */ 769 size_t sh_buflen; /* size of structure table buffer */ 770 smb_struct_t *sh_structs; /* array of structure descriptors */ 771 uint_t sh_nstructs; /* number of active structures */ 772 smb_struct_t **sh_hash; /* hash bucket array for descriptors */ 773 uint_t sh_hashlen; /* hash bucket array length */ 774 int sh_err; /* error code for smbios_errno() */ 775 int sh_libvers; /* library client abi version */ 776 int sh_smbvers; /* derived underlying format version */ 777 uint_t sh_flags; /* miscellaneous flags (see below) */ 778 }; 779 780 #define SMB_FL_DEBUG 0x1 /* print debug messages for this hdl */ 781 #define SMB_FL_BUFALLOC 0x2 /* sh_buf was allocated by library */ 782 #define SMB_FL_TRUNC 0x4 /* smbios table is truncated */ 783 784 #define SMB_BIOS_DEVICE "/dev/xsvc" /* device w/ BIOS physmem */ 785 #define SMB_SMBIOS_DEVICE "/dev/smbios" /* device w/ SMBIOS image */ 786 787 #define SMB_RANGE_START 0xF0000 /* start of physical address range */ 788 #define SMB_RANGE_LIMIT 0xFFFFF /* limit of physical address range */ 789 #define SMB_SCAN_STEP 16 /* stepping by paragraph */ 790 791 #define SMB_MAJMIN(M, m) ((((M) & 0xFF) << 8) | ((m) & 0xFF)) 792 #define SMB_MAJOR(v) (((v) & 0xFF00) >> 8) 793 #define SMB_MINOR(v) (((v) & 0x00FF)) 794 795 #define ESMB_BASE 1000 /* base value for libsmbios errnos */ 796 797 enum { 798 ESMB_NOTFOUND = ESMB_BASE, /* SMBIOS table not found on system */ 799 ESMB_MAPDEV, /* failed to map SMBIOS table */ 800 ESMB_NOENT, /* failed to locate structure */ 801 ESMB_NOMEM, /* failed to allocate memory */ 802 ESMB_NOHDR, /* failed to read SMBIOS header */ 803 ESMB_NOSTAB, /* failed to read SMBIOS struct table */ 804 ESMB_NOINFO, /* no common info for structure */ 805 ESMB_SHORT, /* buffer length doesn't match header */ 806 ESMB_CORRUPT, /* buffer struct or len is corrupt */ 807 ESMB_VERSION, /* version not supported by library */ 808 ESMB_NOTSUP, /* feature not supported by provider */ 809 ESMB_HEADER, /* SMBIOS header corrupt or invalid */ 810 ESMB_OLD, /* SMBIOS version is too old for us */ 811 ESMB_NEW, /* SMBIOS version is too new for us */ 812 ESMB_CKSUM, /* SMBIOS header checksum mismatch */ 813 ESMB_INVAL, /* invalid function call argument */ 814 ESMB_TYPE, /* structure type mismatch */ 815 ESMB_UNKNOWN /* unknown error (maximum value tag) */ 816 }; 817 818 extern const smb_struct_t *smb_lookup_type(smbios_hdl_t *, uint_t); 819 extern const smb_struct_t *smb_lookup_id(smbios_hdl_t *, uint_t); 820 extern const char *smb_strptr(const smb_struct_t *, uint_t); 821 extern boolean_t smb_gteq(smbios_hdl_t *, int); 822 extern boolean_t smb_libgteq(smbios_hdl_t *, int); 823 824 extern int smb_set_errno(smbios_hdl_t *, int); 825 extern smbios_hdl_t *smb_open_error(smbios_hdl_t *, int *, int); 826 extern const char *smb_strerror(int); 827 828 extern void *smb_alloc(size_t); 829 extern void *smb_zalloc(size_t); 830 extern void smb_free(void *, size_t); 831 832 extern void smb_dprintf(smbios_hdl_t *, const char *, ...); 833 834 extern int _smb_debug; 835 836 /* 837 * The following series of structures represent the base versions of public 838 * structures that are used inside by the smbios routines. This allows the 839 * common code to properly know how much it should or should not bzero and how 840 * to handle additions to the spec. Types should only be added here if we need 841 * to extend the public structures in sys/smbios.h due to a change in the spec. 842 * 843 * Types here have the name smb_base_%s which corresponds to smbios_%s. 844 */ 845 typedef struct smb_base_chassis { 846 uint32_t smbbc_oemdata; /* OEM-specific data */ 847 uint8_t smbbc_lock; /* lock present? */ 848 uint8_t smbbc_type; /* type */ 849 uint8_t smbbc_bustate; /* boot-up state */ 850 uint8_t smbbc_psstate; /* power supply state */ 851 uint8_t smbbc_thstate; /* thermal state */ 852 uint8_t smbbc_security; /* security status */ 853 uint8_t smbbc_uheight; /* enclosure height in U's */ 854 uint8_t smbbc_cords; /* number of power cords */ 855 uint8_t smbbc_elems; /* number of element records (n) */ 856 uint8_t smbbc_elemlen; /* length of contained element (m) */ 857 } smb_base_chassis_t; 858 859 typedef struct smb_base_processor { 860 uint64_t smbbp_cpuid; /* processor cpuid information */ 861 uint32_t smbbp_family; /* processor family */ 862 uint8_t smbbp_type; /* processor type (SMB_PRT_*) */ 863 uint8_t smbbp_voltage; /* voltage (SMB_PRV_*) */ 864 uint8_t smbbp_status; /* status (SMB_PRS_*) */ 865 uint8_t smbbp_upgrade; /* upgrade (SMB_PRU_*) */ 866 uint32_t smbbp_clkspeed; /* external clock speed in MHz */ 867 uint32_t smbbp_maxspeed; /* maximum speed in MHz */ 868 uint32_t smbbp_curspeed; /* current speed in MHz */ 869 id_t smbbp_l1cache; /* L1 cache handle */ 870 id_t smbbp_l2cache; /* L2 cache handle */ 871 id_t smbbp_l3cache; /* L3 cache handle */ 872 } smb_base_processor_t; 873 874 typedef struct smb_base_memdevice { 875 id_t smbbmd_array; /* handle of physical memory array */ 876 id_t smbbmd_error; /* handle of memory error data */ 877 uint32_t smbbmd_twidth; /* total width in bits including ecc */ 878 uint32_t smbbmd_dwidth; /* data width in bits */ 879 uint64_t smbbmd_size; /* size in bytes (see note above) */ 880 uint8_t smbbmd_form; /* form factor */ 881 uint8_t smbbmd_set; /* set (0x00=none, 0xFF=unknown) */ 882 uint8_t smbbmd_type; /* memory type */ 883 uint8_t smbbmd_pad; /* padding */ 884 uint32_t smbbmd_flags; /* flags (see below) */ 885 uint32_t smbbmd_speed; /* speed in MHz */ 886 const char *smbbmd_dloc; /* physical device locator string */ 887 const char *smbbmd_bloc; /* physical bank locator string */ 888 uint8_t smbbmd_rank; /* rank */ 889 } smb_base_memdevice_t; 890 891 typedef struct smb_base_bios { 892 const char *smbbb_vendor; /* bios vendor string */ 893 const char *smbbb_version; /* bios version string */ 894 const char *smbbb_reldate; /* bios release date */ 895 uint32_t smbbb_segment; /* bios address segment location */ 896 uint32_t smbbb_romsize; /* bios rom size in bytes */ 897 uint32_t smbbb_runsize; /* bios image size in bytes */ 898 uint64_t smbbb_cflags; /* bios characteristics */ 899 const uint8_t *smbbb_xcflags; /* bios characteristics extensions */ 900 size_t smbbb_nxcflags; /* number of smbb_xcflags[] bytes */ 901 smbios_version_t smbbb_biosv; /* bios version */ 902 smbios_version_t smbbb_ecfwv; /* bios embedded ctrl f/w version */ 903 } smb_base_bios_t; 904 905 typedef struct smb_base_cache { 906 uint32_t smbba_maxsize; /* maximum installed size in bytes */ 907 uint32_t smbba_size; /* installed size in bytes */ 908 uint16_t smbba_stype; /* supported SRAM types (SMB_CAT_*) */ 909 uint16_t smbba_ctype; /* current SRAM type (SMB_CAT_*) */ 910 uint8_t smbba_speed; /* speed in nanoseconds */ 911 uint8_t smbba_etype; /* error correction type (SMB_CAE_*) */ 912 uint8_t smbba_ltype; /* logical cache type (SMB_CAG_*) */ 913 uint8_t smbba_assoc; /* associativity (SMB_CAA_*) */ 914 uint8_t smbba_level; /* cache level */ 915 uint8_t smbba_mode; /* cache mode (SMB_CAM_*) */ 916 uint8_t smbba_location; /* cache location (SMB_CAL_*) */ 917 uint8_t smbba_flags; /* cache flags (SMB_CAF_*) */ 918 } smb_base_cache_t; 919 920 typedef struct smb_base_slot { 921 const char *smbbl_name; /* reference designation */ 922 uint8_t smbbl_type; /* slot type */ 923 uint8_t smbbl_width; /* slot data bus width */ 924 uint8_t smbbl_usage; /* current usage */ 925 uint8_t smbbl_length; /* slot length */ 926 uint16_t smbbl_id; /* slot ID */ 927 uint8_t smbbl_ch1; /* slot characteristics 1 */ 928 uint8_t smbbl_ch2; /* slot characteristics 2 */ 929 uint16_t smbbl_sg; /* segment group number */ 930 uint8_t smbbl_bus; /* bus number */ 931 uint8_t smbbl_df; /* device/function number */ 932 } smb_base_slot_t; 933 934 /* 935 * Prior to reivison 3.5 of the library and interface we had embedded a 256 byte 936 * string for the SKU into here rather than pointing to constant data. This, 937 * combined withe bugs in the implementation, generally led to strings with 938 * garbage. As part of fixing this with the 3.5 support, we moved the struct to 939 * ve more inline with everything else. 940 */ 941 typedef struct smb_chassis_pre35 { 942 uint32_t smbc_oemdata; /* OEM-specific data */ 943 uint8_t smbc_lock; /* lock present? */ 944 uint8_t smbc_type; /* type */ 945 uint8_t smbc_bustate; /* boot-up state */ 946 uint8_t smbc_psstate; /* power supply state */ 947 uint8_t smbc_thstate; /* thermal state */ 948 uint8_t smbc_security; /* security status */ 949 uint8_t smbc_uheight; /* enclosure height in U's */ 950 uint8_t smbc_cords; /* number of power cords */ 951 uint8_t smbc_elems; /* number of element records (n) */ 952 uint8_t smbc_elemlen; /* length of contained element (m) */ 953 char smbc_sku[256]; 954 } smb_chassis_pre35_t; 955 956 #ifdef __cplusplus 957 } 958 #endif 959 960 #endif /* _SYS_SMBIOS_IMPL_H */ 961