1bea36afaSTakashi Sakamoto // SPDX-License-Identifier: GPL-2.0-only 2bea36afaSTakashi Sakamoto // 3bea36afaSTakashi Sakamoto // motu-register-dsp-message-parser.c - a part of driver for MOTU FireWire series 4bea36afaSTakashi Sakamoto // 5bea36afaSTakashi Sakamoto // Copyright (c) 2021 Takashi Sakamoto <o-takashi@sakamocchi.jp> 6bea36afaSTakashi Sakamoto 7bea36afaSTakashi Sakamoto // Below models allow software to configure their DSP functions by asynchronous transaction 8bea36afaSTakashi Sakamoto // to access their internal registers. 9bea36afaSTakashi Sakamoto // * 828 mk2 10bea36afaSTakashi Sakamoto // * 896hd 11bea36afaSTakashi Sakamoto // * Traveler 12bea36afaSTakashi Sakamoto // * 8 pre 13bea36afaSTakashi Sakamoto // * Ultralite 14bea36afaSTakashi Sakamoto // * 4 pre 15bea36afaSTakashi Sakamoto // * Audio Express 16bea36afaSTakashi Sakamoto // 17bea36afaSTakashi Sakamoto // Additionally, isochronous packets from the above models include messages to notify state of 18bea36afaSTakashi Sakamoto // DSP. The messages are two set of 3 byte data in 2nd and 3rd quadlet of data block. When user 19bea36afaSTakashi Sakamoto // operates hardware components such as dial and switch, corresponding messages are transferred. 20bea36afaSTakashi Sakamoto // The messages include Hardware metering and MIDI messages as well. 21bea36afaSTakashi Sakamoto 22bea36afaSTakashi Sakamoto #include "motu.h" 23bea36afaSTakashi Sakamoto 24bea36afaSTakashi Sakamoto #define MSG_FLAG_POS 4 25bea36afaSTakashi Sakamoto #define MSG_FLAG_TYPE_MASK 0xf8 26bea36afaSTakashi Sakamoto #define MSG_FLAG_MIDI_MASK 0x01 27bea36afaSTakashi Sakamoto #define MSG_FLAG_MODEL_SPECIFIC_MASK 0x06 28bea36afaSTakashi Sakamoto #define MSG_FLAG_8PRE 0x00 29bea36afaSTakashi Sakamoto #define MSG_FLAG_ULTRALITE 0x04 30bea36afaSTakashi Sakamoto #define MSG_FLAG_TRAVELER 0x04 31bea36afaSTakashi Sakamoto #define MSG_FLAG_828MK2 0x04 32bea36afaSTakashi Sakamoto #define MSG_FLAG_896HD 0x04 33bea36afaSTakashi Sakamoto #define MSG_FLAG_4PRE 0x05 // MIDI mask is in 8th byte. 34bea36afaSTakashi Sakamoto #define MSG_FLAG_AUDIOEXPRESS 0x05 // MIDI mask is in 8th byte. 35bea36afaSTakashi Sakamoto #define MSG_FLAG_TYPE_SHIFT 3 36bea36afaSTakashi Sakamoto #define MSG_VALUE_POS 5 37bea36afaSTakashi Sakamoto #define MSG_MIDI_BYTE_POS 6 38bea36afaSTakashi Sakamoto #define MSG_METER_IDX_POS 7 39bea36afaSTakashi Sakamoto 40bea36afaSTakashi Sakamoto // In 4 pre and Audio express, meter index is in 6th byte. MIDI flag is in 8th byte and MIDI byte 41bea36afaSTakashi Sakamoto // is in 7th byte. 42bea36afaSTakashi Sakamoto #define MSG_METER_IDX_POS_4PRE_AE 6 43bea36afaSTakashi Sakamoto #define MSG_MIDI_BYTE_POS_4PRE_AE 7 44bea36afaSTakashi Sakamoto #define MSG_FLAG_MIDI_POS_4PRE_AE 8 45bea36afaSTakashi Sakamoto 46bea36afaSTakashi Sakamoto enum register_dsp_msg_type { 47bea36afaSTakashi Sakamoto // Used for messages with no information. 48bea36afaSTakashi Sakamoto INVALID = 0x00, 49bea36afaSTakashi Sakamoto MIXER_SELECT = 0x01, 50bea36afaSTakashi Sakamoto MIXER_SRC_GAIN = 0x02, 51bea36afaSTakashi Sakamoto MIXER_SRC_PAN = 0x03, 52bea36afaSTakashi Sakamoto MIXER_SRC_FLAG = 0x04, 53bea36afaSTakashi Sakamoto MIXER_OUTPUT_PAIRED_VOLUME = 0x05, 54bea36afaSTakashi Sakamoto MIXER_OUTPUT_PAIRED_FLAG = 0x06, 55bea36afaSTakashi Sakamoto MAIN_OUTPUT_PAIRED_VOLUME = 0x07, 56bea36afaSTakashi Sakamoto HP_OUTPUT_PAIRED_VOLUME = 0x08, 57bea36afaSTakashi Sakamoto HP_OUTPUT_ASSIGN = 0x09, 58bea36afaSTakashi Sakamoto // Transferred by all models but the purpose is still unknown. 59bea36afaSTakashi Sakamoto UNKNOWN_0 = 0x0a, 60bea36afaSTakashi Sakamoto // Specific to 828mk2, 896hd, Traveler. 61bea36afaSTakashi Sakamoto UNKNOWN_2 = 0x0c, 62bea36afaSTakashi Sakamoto // Specific to 828mk2, Traveler, and 896hd (not functional). 63bea36afaSTakashi Sakamoto LINE_INPUT_BOOST = 0x0d, 64bea36afaSTakashi Sakamoto // Specific to 828mk2, Traveler, and 896hd (not functional). 65bea36afaSTakashi Sakamoto LINE_INPUT_NOMINAL_LEVEL = 0x0e, 66bea36afaSTakashi Sakamoto // Specific to Ultralite, 4 pre, Audio express, and 8 pre (not functional). 67bea36afaSTakashi Sakamoto INPUT_GAIN_AND_INVERT = 0x15, 68bea36afaSTakashi Sakamoto // Specific to 4 pre, and Audio express. 69bea36afaSTakashi Sakamoto INPUT_FLAG = 0x16, 70bea36afaSTakashi Sakamoto // Specific to 4 pre, and Audio express. 71bea36afaSTakashi Sakamoto MIXER_SRC_PAIRED_BALANCE = 0x17, 72bea36afaSTakashi Sakamoto // Specific to 4 pre, and Audio express. 73bea36afaSTakashi Sakamoto MIXER_SRC_PAIRED_WIDTH = 0x18, 74bea36afaSTakashi Sakamoto // Transferred by all models. This type of message interposes the series of the other 75bea36afaSTakashi Sakamoto // messages. The message delivers signal level up to 96.0 kHz. In 828mk2, 896hd, and 76bea36afaSTakashi Sakamoto // Traveler, one of physical outputs is selected for the message. The selection is done 77bea36afaSTakashi Sakamoto // by LSB one byte in asynchronous write quadlet transaction to 0x'ffff'f000'0b2c. 78bea36afaSTakashi Sakamoto METER = 0x1f, 79bea36afaSTakashi Sakamoto }; 80bea36afaSTakashi Sakamoto 81bea36afaSTakashi Sakamoto struct msg_parser { 8258b62ab7STakashi Sakamoto spinlock_t lock; 83bea36afaSTakashi Sakamoto struct snd_firewire_motu_register_dsp_meter meter; 84bea36afaSTakashi Sakamoto bool meter_pos_quirk; 85dc36a975STakashi Sakamoto 86dc36a975STakashi Sakamoto struct snd_firewire_motu_register_dsp_parameter param; 87dc36a975STakashi Sakamoto u8 prev_mixer_src_type; 88dc36a975STakashi Sakamoto u8 mixer_ch; 89dc36a975STakashi Sakamoto u8 mixer_src_ch; 90bea36afaSTakashi Sakamoto }; 91bea36afaSTakashi Sakamoto 92bea36afaSTakashi Sakamoto int snd_motu_register_dsp_message_parser_new(struct snd_motu *motu) 93bea36afaSTakashi Sakamoto { 94bea36afaSTakashi Sakamoto struct msg_parser *parser; 95bea36afaSTakashi Sakamoto parser = devm_kzalloc(&motu->card->card_dev, sizeof(*parser), GFP_KERNEL); 96bea36afaSTakashi Sakamoto if (!parser) 97bea36afaSTakashi Sakamoto return -ENOMEM; 9858b62ab7STakashi Sakamoto spin_lock_init(&parser->lock); 99bea36afaSTakashi Sakamoto if (motu->spec == &snd_motu_spec_4pre || motu->spec == &snd_motu_spec_audio_express) 100bea36afaSTakashi Sakamoto parser->meter_pos_quirk = true; 101bea36afaSTakashi Sakamoto motu->message_parser = parser; 102bea36afaSTakashi Sakamoto return 0; 103bea36afaSTakashi Sakamoto } 104bea36afaSTakashi Sakamoto 105bea36afaSTakashi Sakamoto int snd_motu_register_dsp_message_parser_init(struct snd_motu *motu) 106bea36afaSTakashi Sakamoto { 107dc36a975STakashi Sakamoto struct msg_parser *parser = motu->message_parser; 108dc36a975STakashi Sakamoto 109dc36a975STakashi Sakamoto parser->prev_mixer_src_type = INVALID; 110dc36a975STakashi Sakamoto parser->mixer_ch = 0xff; 111dc36a975STakashi Sakamoto parser->mixer_src_ch = 0xff; 112dc36a975STakashi Sakamoto 113bea36afaSTakashi Sakamoto return 0; 114bea36afaSTakashi Sakamoto } 115bea36afaSTakashi Sakamoto 116bea36afaSTakashi Sakamoto void snd_motu_register_dsp_message_parser_parse(struct snd_motu *motu, const struct pkt_desc *descs, 117bea36afaSTakashi Sakamoto unsigned int desc_count, unsigned int data_block_quadlets) 118bea36afaSTakashi Sakamoto { 119bea36afaSTakashi Sakamoto struct msg_parser *parser = motu->message_parser; 120bea36afaSTakashi Sakamoto bool meter_pos_quirk = parser->meter_pos_quirk; 12158b62ab7STakashi Sakamoto unsigned long flags; 122bea36afaSTakashi Sakamoto int i; 123bea36afaSTakashi Sakamoto 12458b62ab7STakashi Sakamoto spin_lock_irqsave(&parser->lock, flags); 12558b62ab7STakashi Sakamoto 126bea36afaSTakashi Sakamoto for (i = 0; i < desc_count; ++i) { 127bea36afaSTakashi Sakamoto const struct pkt_desc *desc = descs + i; 128bea36afaSTakashi Sakamoto __be32 *buffer = desc->ctx_payload; 129bea36afaSTakashi Sakamoto unsigned int data_blocks = desc->data_blocks; 130bea36afaSTakashi Sakamoto int j; 131bea36afaSTakashi Sakamoto 132bea36afaSTakashi Sakamoto for (j = 0; j < data_blocks; ++j) { 133bea36afaSTakashi Sakamoto u8 *b = (u8 *)buffer; 134bea36afaSTakashi Sakamoto u8 msg_type = (b[MSG_FLAG_POS] & MSG_FLAG_TYPE_MASK) >> MSG_FLAG_TYPE_SHIFT; 135bea36afaSTakashi Sakamoto u8 val = b[MSG_VALUE_POS]; 136bea36afaSTakashi Sakamoto 137bea36afaSTakashi Sakamoto buffer += data_block_quadlets; 138bea36afaSTakashi Sakamoto 139bea36afaSTakashi Sakamoto switch (msg_type) { 140dc36a975STakashi Sakamoto case MIXER_SELECT: 141dc36a975STakashi Sakamoto { 142dc36a975STakashi Sakamoto u8 mixer_ch = val / 0x20; 143dc36a975STakashi Sakamoto if (mixer_ch < SNDRV_FIREWIRE_MOTU_REGISTER_DSP_MIXER_COUNT) { 144dc36a975STakashi Sakamoto parser->mixer_src_ch = 0; 145dc36a975STakashi Sakamoto parser->mixer_ch = mixer_ch; 146dc36a975STakashi Sakamoto } 147dc36a975STakashi Sakamoto break; 148dc36a975STakashi Sakamoto } 149dc36a975STakashi Sakamoto case MIXER_SRC_GAIN: 150dc36a975STakashi Sakamoto case MIXER_SRC_PAN: 151dc36a975STakashi Sakamoto case MIXER_SRC_FLAG: 152dc36a975STakashi Sakamoto case MIXER_SRC_PAIRED_BALANCE: 153dc36a975STakashi Sakamoto case MIXER_SRC_PAIRED_WIDTH: 154dc36a975STakashi Sakamoto { 155dc36a975STakashi Sakamoto struct snd_firewire_motu_register_dsp_parameter *param = &parser->param; 156dc36a975STakashi Sakamoto u8 mixer_ch = parser->mixer_ch; 157dc36a975STakashi Sakamoto u8 mixer_src_ch = parser->mixer_src_ch; 158dc36a975STakashi Sakamoto 159dc36a975STakashi Sakamoto if (msg_type != parser->prev_mixer_src_type) 160dc36a975STakashi Sakamoto mixer_src_ch = 0; 161dc36a975STakashi Sakamoto else 162dc36a975STakashi Sakamoto ++mixer_src_ch; 163dc36a975STakashi Sakamoto parser->prev_mixer_src_type = msg_type; 164dc36a975STakashi Sakamoto 165dc36a975STakashi Sakamoto if (mixer_ch < SNDRV_FIREWIRE_MOTU_REGISTER_DSP_MIXER_COUNT && 166dc36a975STakashi Sakamoto mixer_src_ch < SNDRV_FIREWIRE_MOTU_REGISTER_DSP_MIXER_SRC_COUNT) { 167dc36a975STakashi Sakamoto u8 mixer_ch = parser->mixer_ch; 168dc36a975STakashi Sakamoto 169dc36a975STakashi Sakamoto switch (msg_type) { 170dc36a975STakashi Sakamoto case MIXER_SRC_GAIN: 171dc36a975STakashi Sakamoto param->mixer.source[mixer_ch].gain[mixer_src_ch] = val; 172dc36a975STakashi Sakamoto break; 173dc36a975STakashi Sakamoto case MIXER_SRC_PAN: 174dc36a975STakashi Sakamoto param->mixer.source[mixer_ch].pan[mixer_src_ch] = val; 175dc36a975STakashi Sakamoto break; 176dc36a975STakashi Sakamoto case MIXER_SRC_FLAG: 177dc36a975STakashi Sakamoto param->mixer.source[mixer_ch].flag[mixer_src_ch] = val; 178dc36a975STakashi Sakamoto break; 179dc36a975STakashi Sakamoto case MIXER_SRC_PAIRED_BALANCE: 180dc36a975STakashi Sakamoto param->mixer.source[mixer_ch].paired_balance[mixer_src_ch] = val; 181dc36a975STakashi Sakamoto break; 182dc36a975STakashi Sakamoto case MIXER_SRC_PAIRED_WIDTH: 183dc36a975STakashi Sakamoto param->mixer.source[mixer_ch].paired_width[mixer_src_ch] = val; 184dc36a975STakashi Sakamoto break; 185dc36a975STakashi Sakamoto default: 186dc36a975STakashi Sakamoto break; 187dc36a975STakashi Sakamoto } 188dc36a975STakashi Sakamoto 189dc36a975STakashi Sakamoto parser->mixer_src_ch = mixer_src_ch; 190dc36a975STakashi Sakamoto } 191dc36a975STakashi Sakamoto break; 192dc36a975STakashi Sakamoto } 193*ce69bed5STakashi Sakamoto case MIXER_OUTPUT_PAIRED_VOLUME: 194*ce69bed5STakashi Sakamoto case MIXER_OUTPUT_PAIRED_FLAG: 195*ce69bed5STakashi Sakamoto { 196*ce69bed5STakashi Sakamoto struct snd_firewire_motu_register_dsp_parameter *param = &parser->param; 197*ce69bed5STakashi Sakamoto u8 mixer_ch = parser->mixer_ch; 198*ce69bed5STakashi Sakamoto 199*ce69bed5STakashi Sakamoto if (mixer_ch < SNDRV_FIREWIRE_MOTU_REGISTER_DSP_MIXER_COUNT) { 200*ce69bed5STakashi Sakamoto switch (msg_type) { 201*ce69bed5STakashi Sakamoto case MIXER_OUTPUT_PAIRED_VOLUME: 202*ce69bed5STakashi Sakamoto param->mixer.output.paired_volume[mixer_ch] = val; 203*ce69bed5STakashi Sakamoto break; 204*ce69bed5STakashi Sakamoto case MIXER_OUTPUT_PAIRED_FLAG: 205*ce69bed5STakashi Sakamoto param->mixer.output.paired_flag[mixer_ch] = val; 206*ce69bed5STakashi Sakamoto break; 207*ce69bed5STakashi Sakamoto default: 208*ce69bed5STakashi Sakamoto break; 209*ce69bed5STakashi Sakamoto } 210*ce69bed5STakashi Sakamoto } 211*ce69bed5STakashi Sakamoto break; 212*ce69bed5STakashi Sakamoto } 213bea36afaSTakashi Sakamoto case METER: 214bea36afaSTakashi Sakamoto { 215bea36afaSTakashi Sakamoto u8 pos; 216bea36afaSTakashi Sakamoto 217bea36afaSTakashi Sakamoto if (!meter_pos_quirk) 218bea36afaSTakashi Sakamoto pos = b[MSG_METER_IDX_POS]; 219bea36afaSTakashi Sakamoto else 220bea36afaSTakashi Sakamoto pos = b[MSG_METER_IDX_POS_4PRE_AE]; 221bea36afaSTakashi Sakamoto 222bea36afaSTakashi Sakamoto if (pos < 0x80) 223bea36afaSTakashi Sakamoto pos &= 0x1f; 224bea36afaSTakashi Sakamoto else 225bea36afaSTakashi Sakamoto pos = (pos & 0x1f) + 20; 226bea36afaSTakashi Sakamoto parser->meter.data[pos] = val; 227bea36afaSTakashi Sakamoto break; 228bea36afaSTakashi Sakamoto } 229bea36afaSTakashi Sakamoto default: 230bea36afaSTakashi Sakamoto break; 231bea36afaSTakashi Sakamoto } 232bea36afaSTakashi Sakamoto } 233bea36afaSTakashi Sakamoto } 23458b62ab7STakashi Sakamoto 23558b62ab7STakashi Sakamoto spin_unlock_irqrestore(&parser->lock, flags); 23658b62ab7STakashi Sakamoto } 23758b62ab7STakashi Sakamoto 23858b62ab7STakashi Sakamoto void snd_motu_register_dsp_message_parser_copy_meter(struct snd_motu *motu, 23958b62ab7STakashi Sakamoto struct snd_firewire_motu_register_dsp_meter *meter) 24058b62ab7STakashi Sakamoto { 24158b62ab7STakashi Sakamoto struct msg_parser *parser = motu->message_parser; 24258b62ab7STakashi Sakamoto unsigned long flags; 24358b62ab7STakashi Sakamoto 24458b62ab7STakashi Sakamoto spin_lock_irqsave(&parser->lock, flags); 24558b62ab7STakashi Sakamoto memcpy(meter, &parser->meter, sizeof(*meter)); 24658b62ab7STakashi Sakamoto spin_unlock_irqrestore(&parser->lock, flags); 247bea36afaSTakashi Sakamoto } 248