This is a (largish) patch set for adding the support of MIDI 2.0 functionality, mainly targeted for USB devices. MIDI 2.0 is a complete overhaul of the 40-years old MIDI 1.0. Unlike MIDI 1.0 byte stream, MIDI 2.0 uses packets in 32bit words for Universal MIDI Packet (UMP) protocol. It supports both MIDI 1.0 commands for compatibility and the extended MIDI 2.0 commands for higher resolutions and more functions. For supporting the UMP, the patch set extends the existing ALSA rawmidi and sequencer interfaces, and adds the USB MIDI 2.0 support to the standard USB-audio driver. The rawmidi for UMP has a different device name (/dev/snd/umpC*D*) and it reads/writes UMP packet data in 32bit CPU-native endianness. For the old MIDI 1.0 applications, the legacy rawmidi interface is provided, too. As default, USB-audio driver will take the alternate setting for MIDI 2.0 interface, and the compatibility with MIDI 1.0 is provided via the rawmidi common layer. However, user may let the driver falling back to the old MIDI 1.0 interface by a module option, too. A UMP-capable rawmidi device can create the corresponding ALSA sequencer client(s) to support the UMP Endpoint and UMP Group connections. As a nature of ALSA sequencer, arbitrary connections between clients/ports are allowed, and the ALSA sequencer core performs the automatic conversions for the connections between a new UMP sequencer client and a legacy MIDI 1.0 sequencer client. It allows the existing application to use MIDI 2.0 devices without changes. The MIDI-CI, which is another major extension in MIDI 2.0, isn't covered by this patch set. It would be implemented rather in user-space. Roughly speaking, the first half of this patch set is for extending the rawmidi and USB-audio, and the second half is for extending the ALSA sequencer interface. The patch set is based on 6.4-rc2 kernel, but all patches can be cleanly applicable on 6.2 and 6.3 kernels, too (while 6.1 and older kernels would need minor adjustment for uapi header changes). The updates for alsa-lib and alsa-utils will follow shortly later. The author thanks members of MIDI Association OS/API Working Group, especially Andrew Mee, for great helps for the initial design and debugging / testing the drivers.
Showing the changes to include/uapi (2 of 234 files). Show all
Unified · Split
| @@ -10,7 +10,7 @@ · 9 unmodified lines | ||
| 10 | 10 | #include <sound/asound.h> |
| 11 | 11 | |
| 12 | 12 | /** version of the sequencer */ |
| 13 | −#define SNDRV_SEQ_VERSION SNDRV_PROTOCOL_VERSION(1, 0, 2) | |
| 13 | +#define SNDRV_SEQ_VERSION SNDRV_PROTOCOL_VERSION(1, 0, 3) | |
| 14 | 14 | |
| 15 | 15 | /** |
| 16 | 16 | * definition of sequencer event types |
| @@ -174,6 +174,7 @@ struct snd_seq_connect { · 157 unmodified lines | ||
| 174 | 174 | #define SNDRV_SEQ_PRIORITY_HIGH (1<<4) /* event should be processed before others */ |
| 175 | 175 | #define SNDRV_SEQ_PRIORITY_MASK (1<<4) |
| 176 | 176 | |
| 177 | +#define SNDRV_SEQ_EVENT_UMP (1<<5) /* event holds a UMP packet */ | |
| 177 | 178 | |
| 178 | 179 | /* note event */ |
| 179 | 180 | struct snd_seq_ev_note { |
| @@ -252,6 +253,19 @@ struct snd_seq_ev_quote { · 72 unmodified lines | ||
| 252 | 253 | struct snd_seq_event *event; /* quoted event */ |
| 253 | 254 | } __attribute__((packed)); |
| 254 | 255 | |
| 256 | +union snd_seq_event_data { /* event data... */ | |
| 257 | + struct snd_seq_ev_note note; | |
| 258 | + struct snd_seq_ev_ctrl control; | |
| 259 | + struct snd_seq_ev_raw8 raw8; | |
| 260 | + struct snd_seq_ev_raw32 raw32; | |
| 261 | + struct snd_seq_ev_ext ext; | |
| 262 | + struct snd_seq_ev_queue_control queue; | |
| 263 | + union snd_seq_timestamp time; | |
| 264 | + struct snd_seq_addr addr; | |
| 265 | + struct snd_seq_connect connect; | |
| 266 | + struct snd_seq_result result; | |
| 267 | + struct snd_seq_ev_quote quote; | |
| 268 | +}; | |
| 255 | 269 | |
| 256 | 270 | /* sequencer event */ |
| 257 | 271 | struct snd_seq_event { |
| @@ -262,25 +276,27 @@ struct snd_seq_event { · 4 unmodified lines | ||
| 262 | 276 | unsigned char queue; /* schedule queue */ |
| 263 | 277 | union snd_seq_timestamp time; /* schedule time */ |
| 264 | 278 | |
| 265 | − | |
| 266 | 279 | struct snd_seq_addr source; /* source address */ |
| 267 | 280 | struct snd_seq_addr dest; /* destination address */ |
| 268 | 281 | |
| 269 | − union { /* event data... */ | |
| 270 | − struct snd_seq_ev_note note; | |
| 271 | − struct snd_seq_ev_ctrl control; | |
| 272 | − struct snd_seq_ev_raw8 raw8; | |
| 273 | − struct snd_seq_ev_raw32 raw32; | |
| 274 | − struct snd_seq_ev_ext ext; | |
| 275 | − struct snd_seq_ev_queue_control queue; | |
| 276 | − union snd_seq_timestamp time; | |
| 277 | − struct snd_seq_addr addr; | |
| 278 | − struct snd_seq_connect connect; | |
| 279 | − struct snd_seq_result result; | |
| 280 | − struct snd_seq_ev_quote quote; | |
| 281 | − } data; | |
| 282 | + union snd_seq_event_data data; | |
| 282 | 283 | }; |
| 283 | 284 | |
| 285 | + /* (compatible) event for UMP-capable clients */ | |
| 286 | +struct snd_seq_ump_event { | |
| 287 | + snd_seq_event_type_t type; /* event type */ | |
| 288 | + unsigned char flags; /* event flags */ | |
| 289 | + char tag; | |
| 290 | + unsigned char queue; /* schedule queue */ | |
| 291 | + union snd_seq_timestamp time; /* schedule time */ | |
| 292 | + struct snd_seq_addr source; /* source address */ | |
| 293 | + struct snd_seq_addr dest; /* destination address */ | |
| 294 | + | |
| 295 | + union { | |
| 296 | + union snd_seq_event_data data; | |
| 297 | + unsigned int ump[4]; | |
| 298 | + }; | |
| 299 | +}; | |
| 284 | 300 | |
| 285 | 301 | /* |
| 286 | 302 | * bounce event - stored as variable size data |
| @@ -331,6 +347,7 @@ typedef int __bitwise snd_seq_client_type_t; · 44 unmodified lines | ||
| 331 | 347 | #define SNDRV_SEQ_FILTER_BROADCAST (1U<<0) /* accept broadcast messages */ |
| 332 | 348 | #define SNDRV_SEQ_FILTER_MULTICAST (1U<<1) /* accept multicast messages */ |
| 333 | 349 | #define SNDRV_SEQ_FILTER_BOUNCE (1U<<2) /* accept bounce event in error */ |
| 350 | +#define SNDRV_SEQ_FILTER_NO_CONVERT (1U<<30) /* don't convert UMP events */ | |
| 334 | 351 | #define SNDRV_SEQ_FILTER_USE_EVENT (1U<<31) /* use event filter */ |
| 335 | 352 | |
| 336 | 353 | struct snd_seq_client_info { |
| @@ -344,9 +361,15 @@ struct snd_seq_client_info { · 7 unmodified lines | ||
| 344 | 361 | int event_lost; /* number of lost events */ |
| 345 | 362 | int card; /* RO: card number[kernel] */ |
| 346 | 363 | int pid; /* RO: pid[user] */ |
| 347 | − char reserved[56]; /* for future use */ | |
| 364 | + unsigned int midi_version; /* MIDI version */ | |
| 365 | + unsigned int group_filter; /* UMP group filter bitmap (for 1-based Group indices) */ | |
| 366 | + char reserved[48]; /* for future use */ | |
| 348 | 367 | }; |
| 349 | 368 | |
| 369 | +/* MIDI version numbers in client info */ | |
| 370 | +#define SNDRV_SEQ_CLIENT_LEGACY_MIDI 0 /* Legacy client */ | |
| 371 | +#define SNDRV_SEQ_CLIENT_UMP_MIDI_1_0 1 /* UMP MIDI 1.0 */ | |
| 372 | +#define SNDRV_SEQ_CLIENT_UMP_MIDI_2_0 2 /* UMP MIDI 2.0 */ | |
| 350 | 373 | |
| 351 | 374 | /* client pool size */ |
| 352 | 375 | struct snd_seq_client_pool { |
| @@ -406,6 +429,8 @@ struct snd_seq_remove_events { · 53 unmodified lines | ||
| 406 | 429 | #define SNDRV_SEQ_PORT_CAP_SUBS_READ (1<<5) /* allow read subscription */ |
| 407 | 430 | #define SNDRV_SEQ_PORT_CAP_SUBS_WRITE (1<<6) /* allow write subscription */ |
| 408 | 431 | #define SNDRV_SEQ_PORT_CAP_NO_EXPORT (1<<7) /* routing not allowed */ |
| 432 | +#define SNDRV_SEQ_PORT_CAP_INACTIVE (1<<8) /* inactive port */ | |
| 433 | +#define SNDRV_SEQ_PORT_CAP_UMP_ENDPOINT (1<<9) /* MIDI 2.0 UMP Endpoint port */ | |
| 409 | 434 | |
| 410 | 435 | /* port type */ |
| 411 | 436 | #define SNDRV_SEQ_PORT_TYPE_SPECIFIC (1<<0) /* hardware specific */ |
| @@ -415,6 +440,7 @@ struct snd_seq_remove_events { · 3 unmodified lines | ||
| 415 | 440 | #define SNDRV_SEQ_PORT_TYPE_MIDI_XG (1<<4) /* XG compatible device */ |
| 416 | 441 | #define SNDRV_SEQ_PORT_TYPE_MIDI_MT32 (1<<5) /* MT-32 compatible device */ |
| 417 | 442 | #define SNDRV_SEQ_PORT_TYPE_MIDI_GM2 (1<<6) /* General MIDI 2 compatible device */ |
| 443 | +#define SNDRV_SEQ_PORT_TYPE_MIDI_UMP (1<<7) /* UMP */ | |
| 418 | 444 | |
| 419 | 445 | /* other standards...*/ |
| 420 | 446 | #define SNDRV_SEQ_PORT_TYPE_SYNTH (1<<10) /* Synth device (no MIDI compatible - direct wavetable) */ |
| @@ -432,6 +458,12 @@ struct snd_seq_remove_events { · 11 unmodified lines | ||
| 432 | 458 | #define SNDRV_SEQ_PORT_FLG_TIMESTAMP (1<<1) |
| 433 | 459 | #define SNDRV_SEQ_PORT_FLG_TIME_REAL (1<<2) |
| 434 | 460 | |
| 461 | +/* port direction */ | |
| 462 | +#define SNDRV_SEQ_PORT_DIR_UNKNOWN 0 | |
| 463 | +#define SNDRV_SEQ_PORT_DIR_INPUT 1 | |
| 464 | +#define SNDRV_SEQ_PORT_DIR_OUTPUT 2 | |
| 465 | +#define SNDRV_SEQ_PORT_DIR_BIDIRECTION 3 | |
| 466 | + | |
| 435 | 467 | struct snd_seq_port_info { |
| 436 | 468 | struct snd_seq_addr addr; /* client/port numbers */ |
| 437 | 469 | char name[64]; /* port name */ |
| @@ -448,7 +480,9 @@ struct snd_seq_port_info { · 10 unmodified lines | ||
| 448 | 480 | void *kernel; /* reserved for kernel use (must be NULL) */ |
| 449 | 481 | unsigned int flags; /* misc. conditioning */ |
| 450 | 482 | unsigned char time_queue; /* queue # for timestamping */ |
| 451 | − char reserved[59]; /* for future use */ | |
| 483 | + unsigned char direction; /* port usage direction (r/w/bidir) */ | |
| 484 | + unsigned char ump_group; /* 0 = UMP EP (no conversion), 1-16 = UMP group number */ | |
| 485 | + char reserved[57]; /* for future use */ | |
| 452 | 486 | }; |
| 453 | 487 | |
| 454 | 488 | |
| @@ -552,6 +586,18 @@ struct snd_seq_query_subs { · 97 unmodified lines | ||
| 552 | 586 | char reserved[64]; /* for future use */ |
| 553 | 587 | }; |
| 554 | 588 | |
| 589 | +/* | |
| 590 | + * UMP-specific information | |
| 591 | + */ | |
| 592 | +/* type of UMP info query */ | |
| 593 | +#define SNDRV_SEQ_CLIENT_UMP_INFO_ENDPOINT 0 | |
| 594 | +#define SNDRV_SEQ_CLIENT_UMP_INFO_BLOCK 1 | |
| 595 | + | |
| 596 | +struct snd_seq_client_ump_info { | |
| 597 | + int client; /* client number to inquire/set */ | |
| 598 | + int type; /* type to inquire/set */ | |
| 599 | + unsigned char info[512]; /* info (either UMP ep or block info) */ | |
| 600 | +} __packed; | |
| 555 | 601 | |
| 556 | 602 | /* |
| 557 | 603 | * IOCTL commands |
| @@ -561,9 +607,12 @@ struct snd_seq_query_subs { · 3 unmodified lines | ||
| 561 | 607 | #define SNDRV_SEQ_IOCTL_CLIENT_ID _IOR ('S', 0x01, int) |
| 562 | 608 | #define SNDRV_SEQ_IOCTL_SYSTEM_INFO _IOWR('S', 0x02, struct snd_seq_system_info) |
| 563 | 609 | #define SNDRV_SEQ_IOCTL_RUNNING_MODE _IOWR('S', 0x03, struct snd_seq_running_info) |
| 610 | +#define SNDRV_SEQ_IOCTL_USER_PVERSION _IOW('S', 0x04, int) | |
| 564 | 611 | |
| 565 | 612 | #define SNDRV_SEQ_IOCTL_GET_CLIENT_INFO _IOWR('S', 0x10, struct snd_seq_client_info) |
| 566 | 613 | #define SNDRV_SEQ_IOCTL_SET_CLIENT_INFO _IOW ('S', 0x11, struct snd_seq_client_info) |
| 614 | +#define SNDRV_SEQ_IOCTL_GET_CLIENT_UMP_INFO _IOWR('S', 0x12, struct snd_seq_client_ump_info) | |
| 615 | +#define SNDRV_SEQ_IOCTL_SET_CLIENT_UMP_INFO _IOWR('S', 0x13, struct snd_seq_client_ump_info) | |
| 567 | 616 | |
| 568 | 617 | #define SNDRV_SEQ_IOCTL_CREATE_PORT _IOWR('S', 0x20, struct snd_seq_port_info) |
| 569 | 618 | #define SNDRV_SEQ_IOCTL_DELETE_PORT _IOW ('S', 0x21, struct snd_seq_port_info) |
| @@ -712,7 +712,7 @@ enum { · 711 unmodified lines | ||
| 712 | 712 | * Raw MIDI section - /dev/snd/midi?? |
| 713 | 713 | */ |
| 714 | 714 | |
| 715 | −#define SNDRV_RAWMIDI_VERSION SNDRV_PROTOCOL_VERSION(2, 0, 2) | |
| 715 | +#define SNDRV_RAWMIDI_VERSION SNDRV_PROTOCOL_VERSION(2, 0, 3) | |
| 716 | 716 | |
| 717 | 717 | enum { |
| 718 | 718 | SNDRV_RAWMIDI_STREAM_OUTPUT = 0, |
| @@ -723,6 +723,7 @@ enum { · 4 unmodified lines | ||
| 723 | 723 | #define SNDRV_RAWMIDI_INFO_OUTPUT 0x00000001 |
| 724 | 724 | #define SNDRV_RAWMIDI_INFO_INPUT 0x00000002 |
| 725 | 725 | #define SNDRV_RAWMIDI_INFO_DUPLEX 0x00000004 |
| 726 | +#define SNDRV_RAWMIDI_INFO_UMP 0x00000008 | |
| 726 | 727 | |
| 727 | 728 | struct snd_rawmidi_info { |
| 728 | 729 | unsigned int device; /* RO/WR (control): device number */ |
| @@ -783,6 +784,57 @@ struct snd_rawmidi_status { · 54 unmodified lines | ||
| 783 | 784 | }; |
| 784 | 785 | #endif |
| 785 | 786 | |
| 787 | +/* UMP EP Protocol / JRTS capability bits */ | |
| 788 | +#define SNDRV_UMP_EP_INFO_PROTO_MIDI_MASK 0x0300 | |
| 789 | +#define SNDRV_UMP_EP_INFO_PROTO_MIDI1 0x0100 /* MIDI 1.0 */ | |
| 790 | +#define SNDRV_UMP_EP_INFO_PROTO_MIDI2 0x0200 /* MIDI 2.0 */ | |
| 791 | +#define SNDRV_UMP_EP_INFO_PROTO_JRTS_MASK 0x0003 | |
| 792 | +#define SNDRV_UMP_EP_INFO_PROTO_JRTS_TX 0x0001 /* JRTS Transmit */ | |
| 793 | +#define SNDRV_UMP_EP_INFO_PROTO_JRTS_RX 0x0002 /* JRTS Receive */ | |
| 794 | + | |
| 795 | +/* UMP Endpoint information */ | |
| 796 | +struct snd_ump_endpoint_info { | |
| 797 | + int card; /* card number */ | |
| 798 | + int device; /* device number */ | |
| 799 | + unsigned int flags; /* additional info */ | |
| 800 | + unsigned int protocol_caps; /* protocol capabilities */ | |
| 801 | + unsigned int protocol; /* current protocol */ | |
| 802 | + unsigned int num_blocks; /* # of function blocks */ | |
| 803 | + unsigned short version; /* UMP major/minor version */ | |
| 804 | + unsigned short padding[7]; | |
| 805 | + unsigned char name[128]; /* endpoint name string */ | |
| 806 | + unsigned char product_id[128]; /* unique product id string */ | |
| 807 | + unsigned char reserved[32]; | |
| 808 | +} __packed; | |
| 809 | + | |
| 810 | +/* UMP direction */ | |
| 811 | +#define SNDRV_UMP_DIR_INPUT 0x01 | |
| 812 | +#define SNDRV_UMP_DIR_OUTPUT 0x02 | |
| 813 | +#define SNDRV_UMP_DIR_BIDIRECTION 0x03 | |
| 814 | + | |
| 815 | +/* UMP block info flags */ | |
| 816 | +#define SNDRV_UMP_BLOCK_IS_MIDI1 (1U << 0) /* MIDI 1.0 port w/o restrict */ | |
| 817 | +#define SNDRV_UMP_BLOCK_IS_LOWSPEED (1U << 1) /* 31.25Kbps B/W MIDI1 port */ | |
| 818 | + | |
| 819 | +/* UMP groups and blocks */ | |
| 820 | +#define SNDRV_UMP_MAX_GROUPS 16 | |
| 821 | +#define SNDRV_UMP_MAX_BLOCKS 32 | |
| 822 | + | |
| 823 | +/* UMP Block information */ | |
| 824 | +struct snd_ump_block_info { | |
| 825 | + int card; /* card number */ | |
| 826 | + int device; /* device number */ | |
| 827 | + unsigned char block_id; /* block ID (R/W) */ | |
| 828 | + unsigned char direction; /* UMP direction */ | |
| 829 | + unsigned char active; /* Activeness */ | |
| 830 | + unsigned char first_group; /* first group ID */ | |
| 831 | + unsigned char num_groups; /* number of groups */ | |
| 832 | + unsigned char padding[3]; | |
| 833 | + unsigned int flags; /* various info flags */ | |
| 834 | + unsigned char name[128]; /* block name string */ | |
| 835 | + unsigned char reserved[32]; | |
| 836 | +} __packed; | |
| 837 | + | |
| 786 | 838 | #define SNDRV_RAWMIDI_IOCTL_PVERSION _IOR('W', 0x00, int) |
| 787 | 839 | #define SNDRV_RAWMIDI_IOCTL_INFO _IOR('W', 0x01, struct snd_rawmidi_info) |
| 788 | 840 | #define SNDRV_RAWMIDI_IOCTL_USER_PVERSION _IOW('W', 0x02, int) |
| @@ -790,6 +842,9 @@ struct snd_rawmidi_status { · 1 unmodified line | ||
| 790 | 842 | #define SNDRV_RAWMIDI_IOCTL_STATUS _IOWR('W', 0x20, struct snd_rawmidi_status) |
| 791 | 843 | #define SNDRV_RAWMIDI_IOCTL_DROP _IOW('W', 0x30, int) |
| 792 | 844 | #define SNDRV_RAWMIDI_IOCTL_DRAIN _IOW('W', 0x31, int) |
| 845 | +/* Additional ioctls for UMP rawmidi devices */ | |
| 846 | +#define SNDRV_UMP_IOCTL_ENDPOINT_INFO _IOR('W', 0x40, struct snd_ump_endpoint_info) | |
| 847 | +#define SNDRV_UMP_IOCTL_BLOCK_INFO _IOR('W', 0x41, struct snd_ump_block_info) | |
| 793 | 848 | |
| 794 | 849 | /* |
| 795 | 850 | * Timer section - /dev/snd/timer |
| @@ -965,7 +1020,7 @@ struct snd_timer_tread { · 169 unmodified lines | ||
| 965 | 1020 | * * |
| 966 | 1021 | ****************************************************************************/ |
| 967 | 1022 | |
| 968 | −#define SNDRV_CTL_VERSION SNDRV_PROTOCOL_VERSION(2, 0, 8) | |
| 1023 | +#define SNDRV_CTL_VERSION SNDRV_PROTOCOL_VERSION(2, 0, 9) | |
| 969 | 1024 | |
| 970 | 1025 | struct snd_ctl_card_info { |
| 971 | 1026 | int card; /* card number */ |
| @@ -1126,6 +1181,9 @@ struct snd_ctl_tlv { · 154 unmodified lines | ||
| 1126 | 1181 | #define SNDRV_CTL_IOCTL_RAWMIDI_NEXT_DEVICE _IOWR('U', 0x40, int) |
| 1127 | 1182 | #define SNDRV_CTL_IOCTL_RAWMIDI_INFO _IOWR('U', 0x41, struct snd_rawmidi_info) |
| 1128 | 1183 | #define SNDRV_CTL_IOCTL_RAWMIDI_PREFER_SUBDEVICE _IOW('U', 0x42, int) |
| 1184 | +#define SNDRV_CTL_IOCTL_UMP_NEXT_DEVICE _IOWR('U', 0x43, int) | |
| 1185 | +#define SNDRV_CTL_IOCTL_UMP_ENDPOINT_INFO _IOWR('U', 0x44, struct snd_ump_endpoint_info) | |
| 1186 | +#define SNDRV_CTL_IOCTL_UMP_BLOCK_INFO _IOWR('U', 0x45, struct snd_ump_block_info) | |
| 1129 | 1187 | #define SNDRV_CTL_IOCTL_POWER _IOWR('U', 0xd0, int) |
| 1130 | 1188 | #define SNDRV_CTL_IOCTL_POWER_STATE _IOR('U', 0xd1, int) |
| 1131 | 1189 | |