[mirror_ubuntu-bionic-kernel.git] / sound / firewire / cmp.h

/* SPDX-License-Identifier: GPL-2.0 */
#ifndef SOUND_FIREWIRE_CMP_H_INCLUDED
#define SOUND_FIREWIRE_CMP_H_INCLUDED

#include <linux/mutex.h>
#include <linux/types.h>
#include "iso-resources.h"

struct fw_unit;

enum cmp_direction {
	CMP_INPUT = 0,
	CMP_OUTPUT,
};

/**
 * struct cmp_connection - manages an isochronous connection to a device
 * @speed: the connection's actual speed
 *
 * This structure manages (using CMP) an isochronous stream between the local
 * computer and a device's input plug (iPCR) and output plug (oPCR).
 *
 * There is no corresponding oPCR created on the local computer, so it is not
 * possible to overlay connections on top of this one.
 */
struct cmp_connection {
	int speed;
	/* private: */
	bool connected;
	struct mutex mutex;
	struct fw_iso_resources resources;
	__be32 last_pcr_value;
	unsigned int pcr_index;
	unsigned int max_speed;
	enum cmp_direction direction;
};

int cmp_connection_init(struct cmp_connection *connection,
			struct fw_unit *unit,
			enum cmp_direction direction,
			unsigned int pcr_index);
int cmp_connection_check_used(struct cmp_connection *connection, bool *used);
void cmp_connection_destroy(struct cmp_connection *connection);

int cmp_connection_establish(struct cmp_connection *connection,
			     unsigned int max_payload);
int cmp_connection_update(struct cmp_connection *connection);
void cmp_connection_break(struct cmp_connection *connection);

#endif
Commit	Line	Data
b2441318	1	/* SPDX-License-Identifier: GPL-2.0 */
31ef9134 CL	2	#ifndef SOUND_FIREWIRE_CMP_H_INCLUDED
	3	#define SOUND_FIREWIRE_CMP_H_INCLUDED
	4
	5	#include <linux/mutex.h>
	6	#include <linux/types.h>
	7	#include "iso-resources.h"
	8
	9	struct fw_unit;
	10
c68a1c65 TS	11	enum cmp_direction {
	12	CMP_INPUT = 0,
	13	CMP_OUTPUT,
	14	};
	15
31ef9134 CL	16	/**
	17	* struct cmp_connection - manages an isochronous connection to a device
	18	* @speed: the connection's actual speed
	19	*
a7fa0d04 TS	20	* This structure manages (using CMP) an isochronous stream between the local
a7fa0d04 TS	21	* computer and a device's input plug (iPCR) and output plug (oPCR).
31ef9134 CL	22	*
	23	* There is no corresponding oPCR created on the local computer, so it is not
	24	* possible to overlay connections on top of this one.
	25	*/
	26	struct cmp_connection {
	27	int speed;
	28	/* private: */
	29	bool connected;
	30	struct mutex mutex;
	31	struct fw_iso_resources resources;
	32	__be32 last_pcr_value;
	33	unsigned int pcr_index;
	34	unsigned int max_speed;
c68a1c65	35	enum cmp_direction direction;
31ef9134 CL	36	};
	37
	38	int cmp_connection_init(struct cmp_connection *connection,
	39	struct fw_unit *unit,
c68a1c65	40	enum cmp_direction direction,
a7fa0d04	41	unsigned int pcr_index);
b04479fb	42	int cmp_connection_check_used(struct cmp_connection connection, bool used);
31ef9134 CL	43	void cmp_connection_destroy(struct cmp_connection *connection);
	44
	45	int cmp_connection_establish(struct cmp_connection *connection,
	46	unsigned int max_payload);
	47	int cmp_connection_update(struct cmp_connection *connection);
	48	void cmp_connection_break(struct cmp_connection *connection);
	49
	50	#endif