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 #ifdef __cplusplus
13 extern "C" {
14 #endif
15 
23 typedef struct _snd_ump snd_ump_t;
28 
29 int snd_ump_open(snd_ump_t **inputp, snd_ump_t **outputp, const char *name, int mode);
30 int snd_ump_close(snd_ump_t *ump);
32 const char *snd_ump_name(snd_ump_t *ump);
34 int snd_ump_poll_descriptors(snd_ump_t *ump, struct pollfd *pfds, unsigned int space);
35 int snd_ump_poll_descriptors_revents(snd_ump_t *ump, struct pollfd *pfds, unsigned int nfds, unsigned short *revents);
36 int snd_ump_nonblock(snd_ump_t *ump, int nonblock);
41 int snd_ump_drop(snd_ump_t *ump);
42 int snd_ump_drain(snd_ump_t *ump);
43 ssize_t snd_ump_write(snd_ump_t *ump, const void *buffer, size_t size);
44 ssize_t snd_ump_read(snd_ump_t *ump, void *buffer, size_t size);
45 ssize_t snd_ump_tread(snd_ump_t *ump, struct timespec *tstamp, void *buffer, size_t size);
46 
48 #define SND_UMP_MAX_GROUPS 16
49 
50 #define SND_UMP_MAX_BLOCKS 32
51 
60 };
61 
63 #define SND_UMP_EP_INFO_STATIC_BLOCKS 0x01
64 
66 #define SND_UMP_EP_INFO_PROTO_MIDI_MASK 0x0300
67 
68 #define SND_UMP_EP_INFO_PROTO_MIDI1 0x0100
69 
70 #define SND_UMP_EP_INFO_PROTO_MIDI2 0x0200
71 
72 #define SND_UMP_EP_INFO_PROTO_JRTS_MASK 0x0003
73 
74 #define SND_UMP_EP_INFO_PROTO_JRTS_TX 0x0001
75 
76 #define SND_UMP_EP_INFO_PROTO_JRTS_RX 0x0002
77 
79 #define SND_UMP_EP_INFO_DEFAULT_VERSION 0x0101
80 
81 size_t snd_ump_endpoint_info_sizeof(void);
86 #define snd_ump_endpoint_info_alloca(ptr) __snd_alloca(ptr, snd_ump_endpoint_info)
101 const unsigned char *snd_ump_endpoint_info_get_sw_revision(const snd_ump_endpoint_info_t *info);
105 
106 void snd_ump_endpoint_info_set_card(snd_ump_endpoint_info_t *info, unsigned int card);
107 void snd_ump_endpoint_info_set_device(snd_ump_endpoint_info_t *info, unsigned int device);
110 void snd_ump_endpoint_info_set_protocol(snd_ump_endpoint_info_t *info, unsigned int protocols);
111 void snd_ump_endpoint_info_set_num_blocks(snd_ump_endpoint_info_t *info, unsigned int num_blocks);
112 void snd_ump_endpoint_info_set_version(snd_ump_endpoint_info_t *info, unsigned int version);
116 void snd_ump_endpoint_info_set_sw_revision(snd_ump_endpoint_info_t *info, const unsigned char *id);
117 void snd_ump_endpoint_info_set_name(snd_ump_endpoint_info_t *info, const char *name);
119 
121 #define SND_UMP_BLOCK_IS_MIDI1 (1U << 0)
122 
123 #define SND_UMP_BLOCK_IS_LOWSPEED (1U << 1)
124 
135 };
136 
138 #define SND_UMP_BLOCK_INFO_DEFAULT_MIDI_CI_VERSION 0x01
139 
140 size_t snd_ump_block_info_sizeof(void);
145 #define snd_ump_block_info_alloca(ptr) __snd_alloca(ptr, snd_ump_block_info)
152 unsigned int snd_ump_block_info_get_block_id(const snd_ump_block_info_t *info);
153 unsigned int snd_ump_block_info_get_active(const snd_ump_block_info_t *info);
154 unsigned int snd_ump_block_info_get_flags(const snd_ump_block_info_t *info);
160 unsigned int snd_ump_block_info_get_ui_hint(const snd_ump_block_info_t *info);
161 const char *snd_ump_block_info_get_name(const snd_ump_block_info_t *info);
163 
164 void snd_ump_block_info_set_card(snd_ump_block_info_t *info, unsigned int card);
165 void snd_ump_block_info_set_device(snd_ump_block_info_t *info, unsigned int device);
166 void snd_ump_block_info_set_block_id(snd_ump_block_info_t *info, unsigned int id);
167 void snd_ump_block_info_set_active(snd_ump_block_info_t *info, unsigned int active);
169 void snd_ump_block_info_set_direction(snd_ump_block_info_t *info, unsigned int direction);
170 void snd_ump_block_info_set_first_group(snd_ump_block_info_t *info, unsigned int first_group);
171 void snd_ump_block_info_set_num_groups(snd_ump_block_info_t *info, unsigned int num_groups);
172 void snd_ump_block_info_set_midi_ci_version(snd_ump_block_info_t *info, unsigned int version);
173 void snd_ump_block_info_set_sysex8_streams(snd_ump_block_info_t *info, unsigned int streams);
174 void snd_ump_block_info_set_ui_hint(snd_ump_block_info_t *info, unsigned int hint);
175 void snd_ump_block_info_set_name(snd_ump_block_info_t *info, const char *name);
176 
179 #ifdef __cplusplus
180 }
181 #endif
182 
183 #endif /* __ALSA_UMP_H */
struct _snd_rawmidi_params snd_rawmidi_params_t
Definition: rawmidi.h:47
size_t snd_ump_block_info_sizeof(void)
get size of the snd_ump_block_info_t structure in bytes
Definition: ump.c:673
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_endpoint_info_malloc(snd_ump_endpoint_info_t **info)
allocate the snd_ump_endpoint_info_t structure
Definition: ump.c:343
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_endpoint_info_get_protocol_caps(const snd_ump_endpoint_info_t *info)
get UMP endpoint protocol capability bits
Definition: ump.c:420
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
struct _snd_ump snd_ump_t
Definition: ump.h:23
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:906
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
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_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:938
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
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
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
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
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_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
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
Definition: ump.h:55
unsigned int snd_ump_block_info_get_flags(const snd_ump_block_info_t *info)
get UMP block information flags
Definition: ump.c:773
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
const char * snd_ump_endpoint_info_get_name(const snd_ump_endpoint_info_t *info)
get UMP endpoint name string
Definition: ump.c:500
unsigned int snd_ump_endpoint_info_get_model_id(const snd_ump_endpoint_info_t *info)
get UMP model ID
Definition: ump.c:480
uint8_t status
Definition: ump_msg.h:187
struct _snd_rawmidi_info snd_rawmidi_info_t
Definition: rawmidi.h:45
_snd_ump_block_ui_hint
Definition: ump.h:126
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_ui_hint(const snd_ump_block_info_t *info)
get UI hint of the given UMP block
Definition: ump.c:833
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(snd_ump_endpoint_info_t *info, unsigned int protocols)
set the current protocol of UMP endpoint
Definition: ump.c:564
_snd_ump_direction
Definition: ump.h:53
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:960
int snd_ump_nonblock(snd_ump_t *ump, int nonblock)
set nonblock mode
Definition: ump.c:211
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_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:949
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
size_t snd_ump_endpoint_info_sizeof(void)
get size of the snd_ump_endpoint_info_t structure in bytes
Definition: ump.c:330
Definition: ump.h:130
int snd_ump_block_info(snd_ump_t *ump, snd_ump_block_info_t *info)
get UMP block information
Definition: ump.c:985
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_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:927
int snd_ump_poll_descriptors_count(snd_ump_t *ump)
get count of poll descriptors for UMP handle
Definition: ump.c:169
Definition: ump.h:128
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
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
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
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:970
void snd_ump_block_info_free(snd_ump_block_info_t *info)
frees the snd_ump_block_info_t structure
Definition: ump.c:701
Definition: ump.h:59
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
struct snd_ump_block_info snd_ump_block_info_t
Definition: ump.h:27
void snd_ump_endpoint_info_clear(snd_ump_endpoint_info_t *info)
clears the snd_ump_endpoint_info_t structure
Definition: ump.c:369
struct snd_ump_endpoint_info snd_ump_endpoint_info_t
Definition: ump.h:25
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
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
unsigned int snd_ump_block_info_get_active(const snd_ump_block_info_t *info)
get UMP block activeness
Definition: ump.c:763
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
int snd_ump_poll_descriptors(snd_ump_t *ump, struct pollfd *pfds, unsigned int space)
get poll descriptors
Definition: ump.c:181
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:916
const char * snd_ump_name(snd_ump_t *ump)
get identifier of UMP handle
Definition: ump.c:159
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_flags(snd_ump_endpoint_info_t *info, unsigned int flags)
set info flags of UMP endpoint
Definition: ump.c:542
int snd_ump_endpoint_info_get_device(const snd_ump_endpoint_info_t *info)
get device number of UMP endpoint
Definition: ump.c:400
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
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
void snd_ump_block_info_clear(snd_ump_block_info_t *info)
clears the snd_ump_block_info_t structure
Definition: ump.c:712
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
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:886
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
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_family_id(const snd_ump_endpoint_info_t *info)
get UMP family ID
Definition: ump.c:470
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
Definition: ump.h:134
int snd_ump_rawmidi_info(snd_ump_t *ump, snd_rawmidi_info_t *info)
get information about associated RawMidi handle
Definition: ump.c:222
struct _snd_rawmidi_status snd_rawmidi_status_t
Definition: rawmidi.h:49
uint8_t flags
Definition: ump_msg.h:186
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
Definition: ump.h:57
ssize_t snd_ump_read(snd_ump_t *ump, void *buffer, size_t size)
read UMP packets from UMP stream
Definition: ump.c:303
int snd_ump_close(snd_ump_t *ump)
close UMP handle
Definition: ump.c:130
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
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_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:875
Definition: ump.h:132
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
struct _snd_rawmidi snd_rawmidi_t
Definition: rawmidi.h:68
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
int snd_ump_block_info_malloc(snd_ump_block_info_t **info)
allocate the snd_ump_block_info_t structure
Definition: ump.c:686
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_rawmidi_status(snd_ump_t *ump, snd_rawmidi_status_t *status)
get status of associated RawMidi stream
Definition: ump.c:255
int snd_ump_endpoint_info_get_card(const snd_ump_endpoint_info_t *info)
get card number of UMP endpoint
Definition: ump.c:390
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_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:896
int snd_ump_rawmidi_params(snd_ump_t *ump, snd_rawmidi_params_t *params)
set parameters about associated RawMidi stream
Definition: ump.c:233
unsigned int snd_ump_block_info_get_direction(const snd_ump_block_info_t *info)
get UMP block direction
Definition: ump.c:783
snd_rawmidi_t * snd_ump_rawmidi(snd_ump_t *ump)
get RawMidi instance associated with the UMP handle
Definition: ump.c:146