audio/ipc.h - bluez-imx - Git at Google

 /*
  *
  *  BlueZ - Bluetooth protocol stack for Linux
  *
  *  Copyright (C) 2004-2008  Marcel Holtmann <marcel@holtmann.org>
  *
  *  This library is free software; you can redistribute it and/or
  *  modify it under the terms of the GNU Lesser General Public
  *  License as published by the Free Software Foundation; either
  *  version 2.1 of the License, or (at your option) any later version.
  *
  *  This library is distributed in the hope that it will be useful,
  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  *  Lesser General Public License for more details.
  *
  *  You should have received a copy of the GNU Lesser General Public
  *  License along with this library; if not, write to the Free Software
  *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  *
  */

 /*
   Message sequence chart of streaming sequence for A2DP transport

   Audio daemon                       User
                              on snd_pcm_open
                  <--BT_GETCAPABILITIES_REQ

   BT_GETCAPABILITIES_RSP-->

                         on snd_pcm_hw_params
                 <--BT_SETCONFIGURATION_REQ

   BT_SETCONFIGURATION_RSP-->

 			on snd_pcm_prepare
                 <--BT_STREAMSTART_REQ

   <Moves to streaming state>
   BT_STREAMSTART_RSP-->

   BT_STREAMFD_IND -->

                           <  streams data >
                              ..........

                on snd_pcm_drop/snd_pcm_drain

                 <--BT_STREAMSTOP_REQ

   <Moves to open state>
   BT_STREAMSTOP_RSP-->

 			on IPC close or appl crash
   <Moves to idle>

  */

 #ifndef BT_AUDIOCLIENT_H
 #define BT_AUDIOCLIENT_H

 #ifdef __cplusplus
 extern "C" {
 #endif

 #include <stdint.h>
 #include <stdio.h>
 #include <unistd.h>
 #include <sys/socket.h>
 #include <sys/un.h>
 #include <errno.h>

 #define BT_AUDIO_IPC_PACKET_SIZE   128
 #define BT_IPC_SOCKET_NAME "\0/org/bluez/audio"

 /* Generic message header definition, except for RSP messages */
 typedef struct {
 	uint8_t msg_type;
 } __attribute__ ((packed)) bt_audio_msg_header_t;

 /* Generic message header definition, for all RSP messages */
 typedef struct {
 	bt_audio_msg_header_t	msg_h;
 	uint8_t			posix_errno;
 } __attribute__ ((packed)) bt_audio_rsp_msg_header_t;

 /* Messages list */
 #define BT_GETCAPABILITIES_REQ		0
 #define BT_GETCAPABILITIES_RSP		1

 #define BT_SETCONFIGURATION_REQ		2
 #define BT_SETCONFIGURATION_RSP		3

 #define BT_STREAMSTART_REQ		4
 #define BT_STREAMSTART_RSP		5

 #define BT_STREAMSTOP_REQ		6
 #define BT_STREAMSTOP_RSP		7

 #define BT_STREAMSUSPEND_IND		8
 #define BT_STREAMRESUME_IND		9

 #define BT_CONTROL_REQ		       10
 #define BT_CONTROL_RSP		       11
 #define BT_CONTROL_IND		       12

 #define BT_STREAMFD_IND		       13

 /* BT_GETCAPABILITIES_REQ */

 #define BT_CAPABILITIES_TRANSPORT_A2DP	0
 #define BT_CAPABILITIES_TRANSPORT_SCO	1
 #define BT_CAPABILITIES_TRANSPORT_ANY	2

 #define BT_CAPABILITIES_ACCESS_MODE_READ	1
 #define BT_CAPABILITIES_ACCESS_MODE_WRITE	2
 #define BT_CAPABILITIES_ACCESS_MODE_READWRITE	3

 #define BT_FLAG_AUTOCONNECT	1

 struct bt_getcapabilities_req {
 	bt_audio_msg_header_t	h;
 	char			device[18];	/* Address of the remote Device */
 	uint8_t			transport;	/* Requested transport */
 	uint8_t			flags;		/* Requested flags */
 } __attribute__ ((packed));

 /* BT_GETCAPABILITIES_RSP */

 /**
  * SBC Codec parameters as per A2DP profile 1.0 § 4.3
  */

 #define BT_SBC_SAMPLING_FREQ_16000		(1 << 3)
 #define BT_SBC_SAMPLING_FREQ_32000		(1 << 2)
 #define BT_SBC_SAMPLING_FREQ_44100		(1 << 1)
 #define BT_SBC_SAMPLING_FREQ_48000		1

 #define BT_A2DP_CHANNEL_MODE_MONO		(1 << 3)
 #define BT_A2DP_CHANNEL_MODE_DUAL_CHANNEL	(1 << 2)
 #define BT_A2DP_CHANNEL_MODE_STEREO		(1 << 1)
 #define BT_A2DP_CHANNEL_MODE_JOINT_STEREO	1

 #define BT_A2DP_BLOCK_LENGTH_4			(1 << 3)
 #define BT_A2DP_BLOCK_LENGTH_8			(1 << 2)
 #define BT_A2DP_BLOCK_LENGTH_12			(1 << 1)
 #define BT_A2DP_BLOCK_LENGTH_16			1

 #define BT_A2DP_SUBBANDS_4			(1 << 1)
 #define BT_A2DP_SUBBANDS_8			1

 #define BT_A2DP_ALLOCATION_SNR			(1 << 1)
 #define BT_A2DP_ALLOCATION_LOUDNESS		1

 #define BT_MPEG_SAMPLING_FREQ_16000		(1 << 5)
 #define BT_MPEG_SAMPLING_FREQ_22050		(1 << 4)
 #define BT_MPEG_SAMPLING_FREQ_24000		(1 << 3)
 #define BT_MPEG_SAMPLING_FREQ_32000		(1 << 2)
 #define BT_MPEG_SAMPLING_FREQ_44100		(1 << 1)
 #define BT_MPEG_SAMPLING_FREQ_48000		1

 #define BT_MPEG_LAYER_1				(1 << 2)
 #define BT_MPEG_LAYER_2				(1 << 1)
 #define BT_MPEG_LAYER_3				1

 typedef struct {
 	uint8_t channel_mode;
 	uint8_t frequency;
 	uint8_t allocation_method;
 	uint8_t subbands;
 	uint8_t block_length;
 	uint8_t min_bitpool;
 	uint8_t max_bitpool;
 } __attribute__ ((packed)) sbc_capabilities_t;

 typedef struct {
 	uint8_t channel_mode;
 	uint8_t crc;
 	uint8_t layer;
 	uint8_t frequency;
 	uint8_t mpf;
 	uint16_t bitrate;
 } __attribute__ ((packed)) mpeg_capabilities_t;

 struct bt_getcapabilities_rsp {
 	bt_audio_rsp_msg_header_t	rsp_h;
 	uint8_t				transport;	   /* Granted transport */
 	sbc_capabilities_t		sbc_capabilities;  /* A2DP only */
 	mpeg_capabilities_t		mpeg_capabilities; /* A2DP only */
 	uint16_t			sampling_rate;	   /* SCO only */
 } __attribute__ ((packed));

 /* BT_SETCONFIGURATION_REQ */
 struct bt_setconfiguration_req {
 	bt_audio_msg_header_t	h;
 	char			device[18];		/* Address of the remote Device */
 	uint8_t			transport;		/* Requested transport */
 	uint8_t			access_mode;		/* Requested access mode */
 	sbc_capabilities_t	sbc_capabilities;	/* A2DP only - only one of this field
 							and next one must be filled */
 	mpeg_capabilities_t	mpeg_capabilities;	/* A2DP only */
 } __attribute__ ((packed));

 /* BT_SETCONFIGURATION_RSP */
 struct bt_setconfiguration_rsp {
 	bt_audio_rsp_msg_header_t	rsp_h;
 	uint8_t				transport;	/* Granted transport */
 	uint8_t				access_mode;	/* Granted access mode */
 	uint16_t			link_mtu;	/* Max length that transport supports */
 } __attribute__ ((packed));

 /* BT_STREAMSTART_REQ */
 #define BT_STREAM_ACCESS_READ		0
 #define BT_STREAM_ACCESS_WRITE		1
 #define BT_STREAM_ACCESS_READWRITE	2
 struct bt_streamstart_req {
 	bt_audio_msg_header_t	h;
 } __attribute__ ((packed));

 /* BT_STREAMSTART_RSP */
 struct bt_streamstart_rsp {
 	bt_audio_rsp_msg_header_t	rsp_h;
 } __attribute__ ((packed));

 /* BT_STREAMFD_IND */
 /* This message is followed by one byte of data containing the stream data fd
    as ancilliary data */
 struct bt_streamfd_ind {
 	bt_audio_msg_header_t	h;
 } __attribute__ ((packed));

 /* BT_STREAMSTOP_REQ */
 struct bt_streamstop_req {
 	bt_audio_msg_header_t	h;
 } __attribute__ ((packed));

 /* BT_STREAMSTOP_RSP */
 struct bt_streamstop_rsp {
 	bt_audio_rsp_msg_header_t	rsp_h;
 } __attribute__ ((packed));

 /* BT_STREAMSUSPEND_IND */
 struct bt_streamsuspend_ind {
 	bt_audio_msg_header_t	h;
 } __attribute__ ((packed));

 /* BT_STREAMRESUME_IND */
 struct bt_streamresume_ind {
 	bt_audio_msg_header_t	h;
 } __attribute__ ((packed));

 /* BT_CONTROL_REQ */

 #define BT_CONTROL_KEY_POWER			0x40
 #define BT_CONTROL_KEY_VOL_UP			0x41
 #define BT_CONTROL_KEY_VOL_DOWN			0x42
 #define BT_CONTROL_KEY_MUTE			0x43
 #define BT_CONTROL_KEY_PLAY			0x44
 #define BT_CONTROL_KEY_STOP			0x45
 #define BT_CONTROL_KEY_PAUSE			0x46
 #define BT_CONTROL_KEY_RECORD			0x47
 #define BT_CONTROL_KEY_REWIND			0x48
 #define BT_CONTROL_KEY_FAST_FORWARD		0x49
 #define BT_CONTROL_KEY_EJECT			0x4A
 #define BT_CONTROL_KEY_FORWARD			0x4B
 #define BT_CONTROL_KEY_BACKWARD			0x4C

 struct bt_control_req {
 	bt_audio_msg_header_t	h;
 	uint8_t			mode;		/* Control Mode */
 	uint8_t			key;		/* Control Key */
 } __attribute__ ((packed));

 /* BT_CONTROL_RSP */
 struct bt_control_rsp {
 	bt_audio_rsp_msg_header_t	rsp_h;
 	uint8_t				mode;	/* Control Mode */
 	uint8_t				key;	/* Control Key */
 } __attribute__ ((packed));

 /* BT_CONTROL_IND */
 struct bt_control_ind {
 	bt_audio_msg_header_t	h;
 	uint8_t			mode;		/* Control Mode */
 	uint8_t			key;		/* Control Key */
 } __attribute__ ((packed));

 /* Function declaration */

 /* Opens a connection to the audio service: return a socket descriptor */
 int bt_audio_service_open(void);

 /* Closes a connection to the audio service */
 int bt_audio_service_close(int sk);

 /* Receives stream data file descriptor : must be called after a
 BT_STREAMFD_IND message is returned */
 int bt_audio_service_get_data_fd(int sk);

 /* Human readable message type string */
 const char *bt_audio_strmsg(int type);

 #ifdef __cplusplus
 }
 #endif

 #endif /* BT_AUDIOCLIENT_H */
	/*
	*
	* BlueZ - Bluetooth protocol stack for Linux
	*
	* Copyright (C) 2004-2008 Marcel Holtmann <marcel@holtmann.org>
	*
	* This library is free software; you can redistribute it and/or
	* modify it under the terms of the GNU Lesser General Public
	* License as published by the Free Software Foundation; either
	* version 2.1 of the License, or (at your option) any later version.
	*
	* This library is distributed in the hope that it will be useful,
	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	* Lesser General Public License for more details.
	*
	* You should have received a copy of the GNU Lesser General Public
	* License along with this library; if not, write to the Free Software
	* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
	*
	*/

	/*
	Message sequence chart of streaming sequence for A2DP transport

	Audio daemon User
	on snd_pcm_open
	<--BT_GETCAPABILITIES_REQ

	BT_GETCAPABILITIES_RSP-->

	on snd_pcm_hw_params
	<--BT_SETCONFIGURATION_REQ

	BT_SETCONFIGURATION_RSP-->

	on snd_pcm_prepare
	<--BT_STREAMSTART_REQ

	<Moves to streaming state>
	BT_STREAMSTART_RSP-->

	BT_STREAMFD_IND -->

	< streams data >
	..........

	on snd_pcm_drop/snd_pcm_drain

	<--BT_STREAMSTOP_REQ

	<Moves to open state>
	BT_STREAMSTOP_RSP-->

	on IPC close or appl crash
	<Moves to idle>

	*/

	#ifndef BT_AUDIOCLIENT_H
	#define BT_AUDIOCLIENT_H

	#ifdef __cplusplus
	extern "C" {
	#endif

	#include <stdint.h>
	#include <stdio.h>
	#include <unistd.h>
	#include <sys/socket.h>
	#include <sys/un.h>
	#include <errno.h>

	#define BT_AUDIO_IPC_PACKET_SIZE 128
	#define BT_IPC_SOCKET_NAME "\0/org/bluez/audio"

	/* Generic message header definition, except for RSP messages */
	typedef struct {
	uint8_t msg_type;
	} __attribute__ ((packed)) bt_audio_msg_header_t;

	/* Generic message header definition, for all RSP messages */
	typedef struct {
	bt_audio_msg_header_t msg_h;
	uint8_t posix_errno;
	} __attribute__ ((packed)) bt_audio_rsp_msg_header_t;

	/* Messages list */
	#define BT_GETCAPABILITIES_REQ 0
	#define BT_GETCAPABILITIES_RSP 1

	#define BT_SETCONFIGURATION_REQ 2
	#define BT_SETCONFIGURATION_RSP 3

	#define BT_STREAMSTART_REQ 4
	#define BT_STREAMSTART_RSP 5

	#define BT_STREAMSTOP_REQ 6
	#define BT_STREAMSTOP_RSP 7

	#define BT_STREAMSUSPEND_IND 8
	#define BT_STREAMRESUME_IND 9

	#define BT_CONTROL_REQ 10
	#define BT_CONTROL_RSP 11
	#define BT_CONTROL_IND 12

	#define BT_STREAMFD_IND 13

	/* BT_GETCAPABILITIES_REQ */

	#define BT_CAPABILITIES_TRANSPORT_A2DP 0
	#define BT_CAPABILITIES_TRANSPORT_SCO 1
	#define BT_CAPABILITIES_TRANSPORT_ANY 2

	#define BT_CAPABILITIES_ACCESS_MODE_READ 1
	#define BT_CAPABILITIES_ACCESS_MODE_WRITE 2
	#define BT_CAPABILITIES_ACCESS_MODE_READWRITE 3

	#define BT_FLAG_AUTOCONNECT 1

	struct bt_getcapabilities_req {
	bt_audio_msg_header_t h;
	char device[18]; /* Address of the remote Device */
	uint8_t transport; /* Requested transport */
	uint8_t flags; /* Requested flags */
	} __attribute__ ((packed));

	/* BT_GETCAPABILITIES_RSP */

	/**
	* SBC Codec parameters as per A2DP profile 1.0 § 4.3
	*/

	#define BT_SBC_SAMPLING_FREQ_16000 (1 << 3)
	#define BT_SBC_SAMPLING_FREQ_32000 (1 << 2)
	#define BT_SBC_SAMPLING_FREQ_44100 (1 << 1)
	#define BT_SBC_SAMPLING_FREQ_48000 1

	#define BT_A2DP_CHANNEL_MODE_MONO (1 << 3)
	#define BT_A2DP_CHANNEL_MODE_DUAL_CHANNEL (1 << 2)
	#define BT_A2DP_CHANNEL_MODE_STEREO (1 << 1)
	#define BT_A2DP_CHANNEL_MODE_JOINT_STEREO 1

	#define BT_A2DP_BLOCK_LENGTH_4 (1 << 3)
	#define BT_A2DP_BLOCK_LENGTH_8 (1 << 2)
	#define BT_A2DP_BLOCK_LENGTH_12 (1 << 1)
	#define BT_A2DP_BLOCK_LENGTH_16 1

	#define BT_A2DP_SUBBANDS_4 (1 << 1)
	#define BT_A2DP_SUBBANDS_8 1

	#define BT_A2DP_ALLOCATION_SNR (1 << 1)
	#define BT_A2DP_ALLOCATION_LOUDNESS 1

	#define BT_MPEG_SAMPLING_FREQ_16000 (1 << 5)
	#define BT_MPEG_SAMPLING_FREQ_22050 (1 << 4)
	#define BT_MPEG_SAMPLING_FREQ_24000 (1 << 3)
	#define BT_MPEG_SAMPLING_FREQ_32000 (1 << 2)
	#define BT_MPEG_SAMPLING_FREQ_44100 (1 << 1)
	#define BT_MPEG_SAMPLING_FREQ_48000 1

	#define BT_MPEG_LAYER_1 (1 << 2)
	#define BT_MPEG_LAYER_2 (1 << 1)
	#define BT_MPEG_LAYER_3 1

	typedef struct {
	uint8_t channel_mode;
	uint8_t frequency;
	uint8_t allocation_method;
	uint8_t subbands;
	uint8_t block_length;
	uint8_t min_bitpool;
	uint8_t max_bitpool;
	} __attribute__ ((packed)) sbc_capabilities_t;

	typedef struct {
	uint8_t channel_mode;
	uint8_t crc;
	uint8_t layer;
	uint8_t frequency;
	uint8_t mpf;
	uint16_t bitrate;
	} __attribute__ ((packed)) mpeg_capabilities_t;

	struct bt_getcapabilities_rsp {
	bt_audio_rsp_msg_header_t rsp_h;
	uint8_t transport; /* Granted transport */
	sbc_capabilities_t sbc_capabilities; /* A2DP only */
	mpeg_capabilities_t mpeg_capabilities; /* A2DP only */
	uint16_t sampling_rate; /* SCO only */
	} __attribute__ ((packed));

	/* BT_SETCONFIGURATION_REQ */
	struct bt_setconfiguration_req {
	bt_audio_msg_header_t h;
	char device[18]; /* Address of the remote Device */
	uint8_t transport; /* Requested transport */
	uint8_t access_mode; /* Requested access mode */
	sbc_capabilities_t sbc_capabilities; /* A2DP only - only one of this field
	and next one must be filled */
	mpeg_capabilities_t mpeg_capabilities; /* A2DP only */
	} __attribute__ ((packed));

	/* BT_SETCONFIGURATION_RSP */
	struct bt_setconfiguration_rsp {
	bt_audio_rsp_msg_header_t rsp_h;
	uint8_t transport; /* Granted transport */
	uint8_t access_mode; /* Granted access mode */
	uint16_t link_mtu; /* Max length that transport supports */
	} __attribute__ ((packed));

	/* BT_STREAMSTART_REQ */
	#define BT_STREAM_ACCESS_READ 0
	#define BT_STREAM_ACCESS_WRITE 1
	#define BT_STREAM_ACCESS_READWRITE 2
	struct bt_streamstart_req {
	bt_audio_msg_header_t h;
	} __attribute__ ((packed));

	/* BT_STREAMSTART_RSP */
	struct bt_streamstart_rsp {
	bt_audio_rsp_msg_header_t rsp_h;
	} __attribute__ ((packed));

	/* BT_STREAMFD_IND */
	/* This message is followed by one byte of data containing the stream data fd
	as ancilliary data */
	struct bt_streamfd_ind {
	bt_audio_msg_header_t h;
	} __attribute__ ((packed));

	/* BT_STREAMSTOP_REQ */
	struct bt_streamstop_req {
	bt_audio_msg_header_t h;
	} __attribute__ ((packed));

	/* BT_STREAMSTOP_RSP */
	struct bt_streamstop_rsp {
	bt_audio_rsp_msg_header_t rsp_h;
	} __attribute__ ((packed));

	/* BT_STREAMSUSPEND_IND */
	struct bt_streamsuspend_ind {
	bt_audio_msg_header_t h;
	} __attribute__ ((packed));

	/* BT_STREAMRESUME_IND */
	struct bt_streamresume_ind {
	bt_audio_msg_header_t h;
	} __attribute__ ((packed));

	/* BT_CONTROL_REQ */

	#define BT_CONTROL_KEY_POWER 0x40
	#define BT_CONTROL_KEY_VOL_UP 0x41
	#define BT_CONTROL_KEY_VOL_DOWN 0x42
	#define BT_CONTROL_KEY_MUTE 0x43
	#define BT_CONTROL_KEY_PLAY 0x44
	#define BT_CONTROL_KEY_STOP 0x45
	#define BT_CONTROL_KEY_PAUSE 0x46
	#define BT_CONTROL_KEY_RECORD 0x47
	#define BT_CONTROL_KEY_REWIND 0x48
	#define BT_CONTROL_KEY_FAST_FORWARD 0x49
	#define BT_CONTROL_KEY_EJECT 0x4A
	#define BT_CONTROL_KEY_FORWARD 0x4B
	#define BT_CONTROL_KEY_BACKWARD 0x4C

	struct bt_control_req {
	bt_audio_msg_header_t h;
	uint8_t mode; /* Control Mode */
	uint8_t key; /* Control Key */
	} __attribute__ ((packed));

	/* BT_CONTROL_RSP */
	struct bt_control_rsp {
	bt_audio_rsp_msg_header_t rsp_h;
	uint8_t mode; /* Control Mode */
	uint8_t key; /* Control Key */
	} __attribute__ ((packed));

	/* BT_CONTROL_IND */
	struct bt_control_ind {
	bt_audio_msg_header_t h;
	uint8_t mode; /* Control Mode */
	uint8_t key; /* Control Key */
	} __attribute__ ((packed));

	/* Function declaration */

	/* Opens a connection to the audio service: return a socket descriptor */
	int bt_audio_service_open(void);

	/* Closes a connection to the audio service */
	int bt_audio_service_close(int sk);

	/* Receives stream data file descriptor : must be called after a
	BT_STREAMFD_IND message is returned */
	int bt_audio_service_get_data_fd(int sk);

	/* Human readable message type string */
	const char *bt_audio_strmsg(int type);

	#ifdef __cplusplus
	}
	#endif

	#endif /* BT_AUDIOCLIENT_H */