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, Version 1.0 only 6 * (the "License"). You may not use this file except in compliance 7 * with the License. 8 * 9 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 10 * or http://www.opensolaris.org/os/licensing. 11 * See the License for the specific language governing permissions 12 * and limitations under the License. 13 * 14 * When distributing Covered Code, include this CDDL HEADER in each 15 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 16 * If applicable, add the following below this CDDL HEADER, with the 17 * fields enclosed by brackets "[]" replaced with your own identifying 18 * information: Portions Copyright [yyyy] [name of copyright owner] 19 * 20 * CDDL HEADER END 21 */ 22 23 /* 24 * Copyright 2005 Sun Microsystems, Inc. All rights reserved. 25 * Use is subject to license terms. 26 */ 27 28 /* 29 * This header file defines the implementation structures for the SMBIOS access 30 * library, libsmbios, and an equivalent kernel module. Clients should use 31 * the <smbios.h> or <sys/smbios.h> header files to access DMTF SMBIOS 32 * information, NOT these underlying implementation structures from the spec. 33 * In short, do not user this header file or these routines for any purpose. 34 */ 35 36 #ifndef _SYS_SMBIOS_IMPL_H 37 #define _SYS_SMBIOS_IMPL_H 38 39 #pragma ident "%Z%%M% %I% %E% SMI" 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 #pragma pack(1) 56 57 typedef struct smb_header { 58 uint8_t smbh_type; /* structure type (SMB_TYPE_* value) */ 59 uint8_t smbh_len; /* length in bytes of formatted area */ 60 uint16_t smbh_hdl; /* structure handle */ 61 } smb_header_t; 62 63 typedef struct smb_bios { 64 smb_header_t smbbi_hdr; /* structure header */ 65 uint8_t smbbi_vendor; /* bios vendor string */ 66 uint8_t smbbi_version; /* bios version string */ 67 uint16_t smbbi_segment; /* segment location of bios address */ 68 uint8_t smbbi_reldate; /* bios release date */ 69 uint8_t smbbi_romsize; /* bios rom size (64k * (n + 1)) */ 70 uint64_t smbbi_cflags; /* bios characteristics */ 71 uint8_t smbbi_xcflags[1]; /* bios characteristics extensions */ 72 } smb_bios_t; 73 74 typedef struct smb_system { 75 smb_header_t smbsi_hdr; /* structure header */ 76 uint8_t smbsi_manufacturer; /* manufacturer */ 77 uint8_t smbsi_product; /* product name */ 78 uint8_t smbsi_version; /* version */ 79 uint8_t smbsi_serial; /* serial number */ 80 uint8_t smbsi_uuid[16]; /* UUID */ 81 uint8_t smbsi_wakeup; /* wake-up type */ 82 uint8_t smbsi_sku; /* SKU number */ 83 uint8_t smbsi_family; /* family */ 84 } smb_system_t; 85 86 typedef struct smb_bboard { 87 smb_header_t smbbb_hdr; /* structure header */ 88 uint8_t smbbb_manufacturer; /* manufacturer */ 89 uint8_t smbbb_product; /* product name */ 90 uint8_t smbbb_version; /* version */ 91 uint8_t smbbb_serial; /* serial number */ 92 uint8_t smbbb_asset; /* asset tag */ 93 uint8_t smbbb_flags; /* feature flags */ 94 uint8_t smbbb_location; /* location in chassis */ 95 uint16_t smbbb_chassis; /* chassis handle */ 96 uint8_t smbbb_type; /* board type */ 97 uint8_t smbbb_cn; /* number of contained handles */ 98 uint16_t smbbb_cv[1]; /* array of contained handles */ 99 } smb_bboard_t; 100 101 typedef struct smb_chassis { 102 smb_header_t smbch_hdr; /* structure header */ 103 uint8_t smbch_manufacturer; /* manufacturer */ 104 uint8_t smbch_type; /* type */ 105 uint8_t smbch_version; /* version */ 106 uint8_t smbch_serial; /* serial number */ 107 uint8_t smbch_asset; /* asset tag */ 108 uint8_t smbch_bustate; /* boot-up state */ 109 uint8_t smbch_psstate; /* power supply state */ 110 uint8_t smbch_thstate; /* thermal state */ 111 uint8_t smbch_security; /* security state */ 112 uint32_t smbch_oemdata; /* OEM-specific data */ 113 uint8_t smbch_uheight; /* enclosure height */ 114 uint8_t smbch_cords; /* number of power cords */ 115 uint8_t smbch_cn; /* number of contained records */ 116 uint8_t smbch_cm; /* size of contained records */ 117 uint8_t smbch_cv[1]; /* array of contained records */ 118 } smb_chassis_t; 119 120 #define SMB_CHT_LOCK 0x80 /* lock bit within smbch_type */ 121 122 typedef struct smb_processor { 123 smb_header_t smbpr_hdr; /* structure header */ 124 uint8_t smbpr_socket; /* socket designation */ 125 uint8_t smbpr_type; /* processor type (see <smbios.h>) */ 126 uint8_t smbpr_family; /* processor family (see <smbios.h>) */ 127 uint8_t smbpr_manufacturer; /* manufacturer */ 128 uint64_t smbpr_cpuid; /* processor cpuid information */ 129 uint8_t smbpr_version; /* version */ 130 uint8_t smbpr_voltage; /* voltage */ 131 uint16_t smbpr_clkspeed; /* external clock speed in MHz */ 132 uint16_t smbpr_maxspeed; /* maximum speed in MHz */ 133 uint16_t smbpr_curspeed; /* current speed in MHz */ 134 uint8_t smbpr_status; /* status (see <smbios.h>) */ 135 uint8_t smbpr_upgrade; /* upgrade */ 136 uint16_t smbpr_l1cache; /* L1 cache handle (if any) */ 137 uint16_t smbpr_l2cache; /* L2 cache handle (if any) */ 138 uint16_t smbpr_l3cache; /* L3 cache handle (if any) */ 139 uint8_t smbpr_serial; /* serial number */ 140 uint8_t smbpr_asset; /* asset tag */ 141 uint8_t smbpr_part; /* part number */ 142 } smb_processor_t; 143 144 typedef struct smb_cache { 145 smb_header_t smbca_hdr; /* structure header */ 146 uint8_t smbca_socket; /* socket designation */ 147 uint16_t smbca_config; /* cache configuration */ 148 uint16_t smbca_maxsize; /* maximum installed size */ 149 uint16_t smbca_size; /* installed size */ 150 uint16_t smbca_stype; /* supported SRAM type */ 151 uint16_t smbca_ctype; /* current SRAM type */ 152 uint8_t smbca_speed; /* speed in nanoseconds */ 153 uint8_t smbca_etype; /* error correction type */ 154 uint8_t smbca_ltype; /* logical cache type */ 155 uint8_t smbca_assoc; /* associativity */ 156 } smb_cache_t; 157 158 #define SMB_CACHE_SIZE(s) \ 159 (((s) & 0x8000) ? (((s) & 0x7FFF) << 1) : (s)) 160 161 #define SMB_CACHE_CFG_MODE(c) (((c) >> 8) & 3) 162 #define SMB_CACHE_CFG_ENABLED(c) (((c) >> 7) & 1) 163 #define SMB_CACHE_CFG_LOCATION(c) (((c) >> 5) & 3) 164 #define SMB_CACHE_CFG_SOCKETED(c) (((c) >> 3) & 1) 165 #define SMB_CACHE_CFG_LEVEL(c) (((c) & 7) + 1) 166 167 typedef struct smb_port { 168 smb_header_t smbpo_hdr; /* structure header */ 169 uint8_t smbpo_iref; /* internal reference designator */ 170 uint8_t smbpo_itype; /* internal connector type */ 171 uint8_t smbpo_eref; /* external reference designator */ 172 uint8_t smbpo_etype; /* external connector type */ 173 uint8_t smbpo_ptype; /* port type */ 174 } smb_port_t; 175 176 typedef struct smb_slot { 177 smb_header_t smbsl_hdr; /* structure header */ 178 uint8_t smbsl_name; /* reference designation */ 179 uint8_t smbsl_type; /* slot type */ 180 uint8_t smbsl_width; /* slot data bus width */ 181 uint8_t smbsl_usage; /* current usage */ 182 uint8_t smbsl_length; /* slot length */ 183 uint16_t smbsl_id; /* slot ID */ 184 uint8_t smbsl_ch1; /* slot characteristics 1 */ 185 uint8_t smbsl_ch2; /* slot characteristics 2 */ 186 } smb_slot_t; 187 188 typedef struct smb_obdev { 189 uint8_t smbob_type; /* encoded type and enable bit */ 190 uint8_t smbob_name; /* descriptiong string */ 191 } smb_obdev_t; 192 193 #define SMB_OBT_ENABLED 0x80 /* enable bit within smbob_type */ 194 195 typedef struct smb_strtab { 196 smb_header_t smbtb_hdr; /* structure header */ 197 uint8_t smbtb_count; /* number of strings */ 198 } smb_strtab_t; 199 200 typedef struct smb_lang { 201 smb_header_t smblang_hdr; /* structure header */ 202 uint8_t smblang_num; /* number of installed languages */ 203 uint8_t smblang_flags; /* flags */ 204 uint8_t smblang_resv[15]; /* reserved for future use */ 205 uint8_t smblang_cur; /* current language string */ 206 } smb_lang_t; 207 208 typedef struct smb_sel { 209 smb_header_t smbsel_hdr; /* structure header */ 210 uint16_t smbsel_len; /* log area length */ 211 uint16_t smbsel_hdroff; /* header offset */ 212 uint16_t smbsel_dataoff; /* data offset */ 213 uint8_t smbsel_method; /* access method */ 214 uint8_t smbsel_status; /* status flags */ 215 uint32_t smbsel_token; /* change token */ 216 uint32_t smbsel_addr; /* access method address */ 217 uint8_t smbsel_format; /* header format */ 218 uint8_t smbsel_typec; /* number of type descriptors */ 219 uint8_t smbsel_typesz; /* size of each type descriptor */ 220 uint8_t smbsel_typev[1]; /* array of type descriptors */ 221 } smb_sel_t; 222 223 typedef struct smb_memarray { 224 smb_header_t smbmarr_hdr; /* structure header */ 225 uint8_t smbmarr_loc; /* location */ 226 uint8_t smbmarr_use; /* use */ 227 uint8_t smbmarr_ecc; /* error detect/correct mechanism */ 228 uint32_t smbmarr_cap; /* maximum capacity */ 229 uint16_t smbmarr_err; /* error handle */ 230 uint16_t smbmarr_ndevs; /* number of slots or sockets */ 231 } smb_memarray_t; 232 233 typedef struct smb_memarrmap { 234 smb_header_t smbamap_hdr; /* structure header */ 235 uint32_t smbamap_start; /* starting address in kilobytes */ 236 uint32_t smbamap_end; /* ending address in kilobytes */ 237 uint16_t smbamap_array; /* physical memory array handle */ 238 uint8_t smbamap_width; /* partition width */ 239 } smb_memarrmap_t; 240 241 typedef struct smb_memdevice { 242 smb_header_t smbmdev_hdr; /* structure header */ 243 uint16_t smbmdev_array; /* array handle */ 244 uint16_t smbmdev_error; /* error handle */ 245 uint16_t smbmdev_twidth; /* total width */ 246 uint16_t smbmdev_dwidth; /* data width */ 247 uint16_t smbmdev_size; /* size in either K or MB */ 248 uint8_t smbmdev_form; /* form factor */ 249 uint8_t smbmdev_set; /* device set */ 250 uint8_t smbmdev_dloc; /* device locator */ 251 uint8_t smbmdev_bloc; /* bank locator */ 252 uint8_t smbmdev_type; /* memory type */ 253 uint16_t smbmdev_flags; /* detail flags */ 254 uint16_t smbmdev_speed; /* speed in MHz */ 255 uint8_t smbmdev_manufacturer; /* manufacturer */ 256 uint8_t smbmdev_serial; /* serial number */ 257 uint8_t smbmdev_asset; /* asset tag */ 258 uint8_t smbmdev_part; /* part number */ 259 } smb_memdevice_t; 260 261 #define SMB_MDS_KBYTES 0x8000 /* size in specified in kilobytes */ 262 263 typedef struct smb_memdevmap { 264 smb_header_t smbdmap_hdr; /* structure header */ 265 uint32_t smbdmap_start; /* starting address in kilobytes */ 266 uint32_t smbdmap_end; /* ending address in kilobytes */ 267 uint16_t smbdmap_device; /* memory device handle */ 268 uint16_t smbdmap_array; /* memory array mapped address handle */ 269 uint8_t smbdmap_rpos; /* row position */ 270 uint8_t smbdmap_ipos; /* interleave position */ 271 uint8_t smbdmap_idepth; /* interleave depth */ 272 } smb_memdevmap_t; 273 274 typedef struct smb_battery { 275 smb_header_t smbbat_hdr; /* structure header */ 276 uint8_t smbbat_loc; /* location */ 277 uint8_t smbbat_manufacturer; /* manufacturer */ 278 uint8_t smbbat_date; /* manufacture date */ 279 uint8_t smbbat_serial; /* serial number */ 280 uint8_t smbbat_devname; /* device name */ 281 uint8_t smbbat_chem; /* device chemistry */ 282 uint16_t smbbat_cap; /* design capacity in mW hours */ 283 uint16_t smbbat_volt; /* design voltage in mV */ 284 uint8_t smbbat_version; /* SBDS version string */ 285 uint8_t smbbat_err; /* error percentage */ 286 uint16_t smbbat_ssn; /* SBDS serial number */ 287 uint16_t smbbat_sdate; /* SBDS manufacture date */ 288 uint8_t smbbat_schem; /* SBDS chemistry string */ 289 uint8_t smbbat_mult; /* design capacity multiplier */ 290 uint32_t smbbat_oemdata; /* OEM-specific data */ 291 } smb_battery_t; 292 293 typedef struct smb_hwsec { 294 smb_header_t smbhs_hdr; /* structure header */ 295 uint8_t smbhs_settings; /* settings byte */ 296 } smb_hwsec_t; 297 298 #define SMB_HWS_PWR_PS(x) (((x) & 0xC0) >> 6) 299 #define SMB_HWS_KBD_PS(x) (((x) & 0x30) >> 4) 300 #define SMB_HWS_ADM_PS(x) (((x) & 0x0C) >> 2) 301 #define SMB_HWS_PAN_PS(x) (((x) & 0x03) >> 0) 302 303 typedef struct smb_boot { 304 smb_header_t smbbo_hdr; /* structure header */ 305 uint8_t smbbo_pad[6]; /* reserved for future use */ 306 uint8_t smbbo_status[1]; /* variable-length status buffer */ 307 } smb_boot_t; 308 309 typedef struct smb_ipmi { 310 smb_header_t smbipm_hdr; /* structure header */ 311 uint8_t smbipm_type; /* interface type */ 312 uint8_t smbipm_spec; /* specification revision */ 313 uint8_t smbipm_i2c; /* i2C slave address */ 314 uint8_t smbipm_bus; /* NV storage device bus ID */ 315 uint64_t smbipm_addr; /* base address */ 316 uint8_t smbipm_info; /* base address modifier/intr info */ 317 uint8_t smbipm_intr; /* interrupt number */ 318 } smb_ipmi_t; 319 320 #define SMB_IPM_SPEC_MAJOR(x) (((x) & 0xF0) >> 4) 321 #define SMB_IPM_SPEC_MINOR(x) ((x) & 0x0F) 322 323 #define SMB_IPM_ADDR_IO 1ULL 324 325 #define SMB_IPM_INFO_REGS(x) (((x) & 0xC0) >> 6) 326 #define SMB_IPM_INFO_LSB(x) (((x) & 0x10) >> 4) 327 #define SMB_IPM_INFO_ISPEC(x) (((x) & 0x08) >> 3) 328 #define SMB_IPM_INFO_IPOL(x) (((x) & 0x02) >> 1) 329 #define SMB_IPM_INFO_IMODE(x) (((x) & 0x01) >> 0) 330 331 #define SMB_IPM_REGS_1B 0 332 #define SMB_IPM_REGS_4B 1 333 #define SMB_IPM_REGS_16B 2 334 335 #define SMB_IPM_IPOL_LO 0 336 #define SMB_IPM_IPOL_HI 1 337 338 #define SMB_IPM_IMODE_EDGE 0 339 #define SMB_IPM_IMODE_LEVEL 1 340 341 typedef struct smb_powersup { 342 smb_header_t smbpsup_hdr; /* structure header */ 343 uint8_t smbpsup_group; /* group id */ 344 uint8_t smbpsup_loc; /* location tag */ 345 uint8_t smbpsup_devname; /* device name */ 346 uint8_t smbpsup_manufacturer; /* manufacturer */ 347 uint8_t smbpsup_serial; /* serial number */ 348 uint8_t smbpsup_asset; /* asset tag */ 349 uint8_t smbpsup_part; /* part number */ 350 uint8_t smbpsup_rev; /* revision string */ 351 uint16_t smbpsup_max; /* max output in milliwatts */ 352 uint16_t smbpsup_char; /* characteristics */ 353 uint16_t smbpsup_vprobe; /* voltage probe handle */ 354 uint16_t smbpsup_cooldev; /* cooling device handle */ 355 uint16_t smbpsup_iprobe; /* current probe handle */ 356 } smb_powersup_t; 357 358 #pragma pack() 359 360 typedef struct smb_struct { 361 const smb_header_t *smbst_hdr; /* address of raw structure data */ 362 const uchar_t *smbst_str; /* address of string data (if any) */ 363 const uchar_t *smbst_end; /* address of 0x0000 ending tag */ 364 struct smb_struct *smbst_next; /* next structure in hash chain */ 365 uint16_t *smbst_strtab; /* string index -> offset table */ 366 uint_t smbst_strtablen; /* length of smbst_strtab */ 367 } smb_struct_t; 368 369 struct smbios_hdl { 370 smbios_entry_t sh_ent; /* structure table entry point */ 371 const void *sh_buf; /* structure table buffer */ 372 size_t sh_buflen; /* size of structure table buffer */ 373 smb_struct_t *sh_structs; /* array of structure descriptors */ 374 uint_t sh_nstructs; /* number of active structures */ 375 smb_struct_t **sh_hash; /* hash bucket array for descriptors */ 376 uint_t sh_hashlen; /* hash bucket array length */ 377 int sh_err; /* error code for smbios_errno() */ 378 int sh_libvers; /* library client abi version */ 379 int sh_smbvers; /* derived underlying format version */ 380 uint_t sh_flags; /* miscellaneous flags (see below) */ 381 }; 382 383 #define SMB_FL_DEBUG 0x1 /* print debug messages for this hdl */ 384 #define SMB_FL_BUFALLOC 0x2 /* sh_buf was allocated by library */ 385 386 #define SMB_BIOS_DEVICE "/dev/xsvc" /* device w/ BIOS physmem */ 387 #define SMB_SMBIOS_DEVICE "/dev/smbios" /* device w/ SMBIOS image */ 388 389 #define SMB_RANGE_START 0xF0000 /* start of physical address range */ 390 #define SMB_RANGE_LIMIT 0xFFFFF /* limit of physical address range */ 391 392 #define SMB_MAJMIN(M, m) ((((M) & 0xFF) << 16) | ((m) & 0xFF)) 393 #define SMB_MAJOR(v) (((v) & 0xFF00) >> 8) 394 #define SMB_MINOR(v) (((v) & 0x00FF)) 395 396 #define ESMB_BASE 1000 /* base value for libsmbios errnos */ 397 398 enum { 399 ESMB_NOTFOUND = ESMB_BASE, /* SMBIOS table not found on system */ 400 ESMB_MAPDEV, /* failed to map SMBIOS table */ 401 ESMB_NOENT, /* failed to locate structure */ 402 ESMB_NOMEM, /* failed to allocate memory */ 403 ESMB_NOHDR, /* failed to read SMBIOS header */ 404 ESMB_NOSTAB, /* failed to read SMBIOS struct table */ 405 ESMB_NOINFO, /* no common info for structure */ 406 ESMB_SHORT, /* buffer length doesn't match header */ 407 ESMB_CORRUPT, /* buffer struct or len is corrupt */ 408 ESMB_VERSION, /* version not supported by library */ 409 ESMB_NOTSUP, /* feature not supported by provider */ 410 ESMB_HEADER, /* SMBIOS header corrupt or invalid */ 411 ESMB_OLD, /* SMBIOS version is too old for us */ 412 ESMB_NEW, /* SMBIOS version is too new for us */ 413 ESMB_CKSUM, /* SMBIOS header checksum mismatch */ 414 ESMB_INVAL, /* invalid function call argument */ 415 ESMB_TYPE, /* structure type mismatch */ 416 ESMB_UNKNOWN /* unknown error (maximum value tag) */ 417 }; 418 419 extern const smb_struct_t *smb_lookup_type(smbios_hdl_t *, uint_t); 420 extern const smb_struct_t *smb_lookup_id(smbios_hdl_t *, uint_t); 421 extern const char *smb_strptr(const smb_struct_t *, uint_t); 422 extern int smb_gteq(smbios_hdl_t *, int); 423 424 extern int smb_set_errno(smbios_hdl_t *, int); 425 extern smbios_hdl_t *smb_open_error(smbios_hdl_t *, int *, int); 426 extern const char *smb_strerror(int); 427 428 extern void *smb_alloc(size_t); 429 extern void *smb_zalloc(size_t); 430 extern void smb_free(void *, size_t); 431 432 extern void smb_dprintf(smbios_hdl_t *, const char *, ...); 433 434 extern int _smb_debug; 435 436 #ifdef __cplusplus 437 } 438 #endif 439 440 #endif /* _SYS_SMBIOS_IMPL_H */ 441