2 * oxfw_stream.c - a part of driver for OXFW970/971 based devices
4 * Copyright (c) 2014 Takashi Sakamoto
6 * Licensed under the terms of the GNU General Public License, version 2.
10 #include <linux/delay.h>
12 #define AVC_GENERIC_FRAME_MAXIMUM_BYTES 512
13 #define CALLBACK_TIMEOUT 200
16 * According to datasheet of Oxford Semiconductor:
17 * OXFW970: 32.0/44.1/48.0/96.0 Khz, 8 audio channels I/O
18 * OXFW971: 32.0/44.1/48.0/88.2/96.0/192.0 kHz, 16 audio channels I/O, MIDI I/O
20 static const unsigned int oxfw_rate_table[] = {
30 * See Table 5.7 – Sampling frequency for Multi-bit Audio
31 * in AV/C Stream Format Information Specification 1.1 (Apr 2005, 1394TA)
33 static const unsigned int avc_stream_rate_table[] = {
42 static int set_rate(struct snd_oxfw *oxfw, unsigned int rate)
46 err = avc_general_set_sig_fmt(oxfw->unit, rate,
47 AVC_GENERAL_PLUG_DIR_IN, 0);
52 err = avc_general_set_sig_fmt(oxfw->unit, rate,
53 AVC_GENERAL_PLUG_DIR_OUT, 0);
58 static int set_stream_format(struct snd_oxfw *oxfw, struct amdtp_stream *s,
59 unsigned int rate, unsigned int pcm_channels)
62 struct snd_oxfw_stream_formation formation;
63 enum avc_general_plug_dir dir;
67 if (s == &oxfw->tx_stream) {
68 formats = oxfw->tx_stream_formats;
69 dir = AVC_GENERAL_PLUG_DIR_OUT;
71 formats = oxfw->rx_stream_formats;
72 dir = AVC_GENERAL_PLUG_DIR_IN;
75 /* Seek stream format for requirements. */
76 for (i = 0; i < SND_OXFW_STREAM_FORMAT_ENTRIES; i++) {
77 err = snd_oxfw_stream_parse_format(formats[i], &formation);
81 if ((formation.rate == rate) && (formation.pcm == pcm_channels))
84 if (i == SND_OXFW_STREAM_FORMAT_ENTRIES)
87 /* If assumed, just change rate. */
89 return set_rate(oxfw, rate);
91 /* Calculate format length. */
92 len = 5 + formats[i][4] * 2;
94 err = avc_stream_set_format(oxfw->unit, dir, 0, formats[i], len);
98 /* Some requests just after changing format causes freezing. */
104 static void stop_stream(struct snd_oxfw *oxfw, struct amdtp_stream *stream)
106 amdtp_stream_pcm_abort(stream);
107 amdtp_stream_stop(stream);
109 if (stream == &oxfw->tx_stream)
110 cmp_connection_break(&oxfw->out_conn);
112 cmp_connection_break(&oxfw->in_conn);
115 static int start_stream(struct snd_oxfw *oxfw, struct amdtp_stream *stream,
116 unsigned int rate, unsigned int pcm_channels)
119 struct cmp_connection *conn;
120 struct snd_oxfw_stream_formation formation;
121 unsigned int i, midi_ports;
124 if (stream == &oxfw->rx_stream) {
125 formats = oxfw->rx_stream_formats;
126 conn = &oxfw->in_conn;
128 formats = oxfw->tx_stream_formats;
129 conn = &oxfw->out_conn;
132 /* Get stream format */
133 for (i = 0; i < SND_OXFW_STREAM_FORMAT_ENTRIES; i++) {
134 if (formats[i] == NULL)
137 err = snd_oxfw_stream_parse_format(formats[i], &formation);
140 if (rate != formation.rate)
142 if (pcm_channels == 0 || pcm_channels == formation.pcm)
145 if (i == SND_OXFW_STREAM_FORMAT_ENTRIES) {
150 pcm_channels = formation.pcm;
151 midi_ports = formation.midi * 8;
153 /* The stream should have one pcm channels at least */
154 if (pcm_channels == 0) {
158 err = amdtp_am824_set_parameters(stream, rate, pcm_channels, midi_ports,
163 err = cmp_connection_establish(conn,
164 amdtp_stream_get_max_payload(stream));
168 err = amdtp_stream_start(stream,
169 conn->resources.channel,
172 cmp_connection_break(conn);
176 /* Wait first packet */
177 if (!amdtp_stream_wait_callback(stream, CALLBACK_TIMEOUT)) {
178 stop_stream(oxfw, stream);
185 static int check_connection_used_by_others(struct snd_oxfw *oxfw,
186 struct amdtp_stream *stream)
188 struct cmp_connection *conn;
192 if (stream == &oxfw->tx_stream)
193 conn = &oxfw->out_conn;
195 conn = &oxfw->in_conn;
197 err = cmp_connection_check_used(conn, &used);
198 if ((err >= 0) && used && !amdtp_stream_running(stream)) {
199 dev_err(&oxfw->unit->device,
200 "Connection established by others: %cPCR[%d]\n",
201 (conn->direction == CMP_OUTPUT) ? 'o' : 'i',
209 int snd_oxfw_stream_init_simplex(struct snd_oxfw *oxfw,
210 struct amdtp_stream *stream)
212 struct cmp_connection *conn;
213 enum cmp_direction c_dir;
214 enum amdtp_stream_direction s_dir;
217 if (stream == &oxfw->tx_stream) {
218 conn = &oxfw->out_conn;
220 s_dir = AMDTP_IN_STREAM;
222 conn = &oxfw->in_conn;
224 s_dir = AMDTP_OUT_STREAM;
227 err = cmp_connection_init(conn, oxfw->unit, c_dir, 0);
231 err = amdtp_am824_init(stream, oxfw->unit, s_dir, CIP_NONBLOCKING);
233 amdtp_stream_destroy(stream);
234 cmp_connection_destroy(conn);
239 * OXFW starts to transmit packets with non-zero dbc.
240 * OXFW postpone transferring packets till handling any asynchronous
241 * packets. As a result, next isochronous packet includes more data
242 * blocks than IEC 61883-6 defines.
244 if (stream == &oxfw->tx_stream) {
245 oxfw->tx_stream.flags |= CIP_JUMBO_PAYLOAD;
247 oxfw->tx_stream.flags |= CIP_WRONG_DBS;
253 int snd_oxfw_stream_start_simplex(struct snd_oxfw *oxfw,
254 struct amdtp_stream *stream,
255 unsigned int rate, unsigned int pcm_channels)
257 struct amdtp_stream *opposite;
258 struct snd_oxfw_stream_formation formation;
259 enum avc_general_plug_dir dir;
260 unsigned int substreams, opposite_substreams;
263 if (stream == &oxfw->tx_stream) {
264 substreams = oxfw->capture_substreams;
265 opposite = &oxfw->rx_stream;
266 opposite_substreams = oxfw->playback_substreams;
267 dir = AVC_GENERAL_PLUG_DIR_OUT;
269 substreams = oxfw->playback_substreams;
270 opposite_substreams = oxfw->capture_substreams;
272 if (oxfw->has_output)
273 opposite = &oxfw->rx_stream;
277 dir = AVC_GENERAL_PLUG_DIR_IN;
284 * Considering JACK/FFADO streaming:
285 * TODO: This can be removed hwdep functionality becomes popular.
287 err = check_connection_used_by_others(oxfw, stream);
291 /* packet queueing error */
292 if (amdtp_streaming_error(stream))
293 stop_stream(oxfw, stream);
295 err = snd_oxfw_stream_get_current_formation(oxfw, dir, &formation);
299 rate = formation.rate;
300 if (pcm_channels == 0)
301 pcm_channels = formation.pcm;
303 if ((formation.rate != rate) || (formation.pcm != pcm_channels)) {
304 if (opposite != NULL) {
305 err = check_connection_used_by_others(oxfw, opposite);
308 stop_stream(oxfw, opposite);
310 stop_stream(oxfw, stream);
312 err = set_stream_format(oxfw, stream, rate, pcm_channels);
314 dev_err(&oxfw->unit->device,
315 "fail to set stream format: %d\n", err);
319 /* Start opposite stream if needed. */
320 if (opposite && !amdtp_stream_running(opposite) &&
321 (opposite_substreams > 0)) {
322 err = start_stream(oxfw, opposite, rate, 0);
324 dev_err(&oxfw->unit->device,
325 "fail to restart stream: %d\n", err);
331 /* Start requested stream. */
332 if (!amdtp_stream_running(stream)) {
333 err = start_stream(oxfw, stream, rate, pcm_channels);
335 dev_err(&oxfw->unit->device,
336 "fail to start stream: %d\n", err);
342 void snd_oxfw_stream_stop_simplex(struct snd_oxfw *oxfw,
343 struct amdtp_stream *stream)
345 if (((stream == &oxfw->tx_stream) && (oxfw->capture_substreams > 0)) ||
346 ((stream == &oxfw->rx_stream) && (oxfw->playback_substreams > 0)))
349 stop_stream(oxfw, stream);
353 * This function should be called before starting the stream or after stopping
356 void snd_oxfw_stream_destroy_simplex(struct snd_oxfw *oxfw,
357 struct amdtp_stream *stream)
359 struct cmp_connection *conn;
361 if (stream == &oxfw->tx_stream)
362 conn = &oxfw->out_conn;
364 conn = &oxfw->in_conn;
366 amdtp_stream_destroy(stream);
367 cmp_connection_destroy(conn);
370 void snd_oxfw_stream_update_simplex(struct snd_oxfw *oxfw,
371 struct amdtp_stream *stream)
373 struct cmp_connection *conn;
375 if (stream == &oxfw->tx_stream)
376 conn = &oxfw->out_conn;
378 conn = &oxfw->in_conn;
380 if (cmp_connection_update(conn) < 0)
381 stop_stream(oxfw, stream);
383 amdtp_stream_update(stream);
386 int snd_oxfw_stream_get_current_formation(struct snd_oxfw *oxfw,
387 enum avc_general_plug_dir dir,
388 struct snd_oxfw_stream_formation *formation)
394 len = AVC_GENERIC_FRAME_MAXIMUM_BYTES;
395 format = kmalloc(len, GFP_KERNEL);
399 err = avc_stream_get_format_single(oxfw->unit, dir, 0, format, &len);
407 err = snd_oxfw_stream_parse_format(format, formation);
414 * See Table 6.16 - AM824 Stream Format
415 * Figure 6.19 - format_information field for AM824 Compound
416 * in AV/C Stream Format Information Specification 1.1 (Apr 2005, 1394TA)
417 * Also 'Clause 12 AM824 sequence adaption layers' in IEC 61883-6:2005
419 int snd_oxfw_stream_parse_format(u8 *format,
420 struct snd_oxfw_stream_formation *formation)
422 unsigned int i, e, channels, type;
424 memset(formation, 0, sizeof(struct snd_oxfw_stream_formation));
427 * this module can support a hierarchy combination that:
428 * Root: Audio and Music (0x90)
429 * Level 1: AM824 Compound (0x40)
431 if ((format[0] != 0x90) || (format[1] != 0x40))
434 /* check the sampling rate */
435 for (i = 0; i < ARRAY_SIZE(avc_stream_rate_table); i++) {
436 if (format[2] == avc_stream_rate_table[i])
439 if (i == ARRAY_SIZE(avc_stream_rate_table))
442 formation->rate = oxfw_rate_table[i];
444 for (e = 0; e < format[4]; e++) {
445 channels = format[5 + e * 2];
446 type = format[6 + e * 2];
449 /* IEC 60958 Conformant, currently handled as MBLA */
451 /* Multi Bit Linear Audio (Raw) */
453 formation->pcm += channels;
455 /* MIDI Conformant */
457 formation->midi = channels;
459 /* IEC 61937-3 to 7 */
465 /* Multi Bit Linear Audio */
466 case 0x07: /* DVD-Audio */
467 case 0x0c: /* High Precision */
469 case 0x08: /* (Plain) Raw */
470 case 0x09: /* (Plain) SACD */
471 case 0x0a: /* (Encoded) Raw */
472 case 0x0b: /* (Encoded) SACD */
473 /* SMPTE Time-Code conformant */
479 /* Synchronization Stream (Stereo Raw audio) */
484 return -ENOSYS; /* not supported */
488 if (formation->pcm > AM824_MAX_CHANNELS_FOR_PCM ||
489 formation->midi > AM824_MAX_CHANNELS_FOR_MIDI)
496 assume_stream_formats(struct snd_oxfw *oxfw, enum avc_general_plug_dir dir,
497 unsigned int pid, u8 *buf, unsigned int *len,
500 struct snd_oxfw_stream_formation formation;
504 /* get format at current sampling rate */
505 err = avc_stream_get_format_single(oxfw->unit, dir, pid, buf, len);
507 dev_err(&oxfw->unit->device,
508 "fail to get current stream format for isoc %s plug %d:%d\n",
509 (dir == AVC_GENERAL_PLUG_DIR_IN) ? "in" : "out",
514 /* parse and set stream format */
516 err = snd_oxfw_stream_parse_format(buf, &formation);
520 formats[eid] = kmemdup(buf, *len, GFP_KERNEL);
521 if (formats[eid] == NULL) {
526 /* apply the format for each available sampling rate */
527 for (i = 0; i < ARRAY_SIZE(oxfw_rate_table); i++) {
528 if (formation.rate == oxfw_rate_table[i])
531 err = avc_general_inquiry_sig_fmt(oxfw->unit,
538 formats[eid] = kmemdup(buf, *len, GFP_KERNEL);
539 if (formats[eid] == NULL) {
543 formats[eid][2] = avc_stream_rate_table[i];
547 oxfw->assumed = true;
552 static int fill_stream_formats(struct snd_oxfw *oxfw,
553 enum avc_general_plug_dir dir,
557 unsigned int len, eid = 0;
558 struct snd_oxfw_stream_formation dummy;
561 buf = kmalloc(AVC_GENERIC_FRAME_MAXIMUM_BYTES, GFP_KERNEL);
565 if (dir == AVC_GENERAL_PLUG_DIR_OUT)
566 formats = oxfw->tx_stream_formats;
568 formats = oxfw->rx_stream_formats;
570 /* get first entry */
571 len = AVC_GENERIC_FRAME_MAXIMUM_BYTES;
572 err = avc_stream_get_format_list(oxfw->unit, dir, 0, buf, &len, 0);
573 if (err == -ENOSYS) {
574 /* LIST subfunction is not implemented */
575 len = AVC_GENERIC_FRAME_MAXIMUM_BYTES;
576 err = assume_stream_formats(oxfw, dir, pid, buf, &len,
579 } else if (err < 0) {
580 dev_err(&oxfw->unit->device,
581 "fail to get stream format %d for isoc %s plug %d:%d\n",
582 eid, (dir == AVC_GENERAL_PLUG_DIR_IN) ? "in" : "out",
587 /* LIST subfunction is implemented */
588 while (eid < SND_OXFW_STREAM_FORMAT_ENTRIES) {
589 /* The format is too short. */
595 /* parse and set stream format */
596 err = snd_oxfw_stream_parse_format(buf, &dummy);
600 formats[eid] = kmemdup(buf, len, GFP_KERNEL);
601 if (formats[eid] == NULL) {
607 len = AVC_GENERIC_FRAME_MAXIMUM_BYTES;
608 err = avc_stream_get_format_list(oxfw->unit, dir, 0,
610 /* No entries remained. */
611 if (err == -EINVAL) {
614 } else if (err < 0) {
615 dev_err(&oxfw->unit->device,
616 "fail to get stream format %d for isoc %s plug %d:%d\n",
617 eid, (dir == AVC_GENERAL_PLUG_DIR_IN) ? "in" :
628 int snd_oxfw_stream_discover(struct snd_oxfw *oxfw)
630 u8 plugs[AVC_PLUG_INFO_BUF_BYTES];
631 struct snd_oxfw_stream_formation formation;
636 /* the number of plugs for isoc in/out, ext in/out */
637 err = avc_general_get_plug_info(oxfw->unit, 0x1f, 0x07, 0x00, plugs);
639 dev_err(&oxfw->unit->device,
640 "fail to get info for isoc/external in/out plugs: %d\n",
643 } else if ((plugs[0] == 0) && (plugs[1] == 0)) {
648 /* use oPCR[0] if exists */
650 err = fill_stream_formats(oxfw, AVC_GENERAL_PLUG_DIR_OUT, 0);
654 for (i = 0; i < SND_OXFW_STREAM_FORMAT_ENTRIES; i++) {
655 format = oxfw->tx_stream_formats[i];
658 err = snd_oxfw_stream_parse_format(format, &formation);
662 /* Add one MIDI port. */
663 if (formation.midi > 0)
664 oxfw->midi_input_ports = 1;
667 oxfw->has_output = true;
670 /* use iPCR[0] if exists */
672 err = fill_stream_formats(oxfw, AVC_GENERAL_PLUG_DIR_IN, 0);
676 for (i = 0; i < SND_OXFW_STREAM_FORMAT_ENTRIES; i++) {
677 format = oxfw->rx_stream_formats[i];
680 err = snd_oxfw_stream_parse_format(format, &formation);
684 /* Add one MIDI port. */
685 if (formation.midi > 0)
686 oxfw->midi_output_ports = 1;
693 void snd_oxfw_stream_lock_changed(struct snd_oxfw *oxfw)
695 oxfw->dev_lock_changed = true;
696 wake_up(&oxfw->hwdep_wait);
699 int snd_oxfw_stream_lock_try(struct snd_oxfw *oxfw)
703 spin_lock_irq(&oxfw->lock);
705 /* user land lock this */
706 if (oxfw->dev_lock_count < 0) {
711 /* this is the first time */
712 if (oxfw->dev_lock_count++ == 0)
713 snd_oxfw_stream_lock_changed(oxfw);
716 spin_unlock_irq(&oxfw->lock);
720 void snd_oxfw_stream_lock_release(struct snd_oxfw *oxfw)
722 spin_lock_irq(&oxfw->lock);
724 if (WARN_ON(oxfw->dev_lock_count <= 0))
726 if (--oxfw->dev_lock_count == 0)
727 snd_oxfw_stream_lock_changed(oxfw);
729 spin_unlock_irq(&oxfw->lock);