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
19 MODULE_DESCRIPTION("Echo Fireworks driver");
20 MODULE_AUTHOR("Takashi Sakamoto <o-takashi@sakamocchi.jp>");
21 MODULE_LICENSE("GPL v2");
22
23 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX;
24 static char *id[SNDRV_CARDS] = SNDRV_DEFAULT_STR;
25 static bool enable[SNDRV_CARDS] = SNDRV_DEFAULT_ENABLE_PNP;
26 unsigned int snd_efw_resp_buf_size = 1024;
27 bool snd_efw_resp_buf_debug = false;
28
29 module_param_array(index, int, NULL, 0444);
30 MODULE_PARM_DESC(index, "card index");
31 module_param_array(id, charp, NULL, 0444);
32 MODULE_PARM_DESC(id, "ID string");
33 module_param_array(enable, bool, NULL, 0444);
34 MODULE_PARM_DESC(enable, "enable Fireworks sound card");
35 module_param_named(resp_buf_size, snd_efw_resp_buf_size, uint, 0444);
36 MODULE_PARM_DESC(resp_buf_size,
37 "response buffer size (max 4096, default 1024)");
38 module_param_named(resp_buf_debug, snd_efw_resp_buf_debug, bool, 0444);
39 MODULE_PARM_DESC(resp_buf_debug, "store all responses to buffer");
40
41 static DEFINE_MUTEX(devices_mutex);
42 static 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
71 static int
get_hardware_info(struct snd_efw * efw)72 get_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;
181 end:
182 kfree(hwinfo);
183 return err;
184 }
185
186 static void
efw_card_free(struct snd_card * card)187 efw_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
199 static void
do_registration(struct work_struct * work)200 do_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;
275 error:
276 snd_card_free(efw->card);
277 dev_info(&efw->unit->device,
278 "Sound card registration failed: %d\n", err);
279 }
280
281 static int
efw_probe(struct fw_unit * unit,const struct ieee1394_device_id * entry)282 efw_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
efw_update(struct fw_unit * unit)303 static 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
efw_remove(struct fw_unit * unit)324 static 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
344 static 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 };
360 MODULE_DEVICE_TABLE(ieee1394, efw_id_table);
361
362 static 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
snd_efw_init(void)374 static 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
386 end:
387 return err;
388 }
389
snd_efw_exit(void)390 static void __exit snd_efw_exit(void)
391 {
392 snd_efw_transaction_unregister();
393 driver_unregister(&efw_driver.driver);
394 }
395
396 module_init(snd_efw_init);
397 module_exit(snd_efw_exit);
398