linux/sound/firewire/fireworks/fireworks.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0-only
   2/*
   3 * fireworks.c - a part of driver for Fireworks based devices
   4 *
   5 * Copyright (c) 2009-2010 Clemens Ladisch
   6 * Copyright (c) 2013-2014 Takashi Sakamoto
   7 */
   8
   9/*
  10 * Fireworks is a board module which Echo Audio produced. This module consists
  11 * of three chipsets:
  12 *  - Communication chipset for IEEE1394 PHY/Link and IEC 61883-1/6
  13 *  - DSP or/and FPGA for signal processing
  14 *  - Flash Memory to store firmwares
  15 */
  16
  17#include "fireworks.h"
  18
  19MODULE_DESCRIPTION("Echo Fireworks driver");
  20MODULE_AUTHOR("Takashi Sakamoto <o-takashi@sakamocchi.jp>");
  21MODULE_LICENSE("GPL v2");
  22
  23static int index[SNDRV_CARDS]   = SNDRV_DEFAULT_IDX;
  24static char *id[SNDRV_CARDS]    = SNDRV_DEFAULT_STR;
  25static bool enable[SNDRV_CARDS] = SNDRV_DEFAULT_ENABLE_PNP;
  26unsigned int snd_efw_resp_buf_size      = 1024;
  27bool snd_efw_resp_buf_debug             = false;
  28
  29module_param_array(index, int, NULL, 0444);
  30MODULE_PARM_DESC(index, "card index");
  31module_param_array(id, charp, NULL, 0444);
  32MODULE_PARM_DESC(id, "ID string");
  33module_param_array(enable, bool, NULL, 0444);
  34MODULE_PARM_DESC(enable, "enable Fireworks sound card");
  35module_param_named(resp_buf_size, snd_efw_resp_buf_size, uint, 0444);
  36MODULE_PARM_DESC(resp_buf_size,
  37                 "response buffer size (max 4096, default 1024)");
  38module_param_named(resp_buf_debug, snd_efw_resp_buf_debug, bool, 0444);
  39MODULE_PARM_DESC(resp_buf_debug, "store all responses to buffer");
  40
  41static DEFINE_MUTEX(devices_mutex);
  42static DECLARE_BITMAP(devices_used, SNDRV_CARDS);
  43
  44#define VENDOR_LOUD                     0x000ff2
  45#define  MODEL_MACKIE_400F              0x00400f
  46#define  MODEL_MACKIE_1200F             0x01200f
  47
  48#define VENDOR_ECHO                     0x001486
  49#define  MODEL_ECHO_AUDIOFIRE_12        0x00af12
  50#define  MODEL_ECHO_AUDIOFIRE_12HD      0x0af12d
  51#define  MODEL_ECHO_AUDIOFIRE_12_APPLE  0x0af12a
  52/* This is applied for AudioFire8 (until 2009 July) */
  53#define  MODEL_ECHO_AUDIOFIRE_8         0x000af8
  54#define  MODEL_ECHO_AUDIOFIRE_2         0x000af2
  55#define  MODEL_ECHO_AUDIOFIRE_4         0x000af4
  56/* AudioFire9 is applied for AudioFire8(since 2009 July) and AudioFirePre8 */
  57#define  MODEL_ECHO_AUDIOFIRE_9         0x000af9
  58/* unknown as product */
  59#define  MODEL_ECHO_FIREWORKS_8         0x0000f8
  60#define  MODEL_ECHO_FIREWORKS_HDMI      0x00afd1
  61
  62#define VENDOR_GIBSON                   0x00075b
  63/* for Robot Interface Pack of Dark Fire, Dusk Tiger, Les Paul Standard 2010 */
  64#define  MODEL_GIBSON_RIP               0x00afb2
  65/* unknown as product */
  66#define  MODEL_GIBSON_GOLDTOP           0x00afb9
  67
  68/* part of hardware capability flags */
  69#define FLAG_RESP_ADDR_CHANGABLE        0
  70
  71static int
  72get_hardware_info(struct snd_efw *efw)
  73{
  74        struct fw_device *fw_dev = fw_parent_device(efw->unit);
  75        struct snd_efw_hwinfo *hwinfo;
  76        char version[12] = {0};
  77        int err;
  78
  79        hwinfo = kzalloc(sizeof(struct snd_efw_hwinfo), GFP_KERNEL);
  80        if (hwinfo == NULL)
  81                return -ENOMEM;
  82
  83        err = snd_efw_command_get_hwinfo(efw, hwinfo);
  84        if (err < 0)
  85                goto end;
  86
  87        /* firmware version for communication chipset */
  88        snprintf(version, sizeof(version), "%u.%u",
  89                 (hwinfo->arm_version >> 24) & 0xff,
  90                 (hwinfo->arm_version >> 16) & 0xff);
  91        efw->firmware_version = hwinfo->arm_version;
  92
  93        strcpy(efw->card->driver, "Fireworks");
  94        strcpy(efw->card->shortname, hwinfo->model_name);
  95        strcpy(efw->card->mixername, hwinfo->model_name);
  96        snprintf(efw->card->longname, sizeof(efw->card->longname),
  97                 "%s %s v%s, GUID %08x%08x at %s, S%d",
  98                 hwinfo->vendor_name, hwinfo->model_name, version,
  99                 hwinfo->guid_hi, hwinfo->guid_lo,
 100                 dev_name(&efw->unit->device), 100 << fw_dev->max_speed);
 101
 102        if (hwinfo->flags & BIT(FLAG_RESP_ADDR_CHANGABLE))
 103                efw->resp_addr_changable = true;
 104
 105        efw->supported_sampling_rate = 0;
 106        if ((hwinfo->min_sample_rate <= 22050)
 107         && (22050 <= hwinfo->max_sample_rate))
 108                efw->supported_sampling_rate |= SNDRV_PCM_RATE_22050;
 109        if ((hwinfo->min_sample_rate <= 32000)
 110         && (32000 <= hwinfo->max_sample_rate))
 111                efw->supported_sampling_rate |= SNDRV_PCM_RATE_32000;
 112        if ((hwinfo->min_sample_rate <= 44100)
 113         && (44100 <= hwinfo->max_sample_rate))
 114                efw->supported_sampling_rate |= SNDRV_PCM_RATE_44100;
 115        if ((hwinfo->min_sample_rate <= 48000)
 116         && (48000 <= hwinfo->max_sample_rate))
 117                efw->supported_sampling_rate |= SNDRV_PCM_RATE_48000;
 118        if ((hwinfo->min_sample_rate <= 88200)
 119         && (88200 <= hwinfo->max_sample_rate))
 120                efw->supported_sampling_rate |= SNDRV_PCM_RATE_88200;
 121        if ((hwinfo->min_sample_rate <= 96000)
 122         && (96000 <= hwinfo->max_sample_rate))
 123                efw->supported_sampling_rate |= SNDRV_PCM_RATE_96000;
 124        if ((hwinfo->min_sample_rate <= 176400)
 125         && (176400 <= hwinfo->max_sample_rate))
 126                efw->supported_sampling_rate |= SNDRV_PCM_RATE_176400;
 127        if ((hwinfo->min_sample_rate <= 192000)
 128         && (192000 <= hwinfo->max_sample_rate))
 129                efw->supported_sampling_rate |= SNDRV_PCM_RATE_192000;
 130
 131        /* the number of MIDI ports, not of MIDI conformant data channels */
 132        if (hwinfo->midi_out_ports > SND_EFW_MAX_MIDI_OUT_PORTS ||
 133            hwinfo->midi_in_ports > SND_EFW_MAX_MIDI_IN_PORTS) {
 134                err = -EIO;
 135                goto end;
 136        }
 137        efw->midi_out_ports = hwinfo->midi_out_ports;
 138        efw->midi_in_ports = hwinfo->midi_in_ports;
 139
 140        if (hwinfo->amdtp_tx_pcm_channels    > AM824_MAX_CHANNELS_FOR_PCM ||
 141            hwinfo->amdtp_tx_pcm_channels_2x > AM824_MAX_CHANNELS_FOR_PCM ||
 142            hwinfo->amdtp_tx_pcm_channels_4x > AM824_MAX_CHANNELS_FOR_PCM ||
 143            hwinfo->amdtp_rx_pcm_channels    > AM824_MAX_CHANNELS_FOR_PCM ||
 144            hwinfo->amdtp_rx_pcm_channels_2x > AM824_MAX_CHANNELS_FOR_PCM ||
 145            hwinfo->amdtp_rx_pcm_channels_4x > AM824_MAX_CHANNELS_FOR_PCM) {
 146                err = -ENOSYS;
 147                goto end;
 148        }
 149        efw->pcm_capture_channels[0] = hwinfo->amdtp_tx_pcm_channels;
 150        efw->pcm_capture_channels[1] = hwinfo->amdtp_tx_pcm_channels_2x;
 151        efw->pcm_capture_channels[2] = hwinfo->amdtp_tx_pcm_channels_4x;
 152        efw->pcm_playback_channels[0] = hwinfo->amdtp_rx_pcm_channels;
 153        efw->pcm_playback_channels[1] = hwinfo->amdtp_rx_pcm_channels_2x;
 154        efw->pcm_playback_channels[2] = hwinfo->amdtp_rx_pcm_channels_4x;
 155
 156        /* Hardware metering. */
 157        if (hwinfo->phys_in_grp_count  > HWINFO_MAX_CAPS_GROUPS ||
 158            hwinfo->phys_out_grp_count > HWINFO_MAX_CAPS_GROUPS) {
 159                err = -EIO;
 160                goto end;
 161        }
 162        efw->phys_in = hwinfo->phys_in;
 163        efw->phys_out = hwinfo->phys_out;
 164        efw->phys_in_grp_count = hwinfo->phys_in_grp_count;
 165        efw->phys_out_grp_count = hwinfo->phys_out_grp_count;
 166        memcpy(&efw->phys_in_grps, hwinfo->phys_in_grps,
 167               sizeof(struct snd_efw_phys_grp) * hwinfo->phys_in_grp_count);
 168        memcpy(&efw->phys_out_grps, hwinfo->phys_out_grps,
 169               sizeof(struct snd_efw_phys_grp) * hwinfo->phys_out_grp_count);
 170
 171        /* AudioFire8 (since 2009) and AudioFirePre8 */
 172        if (hwinfo->type == MODEL_ECHO_AUDIOFIRE_9)
 173                efw->is_af9 = true;
 174        /* These models uses the same firmware. */
 175        if (hwinfo->type == MODEL_ECHO_AUDIOFIRE_2 ||
 176            hwinfo->type == MODEL_ECHO_AUDIOFIRE_4 ||
 177            hwinfo->type == MODEL_ECHO_AUDIOFIRE_9 ||
 178            hwinfo->type == MODEL_GIBSON_RIP ||
 179            hwinfo->type == MODEL_GIBSON_GOLDTOP)
 180                efw->is_fireworks3 = true;
 181end:
 182        kfree(hwinfo);
 183        return err;
 184}
 185
 186static void
 187efw_card_free(struct snd_card *card)
 188{
 189        struct snd_efw *efw = card->private_data;
 190
 191        mutex_lock(&devices_mutex);
 192        clear_bit(efw->card_index, devices_used);
 193        mutex_unlock(&devices_mutex);
 194
 195        snd_efw_stream_destroy_duplex(efw);
 196        snd_efw_transaction_remove_instance(efw);
 197}
 198
 199static void
 200do_registration(struct work_struct *work)
 201{
 202        struct snd_efw *efw = container_of(work, struct snd_efw, dwork.work);
 203        unsigned int card_index;
 204        int err;
 205
 206        if (efw->registered)
 207                return;
 208
 209        /* check registered cards */
 210        mutex_lock(&devices_mutex);
 211        for (card_index = 0; card_index < SNDRV_CARDS; ++card_index) {
 212                if (!test_bit(card_index, devices_used) && enable[card_index])
 213                        break;
 214        }
 215        if (card_index >= SNDRV_CARDS) {
 216                mutex_unlock(&devices_mutex);
 217                return;
 218        }
 219
 220        err = snd_card_new(&efw->unit->device, index[card_index],
 221                           id[card_index], THIS_MODULE, 0, &efw->card);
 222        if (err < 0) {
 223                mutex_unlock(&devices_mutex);
 224                return;
 225        }
 226        set_bit(card_index, devices_used);
 227        mutex_unlock(&devices_mutex);
 228
 229        efw->card->private_free = efw_card_free;
 230        efw->card->private_data = efw;
 231
 232        /* prepare response buffer */
 233        snd_efw_resp_buf_size = clamp(snd_efw_resp_buf_size,
 234                                      SND_EFW_RESPONSE_MAXIMUM_BYTES, 4096U);
 235        efw->resp_buf = devm_kzalloc(&efw->card->card_dev,
 236                                     snd_efw_resp_buf_size, GFP_KERNEL);
 237        if (!efw->resp_buf) {
 238                err = -ENOMEM;
 239                goto error;
 240        }
 241        efw->pull_ptr = efw->push_ptr = efw->resp_buf;
 242        snd_efw_transaction_add_instance(efw);
 243
 244        err = get_hardware_info(efw);
 245        if (err < 0)
 246                goto error;
 247
 248        err = snd_efw_stream_init_duplex(efw);
 249        if (err < 0)
 250                goto error;
 251
 252        snd_efw_proc_init(efw);
 253
 254        if (efw->midi_out_ports || efw->midi_in_ports) {
 255                err = snd_efw_create_midi_devices(efw);
 256                if (err < 0)
 257                        goto error;
 258        }
 259
 260        err = snd_efw_create_pcm_devices(efw);
 261        if (err < 0)
 262                goto error;
 263
 264        err = snd_efw_create_hwdep_device(efw);
 265        if (err < 0)
 266                goto error;
 267
 268        err = snd_card_register(efw->card);
 269        if (err < 0)
 270                goto error;
 271
 272        efw->registered = true;
 273
 274        return;
 275error:
 276        snd_card_free(efw->card);
 277        dev_info(&efw->unit->device,
 278                 "Sound card registration failed: %d\n", err);
 279}
 280
 281static int
 282efw_probe(struct fw_unit *unit, const struct ieee1394_device_id *entry)
 283{
 284        struct snd_efw *efw;
 285
 286        efw = devm_kzalloc(&unit->device, sizeof(struct snd_efw), GFP_KERNEL);
 287        if (efw == NULL)
 288                return -ENOMEM;
 289        efw->unit = fw_unit_get(unit);
 290        dev_set_drvdata(&unit->device, efw);
 291
 292        mutex_init(&efw->mutex);
 293        spin_lock_init(&efw->lock);
 294        init_waitqueue_head(&efw->hwdep_wait);
 295
 296        /* Allocate and register this sound card later. */
 297        INIT_DEFERRABLE_WORK(&efw->dwork, do_registration);
 298        snd_fw_schedule_registration(unit, &efw->dwork);
 299
 300        return 0;
 301}
 302
 303static void efw_update(struct fw_unit *unit)
 304{
 305        struct snd_efw *efw = dev_get_drvdata(&unit->device);
 306
 307        /* Postpone a workqueue for deferred registration. */
 308        if (!efw->registered)
 309                snd_fw_schedule_registration(unit, &efw->dwork);
 310
 311        snd_efw_transaction_bus_reset(efw->unit);
 312
 313        /*
 314         * After registration, userspace can start packet streaming, then this
 315         * code block works fine.
 316         */
 317        if (efw->registered) {
 318                mutex_lock(&efw->mutex);
 319                snd_efw_stream_update_duplex(efw);
 320                mutex_unlock(&efw->mutex);
 321        }
 322}
 323
 324static void efw_remove(struct fw_unit *unit)
 325{
 326        struct snd_efw *efw = dev_get_drvdata(&unit->device);
 327
 328        /*
 329         * Confirm to stop the work for registration before the sound card is
 330         * going to be released. The work is not scheduled again because bus
 331         * reset handler is not called anymore.
 332         */
 333        cancel_delayed_work_sync(&efw->dwork);
 334
 335        if (efw->registered) {
 336                // Block till all of ALSA character devices are released.
 337                snd_card_free(efw->card);
 338        }
 339
 340        mutex_destroy(&efw->mutex);
 341        fw_unit_put(efw->unit);
 342}
 343
 344static const struct ieee1394_device_id efw_id_table[] = {
 345        SND_EFW_DEV_ENTRY(VENDOR_LOUD, MODEL_MACKIE_400F),
 346        SND_EFW_DEV_ENTRY(VENDOR_LOUD, MODEL_MACKIE_1200F),
 347        SND_EFW_DEV_ENTRY(VENDOR_ECHO, MODEL_ECHO_AUDIOFIRE_8),
 348        SND_EFW_DEV_ENTRY(VENDOR_ECHO, MODEL_ECHO_AUDIOFIRE_12),
 349        SND_EFW_DEV_ENTRY(VENDOR_ECHO, MODEL_ECHO_AUDIOFIRE_12HD),
 350        SND_EFW_DEV_ENTRY(VENDOR_ECHO, MODEL_ECHO_AUDIOFIRE_12_APPLE),
 351        SND_EFW_DEV_ENTRY(VENDOR_ECHO, MODEL_ECHO_AUDIOFIRE_2),
 352        SND_EFW_DEV_ENTRY(VENDOR_ECHO, MODEL_ECHO_AUDIOFIRE_4),
 353        SND_EFW_DEV_ENTRY(VENDOR_ECHO, MODEL_ECHO_AUDIOFIRE_9),
 354        SND_EFW_DEV_ENTRY(VENDOR_ECHO, MODEL_ECHO_FIREWORKS_8),
 355        SND_EFW_DEV_ENTRY(VENDOR_ECHO, MODEL_ECHO_FIREWORKS_HDMI),
 356        SND_EFW_DEV_ENTRY(VENDOR_GIBSON, MODEL_GIBSON_RIP),
 357        SND_EFW_DEV_ENTRY(VENDOR_GIBSON, MODEL_GIBSON_GOLDTOP),
 358        {}
 359};
 360MODULE_DEVICE_TABLE(ieee1394, efw_id_table);
 361
 362static struct fw_driver efw_driver = {
 363        .driver = {
 364                .owner = THIS_MODULE,
 365                .name = "snd-fireworks",
 366                .bus = &fw_bus_type,
 367        },
 368        .probe    = efw_probe,
 369        .update   = efw_update,
 370        .remove   = efw_remove,
 371        .id_table = efw_id_table,
 372};
 373
 374static int __init snd_efw_init(void)
 375{
 376        int err;
 377
 378        err = snd_efw_transaction_register();
 379        if (err < 0)
 380                goto end;
 381
 382        err = driver_register(&efw_driver.driver);
 383        if (err < 0)
 384                snd_efw_transaction_unregister();
 385
 386end:
 387        return err;
 388}
 389
 390static void __exit snd_efw_exit(void)
 391{
 392        snd_efw_transaction_unregister();
 393        driver_unregister(&efw_driver.driver);
 394}
 395
 396module_init(snd_efw_init);
 397module_exit(snd_efw_exit);
 398