qapi: Improve specificity of type/member descriptions
[qemu/armbru.git] / hw / audio / soundhw.c
blob94d9463e42d8b2d58d4bca12a9ac21feb5c00c4e
1 /*
2 * QEMU System Emulator
4 * Copyright (c) 2003-2008 Fabrice Bellard
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
22 * THE SOFTWARE.
24 #include "qemu/osdep.h"
25 #include "qemu/option.h"
26 #include "qemu/help_option.h"
27 #include "qemu/error-report.h"
28 #include "qapi/error.h"
29 #include "qom/object.h"
30 #include "hw/qdev-properties.h"
31 #include "hw/isa/isa.h"
32 #include "hw/pci/pci.h"
33 #include "hw/audio/soundhw.h"
35 struct soundhw {
36 const char *name;
37 const char *descr;
38 const char *typename;
39 int isa;
40 int (*init_pci) (PCIBus *bus, const char *audiodev);
43 static struct soundhw soundhw[9];
44 static int soundhw_count;
46 void pci_register_soundhw(const char *name, const char *descr,
47 int (*init_pci)(PCIBus *bus, const char *audiodev))
49 assert(soundhw_count < ARRAY_SIZE(soundhw) - 1);
50 soundhw[soundhw_count].name = name;
51 soundhw[soundhw_count].descr = descr;
52 soundhw[soundhw_count].isa = 0;
53 soundhw[soundhw_count].init_pci = init_pci;
54 soundhw_count++;
57 void deprecated_register_soundhw(const char *name, const char *descr,
58 int isa, const char *typename)
60 assert(soundhw_count < ARRAY_SIZE(soundhw) - 1);
61 soundhw[soundhw_count].name = name;
62 soundhw[soundhw_count].descr = descr;
63 soundhw[soundhw_count].isa = isa;
64 soundhw[soundhw_count].typename = typename;
65 soundhw_count++;
68 void show_valid_soundhw(void)
70 struct soundhw *c;
72 if (soundhw_count) {
73 printf("Valid sound card names (comma separated):\n");
74 for (c = soundhw; c->name; ++c) {
75 printf ("%-11s %s\n", c->name, c->descr);
77 } else {
78 printf("Machine has no user-selectable audio hardware "
79 "(it may or may not have always-present audio hardware).\n");
83 static struct soundhw *selected = NULL;
84 static const char *audiodev_id;
86 void select_soundhw(const char *optarg, const char *audiodev)
88 struct soundhw *c;
90 if (selected) {
91 error_setg(&error_fatal, "only one -soundhw option is allowed");
94 for (c = soundhw; c->name; ++c) {
95 if (g_str_equal(c->name, optarg)) {
96 selected = c;
97 audiodev_id = audiodev;
98 break;
102 if (!c->name) {
103 error_report("Unknown sound card name `%s'", optarg);
104 show_valid_soundhw();
105 exit(1);
109 void soundhw_init(void)
111 struct soundhw *c = selected;
112 ISABus *isa_bus = (ISABus *) object_resolve_path_type("", TYPE_ISA_BUS, NULL);
113 PCIBus *pci_bus = (PCIBus *) object_resolve_path_type("", TYPE_PCI_BUS, NULL);
114 BusState *bus;
116 if (!c) {
117 return;
119 if (c->isa) {
120 if (!isa_bus) {
121 error_report("ISA bus not available for %s", c->name);
122 exit(1);
124 bus = BUS(isa_bus);
125 } else {
126 if (!pci_bus) {
127 error_report("PCI bus not available for %s", c->name);
128 exit(1);
130 bus = BUS(pci_bus);
133 if (c->typename) {
134 DeviceState *dev = qdev_new(c->typename);
135 qdev_prop_set_string(dev, "audiodev", audiodev_id);
136 qdev_realize_and_unref(dev, bus, &error_fatal);
137 } else {
138 assert(!c->isa);
139 c->init_pci(pci_bus, audiodev_id);