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
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
/* Copyright (C) 2007-2008 The Android Open Source Project
**
** This software is licensed under the terms of the GNU General Public
** License version 2, as published by the Free Software Foundation, and
** may be copied, distributed, and modified under those terms.
**
** This program 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 General Public License for more details.
*/
#ifndef _android_modem_h_
#define _android_modem_h_
#include "sim_card.h"
#include "sms.h"
/** MODEM OBJECT
**/
typedef struct AModemRec_* AModem;
/* a function used by the modem to send unsolicited messages to the channel controller */
typedef void (*AModemUnsolFunc)( void* opaque, const char* message );
extern AModem amodem_create( int base_port, AModemUnsolFunc unsol_func, void* unsol_opaque );
extern void amodem_set_legacy( AModem modem );
extern void amodem_destroy( AModem modem );
/* send a command to the modem */
extern const char* amodem_send( AModem modem, const char* cmd );
/* simulate the receipt on an incoming SMS message */
extern void amodem_receive_sms( AModem modem, SmsPDU pdu );
/** RADIO STATE
**/
typedef enum {
A_RADIO_STATE_OFF = 0, /* Radio explictly powered off (eg CFUN=0) */
A_RADIO_STATE_ON, /* Radio on */
} ARadioState;
extern ARadioState amodem_get_radio_state( AModem modem );
extern void amodem_set_radio_state( AModem modem, ARadioState state );
/* Set the received signal strength indicator and bit error rate */
extern void amodem_set_signal_strength( AModem modem, int rssi, int ber );
/** SIM CARD STATUS
**/
extern ASimCard amodem_get_sim( AModem modem );
/** VOICE AND DATA NETWORK REGISTRATION
**/
/* 'stat' for +CREG/+CGREG commands */
typedef enum {
A_REGISTRATION_UNREGISTERED = 0,
A_REGISTRATION_HOME = 1,
A_REGISTRATION_SEARCHING,
A_REGISTRATION_DENIED,
A_REGISTRATION_UNKNOWN,
A_REGISTRATION_ROAMING
} ARegistrationState;
typedef enum {
A_DATA_NETWORK_UNKNOWN = 0,
A_DATA_NETWORK_GPRS,
A_DATA_NETWORK_EDGE,
A_DATA_NETWORK_UMTS,
A_DATA_NETWORK_LTE,
A_DATA_NETWORK_CDMA1X,
A_DATA_NETWORK_EVDO, // TODO: Should REV0, REVA and REVB be added?
} ADataNetworkType;
// TODO: Merge the usage of these two structs and rename ADataNetworkType
typedef enum {
A_TECH_GSM = 0,
A_TECH_WCDMA,
A_TECH_CDMA,
A_TECH_EVDO,
A_TECH_LTE,
A_TECH_UNKNOWN // This must always be the last value in the enum
} AModemTech;
typedef enum {
A_SUBSCRIPTION_NVRAM = 0,
A_SUBSCRIPTION_RUIM,
A_SUBSCRIPTION_UNKNOWN // This must always be the last value in the enum
} ACdmaSubscriptionSource;
typedef enum {
A_ROAMING_PREF_HOME = 0,
A_ROAMING_PREF_AFFILIATED,
A_ROAMING_PREF_ANY,
A_ROAMING_PREF_UNKNOWN // This must always be the last value in the enum
} ACdmaRoamingPref;
extern ARegistrationState amodem_get_voice_registration( AModem modem );
extern void amodem_set_voice_registration( AModem modem, ARegistrationState state );
extern ARegistrationState amodem_get_data_registration( AModem modem );
extern void amodem_set_data_registration( AModem modem, ARegistrationState state );
extern void amodem_set_data_network_type( AModem modem, ADataNetworkType type );
extern ADataNetworkType android_parse_network_type( const char* speed );
extern AModemTech android_parse_modem_tech( const char* tech );
extern void amodem_set_cdma_subscription_source( AModem modem, ACdmaSubscriptionSource ssource );
extern void amodem_set_cdma_prl_version( AModem modem, int prlVersion);
/** OPERATOR NAMES
**/
typedef enum {
A_NAME_LONG = 0,
A_NAME_SHORT,
A_NAME_NUMERIC,
A_NAME_MAX /* don't remove */
} ANameIndex;
/* retrieve operator name into user-provided buffer. returns number of writes written, including terminating zero */
extern int amodem_get_operator_name ( AModem modem, ANameIndex index, char* buffer, int buffer_size );
/* reset one operator name from a user-provided buffer, set buffer_size to -1 for zero-terminated strings */
extern void amodem_set_operator_name( AModem modem, ANameIndex index, const char* buffer, int buffer_size );
/** CALL STATES
**/
typedef enum {
A_CALL_OUTBOUND = 0,
A_CALL_INBOUND = 1,
} ACallDir;
typedef enum {
A_CALL_ACTIVE = 0,
A_CALL_HELD,
A_CALL_DIALING,
A_CALL_ALERTING,
A_CALL_INCOMING,
A_CALL_WAITING
} ACallState;
typedef enum {
A_CALL_VOICE = 0,
A_CALL_DATA,
A_CALL_FAX,
A_CALL_UNKNOWN = 9
} ACallMode;
#define A_CALL_NUMBER_MAX_SIZE 16
typedef struct {
int id;
ACallDir dir;
ACallState state;
ACallMode mode;
int multi;
char number[ A_CALL_NUMBER_MAX_SIZE+1 ];
} ACallRec, *ACall;
extern int amodem_get_call_count( AModem modem );
extern ACall amodem_get_call( AModem modem, int index );
extern ACall amodem_find_call_by_number( AModem modem, const char* number );
extern int amodem_add_inbound_call( AModem modem, const char* number );
extern int amodem_update_call( AModem modem, const char* number, ACallState state );
extern int amodem_disconnect_call( AModem modem, const char* number );
/**/
#endif /* _android_modem_h_ */
|
