fix doc of using raw values with sendkey
[qemu/ar7.git] / hw / spapr_vio.c
blob7ca445216d71f6c2a8d6398d9454f41d20352e11
1 /*
2 * QEMU sPAPR VIO code
4 * Copyright (c) 2010 David Gibson, IBM Corporation <dwg@au1.ibm.com>
5 * Based on the s390 virtio bus code:
6 * Copyright (c) 2009 Alexander Graf <agraf@suse.de>
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
22 #include "hw.h"
23 #include "sysemu.h"
24 #include "boards.h"
25 #include "monitor.h"
26 #include "loader.h"
27 #include "elf.h"
28 #include "hw/sysbus.h"
29 #include "kvm.h"
30 #include "device_tree.h"
31 #include "kvm_ppc.h"
33 #include "hw/spapr.h"
34 #include "hw/spapr_vio.h"
35 #include "hw/xics.h"
37 #ifdef CONFIG_FDT
38 #include <libfdt.h>
39 #endif /* CONFIG_FDT */
41 /* #define DEBUG_SPAPR */
43 #ifdef DEBUG_SPAPR
44 #define dprintf(fmt, ...) \
45 do { fprintf(stderr, fmt, ## __VA_ARGS__); } while (0)
46 #else
47 #define dprintf(fmt, ...) \
48 do { } while (0)
49 #endif
51 static Property spapr_vio_props[] = {
52 DEFINE_PROP_UINT32("irq", VIOsPAPRDevice, irq, 0), \
53 DEFINE_PROP_END_OF_LIST(),
56 static const TypeInfo spapr_vio_bus_info = {
57 .name = TYPE_SPAPR_VIO_BUS,
58 .parent = TYPE_BUS,
59 .instance_size = sizeof(VIOsPAPRBus),
62 VIOsPAPRDevice *spapr_vio_find_by_reg(VIOsPAPRBus *bus, uint32_t reg)
64 BusChild *kid;
65 VIOsPAPRDevice *dev = NULL;
67 QTAILQ_FOREACH(kid, &bus->bus.children, sibling) {
68 dev = (VIOsPAPRDevice *)kid->child;
69 if (dev->reg == reg) {
70 return dev;
74 return NULL;
77 static char *vio_format_dev_name(VIOsPAPRDevice *dev)
79 VIOsPAPRDeviceClass *pc = VIO_SPAPR_DEVICE_GET_CLASS(dev);
80 char *name;
82 /* Device tree style name device@reg */
83 if (asprintf(&name, "%s@%x", pc->dt_name, dev->reg) < 0) {
84 return NULL;
87 return name;
90 #ifdef CONFIG_FDT
91 static int vio_make_devnode(VIOsPAPRDevice *dev,
92 void *fdt)
94 VIOsPAPRDeviceClass *pc = VIO_SPAPR_DEVICE_GET_CLASS(dev);
95 int vdevice_off, node_off, ret;
96 char *dt_name;
98 vdevice_off = fdt_path_offset(fdt, "/vdevice");
99 if (vdevice_off < 0) {
100 return vdevice_off;
103 dt_name = vio_format_dev_name(dev);
104 if (!dt_name) {
105 return -ENOMEM;
108 node_off = fdt_add_subnode(fdt, vdevice_off, dt_name);
109 free(dt_name);
110 if (node_off < 0) {
111 return node_off;
114 ret = fdt_setprop_cell(fdt, node_off, "reg", dev->reg);
115 if (ret < 0) {
116 return ret;
119 if (pc->dt_type) {
120 ret = fdt_setprop_string(fdt, node_off, "device_type",
121 pc->dt_type);
122 if (ret < 0) {
123 return ret;
127 if (pc->dt_compatible) {
128 ret = fdt_setprop_string(fdt, node_off, "compatible",
129 pc->dt_compatible);
130 if (ret < 0) {
131 return ret;
135 if (dev->irq) {
136 uint32_t ints_prop[] = {cpu_to_be32(dev->irq), 0};
138 ret = fdt_setprop(fdt, node_off, "interrupts", ints_prop,
139 sizeof(ints_prop));
140 if (ret < 0) {
141 return ret;
145 ret = spapr_tcet_dma_dt(fdt, node_off, "ibm,my-dma-window", dev->dma);
146 if (ret < 0) {
147 return ret;
150 if (pc->devnode) {
151 ret = (pc->devnode)(dev, fdt, node_off);
152 if (ret < 0) {
153 return ret;
157 return node_off;
159 #endif /* CONFIG_FDT */
162 * CRQ handling
164 static target_ulong h_reg_crq(CPUPPCState *env, sPAPREnvironment *spapr,
165 target_ulong opcode, target_ulong *args)
167 target_ulong reg = args[0];
168 target_ulong queue_addr = args[1];
169 target_ulong queue_len = args[2];
170 VIOsPAPRDevice *dev = spapr_vio_find_by_reg(spapr->vio_bus, reg);
172 if (!dev) {
173 hcall_dprintf("Unit 0x" TARGET_FMT_lx " does not exist\n", reg);
174 return H_PARAMETER;
177 /* We can't grok a queue size bigger than 256M for now */
178 if (queue_len < 0x1000 || queue_len > 0x10000000) {
179 hcall_dprintf("Queue size too small or too big (0x" TARGET_FMT_lx
180 ")\n", queue_len);
181 return H_PARAMETER;
184 /* Check queue alignment */
185 if (queue_addr & 0xfff) {
186 hcall_dprintf("Queue not aligned (0x" TARGET_FMT_lx ")\n", queue_addr);
187 return H_PARAMETER;
190 /* Check if device supports CRQs */
191 if (!dev->crq.SendFunc) {
192 hcall_dprintf("Device does not support CRQ\n");
193 return H_NOT_FOUND;
196 /* Already a queue ? */
197 if (dev->crq.qsize) {
198 hcall_dprintf("CRQ already registered\n");
199 return H_RESOURCE;
201 dev->crq.qladdr = queue_addr;
202 dev->crq.qsize = queue_len;
203 dev->crq.qnext = 0;
205 dprintf("CRQ for dev 0x" TARGET_FMT_lx " registered at 0x"
206 TARGET_FMT_lx "/0x" TARGET_FMT_lx "\n",
207 reg, queue_addr, queue_len);
208 return H_SUCCESS;
211 static target_ulong free_crq(VIOsPAPRDevice *dev)
213 dev->crq.qladdr = 0;
214 dev->crq.qsize = 0;
215 dev->crq.qnext = 0;
217 dprintf("CRQ for dev 0x%" PRIx32 " freed\n", dev->reg);
219 return H_SUCCESS;
222 static target_ulong h_free_crq(CPUPPCState *env, sPAPREnvironment *spapr,
223 target_ulong opcode, target_ulong *args)
225 target_ulong reg = args[0];
226 VIOsPAPRDevice *dev = spapr_vio_find_by_reg(spapr->vio_bus, reg);
228 if (!dev) {
229 hcall_dprintf("Unit 0x" TARGET_FMT_lx " does not exist\n", reg);
230 return H_PARAMETER;
233 return free_crq(dev);
236 static target_ulong h_send_crq(CPUPPCState *env, sPAPREnvironment *spapr,
237 target_ulong opcode, target_ulong *args)
239 target_ulong reg = args[0];
240 target_ulong msg_hi = args[1];
241 target_ulong msg_lo = args[2];
242 VIOsPAPRDevice *dev = spapr_vio_find_by_reg(spapr->vio_bus, reg);
243 uint64_t crq_mangle[2];
245 if (!dev) {
246 hcall_dprintf("Unit 0x" TARGET_FMT_lx " does not exist\n", reg);
247 return H_PARAMETER;
249 crq_mangle[0] = cpu_to_be64(msg_hi);
250 crq_mangle[1] = cpu_to_be64(msg_lo);
252 if (dev->crq.SendFunc) {
253 return dev->crq.SendFunc(dev, (uint8_t *)crq_mangle);
256 return H_HARDWARE;
259 static target_ulong h_enable_crq(CPUPPCState *env, sPAPREnvironment *spapr,
260 target_ulong opcode, target_ulong *args)
262 target_ulong reg = args[0];
263 VIOsPAPRDevice *dev = spapr_vio_find_by_reg(spapr->vio_bus, reg);
265 if (!dev) {
266 hcall_dprintf("Unit 0x" TARGET_FMT_lx " does not exist\n", reg);
267 return H_PARAMETER;
270 return 0;
273 /* Returns negative error, 0 success, or positive: queue full */
274 int spapr_vio_send_crq(VIOsPAPRDevice *dev, uint8_t *crq)
276 int rc;
277 uint8_t byte;
279 if (!dev->crq.qsize) {
280 fprintf(stderr, "spapr_vio_send_creq on uninitialized queue\n");
281 return -1;
284 /* Maybe do a fast path for KVM just writing to the pages */
285 rc = spapr_vio_dma_read(dev, dev->crq.qladdr + dev->crq.qnext, &byte, 1);
286 if (rc) {
287 return rc;
289 if (byte != 0) {
290 return 1;
293 rc = spapr_vio_dma_write(dev, dev->crq.qladdr + dev->crq.qnext + 8,
294 &crq[8], 8);
295 if (rc) {
296 return rc;
299 kvmppc_eieio();
301 rc = spapr_vio_dma_write(dev, dev->crq.qladdr + dev->crq.qnext, crq, 8);
302 if (rc) {
303 return rc;
306 dev->crq.qnext = (dev->crq.qnext + 16) % dev->crq.qsize;
308 if (dev->signal_state & 1) {
309 qemu_irq_pulse(spapr_vio_qirq(dev));
312 return 0;
315 /* "quiesce" handling */
317 static void spapr_vio_quiesce_one(VIOsPAPRDevice *dev)
319 VIOsPAPRDeviceClass *pc = VIO_SPAPR_DEVICE_GET_CLASS(dev);
320 uint32_t liobn = SPAPR_VIO_BASE_LIOBN | dev->reg;
322 if (dev->dma) {
323 spapr_tce_free(dev->dma);
325 dev->dma = spapr_tce_new_dma_context(liobn, pc->rtce_window_size);
327 dev->crq.qladdr = 0;
328 dev->crq.qsize = 0;
329 dev->crq.qnext = 0;
332 static void rtas_set_tce_bypass(sPAPREnvironment *spapr, uint32_t token,
333 uint32_t nargs, target_ulong args,
334 uint32_t nret, target_ulong rets)
336 VIOsPAPRBus *bus = spapr->vio_bus;
337 VIOsPAPRDevice *dev;
338 uint32_t unit, enable;
340 if (nargs != 2) {
341 rtas_st(rets, 0, -3);
342 return;
344 unit = rtas_ld(args, 0);
345 enable = rtas_ld(args, 1);
346 dev = spapr_vio_find_by_reg(bus, unit);
347 if (!dev) {
348 rtas_st(rets, 0, -3);
349 return;
351 if (enable) {
352 spapr_tce_free(dev->dma);
353 dev->dma = NULL;
354 } else {
355 VIOsPAPRDeviceClass *pc = VIO_SPAPR_DEVICE_GET_CLASS(dev);
356 uint32_t liobn = SPAPR_VIO_BASE_LIOBN | dev->reg;
358 dev->dma = spapr_tce_new_dma_context(liobn, pc->rtce_window_size);
361 rtas_st(rets, 0, 0);
364 static void rtas_quiesce(sPAPREnvironment *spapr, uint32_t token,
365 uint32_t nargs, target_ulong args,
366 uint32_t nret, target_ulong rets)
368 VIOsPAPRBus *bus = spapr->vio_bus;
369 BusChild *kid;
370 VIOsPAPRDevice *dev = NULL;
372 if (nargs != 0) {
373 rtas_st(rets, 0, -3);
374 return;
377 QTAILQ_FOREACH(kid, &bus->bus.children, sibling) {
378 dev = (VIOsPAPRDevice *)kid->child;
379 spapr_vio_quiesce_one(dev);
382 rtas_st(rets, 0, 0);
385 static VIOsPAPRDevice *reg_conflict(VIOsPAPRDevice *dev)
387 VIOsPAPRBus *bus = DO_UPCAST(VIOsPAPRBus, bus, dev->qdev.parent_bus);
388 BusChild *kid;
389 VIOsPAPRDevice *other;
392 * Check for a device other than the given one which is already
393 * using the requested address. We have to open code this because
394 * the given dev might already be in the list.
396 QTAILQ_FOREACH(kid, &bus->bus.children, sibling) {
397 other = DO_UPCAST(VIOsPAPRDevice, qdev, kid->child);
399 if (other != dev && other->reg == dev->reg) {
400 return other;
404 return 0;
407 static void spapr_vio_busdev_reset(DeviceState *qdev)
409 VIOsPAPRDevice *dev = DO_UPCAST(VIOsPAPRDevice, qdev, qdev);
410 VIOsPAPRDeviceClass *pc = VIO_SPAPR_DEVICE_GET_CLASS(dev);
412 if (dev->crq.qsize) {
413 free_crq(dev);
416 if (pc->reset) {
417 pc->reset(dev);
421 static int spapr_vio_busdev_init(DeviceState *qdev)
423 VIOsPAPRDevice *dev = (VIOsPAPRDevice *)qdev;
424 VIOsPAPRDeviceClass *pc = VIO_SPAPR_DEVICE_GET_CLASS(dev);
425 uint32_t liobn;
426 char *id;
428 if (dev->reg != -1) {
430 * Explicitly assigned address, just verify that no-one else
431 * is using it. other mechanism). We have to open code this
432 * rather than using spapr_vio_find_by_reg() because sdev
433 * itself is already in the list.
435 VIOsPAPRDevice *other = reg_conflict(dev);
437 if (other) {
438 fprintf(stderr, "vio: %s and %s devices conflict at address %#x\n",
439 object_get_typename(OBJECT(qdev)),
440 object_get_typename(OBJECT(&other->qdev)),
441 dev->reg);
442 return -1;
444 } else {
445 /* Need to assign an address */
446 VIOsPAPRBus *bus = DO_UPCAST(VIOsPAPRBus, bus, dev->qdev.parent_bus);
448 do {
449 dev->reg = bus->next_reg++;
450 } while (reg_conflict(dev));
453 /* Don't overwrite ids assigned on the command line */
454 if (!dev->qdev.id) {
455 id = vio_format_dev_name(dev);
456 if (!id) {
457 return -1;
459 dev->qdev.id = id;
462 dev->irq = spapr_allocate_msi(dev->irq);
463 if (!dev->irq) {
464 return -1;
467 liobn = SPAPR_VIO_BASE_LIOBN | dev->reg;
468 dev->dma = spapr_tce_new_dma_context(liobn, pc->rtce_window_size);
470 return pc->init(dev);
473 static target_ulong h_vio_signal(CPUPPCState *env, sPAPREnvironment *spapr,
474 target_ulong opcode,
475 target_ulong *args)
477 target_ulong reg = args[0];
478 target_ulong mode = args[1];
479 VIOsPAPRDevice *dev = spapr_vio_find_by_reg(spapr->vio_bus, reg);
480 VIOsPAPRDeviceClass *pc;
482 if (!dev) {
483 return H_PARAMETER;
486 pc = VIO_SPAPR_DEVICE_GET_CLASS(dev);
488 if (mode & ~pc->signal_mask) {
489 return H_PARAMETER;
492 dev->signal_state = mode;
494 return H_SUCCESS;
497 VIOsPAPRBus *spapr_vio_bus_init(void)
499 VIOsPAPRBus *bus;
500 BusState *qbus;
501 DeviceState *dev;
503 /* Create bridge device */
504 dev = qdev_create(NULL, "spapr-vio-bridge");
505 qdev_init_nofail(dev);
507 /* Create bus on bridge device */
509 qbus = qbus_create(TYPE_SPAPR_VIO_BUS, dev, "spapr-vio");
510 bus = DO_UPCAST(VIOsPAPRBus, bus, qbus);
511 bus->next_reg = 0x1000;
513 /* hcall-vio */
514 spapr_register_hypercall(H_VIO_SIGNAL, h_vio_signal);
516 /* hcall-crq */
517 spapr_register_hypercall(H_REG_CRQ, h_reg_crq);
518 spapr_register_hypercall(H_FREE_CRQ, h_free_crq);
519 spapr_register_hypercall(H_SEND_CRQ, h_send_crq);
520 spapr_register_hypercall(H_ENABLE_CRQ, h_enable_crq);
522 /* RTAS calls */
523 spapr_rtas_register("ibm,set-tce-bypass", rtas_set_tce_bypass);
524 spapr_rtas_register("quiesce", rtas_quiesce);
526 return bus;
529 /* Represents sPAPR hcall VIO devices */
531 static int spapr_vio_bridge_init(SysBusDevice *dev)
533 /* nothing */
534 return 0;
537 static void spapr_vio_bridge_class_init(ObjectClass *klass, void *data)
539 DeviceClass *dc = DEVICE_CLASS(klass);
540 SysBusDeviceClass *k = SYS_BUS_DEVICE_CLASS(klass);
542 k->init = spapr_vio_bridge_init;
543 dc->no_user = 1;
546 static TypeInfo spapr_vio_bridge_info = {
547 .name = "spapr-vio-bridge",
548 .parent = TYPE_SYS_BUS_DEVICE,
549 .instance_size = sizeof(SysBusDevice),
550 .class_init = spapr_vio_bridge_class_init,
553 static void vio_spapr_device_class_init(ObjectClass *klass, void *data)
555 DeviceClass *k = DEVICE_CLASS(klass);
556 k->init = spapr_vio_busdev_init;
557 k->reset = spapr_vio_busdev_reset;
558 k->bus_type = TYPE_SPAPR_VIO_BUS;
559 k->props = spapr_vio_props;
562 static TypeInfo spapr_vio_type_info = {
563 .name = TYPE_VIO_SPAPR_DEVICE,
564 .parent = TYPE_DEVICE,
565 .instance_size = sizeof(VIOsPAPRDevice),
566 .abstract = true,
567 .class_size = sizeof(VIOsPAPRDeviceClass),
568 .class_init = vio_spapr_device_class_init,
571 static void spapr_vio_register_types(void)
573 type_register_static(&spapr_vio_bus_info);
574 type_register_static(&spapr_vio_bridge_info);
575 type_register_static(&spapr_vio_type_info);
578 type_init(spapr_vio_register_types)
580 #ifdef CONFIG_FDT
581 static int compare_reg(const void *p1, const void *p2)
583 VIOsPAPRDevice const *dev1, *dev2;
585 dev1 = (VIOsPAPRDevice *)*(DeviceState **)p1;
586 dev2 = (VIOsPAPRDevice *)*(DeviceState **)p2;
588 if (dev1->reg < dev2->reg) {
589 return -1;
591 if (dev1->reg == dev2->reg) {
592 return 0;
595 /* dev1->reg > dev2->reg */
596 return 1;
599 int spapr_populate_vdevice(VIOsPAPRBus *bus, void *fdt)
601 DeviceState *qdev, **qdevs;
602 BusChild *kid;
603 int i, num, ret = 0;
605 /* Count qdevs on the bus list */
606 num = 0;
607 QTAILQ_FOREACH(kid, &bus->bus.children, sibling) {
608 num++;
611 /* Copy out into an array of pointers */
612 qdevs = g_malloc(sizeof(qdev) * num);
613 num = 0;
614 QTAILQ_FOREACH(kid, &bus->bus.children, sibling) {
615 qdevs[num++] = kid->child;
618 /* Sort the array */
619 qsort(qdevs, num, sizeof(qdev), compare_reg);
621 /* Hack alert. Give the devices to libfdt in reverse order, we happen
622 * to know that will mean they are in forward order in the tree. */
623 for (i = num - 1; i >= 0; i--) {
624 VIOsPAPRDevice *dev = (VIOsPAPRDevice *)(qdevs[i]);
626 ret = vio_make_devnode(dev, fdt);
628 if (ret < 0) {
629 goto out;
633 ret = 0;
634 out:
635 free(qdevs);
637 return ret;
640 int spapr_populate_chosen_stdout(void *fdt, VIOsPAPRBus *bus)
642 VIOsPAPRDevice *dev;
643 char *name, *path;
644 int ret, offset;
646 dev = spapr_vty_get_default(bus);
647 if (!dev)
648 return 0;
650 offset = fdt_path_offset(fdt, "/chosen");
651 if (offset < 0) {
652 return offset;
655 name = vio_format_dev_name(dev);
656 if (!name) {
657 return -ENOMEM;
660 if (asprintf(&path, "/vdevice/%s", name) < 0) {
661 path = NULL;
662 ret = -ENOMEM;
663 goto out;
666 ret = fdt_setprop_string(fdt, offset, "linux,stdout-path", path);
667 out:
668 free(name);
669 free(path);
671 return ret;
673 #endif /* CONFIG_FDT */