/*
+ $Id$
+
G N O K I I
A Linux/Unix toolset and driver for Nokia mobile phones.
+ Copyright (C) 1999, 2000 Hugh Blemings & Pavel JanÃk ml.
+
Released under the terms of the GNU GPL, see file COPYING for more details.
Header file for the definitions, enums etc. that are used by all models of
handset.
+ $Log$
+ Revision 1.1.1.10 2002/04/03 01:44:15 short
+ Implemented connection type "tcp" (GCT_TCP), use <hostname>:<port> as "port"
+
+ Revision 1.1.1.9 2002/04/03 00:08:19 short
+ Found in "gnokii-working" directory, some November-patches version
+
+ Revision 1.80 2001/08/20 23:36:27 pkot
+ More cleanup in AT code (Manfred Jonsson)
+
+ Revision 1.79 2001/07/27 00:02:22 pkot
+ Generic AT support for the new structure (Manfred Jonsson)
+
+ Revision 1.78 2001/06/28 00:28:45 pkot
+ Small docs updates (Pawel Kot)
+
+
*/
#ifndef __gsm_common_h
#define __gsm_common_h
-#include "misc.h"
+#include <stdlib.h>
+
+#include "gsm-common.h"
+#include "data/rlp-common.h"
+
+/* Type of connection. Now we support serial connection with FBUS cable and
+ IR (only with 61x0 models) */
+
+typedef enum {
+ GCT_Serial, /* Serial connection. */
+ GCT_Infrared, /* Infrared connection. */
+ GCT_Tekram, /* Tekram Ir-Dongle */
+ GCT_Irda,
+ GCT_TCP, /* TCP network connection */
+} GSM_ConnectionType;
+
+/* Maximum length of device name for serial port */
+
+#define GSM_MAX_DEVICE_NAME_LENGTH (100)
+
+/* Define an enum for specifying memory types for retrieving phonebook
+ entries, SMS messages etc. This type is not mobile specific - the model
+ code should take care of translation to mobile specific numbers - see 6110
+ code.
+ 01/07/99: Two letter codes follow GSM 07.07 release 6.2.0
+*/
+
+typedef enum {
+ GMT_ME, /* Internal memory of the mobile equipment */
+ GMT_SM, /* SIM card memory */
+ GMT_FD, /* Fixed dial numbers */
+ GMT_ON, /* Own numbers */
+ GMT_EN, /* Emergency numbers */
+ GMT_DC, /* Dialled numbers */
+ GMT_RC, /* Received numbers */
+ GMT_MC, /* Missed numbers */
+ GMT_LD, /* Last dialed */
+ GMT_MT, /* combined ME and SIM phonebook */
+ GMT_TA, /* for compatibility only: TA=computer memory */
+ GMT_CB, /* Currently selected memory */
+ GMT_XX = 0xff /* Error code for unknown memory type (returned by fbus-xxxx functions). */
+} GSM_MemoryType;
+
+/* Power source types */
+
+typedef enum {
+ GPS_ACDC=1, /* AC/DC powered (charging) */
+ GPS_BATTERY /* Internal battery */
+} GSM_PowerSource;
+
+/* This data-type is used to specify the type of the number. See the official
+ GSM specification 03.40, version 5.3.0, section 9.1.2.5, page 33. */
+
+typedef enum {
+ GNT_UNKNOWN=0x81, /* Unknown number */
+ GNT_INTERNATIONAL=0x91 /* International number */
+} GSM_NumberType;
-#define MYGNOKII
/* Maximum length of SMS center name */
+
#define GSM_MAX_SMS_CENTER_NAME_LENGTH (20)
/* Limits of SMS messages. */
+
#define GSM_MAX_SMS_CENTER_LENGTH (40)
-#define GSM_MAX_RECIPIENT_LENGTH (40)
#define GSM_MAX_SENDER_LENGTH (40)
#define GSM_MAX_DESTINATION_LENGTH (40)
#define GSM_MAX_SMS_LENGTH (160)
-#define GSM_MAX_SMS_8_BIT_LENGTH (140)
-#define GSM_MAX_USER_DATA_HEADER_LENGTH (140)
+#define GSM_MAX_SMS_8BIT_LENGTH (140)
+
+#define GSM_MAX_CB_MESSAGE (160)
+
/* The maximum length of an uncompressed concatenated short message is
255 * 153 = 39015 default alphabet characters */
#define GSM_MAX_CONCATENATED_SMS_LENGTH (39015)
-#define GSM_MAX_CB_MESSAGE (160)
+/* All the concatenated UDH headers may get long (at least logo+concatenation).
+ * Theoretically it can be (GSM_MAX_SMS_LENGTH*7/8).
+ */
+#define GSM_MAX_USER_DATA_HEADER_LENGTH (256)
-/* Correct for phones in fbus-6110.c */
-/* For other translation could be required */
-#define PHONEKEY_1 0x01
-#define PHONEKEY_2 0x02
-#define PHONEKEY_3 0x03
-#define PHONEKEY_4 0x04
-#define PHONEKEY_5 0x05
-#define PHONEKEY_6 0x06
-#define PHONEKEY_7 0x07
-#define PHONEKEY_8 0x08
-#define PHONEKEY_9 0x09
-#define PHONEKEY_0 0x0a
-#define PHONEKEY_HASH 0x0b /* # */
-#define PHONEKEY_ASTERISK 0x0c /* * */
-#define PHONEKEY_POWER 0x0d
-#define PHONEKEY_INCREASEVOLUME 0x10 /* doesn't available in some phones as separate button: ie. N5110 */
-#define PHONEKEY_DECREASEVOLUME 0x11 /* doesn't available in some phones as separate button: ie. N5110 */
-#define PHONEKEY_UP 0x17
-#define PHONEKEY_DOWN 0x18
-#define PHONEKEY_MENU 0x19
-#define PHONEKEY_NAMES 0x1a /* doesn't available in some phone: ie. N5110 */
-#define PHONEKEY_GREEN 0x0e /* in some phone ie. N5110 sometimes works identical to POWER */
-#define PHONEKEY_RED 0x0f /* (c) key in some phone: ie. N5110 */
-
-/* Correct for phones in fbus-6110.c */
-/* For other translation could be required */
-#define PRESSPHONEKEY 0x01
-#define RELEASEPHONEKEY 0x02
+/* types of User Data Header */
+typedef enum {
+ GSM_NoUDH,
+ GSM_ConcatenatedMessages,
+ GSM_OpLogo,
+ GSM_CallerIDLogo,
+ GSM_RingtoneUDH
+} GSM_UDH;
-/* Limits for IMEI, Revision and Model string storage. */
-#define GSM_MAX_IMEI_LENGTH (20)
-#define GSM_MAX_REVISION_LENGTH (20)
-#define GSM_MAX_MODEL_LENGTH (10)
+/* Define datatype for SMS Message Type */
-/* In 6210 test 57 there seems to be 75 chars */
-#define NM_MAX_SCREEN_WIDTH 75
+typedef enum {
+ GST_MO, /* Mobile Originated (MO) message - Outbox message */
+ GST_MT, /* Mobile Terminated (MT) message - Inbox message */
+ GST_DR, /* Delivery Report */
+ GST_UN /* Unknown */
+} GSM_SMSMessageType;
+
+/* Datatype for SMS status */
+/* FIXME - This needs to be made clearer and or turned into a
+ bitfield to allow compound values (read | sent etc.) */
-/* Power source types */
typedef enum {
- GPS_ACDC=1, /* AC/DC powered (charging) */
- GPS_BATTERY /* Internal battery */
-} GSM_PowerSource;
+ GSS_SENTREAD = true, /* Sent or read message */
+ GSS_NOTSENTREAD = false /* Not sent or not read message */
+} GSM_SMSMessageStatus;
+
+/* SMS Messages sent as... */
+
+typedef enum {
+ GSMF_Text = 0x00, /* Plain text message. */
+ GSMF_Fax = 0x22, /* Fax message. */
+ GSMF_Voice = 0x24, /* Voice mail message. */
+ GSMF_ERMES = 0x25, /* ERMES message. */
+ GSMF_Paging = 0x26, /* Paging. */
+ GSMF_UCI = 0x2d, /* Email message in 8110i. */
+ GSMF_Email = 0x32, /* Email message. */
+ GSMF_X400 = 0x31 /* X.400 message. */
+} GSM_SMSMessageFormat;
+
+/* Validity of SMS Messages. */
+
+typedef enum {
+ GSMV_1_Hour = 0x0b,
+ GSMV_6_Hours = 0x47,
+ GSMV_24_Hours = 0xa7,
+ GSMV_72_Hours = 0xa9,
+ GSMV_1_Week = 0xad,
+ GSMV_Max_Time = 0xff
+} GSM_SMSMessageValidity;
+
+/* Define datatype for SMS Message Center */
+
+typedef struct {
+ int No; /* Number of the SMSC in the phone memory. */
+ char Name[GSM_MAX_SMS_CENTER_NAME_LENGTH]; /* Name of the SMSC. */
+ GSM_SMSMessageFormat Format; /* SMS is sent as text/fax/paging/email. */
+ GSM_SMSMessageValidity Validity; /* Validity of SMS Message. */
+ char Number[GSM_MAX_SMS_CENTER_LENGTH]; /* Number of the SMSC. */
+ char Recipient[GSM_MAX_SMS_CENTER_LENGTH]; /* Number of the default recipient. */
+} GSM_MessageCenter;
+
+/* Define datatype for Cell Broadcast message */
+typedef struct {
+ int Channel; /* channel number */
+ char Message[GSM_MAX_CB_MESSAGE + 1];
+ int New;
+} GSM_CBMessage;
+
+
/* Definition of security codes. */
+
typedef enum {
GSCT_SecurityCode = 0x01, /* Security code. */
GSCT_Pin, /* PIN. */
} GSM_SecurityCodeType;
/* Security code definition. */
+
typedef struct {
GSM_SecurityCodeType Type; /* Type of the code. */
char Code[10]; /* Actual code. */
} GSM_SecurityCode;
-/* Define an enum for specifying memory types for retrieving phonebook
- entries, SMS messages etc. This type is not mobile specific - the model
- code should take care of translation to mobile specific numbers - see 6110
- code.
- 01/07/99: Two letter codes follow GSM 07.07 release 6.2.0
-*/
-typedef enum {
- GMT_ME, /* Internal memory of the mobile equipment */
- GMT_SM, /* SIM card memory */
- GMT_FD, /* Fixed dial numbers */
- GMT_ON, /* Own numbers */
- GMT_EN, /* Emergency numbers */
- GMT_DC, /* Dialled numbers */
- GMT_RC, /* Received numbers */
- GMT_MC, /* Missed numbers */
- GMT_LD, /* Last dialed */
- GMT_MT, /* combined ME and SIM phonebook */
- GMT_TA, /* for compatibility only: TA=computer memory */
- GMT_CB, /* Currently selected memory */
- GMT_CG, /* Caller groups */
- GMT_XX = 0xff /* Error code for unknown memory type (returned by fbus-xxxx functions. */
-} GSM_MemoryType;
+/* Structure used for passing dates/times to date/time functions such as
+ GSM_GetTime and GSM_GetAlarm etc. */
-/* This define speed dialing entries. */
typedef struct {
- int Number; /* Which number is used to dialing? */
- GSM_MemoryType MemoryType; /* Memory type of the number. */
- int Location; /* Location of the number in MemoryType. */
-} GSM_SpeedDial;
+ bool AlarmEnabled; /* Is the alarm set? */
+ int Year; /* The complete year specification - e.g. 1999. Y2K :-) */
+ int Month; /* January = 1 */
+ int Day;
+ int Hour;
+ int Minute;
+ int Second;
+ int Timezone; /* The difference between local time and GMT, FIXME: WHICH UNITS? --- FIX THE CODE! */
+} GSM_DateTime;
+
+/* Define datatype for SMS messages, used for getting SMS messages from the
+ phones memory. */
-/* Define enums for Battery units. */
-typedef enum {
- GBU_Arbitrary,
- GBU_Volts,
- GBU_Minutes,
- GBU_Percentage
-} GSM_BatteryUnits;
+typedef struct {
+ GSM_DateTime Time; /* Date of reception/response of messages. */
+ GSM_DateTime SMSCTime; /* Date of SMSC response if DeliveryReport messages. */
+ int Validity; /* Validity Period of the SMS message (unit is minutes). */
+ bool UDHPresent; /* If UDH is present */
+ unsigned char UDH[GSM_MAX_USER_DATA_HEADER_LENGTH]; /* If UDH is present - content of UDH, UDH[0] specifies length */
+ char MessageText[GSM_MAX_SMS_LENGTH + 1]; /* (+1) is room for null term, sized by GSM_SMSMessage.MessageTextLength
+ * GSM_SMSMessage.EightBit==false => MessageText is also '\0'-terminated
+ */
+ int MessageTextLength; /* Unit is determined by GSM_SMSMessage.EightBit */
+ GSM_MessageCenter MessageCenter; /* SMS Center. */
+ char Sender[GSM_MAX_SENDER_LENGTH + 1]; /* Sender of the SMS message. */
+ char Destination[GSM_MAX_DESTINATION_LENGTH + 1]; /* Destination of the message. */
+ int MessageNumber; /* Location in the memory (output argument). */
+ GSM_MemoryType MemoryType; /* Type of memory message is stored in. */
+ GSM_SMSMessageType Type; /* Type of the SMS message */
+ GSM_SMSMessageStatus Status; /* Status of the SMS message */
+ int Class; /* Class Message: 0, 1, 2, 3 or none (value -1 !); see GSM 03.38 */
+ bool EightBit; /* Indicates whether SMS contains 8 bit data */
+ bool Compression; /* Indicates whether SMS contains compressed data */
+ int Location; /* Location in the memory (input argument). */
+ bool ReplyViaSameSMSC; /* Indicates whether "Reply via same center" is set */
+} GSM_SMSMessage;
+
+/* This structure is used to get the current network status */
-/* This enum is used for display status. */
+typedef struct {
+ char NetworkCode[10]; /* GSM network code */
+ char CellID[10]; /* CellID */
+ char LAC[10]; /* LAC */
+} GSM_NetworkInfo;
-typedef enum {
- DS_Call_In_Progress, /* Call in progress. */
- DS_Unknown, /* The meaning is unknown now :-( */
- DS_Unread_SMS, /* There is Unread SMS. */
- DS_Voice_Call, /* Voice call active. */
- DS_Fax_Call, /* Fax call active. */
- DS_Data_Call, /* Data call active. */
- DS_Keyboard_Lock, /* Keyboard lock status. */
- DS_SMS_Storage_Full /* Full SMS Memory. */
-} DisplayStatusEntity;
+/* Limits for sizing of array in GSM_PhonebookEntry. Individual handsets may
+ not support these lengths so they have their own limits set. */
-/* Constants for Profiles. */
-
-#define PROFILE_MESSAGE_NOTONE 0x00
-#define PROFILE_MESSAGE_STANDARD 0x01
-#define PROFILE_MESSAGE_SPECIAL 0x02
-#define PROFILE_MESSAGE_BEEPONCE 0x03
-#define PROFILE_MESSAGE_ASCENDING 0x04
-
-#define PROFILE_WARNING_OFF 0xff
-#define PROFILE_WARNING_ON 0x04
-
-#define PROFILE_CALLALERT_RINGING 0x01
-#define PROFILE_CALLALERT_BEEPONCE 0x02
-#define PROFILE_CALLALERT_OFF 0x04
-#define PROFILE_CALLALERT_RINGONCE 0x05
-#define PROFILE_CALLALERT_ASCENDING 0x06
-#define PROFILE_CALLALERT_CALLERGROUPS 0x07
-
-#define PROFILE_KEYPAD_OFF 0xff
-#define PROFILE_KEYPAD_LEVEL1 0x00
-#define PROFILE_KEYPAD_LEVEL2 0x01
-#define PROFILE_KEYPAD_LEVEL3 0x02
-//in 5110 I had also once 0x03
-
-#define PROFILE_VOLUME_LEVEL1 0x06
-#define PROFILE_VOLUME_LEVEL2 0x07
-#define PROFILE_VOLUME_LEVEL3 0x08
-#define PROFILE_VOLUME_LEVEL4 0x09
-#define PROFILE_VOLUME_LEVEL5 0x0a
-
-#define PROFILE_CALLERGROUPS_ALL 0xff
-#define PROFILE_CALLERGROUPS_FAMILY 0x01
-#define PROFILE_CALLERGROUPS_VIP 0x02
-#define PROFILE_CALLERGROUPS_FRIENDS 0x04
-#define PROFILE_CALLERGROUPS_COLLEAGUES 0x08
-#define PROFILE_CALLERGROUPS_OTHERS 0x10
-
-#define PROFILE_VIBRATION_OFF 0x00
-#define PROFILE_VIBRATION_ON 0x01
-#define PROFILE_VIBRATION_FIRST 0x02
+#define GSM_MAX_PHONEBOOK_NAME_LENGTH (50) /* For 7110 */
+#define GSM_MAX_PHONEBOOK_NUMBER_LENGTH (48) /* For 7110 */
+#define GSM_MAX_PHONEBOOK_TEXT_LENGTH (60) /* For 7110 */
+#define GSM_MAX_PHONEBOOK_SUB_ENTRIES (8) /* For 7110 */
+ /* 7110 is able to in one
+ * entry 5 numbers and 2
+ * texts [email,notice,postal] */
-/* Structure to hold profile entries. */
+/* Here is a macro for models that do not support caller groups. */
+
+#define GSM_GROUPS_NOT_SUPPORTED -1
+
+/* This data type is used to report the number of used and free positions in
+ memory (sim or internal). */
typedef struct {
- int Number; /* The number of the profile. */
- char Name[40]; /* The name of the profile. */
- int DefaultName; /* 0-6, when default name is used, -1, when not */
- int KeypadTone; /* Volumen level for keypad tones. */
- int Lights; /* Lights on/off. */
- int CallAlert; /* Incoming call alert. */
- int Ringtone; /* Ringtone for incoming call alert. */
- int Volume; /* Volume of the ringing. */
- int MessageTone; /* The tone for message indication. */
- int WarningTone; /* The tone for warning messages. */
- int Vibration; /* Vibration? */
- int CallerGroups; /* CallerGroups. */
- int ScreenSaver; /* ScreenSaver */
- int AutomaticAnswer; /* Does the phone auto-answer incoming call? */
-} GSM_Profile;
+ GSM_MemoryType MemoryType; /* Type of the memory */
+ int Used; /* Number of used positions */
+ int Free; /* Number of free positions */
+} GSM_MemoryStatus;
-typedef enum {
- PPS_ALS=0,
- PPS_HRData,
- PPS_14400Data,
- PPS_LCDContrast,
- PPS_EFR,
- PPS_FR,
- PPS_HR,
- PPS_GamesMenu, /* N3210 5.26 and higher */
- PPS_VibraMenu /* N3210 */
-} GSM_PPS_Settings;
+/* This data type is used to hold the current SMS status. */
+
+typedef struct {
+ int UnRead; /* The number of unread messages (currently not used) */
+ int Used; /* The number of currently stored messages */
+ int Slots; /* Reading will try all 1..Slots locations */
+} GSM_SMSStatus;
+
+
+
+/* Some phones (at the moment 6210/7110) supports extended phonebook
+ with additional data. Here we have structures for them */
+
+typedef enum
+{
+ GSM_General = 0x0a,
+ GSM_Mobile = 0x03,
+ GSM_Work = 0x06,
+ GSM_Fax = 0x04,
+ GSM_Home = 0x02
+} GSM_Number_Type;
+
+typedef enum
+{
+ GSM_Number = 0x0b,
+ GSM_Note = 0x0a,
+ GSM_Postal = 0x09,
+ GSM_Email = 0x08,
+ GSM_Name = 0x07,
+ GSM_Date = 0x13 /* Date is used for DC,RC,etc (last calls) */
+} GSM_EntryType;
typedef struct {
- GSM_PPS_Settings Name;
- bool bool_value;
- int int_value;
-} GSM_PPS;
+ GSM_EntryType EntryType;
+ GSM_Number_Type NumberType;
+ union {
+ char Number[GSM_MAX_PHONEBOOK_TEXT_LENGTH + 1]; /* Number */
+ GSM_DateTime Date; /* or the last calls list */
+ } data;
+ int BlockNumber;
+} GSM_SubPhonebookEntry;
+
+/* Define datatype for phonebook entry, used for getting/writing phonebook
+ entries. */
typedef struct {
- char data[10+1];//detailed info about this simlock
- bool enabled; //is enabled or not ?
- int counter; //how many times user tried to disable simlock using keypad
- bool factory; //is factory simlock ?
-} GSM_OneSimlock;
+ bool Empty; /* Is this entry empty? */
+ char Name[GSM_MAX_PHONEBOOK_NAME_LENGTH + 1]; /* Plus 1 for
+ nullterminator. */
+ char Number[GSM_MAX_PHONEBOOK_NUMBER_LENGTH + 1]; /* Number */
+ GSM_MemoryType MemoryType; /* Type of memory */
+ int Group; /* Group */
+ int Location; /* Location */
+ GSM_DateTime Date; /* The record date and time
+ of the number. */
+ GSM_SubPhonebookEntry SubEntries[GSM_MAX_PHONEBOOK_SUB_ENTRIES];
+ /* For phones with
+ * additional phonebook
+ * entries */
+ int SubEntriesCount; /* Should be 0, if extended
+ phonebook is not used */
+} GSM_PhonebookEntry;
+
+
+
+/* This define speed dialing entries. */
typedef struct {
- GSM_OneSimlock simlocks[4];
-} GSM_AllSimlocks;
+ int Number; /* Which number is used to dialing? */
+ GSM_MemoryType MemoryType; /* Memory type of the number. */
+ int Location; /* Location of the number in MemoryType. */
+} GSM_SpeedDial;
+
+/* Define enum used to describe what sort of date/time support is
+ available. */
-/* Data structures for the call divert */
typedef enum {
- GSM_CDV_Busy = 0x01, /* Divert when busy */
- GSM_CDV_NoAnswer, /* Divert when not answered */
- GSM_CDV_OutOfReach, /* Divert when phone off or no coverage */
- GSM_CDV_AllTypes /* Divert all calls without ringing */
-} GSM_CDV_DivertTypes;
+ GDT_None, /* The mobile phone doesn't support time and date. */
+ GDT_TimeOnly, /* The mobile phone supports only time. */
+ GDT_DateOnly, /* The mobile phone supports only date. */
+ GDT_DateTime /* Wonderful phone - it supports date and time. */
+} GSM_DateTimeSupport;
+
+/* Define enums for RF units. GRF_CSQ asks for units in form used
+ in AT+CSQ command as defined by GSM 07.07 */
typedef enum {
- GSM_CDV_VoiceCalls = 0x01,
- GSM_CDV_FaxCalls,
- GSM_CDV_DataCalls,
- GSM_CDV_AllCalls
-} GSM_CDV_CallTypes;
+ GRF_Arbitrary,
+ GRF_dBm,
+ GRF_mV,
+ GRF_uV,
+ GRF_CSQ,
+ GRF_Percentage
+} GSM_RFUnits;
+
+/* Define enums for Battery units. */
-/* See GSM 02.82 for diverts types */
typedef enum {
- GSM_CDV_Disable = 0x00,
- GSM_CDV_Enable = 0x01,
- GSM_CDV_Query = 0x02, /* Is concrete divert enabled ? */
- GSM_CDV_Register = 0x03, /* Sets divert */
- GSM_CDV_Erasure = 0x04 /* Erase concrete divert */
-} GSM_CDV_Opers;
+ GBU_Arbitrary,
+ GBU_Volts,
+ GBU_Minutes,
+ GBU_Percentage
+} GSM_BatteryUnits;
+
+/* Define enums for Calendar Note types */
+
+typedef enum {
+ GCN_REMINDER=1, /* Reminder */
+ GCN_CALL, /* Call */
+ GCN_MEETING, /* Meeting */
+ GCN_BIRTHDAY /* Birthday */
+} GSM_CalendarNoteType;
+
+/* Calendar note type */
+
+typedef struct {
+ int Location; /* The number of the note in the phone memory */
+ GSM_CalendarNoteType Type; /* The type of the note */
+ GSM_DateTime Time; /* The time of the note */
+ GSM_DateTime Alarm; /* The alarm of the note */
+ char Text[20]; /* The text of the note */
+ char Phone[20]; /* For Call only: the phone number */
+ double Recurance; /* Recurance of the note */
+} GSM_CalendarNote;
+
+/* This structure is provided to allow common information about the particular
+ model to be looked up in a model independant way. Some of the values here
+ define minimum and maximum levels for values retrieved by the various Get
+ functions for example battery level. They are not defined as constants to
+ allow model specific code to set them during initialisation */
typedef struct {
- GSM_CDV_DivertTypes DType;
- GSM_CDV_CallTypes CType;
- GSM_CDV_Opers Operation;
- char Number[GSM_MAX_SENDER_LENGTH + 1];
- unsigned int Timeout;
- bool Enabled;
-} GSM_CallDivert;
+
+ char *Models; /* Models covered by this type, pipe '|' delimited. */
+
+/* Minimum and maximum levels for RF signal strength. Units are as per the
+ setting of RFLevelUnits. The setting of RFLevelUnits indicates the
+ default or "native" units used. In the case of the 3110 and 6110 series
+ these are arbitrary, ranging from 0 to 4. */
+
+ float MaxRFLevel;
+ float MinRFLevel;
+ GSM_RFUnits RFLevelUnits;
+
+/* Minimum and maximum levels for battery level. Again, units are as per the
+ setting of GSM_BatteryLevelUnits. The value that BatteryLevelUnits is set
+ to indicates the "native" or default value that the phone supports. In the
+ case of the 3110 and 6110 series these are arbitrary, ranging from 0 to 4. */
+
+ float MaxBatteryLevel;
+ float MinBatteryLevel;
+ GSM_BatteryUnits BatteryLevelUnits;
+
+/* FIXME: some very similar code is in common/misc.c */
+
+/* Information about date, time and alarm support. In case of alarm
+ information we provide value for the number of alarms supported. */
+
+ GSM_DateTimeSupport DateTimeSupport;
+ GSM_DateTimeSupport AlarmSupport;
+ int MaximumAlarms;
+ u8 StartupLogoH; /* Logo Widths and Heights - if supported */
+ u8 StartupLogoW;
+ u8 OpLogoH;
+ u8 OpLogoW;
+ u8 CallerLogoH;
+ u8 CallerLogoW;
+} GSM_Information;
/* Define standard GSM error/return code values. These codes are also used for
some internal functions such as SIM read/write in the model specific code. */
GE_NONE = 0, /* No error. */
GE_DEVICEOPENFAILED, /* Couldn't open specified serial device. */
GE_UNKNOWNMODEL, /* Model specified isn't known/supported. */
- GE_NOTSUPPORTED, /* We are sure, that function not supported by phone model */
GE_NOLINK, /* Couldn't establish link with phone. */
GE_TIMEOUT, /* Command timed out. */
GE_TRYAGAIN, /* Try again. */
GE_INVALIDSECURITYCODE, /* Invalid Security code. */
GE_NOTIMPLEMENTED, /* Command called isn't implemented in model. */
GE_INVALIDSMSLOCATION, /* Invalid SMS location. */
- GE_INVALIDPHBOOKLOCATION, /* Invalid phonebook location. */ /*10*/
+ GE_INVALIDPHBOOKLOCATION, /* Invalid phonebook location. */
GE_INVALIDMEMORYTYPE, /* Invalid type of memory. */
GE_INVALIDSPEEDDIALLOCATION, /* Invalid speed dial location. */
GE_INVALIDCALNOTELOCATION,/* Invalid calendar note location. */
GE_PHBOOKNUMBERTOOLONG, /* Phonebook number is too long. */
GE_PHBOOKWRITEFAILED, /* Phonebook write failed. */
GE_SMSSENDOK, /* SMS was send correctly. */
- GE_SMSSENDFAILED, /* SMS send fail. */ /*20*/
+ GE_SMSSENDFAILED, /* SMS send fail. */
GE_SMSWAITING, /* Waiting for the next part of SMS. */
GE_SMSTOOLONG, /* SMS message too long. */
GE_NONEWCBRECEIVED, /* Attempt to read CB when no new CB received */
GE_WRONGCOLORS, /* Wrong colors in bitmap file */
GE_INVALIDFILEFORMAT, /* Invalid format of file */
GE_SUBFORMATNOTSUPPORTED, /* Subformat of file not supported */
- GE_TOOSHORT, /* Too short file, structure, etc. to read */
- GE_TOOLONG, /* Too long file, structure, etc. to read */
- GE_INVALIDIMAGESIZE, /* Invalid size of bitmap (in file, etc.) */
+ GE_FILETOOSHORT, /* Too short file to read */
+ GE_FILETOOLONG, /* Too long file to read */
+ GE_INVALIDIMAGESIZE, /* Invalid size of bitmap (in file, sms etc.) */
+ GE_NOTSUPPORTED, /* Function not supported by the phone */
GE_BUSY, /* Command is still being executed. */
- GE_UNKNOWN, /* Unknown error - well better than nothing!! */
- GE_NOACCESS,
GE_USERCANCELED,
+ GE_UNKNOWN, /* Unknown error - well better than nothing!! */
GE_MEMORYFULL,
- GE_INVALIDRINGLOCATION,
- GE_INSIDEBOOKMARKSMENU,
- GE_INVALIDBOOKMARKLOCATION,
- GE_INSIDESETTINGSMENU,
- GE_INVALIDSETTINGSLOCATION,
-
+ GE_NOTWAITING, /* Not waiting for a response from the phone */
+ GE_NOTREADY,
+
/* The following are here in anticipation of data call requirements. */
GE_LINEBUSY, /* Outgoing call requested reported line busy */
- GE_NOCARRIER, /* No Carrier error during data call setup ? */
- GE_SMSSAVEFAILED, /* save sms failed */
- GE_SMSISINMEM, /* sms is already in memory */
- GE_BUSYSMSLOCATION /* there is a sms at the requested sms location */
+ GE_NOCARRIER /* No Carrier error during data call setup ? */
} GSM_Error;
+
+/* This enum is used for display status. */
+
+typedef enum {
+ DS_Call_In_Progress, /* Call in progress. */
+ DS_Unknown, /* The meaning is unknown now :-( */
+ DS_Unread_SMS, /* There is Unread SMS. */
+ DS_Voice_Call, /* Voice call active. */
+ DS_Fax_Call, /* Fax call active. */
+ DS_Data_Call, /* Data call active. */
+ DS_Keyboard_Lock, /* Keyboard lock status. */
+ DS_SMS_Storage_Full /* Full SMS Memory. */
+} DisplayStatusEntity;
+
+/* Bitmap types. */
+
+typedef enum {
+ GSM_None=0,
+ GSM_StartupLogo,
+ GSM_OperatorLogo,
+ GSM_CallerLogo,
+ GSM_PictureImage,
+ GSM_WelcomeNoteText,
+ GSM_DealerNoteText
+} GSM_Bitmap_Types;
+
+#define GSM_MAX_BITMAP_SIZE 864
+
+/* Structure to hold incoming/outgoing bitmaps (and welcome-notes). */
+
+typedef struct {
+ u8 height; /* Bitmap height (pixels) */
+ u8 width; /* Bitmap width (pixels) */
+ u16 size; /* Bitmap size (bytes) */
+ GSM_Bitmap_Types type; /* Bitmap type */
+ char netcode[7]; /* Network operator code */
+ char text[256]; /* Text used for welcome-note or callergroup name */
+ char dealertext[256]; /* Text used for dealer welcome-note */
+ bool dealerset; /* Is dealer welcome-note set now ? */
+ unsigned char bitmap[GSM_MAX_BITMAP_SIZE]; /* Actual Bitmap */
+ char number; /* Caller group number */
+ char ringtone; /* Ringtone no sent with caller group */
+} GSM_Bitmap;
+
+
+/* NoteValue is encoded as octave(scale)*14 + note */
+/* where for note: c=0, d=2, e=4 .... */
+/* ie. c#=1 and 5 and 13 are invalid */
+/* note=255 means a pause */
+
+#define MAX_RINGTONE_NOTES 256
+
+/* Structure to hold note of ringtone. */
+
+typedef struct {
+ u8 duration;
+ u8 note;
+} GSM_RingtoneNote;
+
+/* Structure to hold ringtones. */
+
+typedef struct {
+ char name[20];
+ u8 tempo;
+ u8 NrNotes;
+ GSM_RingtoneNote notes[MAX_RINGTONE_NOTES];
+} GSM_Ringtone;
+
+/* Structure to hold profile entries. */
+
+typedef struct {
+ int Number; /* The number of the profile. */
+ char Name[40]; /* The name of the profile. */
+ int DefaultName; /* 0-6, when default name is used, -1, when not. */
+ int KeypadTone; /* Volume level for keypad tones. */
+ int Lights; /* Lights on/off. */
+ int CallAlert; /* Incoming call alert. */
+ int Ringtone; /* Ringtone for incoming call alert. */
+ int Volume; /* Volume of the ringing. */
+ int MessageTone; /* The tone for message indication. */
+ int WarningTone; /* The tone for warning messages. */
+ int Vibration; /* Vibration? */
+ int CallerGroups; /* CallerGroups. */
+ int AutomaticAnswer; /* Does the phone auto-answer incoming call? */
+} GSM_Profile;
+
+
+#define FO_SUBMIT 0x01
+#define FO_RD 0x40
+#define FO_VPF_NONE 0x00
+#define FO_VPF_REL 0x10
+#define FO_VPF_ABS 0x18
+#define FO_VPF_ENH 0x08
+#define FO_SRR 0x20
+#define FO_UDHI 0x40
+#define FO_RP 0x80
+#define FO_DEFAULT (FO_SUBMIT | FO_VPF_REL | FO_SRR)
+
+#define PID_DEFAULT 0x00
+#define PID_TYPE0 0x40
+#define PID_REPLACE1 0x41
+#define PID_REPLACE2 0x42
+#define PID_REPLACE3 0x43
+#define PID_REPLACE4 0x44
+#define PID_REPLACE5 0x45
+#define PID_REPLACE6 0x46
+#define PID_REPLACE7 0x47
+#define PID_RETURN_CALL 0x5f
+
+#define DCS_DEFAULT 0x00
+#define DCS_MSG_WAIT_VOICE_DISCARD 0xc8
+#define DCS_MSG_WAIT_VOICE_OFF 0xc0
+#define DCS_MSG_WAIT_VOICE_STORE 0xd8
+#define DCS_DATA 0xf4
+#define DCS_CLASS0 0xf0
+#define DCS_CLASS1 0xf1
+#define DCS_CLASS2 0xf2
+#define DCS_CLASS3 0xf3
+
+/* Limits for IMEI, Revision and Model string storage. */
+
+#define GSM_MAX_IMEI_LENGTH (20)
+#define GSM_MAX_REVISION_LENGTH (16)
+#define GSM_MAX_MODEL_LENGTH (64)
+#define GSM_MAX_MANUFACTURER_LENGTH (36)
+
+
+
+/* This is a generic holder for high level information - eg a GSM_Bitmap */
+
+typedef struct {
+ GSM_SMSMessage *SMSMessage;
+ GSM_PhonebookEntry *PhonebookEntry;
+ GSM_SpeedDial *SpeedDial;
+ GSM_MemoryStatus *MemoryStatus;
+ GSM_SMSStatus *SMSStatus;
+ GSM_MessageCenter *MessageCenter;
+ char *Imei;
+ char *Revision;
+ char *Model;
+ char *Manufacturer;
+ GSM_NetworkInfo *NetworkInfo;
+ GSM_CalendarNote *CalendarNote;
+ GSM_Bitmap *Bitmap;
+ char *BitmapDest;
+ GSM_Ringtone *Ringtone;
+ char *RingtoneDest;
+ GSM_Profile *Profile;
+ GSM_BatteryUnits *BatteryUnits;
+ float *BatteryLevel;
+ GSM_RFUnits *RFUnits;
+ float *RFLevel;
+ GSM_Error (*OutputFn)(char *Display, char *Indicators);
+ char *IncomingCallNr;
+ GSM_PowerSource *PowerSource;
+ GSM_SecurityCode *SecurityCode;
+ GSM_SecurityCodeType *SecurityCodeStatus;
+ GSM_DateTime *DateTime;
+ int *AlarmNumber;
+ GSM_DateTime *AlarmDateTime;
+ char *VoiceNumber;
+ char *DataNumber;
+ char *DataType;
+ void (*DataCallPassUp)(char c);
+ unsigned char *NetMonitorMode;
+ char *NetMonitorScreen;
+ char *DTMF;
+ char *ResetType;
+ RLP_F96Frame *RLPFrame;
+ bool *RLPFrame_out_dtx;
+ GSM_CBMessage *CBMessage;
+ int *SetKeyKey;
+ int *SetKeyUp;
+ char *HandleString;
+ char *CallNo;
+ int *DisplayStatus;
+} GSM_Data;
+
+
+/* Global structures intended to be independant of phone etc */
+/* Obviously currently rather Nokia biased but I think most things */
+/* (eg at commands) can be enumerated */
+
+
+/* A structure to hold information about the particular link */
+/* The link comes 'under' the phone */
+typedef struct {
+ char PortDevice[20]; /* The port device */
+ int InitLength; /* Number of chars sent to sync the serial port */
+ GSM_ConnectionType ConnectionType; /* Connection type, serial, ir etc */
+
+ /* A regularly called loop function */
+ /* timeout can be used to make the function block or not */
+ GSM_Error (*Loop)(struct timeval *timeout);
+
+ /* A pointer to the function used to send out a message */
+ /* This is used by the phone specific code to send a message over the link */
+ GSM_Error (*SendMessage)(u16 messagesize, u8 messagetype, void *message);
+
+} GSM_Link;
+
+
+/* Small structure used in GSM_Phone */
+/* Messagetype is passed to the function in case it is a 'generic' one */
+typedef struct {
+ u8 MessageType;
+ GSM_Error (*Functions)(int messagetype, unsigned char *buffer, int length, GSM_Data *data);
+} GSM_IncomingFunctionType;
+
+typedef enum {
+ GOP_Init,
+ GOP_Terminate,
+ GOP_GetModel,
+ GOP_GetRevision,
+ GOP_GetImei,
+ GOP_GetManufacturer,
+ GOP_Identify,
+ GOP_GetBitmap,
+ GOP_SetBitmap,
+ GOP_SetRingtone,
+ GOP_GetBatteryLevel,
+ GOP_GetRFLevel,
+ GOP_DisplayOutput,
+ GOP_GetMemoryStatus,
+ GOP_ReadPhonebook,
+ GOP_WritePhonebook,
+ GOP_GetPowersource,
+ GOP_GetDisplayStatus,
+ GOP_EnterSecurityCode,
+ GOP_GetSecurityCodeStatus,
+ GOP_GetAlarm,
+ GOP_SetAlarm,
+ GOP_DialVoice,
+ GOP_DialData,
+ GOP_GetSMSStatus,
+ GOP_SetSMSStatus,
+ GOP_GetIncomingCallNr,
+ GOP_GetNetworkInfo,
+ GOP_GetSMS,
+ GOP_DeleteSMS,
+ GOP_SendSMS,
+ GOP_SaveSMS,
+ GOP_GetSpeedDial,
+ GOP_SetSpeedDial,
+ GOP_GetSMSCenter,
+ GOP_SetSMSCenter,
+ GOP_GetDateTime,
+ GOP_SetDateTime,
+ GOP_GetCalendarNote,
+ GOP_WriteCalendarNote,
+ GOP_DeleteCalendarNote,
+ GOP_NetMonitor,
+ GOP_SendDTMF,
+ GOP_Reset,
+ GOP_GetProfile,
+ GOP_SetProfile,
+ GOP_SendRLPFrame,
+ GOP_CancelCall,
+ GOP_EnableDisplayOutput,
+ GOP_DisableDisplayOutput,
+ GOP_EnableCellBroadcast,
+ GOP_DisableCellBroadcast,
+ GOP_ReadCellBroadcast,
+ GOP_SetKey,
+ GOP_HandleString,
+ GOP_AnswerCall,
+ GOP_Max /* don't append anything after this entry */
+} GSM_Operation;
+
+/* This structure contains the 'callups' needed by the statemachine */
+/* to deal with messages from the phone and other information */
+
+typedef struct _GSM_Statemachine GSM_Statemachine;
+
+typedef struct {
+ /* These make up a list of functions, one for each message type and NULL terminated */
+ GSM_IncomingFunctionType *IncomingFunctions;
+ GSM_Error (*DefaultFunction)(int messagetype, unsigned char *buffer, int length);
+ GSM_Information Info;
+ GSM_Error (*Functions)(GSM_Operation op, GSM_Data *data, GSM_Statemachine *state);
+} GSM_Phone;
+
+
+/* The states the statemachine can take */
+
+typedef enum {
+ Startup, /* Not yet initialised */
+ Initialised, /* Ready! */
+ MessageSent, /* A command has been sent to the link(phone) */
+ WaitingForResponse, /* We are waiting for a response from the link(phone) */
+ ResponseReceived /* A response has been received - waiting for the phone layer to collect it */
+} GSM_State;
+
+/* How many message types we can wait for at one */
+#define SM_MAXWAITINGFOR 3
+
+
+/* All properties of the state machine */
+
+struct _GSM_Statemachine{
+ GSM_State CurrentState;
+ GSM_Link Link;
+ GSM_Phone Phone;
+
+ /* Store last message for resend purposes */
+ u8 LastMsgType;
+ u16 LastMsgSize;
+ void *LastMsg;
+
+ /* The responses we are waiting for */
+ unsigned char NumWaitingFor;
+ unsigned char NumReceived;
+ unsigned char WaitingFor[SM_MAXWAITINGFOR];
+ GSM_Error ResponseError[SM_MAXWAITINGFOR];
+ /* Data structure to be filled in with the response */
+ GSM_Data *Data[SM_MAXWAITINGFOR];
+};
+
+
+
+/* Define the structure used to hold pointers to the various API functions.
+ This is in effect the master list of functions provided by the gnokii API.
+ Modules containing the model specific code each contain one of these
+ structures which is "filled in" with the corresponding function within the
+ model specific code. If a function is not supported or not implemented, a
+ generic not implemented function is used to return a GE_NOTIMPLEMENTED
+ error code. */
+
+typedef struct {
+
+ /* FIXME: comment this. */
+
+ GSM_Error (*Initialise)( char *port_device, char *initlength,
+ GSM_ConnectionType connection,
+ void (*rlp_callback)(RLP_F96Frame *frame));
+
+ void (*Terminate)(void);
+
+ GSM_Error (*GetMemoryLocation)( GSM_PhonebookEntry *entry );
+
+ GSM_Error (*WritePhonebookLocation)( GSM_PhonebookEntry *entry );
+
+ GSM_Error (*GetSpeedDial)( GSM_SpeedDial *entry);
+
+ GSM_Error (*SetSpeedDial)( GSM_SpeedDial *entry);
+
+ GSM_Error (*GetMemoryStatus)( GSM_MemoryStatus *Status);
+
+ GSM_Error (*GetSMSStatus)( GSM_SMSStatus *Status);
+
+ GSM_Error (*GetSMSCenter)( GSM_MessageCenter *MessageCenter );
+
+ GSM_Error (*SetSMSCenter)( GSM_MessageCenter *MessageCenter );
+
+ GSM_Error (*GetSMSMessage)( GSM_SMSMessage *Message );
+
+ GSM_Error (*DeleteSMSMessage)( GSM_SMSMessage *Message );
+
+ GSM_Error (*SendSMSMessage)( GSM_SMSMessage *Message );
+
+ GSM_Error (*SaveSMSMessage)( GSM_SMSMessage *Message );
+
+ /* If units is set to a valid GSM_RFUnits value, the code
+ will return level in these units if it is able. Otherwise
+ value will be returned as GRF_Arbitary. If phone doesn't
+ support GetRFLevel, function returns GE_NOTSUPPORTED */
+ GSM_Error (*GetRFLevel)( GSM_RFUnits *units, float *level );
+
+ /* Works the same as GetRFLevel, except returns battery
+ level if known. */
+ GSM_Error (*GetBatteryLevel)( GSM_BatteryUnits *units, float *level );
+
+ GSM_Error (*GetPowerSource)( GSM_PowerSource *source);
+
+ GSM_Error (*GetDisplayStatus)( int *Status);
+
+ GSM_Error (*EnterSecurityCode)( GSM_SecurityCode Code);
+
+ GSM_Error (*GetSecurityCodeStatus)( int *Status );
+
+ GSM_Error (*GetIMEI)( char *imei );
+
+ GSM_Error (*GetRevision)( char *revision );
+
+ GSM_Error (*GetModel)( char *model );
+
+ GSM_Error (*GetManufacturer)( char *manufacturer );
+
+ GSM_Error (*GetDateTime)( GSM_DateTime *date_time);
+
+ GSM_Error (*SetDateTime)( GSM_DateTime *date_time);
+
+ GSM_Error (*GetAlarm)( int alarm_number, GSM_DateTime *date_time );
+
+ GSM_Error (*SetAlarm)( int alarm_number, GSM_DateTime *date_time );
+
+ GSM_Error (*DialVoice)( char *Number);
+
+ GSM_Error (*DialData)( char *Number, char type, void (* callpassup)(char c));
+
+ GSM_Error (*GetIncomingCallNr)( char *Number );
+
+ GSM_Error (*GetNetworkInfo) ( GSM_NetworkInfo *NetworkInfo );
+
+ GSM_Error (*GetCalendarNote) ( GSM_CalendarNote *CalendarNote);
+
+ GSM_Error (*WriteCalendarNote) ( GSM_CalendarNote *CalendarNote);
+
+ GSM_Error (*DeleteCalendarNote) ( GSM_CalendarNote *CalendarNote);
+
+ GSM_Error (*NetMonitor) ( unsigned char mode, char *Screen );
+
+ GSM_Error (*SendDTMF) ( char *String );
+
+ GSM_Error (*GetBitmap) ( GSM_Bitmap *Bitmap );
+
+ GSM_Error (*SetBitmap) ( GSM_Bitmap *Bitmap );
+
+ GSM_Error (*SetRingtone) ( GSM_Ringtone *ringtone );
+
+ GSM_Error (*Reset) ( unsigned char type );
+
+ GSM_Error (*GetProfile) ( GSM_Profile *Profile );
+
+ GSM_Error (*SetProfile) ( GSM_Profile *Profile );
+
+ bool (*SendRLPFrame) ( RLP_F96Frame *frame, bool out_dtx );
+
+ GSM_Error (*CancelCall) ();
+
+ GSM_Error (*EnableDisplayOutput) ();
+
+ GSM_Error (*DisableDisplayOutput) ();
+
+ GSM_Error (*EnableCellBroadcast) ();
+
+ GSM_Error (*DisableCellBroadcast) ();
+
+ GSM_Error (*ReadCellBroadcast) ( GSM_CBMessage *Message );
+
+ GSM_Error (*SetKey) (int c, int up);
+
+ GSM_Error (*HandleString) (char *s);
+
+ GSM_Error (*AnswerCall) (char s);
+
+} GSM_Functions;
+
+typedef struct {
+ bool first; /* MUST be set to "true" during the first call of SMS_Deconcatenate() */
+ bool singleshot; /* no concatenation wrapping was needed */
+ unsigned sequence; /* =1 for the first part etc. */
+ u8 *sequencep; /* For updating inside-PDU header sequence number */
+ size_t cargoitems; /* How many items of MessageText fit in one SMS part */
+ } GSM_Deconcatenate_state;
+
+/* Undefined functions in fbus/mbus files */
+extern GSM_Error Unimplemented(void);
+#define UNIMPLEMENTED (void *) Unimplemented
+
+extern unsigned char GSM_Default_Alphabet[];
+
+/* Coding functions */
+extern void EncodeAscii (unsigned char* dest, const unsigned char* src, int len);
+extern void DecodeAscii (unsigned char* dest, const unsigned char* src, int len);
+extern void EncodeUnicode (unsigned char* dest, const unsigned char* src, int len);
+extern void DecodeUnicode (unsigned char* dest, const unsigned char* src, int len);
+
+extern unsigned char EncodeWithDefaultAlphabet(unsigned char);
+extern unsigned char DecodeWithDefaultAlphabet(unsigned char);
+extern wchar_t EncodeWithUnicodeAlphabet(unsigned char);
+extern unsigned char DecodeWithUnicodeAlphabet(wchar_t);
+extern GSM_MemoryType StrToMemoryType (const char *s);
+extern unsigned char SMS_Validity_to_VP(int Validity);
+extern int SMS_VP_to_Validity(GSM_SMSMessageValidity Validity);
+extern int SemiOctetPack(char *Number, unsigned char *Output);
+extern char *SemiOctetUnpack(char *dest,size_t destlen,u8 *Number,size_t nibbles);
+extern char *SemiOctetUnpack_static(u8 *Number,size_t nibbles);
+#define SEMIOCTETUNPACK_STATIC_BYTES(Number) (SemiOctetUnpack_static((Number)+1,*(Number)*2))
+#define SEMIOCTETUNPACK_STATIC_NIBBLES(Number) (SemiOctetUnpack_static((Number)+1,*(Number) ))
+extern int PackSevenBitsToEight(int UsedBits, unsigned char *input, unsigned char *output);
+extern int UnpackEightBitsToSeven(int offset, int in_length, int out_length,
+ unsigned char *input, unsigned char *output);
+extern GSM_Error SMS_SetupUDH(GSM_SMSMessage *sms,GSM_UDH UDHType);
+extern GSM_UDH SMS_DetectUDH(GSM_SMSMessage *sms);
+extern bool SMS_Deconcatenate(GSM_Deconcatenate_state *state,GSM_SMSMessage *sms,char *buf,size_t buflen,bool useudh);
+extern u8 *SMS_BlockFromHex(u8 *d,const char *s,size_t len);
+extern char *SMS_BlockToHex(char *d,const u8 *s,size_t len);
+
+inline void GSM_DataClear(GSM_Data *data);
+
#endif /* __gsm_common_h */