1 // SPDX-License-Identifier: GPL-2.0-or-later 2 /* 3 * Dummy soundcard 4 * Copyright (c) by Jaroslav Kysela <perex@perex.cz> 5 */ 6 7 #include <linux/init.h> 8 #include <linux/err.h> 9 #include <linux/platform_device.h> 10 #include <linux/jiffies.h> 11 #include <linux/slab.h> 12 #include <linux/time.h> 13 #include <linux/wait.h> 14 #include <linux/hrtimer.h> 15 #include <linux/math64.h> 16 #include <linux/module.h> 17 #include <sound/core.h> 18 #include <sound/control.h> 19 #include <sound/tlv.h> 20 #include <sound/pcm.h> 21 #include <sound/rawmidi.h> 22 #include <sound/info.h> 23 #include <sound/initval.h> 24 25 MODULE_AUTHOR("Jaroslav Kysela <perex@perex.cz>"); 26 MODULE_DESCRIPTION("Dummy soundcard (/dev/null)"); 27 MODULE_LICENSE("GPL"); 28 29 #define MAX_PCM_DEVICES 4 30 #define MAX_PCM_SUBSTREAMS 128 31 #define MAX_MIDI_DEVICES 2 32 33 /* defaults */ 34 #define MAX_BUFFER_SIZE (64*1024) 35 #define MIN_PERIOD_SIZE 64 36 #define MAX_PERIOD_SIZE MAX_BUFFER_SIZE 37 #define USE_FORMATS (SNDRV_PCM_FMTBIT_U8 | SNDRV_PCM_FMTBIT_S16_LE) 38 #define USE_RATE SNDRV_PCM_RATE_CONTINUOUS | SNDRV_PCM_RATE_8000_48000 39 #define USE_RATE_MIN 5500 40 #define USE_RATE_MAX 48000 41 #define USE_CHANNELS_MIN 1 42 #define USE_CHANNELS_MAX 2 43 #define USE_PERIODS_MIN 1 44 #define USE_PERIODS_MAX 1024 45 #define USE_MIXER_VOLUME_LEVEL_MIN -50 46 #define USE_MIXER_VOLUME_LEVEL_MAX 100 47 48 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX; /* Index 0-MAX */ 49 static char *id[SNDRV_CARDS] = SNDRV_DEFAULT_STR; /* ID for this card */ 50 static bool enable[SNDRV_CARDS] = {1, [1 ... (SNDRV_CARDS - 1)] = 0}; 51 static char *model[SNDRV_CARDS] = {[0 ... (SNDRV_CARDS - 1)] = NULL}; 52 static int pcm_devs[SNDRV_CARDS] = {[0 ... (SNDRV_CARDS - 1)] = 1}; 53 static int pcm_substreams[SNDRV_CARDS] = {[0 ... (SNDRV_CARDS - 1)] = 8}; 54 //static int midi_devs[SNDRV_CARDS] = {[0 ... (SNDRV_CARDS - 1)] = 2}; 55 static int mixer_volume_level_min = USE_MIXER_VOLUME_LEVEL_MIN; 56 static int mixer_volume_level_max = USE_MIXER_VOLUME_LEVEL_MAX; 57 #ifdef CONFIG_HIGH_RES_TIMERS 58 static bool hrtimer = 1; 59 #endif 60 static bool fake_buffer = 1; 61 62 module_param_array(index, int, NULL, 0444); 63 MODULE_PARM_DESC(index, "Index value for dummy soundcard."); 64 module_param_array(id, charp, NULL, 0444); 65 MODULE_PARM_DESC(id, "ID string for dummy soundcard."); 66 module_param_array(enable, bool, NULL, 0444); 67 MODULE_PARM_DESC(enable, "Enable this dummy soundcard."); 68 module_param_array(model, charp, NULL, 0444); 69 MODULE_PARM_DESC(model, "Soundcard model."); 70 module_param_array(pcm_devs, int, NULL, 0444); 71 MODULE_PARM_DESC(pcm_devs, "PCM devices # (0-4) for dummy driver."); 72 module_param_array(pcm_substreams, int, NULL, 0444); 73 MODULE_PARM_DESC(pcm_substreams, "PCM substreams # (1-128) for dummy driver."); 74 //module_param_array(midi_devs, int, NULL, 0444); 75 //MODULE_PARM_DESC(midi_devs, "MIDI devices # (0-2) for dummy driver."); 76 module_param(mixer_volume_level_min, int, 0444); 77 MODULE_PARM_DESC(mixer_volume_level_min, "Minimum mixer volume level for dummy driver. Default: -50"); 78 module_param(mixer_volume_level_max, int, 0444); 79 MODULE_PARM_DESC(mixer_volume_level_max, "Maximum mixer volume level for dummy driver. Default: 100"); 80 module_param(fake_buffer, bool, 0444); 81 MODULE_PARM_DESC(fake_buffer, "Fake buffer allocations."); 82 #ifdef CONFIG_HIGH_RES_TIMERS 83 module_param(hrtimer, bool, 0644); 84 MODULE_PARM_DESC(hrtimer, "Use hrtimer as the timer source."); 85 #endif 86 87 static struct platform_device *devices[SNDRV_CARDS]; 88 89 #define MIXER_ADDR_MASTER 0 90 #define MIXER_ADDR_LINE 1 91 #define MIXER_ADDR_MIC 2 92 #define MIXER_ADDR_SYNTH 3 93 #define MIXER_ADDR_CD 4 94 #define MIXER_ADDR_LAST 4 95 96 struct dummy_timer_ops { 97 int (*create)(struct snd_pcm_substream *); 98 void (*free)(struct snd_pcm_substream *); 99 int (*prepare)(struct snd_pcm_substream *); 100 int (*start)(struct snd_pcm_substream *); 101 int (*stop)(struct snd_pcm_substream *); 102 snd_pcm_uframes_t (*pointer)(struct snd_pcm_substream *); 103 }; 104 105 #define get_dummy_ops(substream) \ 106 (*(const struct dummy_timer_ops **)(substream)->runtime->private_data) 107 108 struct dummy_model { 109 const char *name; 110 int (*playback_constraints)(struct snd_pcm_runtime *runtime); 111 int (*capture_constraints)(struct snd_pcm_runtime *runtime); 112 u64 formats; 113 size_t buffer_bytes_max; 114 size_t period_bytes_min; 115 size_t period_bytes_max; 116 unsigned int periods_min; 117 unsigned int periods_max; 118 unsigned int rates; 119 unsigned int rate_min; 120 unsigned int rate_max; 121 unsigned int channels_min; 122 unsigned int channels_max; 123 }; 124 125 struct snd_dummy { 126 struct snd_card *card; 127 const struct dummy_model *model; 128 struct snd_pcm *pcm; 129 struct snd_pcm_hardware pcm_hw; 130 spinlock_t mixer_lock; 131 int mixer_volume[MIXER_ADDR_LAST+1][2]; 132 int capture_source[MIXER_ADDR_LAST+1][2]; 133 int iobox; 134 struct snd_kcontrol *cd_volume_ctl; 135 struct snd_kcontrol *cd_switch_ctl; 136 }; 137 138 /* 139 * card models 140 */ 141 142 static int emu10k1_playback_constraints(struct snd_pcm_runtime *runtime) 143 { 144 int err; 145 err = snd_pcm_hw_constraint_integer(runtime, SNDRV_PCM_HW_PARAM_PERIODS); 146 if (err < 0) 147 return err; 148 err = snd_pcm_hw_constraint_minmax(runtime, SNDRV_PCM_HW_PARAM_BUFFER_BYTES, 256, UINT_MAX); 149 if (err < 0) 150 return err; 151 return 0; 152 } 153 154 static const struct dummy_model model_emu10k1 = { 155 .name = "emu10k1", 156 .playback_constraints = emu10k1_playback_constraints, 157 .buffer_bytes_max = 128 * 1024, 158 }; 159 160 static const struct dummy_model model_rme9652 = { 161 .name = "rme9652", 162 .buffer_bytes_max = 26 * 64 * 1024, 163 .formats = SNDRV_PCM_FMTBIT_S32_LE, 164 .channels_min = 26, 165 .channels_max = 26, 166 .periods_min = 2, 167 .periods_max = 2, 168 }; 169 170 static const struct dummy_model model_ice1712 = { 171 .name = "ice1712", 172 .buffer_bytes_max = 256 * 1024, 173 .formats = SNDRV_PCM_FMTBIT_S32_LE, 174 .channels_min = 10, 175 .channels_max = 10, 176 .periods_min = 1, 177 .periods_max = 1024, 178 }; 179 180 static const struct dummy_model model_uda1341 = { 181 .name = "uda1341", 182 .buffer_bytes_max = 16380, 183 .formats = SNDRV_PCM_FMTBIT_S16_LE, 184 .channels_min = 2, 185 .channels_max = 2, 186 .periods_min = 2, 187 .periods_max = 255, 188 }; 189 190 static const struct dummy_model model_ac97 = { 191 .name = "ac97", 192 .formats = SNDRV_PCM_FMTBIT_S16_LE, 193 .channels_min = 2, 194 .channels_max = 2, 195 .rates = SNDRV_PCM_RATE_48000, 196 .rate_min = 48000, 197 .rate_max = 48000, 198 }; 199 200 static const struct dummy_model model_ca0106 = { 201 .name = "ca0106", 202 .formats = SNDRV_PCM_FMTBIT_S16_LE, 203 .buffer_bytes_max = ((65536-64)*8), 204 .period_bytes_max = (65536-64), 205 .periods_min = 2, 206 .periods_max = 8, 207 .channels_min = 2, 208 .channels_max = 2, 209 .rates = SNDRV_PCM_RATE_48000|SNDRV_PCM_RATE_96000|SNDRV_PCM_RATE_192000, 210 .rate_min = 48000, 211 .rate_max = 192000, 212 }; 213 214 static const struct dummy_model *dummy_models[] = { 215 &model_emu10k1, 216 &model_rme9652, 217 &model_ice1712, 218 &model_uda1341, 219 &model_ac97, 220 &model_ca0106, 221 NULL 222 }; 223 224 /* 225 * system timer interface 226 */ 227 228 struct dummy_systimer_pcm { 229 /* ops must be the first item */ 230 const struct dummy_timer_ops *timer_ops; 231 spinlock_t lock; 232 struct timer_list timer; 233 unsigned long base_time; 234 unsigned int frac_pos; /* fractional sample position (based HZ) */ 235 unsigned int frac_period_rest; 236 unsigned int frac_buffer_size; /* buffer_size * HZ */ 237 unsigned int frac_period_size; /* period_size * HZ */ 238 unsigned int rate; 239 int elapsed; 240 struct snd_pcm_substream *substream; 241 }; 242 243 static void dummy_systimer_rearm(struct dummy_systimer_pcm *dpcm) 244 { 245 mod_timer(&dpcm->timer, jiffies + 246 DIV_ROUND_UP(dpcm->frac_period_rest, dpcm->rate)); 247 } 248 249 static void dummy_systimer_update(struct dummy_systimer_pcm *dpcm) 250 { 251 unsigned long delta; 252 253 delta = jiffies - dpcm->base_time; 254 if (!delta) 255 return; 256 dpcm->base_time += delta; 257 delta *= dpcm->rate; 258 dpcm->frac_pos += delta; 259 while (dpcm->frac_pos >= dpcm->frac_buffer_size) 260 dpcm->frac_pos -= dpcm->frac_buffer_size; 261 while (dpcm->frac_period_rest <= delta) { 262 dpcm->elapsed++; 263 dpcm->frac_period_rest += dpcm->frac_period_size; 264 } 265 dpcm->frac_period_rest -= delta; 266 } 267 268 static int dummy_systimer_start(struct snd_pcm_substream *substream) 269 { 270 struct dummy_systimer_pcm *dpcm = substream->runtime->private_data; 271 spin_lock(&dpcm->lock); 272 dpcm->base_time = jiffies; 273 dummy_systimer_rearm(dpcm); 274 spin_unlock(&dpcm->lock); 275 return 0; 276 } 277 278 static int dummy_systimer_stop(struct snd_pcm_substream *substream) 279 { 280 struct dummy_systimer_pcm *dpcm = substream->runtime->private_data; 281 spin_lock(&dpcm->lock); 282 timer_delete(&dpcm->timer); 283 spin_unlock(&dpcm->lock); 284 return 0; 285 } 286 287 static int dummy_systimer_prepare(struct snd_pcm_substream *substream) 288 { 289 struct snd_pcm_runtime *runtime = substream->runtime; 290 struct dummy_systimer_pcm *dpcm = runtime->private_data; 291 292 dpcm->frac_pos = 0; 293 dpcm->rate = runtime->rate; 294 dpcm->frac_buffer_size = runtime->buffer_size * HZ; 295 dpcm->frac_period_size = runtime->period_size * HZ; 296 dpcm->frac_period_rest = dpcm->frac_period_size; 297 dpcm->elapsed = 0; 298 299 return 0; 300 } 301 302 static void dummy_systimer_callback(struct timer_list *t) 303 { 304 struct dummy_systimer_pcm *dpcm = from_timer(dpcm, t, timer); 305 unsigned long flags; 306 int elapsed = 0; 307 308 spin_lock_irqsave(&dpcm->lock, flags); 309 dummy_systimer_update(dpcm); 310 dummy_systimer_rearm(dpcm); 311 elapsed = dpcm->elapsed; 312 dpcm->elapsed = 0; 313 spin_unlock_irqrestore(&dpcm->lock, flags); 314 if (elapsed) 315 snd_pcm_period_elapsed(dpcm->substream); 316 } 317 318 static snd_pcm_uframes_t 319 dummy_systimer_pointer(struct snd_pcm_substream *substream) 320 { 321 struct dummy_systimer_pcm *dpcm = substream->runtime->private_data; 322 snd_pcm_uframes_t pos; 323 324 spin_lock(&dpcm->lock); 325 dummy_systimer_update(dpcm); 326 pos = dpcm->frac_pos / HZ; 327 spin_unlock(&dpcm->lock); 328 return pos; 329 } 330 331 static int dummy_systimer_create(struct snd_pcm_substream *substream) 332 { 333 struct dummy_systimer_pcm *dpcm; 334 335 dpcm = kzalloc(sizeof(*dpcm), GFP_KERNEL); 336 if (!dpcm) 337 return -ENOMEM; 338 substream->runtime->private_data = dpcm; 339 timer_setup(&dpcm->timer, dummy_systimer_callback, 0); 340 spin_lock_init(&dpcm->lock); 341 dpcm->substream = substream; 342 return 0; 343 } 344 345 static void dummy_systimer_free(struct snd_pcm_substream *substream) 346 { 347 kfree(substream->runtime->private_data); 348 } 349 350 static const struct dummy_timer_ops dummy_systimer_ops = { 351 .create = dummy_systimer_create, 352 .free = dummy_systimer_free, 353 .prepare = dummy_systimer_prepare, 354 .start = dummy_systimer_start, 355 .stop = dummy_systimer_stop, 356 .pointer = dummy_systimer_pointer, 357 }; 358 359 #ifdef CONFIG_HIGH_RES_TIMERS 360 /* 361 * hrtimer interface 362 */ 363 364 struct dummy_hrtimer_pcm { 365 /* ops must be the first item */ 366 const struct dummy_timer_ops *timer_ops; 367 ktime_t base_time; 368 ktime_t period_time; 369 atomic_t running; 370 struct hrtimer timer; 371 struct snd_pcm_substream *substream; 372 }; 373 374 static enum hrtimer_restart dummy_hrtimer_callback(struct hrtimer *timer) 375 { 376 struct dummy_hrtimer_pcm *dpcm; 377 378 dpcm = container_of(timer, struct dummy_hrtimer_pcm, timer); 379 if (!atomic_read(&dpcm->running)) 380 return HRTIMER_NORESTART; 381 /* 382 * In cases of XRUN and draining, this calls .trigger to stop PCM 383 * substream. 384 */ 385 snd_pcm_period_elapsed(dpcm->substream); 386 if (!atomic_read(&dpcm->running)) 387 return HRTIMER_NORESTART; 388 389 hrtimer_forward_now(timer, dpcm->period_time); 390 return HRTIMER_RESTART; 391 } 392 393 static int dummy_hrtimer_start(struct snd_pcm_substream *substream) 394 { 395 struct dummy_hrtimer_pcm *dpcm = substream->runtime->private_data; 396 397 dpcm->base_time = hrtimer_cb_get_time(&dpcm->timer); 398 hrtimer_start(&dpcm->timer, dpcm->period_time, HRTIMER_MODE_REL_SOFT); 399 atomic_set(&dpcm->running, 1); 400 return 0; 401 } 402 403 static int dummy_hrtimer_stop(struct snd_pcm_substream *substream) 404 { 405 struct dummy_hrtimer_pcm *dpcm = substream->runtime->private_data; 406 407 atomic_set(&dpcm->running, 0); 408 if (!hrtimer_callback_running(&dpcm->timer)) 409 hrtimer_cancel(&dpcm->timer); 410 return 0; 411 } 412 413 static inline void dummy_hrtimer_sync(struct dummy_hrtimer_pcm *dpcm) 414 { 415 hrtimer_cancel(&dpcm->timer); 416 } 417 418 static snd_pcm_uframes_t 419 dummy_hrtimer_pointer(struct snd_pcm_substream *substream) 420 { 421 struct snd_pcm_runtime *runtime = substream->runtime; 422 struct dummy_hrtimer_pcm *dpcm = runtime->private_data; 423 u64 delta; 424 u32 pos; 425 426 delta = ktime_us_delta(hrtimer_cb_get_time(&dpcm->timer), 427 dpcm->base_time); 428 delta = div_u64(delta * runtime->rate + 999999, 1000000); 429 div_u64_rem(delta, runtime->buffer_size, &pos); 430 return pos; 431 } 432 433 static int dummy_hrtimer_prepare(struct snd_pcm_substream *substream) 434 { 435 struct snd_pcm_runtime *runtime = substream->runtime; 436 struct dummy_hrtimer_pcm *dpcm = runtime->private_data; 437 unsigned int period, rate; 438 long sec; 439 unsigned long nsecs; 440 441 dummy_hrtimer_sync(dpcm); 442 period = runtime->period_size; 443 rate = runtime->rate; 444 sec = period / rate; 445 period %= rate; 446 nsecs = div_u64((u64)period * 1000000000UL + rate - 1, rate); 447 dpcm->period_time = ktime_set(sec, nsecs); 448 449 return 0; 450 } 451 452 static int dummy_hrtimer_create(struct snd_pcm_substream *substream) 453 { 454 struct dummy_hrtimer_pcm *dpcm; 455 456 dpcm = kzalloc(sizeof(*dpcm), GFP_KERNEL); 457 if (!dpcm) 458 return -ENOMEM; 459 substream->runtime->private_data = dpcm; 460 hrtimer_setup(&dpcm->timer, dummy_hrtimer_callback, CLOCK_MONOTONIC, HRTIMER_MODE_REL_SOFT); 461 dpcm->substream = substream; 462 atomic_set(&dpcm->running, 0); 463 return 0; 464 } 465 466 static void dummy_hrtimer_free(struct snd_pcm_substream *substream) 467 { 468 struct dummy_hrtimer_pcm *dpcm = substream->runtime->private_data; 469 dummy_hrtimer_sync(dpcm); 470 kfree(dpcm); 471 } 472 473 static const struct dummy_timer_ops dummy_hrtimer_ops = { 474 .create = dummy_hrtimer_create, 475 .free = dummy_hrtimer_free, 476 .prepare = dummy_hrtimer_prepare, 477 .start = dummy_hrtimer_start, 478 .stop = dummy_hrtimer_stop, 479 .pointer = dummy_hrtimer_pointer, 480 }; 481 482 #endif /* CONFIG_HIGH_RES_TIMERS */ 483 484 /* 485 * PCM interface 486 */ 487 488 static int dummy_pcm_trigger(struct snd_pcm_substream *substream, int cmd) 489 { 490 switch (cmd) { 491 case SNDRV_PCM_TRIGGER_START: 492 case SNDRV_PCM_TRIGGER_RESUME: 493 return get_dummy_ops(substream)->start(substream); 494 case SNDRV_PCM_TRIGGER_STOP: 495 case SNDRV_PCM_TRIGGER_SUSPEND: 496 return get_dummy_ops(substream)->stop(substream); 497 } 498 return -EINVAL; 499 } 500 501 static int dummy_pcm_prepare(struct snd_pcm_substream *substream) 502 { 503 return get_dummy_ops(substream)->prepare(substream); 504 } 505 506 static snd_pcm_uframes_t dummy_pcm_pointer(struct snd_pcm_substream *substream) 507 { 508 return get_dummy_ops(substream)->pointer(substream); 509 } 510 511 static const struct snd_pcm_hardware dummy_pcm_hardware = { 512 .info = (SNDRV_PCM_INFO_MMAP | 513 SNDRV_PCM_INFO_INTERLEAVED | 514 SNDRV_PCM_INFO_RESUME | 515 SNDRV_PCM_INFO_MMAP_VALID), 516 .formats = USE_FORMATS, 517 .rates = USE_RATE, 518 .rate_min = USE_RATE_MIN, 519 .rate_max = USE_RATE_MAX, 520 .channels_min = USE_CHANNELS_MIN, 521 .channels_max = USE_CHANNELS_MAX, 522 .buffer_bytes_max = MAX_BUFFER_SIZE, 523 .period_bytes_min = MIN_PERIOD_SIZE, 524 .period_bytes_max = MAX_PERIOD_SIZE, 525 .periods_min = USE_PERIODS_MIN, 526 .periods_max = USE_PERIODS_MAX, 527 .fifo_size = 0, 528 }; 529 530 static int dummy_pcm_hw_params(struct snd_pcm_substream *substream, 531 struct snd_pcm_hw_params *hw_params) 532 { 533 if (fake_buffer) { 534 /* runtime->dma_bytes has to be set manually to allow mmap */ 535 substream->runtime->dma_bytes = params_buffer_bytes(hw_params); 536 return 0; 537 } 538 return 0; 539 } 540 541 static int dummy_pcm_open(struct snd_pcm_substream *substream) 542 { 543 struct snd_dummy *dummy = snd_pcm_substream_chip(substream); 544 const struct dummy_model *model = dummy->model; 545 struct snd_pcm_runtime *runtime = substream->runtime; 546 const struct dummy_timer_ops *ops; 547 int err; 548 549 ops = &dummy_systimer_ops; 550 #ifdef CONFIG_HIGH_RES_TIMERS 551 if (hrtimer) 552 ops = &dummy_hrtimer_ops; 553 #endif 554 555 err = ops->create(substream); 556 if (err < 0) 557 return err; 558 get_dummy_ops(substream) = ops; 559 560 runtime->hw = dummy->pcm_hw; 561 if (substream->pcm->device & 1) { 562 runtime->hw.info &= ~SNDRV_PCM_INFO_INTERLEAVED; 563 runtime->hw.info |= SNDRV_PCM_INFO_NONINTERLEAVED; 564 } 565 if (substream->pcm->device & 2) 566 runtime->hw.info &= ~(SNDRV_PCM_INFO_MMAP | 567 SNDRV_PCM_INFO_MMAP_VALID); 568 569 if (model == NULL) 570 return 0; 571 572 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK) { 573 if (model->playback_constraints) 574 err = model->playback_constraints(substream->runtime); 575 } else { 576 if (model->capture_constraints) 577 err = model->capture_constraints(substream->runtime); 578 } 579 if (err < 0) { 580 get_dummy_ops(substream)->free(substream); 581 return err; 582 } 583 return 0; 584 } 585 586 static int dummy_pcm_close(struct snd_pcm_substream *substream) 587 { 588 get_dummy_ops(substream)->free(substream); 589 return 0; 590 } 591 592 /* 593 * dummy buffer handling 594 */ 595 596 static void *dummy_page[2]; 597 598 static void free_fake_buffer(void) 599 { 600 if (fake_buffer) { 601 int i; 602 for (i = 0; i < 2; i++) 603 if (dummy_page[i]) { 604 free_page((unsigned long)dummy_page[i]); 605 dummy_page[i] = NULL; 606 } 607 } 608 } 609 610 static int alloc_fake_buffer(void) 611 { 612 int i; 613 614 if (!fake_buffer) 615 return 0; 616 for (i = 0; i < 2; i++) { 617 dummy_page[i] = (void *)get_zeroed_page(GFP_KERNEL); 618 if (!dummy_page[i]) { 619 free_fake_buffer(); 620 return -ENOMEM; 621 } 622 } 623 return 0; 624 } 625 626 static int dummy_pcm_copy(struct snd_pcm_substream *substream, 627 int channel, unsigned long pos, 628 struct iov_iter *iter, unsigned long bytes) 629 { 630 return 0; /* do nothing */ 631 } 632 633 static int dummy_pcm_silence(struct snd_pcm_substream *substream, 634 int channel, unsigned long pos, 635 unsigned long bytes) 636 { 637 return 0; /* do nothing */ 638 } 639 640 static struct page *dummy_pcm_page(struct snd_pcm_substream *substream, 641 unsigned long offset) 642 { 643 return virt_to_page(dummy_page[substream->stream]); /* the same page */ 644 } 645 646 static const struct snd_pcm_ops dummy_pcm_ops = { 647 .open = dummy_pcm_open, 648 .close = dummy_pcm_close, 649 .hw_params = dummy_pcm_hw_params, 650 .prepare = dummy_pcm_prepare, 651 .trigger = dummy_pcm_trigger, 652 .pointer = dummy_pcm_pointer, 653 }; 654 655 static const struct snd_pcm_ops dummy_pcm_ops_no_buf = { 656 .open = dummy_pcm_open, 657 .close = dummy_pcm_close, 658 .hw_params = dummy_pcm_hw_params, 659 .prepare = dummy_pcm_prepare, 660 .trigger = dummy_pcm_trigger, 661 .pointer = dummy_pcm_pointer, 662 .copy = dummy_pcm_copy, 663 .fill_silence = dummy_pcm_silence, 664 .page = dummy_pcm_page, 665 }; 666 667 static int snd_card_dummy_pcm(struct snd_dummy *dummy, int device, 668 int substreams) 669 { 670 struct snd_pcm *pcm; 671 const struct snd_pcm_ops *ops; 672 int err; 673 674 err = snd_pcm_new(dummy->card, "Dummy PCM", device, 675 substreams, substreams, &pcm); 676 if (err < 0) 677 return err; 678 dummy->pcm = pcm; 679 if (fake_buffer) 680 ops = &dummy_pcm_ops_no_buf; 681 else 682 ops = &dummy_pcm_ops; 683 snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_PLAYBACK, ops); 684 snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE, ops); 685 pcm->private_data = dummy; 686 pcm->info_flags = 0; 687 strcpy(pcm->name, "Dummy PCM"); 688 if (!fake_buffer) { 689 snd_pcm_set_managed_buffer_all(pcm, 690 SNDRV_DMA_TYPE_CONTINUOUS, 691 NULL, 692 0, 64*1024); 693 } 694 return 0; 695 } 696 697 /* 698 * mixer interface 699 */ 700 701 #define DUMMY_VOLUME(xname, xindex, addr) \ 702 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, \ 703 .access = SNDRV_CTL_ELEM_ACCESS_READWRITE | SNDRV_CTL_ELEM_ACCESS_TLV_READ, \ 704 .name = xname, .index = xindex, \ 705 .info = snd_dummy_volume_info, \ 706 .get = snd_dummy_volume_get, .put = snd_dummy_volume_put, \ 707 .private_value = addr, \ 708 .tlv = { .p = db_scale_dummy } } 709 710 static int snd_dummy_volume_info(struct snd_kcontrol *kcontrol, 711 struct snd_ctl_elem_info *uinfo) 712 { 713 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER; 714 uinfo->count = 2; 715 uinfo->value.integer.min = mixer_volume_level_min; 716 uinfo->value.integer.max = mixer_volume_level_max; 717 return 0; 718 } 719 720 static int snd_dummy_volume_get(struct snd_kcontrol *kcontrol, 721 struct snd_ctl_elem_value *ucontrol) 722 { 723 struct snd_dummy *dummy = snd_kcontrol_chip(kcontrol); 724 int addr = kcontrol->private_value; 725 726 spin_lock_irq(&dummy->mixer_lock); 727 ucontrol->value.integer.value[0] = dummy->mixer_volume[addr][0]; 728 ucontrol->value.integer.value[1] = dummy->mixer_volume[addr][1]; 729 spin_unlock_irq(&dummy->mixer_lock); 730 return 0; 731 } 732 733 static int snd_dummy_volume_put(struct snd_kcontrol *kcontrol, 734 struct snd_ctl_elem_value *ucontrol) 735 { 736 struct snd_dummy *dummy = snd_kcontrol_chip(kcontrol); 737 int change, addr = kcontrol->private_value; 738 int left, right; 739 740 left = ucontrol->value.integer.value[0]; 741 if (left < mixer_volume_level_min) 742 left = mixer_volume_level_min; 743 if (left > mixer_volume_level_max) 744 left = mixer_volume_level_max; 745 right = ucontrol->value.integer.value[1]; 746 if (right < mixer_volume_level_min) 747 right = mixer_volume_level_min; 748 if (right > mixer_volume_level_max) 749 right = mixer_volume_level_max; 750 spin_lock_irq(&dummy->mixer_lock); 751 change = dummy->mixer_volume[addr][0] != left || 752 dummy->mixer_volume[addr][1] != right; 753 dummy->mixer_volume[addr][0] = left; 754 dummy->mixer_volume[addr][1] = right; 755 spin_unlock_irq(&dummy->mixer_lock); 756 return change; 757 } 758 759 static const DECLARE_TLV_DB_SCALE(db_scale_dummy, -4500, 30, 0); 760 761 #define DUMMY_CAPSRC(xname, xindex, addr) \ 762 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xindex, \ 763 .info = snd_dummy_capsrc_info, \ 764 .get = snd_dummy_capsrc_get, .put = snd_dummy_capsrc_put, \ 765 .private_value = addr } 766 767 #define snd_dummy_capsrc_info snd_ctl_boolean_stereo_info 768 769 static int snd_dummy_capsrc_get(struct snd_kcontrol *kcontrol, 770 struct snd_ctl_elem_value *ucontrol) 771 { 772 struct snd_dummy *dummy = snd_kcontrol_chip(kcontrol); 773 int addr = kcontrol->private_value; 774 775 spin_lock_irq(&dummy->mixer_lock); 776 ucontrol->value.integer.value[0] = dummy->capture_source[addr][0]; 777 ucontrol->value.integer.value[1] = dummy->capture_source[addr][1]; 778 spin_unlock_irq(&dummy->mixer_lock); 779 return 0; 780 } 781 782 static int snd_dummy_capsrc_put(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol) 783 { 784 struct snd_dummy *dummy = snd_kcontrol_chip(kcontrol); 785 int change, addr = kcontrol->private_value; 786 int left, right; 787 788 left = ucontrol->value.integer.value[0] & 1; 789 right = ucontrol->value.integer.value[1] & 1; 790 spin_lock_irq(&dummy->mixer_lock); 791 change = dummy->capture_source[addr][0] != left && 792 dummy->capture_source[addr][1] != right; 793 dummy->capture_source[addr][0] = left; 794 dummy->capture_source[addr][1] = right; 795 spin_unlock_irq(&dummy->mixer_lock); 796 return change; 797 } 798 799 static int snd_dummy_iobox_info(struct snd_kcontrol *kcontrol, 800 struct snd_ctl_elem_info *info) 801 { 802 static const char *const names[] = { "None", "CD Player" }; 803 804 return snd_ctl_enum_info(info, 1, 2, names); 805 } 806 807 static int snd_dummy_iobox_get(struct snd_kcontrol *kcontrol, 808 struct snd_ctl_elem_value *value) 809 { 810 struct snd_dummy *dummy = snd_kcontrol_chip(kcontrol); 811 812 value->value.enumerated.item[0] = dummy->iobox; 813 return 0; 814 } 815 816 static int snd_dummy_iobox_put(struct snd_kcontrol *kcontrol, 817 struct snd_ctl_elem_value *value) 818 { 819 struct snd_dummy *dummy = snd_kcontrol_chip(kcontrol); 820 int changed; 821 822 if (value->value.enumerated.item[0] > 1) 823 return -EINVAL; 824 825 changed = value->value.enumerated.item[0] != dummy->iobox; 826 if (changed) { 827 dummy->iobox = value->value.enumerated.item[0]; 828 829 if (dummy->iobox) { 830 dummy->cd_volume_ctl->vd[0].access &= 831 ~SNDRV_CTL_ELEM_ACCESS_INACTIVE; 832 dummy->cd_switch_ctl->vd[0].access &= 833 ~SNDRV_CTL_ELEM_ACCESS_INACTIVE; 834 } else { 835 dummy->cd_volume_ctl->vd[0].access |= 836 SNDRV_CTL_ELEM_ACCESS_INACTIVE; 837 dummy->cd_switch_ctl->vd[0].access |= 838 SNDRV_CTL_ELEM_ACCESS_INACTIVE; 839 } 840 841 snd_ctl_notify(dummy->card, SNDRV_CTL_EVENT_MASK_INFO, 842 &dummy->cd_volume_ctl->id); 843 snd_ctl_notify(dummy->card, SNDRV_CTL_EVENT_MASK_INFO, 844 &dummy->cd_switch_ctl->id); 845 } 846 847 return changed; 848 } 849 850 static const struct snd_kcontrol_new snd_dummy_controls[] = { 851 DUMMY_VOLUME("Master Volume", 0, MIXER_ADDR_MASTER), 852 DUMMY_CAPSRC("Master Capture Switch", 0, MIXER_ADDR_MASTER), 853 DUMMY_VOLUME("Synth Volume", 0, MIXER_ADDR_SYNTH), 854 DUMMY_CAPSRC("Synth Capture Switch", 0, MIXER_ADDR_SYNTH), 855 DUMMY_VOLUME("Line Volume", 0, MIXER_ADDR_LINE), 856 DUMMY_CAPSRC("Line Capture Switch", 0, MIXER_ADDR_LINE), 857 DUMMY_VOLUME("Mic Volume", 0, MIXER_ADDR_MIC), 858 DUMMY_CAPSRC("Mic Capture Switch", 0, MIXER_ADDR_MIC), 859 DUMMY_VOLUME("CD Volume", 0, MIXER_ADDR_CD), 860 DUMMY_CAPSRC("CD Capture Switch", 0, MIXER_ADDR_CD), 861 { 862 .iface = SNDRV_CTL_ELEM_IFACE_MIXER, 863 .name = "External I/O Box", 864 .info = snd_dummy_iobox_info, 865 .get = snd_dummy_iobox_get, 866 .put = snd_dummy_iobox_put, 867 }, 868 }; 869 870 static int snd_card_dummy_new_mixer(struct snd_dummy *dummy) 871 { 872 struct snd_card *card = dummy->card; 873 struct snd_kcontrol *kcontrol; 874 unsigned int idx; 875 int err; 876 877 spin_lock_init(&dummy->mixer_lock); 878 strcpy(card->mixername, "Dummy Mixer"); 879 dummy->iobox = 1; 880 881 for (idx = 0; idx < ARRAY_SIZE(snd_dummy_controls); idx++) { 882 kcontrol = snd_ctl_new1(&snd_dummy_controls[idx], dummy); 883 err = snd_ctl_add(card, kcontrol); 884 if (err < 0) 885 return err; 886 if (!strcmp(kcontrol->id.name, "CD Volume")) 887 dummy->cd_volume_ctl = kcontrol; 888 else if (!strcmp(kcontrol->id.name, "CD Capture Switch")) 889 dummy->cd_switch_ctl = kcontrol; 890 891 } 892 return 0; 893 } 894 895 #if defined(CONFIG_SND_DEBUG) && defined(CONFIG_SND_PROC_FS) 896 /* 897 * proc interface 898 */ 899 static void print_formats(struct snd_dummy *dummy, 900 struct snd_info_buffer *buffer) 901 { 902 snd_pcm_format_t i; 903 904 pcm_for_each_format(i) { 905 if (dummy->pcm_hw.formats & pcm_format_to_bits(i)) 906 snd_iprintf(buffer, " %s", snd_pcm_format_name(i)); 907 } 908 } 909 910 static void print_rates(struct snd_dummy *dummy, 911 struct snd_info_buffer *buffer) 912 { 913 static const int rates[] = { 914 5512, 8000, 11025, 16000, 22050, 32000, 44100, 48000, 915 64000, 88200, 96000, 176400, 192000, 916 }; 917 int i; 918 919 if (dummy->pcm_hw.rates & SNDRV_PCM_RATE_CONTINUOUS) 920 snd_iprintf(buffer, " continuous"); 921 if (dummy->pcm_hw.rates & SNDRV_PCM_RATE_KNOT) 922 snd_iprintf(buffer, " knot"); 923 for (i = 0; i < ARRAY_SIZE(rates); i++) 924 if (dummy->pcm_hw.rates & (1 << i)) 925 snd_iprintf(buffer, " %d", rates[i]); 926 } 927 928 #define get_dummy_int_ptr(dummy, ofs) \ 929 (unsigned int *)((char *)&((dummy)->pcm_hw) + (ofs)) 930 #define get_dummy_ll_ptr(dummy, ofs) \ 931 (unsigned long long *)((char *)&((dummy)->pcm_hw) + (ofs)) 932 933 struct dummy_hw_field { 934 const char *name; 935 const char *format; 936 unsigned int offset; 937 unsigned int size; 938 }; 939 #define FIELD_ENTRY(item, fmt) { \ 940 .name = #item, \ 941 .format = fmt, \ 942 .offset = offsetof(struct snd_pcm_hardware, item), \ 943 .size = sizeof(dummy_pcm_hardware.item) } 944 945 static const struct dummy_hw_field fields[] = { 946 FIELD_ENTRY(formats, "%#llx"), 947 FIELD_ENTRY(rates, "%#x"), 948 FIELD_ENTRY(rate_min, "%d"), 949 FIELD_ENTRY(rate_max, "%d"), 950 FIELD_ENTRY(channels_min, "%d"), 951 FIELD_ENTRY(channels_max, "%d"), 952 FIELD_ENTRY(buffer_bytes_max, "%ld"), 953 FIELD_ENTRY(period_bytes_min, "%ld"), 954 FIELD_ENTRY(period_bytes_max, "%ld"), 955 FIELD_ENTRY(periods_min, "%d"), 956 FIELD_ENTRY(periods_max, "%d"), 957 }; 958 959 static void dummy_proc_read(struct snd_info_entry *entry, 960 struct snd_info_buffer *buffer) 961 { 962 struct snd_dummy *dummy = entry->private_data; 963 int i; 964 965 for (i = 0; i < ARRAY_SIZE(fields); i++) { 966 snd_iprintf(buffer, "%s ", fields[i].name); 967 if (fields[i].size == sizeof(int)) 968 snd_iprintf(buffer, fields[i].format, 969 *get_dummy_int_ptr(dummy, fields[i].offset)); 970 else 971 snd_iprintf(buffer, fields[i].format, 972 *get_dummy_ll_ptr(dummy, fields[i].offset)); 973 if (!strcmp(fields[i].name, "formats")) 974 print_formats(dummy, buffer); 975 else if (!strcmp(fields[i].name, "rates")) 976 print_rates(dummy, buffer); 977 snd_iprintf(buffer, "\n"); 978 } 979 } 980 981 static void dummy_proc_write(struct snd_info_entry *entry, 982 struct snd_info_buffer *buffer) 983 { 984 struct snd_dummy *dummy = entry->private_data; 985 char line[64]; 986 987 while (!snd_info_get_line(buffer, line, sizeof(line))) { 988 char item[20]; 989 const char *ptr; 990 unsigned long long val; 991 int i; 992 993 ptr = snd_info_get_str(item, line, sizeof(item)); 994 for (i = 0; i < ARRAY_SIZE(fields); i++) { 995 if (!strcmp(item, fields[i].name)) 996 break; 997 } 998 if (i >= ARRAY_SIZE(fields)) 999 continue; 1000 snd_info_get_str(item, ptr, sizeof(item)); 1001 if (kstrtoull(item, 0, &val)) 1002 continue; 1003 if (fields[i].size == sizeof(int)) 1004 *get_dummy_int_ptr(dummy, fields[i].offset) = val; 1005 else 1006 *get_dummy_ll_ptr(dummy, fields[i].offset) = val; 1007 } 1008 } 1009 1010 static void dummy_proc_init(struct snd_dummy *chip) 1011 { 1012 snd_card_rw_proc_new(chip->card, "dummy_pcm", chip, 1013 dummy_proc_read, dummy_proc_write); 1014 } 1015 #else 1016 #define dummy_proc_init(x) 1017 #endif /* CONFIG_SND_DEBUG && CONFIG_SND_PROC_FS */ 1018 1019 static int snd_dummy_probe(struct platform_device *devptr) 1020 { 1021 struct snd_card *card; 1022 struct snd_dummy *dummy; 1023 const struct dummy_model *m = NULL, **mdl; 1024 int idx, err; 1025 int dev = devptr->id; 1026 1027 err = snd_devm_card_new(&devptr->dev, index[dev], id[dev], THIS_MODULE, 1028 sizeof(struct snd_dummy), &card); 1029 if (err < 0) 1030 return err; 1031 dummy = card->private_data; 1032 dummy->card = card; 1033 for (mdl = dummy_models; *mdl && model[dev]; mdl++) { 1034 if (strcmp(model[dev], (*mdl)->name) == 0) { 1035 pr_info("snd-dummy: Using model '%s' for card %i\n", 1036 (*mdl)->name, card->number); 1037 m = dummy->model = *mdl; 1038 break; 1039 } 1040 } 1041 for (idx = 0; idx < MAX_PCM_DEVICES && idx < pcm_devs[dev]; idx++) { 1042 if (pcm_substreams[dev] < 1) 1043 pcm_substreams[dev] = 1; 1044 if (pcm_substreams[dev] > MAX_PCM_SUBSTREAMS) 1045 pcm_substreams[dev] = MAX_PCM_SUBSTREAMS; 1046 err = snd_card_dummy_pcm(dummy, idx, pcm_substreams[dev]); 1047 if (err < 0) 1048 return err; 1049 } 1050 1051 dummy->pcm_hw = dummy_pcm_hardware; 1052 if (m) { 1053 if (m->formats) 1054 dummy->pcm_hw.formats = m->formats; 1055 if (m->buffer_bytes_max) 1056 dummy->pcm_hw.buffer_bytes_max = m->buffer_bytes_max; 1057 if (m->period_bytes_min) 1058 dummy->pcm_hw.period_bytes_min = m->period_bytes_min; 1059 if (m->period_bytes_max) 1060 dummy->pcm_hw.period_bytes_max = m->period_bytes_max; 1061 if (m->periods_min) 1062 dummy->pcm_hw.periods_min = m->periods_min; 1063 if (m->periods_max) 1064 dummy->pcm_hw.periods_max = m->periods_max; 1065 if (m->rates) 1066 dummy->pcm_hw.rates = m->rates; 1067 if (m->rate_min) 1068 dummy->pcm_hw.rate_min = m->rate_min; 1069 if (m->rate_max) 1070 dummy->pcm_hw.rate_max = m->rate_max; 1071 if (m->channels_min) 1072 dummy->pcm_hw.channels_min = m->channels_min; 1073 if (m->channels_max) 1074 dummy->pcm_hw.channels_max = m->channels_max; 1075 } 1076 1077 if (mixer_volume_level_min > mixer_volume_level_max) { 1078 pr_warn("snd-dummy: Invalid mixer volume level: min=%d, max=%d. Fall back to default value.\n", 1079 mixer_volume_level_min, mixer_volume_level_max); 1080 mixer_volume_level_min = USE_MIXER_VOLUME_LEVEL_MIN; 1081 mixer_volume_level_max = USE_MIXER_VOLUME_LEVEL_MAX; 1082 } 1083 err = snd_card_dummy_new_mixer(dummy); 1084 if (err < 0) 1085 return err; 1086 strcpy(card->driver, "Dummy"); 1087 strcpy(card->shortname, "Dummy"); 1088 sprintf(card->longname, "Dummy %i", dev + 1); 1089 1090 dummy_proc_init(dummy); 1091 1092 err = snd_card_register(card); 1093 if (err < 0) 1094 return err; 1095 platform_set_drvdata(devptr, card); 1096 return 0; 1097 } 1098 1099 static int snd_dummy_suspend(struct device *pdev) 1100 { 1101 struct snd_card *card = dev_get_drvdata(pdev); 1102 1103 snd_power_change_state(card, SNDRV_CTL_POWER_D3hot); 1104 return 0; 1105 } 1106 1107 static int snd_dummy_resume(struct device *pdev) 1108 { 1109 struct snd_card *card = dev_get_drvdata(pdev); 1110 1111 snd_power_change_state(card, SNDRV_CTL_POWER_D0); 1112 return 0; 1113 } 1114 1115 static DEFINE_SIMPLE_DEV_PM_OPS(snd_dummy_pm, snd_dummy_suspend, snd_dummy_resume); 1116 1117 #define SND_DUMMY_DRIVER "snd_dummy" 1118 1119 static struct platform_driver snd_dummy_driver = { 1120 .probe = snd_dummy_probe, 1121 .driver = { 1122 .name = SND_DUMMY_DRIVER, 1123 .pm = &snd_dummy_pm, 1124 }, 1125 }; 1126 1127 static void snd_dummy_unregister_all(void) 1128 { 1129 int i; 1130 1131 for (i = 0; i < ARRAY_SIZE(devices); ++i) 1132 platform_device_unregister(devices[i]); 1133 platform_driver_unregister(&snd_dummy_driver); 1134 free_fake_buffer(); 1135 } 1136 1137 static int __init alsa_card_dummy_init(void) 1138 { 1139 int i, cards, err; 1140 1141 err = platform_driver_register(&snd_dummy_driver); 1142 if (err < 0) 1143 return err; 1144 1145 err = alloc_fake_buffer(); 1146 if (err < 0) { 1147 platform_driver_unregister(&snd_dummy_driver); 1148 return err; 1149 } 1150 1151 cards = 0; 1152 for (i = 0; i < SNDRV_CARDS; i++) { 1153 struct platform_device *device; 1154 if (! enable[i]) 1155 continue; 1156 device = platform_device_register_simple(SND_DUMMY_DRIVER, 1157 i, NULL, 0); 1158 if (IS_ERR(device)) 1159 continue; 1160 if (!platform_get_drvdata(device)) { 1161 platform_device_unregister(device); 1162 continue; 1163 } 1164 devices[i] = device; 1165 cards++; 1166 } 1167 if (!cards) { 1168 #ifdef MODULE 1169 pr_err("Dummy soundcard not found or device busy\n"); 1170 #endif 1171 snd_dummy_unregister_all(); 1172 return -ENODEV; 1173 } 1174 return 0; 1175 } 1176 1177 static void __exit alsa_card_dummy_exit(void) 1178 { 1179 snd_dummy_unregister_all(); 1180 } 1181 1182 module_init(alsa_card_dummy_init) 1183 module_exit(alsa_card_dummy_exit) 1184