Home | History | Annotate | Download | only in audio
      1 /*
      2  *
      3  *  BlueZ - Bluetooth protocol stack for Linux
      4  *
      5  *  Copyright (C) 2006-2010  Nokia Corporation
      6  *  Copyright (C) 2004-2010  Marcel Holtmann <marcel (at) holtmann.org>
      7  *
      8  *
      9  *  This program is free software; you can redistribute it and/or modify
     10  *  it under the terms of the GNU General Public License as published by
     11  *  the Free Software Foundation; either version 2 of the License, or
     12  *  (at your option) any later version.
     13  *
     14  *  This program is distributed in the hope that it will be useful,
     15  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
     16  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     17  *  GNU General Public License for more details.
     18  *
     19  *  You should have received a copy of the GNU General Public License
     20  *  along with this program; if not, write to the Free Software
     21  *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
     22  *
     23  */
     24 
     25 #include <stdint.h>
     26 #include <errno.h>
     27 #include <glib.h>
     28 
     29 /* Response and hold values */
     30 #define BTRH_NOT_SUPPORTED	-2
     31 #define BTRH_NONE		-1
     32 #define BTRH_HOLD		0
     33 #define BTRH_ACCEPT		1
     34 #define BTRH_REJECT		2
     35 
     36 /* HFP feature bits */
     37 #define AG_FEATURE_THREE_WAY_CALLING		0x0001
     38 #define AG_FEATURE_EC_ANDOR_NR			0x0002
     39 #define AG_FEATURE_VOICE_RECOGNITION		0x0004
     40 #define AG_FEATURE_INBAND_RINGTONE		0x0008
     41 #define AG_FEATURE_ATTACH_NUMBER_TO_VOICETAG	0x0010
     42 #define AG_FEATURE_REJECT_A_CALL		0x0020
     43 #define AG_FEATURE_ENHANCED_CALL_STATUS		0x0040
     44 #define AG_FEATURE_ENHANCED_CALL_CONTROL	0x0080
     45 #define AG_FEATURE_EXTENDED_ERROR_RESULT_CODES	0x0100
     46 
     47 #define HF_FEATURE_EC_ANDOR_NR			0x0001
     48 #define HF_FEATURE_CALL_WAITING_AND_3WAY	0x0002
     49 #define HF_FEATURE_CLI_PRESENTATION		0x0004
     50 #define HF_FEATURE_VOICE_RECOGNITION		0x0008
     51 #define HF_FEATURE_REMOTE_VOLUME_CONTROL	0x0010
     52 #define HF_FEATURE_ENHANCED_CALL_STATUS		0x0020
     53 #define HF_FEATURE_ENHANCED_CALL_CONTROL	0x0040
     54 
     55 /* Indicator event values */
     56 #define EV_SERVICE_NONE			0
     57 #define EV_SERVICE_PRESENT		1
     58 
     59 #define EV_CALL_INACTIVE		0
     60 #define EV_CALL_ACTIVE			1
     61 
     62 #define EV_CALLSETUP_INACTIVE		0
     63 #define EV_CALLSETUP_INCOMING		1
     64 #define EV_CALLSETUP_OUTGOING		2
     65 #define EV_CALLSETUP_ALERTING		3
     66 
     67 #define EV_CALLHELD_NONE		0
     68 #define EV_CALLHELD_MULTIPLE		1
     69 #define EV_CALLHELD_ON_HOLD		2
     70 
     71 #define EV_ROAM_INACTIVE		0
     72 #define EV_ROAM_ACTIVE			1
     73 
     74 /* Call parameters */
     75 #define CALL_DIR_OUTGOING		0
     76 #define CALL_DIR_INCOMING		1
     77 
     78 #define CALL_STATUS_ACTIVE		0
     79 #define CALL_STATUS_HELD		1
     80 #define CALL_STATUS_DIALING		2
     81 #define CALL_STATUS_ALERTING		3
     82 #define CALL_STATUS_INCOMING		4
     83 #define CALL_STATUS_WAITING		5
     84 
     85 #define CALL_MODE_VOICE			0
     86 #define CALL_MODE_DATA			1
     87 #define CALL_MODE_FAX			2
     88 
     89 #define CALL_MULTIPARTY_NO		0
     90 #define CALL_MULTIPARTY_YES		1
     91 
     92 /* Subscriber number parameters */
     93 #define SUBSCRIBER_SERVICE_VOICE	4
     94 #define SUBSCRIBER_SERVICE_FAX		5
     95 
     96 /* Operator selection mode values */
     97 #define OPERATOR_MODE_AUTO		0
     98 #define OPERATOR_MODE_MANUAL		1
     99 #define OPERATOR_MODE_DEREGISTER	2
    100 #define OPERATOR_MODE_MANUAL_AUTO	4
    101 
    102 /* Some common number types */
    103 #define NUMBER_TYPE_UNKNOWN		128
    104 #define NUMBER_TYPE_TELEPHONY		129
    105 #define NUMBER_TYPE_INTERNATIONAL	145
    106 #define NUMBER_TYPE_NATIONAL		161
    107 #define NUMBER_TYPE_VOIP		255
    108 
    109 /* Extended Audio Gateway Error Result Codes */
    110 typedef enum {
    111 	CME_ERROR_NONE			= -1,
    112 	CME_ERROR_AG_FAILURE		= 0,
    113 	CME_ERROR_NO_PHONE_CONNECTION	= 1,
    114 	CME_ERROR_NOT_ALLOWED		= 3,
    115 	CME_ERROR_NOT_SUPPORTED		= 4,
    116 	CME_ERROR_PH_SIM_PIN_REQUIRED	= 5,
    117 	CME_ERROR_SIM_NOT_INSERTED	= 10,
    118 	CME_ERROR_SIM_PIN_REQUIRED	= 11,
    119 	CME_ERROR_SIM_PUK_REQUIRED	= 12,
    120 	CME_ERROR_SIM_FAILURE		= 13,
    121 	CME_ERROR_SIM_BUSY		= 14,
    122 	CME_ERROR_INCORRECT_PASSWORD	= 16,
    123 	CME_ERROR_SIM_PIN2_REQUIRED	= 17,
    124 	CME_ERROR_SIM_PUK2_REQUIRED	= 18,
    125 	CME_ERROR_MEMORY_FULL		= 20,
    126 	CME_ERROR_INVALID_INDEX		= 21,
    127 	CME_ERROR_MEMORY_FAILURE	= 23,
    128 	CME_ERROR_TEXT_STRING_TOO_LONG	= 24,
    129 	CME_ERROR_INVALID_TEXT_STRING	= 25,
    130 	CME_ERROR_DIAL_STRING_TOO_LONG	= 26,
    131 	CME_ERROR_INVALID_DIAL_STRING	= 27,
    132 	CME_ERROR_NO_NETWORK_SERVICE	= 30,
    133 	CME_ERROR_NETWORK_TIMEOUT	= 31,
    134 	CME_ERROR_NETWORK_NOT_ALLOWED	= 32,
    135 } cme_error_t;
    136 
    137 struct indicator {
    138 	const char *desc;
    139 	const char *range;
    140 	int val;
    141 	gboolean ignore_redundant;
    142 };
    143 
    144 /* Notify telephony-*.c of connected/disconnected devices. Implemented by
    145  * telephony-*.c
    146  */
    147 void telephony_device_connected(void *telephony_device);
    148 void telephony_device_disconnected(void *telephony_device);
    149 
    150 /* HF requests (sent by the handsfree device). These are implemented by
    151  * telephony-*.c
    152  */
    153 void telephony_event_reporting_req(void *telephony_device, int ind);
    154 void telephony_response_and_hold_req(void *telephony_device, int rh);
    155 void telephony_last_dialed_number_req(void *telephony_device);
    156 void telephony_terminate_call_req(void *telephony_device);
    157 void telephony_answer_call_req(void *telephony_device);
    158 void telephony_dial_number_req(void *telephony_device, const char *number);
    159 void telephony_transmit_dtmf_req(void *telephony_device, char tone);
    160 void telephony_subscriber_number_req(void *telephony_device);
    161 void telephony_list_current_calls_req(void *telephony_device);
    162 void telephony_operator_selection_req(void *telephony_device);
    163 void telephony_call_hold_req(void *telephony_device, const char *cmd);
    164 void telephony_nr_and_ec_req(void *telephony_device, gboolean enable);
    165 void telephony_voice_dial_req(void *telephony_device, gboolean enable);
    166 void telephony_key_press_req(void *telephony_device, const char *keys);
    167 
    168 /* AG responses to HF requests. These are implemented by headset.c */
    169 int telephony_event_reporting_rsp(void *telephony_device, cme_error_t err);
    170 int telephony_response_and_hold_rsp(void *telephony_device, cme_error_t err);
    171 int telephony_last_dialed_number_rsp(void *telephony_device, cme_error_t err);
    172 int telephony_terminate_call_rsp(void *telephony_device, cme_error_t err);
    173 int telephony_answer_call_rsp(void *telephony_device, cme_error_t err);
    174 int telephony_dial_number_rsp(void *telephony_device, cme_error_t err);
    175 int telephony_transmit_dtmf_rsp(void *telephony_device, cme_error_t err);
    176 int telephony_subscriber_number_rsp(void *telephony_device, cme_error_t err);
    177 int telephony_list_current_calls_rsp(void *telephony_device, cme_error_t err);
    178 int telephony_operator_selection_rsp(void *telephony_device, cme_error_t err);
    179 int telephony_call_hold_rsp(void *telephony_device, cme_error_t err);
    180 int telephony_nr_and_ec_rsp(void *telephony_device, cme_error_t err);
    181 int telephony_voice_dial_rsp(void *telephony_device, cme_error_t err);
    182 int telephony_key_press_rsp(void *telephony_device, cme_error_t err);
    183 
    184 /* Event indications by AG. These are implemented by headset.c */
    185 int telephony_event_ind(int index);
    186 int telephony_response_and_hold_ind(int rh);
    187 int telephony_incoming_call_ind(const char *number, int type);
    188 int telephony_calling_stopped_ind(void);
    189 int telephony_ready_ind(uint32_t features, const struct indicator *indicators,
    190 			int rh, const char *chld);
    191 int telephony_deinit(void);
    192 int telephony_list_current_call_ind(int idx, int dir, int status, int mode,
    193 					int mprty, const char *number,
    194 					int type);
    195 int telephony_subscriber_number_ind(const char *number, int type,
    196 					int service);
    197 int telephony_call_waiting_ind(const char *number, int type);
    198 int telephony_operator_selection_ind(int mode, const char *oper);
    199 
    200 /* Helper function for quick indicator updates */
    201 static inline int telephony_update_indicator(struct indicator *indicators,
    202 						const char *desc,
    203 						int new_val)
    204 {
    205 	int i;
    206 	struct indicator *ind = NULL;
    207 
    208 	for (i = 0; indicators[i].desc != NULL; i++) {
    209 		if (g_str_equal(indicators[i].desc, desc)) {
    210 			ind = &indicators[i];
    211 			break;
    212 		}
    213 	}
    214 
    215 	if (!ind)
    216 		return -ENOENT;
    217 
    218 	DBG("Telephony indicator \"%s\" %d->%d", desc, ind->val, new_val);
    219 
    220 	if (ind->ignore_redundant && ind->val == new_val) {
    221 		DBG("Ignoring no-change indication");
    222 		return 0;
    223 	}
    224 
    225 	ind->val = new_val;
    226 
    227 	return telephony_event_ind(i);
    228 }
    229 
    230 static inline int telephony_get_indicator(const struct indicator *indicators,
    231 						const char *desc)
    232 {
    233 	int i;
    234 
    235 	for (i = 0; indicators[i].desc != NULL; i++) {
    236 		if (g_str_equal(indicators[i].desc, desc))
    237 			return indicators[i].val;
    238 	}
    239 
    240 	return -ENOENT;
    241 }
    242 
    243 int telephony_init(void);
    244 void telephony_exit(void);
    245