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 { 82*58b62ab7STakashi Sakamoto spinlock_t lock; 83bea36afaSTakashi Sakamoto struct snd_firewire_motu_register_dsp_meter meter; 84bea36afaSTakashi Sakamoto bool meter_pos_quirk; 85bea36afaSTakashi Sakamoto }; 86bea36afaSTakashi Sakamoto 87bea36afaSTakashi Sakamoto int snd_motu_register_dsp_message_parser_new(struct snd_motu *motu) 88bea36afaSTakashi Sakamoto { 89bea36afaSTakashi Sakamoto struct msg_parser *parser; 90bea36afaSTakashi Sakamoto parser = devm_kzalloc(&motu->card->card_dev, sizeof(*parser), GFP_KERNEL); 91bea36afaSTakashi Sakamoto if (!parser) 92bea36afaSTakashi Sakamoto return -ENOMEM; 93*58b62ab7STakashi Sakamoto spin_lock_init(&parser->lock); 94bea36afaSTakashi Sakamoto if (motu->spec == &snd_motu_spec_4pre || motu->spec == &snd_motu_spec_audio_express) 95bea36afaSTakashi Sakamoto parser->meter_pos_quirk = true; 96bea36afaSTakashi Sakamoto motu->message_parser = parser; 97bea36afaSTakashi Sakamoto return 0; 98bea36afaSTakashi Sakamoto } 99bea36afaSTakashi Sakamoto 100bea36afaSTakashi Sakamoto int snd_motu_register_dsp_message_parser_init(struct snd_motu *motu) 101bea36afaSTakashi Sakamoto { 102bea36afaSTakashi Sakamoto return 0; 103bea36afaSTakashi Sakamoto } 104bea36afaSTakashi Sakamoto 105bea36afaSTakashi Sakamoto void snd_motu_register_dsp_message_parser_parse(struct snd_motu *motu, const struct pkt_desc *descs, 106bea36afaSTakashi Sakamoto unsigned int desc_count, unsigned int data_block_quadlets) 107bea36afaSTakashi Sakamoto { 108bea36afaSTakashi Sakamoto struct msg_parser *parser = motu->message_parser; 109bea36afaSTakashi Sakamoto bool meter_pos_quirk = parser->meter_pos_quirk; 110*58b62ab7STakashi Sakamoto unsigned long flags; 111bea36afaSTakashi Sakamoto int i; 112bea36afaSTakashi Sakamoto 113*58b62ab7STakashi Sakamoto spin_lock_irqsave(&parser->lock, flags); 114*58b62ab7STakashi Sakamoto 115bea36afaSTakashi Sakamoto for (i = 0; i < desc_count; ++i) { 116bea36afaSTakashi Sakamoto const struct pkt_desc *desc = descs + i; 117bea36afaSTakashi Sakamoto __be32 *buffer = desc->ctx_payload; 118bea36afaSTakashi Sakamoto unsigned int data_blocks = desc->data_blocks; 119bea36afaSTakashi Sakamoto int j; 120bea36afaSTakashi Sakamoto 121bea36afaSTakashi Sakamoto for (j = 0; j < data_blocks; ++j) { 122bea36afaSTakashi Sakamoto u8 *b = (u8 *)buffer; 123bea36afaSTakashi Sakamoto u8 msg_type = (b[MSG_FLAG_POS] & MSG_FLAG_TYPE_MASK) >> MSG_FLAG_TYPE_SHIFT; 124bea36afaSTakashi Sakamoto u8 val = b[MSG_VALUE_POS]; 125bea36afaSTakashi Sakamoto 126bea36afaSTakashi Sakamoto buffer += data_block_quadlets; 127bea36afaSTakashi Sakamoto 128bea36afaSTakashi Sakamoto switch (msg_type) { 129bea36afaSTakashi Sakamoto case METER: 130bea36afaSTakashi Sakamoto { 131bea36afaSTakashi Sakamoto u8 pos; 132bea36afaSTakashi Sakamoto 133bea36afaSTakashi Sakamoto if (!meter_pos_quirk) 134bea36afaSTakashi Sakamoto pos = b[MSG_METER_IDX_POS]; 135bea36afaSTakashi Sakamoto else 136bea36afaSTakashi Sakamoto pos = b[MSG_METER_IDX_POS_4PRE_AE]; 137bea36afaSTakashi Sakamoto 138bea36afaSTakashi Sakamoto if (pos < 0x80) 139bea36afaSTakashi Sakamoto pos &= 0x1f; 140bea36afaSTakashi Sakamoto else 141bea36afaSTakashi Sakamoto pos = (pos & 0x1f) + 20; 142bea36afaSTakashi Sakamoto parser->meter.data[pos] = val; 143bea36afaSTakashi Sakamoto break; 144bea36afaSTakashi Sakamoto } 145bea36afaSTakashi Sakamoto default: 146bea36afaSTakashi Sakamoto break; 147bea36afaSTakashi Sakamoto } 148bea36afaSTakashi Sakamoto } 149bea36afaSTakashi Sakamoto } 150*58b62ab7STakashi Sakamoto 151*58b62ab7STakashi Sakamoto spin_unlock_irqrestore(&parser->lock, flags); 152*58b62ab7STakashi Sakamoto } 153*58b62ab7STakashi Sakamoto 154*58b62ab7STakashi Sakamoto void snd_motu_register_dsp_message_parser_copy_meter(struct snd_motu *motu, 155*58b62ab7STakashi Sakamoto struct snd_firewire_motu_register_dsp_meter *meter) 156*58b62ab7STakashi Sakamoto { 157*58b62ab7STakashi Sakamoto struct msg_parser *parser = motu->message_parser; 158*58b62ab7STakashi Sakamoto unsigned long flags; 159*58b62ab7STakashi Sakamoto 160*58b62ab7STakashi Sakamoto spin_lock_irqsave(&parser->lock, flags); 161*58b62ab7STakashi Sakamoto memcpy(meter, &parser->meter, sizeof(*meter)); 162*58b62ab7STakashi Sakamoto spin_unlock_irqrestore(&parser->lock, flags); 163bea36afaSTakashi Sakamoto } 164