| /* SPDX-License-Identifier: GPL-2.0-only */ |
| /* |
| * oxfw.h - a part of driver for OXFW970/971 based devices |
| * |
| * Copyright (c) Clemens Ladisch <clemens@ladisch.de> |
| */ |
| |
| #include <linux/device.h> |
| #include <linux/firewire.h> |
| #include <linux/firewire-constants.h> |
| #include <linux/module.h> |
| #include <linux/mod_devicetable.h> |
| #include <linux/mutex.h> |
| #include <linux/slab.h> |
| #include <linux/compat.h> |
| #include <linux/sched/signal.h> |
| |
| #include <sound/control.h> |
| #include <sound/core.h> |
| #include <sound/initval.h> |
| #include <sound/pcm.h> |
| #include <sound/pcm_params.h> |
| #include <sound/info.h> |
| #include <sound/rawmidi.h> |
| #include <sound/firewire.h> |
| #include <sound/hwdep.h> |
| |
| #include "../lib.h" |
| #include "../fcp.h" |
| #include "../packets-buffer.h" |
| #include "../iso-resources.h" |
| #include "../amdtp-am824.h" |
| #include "../cmp.h" |
| |
| enum snd_oxfw_quirk { |
| // Postpone transferring packets during handling asynchronous transaction. As a result, |
| // next isochronous packet includes more events than one packet can include. |
| SND_OXFW_QUIRK_JUMBO_PAYLOAD = 0x01, |
| // The dbs field of CIP header in tx packet is wrong. |
| SND_OXFW_QUIRK_WRONG_DBS = 0x02, |
| // Blocking transmission mode is used. |
| SND_OXFW_QUIRK_BLOCKING_TRANSMISSION = 0x04, |
| // Stanton SCS1.d and SCS1.m support unique transaction. |
| SND_OXFW_QUIRK_SCS_TRANSACTION = 0x08, |
| // Apogee Duet FireWire ignores data blocks in packet with NO_INFO for audio data |
| // processing, while output level meter moves. Any value in syt field of packet takes |
| // the device to process audio data even if the value is invalid in a point of |
| // IEC 61883-1/6. |
| SND_OXFW_QUIRK_IGNORE_NO_INFO_PACKET = 0x10, |
| // Loud Technologies Mackie Onyx 1640i seems to configure OXFW971 ASIC so that it decides |
| // event frequency according to events in received isochronous packets. The device looks to |
| // performs media clock recovery voluntarily. In the recovery, the packets with NO_INFO |
| // are ignored, thus driver should transfer packets with timestamp. |
| SND_OXFW_QUIRK_VOLUNTARY_RECOVERY = 0x20, |
| // Miglia Harmony Audio does not support AV/C Stream Format Information command. |
| SND_OXFW_QUIRK_STREAM_FORMAT_INFO_UNSUPPORTED = 0x40, |
| // Miglia Harmony Audio transmits CIP in which the value of dbc field expresses the number |
| // of accumulated payload quadlets including the packet. |
| SND_OXFW_QUIRK_DBC_IS_TOTAL_PAYLOAD_QUADLETS = 0x80, |
| }; |
| |
| /* This is an arbitrary number for convinience. */ |
| #define SND_OXFW_STREAM_FORMAT_ENTRIES 10 |
| struct snd_oxfw { |
| struct snd_card *card; |
| struct fw_unit *unit; |
| struct mutex mutex; |
| spinlock_t lock; |
| |
| // The combination of snd_oxfw_quirk enumeration-constants. |
| unsigned int quirks; |
| bool has_output; |
| bool has_input; |
| u8 *tx_stream_formats[SND_OXFW_STREAM_FORMAT_ENTRIES]; |
| u8 *rx_stream_formats[SND_OXFW_STREAM_FORMAT_ENTRIES]; |
| bool assumed; |
| struct cmp_connection out_conn; |
| struct cmp_connection in_conn; |
| struct amdtp_stream tx_stream; |
| struct amdtp_stream rx_stream; |
| unsigned int substreams_count; |
| |
| unsigned int midi_input_ports; |
| unsigned int midi_output_ports; |
| |
| int dev_lock_count; |
| bool dev_lock_changed; |
| wait_queue_head_t hwdep_wait; |
| |
| void *spec; |
| |
| struct amdtp_domain domain; |
| }; |
| |
| /* |
| * AV/C Stream Format Information Specification 1.1 Working Draft |
| * (Apr 2005, 1394TA) |
| */ |
| int avc_stream_set_format(struct fw_unit *unit, enum avc_general_plug_dir dir, |
| unsigned int pid, u8 *format, unsigned int len); |
| int avc_stream_get_format(struct fw_unit *unit, |
| enum avc_general_plug_dir dir, unsigned int pid, |
| u8 *buf, unsigned int *len, unsigned int eid); |
| 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) |
| { |
| return avc_stream_get_format(unit, dir, pid, buf, len, 0xff); |
| } |
| 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) |
| { |
| return avc_stream_get_format(unit, dir, pid, buf, len, eid); |
| } |
| |
| /* |
| * AV/C Digital Interface Command Set General Specification 4.2 |
| * (Sep 2004, 1394TA) |
| */ |
| int avc_general_inquiry_sig_fmt(struct fw_unit *unit, unsigned int rate, |
| enum avc_general_plug_dir dir, |
| unsigned short pid); |
| |
| int snd_oxfw_stream_init_duplex(struct snd_oxfw *oxfw); |
| int snd_oxfw_stream_reserve_duplex(struct snd_oxfw *oxfw, |
| struct amdtp_stream *stream, |
| unsigned int rate, unsigned int pcm_channels, |
| unsigned int frames_per_period, |
| unsigned int frames_per_buffer); |
| int snd_oxfw_stream_start_duplex(struct snd_oxfw *oxfw); |
| void snd_oxfw_stream_stop_duplex(struct snd_oxfw *oxfw); |
| void snd_oxfw_stream_destroy_duplex(struct snd_oxfw *oxfw); |
| void snd_oxfw_stream_update_duplex(struct snd_oxfw *oxfw); |
| |
| struct snd_oxfw_stream_formation { |
| unsigned int rate; |
| unsigned int pcm; |
| unsigned int midi; |
| }; |
| int snd_oxfw_stream_parse_format(const u8 *format, |
| struct snd_oxfw_stream_formation *formation); |
| int snd_oxfw_stream_get_current_formation(struct snd_oxfw *oxfw, |
| enum avc_general_plug_dir dir, |
| struct snd_oxfw_stream_formation *formation); |
| |
| int snd_oxfw_stream_discover(struct snd_oxfw *oxfw); |
| |
| void snd_oxfw_stream_lock_changed(struct snd_oxfw *oxfw); |
| int snd_oxfw_stream_lock_try(struct snd_oxfw *oxfw); |
| void snd_oxfw_stream_lock_release(struct snd_oxfw *oxfw); |
| |
| int snd_oxfw_create_pcm(struct snd_oxfw *oxfw); |
| |
| void snd_oxfw_proc_init(struct snd_oxfw *oxfw); |
| |
| int snd_oxfw_create_midi(struct snd_oxfw *oxfw); |
| |
| int snd_oxfw_create_hwdep(struct snd_oxfw *oxfw); |
| |
| int snd_oxfw_add_spkr(struct snd_oxfw *oxfw, bool is_lacie); |
| int snd_oxfw_scs1x_add(struct snd_oxfw *oxfw); |
| void snd_oxfw_scs1x_update(struct snd_oxfw *oxfw); |