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

#ifndef SOUND_FIREWIRE_ISO_RESOURCES_H_INCLUDED
#define SOUND_FIREWIRE_ISO_RESOURCES_H_INCLUDED

#include <linux/mutex.h>
#include <linux/types.h>

struct fw_unit;

/**
 * struct fw_iso_resources - manages channel/bandwidth allocation
 * @channels_mask: if the device does not support all channel numbers, set this
 *                 bit mask to something else than the default (all ones)
 *
 * This structure manages (de)allocation of isochronous resources (channel and
 * bandwidth) for one isochronous stream.
 */
struct fw_iso_resources {
	u64 channels_mask;
	/* private: */
	struct fw_unit *unit;
	struct mutex mutex;
	unsigned int channel;
	unsigned int bandwidth; /* in bandwidth units, without overhead */
	unsigned int bandwidth_overhead;
	int generation; /* in which allocation is valid */
	bool allocated;
	__be32 buffer[2];
};

void fw_iso_resources_init(struct fw_iso_resources *r,
			   struct fw_unit *unit);
void fw_iso_resources_destroy(struct fw_iso_resources *r);

int fw_iso_resources_allocate(struct fw_iso_resources *r,
			      unsigned int max_payload_bytes, int speed);
int fw_iso_resources_update(struct fw_iso_resources *r);
void fw_iso_resources_free(struct fw_iso_resources *r);

#endif
Commit	Line	Data
31ef9134 CL	1	#ifndef SOUND_FIREWIRE_ISO_RESOURCES_H_INCLUDED
	2	#define SOUND_FIREWIRE_ISO_RESOURCES_H_INCLUDED
	3
	4	#include <linux/mutex.h>
	5	#include <linux/types.h>
	6
	7	struct fw_unit;
	8
	9	/**
	10	* struct fw_iso_resources - manages channel/bandwidth allocation
	11	* @channels_mask: if the device does not support all channel numbers, set this
	12	* bit mask to something else than the default (all ones)
	13	*
	14	* This structure manages (de)allocation of isochronous resources (channel and
	15	* bandwidth) for one isochronous stream.
	16	*/
	17	struct fw_iso_resources {
	18	u64 channels_mask;
	19	/* private: */
	20	struct fw_unit *unit;
	21	struct mutex mutex;
	22	unsigned int channel;
	23	unsigned int bandwidth; /* in bandwidth units, without overhead */
	24	unsigned int bandwidth_overhead;
	25	int generation; /* in which allocation is valid */
	26	bool allocated;
	27	__be32 buffer[2];
	28	};
	29
	30	void fw_iso_resources_init(struct fw_iso_resources *r,
	31	struct fw_unit *unit);
	32	void fw_iso_resources_destroy(struct fw_iso_resources *r);
	33
	34	int fw_iso_resources_allocate(struct fw_iso_resources *r,
	35	unsigned int max_payload_bytes, int speed);
	36	int fw_iso_resources_update(struct fw_iso_resources *r);
	37	void fw_iso_resources_free(struct fw_iso_resources *r);
	38
	39	#endif