xref: /OK3568_Linux_fs/kernel/sound/firewire/oxfw/oxfw.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0-only */
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  * oxfw.h - a part of driver for OXFW970/971 based devices
4*4882a593Smuzhiyun  *
5*4882a593Smuzhiyun  * Copyright (c) Clemens Ladisch <clemens@ladisch.de>
6*4882a593Smuzhiyun  */
7*4882a593Smuzhiyun 
8*4882a593Smuzhiyun #include <linux/device.h>
9*4882a593Smuzhiyun #include <linux/firewire.h>
10*4882a593Smuzhiyun #include <linux/firewire-constants.h>
11*4882a593Smuzhiyun #include <linux/module.h>
12*4882a593Smuzhiyun #include <linux/mod_devicetable.h>
13*4882a593Smuzhiyun #include <linux/mutex.h>
14*4882a593Smuzhiyun #include <linux/slab.h>
15*4882a593Smuzhiyun #include <linux/compat.h>
16*4882a593Smuzhiyun #include <linux/sched/signal.h>
17*4882a593Smuzhiyun 
18*4882a593Smuzhiyun #include <sound/control.h>
19*4882a593Smuzhiyun #include <sound/core.h>
20*4882a593Smuzhiyun #include <sound/initval.h>
21*4882a593Smuzhiyun #include <sound/pcm.h>
22*4882a593Smuzhiyun #include <sound/pcm_params.h>
23*4882a593Smuzhiyun #include <sound/info.h>
24*4882a593Smuzhiyun #include <sound/rawmidi.h>
25*4882a593Smuzhiyun #include <sound/firewire.h>
26*4882a593Smuzhiyun #include <sound/hwdep.h>
27*4882a593Smuzhiyun 
28*4882a593Smuzhiyun #include "../lib.h"
29*4882a593Smuzhiyun #include "../fcp.h"
30*4882a593Smuzhiyun #include "../packets-buffer.h"
31*4882a593Smuzhiyun #include "../iso-resources.h"
32*4882a593Smuzhiyun #include "../amdtp-am824.h"
33*4882a593Smuzhiyun #include "../cmp.h"
34*4882a593Smuzhiyun 
35*4882a593Smuzhiyun /* This is an arbitrary number for convinience. */
36*4882a593Smuzhiyun #define	SND_OXFW_STREAM_FORMAT_ENTRIES	10
37*4882a593Smuzhiyun struct snd_oxfw {
38*4882a593Smuzhiyun 	struct snd_card *card;
39*4882a593Smuzhiyun 	struct fw_unit *unit;
40*4882a593Smuzhiyun 	struct mutex mutex;
41*4882a593Smuzhiyun 	spinlock_t lock;
42*4882a593Smuzhiyun 
43*4882a593Smuzhiyun 	bool registered;
44*4882a593Smuzhiyun 	struct delayed_work dwork;
45*4882a593Smuzhiyun 
46*4882a593Smuzhiyun 	bool wrong_dbs;
47*4882a593Smuzhiyun 	bool has_output;
48*4882a593Smuzhiyun 	bool has_input;
49*4882a593Smuzhiyun 	u8 *tx_stream_formats[SND_OXFW_STREAM_FORMAT_ENTRIES];
50*4882a593Smuzhiyun 	u8 *rx_stream_formats[SND_OXFW_STREAM_FORMAT_ENTRIES];
51*4882a593Smuzhiyun 	bool assumed;
52*4882a593Smuzhiyun 	struct cmp_connection out_conn;
53*4882a593Smuzhiyun 	struct cmp_connection in_conn;
54*4882a593Smuzhiyun 	struct amdtp_stream tx_stream;
55*4882a593Smuzhiyun 	struct amdtp_stream rx_stream;
56*4882a593Smuzhiyun 	unsigned int substreams_count;
57*4882a593Smuzhiyun 
58*4882a593Smuzhiyun 	unsigned int midi_input_ports;
59*4882a593Smuzhiyun 	unsigned int midi_output_ports;
60*4882a593Smuzhiyun 
61*4882a593Smuzhiyun 	int dev_lock_count;
62*4882a593Smuzhiyun 	bool dev_lock_changed;
63*4882a593Smuzhiyun 	wait_queue_head_t hwdep_wait;
64*4882a593Smuzhiyun 
65*4882a593Smuzhiyun 	const struct ieee1394_device_id *entry;
66*4882a593Smuzhiyun 	void *spec;
67*4882a593Smuzhiyun 
68*4882a593Smuzhiyun 	struct amdtp_domain domain;
69*4882a593Smuzhiyun };
70*4882a593Smuzhiyun 
71*4882a593Smuzhiyun /*
72*4882a593Smuzhiyun  * AV/C Stream Format Information Specification 1.1 Working Draft
73*4882a593Smuzhiyun  * (Apr 2005, 1394TA)
74*4882a593Smuzhiyun  */
75*4882a593Smuzhiyun int avc_stream_set_format(struct fw_unit *unit, enum avc_general_plug_dir dir,
76*4882a593Smuzhiyun 			  unsigned int pid, u8 *format, unsigned int len);
77*4882a593Smuzhiyun int avc_stream_get_format(struct fw_unit *unit,
78*4882a593Smuzhiyun 			  enum avc_general_plug_dir dir, unsigned int pid,
79*4882a593Smuzhiyun 			  u8 *buf, unsigned int *len, unsigned int eid);
80*4882a593Smuzhiyun static inline int
avc_stream_get_format_single(struct fw_unit * unit,enum avc_general_plug_dir dir,unsigned int pid,u8 * buf,unsigned int * len)81*4882a593Smuzhiyun avc_stream_get_format_single(struct fw_unit *unit,
82*4882a593Smuzhiyun 			     enum avc_general_plug_dir dir, unsigned int pid,
83*4882a593Smuzhiyun 			     u8 *buf, unsigned int *len)
84*4882a593Smuzhiyun {
85*4882a593Smuzhiyun 	return avc_stream_get_format(unit, dir, pid, buf, len, 0xff);
86*4882a593Smuzhiyun }
87*4882a593Smuzhiyun static inline int
avc_stream_get_format_list(struct fw_unit * unit,enum avc_general_plug_dir dir,unsigned int pid,u8 * buf,unsigned int * len,unsigned int eid)88*4882a593Smuzhiyun avc_stream_get_format_list(struct fw_unit *unit,
89*4882a593Smuzhiyun 			   enum avc_general_plug_dir dir, unsigned int pid,
90*4882a593Smuzhiyun 			   u8 *buf, unsigned int *len,
91*4882a593Smuzhiyun 			   unsigned int eid)
92*4882a593Smuzhiyun {
93*4882a593Smuzhiyun 	return avc_stream_get_format(unit, dir, pid, buf, len, eid);
94*4882a593Smuzhiyun }
95*4882a593Smuzhiyun 
96*4882a593Smuzhiyun /*
97*4882a593Smuzhiyun  * AV/C Digital Interface Command Set General Specification 4.2
98*4882a593Smuzhiyun  * (Sep 2004, 1394TA)
99*4882a593Smuzhiyun  */
100*4882a593Smuzhiyun int avc_general_inquiry_sig_fmt(struct fw_unit *unit, unsigned int rate,
101*4882a593Smuzhiyun 				enum avc_general_plug_dir dir,
102*4882a593Smuzhiyun 				unsigned short pid);
103*4882a593Smuzhiyun 
104*4882a593Smuzhiyun int snd_oxfw_stream_init_duplex(struct snd_oxfw *oxfw);
105*4882a593Smuzhiyun int snd_oxfw_stream_reserve_duplex(struct snd_oxfw *oxfw,
106*4882a593Smuzhiyun 				   struct amdtp_stream *stream,
107*4882a593Smuzhiyun 				   unsigned int rate, unsigned int pcm_channels,
108*4882a593Smuzhiyun 				   unsigned int frames_per_period,
109*4882a593Smuzhiyun 				   unsigned int frames_per_buffer);
110*4882a593Smuzhiyun int snd_oxfw_stream_start_duplex(struct snd_oxfw *oxfw);
111*4882a593Smuzhiyun void snd_oxfw_stream_stop_duplex(struct snd_oxfw *oxfw);
112*4882a593Smuzhiyun void snd_oxfw_stream_destroy_duplex(struct snd_oxfw *oxfw);
113*4882a593Smuzhiyun void snd_oxfw_stream_update_duplex(struct snd_oxfw *oxfw);
114*4882a593Smuzhiyun 
115*4882a593Smuzhiyun struct snd_oxfw_stream_formation {
116*4882a593Smuzhiyun 	unsigned int rate;
117*4882a593Smuzhiyun 	unsigned int pcm;
118*4882a593Smuzhiyun 	unsigned int midi;
119*4882a593Smuzhiyun };
120*4882a593Smuzhiyun int snd_oxfw_stream_parse_format(u8 *format,
121*4882a593Smuzhiyun 				 struct snd_oxfw_stream_formation *formation);
122*4882a593Smuzhiyun int snd_oxfw_stream_get_current_formation(struct snd_oxfw *oxfw,
123*4882a593Smuzhiyun 				enum avc_general_plug_dir dir,
124*4882a593Smuzhiyun 				struct snd_oxfw_stream_formation *formation);
125*4882a593Smuzhiyun 
126*4882a593Smuzhiyun int snd_oxfw_stream_discover(struct snd_oxfw *oxfw);
127*4882a593Smuzhiyun 
128*4882a593Smuzhiyun void snd_oxfw_stream_lock_changed(struct snd_oxfw *oxfw);
129*4882a593Smuzhiyun int snd_oxfw_stream_lock_try(struct snd_oxfw *oxfw);
130*4882a593Smuzhiyun void snd_oxfw_stream_lock_release(struct snd_oxfw *oxfw);
131*4882a593Smuzhiyun 
132*4882a593Smuzhiyun int snd_oxfw_create_pcm(struct snd_oxfw *oxfw);
133*4882a593Smuzhiyun 
134*4882a593Smuzhiyun void snd_oxfw_proc_init(struct snd_oxfw *oxfw);
135*4882a593Smuzhiyun 
136*4882a593Smuzhiyun int snd_oxfw_create_midi(struct snd_oxfw *oxfw);
137*4882a593Smuzhiyun 
138*4882a593Smuzhiyun int snd_oxfw_create_hwdep(struct snd_oxfw *oxfw);
139*4882a593Smuzhiyun 
140*4882a593Smuzhiyun int snd_oxfw_add_spkr(struct snd_oxfw *oxfw, bool is_lacie);
141*4882a593Smuzhiyun int snd_oxfw_scs1x_add(struct snd_oxfw *oxfw);
142*4882a593Smuzhiyun void snd_oxfw_scs1x_update(struct snd_oxfw *oxfw);
143