mirror of
https://github.com/alsa-project/alsa-lib.git
synced 2026-02-05 04:06:34 -05:00
ump: Add initial support
This patch adds the initial support for UMP rawmidi access. It's merely the wrapper for the standard rawmidi to access to the UMP rawmidi device. Signed-off-by: Takashi Iwai <tiwai@suse.de>
This commit is contained in:
Takashi Iwai
parent
6627953de0
commit
f47763d2c1
10 changed files with 769 additions and 4 deletions
|
|
@ -34,7 +34,7 @@ endif
|
|||
endif
|
||||
|
||||
if BUILD_RAWMIDI
|
||||
alsainclude_HEADERS += rawmidi.h
|
||||
alsainclude_HEADERS += rawmidi.h ump.h
|
||||
endif
|
||||
|
||||
if BUILD_HWDEP
|
||||
|
|
|
|||
|
|
@ -93,6 +93,9 @@ typedef enum _snd_rawmidi_read_mode {
|
|||
SND_RAWMIDI_READ_TSTAMP = 1,
|
||||
} snd_rawmidi_read_mode_t;
|
||||
|
||||
/** rawmidi info bit flags */
|
||||
#define SND_RAWMIDI_INFO_UMP 0x00000008 /* rawmidi is UMP */
|
||||
|
||||
int snd_rawmidi_open(snd_rawmidi_t **in_rmidi, snd_rawmidi_t **out_rmidi,
|
||||
const char *name, int mode);
|
||||
int snd_rawmidi_open_lconf(snd_rawmidi_t **in_rmidi, snd_rawmidi_t **out_rmidi,
|
||||
|
|
|
|||
119
include/ump.h
Normal file
119
include/ump.h
Normal file
|
|
@ -0,0 +1,119 @@
|
|||
/* SPDX-License-Identifier: LGPL-2.1+ */
|
||||
/**
|
||||
* \file include/ump.h
|
||||
* \brief API library for ALSA rawmidi/UMP interface
|
||||
*
|
||||
* API library for ALSA rawmidi/UMP interface
|
||||
*/
|
||||
|
||||
#ifndef __ALSA_UMP_H
|
||||
#define __ALSA_UMP_H
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/** UMP (Endpoint) RawMIDI device */
|
||||
typedef struct _snd_ump snd_ump_t;
|
||||
/** UMP Endpoint information container */
|
||||
typedef struct snd_ump_endpoint_info snd_ump_endpoint_info_t;
|
||||
/** UMP Block information container */
|
||||
typedef struct snd_ump_block_info snd_ump_block_info_t;
|
||||
|
||||
int snd_ump_open(snd_ump_t **inputp, snd_ump_t **outputp, const char *name, int mode);
|
||||
int snd_ump_close(snd_ump_t *ump);
|
||||
snd_rawmidi_t *snd_ump_rawmidi(snd_ump_t *ump);
|
||||
const char *snd_ump_name(snd_ump_t *ump);
|
||||
int snd_ump_poll_descriptors_count(snd_ump_t *ump);
|
||||
int snd_ump_poll_descriptors(snd_ump_t *ump, struct pollfd *pfds, unsigned int space);
|
||||
int snd_ump_poll_descriptors_revents(snd_ump_t *ump, struct pollfd *pfds, unsigned int nfds, unsigned short *revents);
|
||||
int snd_ump_nonblock(snd_ump_t *ump, int nonblock);
|
||||
int snd_ump_rawmidi_info(snd_ump_t *ump, snd_rawmidi_info_t *info);
|
||||
int snd_ump_rawmidi_params(snd_ump_t *ump, snd_rawmidi_params_t *params);
|
||||
int snd_ump_rawmidi_params_current(snd_ump_t *ump, snd_rawmidi_params_t *params);
|
||||
int snd_ump_rawmidi_status(snd_ump_t *ump, snd_rawmidi_status_t *status);
|
||||
int snd_ump_drop(snd_ump_t *ump);
|
||||
int snd_ump_drain(snd_ump_t *ump);
|
||||
ssize_t snd_ump_write(snd_ump_t *ump, const void *buffer, size_t size);
|
||||
ssize_t snd_ump_read(snd_ump_t *ump, void *buffer, size_t size);
|
||||
ssize_t snd_ump_tread(snd_ump_t *ump, struct timespec *tstamp, void *buffer, size_t size);
|
||||
|
||||
/** Max number of UMP Groups */
|
||||
#define SND_UMP_MAX_GROUPS 16
|
||||
/** Max number of UMP Blocks */
|
||||
#define SND_UMP_MAX_BLOCKS 32
|
||||
|
||||
/** UMP direction */
|
||||
enum _snd_ump_direction {
|
||||
/** Input only */
|
||||
SND_UMP_DIR_INPUT = 0x01,
|
||||
/** Output only */
|
||||
SND_UMP_DIR_OUTPUT = 0x02,
|
||||
/** Bidirectional */
|
||||
SND_UMP_DIR_BIDIRECTION = 0x03,
|
||||
};
|
||||
|
||||
/** Bitmask for UMP EP MIDI protocols */
|
||||
#define SND_UMP_EP_INFO_PROTO_MIDI_MASK 0x0300
|
||||
/** Bit flag for MIDI 1.0 protocol */
|
||||
#define SND_UMP_EP_INFO_PROTO_MIDI1 0x0100
|
||||
/** Bit flag for MIDI 2.0 protocol */
|
||||
#define SND_UMP_EP_INFO_PROTO_MIDI2 0x0200
|
||||
/** Bitmask for UMP Jitter-reduction timestamp */
|
||||
#define SND_UMP_EP_INFO_PROTO_JRTS_MASK 0x0003
|
||||
/** Bit flag for JRTS in Transmit */
|
||||
#define SND_UMP_EP_INFO_PROTO_JRTS_TX 0x0001
|
||||
/** Bit flag for JRTS in Receive */
|
||||
#define SND_UMP_EP_INFO_PROTO_JRTS_RX 0x0002
|
||||
|
||||
size_t snd_ump_endpoint_info_sizeof(void);
|
||||
/** \hideinitializer
|
||||
* \brief allocate an invalid #snd_ump_endpoint_info_t using standard alloca
|
||||
* \param ptr returned pointer
|
||||
*/
|
||||
#define snd_ump_endpoint_info_alloca(ptr) __snd_alloca(ptr, snd_ump_endpoint_info)
|
||||
int snd_ump_endpoint_info_malloc(snd_ump_endpoint_info_t **info);
|
||||
void snd_ump_endpoint_info_free(snd_ump_endpoint_info_t *info);
|
||||
void snd_ump_endpoint_info_copy(snd_ump_endpoint_info_t *dst, const snd_ump_endpoint_info_t *src);
|
||||
int snd_ump_endpoint_info_get_card(const snd_ump_endpoint_info_t *info);
|
||||
int snd_ump_endpoint_info_get_device(const snd_ump_endpoint_info_t *info);
|
||||
unsigned int snd_ump_endpoint_info_get_flags(const snd_ump_endpoint_info_t *info);
|
||||
unsigned int snd_ump_endpoint_info_get_protocol_caps(const snd_ump_endpoint_info_t *info);
|
||||
unsigned int snd_ump_endpoint_info_get_protocol(const snd_ump_endpoint_info_t *info);
|
||||
unsigned int snd_ump_endpoint_info_get_num_blocks(const snd_ump_endpoint_info_t *info);
|
||||
unsigned int snd_ump_endpoint_info_get_version(const snd_ump_endpoint_info_t *info);
|
||||
const char *snd_ump_endpoint_info_get_name(const snd_ump_endpoint_info_t *info);
|
||||
const char *snd_ump_endpoint_info_get_product_id(const snd_ump_endpoint_info_t *info);
|
||||
int snd_ump_endpoint_info(snd_ump_t *ump, snd_ump_endpoint_info_t *info);
|
||||
|
||||
/** Bit flag for MIDI 1.0 port w/o restrict in UMP Block info flags */
|
||||
#define SND_UMP_BLOCK_IS_MIDI1 (1U << 0)
|
||||
/** Bit flag for 31.25Kbps B/W MIDI1 port in UMP Block info flags */
|
||||
#define SND_UMP_BLOCK_IS_LOWSPEED (1U << 1)
|
||||
|
||||
size_t snd_ump_block_info_sizeof(void);
|
||||
/** \hideinitializer
|
||||
* \brief allocate an invalid #snd_ump_block_info_t using standard alloca
|
||||
* \param ptr returned pointer
|
||||
*/
|
||||
#define snd_ump_block_info_alloca(ptr) __snd_alloca(ptr, snd_ump_block_info)
|
||||
int snd_ump_block_info_malloc(snd_ump_block_info_t **info);
|
||||
void snd_ump_block_info_free(snd_ump_block_info_t *info);
|
||||
void snd_ump_block_info_copy(snd_ump_block_info_t *dst, const snd_ump_block_info_t *src);
|
||||
int snd_ump_block_info_get_card(const snd_ump_block_info_t *info);
|
||||
int snd_ump_block_info_get_device(const snd_ump_block_info_t *info);
|
||||
unsigned int snd_ump_block_info_get_block_id(const snd_ump_block_info_t *info);
|
||||
void snd_ump_block_info_set_block_id(snd_ump_block_info_t *info, unsigned int id);
|
||||
unsigned int snd_ump_block_info_get_active(const snd_ump_block_info_t *info);
|
||||
unsigned int snd_ump_block_info_get_flags(const snd_ump_block_info_t *info);
|
||||
unsigned int snd_ump_block_info_get_direction(const snd_ump_block_info_t *info);
|
||||
unsigned int snd_ump_block_info_get_first_group(const snd_ump_block_info_t *info);
|
||||
unsigned int snd_ump_block_info_get_num_groups(const snd_ump_block_info_t *info);
|
||||
const char *snd_ump_block_info_get_name(const snd_ump_block_info_t *info);
|
||||
int snd_ump_block_info(snd_ump_t *ump, snd_ump_block_info_t *info);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif /* __ALSA_UMP_H */
|
||||
Loading…
Add table
Add a link
Reference in a new issue