Home | History | Annotate | Download | only in chip
      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  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
     23  * Use is subject to license terms.
     24  */
     25 
     26 #ifndef _CHIP_H
     27 #define	_CHIP_H
     28 
     29 #include <kstat.h>
     30 #include <libnvpair.h>
     31 #include <fm/libtopo.h>
     32 #include <fm/topo_mod.h>
     33 
     34 #ifdef __cplusplus
     35 extern "C" {
     36 #endif
     37 
     38 #define	CHIP_VERSION		TOPO_VERSION
     39 
     40 /* Below should match the definitions in x86pi_impl.h */
     41 #define	X86PI_FULL		1
     42 #define	X86PI_NONE		2
     43 
     44 /*
     45  * FM_AWARE_SMBIOS means SMBIOS meets FMA needs
     46  * X86PI_FULL is defined as 1 in x86pi.so
     47  * And passed from x86pi.so to chip.so as module
     48  * private data
     49  */
     50 #define	FM_AWARE_SMBIOS(mod)	\
     51 	(topo_mod_getspecific(mod) != NULL && \
     52 	    (*(int *)topo_mod_getspecific(mod) == X86PI_FULL))
     53 #define	IGNORE_ID	0xFFFF
     54 
     55 /*
     56  * These definitions are for the Tree Nodes
     57  * in the FM Topology
     58  */
     59 #define	CHIP_NODE_NAME		"chip"
     60 #define	CORE_NODE_NAME		"core"
     61 #define	STRAND_NODE_NAME	"strand"
     62 #define	MCT_NODE_NAME		"memory-controller"
     63 #define	CHAN_NODE_NAME		"dram-channel"
     64 #define	CS_NODE_NAME		"chip-select"
     65 #define	DIMM_NODE_NAME		"dimm"
     66 #define	RANK_NODE_NAME		"rank"
     67 
     68 #define	PGNAME(prefix)	(prefix##_NODE_NAME "-properties")
     69 
     70 /*
     71  * chip-properties
     72  */
     73 #define	CHIP_VENDOR_ID		"vendor_id"
     74 #define	CHIP_FAMILY		"family"
     75 #define	CHIP_MODEL		"model"
     76 #define	CHIP_STEPPING		"stepping"
     77 #define	CHIP_NCORE		"ncore_per_chip"
     78 
     79 /*
     80  * memory-controller-properties
     81  * check usr/src/uts/i86pc/os/cpuid.c to understand more
     82  * on procnodeid values for AMD & Intel
     83  */
     84 #define	MCT_PROCNODE_ID		"procnodeid"
     85 
     86 /*
     87  * core-properties
     88  */
     89 #define	CORE_CHIP_ID		"chip_id"
     90 #define	CORE_PROCNODE_ID	"procnodeid"
     91 
     92 /*
     93  * strand-properties
     94  */
     95 #define	STRAND_CHIP_ID		"chip_id"
     96 #define	STRAND_PROCNODE_ID	"procnodeid"
     97 #define	STRAND_CORE_ID		"core_id"
     98 #define	STRAND_PKG_CORE_ID	"pkg_core_id"
     99 #define	STRAND_CPU_ID		"cpuid"
    100 
    101 /*
    102  * label property methods
    103  */
    104 #define	SIMPLE_DIMM_LBL		"simple_dimm_label"
    105 #define	SIMPLE_DIMM_LBL_MP	"simple_dimm_label_mp"
    106 #define	SEQ_DIMM_LBL		"seq_dimm_label"
    107 #define	G4_DIMM_LBL		"g4_dimm_label"
    108 #define	G12F_DIMM_LBL		"g12f_dimm_label"
    109 #define	SIMPLE_CHIP_LBL		"simple_chip_label"
    110 #define	G4_CHIP_LBL		"g4_chip_label"
    111 #define	A4FPLUS_CHIP_LBL	"a4fplus_chip_label"
    112 #define	SIMPLE_CS_LBL_MP	"simple_cs_label_mp"
    113 #define	FSB2_CHIP_LBL		"fsb2_chip_label"
    114 
    115 /*
    116  * DIMM serial number property methods
    117  */
    118 #define	GET_DIMM_SERIAL		"get_dimm_serial"
    119 
    120 extern int simple_dimm_label(topo_mod_t *, tnode_t *, topo_version_t,
    121     nvlist_t *, nvlist_t **);
    122 extern int simple_dimm_label_mp(topo_mod_t *, tnode_t *, topo_version_t,
    123     nvlist_t *, nvlist_t **);
    124 extern int seq_dimm_label(topo_mod_t *, tnode_t *, topo_version_t,
    125     nvlist_t *, nvlist_t **);
    126 extern int g4_dimm_label(topo_mod_t *, tnode_t *, topo_version_t, nvlist_t *,
    127     nvlist_t **);
    128 
    129 extern int g12f_dimm_label(topo_mod_t *, tnode_t *, topo_version_t, nvlist_t *,
    130     nvlist_t **);
    131 
    132 extern int simple_chip_label(topo_mod_t *, tnode_t *, topo_version_t,
    133     nvlist_t *, nvlist_t **);
    134 extern int g4_chip_label(topo_mod_t *, tnode_t *, topo_version_t,
    135     nvlist_t *, nvlist_t **);
    136 extern int a4fplus_chip_label(topo_mod_t *, tnode_t *, topo_version_t,
    137     nvlist_t *, nvlist_t **);
    138 extern int simple_cs_label_mp(topo_mod_t *, tnode_t *, topo_version_t,
    139     nvlist_t *, nvlist_t **);
    140 extern int get_dimm_serial(topo_mod_t *, tnode_t *, topo_version_t, nvlist_t *,
    141     nvlist_t **);
    142 extern int fsb2_chip_label(topo_mod_t *, tnode_t *, topo_version_t,
    143     nvlist_t *, nvlist_t **);
    144 
    145 /*
    146  * Support functions of chip_subr.c
    147  */
    148 extern void whinge(topo_mod_t *, int *, const char *, ...);
    149 extern int nvprop_add(topo_mod_t *, nvpair_t *, const char *, tnode_t *);
    150 extern int add_nvlist_strprop(topo_mod_t *, tnode_t *, nvlist_t *,
    151     const char *, const char *, const char **);
    152 extern int add_nvlist_longprop(topo_mod_t *, tnode_t *, nvlist_t *,
    153     const char *, const char *, int32_t *);
    154 extern int add_nvlist_longprops(topo_mod_t *, tnode_t *, nvlist_t *,
    155     const char *, int32_t *, ...);
    156 extern int mkrsrc(topo_mod_t *, tnode_t *, const char *, int,
    157     nvlist_t *, nvlist_t **);
    158 extern nvlist_t *cpu_fmri_create(topo_mod_t *, uint32_t, char *, uint8_t);
    159 extern boolean_t is_xpv();
    160 
    161 /*
    162  * topo methods
    163  */
    164 extern int mem_asru_compute(topo_mod_t *, tnode_t *, topo_version_t,
    165     nvlist_t *, nvlist_t **);
    166 extern int rank_fmri_present(topo_mod_t *, tnode_t *, topo_version_t,
    167     nvlist_t *, nvlist_t **);
    168 extern int rank_fmri_replaced(topo_mod_t *, tnode_t *, topo_version_t,
    169     nvlist_t *, nvlist_t **);
    170 extern int retire_strands(topo_mod_t *, tnode_t *, topo_version_t,
    171     nvlist_t *, nvlist_t **);
    172 extern int unretire_strands(topo_mod_t *, tnode_t *, topo_version_t,
    173     nvlist_t *, nvlist_t **);
    174 extern int service_state_strands(topo_mod_t *, tnode_t *, topo_version_t,
    175     nvlist_t *, nvlist_t **);
    176 extern int unusable_strands(topo_mod_t *, tnode_t *, topo_version_t,
    177     nvlist_t *, nvlist_t **);
    178 extern int ntv_page_retire(topo_mod_t *, tnode_t *, topo_version_t,
    179     nvlist_t *, nvlist_t **);
    180 extern int ntv_page_service_state(topo_mod_t *, tnode_t *, topo_version_t,
    181     nvlist_t *, nvlist_t **);
    182 extern int ntv_page_unretire(topo_mod_t *, tnode_t *, topo_version_t,
    183     nvlist_t *, nvlist_t **);
    184 extern int ntv_page_unusable(topo_mod_t *, tnode_t *, topo_version_t,
    185     nvlist_t *, nvlist_t **);
    186 
    187 extern int mem_asru_create(topo_mod_t *, nvlist_t *, nvlist_t **);
    188 
    189 /*
    190  * Prototypes for chip_amd.c
    191  */
    192 extern void amd_mc_create(topo_mod_t *, uint16_t, tnode_t *, const char *,
    193     nvlist_t *, int32_t, int32_t, int, int, int *);
    194 
    195 /*
    196  * Prototypes for chip_intel.c
    197  */
    198 extern int mc_offchip_open(void);
    199 extern int mc_offchip_create(topo_mod_t *, tnode_t *, const char *, nvlist_t *);
    200 extern void onchip_mc_create(topo_mod_t *, uint16_t, tnode_t *,
    201     const char *, nvlist_t *);
    202 
    203 extern char *get_fmtstr(topo_mod_t *, nvlist_t *);
    204 extern int store_prop_val(topo_mod_t *, char *, char *, nvlist_t **out);
    205 
    206 /*
    207  * Prototypes for chip_smbios.c
    208  */
    209 
    210 extern int init_chip_smbios(topo_mod_t *);
    211 extern int chip_status_smbios_get(topo_mod_t *, id_t);
    212 extern int chip_fru_smbios_get(topo_mod_t *, id_t);
    213 extern const char *chip_label_smbios_get(topo_mod_t *, tnode_t *, id_t, char *);
    214 extern const char *chip_serial_smbios_get(topo_mod_t *, id_t);
    215 extern const char *chip_part_smbios_get(topo_mod_t *, id_t);
    216 extern const char *chip_rev_smbios_get(topo_mod_t *, id_t);
    217 extern id_t memnode_to_smbiosid(uint16_t, const char *, uint64_t, void *);
    218 
    219 
    220 #ifdef __cplusplus
    221 }
    222 #endif
    223 
    224 #endif /* _CHIP_H */
    225