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