5 A Linux/Unix toolset and driver for Nokia mobile phones.
7 Released under the terms of the GNU GPL, see file COPYING for more details.
9 Header file for the various functions, definitions etc. used to implement
10 the handset interface. See fbus-6110.c for more details.
19 /* Nokia 6110 supports phonebook entries of max. 16 characters and numbers of
21 #define N6110_MAX_PHONEBOOK_NAME_LENGTH (16)
22 #define N6110_MAX_PHONEBOOK_NUMBER_LENGTH (30)
24 /* Alternate defines for memory types. Two letter codes follow GSM 07.07
25 release 6.2.0, AT+CPBS "Select Phonebook Memory Storage" */
26 #define N6110_MEMORY_MT 0x01 /* combined ME and SIM phonebook */
27 #define N6110_MEMORY_ME 0x02 /* ME (Mobile Equipment) phonebook */
28 #define N6110_MEMORY_SM 0x03 /* SIM phonebook */
29 #define N6110_MEMORY_FD 0x04 /* SIM fixdialling-phonebook */
30 #define N6110_MEMORY_ON 0x05 /* SIM (or ME) own numbers list */
31 #define N6110_MEMORY_EN 0x06 /* SIM (or ME) emergency number */
32 #define N6110_MEMORY_DC 0x07 /* ME dialled calls list */
33 #define N6110_MEMORY_RC 0x08 /* ME received calls list */
34 #define N6110_MEMORY_MC 0x09 /* ME missed (unanswered received) calls list */
35 #define N6110_MEMORY_VOICE 0x0b /* Voice Mailbox */
36 #define N6110_MEMORY_XX 0xff /* This is used when the memory type is unknown. */
38 /* This byte is used to synchronize FBUS channel over cable or IR. */
39 #define N6110_SYNC_BYTE 0x55
41 /* This byte is send after all N6110_SYNC_BYTE bytes when init infrared. */
42 #define N6110_IR_END_SYNC_BYTE 0xc1
44 /* Every (well, almost every) frame from the computer starts with this
46 #define N6110_FRAME_HEADER 0x00, 0x01, 0x00
48 /* Global variables */
49 extern bool N6110_LinkOK;
50 extern GSM_Functions N6110_Functions;
51 extern GSM_Information N6110_Information;
53 /* Prototypes for the functions designed to be used externally. */
54 static GSM_Error N6110_Initialise(char *port_device, char *initlength,
55 GSM_ConnectionType connection,
56 void (*rlp_callback)(RLP_F96Frame *frame));
58 static void N6110_DispatchMessage(u16 MessageLength, u8 *MessageBuffer,
61 GSM_Error N6110_SendStatusRequest(void);
63 static int N6110_GetMemoryType(GSM_MemoryType memory_type);
66 static GSM_Error N6110_GetVoiceMailbox ( GSM_PhonebookEntry *entry);
68 static GSM_Error N6110_GetOperatorName ( GSM_Network *operator);
69 static GSM_Error N6110_SetOperatorName ( GSM_Network *operator);
72 static GSM_Error N6110_GetMemoryLocation(GSM_PhonebookEntry *entry);
73 static GSM_Error N6110_WritePhonebookLocation(GSM_PhonebookEntry *entry);
75 static GSM_Error N6110_GetSpeedDial(GSM_SpeedDial *entry);
76 static GSM_Error N6110_SetSpeedDial(GSM_SpeedDial *entry);
78 static GSM_Error N6110_GetMemoryStatus(GSM_MemoryStatus *Status);
80 static GSM_Error N6110_GetSMSStatus(GSM_SMSStatus *Status);
81 static GSM_Error N6110_GetSMSCenter(GSM_MessageCenter *MessageCenter);
83 static GSM_Error N6110_GetSMSMessage(GSM_SMSMessage *Message);
84 static GSM_Error N6110_DeleteSMSMessage(GSM_SMSMessage *Message);
85 static GSM_Error N6110_SendSMSMessage(GSM_SMSMessage *Message);
86 static GSM_Error N6110_SaveSMSMessage(GSM_SMSMessage *Message);
89 static GSM_Error N6110_GetRFLevel(GSM_RFUnits *units, float *level);
90 static GSM_Error N6110_GetBatteryLevel(GSM_BatteryUnits *units, float *level);
91 static GSM_Error N6110_GetPowerSource(GSM_PowerSource *source);
93 static GSM_Error N6110_GetDisplayStatus(int *Status);
95 static GSM_Error N6110_EnterSecurityCode(GSM_SecurityCode SecurityCode);
96 static GSM_Error N6110_GetSecurityCodeStatus(int *Status);
97 static GSM_Error N6110_GetSecurityCode(GSM_SecurityCode *SecurityCode);
99 static GSM_Error N6110_GetSMSCenter(GSM_MessageCenter *MessageCenter);
100 static GSM_Error N6110_SetSMSCenter(GSM_MessageCenter *MessageCenter);
103 static GSM_Error N6110_GetIMEI(char *imei);
104 static GSM_Error N6110_GetRevision(char *revision);
105 static GSM_Error N6110_GetModel(char *model);
106 static GSM_Error N6110_GetManufacturer(char *manufacturer);
109 static GSM_Error N6110_GetDateTime(GSM_DateTime *date_time);
110 static GSM_Error N6110_SetDateTime(GSM_DateTime *date_time);
112 static GSM_Error N6110_PrivGetDateTime(GSM_DateTime *date_time, int msgtype);
113 static GSM_Error N6110_PrivSetDateTime(GSM_DateTime *date_time, int msgtype);
115 static GSM_Error N6110_GetAlarm(int alarm_number, GSM_DateTime *date_time);
116 static GSM_Error N6110_SetAlarm(int alarm_number, GSM_DateTime *date_time);
118 static GSM_Error N6110_PrivGetAlarm(int alarm_number, GSM_DateTime *date_time, int msgtype);
119 static GSM_Error N6110_PrivSetAlarm(int alarm_number, GSM_DateTime *date_time, int msgtype);
121 static GSM_Error N6110_DialVoice(char *Number);
123 static GSM_Error N6110_DialData(char *Number, char type, void (* callpassup)(char c));
125 static GSM_Error N6110_AnswerCall(char s);
127 static GSM_Error N6110_GetIncomingCallNr(char *Number);
129 static GSM_Error N6110_GetNetworkInfo(GSM_NetworkInfo *NetworkInfo);
131 static GSM_Error N6110_GetCalendarNote(GSM_CalendarNote *CalendarNote);
132 static GSM_Error N6110_WriteCalendarNote(GSM_CalendarNote *CalendarNote);
133 static GSM_Error N6110_DeleteCalendarNote(GSM_CalendarNote *CalendarNote);
135 static GSM_Error N6110_NetMonitor(unsigned char mode, char *Screen);
137 static GSM_Error N6110_PlayTone(int Herz, u8 Volume);
139 static GSM_Error N6110_SetBitmap( GSM_Bitmap *Bitmap );
140 static GSM_Error N6110_GetBitmap( GSM_Bitmap *Bitmap );
142 static GSM_Error N6110_SetRingTone(GSM_Ringtone *ringtone, int *maxlength);
143 static GSM_Error N6110_SetBinRingTone(GSM_BinRingtone *ringtone);
144 static GSM_Error N6110_GetBinRingTone(GSM_BinRingtone *ringtone);
146 static GSM_Error N6110_EnableDisplayOutput();
147 static GSM_Error N6110_DisableDisplayOutput();
149 static GSM_Error N6110_EnableCellBroadcast ();
150 static GSM_Error N6110_DisableCellBroadcast(void);
151 static GSM_Error N6110_ReadCellBroadcast (GSM_CBMessage *Message);
153 static GSM_Error N6110_SendDTMF(char *String);
156 static GSM_Error N6110_Reset(unsigned char type);
159 static GSM_Error N6110_GetProfile(GSM_Profile *Profile);
160 static GSM_Error N6110_SetProfile(GSM_Profile *Profile);
162 static bool N6110_SendRLPFrame(RLP_F96Frame *frame, bool out_dtx);
164 static GSM_Error N6110_CancelCall(void);
167 static GSM_Error N6110_PressKey(int key, int event);
169 static GSM_Error N6110_GetProductProfileSetting (GSM_PPS *PPS);
170 static GSM_Error N6110_SetProductProfileSetting (GSM_PPS *PPS);
172 static GSM_Error N6110_CallDivert(GSM_CallDivert *cd);
175 static void N6110_RX_HandleRLPMessage(u8 *MessageBuffer);
177 static GSM_Error N6110_SendIMEIFrame();
178 static GSM_Error N6110_SendIDFrame();
179 static GSM_Error N6110_SendHWFrame();
181 static GSM_Error N6110_EnableExtendedCommands (unsigned char status);
184 static GSM_Error N6110_Tests();
186 static void N6110_DisplayTestsInfo(u8 *MessageBuffer);
188 static GSM_Error N6110_SimlockInfo(GSM_AllSimlocks *siml);
189 static GSM_Error N6110_GetSMSFolders ( GSM_SMSFolders *folders);
191 static GSM_Error N6110_ResetPhoneSettings();
194 static void N6110_Dispatch0x01Message(u16 MessageLength, u8 *MessageBuffer, u8 MessageType);
197 static void N6110_ReplySendSMSMessage(u16 MessageLength, u8 *MessageBuffer, u8 MessageType);
198 static void N6110_ReplySetSMSCenter (u16 MessageLength, u8 *MessageBuffer, u8 MessageType);
199 static void N6110_ReplyGetSMSCenter (u16 MessageLength, u8 *MessageBuffer, u8 MessageType);
200 static void N6110_Dispatch0x02Message(u16 MessageLength, u8 *MessageBuffer, u8 MessageType);
201 static void N6110_ReplySetCellBroadcast (u16 MessageLength, u8 *MessageBuffer, u8 MessageType);
202 static void N6110_ReplyReadCellBroadcast(u16 MessageLength, u8 *MessageBuffer, u8 MessageType);
204 static void N6110_ReplyCallDivert (u16 MessageLength, u8 *MessageBuffer, u8 MessageType);
205 static void N6110_Dispatch0x06Message(u16 MessageLength, u8 *MessageBuffer, u8 MessageType);
209 static void N6110_ReplySetDateTime(u16 MessageLength,u8 *MessageBuffer, u8 MessageType);
210 static void N6110_ReplyGetDateTime(u16 MessageLength,u8 *MessageBuffer, u8 MessageType);
211 static void N6110_ReplySetAlarm (u16 MessageLength,u8 *MessageBuffer, u8 MessageType);
212 static void N6110_ReplyGetAlarm (u16 MessageLength,u8 *MessageBuffer, u8 MessageType);
215 static void N6110_ReplyEnableExtendedCommands (u16 MessageLength,u8 *MessageBuffer,u8 MessageType);
217 static void N6110_ReplyResetPhoneSettings (u16 MessageLength,u8 *MessageBuffer,u8 MessageType);
219 static void N6110_ReplyIMEI (u16 MessageLength,u8 *MessageBuffer,u8 MessageType);
221 static void N6110_ReplyGetProductProfileSetting(u16 MessageLength,u8 *MessageBuffer,u8 MessageType);
222 static void N6110_ReplySetProductProfileSetting(u16 MessageLength,u8 *MessageBuffer,u8 MessageType);
223 static void N6110_ReplyNetmonitor (u16 MessageLength,u8 *MessageBuffer,u8 MessageType);
224 static void N6110_ReplySimlockInfo (u16 MessageLength,u8 *MessageBuffer,u8 MessageType);
225 static void N6110_ReplyPlayTone (u16 MessageLength,u8 *MessageBuffer,u8 MessageType);
227 static void N6110_ReplyHW (u16 MessageLength,u8 *MessageBuffer,u8 MessageType);
228 static void N6110_Dispatch0x40Message (u16 MessageLength,u8 *MessageBuffer,u8 MessageType);
230 static void N6110_DispatchACKMessage (u16 MessageLength, u8 *MessageBuffer, u8 MessageType);
231 static void N6110_ReplyID(u16 MessageLength, u8 *MessageBuffer, u8 MessageType);
234 static GSM_Error GSM_EncodeNokiaSMSFrame(GSM_SMSMessage *SMS, unsigned char *req, int *length, SMS_MessageType PDU);
235 static GSM_Error GSM_DecodeNokiaSMSFrame(GSM_SMSMessage *SMS, unsigned char *req, int length);
237 static int N6110_MakeCallerGroupFrame (unsigned char *req,GSM_Bitmap Bitmap);
238 static int N6110_MakeOperatorLogoFrame(unsigned char *req,GSM_Bitmap Bitmap);
239 static int N6110_MakeStartupLogoFrame (unsigned char *req,GSM_Bitmap Bitmap);
242 #endif /* __n_6110_h */