xref: /illumos-gate/usr/src/lib/fm/topo/libtopo/common/topo_hc.h (revision f52943a93040563107b95bccb9db87d9971ef47d)
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 (c) 2006, 2010, Oracle and/or its affiliates. All rights reserved.
24  * Copyright 2019 Joyent, Inc.
25  */
26 
27 #ifndef _TOPO_HC_H
28 #define	_TOPO_HC_H
29 
30 #ifdef	__cplusplus
31 extern "C" {
32 #endif
33 
34 /*
35  * Allowable hardware component names for hc FMRIs
36  */
37 #define	BANK		"bank"
38 #define	BAY		"bay"
39 #define	BLADE		"blade"
40 #define	BRANCH		"branch"
41 #define	CMP		"CMP"
42 #define	CENTERPLANE	"centerplane"
43 #define	CHASSIS		"chassis"
44 #define	CHIP		"chip"
45 #define	CHIPSET		"chipset"
46 #define	CORE		"core"
47 #define	STRAND		"strand"
48 #define	CHIP_SELECT	"chip-select"
49 #define	CONTROLLER	"controller"
50 #define	CPU		"cpu"
51 #define	CPUBOARD	"cpuboard"
52 #define	DIMM		"dimm"
53 #define	DISK		"disk"
54 #define	DRAM		"dram"
55 #define	DRAMCHANNEL	"dram-channel"
56 #define	FAN		"fan"
57 #define	FANBOARD	"fanboard"
58 #define	FANMODULE	"fanmodule"
59 #define	HBA		"hba"
60 #define	HOSTBRIDGE	"hostbridge"
61 #define	INTERCONNECT	"interconnect"
62 #define	IOBOARD		"ioboard"
63 #define	IPORT		"iport"
64 #define	MEMBOARD	"memboard"
65 #define	MEMORYBUFFER	"memory-buffer"
66 #define	MEMORYCONTROL	"memory-controller"
67 #define	MICROCORE	"micro-core"
68 #define	MOTHERBOARD	"motherboard"
69 #define	NIU		"niu"
70 #define	NIUFN		"niufn"
71 #define	PCI_BUS		"pcibus"
72 #define	PCI_DEVICE	"pcidev"
73 #define	PCI_FUNCTION    "pcifn"
74 #define	PCIEX_BUS	"pciexbus"
75 #define	PCIEX_DEVICE	"pciexdev"
76 #define	PCIEX_FUNCTION  "pciexfn"
77 #define	PCIEX_ROOT	"pciexrc"
78 #define	PCIEX_SWUP	"pciexswu"
79 #define	PCIEX_SWDWN	"pciexswd"
80 #define	PORT		"port"
81 #define	POWERBOARD	"powerboard"
82 #define	POWERMODULE	"powermodule"
83 #define	PSU		"psu"
84 #define	RANK		"rank"
85 #define	RECEPTACLE	"receptacle"
86 #define	RISER		"riser"
87 #define	SASEXPANDER	"sas-expander"
88 #define	SHELF		"shelf"
89 #define	SCSI_DEVICE	"scsi-device"
90 #define	SES_ENCLOSURE	"ses-enclosure"
91 #define	SLOT		"slot"
92 #define	SMP_DEVICE	"smp-device"
93 #define	SP		"sp"
94 #define	SUBCHASSIS	"subchassis"
95 #define	SYSTEMBOARD	"systemboard"
96 #define	TRANSCEIVER	"transceiver"
97 #define	UFM		"ufm"
98 #define	USB_DEVICE	"usb-device"
99 #define	XAUI		"xaui"
100 #define	XFP		"xfp"
101 
102 /*
103  * Allowable hc node property group and property names
104  */
105 #define	TOPO_PGROUP_IO		"io"
106 #define	TOPO_IO_DEVTYPE		"devtype"
107 #define	TOPO_IO_DRIVER		"driver"
108 #define	TOPO_IO_INSTANCE	"instance"
109 #define	TOPO_IO_MODULE		"module"
110 #define	TOPO_IO_DEV		"dev"
111 #define	TOPO_IO_DEVID		"devid"
112 #define	TOPO_IO_DEV_PATH	"devfs-path"
113 #define	TOPO_IO_AP_PATH		"ap-path"
114 #define	TOPO_IO_PHYS_PATH	"phys-path"
115 
116 #define	TOPO_PGROUP_PCI		"pci"
117 #define	TOPO_PCI_VENDID		"vendor-id"
118 #define	TOPO_PCI_VENDNM		"vendor-name"
119 #define	TOPO_PCI_SUBSYSNM	"subsystem-name"
120 #define	TOPO_PCI_DEVID		"device-id"
121 #define	TOPO_PCI_DEVNM		"device-name"
122 #define	TOPO_PCI_EXCAP		"extended-capabilities"
123 #define	TOPO_PCI_BDF		"BDF"
124 #define	TOPO_PCI_CLASS		"class-code"
125 #define	TOPO_PCI_AADDR		"assigned-addresses"
126 
127 #define	TOPO_PCI_MAX_WIDTH	"link-maximum-width"
128 #define	TOPO_PCI_CUR_WIDTH	"link-current-width"
129 #define	TOPO_PCI_MAX_SPEED	"link-maximum-speed"
130 #define	TOPO_PCI_CUR_SPEED	"link-current-speed"
131 #define	TOPO_PCI_SUP_SPEED	"link-supported-speeds"
132 #define	TOPO_PCI_ADMIN_SPEED	"link-admin-target-speed"
133 
134 #define	TOPO_PGROUP_BINDING	"binding"
135 #define	TOPO_BINDING_OCCUPANT	"occupant-path"
136 #define	TOPO_BINDING_DRIVER	"driver"
137 #define	TOPO_BINDING_DEVCTL	"devctl"
138 #define	TOPO_BINDING_ENCLOSURE	"enclosure"
139 #define	TOPO_BINDING_SLOT	"slot"
140 #define	TOPO_BINDING_PORT	"port"
141 
142 #define	TOPO_PGROUP_STORAGE	"storage"
143 #define	TOPO_STORAGE_INITIATOR_PORT	"initiator-port"
144 #define	TOPO_STORAGE_INITIATOR_PORT_PM	"initiator-port-pm"
145 #define	TOPO_STORAGE_TARGET_PORT	"target-port"
146 #define	TOPO_STORAGE_TARGET_PORT_L0ID	"target-port-l0id"
147 #define	TOPO_STORAGE_TARGET_PORT_L0IDS	"target-port-l0ids"
148 #define	TOPO_STORAGE_ATTACHED_PORT	"attached-port"
149 #define	TOPO_STORAGE_TARGET_PORT_PM	"target-port-pm"
150 #define	TOPO_STORAGE_ATTACHED_PORT_PM	"attached-port-pm"
151 #define	TOPO_STORAGE_DEVID		"devid"
152 #define	TOPO_STORAGE_LUN64		"lun64"
153 #define	TOPO_STORAGE_DEVICE_TYPE	"inquiry-device-type"
154 #define	TOPO_STORAGE_MANUFACTURER	"manufacturer"
155 #define	TOPO_STORAGE_MODEL		"model"
156 #define	TOPO_STORAGE_FIRMWARE_REV	"firmware-revision"
157 #define	TOPO_STORAGE_SAS_PHY_MASK	"receptacle-pm"
158 #define	TOPO_STORAGE_SAS_CONNECTOR_TYPE	"sas-connector-type"
159 
160 #define	TOPO_PGROUP_SES		"ses"
161 /* Applied  any SES standard related topo node. */
162 #define	TOPO_PROP_NODE_ID	"node-id"
163 #define	TOPO_PROP_TARGET_PATH	"target-path"
164 #define	TOPO_PROP_SES_DEVID	"ses-devid"
165 #define	TOPO_PROP_SES_DEV_PATH	"ses-devfs-path"
166 #define	TOPO_PROP_SES_PHYS_PATH	"ses-phys-path"
167 #define	TOPO_PROP_SES_TARGET_PORT "ses-target-port"
168 
169 #define	TOPO_PGROUP_SMP		"smp"
170 /* host SMP target related info for an expander node. */
171 #define	TOPO_PROP_SMP_DEVID	"smp-devid"
172 #define	TOPO_PROP_SMP_DEV_PATH	"smp-devfs-path"
173 #define	TOPO_PROP_SMP_PHYS_PATH	"smp-phys-path"
174 #define	TOPO_PROP_SMP_TARGET_PORT	"smp-target-port"
175 #define	TOPO_PROP_SAS_ADDR	"sas-address"
176 #define	TOPO_PROP_PHY_COUNT	"phy-count"
177 #define	TOPO_PROP_PATHS		"paths"
178 #define	TOPO_PROP_CHASSIS_TYPE	"chassis-type"
179 #define	TOPO_PROP_SAS_PHY_MASK	"phy-mask"
180 #define	TOPO_PROP_SAS_CONNECTOR_TYPE	"sas-connector-type"
181 
182 #define	TOPO_PGROUP_PORT	"port"
183 #define	TOPO_PROP_PORT_TYPE	"type"
184 #define	TOPO_PROP_PORT_TYPE_SFF	"sff"
185 #define	TOPO_PROP_PORT_TYPE_USB	"usb"
186 
187 #define	TOPO_PGROUP_TRANSCEIVER	"transceiver"
188 #define	TOPO_PROP_TRANSCEIVER_TYPE	"type"
189 #define	TOPO_PROP_TRANSCEIVER_USABLE	"usable"
190 
191 #define	TOPO_PGROUP_SFF_TRANSCEIVER	"sff-transceiver"
192 #define	TOPO_PORT_SFF_TRANSCEIVER_VENDOR	"vendor"
193 #define	TOPO_PORT_SFF_TRANSCEIVER_PN	"part-number"
194 #define	TOPO_PORT_SFF_TRANSCEIVER_REV	"revision"
195 #define	TOPO_PORT_SFF_TRANSCEIVER_SN	"serial-number"
196 
197 #define	TOPO_PGROUP_USB_PORT	"usb-port"
198 #define	TOPO_PROP_USB_PORT_LPORTS	"logical-ports"
199 #define	TOPO_PROP_USB_PORT_VERSIONS	"usb-versions"
200 #define	TOPO_PROP_USB_PORT_TYPE		"port-type"
201 #define	TOPO_PROP_USB_PORT_ATTRIBUTES	"port-attributes"
202 #define	TOPO_PROP_USB_PORT_A_VISIBLE	"user-visible"
203 #define	TOPO_PROP_USB_PORT_A_CONNECTED	"port-connected"
204 #define	TOPO_PROP_USB_PORT_A_DISCONNECTED	"port-disconnected"
205 #define	TOPO_PROP_USB_PORT_A_EXTERNAL	"external-port"
206 #define	TOPO_PROP_USB_PORT_A_INTERNAL	"internal-port"
207 #define	TOPO_PROP_USB_PORT_NATTRS	5
208 
209 #define	TOPO_PGROUP_USB_PROPS	"usb-properties"
210 #define	TOPO_PGROUP_USB_PROPS_VID	"usb-vendor-id"
211 #define	TOPO_PGROUP_USB_PROPS_PID	"usb-product-id"
212 #define	TOPO_PGROUP_USB_PROPS_REV	"usb-revision-id"
213 #define	TOPO_PGROUP_USB_PROPS_VNAME	"usb-vendor-name"
214 #define	TOPO_PGROUP_USB_PROPS_PNAME	"usb-product-name"
215 #define	TOPO_PGROUP_USB_PROPS_SN	"usb-serialno"
216 #define	TOPO_PGROUP_USB_PROPS_VERSION	"usb-version"
217 #define	TOPO_PGROUP_USB_PROPS_SPEED	"usb-speed"
218 #define	TOPO_PGROUP_USB_PROPS_PORT	"usb-port"
219 #define	TOPO_PGROUP_USB_PROPS_SUPPORTED_SPEEDS	"usb-supported-speeds"
220 #define	TOPO_PGROUP_USB_PROPS_MIN_SPEED	"usb-minimum-speed"
221 
222 
223 /*
224  * These properties will exist on nodes enumerated by the ipmi module. They
225  * are consumed by the fac_prov_ipmi module
226  */
227 #define	TOPO_PROP_IPMI_ENTITY_ID	"entity-id"
228 #define	TOPO_PROP_IPMI_ENTITY_INST	"entity-instance"
229 
230 /*
231  * This property can be statically set in a map file and is consumed by the
232  * fac_prov_ipmi module.
233  */
234 #define	TOPO_PROP_IPMI_ENTITY_LIST	"entity-list"
235 
236 #define	TOPO_PGROUP_SLOT		"slot"
237 #define	TOPO_PROP_SLOT_TYPE		"slot-type"
238 
239 #define	TOPO_PGROUP_DIMM_SLOT		"dimm-slot"
240 #define	TOPO_PROP_DIMM_SLOT_FORM	"form-factor"
241 #define	TOPO_DIMM_SLOT_FORM_DIMM	"DIMM"
242 #define	TOPO_DIMM_SLOT_FORM_SODIMM	"SODIMM"
243 #define	TOPO_DIMM_SLOT_FORM_FBDIMM	"FBDIMM"
244 
245 #define	TOPO_PGROUP_DIMM_PROPS		"dimm-properties"
246 #define	TOPO_PROP_DIMM_TYPE
247 #define	TOPO_DIMM_TYPE_UNKNOWN		"UNKNOWN"
248 #define	TOPO_DIMM_TYPE_DDR		"DDR"
249 #define	TOPO_DIMM_TYPE_DDR2		"DDR2"
250 #define	TOPO_DIMM_TYPE_DDR3		"DDR3"
251 #define	TOPO_DIMM_TYPE_DDR4		"DDR4"
252 #define	TOPO_DIMM_TYPE_LPDDR		"LPDDR"
253 #define	TOPO_DIMM_TYPE_LPDDR2		"LPDDR2"
254 #define	TOPO_DIMM_TYPE_LPDDR3		"LPDDR3"
255 #define	TOPO_DIMM_TYPE_LPDDR4		"LPDDR4"
256 
257 #define	TOPO_PGROUP_MOTHERBOARD		"motherboard-properties"
258 #define	TOPO_PROP_MB_MANUFACTURER	"manufacturer"
259 #define	TOPO_PROP_MB_PRODUCT		"product-id"
260 #define	TOPO_PROP_MB_ASSET		"asset-tag"
261 #define	TOPO_PROP_MB_FIRMWARE_VENDOR	"firmware-vendor"
262 #define	TOPO_PROP_MB_FIRMWARE_RELDATE	"firmware-release-date"
263 
264 #define	TOPO_PGROUP_UFM			"ufm-properties"
265 #define	TOPO_PROP_UFM_DESCR		"ufm-description"
266 
267 #define	TOPO_PGROUP_UFM_SLOT		"ufm-slot-properties"
268 #define	TOPO_PROP_UFM_SLOT_VERSION	"ufm-slot-version"
269 #define	TOPO_PROP_UFM_SLOT_MODE		"ufm-slot-mode"
270 #define	TOPO_PROP_UFM_SLOT_ACTIVE	"ufm-slot-active"
271 
272 #ifdef	__cplusplus
273 }
274 #endif
275 
276 #endif	/* _TOPO_HC_H */
277