jdxi_editor.midi.io.utils

utility functions

Functions

format_midi_message_to_hex_string(→ str)

Convert a list of MIDI byte values to a space-separated hex string.

increment_if_lsb_exceeds_7bit(→ int)

Increments the MSB if the LSB exceeds 7-bit maximum (127).

nibble_data(→ list[int])

Ensures all values in the data list are 7-bit safe (0–127).

rtmidi_to_mido(→ Union[bool, mido.Message])

Convert an rtmidi message to address mido message.

convert_to_mido_message(→ Optional[Union[mido.Message, ...)

Convert raw MIDI message content to a mido.Message object or a list of them.

mido_message_data_to_byte_list(→ bytes)

mido message data to byte list

handle_identity_request(→ dict)

Handles an incoming Identity Request/Reply message.

Module Contents

jdxi_editor.midi.io.utils.format_midi_message_to_hex_string(message: Iterable[int]) str[source]

Convert a list of MIDI byte values to a space-separated hex string.

Parameters:

message – Iterable[int]

Returns:

str A string like “F0 41 10 00 00 00 0E … F7”

jdxi_editor.midi.io.utils.increment_if_lsb_exceeds_7bit(msb: int, lsb: int) int[source]

Increments the MSB if the LSB exceeds 7-bit maximum (127).

Parameters:
  • msb – Most significant byte (int)

  • lsb – Least significant byte (int)

Returns:

Adjusted MSB (int)

jdxi_editor.midi.io.utils.nibble_data(data: list[int]) list[int][source]

Ensures all values in the data list are 7-bit safe (0–127). Bytes > 127 are split into two 4-bit nibbles. :param data: List of integer byte values (0–255) :return: List of 7-bit-safe integers (0–127)

jdxi_editor.midi.io.utils.rtmidi_to_mido(byte_message: bytes) bool | mido.Message[source]

Convert an rtmidi message to address mido message.

Parameters:

byte_message – bytes

Returns:

Union[bool, mido.Message]: mido message on success or False otherwise

jdxi_editor.midi.io.utils.convert_to_mido_message(message_content: List[int]) mido.Message | List[mido.Message] | None[source]

Convert raw MIDI message content to a mido.Message object or a list of them.

Deprecated since version This: function is deprecated. Use JDXiSysExParser.convert_to_mido_message() instead. This function is kept for backward compatibility and delegates to the parser.

Parameters:

message_content – List[int] byte list

Returns:

Optional[Union[mido.Message, List[mido.Message]]] either a single mido message or a list of mido messages

jdxi_editor.midi.io.utils.mido_message_data_to_byte_list(message: mido.Message) bytes[source]

mido message data to byte list

Parameters:

message – mido.Message

Returns:

bytes

jdxi_editor.midi.io.utils.handle_identity_request(message: mido.Message) dict[source]

Handles an incoming Identity Request/Reply message.

Deprecated since version This: function is deprecated. Use JDXiSysExParser.parse_identity_request() instead. This function is kept for backward compatibility and delegates to the parser.

Parameters:

message – mido.Message incoming response to identity request

Returns:

dict device details