root/sound/firewire/fireworks/fireworks.h

/* [<][>][^][v][top][bottom][index][help] */

INCLUDED FROM


   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * fireworks.h - a part of driver for Fireworks based devices
   4  *
   5  * Copyright (c) 2009-2010 Clemens Ladisch
   6  * Copyright (c) 2013-2014 Takashi Sakamoto
   7  */
   8 #ifndef SOUND_FIREWORKS_H_INCLUDED
   9 #define SOUND_FIREWORKS_H_INCLUDED
  10 
  11 #include <linux/compat.h>
  12 #include <linux/device.h>
  13 #include <linux/firewire.h>
  14 #include <linux/firewire-constants.h>
  15 #include <linux/module.h>
  16 #include <linux/mod_devicetable.h>
  17 #include <linux/delay.h>
  18 #include <linux/slab.h>
  19 #include <linux/sched/signal.h>
  20 
  21 #include <sound/core.h>
  22 #include <sound/initval.h>
  23 #include <sound/pcm.h>
  24 #include <sound/info.h>
  25 #include <sound/rawmidi.h>
  26 #include <sound/pcm_params.h>
  27 #include <sound/firewire.h>
  28 #include <sound/hwdep.h>
  29 
  30 #include "../packets-buffer.h"
  31 #include "../iso-resources.h"
  32 #include "../amdtp-am824.h"
  33 #include "../cmp.h"
  34 #include "../lib.h"
  35 
  36 #define SND_EFW_MAX_MIDI_OUT_PORTS      2
  37 #define SND_EFW_MAX_MIDI_IN_PORTS       2
  38 
  39 #define SND_EFW_MULTIPLIER_MODES        3
  40 #define HWINFO_NAME_SIZE_BYTES          32
  41 #define HWINFO_MAX_CAPS_GROUPS          8
  42 
  43 /*
  44  * This should be greater than maximum bytes for EFW response content.
  45  * Currently response against command for isochronous channel mapping is
  46  * confirmed to be the maximum one. But for flexibility, use maximum data
  47  * payload for asynchronous primary packets at S100 (Cable base rate) in
  48  * IEEE Std 1394-1995.
  49  */
  50 #define SND_EFW_RESPONSE_MAXIMUM_BYTES  0x200U
  51 
  52 extern unsigned int snd_efw_resp_buf_size;
  53 extern bool snd_efw_resp_buf_debug;
  54 
  55 struct snd_efw_phys_grp {
  56         u8 type;        /* see enum snd_efw_grp_type */
  57         u8 count;
  58 } __packed;
  59 
  60 struct snd_efw {
  61         struct snd_card *card;
  62         struct fw_unit *unit;
  63         int card_index;
  64 
  65         struct mutex mutex;
  66         spinlock_t lock;
  67 
  68         bool registered;
  69         struct delayed_work dwork;
  70 
  71         /* for transaction */
  72         u32 seqnum;
  73         bool resp_addr_changable;
  74 
  75         /* for quirks */
  76         bool is_af9;
  77         bool is_fireworks3;
  78         u32 firmware_version;
  79 
  80         unsigned int midi_in_ports;
  81         unsigned int midi_out_ports;
  82 
  83         unsigned int supported_sampling_rate;
  84         unsigned int pcm_capture_channels[SND_EFW_MULTIPLIER_MODES];
  85         unsigned int pcm_playback_channels[SND_EFW_MULTIPLIER_MODES];
  86 
  87         struct amdtp_stream tx_stream;
  88         struct amdtp_stream rx_stream;
  89         struct cmp_connection out_conn;
  90         struct cmp_connection in_conn;
  91         unsigned int substreams_counter;
  92 
  93         /* hardware metering parameters */
  94         unsigned int phys_out;
  95         unsigned int phys_in;
  96         unsigned int phys_out_grp_count;
  97         unsigned int phys_in_grp_count;
  98         struct snd_efw_phys_grp phys_out_grps[HWINFO_MAX_CAPS_GROUPS];
  99         struct snd_efw_phys_grp phys_in_grps[HWINFO_MAX_CAPS_GROUPS];
 100 
 101         /* for uapi */
 102         int dev_lock_count;
 103         bool dev_lock_changed;
 104         wait_queue_head_t hwdep_wait;
 105 
 106         /* response queue */
 107         u8 *resp_buf;
 108         u8 *pull_ptr;
 109         u8 *push_ptr;
 110 
 111         struct amdtp_domain domain;
 112 };
 113 
 114 int snd_efw_transaction_cmd(struct fw_unit *unit,
 115                             const void *cmd, unsigned int size);
 116 int snd_efw_transaction_run(struct fw_unit *unit,
 117                             const void *cmd, unsigned int cmd_size,
 118                             void *resp, unsigned int resp_size);
 119 int snd_efw_transaction_register(void);
 120 void snd_efw_transaction_unregister(void);
 121 void snd_efw_transaction_bus_reset(struct fw_unit *unit);
 122 void snd_efw_transaction_add_instance(struct snd_efw *efw);
 123 void snd_efw_transaction_remove_instance(struct snd_efw *efw);
 124 
 125 struct snd_efw_hwinfo {
 126         u32 flags;
 127         u32 guid_hi;
 128         u32 guid_lo;
 129         u32 type;
 130         u32 version;
 131         char vendor_name[HWINFO_NAME_SIZE_BYTES];
 132         char model_name[HWINFO_NAME_SIZE_BYTES];
 133         u32 supported_clocks;
 134         u32 amdtp_rx_pcm_channels;
 135         u32 amdtp_tx_pcm_channels;
 136         u32 phys_out;
 137         u32 phys_in;
 138         u32 phys_out_grp_count;
 139         struct snd_efw_phys_grp phys_out_grps[HWINFO_MAX_CAPS_GROUPS];
 140         u32 phys_in_grp_count;
 141         struct snd_efw_phys_grp phys_in_grps[HWINFO_MAX_CAPS_GROUPS];
 142         u32 midi_out_ports;
 143         u32 midi_in_ports;
 144         u32 max_sample_rate;
 145         u32 min_sample_rate;
 146         u32 dsp_version;
 147         u32 arm_version;
 148         u32 mixer_playback_channels;
 149         u32 mixer_capture_channels;
 150         u32 fpga_version;
 151         u32 amdtp_rx_pcm_channels_2x;
 152         u32 amdtp_tx_pcm_channels_2x;
 153         u32 amdtp_rx_pcm_channels_4x;
 154         u32 amdtp_tx_pcm_channels_4x;
 155         u32 reserved[16];
 156 } __packed;
 157 enum snd_efw_grp_type {
 158         SND_EFW_CH_TYPE_ANALOG                  = 0,
 159         SND_EFW_CH_TYPE_SPDIF                   = 1,
 160         SND_EFW_CH_TYPE_ADAT                    = 2,
 161         SND_EFW_CH_TYPE_SPDIF_OR_ADAT           = 3,
 162         SND_EFW_CH_TYPE_ANALOG_MIRRORING        = 4,
 163         SND_EFW_CH_TYPE_HEADPHONES              = 5,
 164         SND_EFW_CH_TYPE_I2S                     = 6,
 165         SND_EFW_CH_TYPE_GUITAR                  = 7,
 166         SND_EFW_CH_TYPE_PIEZO_GUITAR            = 8,
 167         SND_EFW_CH_TYPE_GUITAR_STRING           = 9,
 168         SND_EFW_CH_TYPE_DUMMY
 169 };
 170 struct snd_efw_phys_meters {
 171         u32 status;     /* guitar state/midi signal/clock input detect */
 172         u32 reserved0;
 173         u32 reserved1;
 174         u32 reserved2;
 175         u32 reserved3;
 176         u32 out_meters;
 177         u32 in_meters;
 178         u32 reserved4;
 179         u32 reserved5;
 180         u32 values[0];
 181 } __packed;
 182 enum snd_efw_clock_source {
 183         SND_EFW_CLOCK_SOURCE_INTERNAL   = 0,
 184         SND_EFW_CLOCK_SOURCE_SYTMATCH   = 1,
 185         SND_EFW_CLOCK_SOURCE_WORDCLOCK  = 2,
 186         SND_EFW_CLOCK_SOURCE_SPDIF      = 3,
 187         SND_EFW_CLOCK_SOURCE_ADAT_1     = 4,
 188         SND_EFW_CLOCK_SOURCE_ADAT_2     = 5,
 189         SND_EFW_CLOCK_SOURCE_CONTINUOUS = 6     /* internal variable clock */
 190 };
 191 enum snd_efw_transport_mode {
 192         SND_EFW_TRANSPORT_MODE_WINDOWS  = 0,
 193         SND_EFW_TRANSPORT_MODE_IEC61883 = 1,
 194 };
 195 int snd_efw_command_set_resp_addr(struct snd_efw *efw,
 196                                   u16 addr_high, u32 addr_low);
 197 int snd_efw_command_set_tx_mode(struct snd_efw *efw,
 198                                 enum snd_efw_transport_mode mode);
 199 int snd_efw_command_get_hwinfo(struct snd_efw *efw,
 200                                struct snd_efw_hwinfo *hwinfo);
 201 int snd_efw_command_get_phys_meters(struct snd_efw *efw,
 202                                     struct snd_efw_phys_meters *meters,
 203                                     unsigned int len);
 204 int snd_efw_command_get_clock_source(struct snd_efw *efw,
 205                                      enum snd_efw_clock_source *source);
 206 int snd_efw_command_get_sampling_rate(struct snd_efw *efw, unsigned int *rate);
 207 int snd_efw_command_set_sampling_rate(struct snd_efw *efw, unsigned int rate);
 208 
 209 int snd_efw_stream_init_duplex(struct snd_efw *efw);
 210 int snd_efw_stream_reserve_duplex(struct snd_efw *efw, unsigned int rate);
 211 int snd_efw_stream_start_duplex(struct snd_efw *efw);
 212 void snd_efw_stream_stop_duplex(struct snd_efw *efw);
 213 void snd_efw_stream_update_duplex(struct snd_efw *efw);
 214 void snd_efw_stream_destroy_duplex(struct snd_efw *efw);
 215 void snd_efw_stream_lock_changed(struct snd_efw *efw);
 216 int snd_efw_stream_lock_try(struct snd_efw *efw);
 217 void snd_efw_stream_lock_release(struct snd_efw *efw);
 218 
 219 void snd_efw_proc_init(struct snd_efw *efw);
 220 
 221 int snd_efw_create_midi_devices(struct snd_efw *efw);
 222 
 223 int snd_efw_create_pcm_devices(struct snd_efw *efw);
 224 int snd_efw_get_multiplier_mode(unsigned int sampling_rate, unsigned int *mode);
 225 
 226 int snd_efw_create_hwdep_device(struct snd_efw *efw);
 227 
 228 #define SND_EFW_DEV_ENTRY(vendor, model) \
 229 { \
 230         .match_flags    = IEEE1394_MATCH_VENDOR_ID | \
 231                           IEEE1394_MATCH_MODEL_ID, \
 232         .vendor_id      = vendor,\
 233         .model_id       = model \
 234 }
 235 
 236 #endif

/* [<][>][^][v][top][bottom][index][help] */