MIDI: Add support for MIDI 2.0 I/O using Universal MIDI Packets

Includes support for communication with USB and Bluetooth devices, as well as virtual devices.

modules/juce_audio_devices/native/javaopt/app/com/rmsl/juce/VirtualMidiServices.java

@@ -0,0 +1,181 @@
+/*
+  ==============================================================================
+
+   This file is part of the JUCE framework.
+   Copyright (c) Raw Material Software Limited
+
+   JUCE is an open source framework subject to commercial or open source
+   licensing.
+
+   By downloading, installing, or using the JUCE framework, or combining the
+   JUCE framework with any other source code, object code, content or any other
+   copyrightable work, you agree to the terms of the JUCE End User Licence
+   Agreement, and all incorporated terms including the JUCE Privacy Policy and
+   the JUCE Website Terms of Service, as applicable, which will bind you. If you
+   do not agree to the terms of these agreements, we will not license the JUCE
+   framework to you, and you must discontinue the installation or download
+   process and cease use of the JUCE framework.
+
+   JUCE End User Licence Agreement: https://juce.com/legal/juce-8-licence/
+   JUCE Privacy Policy: https://juce.com/juce-privacy-policy
+   JUCE Website Terms of Service: https://juce.com/juce-website-terms-of-service/
+
+   Or:
+
+   You may also use this code under the terms of the AGPLv3:
+   https://www.gnu.org/licenses/agpl-3.0.en.html
+
+   THE JUCE FRAMEWORK IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL
+   WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING WARRANTY OF
+   MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, ARE DISCLAIMED.
+
+  ==============================================================================
+*/
+
+package com.rmsl.juce;
+
+
+import static android.content.pm.PackageManager.COMPONENT_ENABLED_STATE_DISABLED;
+import static android.content.pm.PackageManager.COMPONENT_ENABLED_STATE_ENABLED;
+import static android.content.pm.PackageManager.DONT_KILL_APP;
+
+import android.annotation.TargetApi;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.media.midi.MidiDeviceService;
+import android.media.midi.MidiReceiver;
+import android.media.midi.MidiUmpDeviceService;
+import android.os.Build;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+
+public class VirtualMidiServices
+{
+    /** Argument is the receiver that should be sent outgoing messages.
+        The return value is a newly-created receiver that will receive incoming messages.
+    */
+    private static native MidiReceiver addVirtualPort (MidiReceiver output, boolean isUmp);
+
+    /** Argument is a receiver previously returned from addVirtualPort. */
+    private static native void removeVirtualPort (MidiReceiver output);
+
+    public static class VirtualPort extends MidiReceiver
+    {
+        @Override
+        public void onSend (byte[] msg, int offset, int count, long timestamp) throws IOException
+        {
+            if (onSend != null)
+                onSend.send (msg, offset, count, timestamp);
+        }
+
+        public MidiReceiver onSend;
+    }
+
+    public static class VirtualBytestreamService extends MidiDeviceService
+    {
+        @Override
+        public MidiReceiver[] onGetInputPortReceivers()
+        {
+            return new MidiReceiver[] { port };
+        }
+
+        @Override
+        public void onCreate()
+        {
+            super.onCreate();
+            MidiReceiver[] receivers = getOutputPortReceivers();
+            port.onSend = addVirtualPort (receivers != null && receivers.length > 0 ? receivers[0] : null, false);
+        }
+
+        @Override
+        public void onDestroy()
+        {
+            removeVirtualPort (port.onSend);
+            super.onDestroy();
+        }
+
+        private final VirtualPort port = new VirtualPort();
+    }
+
+    @TargetApi(Build.VERSION_CODES.VANILLA_ICE_CREAM)
+    public static class VirtualUmpService extends MidiUmpDeviceService
+    {
+        @Override
+        public List<MidiReceiver> onGetInputPortReceivers()
+        {
+            return Collections.singletonList (port);
+        }
+
+        @Override
+        public void onCreate()
+        {
+            super.onCreate();
+            List<MidiReceiver> receivers = getOutputPortReceivers();
+            port.onSend = addVirtualPort (! receivers.isEmpty() ? receivers.getFirst() : null, true);
+        }
+
+        @Override
+        public void onDestroy()
+        {
+            removeVirtualPort (port.onSend);
+            super.onDestroy();
+        }
+
+        private final VirtualPort port = new VirtualPort();
+    }
+
+    private static void setVirtualMidiServiceEnabled (Context context, Class<?> klass, boolean x)
+    {
+        PackageManager pm = context.getPackageManager();
+
+        if (pm == null)
+            return;
+
+        ComponentName componentName = new ComponentName (context, klass);
+
+        int desiredState = x ? COMPONENT_ENABLED_STATE_ENABLED : COMPONENT_ENABLED_STATE_DISABLED;
+        int actualState = pm.getComponentEnabledSetting (componentName);
+
+        if (desiredState == actualState)
+            return;
+
+        pm.setComponentEnabledSetting (componentName, desiredState, DONT_KILL_APP);
+    }
+
+    public static void setVirtualMidiBytestreamEnabled (Context context, boolean x)
+    {
+        setVirtualMidiServiceEnabled (context, VirtualBytestreamService.class, x);
+    }
+
+    public static void setVirtualMidiUmpEnabled (Context context, boolean x)
+    {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.VANILLA_ICE_CREAM)
+            setVirtualMidiServiceEnabled (context, VirtualUmpService.class, x);
+    }
+
+    private static boolean isServiceAvailable (Context context, Class k)
+    {
+        PackageManager packageManager = context.getPackageManager();
+        Intent intent = new Intent (context, k);
+        List services = packageManager.queryIntentServices (intent, PackageManager.MATCH_DEFAULT_ONLY);
+
+        return services != null && ! services.isEmpty();
+    }
+
+    public static boolean isVirtualBytestreamAvailable (Context context)
+    {
+        return isServiceAvailable (context, VirtualBytestreamService.class);
+    }
+
+    public static boolean isVirtualUmpAvailable (Context context)
+    {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.VANILLA_ICE_CREAM)
+            return false;
+
+        return isServiceAvailable (context, VirtualUmpService.class);
+    }
+}

modules/juce_audio_devices/native/juce_ALSA_weak_linux.h

@@ -0,0 +1,161 @@
+/*
+  ==============================================================================
+
+   This file is part of the JUCE framework.
+   Copyright (c) Raw Material Software Limited
+
+   JUCE is an open source framework subject to commercial or open source
+   licensing.
+
+   By downloading, installing, or using the JUCE framework, or combining the
+   JUCE framework with any other source code, object code, content or any other
+   copyrightable work, you agree to the terms of the JUCE End User Licence
+   Agreement, and all incorporated terms including the JUCE Privacy Policy and
+   the JUCE Website Terms of Service, as applicable, which will bind you. If you
+   do not agree to the terms of these agreements, we will not license the JUCE
+   framework to you, and you must discontinue the installation or download
+   process and cease use of the JUCE framework.
+
+   JUCE End User Licence Agreement: https://juce.com/legal/juce-8-licence/
+   JUCE Privacy Policy: https://juce.com/juce-privacy-policy
+   JUCE Website Terms of Service: https://juce.com/juce-website-terms-of-service/
+
+   Or:
+
+   You may also use this code under the terms of the AGPLv3:
+   https://www.gnu.org/licenses/agpl-3.0.en.html
+
+   THE JUCE FRAMEWORK IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL
+   WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING WARRANTY OF
+   MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, ARE DISCLAIMED.
+
+  ==============================================================================
+*/
+
+// This header holds definitions for ALSA symbols that are only present in newer library versions.
+// It also contains weak definitions for functions that are only present in newer library versions.
+// By requesting the functions to weak-link, it's possible to build UMP-aware programs on Linux
+// versions that don't have up-to-date copies of ALSA, and it's also possible to run software
+// built on older Linux platforms, even if that software was built on a more recent system.
+
+#if SND_LIB_VERSION < ((1 << 16) | (2 << 8) | 10)
+
+struct snd_seq_ump_event_t
+{
+    snd_seq_event_type_t type;
+    unsigned char flags;
+    unsigned char tag;
+    unsigned char queue;
+    snd_seq_timestamp_t time;
+    snd_seq_addr_t source;
+    snd_seq_addr_t dest;
+
+    union
+    {
+        decltype (snd_seq_event_t::data) data; // Older headers don't define snd_seq_event_data_t
+        unsigned int ump[4];
+    };
+};
+
+struct snd_ump_endpoint_info_t;
+struct snd_ump_block_info_t;
+
+#define snd_ump_block_info_alloca(ptr) __snd_alloca (ptr, snd_ump_block_info)
+#define snd_ump_endpoint_info_alloca(ptr) __snd_alloca (ptr, snd_ump_endpoint_info)
+
+constexpr auto SND_SEQ_CLIENT_LEGACY_MIDI = 0;
+constexpr auto SND_SEQ_CLIENT_UMP_MIDI_1_0 = 1;
+constexpr auto SND_SEQ_CLIENT_UMP_MIDI_2_0 = 2;
+
+constexpr auto SND_UMP_EP_INFO_STATIC_BLOCKS = 0x1;
+constexpr auto SND_UMP_EP_INFO_PROTO_MIDI1 = 0x100;
+constexpr auto SND_UMP_EP_INFO_PROTO_MIDI2 = 0x200;
+
+constexpr auto SND_SEQ_PORT_CAP_INACTIVE = 1 << 8;
+
+constexpr auto SND_SEQ_EVENT_UMP = 1 << 5;
+
+constexpr auto SND_SEQ_PORT_DIR_INPUT = 1;
+constexpr auto SND_SEQ_PORT_DIR_OUTPUT = 2;
+constexpr auto SND_SEQ_PORT_DIR_BIDIRECTION = 3;
+
+constexpr auto SND_UMP_BLOCK_UI_HINT_UNKNOWN = 0;
+constexpr auto SND_UMP_BLOCK_UI_HINT_RECEIVER = 1;
+constexpr auto SND_UMP_BLOCK_UI_HINT_SENDER = 2;
+constexpr auto SND_UMP_BLOCK_UI_HINT_BOTH = 3;
+
+constexpr auto SND_UMP_BLOCK_IS_MIDI1 = 1U << 0;
+constexpr auto SND_UMP_BLOCK_IS_LOWSPEED = 1U << 1;
+
+constexpr auto SND_UMP_DIR_INPUT = 1;
+constexpr auto SND_UMP_DIR_OUTPUT = 2;
+constexpr auto SND_UMP_DIR_BIDIRECTION = 3;
+
+constexpr auto SND_UMP_EP_INFO_PROTO_JRTS_TX = 1;
+constexpr auto SND_UMP_EP_INFO_PROTO_JRTS_RX = 2;
+#endif
+
+JUCE_BEGIN_IGNORE_WARNINGS_GCC_LIKE ("-Wredundant-decls")
+
+extern "C"
+{
+    [[gnu::weak]] int snd_seq_client_info_get_midi_version (const snd_seq_client_info_t*);
+    [[gnu::weak]] int snd_seq_set_client_midi_version (snd_seq_t*, int);
+    [[gnu::weak]] int snd_seq_set_client_ump_conversion (snd_seq_t*, int);
+    [[gnu::weak]] int snd_seq_ump_event_input (snd_seq_t*, snd_seq_ump_event_t**);
+    [[gnu::weak]] int snd_seq_ump_event_output_direct (snd_seq_t*, snd_seq_ump_event_t*);
+    [[gnu::weak]] int snd_seq_port_info_get_ump_is_midi1 (const snd_seq_port_info_t*);
+    [[gnu::weak]] int snd_seq_port_info_get_ump_group (const snd_seq_port_info_t*);
+    [[gnu::weak]] int snd_seq_create_ump_endpoint (snd_seq_t*, const snd_ump_endpoint_info_t*, unsigned int);
+    [[gnu::weak]] int snd_seq_create_ump_block (snd_seq_t*, int, const snd_ump_block_info_t*);
+    [[gnu::weak]] int snd_seq_set_ump_block_info (snd_seq_t*, int, const void*);
+    [[gnu::weak]] int snd_seq_get_ump_block_info (snd_seq_t*, int, int, void*);
+    [[gnu::weak]] int snd_seq_get_ump_endpoint_info (snd_seq_t*, int, void*);
+
+    [[gnu::weak]] const char* snd_ump_endpoint_info_get_product_id (const snd_ump_endpoint_info_t*);
+    [[gnu::weak]] const unsigned char* snd_ump_endpoint_info_get_sw_revision (const snd_ump_endpoint_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_endpoint_info_get_family_id (const snd_ump_endpoint_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_endpoint_info_get_flags (const snd_ump_endpoint_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_endpoint_info_get_manufacturer_id (const snd_ump_endpoint_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_endpoint_info_get_model_id (const snd_ump_endpoint_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_endpoint_info_get_num_blocks (const snd_ump_endpoint_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_endpoint_info_get_protocol (const snd_ump_endpoint_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_endpoint_info_get_protocol_caps (const snd_ump_endpoint_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_endpoint_info_get_version (const snd_ump_endpoint_info_t*);
+
+    [[gnu::weak]] void snd_ump_endpoint_info_set_product_id (snd_ump_endpoint_info_t*, const char*);
+    [[gnu::weak]] void snd_ump_endpoint_info_set_sw_revision (snd_ump_endpoint_info_t*, const unsigned char*);
+    [[gnu::weak]] void snd_ump_endpoint_info_set_family_id (snd_ump_endpoint_info_t*, unsigned int);
+    [[gnu::weak]] void snd_ump_endpoint_info_set_flags (snd_ump_endpoint_info_t*, unsigned int);
+    [[gnu::weak]] void snd_ump_endpoint_info_set_manufacturer_id (snd_ump_endpoint_info_t*, unsigned int);
+    [[gnu::weak]] void snd_ump_endpoint_info_set_model_id (snd_ump_endpoint_info_t*, unsigned int);
+    [[gnu::weak]] void snd_ump_endpoint_info_set_name (snd_ump_endpoint_info_t*, const char*);
+    [[gnu::weak]] void snd_ump_endpoint_info_set_num_blocks (snd_ump_endpoint_info_t*, unsigned int);
+    [[gnu::weak]] void snd_ump_endpoint_info_set_protocol (snd_ump_endpoint_info_t*, unsigned int);
+    [[gnu::weak]] void snd_ump_endpoint_info_set_protocol_caps (snd_ump_endpoint_info_t*, unsigned int);
+    [[gnu::weak]] void snd_ump_endpoint_info_set_version (snd_ump_endpoint_info_t*, unsigned int);
+
+    [[gnu::weak]] const char* snd_ump_block_info_get_name (const snd_ump_block_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_block_info_get_active (const snd_ump_block_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_block_info_get_direction (const snd_ump_block_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_block_info_get_first_group (const snd_ump_block_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_block_info_get_flags (const snd_ump_block_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_block_info_get_num_groups (const snd_ump_block_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_block_info_get_sysex8_streams (const snd_ump_block_info_t*);
+    [[gnu::weak]] unsigned int snd_ump_block_info_get_ui_hint (const snd_ump_block_info_t*);
+
+    [[gnu::weak]] void snd_ump_block_info_set_name (snd_ump_block_info_t*, const char*);
+    [[gnu::weak]] void snd_ump_block_info_set_active (snd_ump_block_info_t*, unsigned int);
+    [[gnu::weak]] void snd_ump_block_info_set_direction (snd_ump_block_info_t*, unsigned int);
+    [[gnu::weak]] void snd_ump_block_info_set_first_group (snd_ump_block_info_t*, unsigned int);
+    [[gnu::weak]] void snd_ump_block_info_set_flags (snd_ump_block_info_t*, unsigned int);
+    [[gnu::weak]] void snd_ump_block_info_set_num_groups (snd_ump_block_info_t*, unsigned int);
+    [[gnu::weak]] void snd_ump_block_info_set_sysex8_streams (snd_ump_block_info_t*, unsigned int);
+    [[gnu::weak]] void snd_ump_block_info_set_ui_hint (snd_ump_block_info_t*, unsigned int);
+    [[gnu::weak]] void snd_ump_block_info_set_block_id (snd_ump_block_info_t*, unsigned int);
+
+    [[gnu::weak]] int snd_seq_port_info_get_direction (const snd_seq_port_info_t*);
+
+    [[gnu::weak]] size_t snd_ump_block_info_sizeof (void);
+    [[gnu::weak]] size_t snd_ump_endpoint_info_sizeof (void);
+}