1 /* SPDX-License-Identifier: GPL-2.0-only */ 1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /* 2 /*
3 * oxfw.h - a part of driver for OXFW970/971 b 3 * oxfw.h - a part of driver for OXFW970/971 based devices
4 * 4 *
5 * Copyright (c) Clemens Ladisch <clemens@ladi 5 * Copyright (c) Clemens Ladisch <clemens@ladisch.de>
6 */ 6 */
7 7
8 #include <linux/device.h> 8 #include <linux/device.h>
9 #include <linux/firewire.h> 9 #include <linux/firewire.h>
10 #include <linux/firewire-constants.h> 10 #include <linux/firewire-constants.h>
11 #include <linux/module.h> 11 #include <linux/module.h>
12 #include <linux/mod_devicetable.h> 12 #include <linux/mod_devicetable.h>
13 #include <linux/mutex.h> 13 #include <linux/mutex.h>
14 #include <linux/slab.h> 14 #include <linux/slab.h>
15 #include <linux/compat.h> 15 #include <linux/compat.h>
16 #include <linux/sched/signal.h> 16 #include <linux/sched/signal.h>
17 17
18 #include <sound/control.h> 18 #include <sound/control.h>
19 #include <sound/core.h> 19 #include <sound/core.h>
20 #include <sound/initval.h> 20 #include <sound/initval.h>
21 #include <sound/pcm.h> 21 #include <sound/pcm.h>
22 #include <sound/pcm_params.h> 22 #include <sound/pcm_params.h>
23 #include <sound/info.h> 23 #include <sound/info.h>
24 #include <sound/rawmidi.h> 24 #include <sound/rawmidi.h>
25 #include <sound/firewire.h> 25 #include <sound/firewire.h>
26 #include <sound/hwdep.h> 26 #include <sound/hwdep.h>
27 27
28 #include "../lib.h" 28 #include "../lib.h"
29 #include "../fcp.h" 29 #include "../fcp.h"
30 #include "../packets-buffer.h" 30 #include "../packets-buffer.h"
31 #include "../iso-resources.h" 31 #include "../iso-resources.h"
32 #include "../amdtp-am824.h" 32 #include "../amdtp-am824.h"
33 #include "../cmp.h" 33 #include "../cmp.h"
34 34
35 enum snd_oxfw_quirk { 35 enum snd_oxfw_quirk {
36 // Postpone transferring packets durin 36 // Postpone transferring packets during handling asynchronous transaction. As a result,
37 // next isochronous packet includes mo 37 // next isochronous packet includes more events than one packet can include.
38 SND_OXFW_QUIRK_JUMBO_PAYLOAD = 0x01, 38 SND_OXFW_QUIRK_JUMBO_PAYLOAD = 0x01,
39 // The dbs field of CIP header in tx p 39 // The dbs field of CIP header in tx packet is wrong.
40 SND_OXFW_QUIRK_WRONG_DBS = 0x02, 40 SND_OXFW_QUIRK_WRONG_DBS = 0x02,
41 // Blocking transmission mode is used. 41 // Blocking transmission mode is used.
42 SND_OXFW_QUIRK_BLOCKING_TRANSMISSION = 42 SND_OXFW_QUIRK_BLOCKING_TRANSMISSION = 0x04,
43 // Stanton SCS1.d and SCS1.m support u 43 // Stanton SCS1.d and SCS1.m support unique transaction.
44 SND_OXFW_QUIRK_SCS_TRANSACTION = 0x08, 44 SND_OXFW_QUIRK_SCS_TRANSACTION = 0x08,
45 // Apogee Duet FireWire ignores data b 45 // Apogee Duet FireWire ignores data blocks in packet with NO_INFO for audio data
46 // processing, while output level mete 46 // processing, while output level meter moves. Any value in syt field of packet takes
47 // the device to process audio data ev 47 // the device to process audio data even if the value is invalid in a point of
48 // IEC 61883-1/6. 48 // IEC 61883-1/6.
49 SND_OXFW_QUIRK_IGNORE_NO_INFO_PACKET = 49 SND_OXFW_QUIRK_IGNORE_NO_INFO_PACKET = 0x10,
50 // Loud Technologies Mackie Onyx 1640i 50 // Loud Technologies Mackie Onyx 1640i seems to configure OXFW971 ASIC so that it decides
51 // event frequency according to events 51 // event frequency according to events in received isochronous packets. The device looks to
52 // performs media clock recovery volun 52 // performs media clock recovery voluntarily. In the recovery, the packets with NO_INFO
53 // are ignored, thus driver should tra 53 // are ignored, thus driver should transfer packets with timestamp.
54 SND_OXFW_QUIRK_VOLUNTARY_RECOVERY = 0x 54 SND_OXFW_QUIRK_VOLUNTARY_RECOVERY = 0x20,
55 // Miglia Harmony Audio does not suppo 55 // Miglia Harmony Audio does not support AV/C Stream Format Information command.
56 SND_OXFW_QUIRK_STREAM_FORMAT_INFO_UNSU 56 SND_OXFW_QUIRK_STREAM_FORMAT_INFO_UNSUPPORTED = 0x40,
57 // Miglia Harmony Audio transmits CIP 57 // Miglia Harmony Audio transmits CIP in which the value of dbc field expresses the number
58 // of accumulated payload quadlets inc 58 // of accumulated payload quadlets including the packet.
59 SND_OXFW_QUIRK_DBC_IS_TOTAL_PAYLOAD_QU 59 SND_OXFW_QUIRK_DBC_IS_TOTAL_PAYLOAD_QUADLETS = 0x80,
60 }; 60 };
61 61
62 /* This is an arbitrary number for convinience 62 /* This is an arbitrary number for convinience. */
63 #define SND_OXFW_STREAM_FORMAT_ENTRIES 10 63 #define SND_OXFW_STREAM_FORMAT_ENTRIES 10
64 struct snd_oxfw { 64 struct snd_oxfw {
65 struct snd_card *card; 65 struct snd_card *card;
66 struct fw_unit *unit; 66 struct fw_unit *unit;
67 struct mutex mutex; 67 struct mutex mutex;
68 spinlock_t lock; 68 spinlock_t lock;
69 69
70 // The combination of snd_oxfw_quirk e 70 // The combination of snd_oxfw_quirk enumeration-constants.
71 unsigned int quirks; 71 unsigned int quirks;
72 bool has_output; 72 bool has_output;
73 bool has_input; 73 bool has_input;
74 u8 *tx_stream_formats[SND_OXFW_STREAM_ 74 u8 *tx_stream_formats[SND_OXFW_STREAM_FORMAT_ENTRIES];
75 u8 *rx_stream_formats[SND_OXFW_STREAM_ 75 u8 *rx_stream_formats[SND_OXFW_STREAM_FORMAT_ENTRIES];
76 bool assumed; 76 bool assumed;
77 struct cmp_connection out_conn; 77 struct cmp_connection out_conn;
78 struct cmp_connection in_conn; 78 struct cmp_connection in_conn;
79 struct amdtp_stream tx_stream; 79 struct amdtp_stream tx_stream;
80 struct amdtp_stream rx_stream; 80 struct amdtp_stream rx_stream;
81 unsigned int substreams_count; 81 unsigned int substreams_count;
82 82
83 unsigned int midi_input_ports; 83 unsigned int midi_input_ports;
84 unsigned int midi_output_ports; 84 unsigned int midi_output_ports;
85 85
86 int dev_lock_count; 86 int dev_lock_count;
87 bool dev_lock_changed; 87 bool dev_lock_changed;
88 wait_queue_head_t hwdep_wait; 88 wait_queue_head_t hwdep_wait;
89 89
90 void *spec; 90 void *spec;
91 91
92 struct amdtp_domain domain; 92 struct amdtp_domain domain;
93 }; 93 };
94 94
95 /* 95 /*
96 * AV/C Stream Format Information Specificatio 96 * AV/C Stream Format Information Specification 1.1 Working Draft
97 * (Apr 2005, 1394TA) 97 * (Apr 2005, 1394TA)
98 */ 98 */
99 int avc_stream_set_format(struct fw_unit *unit 99 int avc_stream_set_format(struct fw_unit *unit, enum avc_general_plug_dir dir,
100 unsigned int pid, u8 100 unsigned int pid, u8 *format, unsigned int len);
101 int avc_stream_get_format(struct fw_unit *unit 101 int avc_stream_get_format(struct fw_unit *unit,
102 enum avc_general_plu 102 enum avc_general_plug_dir dir, unsigned int pid,
103 u8 *buf, unsigned in 103 u8 *buf, unsigned int *len, unsigned int eid);
104 static inline int 104 static inline int
105 avc_stream_get_format_single(struct fw_unit *u 105 avc_stream_get_format_single(struct fw_unit *unit,
106 enum avc_general_ 106 enum avc_general_plug_dir dir, unsigned int pid,
107 u8 *buf, unsigned 107 u8 *buf, unsigned int *len)
108 { 108 {
109 return avc_stream_get_format(unit, dir 109 return avc_stream_get_format(unit, dir, pid, buf, len, 0xff);
110 } 110 }
111 static inline int 111 static inline int
112 avc_stream_get_format_list(struct fw_unit *uni 112 avc_stream_get_format_list(struct fw_unit *unit,
113 enum avc_general_pl 113 enum avc_general_plug_dir dir, unsigned int pid,
114 u8 *buf, unsigned i 114 u8 *buf, unsigned int *len,
115 unsigned int eid) 115 unsigned int eid)
116 { 116 {
117 return avc_stream_get_format(unit, dir 117 return avc_stream_get_format(unit, dir, pid, buf, len, eid);
118 } 118 }
119 119
120 /* 120 /*
121 * AV/C Digital Interface Command Set General 121 * AV/C Digital Interface Command Set General Specification 4.2
122 * (Sep 2004, 1394TA) 122 * (Sep 2004, 1394TA)
123 */ 123 */
124 int avc_general_inquiry_sig_fmt(struct fw_unit 124 int avc_general_inquiry_sig_fmt(struct fw_unit *unit, unsigned int rate,
125 enum avc_gener 125 enum avc_general_plug_dir dir,
126 unsigned short 126 unsigned short pid);
127 127
128 int snd_oxfw_stream_init_duplex(struct snd_oxf 128 int snd_oxfw_stream_init_duplex(struct snd_oxfw *oxfw);
129 int snd_oxfw_stream_reserve_duplex(struct snd_ 129 int snd_oxfw_stream_reserve_duplex(struct snd_oxfw *oxfw,
130 struct amdt 130 struct amdtp_stream *stream,
131 unsigned in 131 unsigned int rate, unsigned int pcm_channels,
132 unsigned in 132 unsigned int frames_per_period,
133 unsigned in 133 unsigned int frames_per_buffer);
134 int snd_oxfw_stream_start_duplex(struct snd_ox 134 int snd_oxfw_stream_start_duplex(struct snd_oxfw *oxfw);
135 void snd_oxfw_stream_stop_duplex(struct snd_ox 135 void snd_oxfw_stream_stop_duplex(struct snd_oxfw *oxfw);
136 void snd_oxfw_stream_destroy_duplex(struct snd 136 void snd_oxfw_stream_destroy_duplex(struct snd_oxfw *oxfw);
137 void snd_oxfw_stream_update_duplex(struct snd_ 137 void snd_oxfw_stream_update_duplex(struct snd_oxfw *oxfw);
138 138
139 struct snd_oxfw_stream_formation { 139 struct snd_oxfw_stream_formation {
140 unsigned int rate; 140 unsigned int rate;
141 unsigned int pcm; 141 unsigned int pcm;
142 unsigned int midi; 142 unsigned int midi;
143 }; 143 };
144 int snd_oxfw_stream_parse_format(const u8 *for 144 int snd_oxfw_stream_parse_format(const u8 *format,
145 struct snd_ox 145 struct snd_oxfw_stream_formation *formation);
146 int snd_oxfw_stream_get_current_formation(stru 146 int snd_oxfw_stream_get_current_formation(struct snd_oxfw *oxfw,
147 enum avc_gener 147 enum avc_general_plug_dir dir,
148 struct snd_oxf 148 struct snd_oxfw_stream_formation *formation);
149 149
150 int snd_oxfw_stream_discover(struct snd_oxfw * 150 int snd_oxfw_stream_discover(struct snd_oxfw *oxfw);
151 151
152 void snd_oxfw_stream_lock_changed(struct snd_o 152 void snd_oxfw_stream_lock_changed(struct snd_oxfw *oxfw);
153 int snd_oxfw_stream_lock_try(struct snd_oxfw * 153 int snd_oxfw_stream_lock_try(struct snd_oxfw *oxfw);
154 void snd_oxfw_stream_lock_release(struct snd_o 154 void snd_oxfw_stream_lock_release(struct snd_oxfw *oxfw);
155 155
156 int snd_oxfw_create_pcm(struct snd_oxfw *oxfw) 156 int snd_oxfw_create_pcm(struct snd_oxfw *oxfw);
157 157
158 void snd_oxfw_proc_init(struct snd_oxfw *oxfw) 158 void snd_oxfw_proc_init(struct snd_oxfw *oxfw);
159 159
160 int snd_oxfw_create_midi(struct snd_oxfw *oxfw 160 int snd_oxfw_create_midi(struct snd_oxfw *oxfw);
161 161
162 int snd_oxfw_create_hwdep(struct snd_oxfw *oxf 162 int snd_oxfw_create_hwdep(struct snd_oxfw *oxfw);
163 163
164 int snd_oxfw_add_spkr(struct snd_oxfw *oxfw, b 164 int snd_oxfw_add_spkr(struct snd_oxfw *oxfw, bool is_lacie);
165 int snd_oxfw_scs1x_add(struct snd_oxfw *oxfw); 165 int snd_oxfw_scs1x_add(struct snd_oxfw *oxfw);
166 void snd_oxfw_scs1x_update(struct snd_oxfw *ox 166 void snd_oxfw_scs1x_update(struct snd_oxfw *oxfw);
167 167
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.