linux/sound/usb/mixer_scarlett.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0-or-later
   2/*
   3 *   Scarlett Driver for ALSA
   4 *
   5 *   Copyright (c) 2013 by Tobias Hoffmann
   6 *   Copyright (c) 2013 by Robin Gareus <robin at gareus.org>
   7 *   Copyright (c) 2002 by Takashi Iwai <tiwai at suse.de>
   8 *   Copyright (c) 2014 by Chris J Arges <chris.j.arges at canonical.com>
   9 *
  10 *   Many codes borrowed from audio.c by
  11 *          Alan Cox (alan at lxorguk.ukuu.org.uk)
  12 *          Thomas Sailer (sailer at ife.ee.ethz.ch)
  13 *
  14 *   Code cleanup:
  15 *   David Henningsson <david.henningsson at canonical.com>
  16 */
  17
  18/*
  19 * Rewritten and extended to support more models, e.g. Scarlett 18i8.
  20 *
  21 * Auto-detection via UAC2 is not feasible to properly discover the vast
  22 * majority of features. It's related to both Linux/ALSA's UAC2 as well as
  23 * Focusrite's implementation of it. Eventually quirks may be sufficient but
  24 * right now it's a major headache to work arount these things.
  25 *
  26 * NB. Neither the OSX nor the win driver provided by Focusrite performs
  27 * discovery, they seem to operate the same as this driver.
  28 */
  29
  30/* Mixer Interface for the Focusrite Scarlett 18i6 audio interface.
  31 *
  32 * The protocol was reverse engineered by looking at communication between
  33 * Scarlett MixControl (v 1.2.128.0) and the Focusrite(R) Scarlett 18i6
  34 * (firmware v305) using wireshark and usbmon in January 2013.
  35 * Extended in July 2013.
  36 *
  37 * this mixer gives complete access to all features of the device:
  38 *  - change Impedance of inputs (Line-in, Mic / Instrument, Hi-Z)
  39 *  - select clock source
  40 *  - dynamic input to mixer-matrix assignment
  41 *  - 18 x 6 mixer-matrix gain stages
  42 *  - bus routing & volume control
  43 *  - automatic re-initialization on connect if device was power-cycled
  44 *
  45 * USB URB commands overview (bRequest = 0x01 = UAC2_CS_CUR)
  46 * wIndex
  47 * 0x01 Analog Input line/instrument impedance switch, wValue=0x0901 +
  48 *      channel, data=Line/Inst (2bytes)
  49 *      pad (-10dB) switch, wValue=0x0b01 + channel, data=Off/On (2bytes)
  50 *      ?? wValue=0x0803/04, ?? (2bytes)
  51 * 0x0a Master Volume, wValue=0x0200+bus[0:all + only 1..4?] data(2bytes)
  52 *      Bus Mute/Unmute wValue=0x0100+bus[0:all + only 1..4?], data(2bytes)
  53 * 0x28 Clock source, wValue=0x0100, data={1:int,2:spdif,3:adat} (1byte)
  54 * 0x29 Set Sample-rate, wValue=0x0100, data=sample-rate(4bytes)
  55 * 0x32 Mixer mux, wValue=0x0600 + mixer-channel, data=input-to-connect(2bytes)
  56 * 0x33 Output mux, wValue=bus, data=input-to-connect(2bytes)
  57 * 0x34 Capture mux, wValue=0...18, data=input-to-connect(2bytes)
  58 * 0x3c Matrix Mixer gains, wValue=mixer-node  data=gain(2bytes)
  59 *      ?? [sometimes](4bytes, e.g 0x000003be 0x000003bf ...03ff)
  60 *
  61 * USB reads: (i.e. actually issued by original software)
  62 * 0x01 wValue=0x0901+channel (1byte!!), wValue=0x0b01+channed (1byte!!)
  63 * 0x29 wValue=0x0100 sample-rate(4bytes)
  64 *      wValue=0x0200 ?? 1byte (only once)
  65 * 0x2a wValue=0x0100 ?? 4bytes, sample-rate2 ??
  66 *
  67 * USB reads with bRequest = 0x03 = UAC2_CS_MEM
  68 * 0x3c wValue=0x0002 1byte: sync status (locked=1)
  69 *      wValue=0x0000 18*2byte: peak meter (inputs)
  70 *      wValue=0x0001 8(?)*2byte: peak meter (mix)
  71 *      wValue=0x0003 6*2byte: peak meter (pcm/daw)
  72 *
  73 * USB write with bRequest = 0x03
  74 * 0x3c Save settings to hardware: wValue=0x005a, data=0xa5
  75 *
  76 *
  77 * <ditaa>
  78 *  /--------------\    18chn            6chn    /--------------\
  79 *  | Hardware  in +--+-------\        /------+--+ ALSA PCM out |
  80 *  \--------------/  |       |        |      |  \--------------/
  81 *                    |       |        |      |
  82 *                    |       v        v      |
  83 *                    |   +---------------+   |
  84 *                    |    \ Matrix  Mux /    |
  85 *                    |     +-----+-----+     |
  86 *                    |           |           |
  87 *                    |           | 18chn     |
  88 *                    |           v           |
  89 *                    |     +-----------+     |
  90 *                    |     | Mixer     |     |
  91 *                    |     |    Matrix |     |
  92 *                    |     |           |     |
  93 *                    |     | 18x6 Gain |     |
  94 *                    |     |   stages  |     |
  95 *                    |     +-----+-----+     |
  96 *                    |           |           |
  97 *                    |           |           |
  98 *                    | 18chn     | 6chn      | 6chn
  99 *                    v           v           v
 100 *                    =========================
 101 *             +---------------+     +--—------------+
 102 *              \ Output  Mux /       \ Capture Mux /
 103 *               +-----+-----+         +-----+-----+
 104 *                     |                     |
 105 *                     | 6chn                |
 106 *                     v                     |
 107 *              +-------------+              |
 108 *              | Master Gain |              |
 109 *              +------+------+              |
 110 *                     |                     |
 111 *                     | 6chn                | 18chn
 112 *                     | (3 stereo pairs)    |
 113 *  /--------------\   |                     |   /--------------\
 114 *  | Hardware out |<--/                     \-->| ALSA PCM  in |
 115 *  \--------------/                             \--------------/
 116 * </ditaa>
 117 *
 118 */
 119
 120#include <linux/slab.h>
 121#include <linux/usb.h>
 122#include <linux/usb/audio-v2.h>
 123
 124#include <sound/core.h>
 125#include <sound/control.h>
 126#include <sound/tlv.h>
 127
 128#include "usbaudio.h"
 129#include "mixer.h"
 130#include "helper.h"
 131#include "power.h"
 132
 133#include "mixer_scarlett.h"
 134
 135/* some gui mixers can't handle negative ctl values */
 136#define SND_SCARLETT_LEVEL_BIAS 128
 137#define SND_SCARLETT_MATRIX_IN_MAX 18
 138#define SND_SCARLETT_CONTROLS_MAX 10
 139#define SND_SCARLETT_OFFSETS_MAX 5
 140
 141enum {
 142        SCARLETT_OUTPUTS,
 143        SCARLETT_SWITCH_IMPEDANCE,
 144        SCARLETT_SWITCH_PAD,
 145        SCARLETT_SWITCH_GAIN,
 146};
 147
 148enum {
 149        SCARLETT_OFFSET_PCM = 0,
 150        SCARLETT_OFFSET_ANALOG = 1,
 151        SCARLETT_OFFSET_SPDIF = 2,
 152        SCARLETT_OFFSET_ADAT = 3,
 153        SCARLETT_OFFSET_MIX = 4,
 154};
 155
 156struct scarlett_mixer_elem_enum_info {
 157        int start;
 158        int len;
 159        int offsets[SND_SCARLETT_OFFSETS_MAX];
 160        char const * const *names;
 161};
 162
 163struct scarlett_mixer_control {
 164        unsigned char num;
 165        unsigned char type;
 166        const char *name;
 167};
 168
 169struct scarlett_device_info {
 170        int matrix_in;
 171        int matrix_out;
 172        int input_len;
 173        int output_len;
 174
 175        struct scarlett_mixer_elem_enum_info opt_master;
 176        struct scarlett_mixer_elem_enum_info opt_matrix;
 177
 178        /* initial values for matrix mux */
 179        int matrix_mux_init[SND_SCARLETT_MATRIX_IN_MAX];
 180
 181        int num_controls;       /* number of items in controls */
 182        const struct scarlett_mixer_control controls[SND_SCARLETT_CONTROLS_MAX];
 183};
 184
 185/********************** Enum Strings *************************/
 186
 187static const struct scarlett_mixer_elem_enum_info opt_pad = {
 188        .start = 0,
 189        .len = 2,
 190        .offsets = {},
 191        .names = (char const * const []){
 192                "0dB", "-10dB"
 193        }
 194};
 195
 196static const struct scarlett_mixer_elem_enum_info opt_gain = {
 197        .start = 0,
 198        .len = 2,
 199        .offsets = {},
 200        .names = (char const * const []){
 201                "Lo", "Hi"
 202        }
 203};
 204
 205static const struct scarlett_mixer_elem_enum_info opt_impedance = {
 206        .start = 0,
 207        .len = 2,
 208        .offsets = {},
 209        .names = (char const * const []){
 210                "Line", "Hi-Z"
 211        }
 212};
 213
 214static const struct scarlett_mixer_elem_enum_info opt_clock = {
 215        .start = 1,
 216        .len = 3,
 217        .offsets = {},
 218        .names = (char const * const []){
 219                "Internal", "SPDIF", "ADAT"
 220        }
 221};
 222
 223static const struct scarlett_mixer_elem_enum_info opt_sync = {
 224        .start = 0,
 225        .len = 2,
 226        .offsets = {},
 227        .names = (char const * const []){
 228                "No Lock", "Locked"
 229        }
 230};
 231
 232static int scarlett_ctl_switch_info(struct snd_kcontrol *kctl,
 233                struct snd_ctl_elem_info *uinfo)
 234{
 235        struct usb_mixer_elem_info *elem = kctl->private_data;
 236
 237        uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
 238        uinfo->count = elem->channels;
 239        uinfo->value.integer.min = 0;
 240        uinfo->value.integer.max = 1;
 241        return 0;
 242}
 243
 244static int scarlett_ctl_switch_get(struct snd_kcontrol *kctl,
 245                struct snd_ctl_elem_value *ucontrol)
 246{
 247        struct usb_mixer_elem_info *elem = kctl->private_data;
 248        int i, err, val;
 249
 250        for (i = 0; i < elem->channels; i++) {
 251                err = snd_usb_get_cur_mix_value(elem, i, i, &val);
 252                if (err < 0)
 253                        return err;
 254
 255                val = !val; /* invert mute logic for mixer */
 256                ucontrol->value.integer.value[i] = val;
 257        }
 258
 259        return 0;
 260}
 261
 262static int scarlett_ctl_switch_put(struct snd_kcontrol *kctl,
 263                struct snd_ctl_elem_value *ucontrol)
 264{
 265        struct usb_mixer_elem_info *elem = kctl->private_data;
 266        int i, changed = 0;
 267        int err, oval, val;
 268
 269        for (i = 0; i < elem->channels; i++) {
 270                err = snd_usb_get_cur_mix_value(elem, i, i, &oval);
 271                if (err < 0)
 272                        return err;
 273
 274                val = ucontrol->value.integer.value[i];
 275                val = !val;
 276                if (oval != val) {
 277                        err = snd_usb_set_cur_mix_value(elem, i, i, val);
 278                        if (err < 0)
 279                                return err;
 280
 281                        changed = 1;
 282                }
 283        }
 284
 285        return changed;
 286}
 287
 288static int scarlett_ctl_resume(struct usb_mixer_elem_list *list)
 289{
 290        struct usb_mixer_elem_info *elem = mixer_elem_list_to_info(list);
 291        int i;
 292
 293        for (i = 0; i < elem->channels; i++)
 294                if (elem->cached & (1 << i))
 295                        snd_usb_set_cur_mix_value(elem, i, i,
 296                                                  elem->cache_val[i]);
 297        return 0;
 298}
 299
 300static int scarlett_ctl_info(struct snd_kcontrol *kctl,
 301                             struct snd_ctl_elem_info *uinfo)
 302{
 303        struct usb_mixer_elem_info *elem = kctl->private_data;
 304
 305        uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
 306        uinfo->count = elem->channels;
 307        uinfo->value.integer.min = 0;
 308        uinfo->value.integer.max = (int)kctl->private_value +
 309                SND_SCARLETT_LEVEL_BIAS;
 310        uinfo->value.integer.step = 1;
 311        return 0;
 312}
 313
 314static int scarlett_ctl_get(struct snd_kcontrol *kctl,
 315                            struct snd_ctl_elem_value *ucontrol)
 316{
 317        struct usb_mixer_elem_info *elem = kctl->private_data;
 318        int i, err, val;
 319
 320        for (i = 0; i < elem->channels; i++) {
 321                err = snd_usb_get_cur_mix_value(elem, i, i, &val);
 322                if (err < 0)
 323                        return err;
 324
 325                val = clamp(val / 256, -128, (int)kctl->private_value) +
 326                                    SND_SCARLETT_LEVEL_BIAS;
 327                ucontrol->value.integer.value[i] = val;
 328        }
 329
 330        return 0;
 331}
 332
 333static int scarlett_ctl_put(struct snd_kcontrol *kctl,
 334                            struct snd_ctl_elem_value *ucontrol)
 335{
 336        struct usb_mixer_elem_info *elem = kctl->private_data;
 337        int i, changed = 0;
 338        int err, oval, val;
 339
 340        for (i = 0; i < elem->channels; i++) {
 341                err = snd_usb_get_cur_mix_value(elem, i, i, &oval);
 342                if (err < 0)
 343                        return err;
 344
 345                val = ucontrol->value.integer.value[i] -
 346                        SND_SCARLETT_LEVEL_BIAS;
 347                val = val * 256;
 348                if (oval != val) {
 349                        err = snd_usb_set_cur_mix_value(elem, i, i, val);
 350                        if (err < 0)
 351                                return err;
 352
 353                        changed = 1;
 354                }
 355        }
 356
 357        return changed;
 358}
 359
 360static void scarlett_generate_name(int i, char *dst, int offsets[])
 361{
 362        if (i > offsets[SCARLETT_OFFSET_MIX])
 363                sprintf(dst, "Mix %c",
 364                        'A'+(i - offsets[SCARLETT_OFFSET_MIX] - 1));
 365        else if (i > offsets[SCARLETT_OFFSET_ADAT])
 366                sprintf(dst, "ADAT %d", i - offsets[SCARLETT_OFFSET_ADAT]);
 367        else if (i > offsets[SCARLETT_OFFSET_SPDIF])
 368                sprintf(dst, "SPDIF %d", i - offsets[SCARLETT_OFFSET_SPDIF]);
 369        else if (i > offsets[SCARLETT_OFFSET_ANALOG])
 370                sprintf(dst, "Analog %d", i - offsets[SCARLETT_OFFSET_ANALOG]);
 371        else if (i > offsets[SCARLETT_OFFSET_PCM])
 372                sprintf(dst, "PCM %d", i - offsets[SCARLETT_OFFSET_PCM]);
 373        else
 374                sprintf(dst, "Off");
 375}
 376
 377static int scarlett_ctl_enum_dynamic_info(struct snd_kcontrol *kctl,
 378                                          struct snd_ctl_elem_info *uinfo)
 379{
 380        struct usb_mixer_elem_info *elem = kctl->private_data;
 381        struct scarlett_mixer_elem_enum_info *opt = elem->private_data;
 382        unsigned int items = opt->len;
 383
 384        uinfo->type = SNDRV_CTL_ELEM_TYPE_ENUMERATED;
 385        uinfo->count = elem->channels;
 386        uinfo->value.enumerated.items = items;
 387
 388        if (uinfo->value.enumerated.item >= items)
 389                uinfo->value.enumerated.item = items - 1;
 390
 391        /* generate name dynamically based on item number and offset info */
 392        scarlett_generate_name(uinfo->value.enumerated.item,
 393                               uinfo->value.enumerated.name,
 394                               opt->offsets);
 395
 396        return 0;
 397}
 398
 399static int scarlett_ctl_enum_info(struct snd_kcontrol *kctl,
 400                                  struct snd_ctl_elem_info *uinfo)
 401{
 402        struct usb_mixer_elem_info *elem = kctl->private_data;
 403        struct scarlett_mixer_elem_enum_info *opt = elem->private_data;
 404
 405        return snd_ctl_enum_info(uinfo, elem->channels, opt->len,
 406                                 (const char * const *)opt->names);
 407}
 408
 409static int scarlett_ctl_enum_get(struct snd_kcontrol *kctl,
 410                                 struct snd_ctl_elem_value *ucontrol)
 411{
 412        struct usb_mixer_elem_info *elem = kctl->private_data;
 413        struct scarlett_mixer_elem_enum_info *opt = elem->private_data;
 414        int err, val;
 415
 416        err = snd_usb_get_cur_mix_value(elem, 0, 0, &val);
 417        if (err < 0)
 418                return err;
 419
 420        val = clamp(val - opt->start, 0, opt->len-1);
 421
 422        ucontrol->value.enumerated.item[0] = val;
 423
 424        return 0;
 425}
 426
 427static int scarlett_ctl_enum_put(struct snd_kcontrol *kctl,
 428                                 struct snd_ctl_elem_value *ucontrol)
 429{
 430        struct usb_mixer_elem_info *elem = kctl->private_data;
 431        struct scarlett_mixer_elem_enum_info *opt = elem->private_data;
 432        int err, oval, val;
 433
 434        err = snd_usb_get_cur_mix_value(elem, 0, 0, &oval);
 435        if (err < 0)
 436                return err;
 437
 438        val = ucontrol->value.integer.value[0];
 439        val = val + opt->start;
 440        if (val != oval) {
 441                snd_usb_set_cur_mix_value(elem, 0, 0, val);
 442                return 1;
 443        }
 444        return 0;
 445}
 446
 447static int scarlett_ctl_enum_resume(struct usb_mixer_elem_list *list)
 448{
 449        struct usb_mixer_elem_info *elem = mixer_elem_list_to_info(list);
 450
 451        if (elem->cached)
 452                snd_usb_set_cur_mix_value(elem, 0, 0, *elem->cache_val);
 453        return 0;
 454}
 455
 456static int scarlett_ctl_meter_get(struct snd_kcontrol *kctl,
 457                                  struct snd_ctl_elem_value *ucontrol)
 458{
 459        struct usb_mixer_elem_info *elem = kctl->private_data;
 460        struct snd_usb_audio *chip = elem->head.mixer->chip;
 461        unsigned char buf[2 * MAX_CHANNELS] = {0, };
 462        int wValue = (elem->control << 8) | elem->idx_off;
 463        int idx = snd_usb_ctrl_intf(chip) | (elem->head.id << 8);
 464        int err;
 465
 466        err = snd_usb_ctl_msg(chip->dev,
 467                                usb_rcvctrlpipe(chip->dev, 0),
 468                                UAC2_CS_MEM,
 469                                USB_RECIP_INTERFACE | USB_TYPE_CLASS |
 470                                USB_DIR_IN, wValue, idx, buf, elem->channels);
 471        if (err < 0)
 472                return err;
 473
 474        ucontrol->value.enumerated.item[0] = clamp((int)buf[0], 0, 1);
 475        return 0;
 476}
 477
 478static const struct snd_kcontrol_new usb_scarlett_ctl_switch = {
 479        .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
 480        .name = "",
 481        .info = scarlett_ctl_switch_info,
 482        .get =  scarlett_ctl_switch_get,
 483        .put =  scarlett_ctl_switch_put,
 484};
 485
 486static const DECLARE_TLV_DB_SCALE(db_scale_scarlett_gain, -12800, 100, 0);
 487
 488static const struct snd_kcontrol_new usb_scarlett_ctl = {
 489        .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
 490        .access = SNDRV_CTL_ELEM_ACCESS_READWRITE |
 491                  SNDRV_CTL_ELEM_ACCESS_TLV_READ,
 492        .name = "",
 493        .info = scarlett_ctl_info,
 494        .get =  scarlett_ctl_get,
 495        .put =  scarlett_ctl_put,
 496        .private_value = 6,  /* max value */
 497        .tlv = { .p = db_scale_scarlett_gain }
 498};
 499
 500static const struct snd_kcontrol_new usb_scarlett_ctl_master = {
 501        .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
 502        .access = SNDRV_CTL_ELEM_ACCESS_READWRITE |
 503                  SNDRV_CTL_ELEM_ACCESS_TLV_READ,
 504        .name = "",
 505        .info = scarlett_ctl_info,
 506        .get =  scarlett_ctl_get,
 507        .put =  scarlett_ctl_put,
 508        .private_value = 6,  /* max value */
 509        .tlv = { .p = db_scale_scarlett_gain }
 510};
 511
 512static const struct snd_kcontrol_new usb_scarlett_ctl_enum = {
 513        .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
 514        .name = "",
 515        .info = scarlett_ctl_enum_info,
 516        .get =  scarlett_ctl_enum_get,
 517        .put =  scarlett_ctl_enum_put,
 518};
 519
 520static const struct snd_kcontrol_new usb_scarlett_ctl_dynamic_enum = {
 521        .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
 522        .name = "",
 523        .info = scarlett_ctl_enum_dynamic_info,
 524        .get =  scarlett_ctl_enum_get,
 525        .put =  scarlett_ctl_enum_put,
 526};
 527
 528static const struct snd_kcontrol_new usb_scarlett_ctl_sync = {
 529        .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
 530        .access = SNDRV_CTL_ELEM_ACCESS_READ | SNDRV_CTL_ELEM_ACCESS_VOLATILE,
 531        .name = "",
 532        .info = scarlett_ctl_enum_info,
 533        .get =  scarlett_ctl_meter_get,
 534};
 535
 536static int add_new_ctl(struct usb_mixer_interface *mixer,
 537                       const struct snd_kcontrol_new *ncontrol,
 538                       usb_mixer_elem_resume_func_t resume,
 539                       int index, int offset, int num,
 540                       int val_type, int channels, const char *name,
 541                       const struct scarlett_mixer_elem_enum_info *opt,
 542                       struct usb_mixer_elem_info **elem_ret
 543)
 544{
 545        struct snd_kcontrol *kctl;
 546        struct usb_mixer_elem_info *elem;
 547        int err;
 548
 549        elem = kzalloc(sizeof(*elem), GFP_KERNEL);
 550        if (!elem)
 551                return -ENOMEM;
 552
 553        elem->head.mixer = mixer;
 554        elem->head.resume = resume;
 555        elem->control = offset;
 556        elem->idx_off = num;
 557        elem->head.id = index;
 558        elem->val_type = val_type;
 559
 560        elem->channels = channels;
 561
 562        /* add scarlett_mixer_elem_enum_info struct */
 563        elem->private_data = (void *)opt;
 564
 565        kctl = snd_ctl_new1(ncontrol, elem);
 566        if (!kctl) {
 567                kfree(elem);
 568                return -ENOMEM;
 569        }
 570        kctl->private_free = snd_usb_mixer_elem_free;
 571
 572        strlcpy(kctl->id.name, name, sizeof(kctl->id.name));
 573
 574        err = snd_usb_mixer_add_control(&elem->head, kctl);
 575        if (err < 0)
 576                return err;
 577
 578        if (elem_ret)
 579                *elem_ret = elem;
 580
 581        return 0;
 582}
 583
 584static int add_output_ctls(struct usb_mixer_interface *mixer,
 585                           int index, const char *name,
 586                           const struct scarlett_device_info *info)
 587{
 588        int err;
 589        char mx[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
 590        struct usb_mixer_elem_info *elem;
 591
 592        /* Add mute switch */
 593        snprintf(mx, sizeof(mx), "Master %d (%s) Playback Switch",
 594                index + 1, name);
 595        err = add_new_ctl(mixer, &usb_scarlett_ctl_switch,
 596                          scarlett_ctl_resume, 0x0a, 0x01,
 597                          2*index+1, USB_MIXER_S16, 2, mx, NULL, &elem);
 598        if (err < 0)
 599                return err;
 600
 601        /* Add volume control and initialize to 0 */
 602        snprintf(mx, sizeof(mx), "Master %d (%s) Playback Volume",
 603                index + 1, name);
 604        err = add_new_ctl(mixer, &usb_scarlett_ctl_master,
 605                          scarlett_ctl_resume, 0x0a, 0x02,
 606                          2*index+1, USB_MIXER_S16, 2, mx, NULL, &elem);
 607        if (err < 0)
 608                return err;
 609
 610        /* Add L channel source playback enumeration */
 611        snprintf(mx, sizeof(mx), "Master %dL (%s) Source Playback Enum",
 612                index + 1, name);
 613        err = add_new_ctl(mixer, &usb_scarlett_ctl_dynamic_enum,
 614                          scarlett_ctl_enum_resume, 0x33, 0x00,
 615                          2*index, USB_MIXER_S16, 1, mx, &info->opt_master,
 616                          &elem);
 617        if (err < 0)
 618                return err;
 619
 620        /* Add R channel source playback enumeration */
 621        snprintf(mx, sizeof(mx), "Master %dR (%s) Source Playback Enum",
 622                index + 1, name);
 623        err = add_new_ctl(mixer, &usb_scarlett_ctl_dynamic_enum,
 624                          scarlett_ctl_enum_resume, 0x33, 0x00,
 625                          2*index+1, USB_MIXER_S16, 1, mx, &info->opt_master,
 626                          &elem);
 627        if (err < 0)
 628                return err;
 629
 630        return 0;
 631}
 632
 633/********************** device-specific config *************************/
 634
 635/*  untested...  */
 636static const struct scarlett_device_info s6i6_info = {
 637        .matrix_in = 18,
 638        .matrix_out = 8,
 639        .input_len = 6,
 640        .output_len = 6,
 641
 642        .opt_master = {
 643                .start = -1,
 644                .len = 27,
 645                .offsets = {0, 12, 16, 18, 18},
 646                .names = NULL
 647        },
 648
 649        .opt_matrix = {
 650                .start = -1,
 651                .len = 19,
 652                .offsets = {0, 12, 16, 18, 18},
 653                .names = NULL
 654        },
 655
 656        .num_controls = 9,
 657        .controls = {
 658                { .num = 0, .type = SCARLETT_OUTPUTS, .name = "Monitor" },
 659                { .num = 1, .type = SCARLETT_OUTPUTS, .name = "Headphone" },
 660                { .num = 2, .type = SCARLETT_OUTPUTS, .name = "SPDIF" },
 661                { .num = 1, .type = SCARLETT_SWITCH_IMPEDANCE, .name = NULL},
 662                { .num = 1, .type = SCARLETT_SWITCH_PAD, .name = NULL},
 663                { .num = 2, .type = SCARLETT_SWITCH_IMPEDANCE, .name = NULL},
 664                { .num = 2, .type = SCARLETT_SWITCH_PAD, .name = NULL},
 665                { .num = 3, .type = SCARLETT_SWITCH_GAIN, .name = NULL},
 666                { .num = 4, .type = SCARLETT_SWITCH_GAIN, .name = NULL},
 667        },
 668
 669        .matrix_mux_init = {
 670                12, 13, 14, 15,                 /* Analog -> 1..4 */
 671                16, 17,                          /* SPDIF -> 5,6 */
 672                0, 1, 2, 3, 4, 5, 6, 7,     /* PCM[1..12] -> 7..18 */
 673                8, 9, 10, 11
 674        }
 675};
 676
 677/*  untested...  */
 678static const struct scarlett_device_info s8i6_info = {
 679        .matrix_in = 18,
 680        .matrix_out = 6,
 681        .input_len = 8,
 682        .output_len = 6,
 683
 684        .opt_master = {
 685                .start = -1,
 686                .len = 25,
 687                .offsets = {0, 12, 16, 18, 18},
 688                .names = NULL
 689        },
 690
 691        .opt_matrix = {
 692                .start = -1,
 693                .len = 19,
 694                .offsets = {0, 12, 16, 18, 18},
 695                .names = NULL
 696        },
 697
 698        .num_controls = 7,
 699        .controls = {
 700                { .num = 0, .type = SCARLETT_OUTPUTS, .name = "Monitor" },
 701                { .num = 1, .type = SCARLETT_OUTPUTS, .name = "Headphone" },
 702                { .num = 2, .type = SCARLETT_OUTPUTS, .name = "SPDIF" },
 703                { .num = 1, .type = SCARLETT_SWITCH_IMPEDANCE, .name = NULL},
 704                { .num = 2, .type = SCARLETT_SWITCH_IMPEDANCE, .name = NULL},
 705                { .num = 3, .type = SCARLETT_SWITCH_PAD, .name = NULL},
 706                { .num = 4, .type = SCARLETT_SWITCH_PAD, .name = NULL},
 707        },
 708
 709        .matrix_mux_init = {
 710                12, 13, 14, 15,                 /* Analog -> 1..4 */
 711                16, 17,                          /* SPDIF -> 5,6 */
 712                0, 1, 2, 3, 4, 5, 6, 7,     /* PCM[1..12] -> 7..18 */
 713                8, 9, 10, 11
 714        }
 715};
 716
 717static const struct scarlett_device_info s18i6_info = {
 718        .matrix_in = 18,
 719        .matrix_out = 6,
 720        .input_len = 18,
 721        .output_len = 6,
 722
 723        .opt_master = {
 724                .start = -1,
 725                .len = 31,
 726                .offsets = {0, 6, 14, 16, 24},
 727                .names = NULL,
 728        },
 729
 730        .opt_matrix = {
 731                .start = -1,
 732                .len = 25,
 733                .offsets = {0, 6, 14, 16, 24},
 734                .names = NULL,
 735        },
 736
 737        .num_controls = 5,
 738        .controls = {
 739                { .num = 0, .type = SCARLETT_OUTPUTS, .name = "Monitor" },
 740                { .num = 1, .type = SCARLETT_OUTPUTS, .name = "Headphone" },
 741                { .num = 2, .type = SCARLETT_OUTPUTS, .name = "SPDIF" },
 742                { .num = 1, .type = SCARLETT_SWITCH_IMPEDANCE, .name = NULL},
 743                { .num = 2, .type = SCARLETT_SWITCH_IMPEDANCE, .name = NULL},
 744        },
 745
 746        .matrix_mux_init = {
 747                 6,  7,  8,  9, 10, 11, 12, 13, /* Analog -> 1..8 */
 748                16, 17, 18, 19, 20, 21,     /* ADAT[1..6] -> 9..14 */
 749                14, 15,                          /* SPDIF -> 15,16 */
 750                0, 1                          /* PCM[1,2] -> 17,18 */
 751        }
 752};
 753
 754static const struct scarlett_device_info s18i8_info = {
 755        .matrix_in = 18,
 756        .matrix_out = 8,
 757        .input_len = 18,
 758        .output_len = 8,
 759
 760        .opt_master = {
 761                .start = -1,
 762                .len = 35,
 763                .offsets = {0, 8, 16, 18, 26},
 764                .names = NULL
 765        },
 766
 767        .opt_matrix = {
 768                .start = -1,
 769                .len = 27,
 770                .offsets = {0, 8, 16, 18, 26},
 771                .names = NULL
 772        },
 773
 774        .num_controls = 10,
 775        .controls = {
 776                { .num = 0, .type = SCARLETT_OUTPUTS, .name = "Monitor" },
 777                { .num = 1, .type = SCARLETT_OUTPUTS, .name = "Headphone 1" },
 778                { .num = 2, .type = SCARLETT_OUTPUTS, .name = "Headphone 2" },
 779                { .num = 3, .type = SCARLETT_OUTPUTS, .name = "SPDIF" },
 780                { .num = 1, .type = SCARLETT_SWITCH_IMPEDANCE, .name = NULL},
 781                { .num = 1, .type = SCARLETT_SWITCH_PAD, .name = NULL},
 782                { .num = 2, .type = SCARLETT_SWITCH_IMPEDANCE, .name = NULL},
 783                { .num = 2, .type = SCARLETT_SWITCH_PAD, .name = NULL},
 784                { .num = 3, .type = SCARLETT_SWITCH_PAD, .name = NULL},
 785                { .num = 4, .type = SCARLETT_SWITCH_PAD, .name = NULL},
 786        },
 787
 788        .matrix_mux_init = {
 789                 8,  9, 10, 11, 12, 13, 14, 15, /* Analog -> 1..8 */
 790                18, 19, 20, 21, 22, 23,     /* ADAT[1..6] -> 9..14 */
 791                16, 17,                          /* SPDIF -> 15,16 */
 792                0, 1                          /* PCM[1,2] -> 17,18 */
 793        }
 794};
 795
 796static const struct scarlett_device_info s18i20_info = {
 797        .matrix_in = 18,
 798        .matrix_out = 8,
 799        .input_len = 18,
 800        .output_len = 20,
 801
 802        .opt_master = {
 803                .start = -1,
 804                .len = 47,
 805                .offsets = {0, 20, 28, 30, 38},
 806                .names = NULL
 807        },
 808
 809        .opt_matrix = {
 810                .start = -1,
 811                .len = 39,
 812                .offsets = {0, 20, 28, 30, 38},
 813                .names = NULL
 814        },
 815
 816        .num_controls = 10,
 817        .controls = {
 818                { .num = 0, .type = SCARLETT_OUTPUTS, .name = "Monitor" },
 819                { .num = 1, .type = SCARLETT_OUTPUTS, .name = "Line 3/4" },
 820                { .num = 2, .type = SCARLETT_OUTPUTS, .name = "Line 5/6" },
 821                { .num = 3, .type = SCARLETT_OUTPUTS, .name = "Line 7/8" },
 822                { .num = 4, .type = SCARLETT_OUTPUTS, .name = "Line 9/10" },
 823                { .num = 5, .type = SCARLETT_OUTPUTS, .name = "SPDIF" },
 824                { .num = 6, .type = SCARLETT_OUTPUTS, .name = "ADAT 1/2" },
 825                { .num = 7, .type = SCARLETT_OUTPUTS, .name = "ADAT 3/4" },
 826                { .num = 8, .type = SCARLETT_OUTPUTS, .name = "ADAT 5/6" },
 827                { .num = 9, .type = SCARLETT_OUTPUTS, .name = "ADAT 7/8" },
 828                /*{ .num = 1, .type = SCARLETT_SWITCH_IMPEDANCE, .name = NULL},
 829                { .num = 1, .type = SCARLETT_SWITCH_PAD, .name = NULL},
 830                { .num = 2, .type = SCARLETT_SWITCH_IMPEDANCE, .name = NULL},
 831                { .num = 2, .type = SCARLETT_SWITCH_PAD, .name = NULL},
 832                { .num = 3, .type = SCARLETT_SWITCH_PAD, .name = NULL},
 833                { .num = 4, .type = SCARLETT_SWITCH_PAD, .name = NULL},*/
 834        },
 835
 836        .matrix_mux_init = {
 837                20, 21, 22, 23, 24, 25, 26, 27, /* Analog -> 1..8 */
 838                30, 31, 32, 33, 34, 35,     /* ADAT[1..6] -> 9..14 */
 839                28, 29,                          /* SPDIF -> 15,16 */
 840                0, 1                          /* PCM[1,2] -> 17,18 */
 841        }
 842};
 843
 844
 845static int scarlett_controls_create_generic(struct usb_mixer_interface *mixer,
 846        const struct scarlett_device_info *info)
 847{
 848        int i, err;
 849        char mx[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
 850        const struct scarlett_mixer_control *ctl;
 851        struct usb_mixer_elem_info *elem;
 852
 853        /* create master switch and playback volume */
 854        err = add_new_ctl(mixer, &usb_scarlett_ctl_switch,
 855                          scarlett_ctl_resume, 0x0a, 0x01, 0,
 856                          USB_MIXER_S16, 1, "Master Playback Switch", NULL,
 857                          &elem);
 858        if (err < 0)
 859                return err;
 860
 861        err = add_new_ctl(mixer, &usb_scarlett_ctl_master,
 862                          scarlett_ctl_resume, 0x0a, 0x02, 0,
 863                          USB_MIXER_S16, 1, "Master Playback Volume", NULL,
 864                          &elem);
 865        if (err < 0)
 866                return err;
 867
 868        /* iterate through controls in info struct and create each one */
 869        for (i = 0; i < info->num_controls; i++) {
 870                ctl = &info->controls[i];
 871
 872                switch (ctl->type) {
 873                case SCARLETT_OUTPUTS:
 874                        err = add_output_ctls(mixer, ctl->num, ctl->name, info);
 875                        if (err < 0)
 876                                return err;
 877                        break;
 878                case SCARLETT_SWITCH_IMPEDANCE:
 879                        sprintf(mx, "Input %d Impedance Switch", ctl->num);
 880                        err = add_new_ctl(mixer, &usb_scarlett_ctl_enum,
 881                                          scarlett_ctl_enum_resume, 0x01,
 882                                          0x09, ctl->num, USB_MIXER_S16, 1, mx,
 883                                          &opt_impedance, &elem);
 884                        if (err < 0)
 885                                return err;
 886                        break;
 887                case SCARLETT_SWITCH_PAD:
 888                        sprintf(mx, "Input %d Pad Switch", ctl->num);
 889                        err = add_new_ctl(mixer, &usb_scarlett_ctl_enum,
 890                                          scarlett_ctl_enum_resume, 0x01,
 891                                          0x0b, ctl->num, USB_MIXER_S16, 1, mx,
 892                                          &opt_pad, &elem);
 893                        if (err < 0)
 894                                return err;
 895                        break;
 896                case SCARLETT_SWITCH_GAIN:
 897                        sprintf(mx, "Input %d Gain Switch", ctl->num);
 898                        err = add_new_ctl(mixer, &usb_scarlett_ctl_enum,
 899                                          scarlett_ctl_enum_resume, 0x01,
 900                                          0x08, ctl->num, USB_MIXER_S16, 1, mx,
 901                                          &opt_gain, &elem);
 902                        if (err < 0)
 903                                return err;
 904                        break;
 905                }
 906        }
 907
 908        return 0;
 909}
 910
 911/*
 912 * Create and initialize a mixer for the Focusrite(R) Scarlett
 913 */
 914int snd_scarlett_controls_create(struct usb_mixer_interface *mixer)
 915{
 916        int err, i, o;
 917        char mx[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
 918        const struct scarlett_device_info *info;
 919        struct usb_mixer_elem_info *elem;
 920        static char sample_rate_buffer[4] = { '\x80', '\xbb', '\x00', '\x00' };
 921
 922        /* only use UAC_VERSION_2 */
 923        if (!mixer->protocol)
 924                return 0;
 925
 926        switch (mixer->chip->usb_id) {
 927        case USB_ID(0x1235, 0x8012):
 928                info = &s6i6_info;
 929                break;
 930        case USB_ID(0x1235, 0x8002):
 931                info = &s8i6_info;
 932                break;
 933        case USB_ID(0x1235, 0x8004):
 934                info = &s18i6_info;
 935                break;
 936        case USB_ID(0x1235, 0x8014):
 937                info = &s18i8_info;
 938                break;
 939        case USB_ID(0x1235, 0x800c):
 940                info = &s18i20_info;
 941                break;
 942        default: /* device not (yet) supported */
 943                return -EINVAL;
 944        }
 945
 946        /* generic function to create controls */
 947        err = scarlett_controls_create_generic(mixer, info);
 948        if (err < 0)
 949                return err;
 950
 951        /* setup matrix controls */
 952        for (i = 0; i < info->matrix_in; i++) {
 953                snprintf(mx, sizeof(mx), "Matrix %02d Input Playback Route",
 954                         i+1);
 955                err = add_new_ctl(mixer, &usb_scarlett_ctl_dynamic_enum,
 956                                  scarlett_ctl_enum_resume, 0x32,
 957                                  0x06, i, USB_MIXER_S16, 1, mx,
 958                                  &info->opt_matrix, &elem);
 959                if (err < 0)
 960                        return err;
 961
 962                for (o = 0; o < info->matrix_out; o++) {
 963                        sprintf(mx, "Matrix %02d Mix %c Playback Volume", i+1,
 964                                o+'A');
 965                        err = add_new_ctl(mixer, &usb_scarlett_ctl,
 966                                          scarlett_ctl_resume, 0x3c, 0x00,
 967                                          (i << 3) + (o & 0x07), USB_MIXER_S16,
 968                                          1, mx, NULL, &elem);
 969                        if (err < 0)
 970                                return err;
 971
 972                }
 973        }
 974
 975        for (i = 0; i < info->input_len; i++) {
 976                snprintf(mx, sizeof(mx), "Input Source %02d Capture Route",
 977                         i+1);
 978                err = add_new_ctl(mixer, &usb_scarlett_ctl_dynamic_enum,
 979                                  scarlett_ctl_enum_resume, 0x34,
 980                                  0x00, i, USB_MIXER_S16, 1, mx,
 981                                  &info->opt_master, &elem);
 982                if (err < 0)
 983                        return err;
 984        }
 985
 986        /* val_len == 1 needed here */
 987        err = add_new_ctl(mixer, &usb_scarlett_ctl_enum,
 988                          scarlett_ctl_enum_resume, 0x28, 0x01, 0,
 989                          USB_MIXER_U8, 1, "Sample Clock Source",
 990                          &opt_clock, &elem);
 991        if (err < 0)
 992                return err;
 993
 994        /* val_len == 1 and UAC2_CS_MEM */
 995        err = add_new_ctl(mixer, &usb_scarlett_ctl_sync, NULL, 0x3c, 0x00, 2,
 996                          USB_MIXER_U8, 1, "Sample Clock Sync Status",
 997                          &opt_sync, &elem);
 998        if (err < 0)
 999                return err;
1000
1001        /* initialize sampling rate to 48000 */
1002        err = snd_usb_ctl_msg(mixer->chip->dev,
1003                usb_sndctrlpipe(mixer->chip->dev, 0), UAC2_CS_CUR,
1004                USB_RECIP_INTERFACE | USB_TYPE_CLASS |
1005                USB_DIR_OUT, 0x0100, snd_usb_ctrl_intf(mixer->chip) |
1006                (0x29 << 8), sample_rate_buffer, 4);
1007        if (err < 0)
1008                return err;
1009
1010        return err;
1011}
1012