2
* QEMU PC speaker emulation
4
* Copyright (c) 2006 Joachim Henke
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
25
#include "qemu/osdep.h"
26
#include "hw/isa/isa.h"
27
#include "hw/audio/soundhw.h"
28
#include "audio/audio.h"
29
#include "qemu/module.h"
30
#include "qemu/timer.h"
31
#include "qemu/error-report.h"
32
#include "hw/timer/i8254.h"
33
#include "migration/vmstate.h"
34
#include "hw/audio/pcspk.h"
35
#include "qapi/error.h"
36
#include "qom/object.h"
38
#define PCSPK_BUF_LEN 1792
39
#define PCSPK_SAMPLE_RATE 32000
40
#define PCSPK_MAX_FREQ (PCSPK_SAMPLE_RATE >> 1)
41
#define PCSPK_MIN_COUNT DIV_ROUND_UP(PIT_FREQ, PCSPK_MAX_FREQ)
43
OBJECT_DECLARE_SIMPLE_TYPE(PCSpkState, PC_SPEAKER)
50
uint8_t sample_buf[PCSPK_BUF_LEN];
54
unsigned int pit_count;
56
unsigned int play_pos;
58
uint8_t dummy_refresh_clock;
62
static const char *s_spk = "pcspk";
63
static PCSpkState *pcspk_state;
65
static inline void generate_samples(PCSpkState *s)
70
const uint32_t m = PCSPK_SAMPLE_RATE * s->pit_count;
71
const uint32_t n = ((uint64_t)PIT_FREQ << 32) / m;
73
/* multiple of wavelength for gapless looping */
74
s->samples = (QEMU_ALIGN_DOWN(PCSPK_BUF_LEN * PIT_FREQ, m) / (PIT_FREQ >> 1) + 1) >> 1;
75
for (i = 0; i < s->samples; ++i)
76
s->sample_buf[i] = (64 & (n * i >> 25)) - 32;
78
s->samples = PCSPK_BUF_LEN;
79
for (i = 0; i < PCSPK_BUF_LEN; ++i)
80
s->sample_buf[i] = 128; /* silence */
84
static void pcspk_callback(void *opaque, int free)
86
PCSpkState *s = opaque;
90
pit_get_channel_info(s->pit, 2, &ch);
97
/* avoid frequencies that are not reproducible with sample rate */
98
if (n < PCSPK_MIN_COUNT)
101
if (s->pit_count != n) {
108
n = MIN(s->samples - s->play_pos, (unsigned int)free);
109
n = AUD_write(s->voice, &s->sample_buf[s->play_pos], n);
112
s->play_pos = (s->play_pos + n) % s->samples;
117
static int pcspk_audio_init(PCSpkState *s)
119
struct audsettings as = {PCSPK_SAMPLE_RATE, 1, AUDIO_FORMAT_U8, 0};
122
/* already initialized */
126
s->voice = AUD_open_out(&s->card, s->voice, s_spk, s, pcspk_callback, &as);
128
AUD_log(s_spk, "Could not open voice\n");
135
static uint64_t pcspk_io_read(void *opaque, hwaddr addr,
138
PCSpkState *s = opaque;
141
pit_get_channel_info(s->pit, 2, &ch);
143
s->dummy_refresh_clock ^= (1 << 4);
145
return ch.gate | (s->data_on << 1) | s->dummy_refresh_clock |
149
static void pcspk_io_write(void *opaque, hwaddr addr, uint64_t val,
152
PCSpkState *s = opaque;
153
const int gate = val & 1;
155
s->data_on = (val >> 1) & 1;
156
pit_set_gate(s->pit, 2, gate);
158
if (gate) /* restart */
160
AUD_set_active_out(s->voice, gate & s->data_on);
164
static const MemoryRegionOps pcspk_io_ops = {
165
.read = pcspk_io_read,
166
.write = pcspk_io_write,
168
.min_access_size = 1,
169
.max_access_size = 1,
173
static void pcspk_initfn(Object *obj)
175
PCSpkState *s = PC_SPEAKER(obj);
177
memory_region_init_io(&s->ioport, OBJECT(s), &pcspk_io_ops, s, "pcspk", 1);
179
object_property_add_link(obj, "pit", TYPE_PIT_COMMON,
181
qdev_prop_allow_set_link_before_realize,
185
static void pcspk_realizefn(DeviceState *dev, Error **errp)
187
ISADevice *isadev = ISA_DEVICE(dev);
188
PCSpkState *s = PC_SPEAKER(dev);
190
isa_register_ioport(isadev, &s->ioport, s->iobase);
192
if (s->card.state && AUD_register_card(s_spk, &s->card, errp)) {
199
static bool migrate_needed(void *opaque)
201
PCSpkState *s = opaque;
206
static const VMStateDescription vmstate_spk = {
209
.minimum_version_id = 1,
210
.needed = migrate_needed,
211
.fields = (const VMStateField[]) {
212
VMSTATE_UINT8(data_on, PCSpkState),
213
VMSTATE_UINT8(dummy_refresh_clock, PCSpkState),
214
VMSTATE_END_OF_LIST()
218
static Property pcspk_properties[] = {
219
DEFINE_AUDIO_PROPERTIES(PCSpkState, card),
220
DEFINE_PROP_UINT32("iobase", PCSpkState, iobase, 0x61),
221
DEFINE_PROP_BOOL("migrate", PCSpkState, migrate, true),
222
DEFINE_PROP_END_OF_LIST(),
225
static void pcspk_class_initfn(ObjectClass *klass, void *data)
227
DeviceClass *dc = DEVICE_CLASS(klass);
229
dc->realize = pcspk_realizefn;
230
set_bit(DEVICE_CATEGORY_SOUND, dc->categories);
231
dc->vmsd = &vmstate_spk;
232
device_class_set_props(dc, pcspk_properties);
233
/* Reason: realize sets global pcspk_state */
234
/* Reason: pit object link */
235
dc->user_creatable = false;
238
static const TypeInfo pcspk_info = {
239
.name = TYPE_PC_SPEAKER,
240
.parent = TYPE_ISA_DEVICE,
241
.instance_size = sizeof(PCSpkState),
242
.instance_init = pcspk_initfn,
243
.class_init = pcspk_class_initfn,
246
static void pcspk_register(void)
248
type_register_static(&pcspk_info);
250
type_init(pcspk_register)