Home | History | Annotate | Line # | Download | only in dev
ipmivar.h revision 1.4
      1 /* $NetBSD: ipmivar.h,v 1.4 2024/12/03 19:55:33 riastradh Exp $ */
      2 
      3 /*
      4  * Copyright (c) 2005 Jordan Hargrave
      5  * All rights reserved.
      6  *
      7  * Redistribution and use in source and binary forms, with or without
      8  * modification, are permitted provided that the following conditions
      9  * are met:
     10  * 1. Redistributions of source code must retain the above copyright
     11  *    notice, this list of conditions and the following disclaimer.
     12  * 2. Redistributions in binary form must reproduce the above copyright
     13  *    notice, this list of conditions and the following disclaimer in the
     14  *    documentation and/or other materials provided with the distribution.
     15  *
     16  * THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
     17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     19  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR
     20  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     26  * SUCH DAMAGE.
     27  *
     28  */
     29 
     30 #include <sys/mutex.h>
     31 #include <sys/condvar.h>
     32 
     33 #include <dev/sysmon/sysmonvar.h>
     34 
     35 #ifndef _IPMIVAR_H_
     36 #define _IPMIVAR_H_
     37 
     38 #define IPMI_IF_KCS		1
     39 #define IPMI_IF_SMIC		2
     40 #define IPMI_IF_BT		3
     41 #define IPMI_IF_SSIF		4
     42 
     43 #define IPMI_IF_KCS_NREGS	2
     44 #define IPMI_IF_SMIC_NREGS	3
     45 #define IPMI_IF_BT_NREGS	3
     46 #define IPMI_IF_SSIF_NREGS	2
     47 
     48 struct ipmi_thread;
     49 struct ipmi_softc;
     50 
     51 struct ipmi_attach_args {
     52 	bus_space_tag_t	iaa_iot;
     53 	bus_space_tag_t	iaa_memt;
     54 
     55 	int		iaa_if_type;
     56 	int		iaa_if_rev;
     57 	int		iaa_if_iotype;
     58 	bus_addr_t	iaa_if_iobase;
     59 	int		iaa_if_iospacing;
     60 	int		iaa_if_irq;
     61 	int		iaa_if_irqlvl;
     62 };
     63 
     64 struct ipmi_if {
     65 	const char	*name;
     66 	int		nregs;
     67 	void		*(*buildmsg)(struct ipmi_softc *, int, int, int,
     68 			    const void *, int *);
     69 	int		(*sendmsg)(struct ipmi_softc *, int, const uint8_t *);
     70 	int		(*recvmsg)(struct ipmi_softc *, int, int *, uint8_t *);
     71 	int		(*reset)(struct ipmi_softc *);
     72 	int		(*probe)(struct ipmi_softc *);
     73 };
     74 
     75 struct ipmi_softc {
     76 	device_t		sc_dev;
     77 
     78 	struct ipmi_if		*sc_if;		/* Interface layer */
     79 	int			sc_if_iospacing; /* Spacing of I/O ports */
     80 	int			sc_if_rev;	/* IPMI Revision */
     81 	struct ipmi_attach_args	sc_ia;
     82 
     83 	void			*sc_ih;		/* Interrupt/IO handles */
     84 	bus_space_tag_t		sc_iot;
     85 	bus_space_handle_t	sc_ioh;
     86 
     87 	int			sc_btseq;
     88 
     89 	struct lwp		*sc_kthread;
     90 
     91 	int			sc_max_retries;
     92 
     93 	kmutex_t		sc_poll_mtx;
     94 	kcondvar_t		sc_poll_cv;
     95 	kcondvar_t		sc_mode_cv;
     96 
     97 	kmutex_t		sc_cmd_mtx;
     98 	kmutex_t		sc_sleep_mtx;
     99 	kcondvar_t		sc_cmd_sleep;
    100 
    101 	struct ipmi_bmc_args	*sc_iowait_args;
    102 
    103 	struct ipmi_sensor	*current_sensor;
    104 	bool			sc_thread_running;
    105 	bool			sc_thread_ready;
    106 	bool			sc_tickle_due;
    107 	struct sysmon_wdog	sc_wdog;
    108 	struct sysmon_envsys	*sc_envsys;
    109 	envsys_data_t		*sc_sensor;
    110 	int 		sc_nsensors; /* total number of sensors */
    111 
    112 	char		sc_buf[1024 + 3]; /* IPMI_MAX_RX + 3 */
    113 	bool		sc_buf_rsvd;
    114 
    115 	/* request busy */
    116 	int		sc_mode;
    117 #define IPMI_MODE_IDLE		0
    118 #define IPMI_MODE_COMMAND	1
    119 #define IPMI_MODE_ENVSYS	2
    120 	bool		sc_sent;
    121 
    122 	/* dummy */
    123 	int		sc_address;
    124 	int		sc_lun;
    125 
    126 	/* saved from last SEND_COMMAND */
    127 	int		sc_msgid;
    128 	int		sc_netfn;
    129 	int		sc_cmd;
    130 };
    131 
    132 struct ipmi_device_id {
    133 	uint8_t		deviceid;
    134 	uint8_t		revision;
    135 	uint8_t		fwrev1;
    136 	uint8_t		fwrev2;
    137 	uint8_t		version;
    138 	uint8_t		additional;
    139 	uint8_t		manufacturer[3];
    140 	uint8_t		product[2];
    141 	uint8_t		vendor[4];
    142 } __packed;
    143 
    144 struct ipmi_thread {
    145 	struct ipmi_softc   *sc;
    146 	volatile int	    running;
    147 };
    148 
    149 #define IPMI_WDOG_USE_NOLOG		__BIT(7)
    150 #define IPMI_WDOG_USE_NOSTOP		__BIT(6)
    151 #define IPMI_WDOG_USE_RSVD1		__BITS(5, 3)
    152 #define IPMI_WDOG_USE_USE_MASK		__BITS(2, 0)
    153 #define IPMI_WDOG_USE_USE_RSVD		__SHIFTIN(0, IPMI_WDOG_USE_USE_MASK);
    154 #define IPMI_WDOG_USE_USE_FRB2		__SHIFTIN(1, IPMI_WDOG_USE_USE_MASK);
    155 #define IPMI_WDOG_USE_USE_POST		__SHIFTIN(2, IPMI_WDOG_USE_USE_MASK);
    156 #define IPMI_WDOG_USE_USE_OSLOAD	__SHIFTIN(3, IPMI_WDOG_USE_USE_MASK);
    157 #define IPMI_WDOG_USE_USE_OS		__SHIFTIN(4, IPMI_WDOG_USE_USE_MASK);
    158 #define IPMI_WDOG_USE_USE_OEM		__SHIFTIN(5, IPMI_WDOG_USE_USE_MASK);
    159 
    160 #define IPMI_WDOG_ACT_PRE_RSVD1		__BIT(7)
    161 #define IPMI_WDOG_ACT_PRE_MASK		__BITS(6, 4)
    162 #define IPMI_WDOG_ACT_PRE_DISABLED	__SHIFTIN(0, IPMI_WDOG_ACT_MASK)
    163 #define IPMI_WDOG_ACT_PRE_SMI		__SHIFTIN(1, IPMI_WDOG_ACT_MASK)
    164 #define IPMI_WDOG_ACT_PRE_NMI		__SHIFTIN(2, IPMI_WDOG_ACT_MASK)
    165 #define IPMI_WDOG_ACT_PRE_INTERRUPT	__SHIFTIN(3, IPMI_WDOG_ACT_MASK)
    166 #define IPMI_WDOG_ACT_PRE_RSVD0		__BIT(3)
    167 #define IPMI_WDOG_ACT_MASK		__BITS(2, 0)
    168 #define IPMI_WDOG_ACT_DISABLED		__SHIFTIN(0, IPMI_WDOG_ACT_MASK)
    169 #define IPMI_WDOG_ACT_RESET		__SHIFTIN(1, IPMI_WDOG_ACT_MASK)
    170 #define IPMI_WDOG_ACT_PWROFF		__SHIFTIN(2, IPMI_WDOG_ACT_MASK)
    171 #define IPMI_WDOG_ACT_PWRCYCLE		__SHIFTIN(3, IPMI_WDOG_ACT_MASK)
    172 
    173 #define IPMI_WDOG_FLAGS_RSVD1		__BITS(7, 6)
    174 #define IPMI_WDOG_FLAGS_OEM		__BIT(5)
    175 #define IPMI_WDOG_FLAGS_OS		__BIT(4)
    176 #define IPMI_WDOG_FLAGS_OSLOAD		__BIT(3)
    177 #define IPMI_WDOG_FLAGS_POST		__BIT(2)
    178 #define IPMI_WDOG_FLAGS_FRB2		__BIT(1)
    179 #define IPMI_WDOG_FLAGS_RSVD0		__BIT(0)
    180 
    181 struct ipmi_set_watchdog {
    182 	uint8_t		wdog_use;
    183 	uint8_t		wdog_action;
    184 	uint8_t		wdog_pretimeout;
    185 	uint8_t		wdog_flags;
    186 	uint16_t		wdog_timeout;
    187 } __packed;
    188 
    189 struct ipmi_get_watchdog {
    190 	uint8_t		wdog_use;
    191 	uint8_t		wdog_action;
    192 	uint8_t		wdog_pretimeout;
    193 	uint8_t		wdog_flags;
    194 	uint16_t		wdog_timeout;
    195 	uint16_t		wdog_countdown;
    196 } __packed;
    197 
    198 struct dmd_ipmi {
    199 	uint8_t	dmd_sig[4];		/* Signature 'IPMI' */
    200 	uint8_t	dmd_i2c_address;	/* Address of BMC */
    201 	uint8_t	dmd_nvram_address;	/* Address of NVRAM */
    202 	uint8_t	dmd_if_type;		/* IPMI Interface Type */
    203 	uint8_t	dmd_if_rev;		/* IPMI Interface Revision */
    204 } __packed;
    205 
    206 #define APP_NETFN			0x06
    207 #define APP_GET_DEVICE_ID		0x01
    208 #define APP_RESET_WATCHDOG		0x22
    209 #define APP_SET_WATCHDOG_TIMER		0x24
    210 #define APP_GET_WATCHDOG_TIMER		0x25
    211 
    212 #define TRANSPORT_NETFN			0xC
    213 #define BRIDGE_NETFN			0x2
    214 
    215 #define STORAGE_NETFN			0x0A
    216 #define STORAGE_GET_FRU_INV_AREA	0x10
    217 #define STORAGE_READ_FRU_DATA		0x11
    218 #define STORAGE_RESERVE_SDR		0x22
    219 #define STORAGE_GET_SDR			0x23
    220 #define STORAGE_ADD_SDR			0x24
    221 #define STORAGE_ADD_PARTIAL_SDR		0x25
    222 #define STORAGE_DELETE_SDR		0x26
    223 #define STORAGE_RESERVE_SEL		0x42
    224 #define STORAGE_GET_SEL			0x43
    225 #define STORAGE_ADD_SEL			0x44
    226 #define STORAGE_ADD_PARTIAL_SEL		0x45
    227 #define STORAGE_DELETE_SEL		0x46
    228 
    229 #define SE_NETFN			0x04
    230 #define SE_GET_SDR_INFO			0x20
    231 #define SE_GET_SDR			0x21
    232 #define SE_RESERVE_SDR			0x22
    233 #define SE_GET_SENSOR_FACTOR		0x23
    234 #define SE_SET_SENSOR_HYSTERESIS	0x24
    235 #define SE_GET_SENSOR_HYSTERESIS	0x25
    236 #define SE_SET_SENSOR_THRESHOLD		0x26
    237 #define SE_GET_SENSOR_THRESHOLD		0x27
    238 #define SE_SET_SENSOR_EVENT_ENABLE	0x28
    239 #define SE_GET_SENSOR_EVENT_ENABLE	0x29
    240 #define SE_REARM_SENSOR_EVENTS		0x2A
    241 #define SE_GET_SENSOR_EVENT_STATUS	0x2B
    242 #define SE_GET_SENSOR_READING		0x2D
    243 #define SE_SET_SENSOR_TYPE		0x2E
    244 #define SE_GET_SENSOR_TYPE		0x2F
    245 
    246 struct sdrhdr {
    247 	uint16_t	record_id;		/* SDR Record ID */
    248 	uint8_t	sdr_version;		/* SDR Version */
    249 	uint8_t	record_type;		/* SDR Record Type */
    250 	uint8_t	record_length;		/* SDR Record Length */
    251 } __packed;
    252 
    253 /* SDR: Record Type 1 */
    254 struct sdrtype1 {
    255 	struct sdrhdr	sdrhdr;
    256 
    257 	uint8_t	owner_id;
    258 	uint8_t	owner_lun;
    259 	uint8_t	sensor_num;
    260 
    261 	uint8_t	entity_id;
    262 	uint8_t	entity_instance;
    263 	uint8_t	sensor_init;
    264 	uint8_t	sensor_caps;
    265 	uint8_t	sensor_type;
    266 	uint8_t	event_code;
    267 	uint16_t	trigger_mask;
    268 	uint16_t	reading_mask;
    269 	uint16_t	settable_mask;
    270 	uint8_t	units1;
    271 	uint8_t	units2;
    272 	uint8_t	units3;
    273 	uint8_t	linear;
    274 	uint8_t	m;
    275 	uint8_t	m_tolerance;
    276 	uint8_t	b;
    277 	uint8_t	b_accuracy;
    278 	uint8_t	accuracyexp;
    279 	uint8_t	rbexp;
    280 	uint8_t	analogchars;
    281 	uint8_t	nominalreading;
    282 	uint8_t	normalmax;
    283 	uint8_t	normalmin;
    284 	uint8_t	sensormax;
    285 	uint8_t	sensormin;
    286 	uint8_t	uppernr;
    287 	uint8_t	upperc;
    288 	uint8_t	uppernc;
    289 	uint8_t	lowernr;
    290 	uint8_t	lowerc;
    291 	uint8_t	lowernc;
    292 	uint8_t	physt;
    293 	uint8_t	nhyst;
    294 	uint8_t	resvd[2];
    295 	uint8_t	oem;
    296 	uint8_t	typelen;
    297 	uint8_t	name[1];
    298 } __packed;
    299 
    300 /* SDR: Record Type 2 */
    301 struct sdrtype2 {
    302 	struct sdrhdr	sdrhdr;
    303 
    304 	uint8_t	owner_id;
    305 	uint8_t	owner_lun;
    306 	uint8_t	sensor_num;
    307 
    308 	uint8_t	entity_id;
    309 	uint8_t	entity_instance;
    310 	uint8_t	sensor_init;
    311 	uint8_t	sensor_caps;
    312 	uint8_t	sensor_type;
    313 	uint8_t	event_code;
    314 	uint16_t	trigger_mask;
    315 	uint16_t	reading_mask;
    316 	uint16_t	set_mask;
    317 	uint8_t	units1;
    318 	uint8_t	units2;
    319 	uint8_t	units3;
    320 	uint8_t	share1;
    321 	uint8_t	share2;
    322 	uint8_t	physt;
    323 	uint8_t	nhyst;
    324 	uint8_t	resvd[3];
    325 	uint8_t	oem;
    326 	uint8_t	typelen;
    327 	uint8_t	name[1];
    328 } __packed;
    329 
    330 #endif				/* _IPMIVAR_H_ */
    331