test: Add an example program to inquire UMP Endpoint and Block info

Provide an example program to inquire UMP Endpoint and Block info in
various APIs.

Signed-off-by: Takashi Iwai <tiwai@suse.de>

diff --git a/test/Makefile.am b/test/Makefile.am
index 635fa39bb7e3fb6e1868d784ef281e9ad328b6f9..707063cc9fc04a4246dc7017a55e118b39ba7ed3 100644 (file)
--- a/test/Makefile.am
+++ b/test/Makefile.am
@@ -1,7 +1,7 @@
 SUBDIRS=. lsb
 
 check_PROGRAMS=control pcm pcm_min latency seq seq-ump-example \
-              playmidi1 timer rawmidi midiloop \
+              playmidi1 timer rawmidi midiloop umpinfo \
               oldapi queue_timer namehint client_event_filter \
               chmap audio_time user-ctl-element-set pcm-multi-thread
 
@@ -17,6 +17,7 @@ playmidi1_LDADD=../src/libasound.la
 timer_LDADD=../src/libasound.la
 rawmidi_LDADD=../src/libasound.la
 midiloop_LDADD=../src/libasound.la
+umpinfo_LDADD=../src/libasound.la
 oldapi_LDADD=../src/libasound.la
 queue_timer_LDADD=../src/libasound.la
 namehint_LDADD=../src/libasound.la

diff --git a/test/umpinfo.c b/test/umpinfo.c
new file mode 100644 (file)
index 0000000..92a2093
--- /dev/null
+++ b/test/umpinfo.c
@@ -0,0 +1,147 @@
+// SPDX-License-Identifier: GPL-2.0-or-later
+// Inquire UMP Endpoint and Block info in various APIs
+
+#include <stdio.h>
+#include <alsa/asoundlib.h>
+
+enum { UNKNOWN, SEQ, RAWMIDI, CTL };
+static int mode = UNKNOWN;
+
+static snd_seq_t *seq;
+static int client;
+static snd_ump_t *ump;
+static snd_ctl_t *ctl;
+
+static int get_ump_endpoint_info(snd_ump_endpoint_info_t *ep)
+{
+       switch (mode) {
+       case SEQ:
+               return snd_seq_get_ump_endpoint_info(seq, client, ep);
+       case RAWMIDI:
+               return snd_ump_endpoint_info(ump, ep);
+       case CTL:
+               return snd_ctl_ump_endpoint_info(ctl, ep);
+       default:
+               return -EINVAL;
+       }
+}
+
+static int get_ump_block_info(int blk, snd_ump_block_info_t *bp)
+{
+       switch (mode) {
+       case SEQ:
+               return snd_seq_get_ump_block_info(seq, client, blk, bp);
+       case RAWMIDI:
+               snd_ump_block_info_set_block_id(bp, blk);
+               return snd_ump_block_info(ump, bp);
+       case CTL:
+               snd_ump_block_info_set_block_id(bp, blk);
+               return snd_ctl_ump_block_info(ctl, bp);
+       default:
+               return -EINVAL;
+       }
+}
+
+static void help(void)
+{
+       printf("umpinfo: inquire UMP Endpoint and Block info\n"
+              "  umpinfo -c target     inquiry via control API\n"
+              "  umpinfo -m target     inquiry via UMP rawmidi API\n"
+              "  umpinfo -s client     inquiry via sequencer API\n"
+              "    target = hw:0, etc\n"
+              "    client = sequencer client number\n");
+       exit(1);
+}
+
+int main(int argc, char **argv)
+{
+       const char *target = "hw:0";
+       snd_ump_endpoint_info_t *ep;
+       snd_ump_block_info_t *blk;
+       const unsigned char *s;
+       int c, i, num_blks;
+
+       while ((c = getopt(argc, argv, "s:m:c:h")) >= 0) {
+               switch (c) {
+               case 's':
+                       mode = SEQ;
+                       client = atoi(target);
+                       break;
+               case 'm':
+                       mode = RAWMIDI;
+                       target = optarg;
+                       break;
+               case 'c':
+                       mode = CTL;
+                       target = optarg;
+                       break;
+               default:
+                       help();
+                       break;
+               }
+       }
+
+       switch (mode) {
+       case SEQ:
+               if (snd_seq_open(&seq, "default", SND_SEQ_OPEN_DUPLEX, 0)) {
+                       fprintf(stderr, "failed to open sequencer\n");
+                       return 1;
+               }
+               break;
+       case RAWMIDI:
+               if (snd_ump_open(&ump, NULL, target, 0)) {
+                       fprintf(stderr, "failed to open UMP rawmidi\n");
+                       return 1;
+               }
+               break;
+       case CTL:
+               if (snd_ctl_open(&ctl, target, 0)) {
+                       fprintf(stderr, "failed to open control\n");
+                       return 1;
+               }
+               break;
+       default:
+               help();
+               break;
+       }
+
+       snd_ump_endpoint_info_alloca(&ep);
+       snd_ump_block_info_alloca(&blk);
+
+       if (get_ump_endpoint_info(ep)) {
+               fprintf(stderr, "failed to get UMP EP info\n");
+               return 1;
+       }
+
+       printf("Name: %s\n", snd_ump_endpoint_info_get_name(ep));
+       printf("Product ID: %s\n", snd_ump_endpoint_info_get_product_id(ep));
+       printf("Flags: 0x%x\n", snd_ump_endpoint_info_get_flags(ep));
+       printf("Protocol Caps: 0x%x\n", snd_ump_endpoint_info_get_protocol_caps(ep));
+       printf("Protocol: 0x%x\n", snd_ump_endpoint_info_get_protocol(ep));
+       printf("Num Blocks: %d\n", snd_ump_endpoint_info_get_num_blocks(ep));
+       printf("Version: 0x%x\n", snd_ump_endpoint_info_get_version(ep));
+       printf("Manufacturer ID: 0x%x\n", snd_ump_endpoint_info_get_manufacturer_id(ep));
+       printf("Family ID: 0x%x\n", snd_ump_endpoint_info_get_family_id(ep));
+       printf("Model ID: 0x%x\n", snd_ump_endpoint_info_get_model_id(ep));
+       s = snd_ump_endpoint_info_get_sw_revision(ep);
+       printf("SW Revision: %02x:%02x:%02x:%02x\n", s[0], s[1], s[2], s[3]);
+       num_blks = snd_ump_endpoint_info_get_num_blocks(ep);
+       for (i = 0; i < num_blks; i++) {
+               if (get_ump_block_info(i, blk)) {
+                       fprintf(stderr, "failed to get UMP Block info for %d\n", i);
+                       continue;
+               }
+               printf("\n");
+               printf("Block ID: %d\n", snd_ump_block_info_get_block_id(blk));
+               printf("Name: %s\n", snd_ump_block_info_get_name(blk));
+               printf("Active: %d\n", snd_ump_block_info_get_active(blk));
+               printf("Flags: 0x%x\n", snd_ump_block_info_get_flags(blk));
+               printf("Direction: %d\n", snd_ump_block_info_get_direction(blk));
+               printf("First Group: %d\n", snd_ump_block_info_get_first_group(blk));
+               printf("Num Groups: %d\n", snd_ump_block_info_get_num_groups(blk));
+               printf("MIDI-CI Version: %d\n", snd_ump_block_info_get_midi_ci_version(blk));
+               printf("Sysex8 Streams: %d\n", snd_ump_block_info_get_sysex8_streams(blk));
+       }
+
+       return 0;
+}