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