1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
/*
This file is part of the GSM3 communications library for Arduino
-- Multi-transport communications platform
-- Fully asynchronous
-- Includes code for the Arduino-Telefonica GSM/GPRS Shield V1
-- Voice calls
-- SMS
-- TCP/IP connections
-- HTTP basic clients
This library has been developed by Telef�nica Digital - PDI -
- Physical Internet Lab, as part as its collaboration with
Arduino and the Open Hardware Community.
September-December 2012
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
The latest version of this library can always be found at
https://github.com/BlueVia/Official-Arduino
*/
#ifndef _GSM3SHIELDV1VOICEPROVIDER_
#define _GSM3SHIELDV1VOICEPROVIDER_
#include <GSM3MobileVoiceProvider.h>
#include <GSM3ShieldV1ModemCore.h>
#include <GSM3ShieldV1BaseProvider.h>
class GSM3ShieldV1VoiceProvider : public GSM3MobileVoiceProvider, public GSM3ShieldV1BaseProvider
{
public:
/** Constructor */
GSM3ShieldV1VoiceProvider();
/** initilizer, links with modem provider */
void initialize();
/** Manages modem response
@param from Initial byte of buffer
@param to Final byte of buffer
*/
void manageResponse(byte from, byte to);
//Call functions.
/** Launch a voice call
@param number Phone number to be called
@return If asynchronous, returns 0. If synchronous, 1 if success, other if error
*/
int voiceCall(const char* number);
/** Answer a voice call
@return If asynchronous, returns 0. If synchronous, 1 if success, other if error
*/
int answerCall();
/** Hang a voice call
@return If asynchronous, returns 0. If synchronous, 1 if success, other if error
*/
int hangCall();
/** Retrieve phone number of caller
@param buffer Buffer for copy phone number
@param bufsize Buffer size
@return If asynchronous, returns 0. If synchronous, 1 if success, other if error
*/
int retrieveCallingNumber(char* buffer, int bufsize);
/** Get last command status
@return Returns 0 if last command is still executing, 1 success, >1 error
*/
int ready(){return GSM3ShieldV1BaseProvider::ready();};
/** Recognize URC
@param oldTail
@return true if successful
*/
bool recognizeUnsolicitedEvent(byte oldTail);
/** Returns voice call status
@return voice call status
*/
GSM3_voiceCall_st getvoiceCallStatus(){ready(); return _voiceCallstatus;};
/** Set voice call status
@param status New status for voice call
*/
void setvoiceCallStatus(GSM3_voiceCall_st status) { _voiceCallstatus = status; };
private:
int phonelength; // Phone number length
GSM3_voiceCall_st _voiceCallstatus; // The voiceCall status
/** Continue to voice call function
*/
void voiceCallContinue();
/** Continue to answer call function
*/
void answerCallContinue();
/** Continue to hang call function
*/
void hangCallContinue();
/** Continue to retrieve calling number function
*/
void retrieveCallingNumberContinue();
/** Parse CLCC response from buffer
@param number Number initial for extract substring of response
@param nlength Substring length
@return true if successful
*/
bool parseCLCC(char* number, int nlength);
};
#endif
|
