xref: /linux/sound/firewire/motu/motu-protocol-v2.c (revision 26fbb4c8c7c3ee9a4c3b4de555a8587b5a19154e)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * motu-protocol-v2.c - a part of driver for MOTU FireWire series
4  *
5  * Copyright (c) 2015-2017 Takashi Sakamoto <o-takashi@sakamocchi.jp>
6  */
7 
8 #include "motu.h"
9 
10 #define V2_CLOCK_STATUS_OFFSET			0x0b14
11 #define  V2_CLOCK_RATE_MASK			0x00000038
12 #define  V2_CLOCK_RATE_SHIFT			3
13 #define  V2_CLOCK_SRC_MASK			0x00000007
14 #define  V2_CLOCK_SRC_SHIFT			0
15 #define  V2_CLOCK_FETCH_ENABLE			0x02000000
16 #define  V2_CLOCK_MODEL_SPECIFIC		0x04000000
17 
18 #define V2_IN_OUT_CONF_OFFSET			0x0c04
19 #define  V2_OPT_OUT_IFACE_MASK			0x00000c00
20 #define  V2_OPT_OUT_IFACE_SHIFT			10
21 #define  V2_OPT_IN_IFACE_MASK			0x00000300
22 #define  V2_OPT_IN_IFACE_SHIFT			8
23 #define  V2_OPT_IFACE_MODE_NONE			0
24 #define  V2_OPT_IFACE_MODE_ADAT			1
25 #define  V2_OPT_IFACE_MODE_SPDIF		2
26 
27 static int get_clock_rate(u32 data, unsigned int *rate)
28 {
29 	unsigned int index = (data & V2_CLOCK_RATE_MASK) >> V2_CLOCK_RATE_SHIFT;
30 	if (index >= ARRAY_SIZE(snd_motu_clock_rates))
31 		return -EIO;
32 
33 	*rate = snd_motu_clock_rates[index];
34 
35 	return 0;
36 }
37 
38 int snd_motu_protocol_v2_get_clock_rate(struct snd_motu *motu,
39 					unsigned int *rate)
40 {
41 	__be32 reg;
42 	int err;
43 
44 	err = snd_motu_transaction_read(motu, V2_CLOCK_STATUS_OFFSET, &reg,
45 					sizeof(reg));
46 	if (err < 0)
47 		return err;
48 
49 	return get_clock_rate(be32_to_cpu(reg), rate);
50 }
51 
52 int snd_motu_protocol_v2_set_clock_rate(struct snd_motu *motu,
53 					unsigned int rate)
54 {
55 	__be32 reg;
56 	u32 data;
57 	int i;
58 	int err;
59 
60 	for (i = 0; i < ARRAY_SIZE(snd_motu_clock_rates); ++i) {
61 		if (snd_motu_clock_rates[i] == rate)
62 			break;
63 	}
64 	if (i == ARRAY_SIZE(snd_motu_clock_rates))
65 		return -EINVAL;
66 
67 	err = snd_motu_transaction_read(motu, V2_CLOCK_STATUS_OFFSET, &reg,
68 					sizeof(reg));
69 	if (err < 0)
70 		return err;
71 	data = be32_to_cpu(reg);
72 
73 	data &= ~V2_CLOCK_RATE_MASK;
74 	data |= i << V2_CLOCK_RATE_SHIFT;
75 
76 	reg = cpu_to_be32(data);
77 	return snd_motu_transaction_write(motu, V2_CLOCK_STATUS_OFFSET, &reg,
78 					  sizeof(reg));
79 }
80 
81 static int detect_clock_source_optical_model(struct snd_motu *motu, u32 data,
82 					     enum snd_motu_clock_source *src)
83 {
84 	switch (data) {
85 	case 0:
86 		*src = SND_MOTU_CLOCK_SOURCE_INTERNAL;
87 		break;
88 	case 1:
89 	{
90 		__be32 reg;
91 
92 		// To check the configuration of optical interface.
93 		int err = snd_motu_transaction_read(motu, V2_IN_OUT_CONF_OFFSET,
94 						    &reg, sizeof(reg));
95 		if (err < 0)
96 			return err;
97 
98 		if (be32_to_cpu(reg) & 0x00000200)
99 			*src = SND_MOTU_CLOCK_SOURCE_SPDIF_ON_OPT;
100 		else
101 			*src = SND_MOTU_CLOCK_SOURCE_ADAT_ON_OPT;
102 		break;
103 	}
104 	case 2:
105 		*src = SND_MOTU_CLOCK_SOURCE_SPDIF_ON_COAX;
106 		break;
107 	case 3:
108 		*src = SND_MOTU_CLOCK_SOURCE_SPH;
109 		break;
110 	case 4:
111 		*src = SND_MOTU_CLOCK_SOURCE_WORD_ON_BNC;
112 		break;
113 	case 5:
114 		*src = SND_MOTU_CLOCK_SOURCE_ADAT_ON_DSUB;
115 		break;
116 	default:
117 		*src = SND_MOTU_CLOCK_SOURCE_UNKNOWN;
118 		break;
119 	}
120 
121 	return 0;
122 }
123 
124 static int v2_detect_clock_source(struct snd_motu *motu, u32 data,
125 				  enum snd_motu_clock_source *src)
126 {
127 	switch (data) {
128 	case 0:
129 		*src = SND_MOTU_CLOCK_SOURCE_INTERNAL;
130 		break;
131 	case 2:
132 		*src = SND_MOTU_CLOCK_SOURCE_SPDIF_ON_COAX;
133 		break;
134 	case 3:
135 		*src = SND_MOTU_CLOCK_SOURCE_SPH;
136 		break;
137 	case 4:
138 		*src = SND_MOTU_CLOCK_SOURCE_WORD_ON_BNC;
139 		break;
140 	default:
141 		*src = SND_MOTU_CLOCK_SOURCE_UNKNOWN;
142 		break;
143 	}
144 
145 	return 0;
146 }
147 
148 static int get_clock_source(struct snd_motu *motu, u32 data,
149 			    enum snd_motu_clock_source *src)
150 {
151 	data &= V2_CLOCK_SRC_MASK;
152 	if (motu->spec == &snd_motu_spec_828mk2 ||
153 	    motu->spec == &snd_motu_spec_traveler)
154 		return detect_clock_source_optical_model(motu, data, src);
155 	else
156 		return v2_detect_clock_source(motu, data, src);
157 }
158 
159 int snd_motu_protocol_v2_get_clock_source(struct snd_motu *motu,
160 					  enum snd_motu_clock_source *src)
161 {
162 	__be32 reg;
163 	int err;
164 
165 	err = snd_motu_transaction_read(motu, V2_CLOCK_STATUS_OFFSET, &reg,
166 					sizeof(reg));
167 	if (err < 0)
168 		return err;
169 
170 	return get_clock_source(motu, be32_to_cpu(reg), src);
171 }
172 
173 // Expected for Traveler and 896HD, which implements Altera Cyclone EP1C3.
174 static int switch_fetching_mode_cyclone(struct snd_motu *motu, u32 *data,
175 					bool enable)
176 {
177 	*data |= V2_CLOCK_MODEL_SPECIFIC;
178 
179 	return 0;
180 }
181 
182 // For UltraLite and 8pre, which implements Xilinx Spartan XC3S200.
183 static int switch_fetching_mode_spartan(struct snd_motu *motu, u32 *data,
184 					bool enable)
185 {
186 	unsigned int rate;
187 	enum snd_motu_clock_source src;
188 	int err;
189 
190 	err = get_clock_source(motu, *data, &src);
191 	if (err < 0)
192 		return err;
193 
194 	err = get_clock_rate(*data, &rate);
195 	if (err < 0)
196 		return err;
197 
198 	if (src == SND_MOTU_CLOCK_SOURCE_SPH && rate > 48000)
199 		*data |= V2_CLOCK_MODEL_SPECIFIC;
200 
201 	return 0;
202 }
203 
204 int snd_motu_protocol_v2_switch_fetching_mode(struct snd_motu *motu,
205 					      bool enable)
206 {
207 	if (motu->spec == &snd_motu_spec_828mk2) {
208 		// 828mkII implements Altera ACEX 1K EP1K30. Nothing to do.
209 		return 0;
210 	} else {
211 		__be32 reg;
212 		u32 data;
213 		int err;
214 
215 		err = snd_motu_transaction_read(motu, V2_CLOCK_STATUS_OFFSET,
216 						&reg, sizeof(reg));
217 		if (err < 0)
218 			return err;
219 		data = be32_to_cpu(reg);
220 
221 		data &= ~(V2_CLOCK_FETCH_ENABLE | V2_CLOCK_MODEL_SPECIFIC);
222 		if (enable)
223 			data |= V2_CLOCK_FETCH_ENABLE;
224 
225 		if (motu->spec == &snd_motu_spec_traveler)
226 			err = switch_fetching_mode_cyclone(motu, &data, enable);
227 		else
228 			err = switch_fetching_mode_spartan(motu, &data, enable);
229 		if (err < 0)
230 			return err;
231 
232 		reg = cpu_to_be32(data);
233 		return snd_motu_transaction_write(motu, V2_CLOCK_STATUS_OFFSET,
234 						  &reg, sizeof(reg));
235 	}
236 }
237 
238 static int detect_packet_formats_828mk2(struct snd_motu *motu, u32 data)
239 {
240 	if (((data & V2_OPT_IN_IFACE_MASK) >> V2_OPT_IN_IFACE_SHIFT) ==
241 	    V2_OPT_IFACE_MODE_ADAT) {
242 		motu->tx_packet_formats.pcm_chunks[0] += 8;
243 		motu->tx_packet_formats.pcm_chunks[1] += 4;
244 	}
245 
246 	if (((data & V2_OPT_OUT_IFACE_MASK) >> V2_OPT_OUT_IFACE_SHIFT) ==
247 	    V2_OPT_IFACE_MODE_ADAT) {
248 		motu->rx_packet_formats.pcm_chunks[0] += 8;
249 		motu->rx_packet_formats.pcm_chunks[1] += 4;
250 	}
251 
252 	return 0;
253 }
254 
255 static int detect_packet_formats_traveler(struct snd_motu *motu, u32 data)
256 {
257 	if (((data & V2_OPT_IN_IFACE_MASK) >> V2_OPT_IN_IFACE_SHIFT) ==
258 	    V2_OPT_IFACE_MODE_ADAT) {
259 		motu->tx_packet_formats.pcm_chunks[0] += 8;
260 		motu->tx_packet_formats.pcm_chunks[1] += 4;
261 	}
262 
263 	if (((data & V2_OPT_OUT_IFACE_MASK) >> V2_OPT_OUT_IFACE_SHIFT) ==
264 	    V2_OPT_IFACE_MODE_ADAT) {
265 		motu->rx_packet_formats.pcm_chunks[0] += 8;
266 		motu->rx_packet_formats.pcm_chunks[1] += 4;
267 	}
268 
269 	return 0;
270 }
271 
272 static int detect_packet_formats_8pre(struct snd_motu *motu, u32 data)
273 {
274 	if (((data & V2_OPT_IN_IFACE_MASK) >> V2_OPT_IN_IFACE_SHIFT) ==
275 	    V2_OPT_IFACE_MODE_ADAT) {
276 		motu->tx_packet_formats.pcm_chunks[0] += 8;
277 		motu->tx_packet_formats.pcm_chunks[1] += 8;
278 	}
279 
280 	if (((data & V2_OPT_OUT_IFACE_MASK) >> V2_OPT_OUT_IFACE_SHIFT) ==
281 	    V2_OPT_IFACE_MODE_ADAT) {
282 		motu->rx_packet_formats.pcm_chunks[0] += 8;
283 		motu->rx_packet_formats.pcm_chunks[1] += 8;
284 	}
285 
286 	return 0;
287 }
288 
289 int snd_motu_protocol_v2_cache_packet_formats(struct snd_motu *motu)
290 {
291 	__be32 reg;
292 	u32 data;
293 	int err;
294 
295 	motu->tx_packet_formats.pcm_byte_offset = 10;
296 	motu->rx_packet_formats.pcm_byte_offset = 10;
297 
298 	motu->tx_packet_formats.msg_chunks = 2;
299 	motu->rx_packet_formats.msg_chunks = 2;
300 
301 	err = snd_motu_transaction_read(motu, V2_IN_OUT_CONF_OFFSET, &reg,
302 					sizeof(reg));
303 	if (err < 0)
304 		return err;
305 	data = be32_to_cpu(reg);
306 
307 	memcpy(motu->tx_packet_formats.pcm_chunks,
308 	       motu->spec->tx_fixed_pcm_chunks,
309 	       sizeof(motu->tx_packet_formats.pcm_chunks));
310 	memcpy(motu->rx_packet_formats.pcm_chunks,
311 	       motu->spec->rx_fixed_pcm_chunks,
312 	       sizeof(motu->rx_packet_formats.pcm_chunks));
313 
314 	if (motu->spec == &snd_motu_spec_828mk2)
315 		return detect_packet_formats_828mk2(motu, data);
316 	else if (motu->spec == &snd_motu_spec_traveler)
317 		return detect_packet_formats_traveler(motu, data);
318 	else if (motu->spec == &snd_motu_spec_8pre)
319 		return detect_packet_formats_8pre(motu, data);
320 	else
321 		return 0;
322 }
323 
324 const struct snd_motu_spec snd_motu_spec_828mk2 = {
325 	.name = "828mk2",
326 	.protocol_version = SND_MOTU_PROTOCOL_V2,
327 	.flags = SND_MOTU_SPEC_RX_MIDI_2ND_Q |
328 		 SND_MOTU_SPEC_TX_MIDI_2ND_Q,
329 	.tx_fixed_pcm_chunks = {14, 14, 0},
330 	.rx_fixed_pcm_chunks = {14, 14, 0},
331 };
332 
333 const struct snd_motu_spec snd_motu_spec_traveler = {
334 	.name = "Traveler",
335 	.protocol_version = SND_MOTU_PROTOCOL_V2,
336 	.flags = SND_MOTU_SPEC_RX_MIDI_2ND_Q |
337 		 SND_MOTU_SPEC_TX_MIDI_2ND_Q,
338 	.tx_fixed_pcm_chunks = {14, 14, 8},
339 	.rx_fixed_pcm_chunks = {14, 14, 8},
340 };
341 
342 const struct snd_motu_spec snd_motu_spec_ultralite = {
343 	.name = "UltraLite",
344 	.protocol_version = SND_MOTU_PROTOCOL_V2,
345 	.flags = SND_MOTU_SPEC_RX_MIDI_2ND_Q |
346 		 SND_MOTU_SPEC_TX_MIDI_2ND_Q,
347 	.tx_fixed_pcm_chunks = {14, 14, 0},
348 	.rx_fixed_pcm_chunks = {14, 14, 0},
349 };
350 
351 const struct snd_motu_spec snd_motu_spec_8pre = {
352 	.name = "8pre",
353 	.protocol_version = SND_MOTU_PROTOCOL_V2,
354 	.flags = SND_MOTU_SPEC_RX_MIDI_2ND_Q |
355 		 SND_MOTU_SPEC_TX_MIDI_2ND_Q,
356 	.tx_fixed_pcm_chunks = {10, 6, 0},
357 	.rx_fixed_pcm_chunks = {10, 6, 0},
358 };
359