xref: /kernel/linux/linux-6.6/drivers/usb/gadget/function/u_midi2.h

// SPDX-License-Identifier: GPL-2.0+
/*
 * Utility definitions for MIDI 2.0 function
 */

#ifndef U_MIDI2_H
#define U_MIDI2_H

#include <linux/usb/composite.h>
#include <sound/asound.h>

struct f_midi2_opts;
struct f_midi2_ep_opts;
struct f_midi2_block_opts;

/* UMP Function Block info */
struct f_midi2_block_info {
	unsigned int direction;		/* FB direction: 1-3 */
	unsigned int first_group;	/* first UMP group: 0-15 */
	unsigned int num_groups;	/* number of UMP groups: 1-16 */
	unsigned int midi1_first_group;	/* first UMP group for MIDI 1.0 */
	unsigned int midi1_num_groups;	/* number of UMP groups for MIDI 1.0 */
	unsigned int ui_hint;		/* UI-hint: 0-3 */
	unsigned int midi_ci_version;	/* MIDI-CI version: 0-255 */
	unsigned int sysex8_streams;	/* number of sysex8 streams: 0-255 */
	unsigned int is_midi1;		/* MIDI 1.0 port: 0-2 */
	bool active;			/* FB active flag: bool */
	const char *name;		/* FB name */
};

/* UMP Endpoint info */
struct f_midi2_ep_info {
	unsigned int protocol_caps;	/* protocol capabilities: 1-3 */
	unsigned int protocol;		/* default protocol: 1-2 */
	unsigned int manufacturer;	/* manufacturer id: 0-0xffffff */
	unsigned int family;		/* device family id: 0-0xffff */
	unsigned int model;		/* device model id: 0x-0xffff */
	unsigned int sw_revision;	/* software revision: 32bit */

	const char *ep_name;		/* Endpoint name */
	const char *product_id;		/* Product ID */
};

struct f_midi2_card_info {
	bool process_ump;		/* process UMP stream: bool */
	bool static_block;		/* static FBs: bool */
	unsigned int req_buf_size;	/* request buffer size */
	unsigned int num_reqs;		/* number of requests */
	const char *iface_name;		/* interface name */
};

struct f_midi2_block_opts {
	struct config_group group;
	unsigned int id;
	struct f_midi2_block_info info;
	struct f_midi2_ep_opts *ep;
};

struct f_midi2_ep_opts {
	struct config_group group;
	unsigned int index;
	struct f_midi2_ep_info info;
	struct f_midi2_block_opts *blks[SNDRV_UMP_MAX_BLOCKS];
	struct f_midi2_opts *opts;
};

#define MAX_UMP_EPS		4
#define MAX_CABLES		16

struct f_midi2_opts {
	struct usb_function_instance func_inst;
	struct mutex lock;
	int refcnt;

	struct f_midi2_card_info info;

	unsigned int num_eps;
	struct f_midi2_ep_opts *eps[MAX_UMP_EPS];
};

#endif /* U_MIDI2_H */