ALSA project - the C library reference
ump.h
Go to the documentation of this file.
1 /* SPDX-License-Identifier: LGPL-2.1+ */
9 #ifndef __ALSA_UMP_H
10 #define __ALSA_UMP_H
11 
12 #include "rawmidi.h"
13 
14 #ifdef __cplusplus
15 extern "C" {
16 #endif
17 
25 typedef struct _snd_ump snd_ump_t;
30 
31 int snd_ump_open(snd_ump_t **inputp, snd_ump_t **outputp, const char *name, int mode);
32 int snd_ump_close(snd_ump_t *ump);
34 const char *snd_ump_name(snd_ump_t *ump);
36 int snd_ump_poll_descriptors(snd_ump_t *ump, struct pollfd *pfds, unsigned int space);
37 int snd_ump_poll_descriptors_revents(snd_ump_t *ump, struct pollfd *pfds, unsigned int nfds, unsigned short *revents);
38 int snd_ump_nonblock(snd_ump_t *ump, int nonblock);
43 int snd_ump_drop(snd_ump_t *ump);
44 int snd_ump_drain(snd_ump_t *ump);
45 ssize_t snd_ump_write(snd_ump_t *ump, const void *buffer, size_t size);
46 ssize_t snd_ump_read(snd_ump_t *ump, void *buffer, size_t size);
47 ssize_t snd_ump_tread(snd_ump_t *ump, struct timespec *tstamp, void *buffer, size_t size);
48 
50 #define SND_UMP_MAX_GROUPS 16
52 #define SND_UMP_MAX_BLOCKS 32
53 
62 };
63 
65 #define SND_UMP_EP_INFO_STATIC_BLOCKS 0x01
66 
68 #define SND_UMP_EP_INFO_PROTO_MIDI_MASK 0x0300
70 #define SND_UMP_EP_INFO_PROTO_MIDI1 0x0100
72 #define SND_UMP_EP_INFO_PROTO_MIDI2 0x0200
74 #define SND_UMP_EP_INFO_PROTO_JRTS_MASK 0x0003
76 #define SND_UMP_EP_INFO_PROTO_JRTS_TX 0x0001
78 #define SND_UMP_EP_INFO_PROTO_JRTS_RX 0x0002
79 
81 #define SND_UMP_EP_INFO_DEFAULT_VERSION 0x0101
82 
83 size_t snd_ump_endpoint_info_sizeof(void);
88 #define snd_ump_endpoint_info_alloca(ptr) __snd_alloca(ptr, snd_ump_endpoint_info)
103 const unsigned char *snd_ump_endpoint_info_get_sw_revision(const snd_ump_endpoint_info_t *info);
107 
108 void snd_ump_endpoint_info_set_card(snd_ump_endpoint_info_t *info, unsigned int card);
109 void snd_ump_endpoint_info_set_device(snd_ump_endpoint_info_t *info, unsigned int device);
112 void snd_ump_endpoint_info_set_protocol(snd_ump_endpoint_info_t *info, unsigned int protocols);
113 void snd_ump_endpoint_info_set_num_blocks(snd_ump_endpoint_info_t *info, unsigned int num_blocks);
114 void snd_ump_endpoint_info_set_version(snd_ump_endpoint_info_t *info, unsigned int version);
118 void snd_ump_endpoint_info_set_sw_revision(snd_ump_endpoint_info_t *info, const unsigned char *id);
119 void snd_ump_endpoint_info_set_name(snd_ump_endpoint_info_t *info, const char *name);
121 
123 #define SND_UMP_BLOCK_IS_MIDI1 (1U << 0)
125 #define SND_UMP_BLOCK_IS_LOWSPEED (1U << 1)
126 
137 };
138 
140 #define SND_UMP_BLOCK_INFO_DEFAULT_MIDI_CI_VERSION 0x01
141 
142 size_t snd_ump_block_info_sizeof(void);
147 #define snd_ump_block_info_alloca(ptr) __snd_alloca(ptr, snd_ump_block_info)
154 unsigned int snd_ump_block_info_get_block_id(const snd_ump_block_info_t *info);
155 unsigned int snd_ump_block_info_get_active(const snd_ump_block_info_t *info);
156 unsigned int snd_ump_block_info_get_flags(const snd_ump_block_info_t *info);
162 unsigned int snd_ump_block_info_get_ui_hint(const snd_ump_block_info_t *info);
163 const char *snd_ump_block_info_get_name(const snd_ump_block_info_t *info);
165 
166 void snd_ump_block_info_set_card(snd_ump_block_info_t *info, unsigned int card);
167 void snd_ump_block_info_set_device(snd_ump_block_info_t *info, unsigned int device);
168 void snd_ump_block_info_set_block_id(snd_ump_block_info_t *info, unsigned int id);
169 void snd_ump_block_info_set_active(snd_ump_block_info_t *info, unsigned int active);
171 void snd_ump_block_info_set_direction(snd_ump_block_info_t *info, unsigned int direction);
172 void snd_ump_block_info_set_first_group(snd_ump_block_info_t *info, unsigned int first_group);
173 void snd_ump_block_info_set_num_groups(snd_ump_block_info_t *info, unsigned int num_groups);
174 void snd_ump_block_info_set_midi_ci_version(snd_ump_block_info_t *info, unsigned int version);
175 void snd_ump_block_info_set_sysex8_streams(snd_ump_block_info_t *info, unsigned int streams);
176 void snd_ump_block_info_set_ui_hint(snd_ump_block_info_t *info, unsigned int hint);
177 void snd_ump_block_info_set_name(snd_ump_block_info_t *info, const char *name);
178 
181 #ifdef __cplusplus
182 }
183 #endif
184 
185 #endif /* __ALSA_UMP_H */
_snd_ump_direction
Definition: ump.h:55
const char * snd_ump_endpoint_info_get_name(const snd_ump_endpoint_info_t *info)
get UMP endpoint name string
Definition: ump.c:500
const char * snd_ump_block_info_get_name(const snd_ump_block_info_t *info)
get the name string of UMP block
Definition: ump.c:843
int snd_ump_poll_descriptors_count(snd_ump_t *ump)
get count of poll descriptors for UMP handle
Definition: ump.c:169
ssize_t snd_ump_write(snd_ump_t *ump, const void *buffer, size_t size)
write UMP packets to UMP stream
Definition: ump.c:289
struct _snd_rawmidi_status snd_rawmidi_status_t
Definition: rawmidi.h:49
void snd_ump_endpoint_info_free(snd_ump_endpoint_info_t *info)
frees the snd_ump_endpoint_info_t structure
Definition: ump.c:358
void snd_ump_endpoint_info_set_device(snd_ump_endpoint_info_t *info, unsigned int device)
set device number of UMP endpoint
Definition: ump.c:531
unsigned int snd_ump_endpoint_info_get_manufacturer_id(const snd_ump_endpoint_info_t *info)
get UMP manufacturer ID
Definition: ump.c:460
unsigned int snd_ump_block_info_get_midi_ci_version(const snd_ump_block_info_t *info)
get MIDI-CI version number
Definition: ump.c:813
unsigned int snd_ump_block_info_get_ui_hint(const snd_ump_block_info_t *info)
get UI hint of the given UMP block
Definition: ump.c:833
int snd_ump_endpoint_info(snd_ump_t *ump, snd_ump_endpoint_info_t *info)
get endpoint information about UMP handle
Definition: ump.c:664
void snd_ump_endpoint_info_set_card(snd_ump_endpoint_info_t *info, unsigned int card)
set card number of UMP endpoint
Definition: ump.c:520
void snd_ump_block_info_set_direction(snd_ump_block_info_t *info, unsigned int direction)
set UMP block direction to snd_ump_block_info_t structure
Definition: ump.c:916
size_t snd_ump_block_info_sizeof(void)
get size of the snd_ump_block_info_t structure in bytes
Definition: ump.c:673
size_t snd_ump_endpoint_info_sizeof(void)
get size of the snd_ump_endpoint_info_t structure in bytes
Definition: ump.c:330
int snd_ump_block_info(snd_ump_t *ump, snd_ump_block_info_t *info)
get UMP block information
Definition: ump.c:995
void snd_ump_block_info_set_sysex8_streams(snd_ump_block_info_t *info, unsigned int streams)
set number of supported SysEx8 streams to snd_ump_block_info_t structure
Definition: ump.c:959
int snd_ump_rawmidi_params_current(snd_ump_t *ump, snd_rawmidi_params_t *params)
get current parameters about associated RawMidi stream
Definition: ump.c:244
void snd_ump_block_info_set_midi_ci_version(snd_ump_block_info_t *info, unsigned int version)
set MIDI-CI version number to snd_ump_block_info_t structure
Definition: ump.c:948
int snd_ump_block_info_malloc(snd_ump_block_info_t **info)
allocate the snd_ump_block_info_t structure
Definition: ump.c:686
void snd_ump_block_info_set_device(snd_ump_block_info_t *info, unsigned int device)
set device number to snd_ump_block_info_t structure
Definition: ump.c:863
struct _snd_ump snd_ump_t
Definition: ump.h:25
const char * snd_ump_endpoint_info_get_product_id(const snd_ump_endpoint_info_t *info)
get UMP endpoint product ID string
Definition: ump.c:510
void snd_ump_block_info_set_name(snd_ump_block_info_t *info, const char *name)
set the name string to snd_ump_block_info_t structure
Definition: ump.c:980
ssize_t snd_ump_read(snd_ump_t *ump, void *buffer, size_t size)
read UMP packets from UMP stream
Definition: ump.c:303
unsigned int snd_ump_endpoint_info_get_family_id(const snd_ump_endpoint_info_t *info)
get UMP family ID
Definition: ump.c:470
unsigned int snd_ump_block_info_get_direction(const snd_ump_block_info_t *info)
get UMP block direction
Definition: ump.c:783
void snd_ump_block_info_set_block_id(snd_ump_block_info_t *info, unsigned int id)
set UMP block ID to snd_ump_block_info_t structure
Definition: ump.c:879
int snd_ump_drop(snd_ump_t *ump)
drop all packets in the rawmidi I/O ring buffer immediately
Definition: ump.c:265
void snd_ump_endpoint_info_set_model_id(snd_ump_endpoint_info_t *info, unsigned int id)
set the UMP model ID of UMP endpoint
Definition: ump.c:619
void snd_ump_block_info_set_ui_hint(snd_ump_block_info_t *info, unsigned int hint)
set UI Hint to snd_ump_block_info_t structure
Definition: ump.c:970
void snd_ump_endpoint_info_clear(snd_ump_endpoint_info_t *info)
clears the snd_ump_endpoint_info_t structure
Definition: ump.c:369
unsigned int snd_ump_block_info_get_num_groups(const snd_ump_block_info_t *info)
get number of UMP groups belonging to the block
Definition: ump.c:803
int snd_ump_poll_descriptors_revents(snd_ump_t *ump, struct pollfd *pfds, unsigned int nfds, unsigned short *revents)
get returned events from poll descriptors
Definition: ump.c:195
void snd_ump_block_info_set_card(snd_ump_block_info_t *info, unsigned int card)
set card number to snd_ump_block_info_t structure
Definition: ump.c:853
void snd_ump_endpoint_info_set_num_blocks(snd_ump_endpoint_info_t *info, unsigned int num_blocks)
set the number of UMP blocks of UMP endpoint
Definition: ump.c:575
int snd_ump_open(snd_ump_t **inputp, snd_ump_t **outputp, const char *name, int mode)
Opens a new connection to the UMP interface.
Definition: ump.c:58
void snd_ump_endpoint_info_set_family_id(snd_ump_endpoint_info_t *info, unsigned int id)
set the UMP family ID of UMP endpoint
Definition: ump.c:608
const unsigned char * snd_ump_endpoint_info_get_sw_revision(const snd_ump_endpoint_info_t *info)
get UMP software revision
Definition: ump.c:490
int snd_ump_endpoint_info_malloc(snd_ump_endpoint_info_t **info)
allocate the snd_ump_endpoint_info_t structure
Definition: ump.c:343
void snd_ump_endpoint_info_set_protocol(snd_ump_endpoint_info_t *info, unsigned int protocols)
set the current protocol of UMP endpoint
Definition: ump.c:564
int snd_ump_endpoint_info_get_device(const snd_ump_endpoint_info_t *info)
get device number of UMP endpoint
Definition: ump.c:400
_snd_ump_block_ui_hint
Definition: ump.h:128
int snd_ump_rawmidi_status(snd_ump_t *ump, snd_rawmidi_status_t *status)
get status of associated RawMidi stream
Definition: ump.c:255
void snd_ump_endpoint_info_copy(snd_ump_endpoint_info_t *dst, const snd_ump_endpoint_info_t *src)
copy one snd_ump_endpoint_info_t structure to another
Definition: ump.c:379
unsigned int snd_ump_block_info_get_active(const snd_ump_block_info_t *info)
get UMP block activeness
Definition: ump.c:763
void snd_ump_endpoint_info_set_product_id(snd_ump_endpoint_info_t *info, const char *id)
set the product ID string of UMP endpoint
Definition: ump.c:652
struct _snd_rawmidi_params snd_rawmidi_params_t
Definition: rawmidi.h:47
struct _snd_rawmidi snd_rawmidi_t
Definition: rawmidi.h:68
int snd_ump_rawmidi_params(snd_ump_t *ump, snd_rawmidi_params_t *params)
set parameters about associated RawMidi stream
Definition: ump.c:233
int snd_ump_poll_descriptors(snd_ump_t *ump, struct pollfd *pfds, unsigned int space)
get poll descriptors
Definition: ump.c:181
unsigned int snd_ump_endpoint_info_get_protocol_caps(const snd_ump_endpoint_info_t *info)
get UMP endpoint protocol capability bits
Definition: ump.c:420
struct snd_ump_block_info snd_ump_block_info_t
Definition: ump.h:29
const char * snd_ump_name(snd_ump_t *ump)
get identifier of UMP handle
Definition: ump.c:159
struct _snd_rawmidi_info snd_rawmidi_info_t
Definition: rawmidi.h:45
void snd_ump_endpoint_info_set_sw_revision(snd_ump_endpoint_info_t *info, const unsigned char *id)
set the UMP software revision of UMP endpoint
Definition: ump.c:630
void snd_ump_endpoint_info_set_version(snd_ump_endpoint_info_t *info, unsigned int version)
set the UMP version number of UMP endpoint
Definition: ump.c:586
void snd_ump_block_info_set_flags(snd_ump_block_info_t *info, unsigned int flags)
set UMP block information flags to snd_ump_block_info_t structure
Definition: ump.c:906
unsigned int snd_ump_endpoint_info_get_version(const snd_ump_endpoint_info_t *info)
get UMP version number
Definition: ump.c:450
void snd_ump_endpoint_info_set_protocol_caps(snd_ump_endpoint_info_t *info, unsigned int caps)
set protocol capability bits of UMP endpoint
Definition: ump.c:553
int snd_ump_block_info_get_device(const snd_ump_block_info_t *info)
get device number of UMP block
Definition: ump.c:743
int snd_ump_endpoint_info_get_card(const snd_ump_endpoint_info_t *info)
get card number of UMP endpoint
Definition: ump.c:390
unsigned int snd_ump_block_info_get_sysex8_streams(const snd_ump_block_info_t *info)
get number of supported SysEx8 streams
Definition: ump.c:823
unsigned int snd_ump_endpoint_info_get_protocol(const snd_ump_endpoint_info_t *info)
get the current UMP endpoint protocol
Definition: ump.c:430
void snd_ump_block_info_set_num_groups(snd_ump_block_info_t *info, unsigned int num_groups)
set number of UMP groups to snd_ump_block_info_t structure
Definition: ump.c:937
int snd_ump_nonblock(snd_ump_t *ump, int nonblock)
set nonblock mode
Definition: ump.c:211
unsigned int snd_ump_block_info_get_block_id(const snd_ump_block_info_t *info)
get UMP block ID
Definition: ump.c:753
void snd_ump_block_info_set_first_group(snd_ump_block_info_t *info, unsigned int first_group)
set first UMP group to snd_ump_block_info_t structure
Definition: ump.c:926
void snd_ump_block_info_clear(snd_ump_block_info_t *info)
clears the snd_ump_block_info_t structure
Definition: ump.c:712
unsigned int snd_ump_endpoint_info_get_model_id(const snd_ump_endpoint_info_t *info)
get UMP model ID
Definition: ump.c:480
void snd_ump_endpoint_info_set_manufacturer_id(snd_ump_endpoint_info_t *info, unsigned int id)
set the UMP manufacturer ID of UMP endpoint
Definition: ump.c:597
void snd_ump_endpoint_info_set_name(snd_ump_endpoint_info_t *info, const char *name)
set the name of UMP endpoint
Definition: ump.c:641
struct snd_ump_endpoint_info snd_ump_endpoint_info_t
Definition: ump.h:27
snd_rawmidi_t * snd_ump_rawmidi(snd_ump_t *ump)
get RawMidi instance associated with the UMP handle
Definition: ump.c:146
int snd_ump_close(snd_ump_t *ump)
close UMP handle
Definition: ump.c:130
void snd_ump_block_info_copy(snd_ump_block_info_t *dst, const snd_ump_block_info_t *src)
copy one snd_ump_block_info_t structure to another
Definition: ump.c:722
int snd_ump_rawmidi_info(snd_ump_t *ump, snd_rawmidi_info_t *info)
get information about associated RawMidi handle
Definition: ump.c:222
ssize_t snd_ump_tread(snd_ump_t *ump, struct timespec *tstamp, void *buffer, size_t size)
read UMP packets from UMP stream with timestamp
Definition: ump.c:318
unsigned int snd_ump_endpoint_info_get_flags(const snd_ump_endpoint_info_t *info)
get UMP endpoint info flags
Definition: ump.c:410
void snd_ump_block_info_free(snd_ump_block_info_t *info)
frees the snd_ump_block_info_t structure
Definition: ump.c:701
unsigned int snd_ump_block_info_get_first_group(const snd_ump_block_info_t *info)
get first UMP group ID belonging to the block
Definition: ump.c:793
void snd_ump_endpoint_info_set_flags(snd_ump_endpoint_info_t *info, unsigned int flags)
set info flags of UMP endpoint
Definition: ump.c:542
unsigned int snd_ump_endpoint_info_get_num_blocks(const snd_ump_endpoint_info_t *info)
get the number of UMP blocks belonging to the endpoint
Definition: ump.c:440
void snd_ump_block_info_set_active(snd_ump_block_info_t *info, unsigned int active)
set activeness to snd_ump_block_info_t structure
Definition: ump.c:896
int snd_ump_drain(snd_ump_t *ump)
drain all packets in the UMP I/O ring buffer
Definition: ump.c:278
int snd_ump_block_info_get_card(const snd_ump_block_info_t *info)
get card number of UMP block
Definition: ump.c:733
unsigned int snd_ump_block_info_get_flags(const snd_ump_block_info_t *info)
get UMP block information flags
Definition: ump.c:773
@ SND_UMP_DIR_OUTPUT
Definition: ump.h:59
@ SND_UMP_DIR_BIDIRECTION
Definition: ump.h:61
@ SND_UMP_DIR_INPUT
Definition: ump.h:57
@ SND_UMP_BLOCK_UI_HINT_BOTH
Definition: ump.h:136
@ SND_UMP_BLOCK_UI_HINT_UNKNOWN
Definition: ump.h:130
@ SND_UMP_BLOCK_UI_HINT_SENDER
Definition: ump.h:134
@ SND_UMP_BLOCK_UI_HINT_RECEIVER
Definition: ump.h:132
Application interface library for the ALSA driver.
uint8_t flags
Definition: ump_msg.h:10
uint8_t status
Definition: ump_msg.h:11