2 * QEMU IPMI BT emulation
4 * Copyright (c) 2015 Corey Minyard, MontaVista Software, LLC
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
24 #include "qemu/osdep.h"
25 #include "migration/vmstate.h"
27 #include "qapi/error.h"
28 #include "hw/ipmi/ipmi_bt.h"
30 /* Control register */
31 #define IPMI_BT_CLR_WR_BIT 0
32 #define IPMI_BT_CLR_RD_BIT 1
33 #define IPMI_BT_H2B_ATN_BIT 2
34 #define IPMI_BT_B2H_ATN_BIT 3
35 #define IPMI_BT_SMS_ATN_BIT 4
36 #define IPMI_BT_HBUSY_BIT 6
37 #define IPMI_BT_BBUSY_BIT 7
39 #define IPMI_BT_GET_CLR_WR(d) (((d) >> IPMI_BT_CLR_WR_BIT) & 0x1)
41 #define IPMI_BT_GET_CLR_RD(d) (((d) >> IPMI_BT_CLR_RD_BIT) & 0x1)
43 #define IPMI_BT_GET_H2B_ATN(d) (((d) >> IPMI_BT_H2B_ATN_BIT) & 0x1)
45 #define IPMI_BT_B2H_ATN_MASK (1 << IPMI_BT_B2H_ATN_BIT)
46 #define IPMI_BT_GET_B2H_ATN(d) (((d) >> IPMI_BT_B2H_ATN_BIT) & 0x1)
47 #define IPMI_BT_SET_B2H_ATN(d, v) ((d) = (((d) & ~IPMI_BT_B2H_ATN_MASK) | \
48 (!!(v) << IPMI_BT_B2H_ATN_BIT)))
50 #define IPMI_BT_SMS_ATN_MASK (1 << IPMI_BT_SMS_ATN_BIT)
51 #define IPMI_BT_GET_SMS_ATN(d) (((d) >> IPMI_BT_SMS_ATN_BIT) & 0x1)
52 #define IPMI_BT_SET_SMS_ATN(d, v) ((d) = (((d) & ~IPMI_BT_SMS_ATN_MASK) | \
53 (!!(v) << IPMI_BT_SMS_ATN_BIT)))
55 #define IPMI_BT_HBUSY_MASK (1 << IPMI_BT_HBUSY_BIT)
56 #define IPMI_BT_GET_HBUSY(d) (((d) >> IPMI_BT_HBUSY_BIT) & 0x1)
57 #define IPMI_BT_SET_HBUSY(d, v) ((d) = (((d) & ~IPMI_BT_HBUSY_MASK) | \
58 (!!(v) << IPMI_BT_HBUSY_BIT)))
60 #define IPMI_BT_BBUSY_MASK (1 << IPMI_BT_BBUSY_BIT)
61 #define IPMI_BT_SET_BBUSY(d, v) ((d) = (((d) & ~IPMI_BT_BBUSY_MASK) | \
62 (!!(v) << IPMI_BT_BBUSY_BIT)))
66 #define IPMI_BT_B2H_IRQ_EN_BIT 0
67 #define IPMI_BT_B2H_IRQ_BIT 1
69 #define IPMI_BT_B2H_IRQ_EN_MASK (1 << IPMI_BT_B2H_IRQ_EN_BIT)
70 #define IPMI_BT_GET_B2H_IRQ_EN(d) (((d) >> IPMI_BT_B2H_IRQ_EN_BIT) & 0x1)
71 #define IPMI_BT_SET_B2H_IRQ_EN(d, v) ((d) = (((d) & ~IPMI_BT_B2H_IRQ_EN_MASK) |\
72 (!!(v) << IPMI_BT_B2H_IRQ_EN_BIT)))
74 #define IPMI_BT_B2H_IRQ_MASK (1 << IPMI_BT_B2H_IRQ_BIT)
75 #define IPMI_BT_GET_B2H_IRQ(d) (((d) >> IPMI_BT_B2H_IRQ_BIT) & 0x1)
76 #define IPMI_BT_SET_B2H_IRQ(d, v) ((d) = (((d) & ~IPMI_BT_B2H_IRQ_MASK) | \
77 (!!(v) << IPMI_BT_B2H_IRQ_BIT)))
79 #define IPMI_CMD_GET_BT_INTF_CAP 0x36
81 static void ipmi_bt_raise_irq(IPMIBT *ib)
83 if (ib->use_irq && ib->irqs_enabled && ib->raise_irq) {
88 static void ipmi_bt_lower_irq(IPMIBT *ib)
95 static void ipmi_bt_handle_event(IPMIInterface *ii)
97 IPMIInterfaceClass *iic = IPMI_INTERFACE_GET_CLASS(ii);
98 IPMIBT *ib = iic->get_backend_data(ii);
103 /* Note that overruns are handled by handle_command */
104 if (ib->inmsg[0] != (ib->inlen - 1)) {
105 /* Length mismatch, just ignore. */
106 IPMI_BT_SET_BBUSY(ib->control_reg, 1);
110 if ((ib->inmsg[1] == (IPMI_NETFN_APP << 2)) &&
111 (ib->inmsg[3] == IPMI_CMD_GET_BT_INTF_CAP)) {
112 /* We handle this one ourselves. */
114 ib->outmsg[1] = ib->inmsg[1] | 0x04;
115 ib->outmsg[2] = ib->inmsg[2];
116 ib->outmsg[3] = ib->inmsg[3];
118 ib->outmsg[5] = 1; /* Only support 1 outstanding request. */
119 if (sizeof(ib->inmsg) > 0xff) { /* Input buffer size */
120 ib->outmsg[6] = 0xff;
122 ib->outmsg[6] = (unsigned char) sizeof(ib->inmsg);
124 if (sizeof(ib->outmsg) > 0xff) { /* Output buffer size */
125 ib->outmsg[7] = 0xff;
127 ib->outmsg[7] = (unsigned char) sizeof(ib->outmsg);
129 ib->outmsg[8] = 10; /* Max request to response time */
130 ib->outmsg[9] = 0; /* Don't recommend retries */
132 IPMI_BT_SET_BBUSY(ib->control_reg, 0);
133 IPMI_BT_SET_B2H_ATN(ib->control_reg, 1);
134 if (!IPMI_BT_GET_B2H_IRQ(ib->mask_reg) &&
135 IPMI_BT_GET_B2H_IRQ_EN(ib->mask_reg)) {
136 IPMI_BT_SET_B2H_IRQ(ib->mask_reg, 1);
137 ipmi_bt_raise_irq(ib);
141 ib->waiting_seq = ib->inmsg[2];
142 ib->inmsg[2] = ib->inmsg[1];
144 IPMIBmcClass *bk = IPMI_BMC_GET_CLASS(ib->bmc);
145 bk->handle_command(ib->bmc, ib->inmsg + 2, ib->inlen - 2,
146 sizeof(ib->inmsg), ib->waiting_rsp);
152 static void ipmi_bt_handle_rsp(IPMIInterface *ii, uint8_t msg_id,
153 unsigned char *rsp, unsigned int rsp_len)
155 IPMIInterfaceClass *iic = IPMI_INTERFACE_GET_CLASS(ii);
156 IPMIBT *ib = iic->get_backend_data(ii);
158 if (ib->waiting_rsp == msg_id) {
160 if (rsp_len > (sizeof(ib->outmsg) - 2)) {
162 ib->outmsg[1] = rsp[0];
163 ib->outmsg[2] = ib->waiting_seq;
164 ib->outmsg[3] = rsp[1];
165 ib->outmsg[4] = IPMI_CC_CANNOT_RETURN_REQ_NUM_BYTES;
168 ib->outmsg[0] = rsp_len + 1;
169 ib->outmsg[1] = rsp[0];
170 ib->outmsg[2] = ib->waiting_seq;
171 memcpy(ib->outmsg + 3, rsp + 1, rsp_len - 1);
172 ib->outlen = rsp_len + 2;
174 IPMI_BT_SET_BBUSY(ib->control_reg, 0);
175 IPMI_BT_SET_B2H_ATN(ib->control_reg, 1);
176 if (!IPMI_BT_GET_B2H_IRQ(ib->mask_reg) &&
177 IPMI_BT_GET_B2H_IRQ_EN(ib->mask_reg)) {
178 IPMI_BT_SET_B2H_IRQ(ib->mask_reg, 1);
179 ipmi_bt_raise_irq(ib);
185 static uint64_t ipmi_bt_ioport_read(void *opaque, hwaddr addr, unsigned size)
187 IPMIInterface *ii = opaque;
188 IPMIInterfaceClass *iic = IPMI_INTERFACE_GET_CLASS(ii);
189 IPMIBT *ib = iic->get_backend_data(ii);
192 switch (addr & ib->size_mask) {
194 ret = ib->control_reg;
197 if (ib->outpos < ib->outlen) {
198 ret = ib->outmsg[ib->outpos];
200 if (ib->outpos == ib->outlen) {
218 static void ipmi_bt_signal(IPMIBT *ib, IPMIInterface *ii)
220 IPMIInterfaceClass *iic = IPMI_INTERFACE_GET_CLASS(ii);
223 while (ib->do_wake) {
225 iic->handle_if_event(ii);
229 static void ipmi_bt_ioport_write(void *opaque, hwaddr addr, uint64_t val,
232 IPMIInterface *ii = opaque;
233 IPMIInterfaceClass *iic = IPMI_INTERFACE_GET_CLASS(ii);
234 IPMIBT *ib = iic->get_backend_data(ii);
236 switch (addr & ib->size_mask) {
238 if (IPMI_BT_GET_CLR_WR(val)) {
241 if (IPMI_BT_GET_CLR_RD(val)) {
244 if (IPMI_BT_GET_B2H_ATN(val)) {
245 IPMI_BT_SET_B2H_ATN(ib->control_reg, 0);
247 if (IPMI_BT_GET_SMS_ATN(val)) {
248 IPMI_BT_SET_SMS_ATN(ib->control_reg, 0);
250 if (IPMI_BT_GET_HBUSY(val)) {
252 IPMI_BT_SET_HBUSY(ib->control_reg,
253 !IPMI_BT_GET_HBUSY(ib->control_reg));
255 if (IPMI_BT_GET_H2B_ATN(val)) {
256 IPMI_BT_SET_BBUSY(ib->control_reg, 1);
257 ipmi_bt_signal(ib, ii);
262 if (ib->inlen < sizeof(ib->inmsg)) {
263 ib->inmsg[ib->inlen] = val;
269 if (IPMI_BT_GET_B2H_IRQ_EN(val) !=
270 IPMI_BT_GET_B2H_IRQ_EN(ib->mask_reg)) {
271 if (IPMI_BT_GET_B2H_IRQ_EN(val)) {
272 if (IPMI_BT_GET_B2H_ATN(ib->control_reg) ||
273 IPMI_BT_GET_SMS_ATN(ib->control_reg)) {
274 IPMI_BT_SET_B2H_IRQ(ib->mask_reg, 1);
275 ipmi_bt_raise_irq(ib);
277 IPMI_BT_SET_B2H_IRQ_EN(ib->mask_reg, 1);
279 if (IPMI_BT_GET_B2H_IRQ(ib->mask_reg)) {
280 IPMI_BT_SET_B2H_IRQ(ib->mask_reg, 0);
281 ipmi_bt_lower_irq(ib);
283 IPMI_BT_SET_B2H_IRQ_EN(ib->mask_reg, 0);
286 if (IPMI_BT_GET_B2H_IRQ(val) && IPMI_BT_GET_B2H_IRQ(ib->mask_reg)) {
287 IPMI_BT_SET_B2H_IRQ(ib->mask_reg, 0);
288 ipmi_bt_lower_irq(ib);
297 static const MemoryRegionOps ipmi_bt_io_ops = {
298 .read = ipmi_bt_ioport_read,
299 .write = ipmi_bt_ioport_write,
301 .min_access_size = 1,
302 .max_access_size = 1,
304 .endianness = DEVICE_LITTLE_ENDIAN,
307 static void ipmi_bt_set_atn(IPMIInterface *ii, int val, int irq)
309 IPMIInterfaceClass *iic = IPMI_INTERFACE_GET_CLASS(ii);
310 IPMIBT *ib = iic->get_backend_data(ii);
312 if (!!val == IPMI_BT_GET_SMS_ATN(ib->control_reg)) {
316 IPMI_BT_SET_SMS_ATN(ib->control_reg, val);
318 if (irq && !IPMI_BT_GET_B2H_ATN(ib->control_reg) &&
319 IPMI_BT_GET_B2H_IRQ_EN(ib->mask_reg)) {
320 IPMI_BT_SET_B2H_IRQ(ib->mask_reg, 1);
321 ipmi_bt_raise_irq(ib);
324 if (!IPMI_BT_GET_B2H_ATN(ib->control_reg) &&
325 IPMI_BT_GET_B2H_IRQ(ib->mask_reg)) {
326 IPMI_BT_SET_B2H_IRQ(ib->mask_reg, 0);
327 ipmi_bt_lower_irq(ib);
332 static void ipmi_bt_handle_reset(IPMIInterface *ii, bool is_cold)
334 IPMIInterfaceClass *iic = IPMI_INTERFACE_GET_CLASS(ii);
335 IPMIBT *ib = iic->get_backend_data(ii);
338 /* Disable the BT interrupt on reset */
339 if (IPMI_BT_GET_B2H_IRQ(ib->mask_reg)) {
340 IPMI_BT_SET_B2H_IRQ(ib->mask_reg, 0);
341 ipmi_bt_lower_irq(ib);
343 IPMI_BT_SET_B2H_IRQ_EN(ib->mask_reg, 0);
347 static void ipmi_bt_set_irq_enable(IPMIInterface *ii, int val)
349 IPMIInterfaceClass *iic = IPMI_INTERFACE_GET_CLASS(ii);
350 IPMIBT *ib = iic->get_backend_data(ii);
352 ib->irqs_enabled = val;
355 static void ipmi_bt_init(IPMIInterface *ii, unsigned int min_size, Error **errp)
357 IPMIInterfaceClass *iic = IPMI_INTERFACE_GET_CLASS(ii);
358 IPMIBT *ib = iic->get_backend_data(ii);
363 ib->size_mask = min_size - 1;
366 memory_region_init_io(&ib->io, NULL, &ipmi_bt_io_ops, ii, "ipmi-bt",
370 int ipmi_bt_vmstate_post_load(void *opaque, int version)
374 /* Make sure all the values are sane. */
375 if (ib->outpos >= MAX_IPMI_MSG_SIZE || ib->outlen >= MAX_IPMI_MSG_SIZE ||
376 ib->outpos >= ib->outlen) {
377 qemu_log_mask(LOG_GUEST_ERROR,
378 "ipmi:bt: vmstate transfer received bad out values: %d %d\n",
379 ib->outpos, ib->outlen);
384 if (ib->inlen >= MAX_IPMI_MSG_SIZE) {
385 qemu_log_mask(LOG_GUEST_ERROR,
386 "ipmi:bt: vmstate transfer received bad in value: %d\n",
394 const VMStateDescription vmstate_IPMIBT = {
395 .name = TYPE_IPMI_INTERFACE_PREFIX "bt",
397 .minimum_version_id = 1,
398 .post_load = ipmi_bt_vmstate_post_load,
399 .fields = (VMStateField[]) {
400 VMSTATE_BOOL(obf_irq_set, IPMIBT),
401 VMSTATE_BOOL(atn_irq_set, IPMIBT),
402 VMSTATE_BOOL(irqs_enabled, IPMIBT),
403 VMSTATE_UINT32(outpos, IPMIBT),
404 VMSTATE_UINT32(outlen, IPMIBT),
405 VMSTATE_UINT8_ARRAY(outmsg, IPMIBT, MAX_IPMI_MSG_SIZE),
406 VMSTATE_UINT32(inlen, IPMIBT),
407 VMSTATE_UINT8_ARRAY(inmsg, IPMIBT, MAX_IPMI_MSG_SIZE),
408 VMSTATE_UINT8(control_reg, IPMIBT),
409 VMSTATE_UINT8(mask_reg, IPMIBT),
410 VMSTATE_UINT8(waiting_rsp, IPMIBT),
411 VMSTATE_UINT8(waiting_seq, IPMIBT),
412 VMSTATE_END_OF_LIST()
416 void ipmi_bt_get_fwinfo(struct IPMIBT *ib, IPMIFwInfo *info)
418 info->interface_name = "bt";
419 info->interface_type = IPMI_SMBIOS_BT;
420 info->ipmi_spec_major_revision = 2;
421 info->ipmi_spec_minor_revision = 0;
422 info->base_address = ib->io_base;
423 info->register_length = ib->io_length;
424 info->register_spacing = 1;
425 info->memspace = IPMI_MEMSPACE_IO;
426 info->irq_type = IPMI_LEVEL_IRQ;
429 void ipmi_bt_class_init(IPMIInterfaceClass *iic)
431 iic->init = ipmi_bt_init;
432 iic->set_atn = ipmi_bt_set_atn;
433 iic->handle_rsp = ipmi_bt_handle_rsp;
434 iic->handle_if_event = ipmi_bt_handle_event;
435 iic->set_irq_enable = ipmi_bt_set_irq_enable;
436 iic->reset = ipmi_bt_handle_reset;