ALSA: UMP RPN/NRPN conversion fixes
cover ALSA: UMP RPN/NRPN conversion fixes
There are a few minor issues about RPN/NRPN message conversions between MIDI1 and MIDI2 when some incomplete messages are sent. This patch set addresses the issue. It also cleans up the data type shared by both UMP core and sequencer UMP conversion.
Takashi
===
Takashi Iwai (5):
ALSA: ump: Transmit RPN/NRPN message at each MSB/LSB data reception
ALSA: ump: Explicitly reset RPN with Null RPN
ALSA: seq: ump: Use the common RPN/bank conversion context
ALSA: seq: ump: Transmit RPN/NRPN message at each MSB/LSB data
reception
ALSA: seq: ump: Explicitly reset RPN with Null RPN
include/sound/ump_convert.h | 1 + sound/core/seq/seq_ports.h | 14 +---- sound/core/seq/seq_ump_convert.c | 97 ++++++++++++++++++++------------ sound/core/ump_convert.c | 60 ++++++++++++++------ 4 files changed, 106 insertions(+), 66 deletions(-)
Signature · 1 line
2.43.0
PATCH 1/5 ALSA: ump: Transmit RPN/NRPN message at each MSB/LSB data reception
The UMP 1.1 spec says that an RPN/NRPN should be sent when one of the following occurs:
* a CC 38 is received
* a subsequent CC 6 is received
* a CC 98, 99, 100, and 101 is received, indicating the last RPN/NRPN message has ended and a new one has started
That said, we should send a partial data even if it's not fully filled. Let's change the UMP conversion helper code to follow that rule.
--- include/sound/ump_convert.h | 1 + sound/core/ump_convert.c | 49 ++++++++++++++++++++++++------------- 2 files changed, 33 insertions(+), 17 deletions(-)
include/sound/ump_convert.h +1 -0
@@ -13,6 +13,7 @@ struct ump_cvt_to_ump_bank {unsigned char cc_nrpn_msb, cc_nrpn_lsb;unsigned char cc_data_msb, cc_data_lsb;unsigned char cc_bank_msb, cc_bank_lsb; +bool cc_data_msb_set, cc_data_lsb_set; };/* context for converting from MIDI1 byte stream to UMP packet */
sound/core/ump_convert.c +32 -17
99 lines not on this page · raw message
Signature · 1 line
2.43.0
PATCH 2/5 ALSA: ump: Explicitly reset RPN with Null RPN
In reply to Takashi IwaiRPN with 127:127 is treated as a Null RPN, just to reset the parameters, and it's not translated to MIDI2. Although the current code can work as is in most cases, better to implement the RPN reset explicitly for Null message.
--- sound/core/ump_convert.c | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-)
sound/core/ump_convert.c +14 -5
@@ -287,6 +287,15 @@ static int cvt_legacy_system_to_ump(struct ump_cvt_to_ump *cvt,return 4 ; } +static void reset_rpn (struct ump_cvt_to_ump_bank *cc) +{ + cc->rpn_set =0 ; + cc->nrpn_set =0 ; + cc->cc_rpn_msb = cc->cc_rpn_lsb =0 ; + cc->cc_data_msb = cc->cc_data_lsb =0 ; + cc->cc_data_msb_set = cc->cc_data_lsb_set =0 ; +} +static int fill_rpn (struct ump_cvt_to_ump_bank *cc,union snd_ump_midi2_msg *midi2,bool flush)
@@ -312,11 +321,7 @@ static int fill_rpn(struct ump_cvt_to_ump_bank *cc, midi2->rpn.data =upscale_14_to_32bit ((cc->cc_data_msb <<7 ) | cc->cc_data_lsb); - cc->rpn_set =0 ; - cc->nrpn_set =0 ; - cc->cc_rpn_msb = cc->cc_rpn_lsb =0 ; - cc->cc_data_msb = cc->cc_data_lsb =0 ; - cc->cc_data_msb_set = cc->cc_data_lsb_set =0 ; +reset_rpn (cc);return 1 ; }
@@ -374,11 +379,15 @@ static int cvt_legacy_cmd_to_ump(struct ump_cvt_to_ump *cvt, ret =fill_rpn (cc, midi2, true); cc->rpn_set =1 ; cc->cc_rpn_msb = buf[2 ]; +if (cc->cc_rpn_msb ==0x7f && cc->cc_rpn_lsb ==0x7f ) +reset_rpn (cc);return ret;case UMP_CC_RPN_LSB : ret =fill_rpn (cc, midi2, true); cc->rpn_set =1 ; cc->cc_rpn_lsb = buf[2 ]; +if (cc->cc_rpn_msb ==0x7f && cc->cc_rpn_lsb ==0x7f ) +reset_rpn (cc);return ret;case UMP_CC_NRPN_MSB : ret =fill_rpn (cc, midi2, true);
Signature · 1 line
2.43.0
PATCH 3/5 ALSA: seq: ump: Use the common RPN/bank conversion context
In reply to Takashi IwaiThe UMP core conversion helper API already defines the context needed to record the bank and RPN/NRPN values, and we can simply re-use the same struct instead of re-defining the same content as a different name.
--- sound/core/seq/seq_ports.h | 14 ++------------ sound/core/seq/seq_ump_convert.c | 10 +++++----- 2 files changed, 7 insertions(+), 17 deletions(-)
sound/core/seq/seq_ports.h +2 -12
@@ -7,6 +7,7 @@#define __SND_SEQ_PORTS_H#include <sound/seq_kernel.h> +#include <sound/ump_convert.h> #include "seq_lock.h" /* list of 'exported' ports */
@@ -42,17 +43,6 @@ struct snd_seq_port_subs_info {int (*close)(void *private_data,struct snd_seq_port_subscribe *info); }; -/* context for converting from legacy control event to UMP packet */ -struct snd_seq_ump_midi2_bank { -bool rpn_set; -bool nrpn_set; -bool bank_set; -unsigned char cc_rpn_msb, cc_rpn_lsb; -unsigned char cc_nrpn_msb, cc_nrpn_lsb; -unsigned char cc_data_msb, cc_data_lsb; -unsigned char cc_bank_msb, cc_bank_lsb; -}; -struct snd_seq_client_port {struct snd_seq_addr addr;/* client/port number */
@@ -88,7 +78,7 @@ struct snd_seq_client_port {unsigned char ump_group;#if IS_ENABLED (CONFIG_SND_SEQ_UMP ) -struct snd_seq_ump_midi2_bank midi2_bank[16 ];/* per channel */ +struct ump_cvt_to_ump_bank midi2_bank[16 ];/* per channel */ #endif };
sound/core/seq/seq_ump_convert.c +5 -5
@@ -368,7 +368,7 @@ static int cvt_ump_midi1_to_midi2(struct snd_seq_client *dest,struct snd_seq_ump_event ev_cvt;const union snd_ump_midi1_msg *midi1 = (const union snd_ump_midi1_msg *)event->ump;union snd_ump_midi2_msg *midi2 = (union snd_ump_midi2_msg *)ev_cvt.ump; -struct snd_seq_ump_midi2_bank *cc; +struct ump_cvt_to_ump_bank *cc; ev_cvt = *event;memset (&ev_cvt.ump,0 ,sizeof (ev_cvt.ump));
@@ -790,7 +790,7 @@ static int paf_ev_to_ump_midi2(const struct snd_seq_event *event, }/* set up the MIDI2 RPN/NRPN packet data from the parsed info */ -static void fill_rpn (struct snd_seq_ump_midi2_bank *cc, +static void fill_rpn (struct ump_cvt_to_ump_bank *cc,union snd_ump_midi2_msg *data,unsigned char channel) {
@@ -822,7 +822,7 @@ static int cc_ev_to_ump_midi2(const struct snd_seq_event *event,unsigned char channel = event->data.control.channel &0x0f ;unsigned char index = event->data.control.param &0x7f ;unsigned char val = event->data.control.value &0x7f ; -struct snd_seq_ump_midi2_bank *cc = &dest_port->midi2_bank[channel]; +struct ump_cvt_to_ump_bank *cc = &dest_port->midi2_bank[channel];/* process special CC's (bank/rpn/nrpn) */ switch (index) {
@@ -887,7 +887,7 @@ static int pgm_ev_to_ump_midi2(const struct snd_seq_event *event, unsigned char status) {unsigned char channel = event->data.control.channel &0x0f ; -struct snd_seq_ump_midi2_bank *cc = &dest_port->midi2_bank[channel]; +struct ump_cvt_to_ump_bank *cc = &dest_port->midi2_bank[channel]; data->pg.status = status; data->pg.channel = channel;
@@ -924,7 +924,7 @@ static int ctrl14_ev_to_ump_midi2(const struct snd_seq_event *event, {unsigned char channel = event->data.control.channel &0x0f ;unsigned char index = event->data.control.param &0x7f ; -struct snd_seq_ump_midi2_bank *cc = &dest_port->midi2_bank[channel]; +struct ump_cvt_to_ump_bank *cc = &dest_port->midi2_bank[channel];unsigned char msb, lsb; msb = (event->data.control.value >>7 ) &0x7f ;
Signature · 1 line
2.43.0
PATCH 4/5 ALSA: seq: ump: Transmit RPN/NRPN message at each MSB/LSB data reception
In reply to Takashi IwaiJust like the core UMP conversion helper, we need to deal with the partially-filled RPN/NRPN data in the sequencer UMP converter as well.
--- sound/core/seq/seq_ump_convert.c | 74 +++++++++++++++++++------------- 1 file changed, 44 insertions(+), 30 deletions(-)
sound/core/seq/seq_ump_convert.c +44 -30
@@ -790,27 +790,39 @@ static int paf_ev_to_ump_midi2(const struct snd_seq_event *event, }/* set up the MIDI2 RPN/NRPN packet data from the parsed info */ -static void fill_rpn (struct ump_cvt_to_ump_bank *cc, -union snd_ump_midi2_msg *data, -unsigned char channel) +static int fill_rpn (struct ump_cvt_to_ump_bank *cc, +union snd_ump_midi2_msg *data, +unsigned char channel, +bool flush) { +if (!(cc->cc_data_lsb_set || cc->cc_data_msb_set)) +return 0 ;// skip +/* when not flushing, wait for complete data set */ +if (!flush && (!cc->cc_data_lsb_set || !cc->cc_data_msb_set)) +return 0 ;// skip +if (cc->rpn_set) { data->rpn.status =UMP_MSG_STATUS_RPN ; data->rpn.bank = cc->cc_rpn_msb; data->rpn.index = cc->cc_rpn_lsb; - cc->rpn_set =0 ; - cc->cc_rpn_msb = cc->cc_rpn_lsb =0 ; - }else { + }else if (cc->nrpn_set) { data->rpn.status =UMP_MSG_STATUS_NRPN ; data->rpn.bank = cc->cc_nrpn_msb; data->rpn.index = cc->cc_nrpn_lsb; - cc->nrpn_set =0 ; - cc->cc_nrpn_msb = cc->cc_nrpn_lsb =0 ; + }else { +return 0 ;// skip } + data->rpn.data =upscale_14_to_32bit ((cc->cc_data_msb <<7 ) | cc->cc_data_lsb); data->rpn.channel = channel; + + cc->rpn_set =0 ; + cc->nrpn_set =0 ; + cc->cc_rpn_msb = cc->cc_rpn_lsb =0 ; cc->cc_data_msb = cc->cc_data_lsb =0 ; + cc->cc_data_msb_set = cc->cc_data_lsb_set =0 ; +return 1 ; }/* convert CC event to MIDI 2.0 UMP */
@@ -823,28 +835,34 @@ static int cc_ev_to_ump_midi2(const struct snd_seq_event *event,unsigned char index = event->data.control.param &0x7f ;unsigned char val = event->data.control.value &0x7f ;struct ump_cvt_to_ump_bank *cc = &dest_port->midi2_bank[channel]; +int ret;/* process special CC's (bank/rpn/nrpn) */ switch (index) {case UMP_CC_RPN_MSB : + ret =fill_rpn (cc, data, channel, true); cc->rpn_set =1 ; cc->cc_rpn_msb = val; -return 0 ;// skip +return ret;case UMP_CC_RPN_LSB : + ret =fill_rpn (cc, data, channel, true); cc->rpn_set =1 ; cc->cc_rpn_lsb = val; -return 0 ;// skip +return ret;case UMP_CC_NRPN_MSB : + ret =fill_rpn (cc, data, channel, true); cc->nrpn_set =1 ; cc->cc_nrpn_msb = val; -return 0 ;// skip +return ret;case UMP_CC_NRPN_LSB : + ret =fill_rpn (cc, data, channel, true); cc->nrpn_set =1 ; cc->cc_nrpn_lsb = val; -return 0 ;// skip +return ret;case UMP_CC_DATA : + cc->cc_data_msb_set =1 ; cc->cc_data_msb = val; -return 0 ;// skip +return fill_rpn (cc, data, channel, false);case UMP_CC_BANK_SELECT : cc->bank_set =1 ; cc->cc_bank_msb = val;
@@ -854,11 +872,9 @@ static int cc_ev_to_ump_midi2(const struct snd_seq_event *event, cc->cc_bank_lsb = val;return 0 ;// skip case UMP_CC_DATA_LSB : + cc->cc_data_lsb_set =1 ; cc->cc_data_lsb = val; -if (!(cc->rpn_set || cc->nrpn_set)) -return 0 ;// skip -fill_rpn (cc, data, channel); -return 1 ; +return fill_rpn (cc, data, channel, false); } data->cc.status = status;
@@ -926,6 +942,7 @@ static int ctrl14_ev_to_ump_midi2(const struct snd_seq_event *event,unsigned char index = event->data.control.param &0x7f ;struct ump_cvt_to_ump_bank *cc = &dest_port->midi2_bank[channel];unsigned char msb, lsb; +int ret; msb = (event->data.control.value >>7 ) &0x7f ; lsb = event->data.control.value &0x7f ;
@@ -939,28 +956,25 @@ static int ctrl14_ev_to_ump_midi2(const struct snd_seq_event *event, cc->cc_bank_lsb = lsb;return 0 ;// skip case UMP_CC_RPN_MSB : - cc->cc_rpn_msb = msb; - fallthrough;case UMP_CC_RPN_LSB : - cc->rpn_set =1 ; + ret =fill_rpn (cc, data, channel, true); + cc->cc_rpn_msb = msb; cc->cc_rpn_lsb = lsb; -return 0 ;// skip + cc->rpn_set =1 ; +return ret;case UMP_CC_NRPN_MSB : - cc->cc_nrpn_msb = msb; - fallthrough;case UMP_CC_NRPN_LSB : + ret =fill_rpn (cc, data, channel, true); + cc->cc_nrpn_msb = msb; cc->nrpn_set =1 ; cc->cc_nrpn_lsb = lsb; -return 0 ;// skip +return ret;case UMP_CC_DATA : - cc->cc_data_msb = msb; - fallthrough;case UMP_CC_DATA_LSB : + cc->cc_data_msb_set = cc->cc_data_lsb_set =1 ; + cc->cc_data_msb = msb; cc->cc_data_lsb = lsb; -if (!(cc->rpn_set || cc->nrpn_set)) -return 0 ;// skip -fill_rpn (cc, data, channel); -return 1 ; +return fill_rpn (cc, data, channel, false); } data->cc.status =UMP_MSG_STATUS_CC ;
Signature · 1 line
2.43.0
PATCH 5/5 ALSA: seq: ump: Explicitly reset RPN with Null RPN
In reply to Takashi IwaiRPN with 127:127 is treated as a Null RPN, just to reset the parameters, and it's not translated to MIDI2. Although the current code can work as is in most cases, better to implement the RPN reset explicitly for Null message.
--- sound/core/seq/seq_ump_convert.c | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-)
sound/core/seq/seq_ump_convert.c +16 -5
@@ -789,6 +789,15 @@ static int paf_ev_to_ump_midi2(const struct snd_seq_event *event,return 1 ; } +static void reset_rpn (struct ump_cvt_to_ump_bank *cc) +{ + cc->rpn_set =0 ; + cc->nrpn_set =0 ; + cc->cc_rpn_msb = cc->cc_rpn_lsb =0 ; + cc->cc_data_msb = cc->cc_data_lsb =0 ; + cc->cc_data_msb_set = cc->cc_data_lsb_set =0 ; +} +/* set up the MIDI2 RPN/NRPN packet data from the parsed info */ static int fill_rpn(struct ump_cvt_to_ump_bank *cc, union snd_ump_midi2_msg *data,
@@ -817,11 +826,7 @@ static int fill_rpn(struct ump_cvt_to_ump_bank *cc, cc->cc_data_lsb); data->rpn.channel = channel; - cc->rpn_set =0 ; - cc->nrpn_set =0 ; - cc->cc_rpn_msb = cc->cc_rpn_lsb =0 ; - cc->cc_data_msb = cc->cc_data_lsb =0 ; - cc->cc_data_msb_set = cc->cc_data_lsb_set =0 ; +reset_rpn (cc);return 1 ; }
@@ -843,11 +848,15 @@ static int cc_ev_to_ump_midi2(const struct snd_seq_event *event, ret =fill_rpn (cc, data, channel, true); cc->rpn_set =1 ; cc->cc_rpn_msb = val; +if (cc->cc_rpn_msb ==0x7f && cc->cc_rpn_lsb ==0x7f ) +reset_rpn (cc);return ret;case UMP_CC_RPN_LSB : ret =fill_rpn (cc, data, channel, true); cc->rpn_set =1 ; cc->cc_rpn_lsb = val; +if (cc->cc_rpn_msb ==0x7f && cc->cc_rpn_lsb ==0x7f ) +reset_rpn (cc);return ret;case UMP_CC_NRPN_MSB : ret =fill_rpn (cc, data, channel, true);
@@ -961,6 +970,8 @@ static int ctrl14_ev_to_ump_midi2(const struct snd_seq_event *event, cc->cc_rpn_msb = msb; cc->cc_rpn_lsb = lsb; cc->rpn_set =1 ; +if (cc->cc_rpn_msb ==0x7f && cc->cc_rpn_lsb ==0x7f ) +reset_rpn (cc);return ret;case UMP_CC_NRPN_MSB :case UMP_CC_NRPN_LSB :
Signature · 1 line
2.43.0