Memory

Data Structures
struct	GSM_MemoryStatus
struct	GSM_SubMemoryEntry
struct	GSM_MemoryEntry
struct	GSM_SpeedDial

Macros
#define	GSM_MemoryTypeToString(x)

Enumerations
enum	GSM_MemoryType {   MEM_ME = 1, MEM_SM, MEM_ON, MEM_DC,   MEM_RC, MEM_MC, MEM_MT, MEM_FD,   MEM_VM, MEM_SL, MEM_QD, MEM_INVALID }
enum	GSM_EntryType {   PBK_Number_General = 1, PBK_Number_Mobile, PBK_Number_Fax, PBK_Number_Pager,   PBK_Number_Other, PBK_Text_Note, PBK_Text_Postal, PBK_Text_Email,   PBK_Text_Email2, PBK_Text_URL, PBK_Date, PBK_Caller_Group,   PBK_Text_Name, PBK_Text_LastName, PBK_Text_FirstName, PBK_Text_Company,   PBK_Text_JobTitle, PBK_Category, PBK_Private, PBK_Text_StreetAddress,   PBK_Text_City, PBK_Text_State, PBK_Text_Zip, PBK_Text_Country,   PBK_Text_Custom1, PBK_Text_Custom2, PBK_Text_Custom3, PBK_Text_Custom4,   PBK_RingtoneID, PBK_PictureID, PBK_Text_UserID, PBK_CallLength,   PBK_Text_LUID, PBK_LastModified, PBK_Text_NickName, PBK_Text_FormalName,   PBK_Text_PictureName, PBK_PushToTalkID, PBK_Number_Messaging, PBK_Photo,   PBK_Text_SecondName, PBK_Text_VOIP, PBK_Text_SIP, PBK_Text_DTMF,   PBK_Number_Video, PBK_Text_SWIS, PBK_Text_WVID, PBK_Text_NamePrefix,   PBK_Text_NameSuffix }
enum	GSM_EntryLocation { PBK_Location_Unknown = 0, PBK_Location_Home, PBK_Location_Work }
enum	GSM_VCardVersion {   Nokia_VCard10 = 1, Nokia_VCard21, SonyEricsson_VCard10, SonyEricsson_VCard21,   SonyEricsson_VCard21_Phone }

Functions
GSM_Error	GSM_GetMemoryStatus (GSM_StateMachine *s, GSM_MemoryStatus *status)
GSM_Error	GSM_GetMemory (GSM_StateMachine *s, GSM_MemoryEntry *entry)
GSM_Error	GSM_GetNextMemory (GSM_StateMachine *s, GSM_MemoryEntry *entry, gboolean start)
GSM_Error	GSM_SetMemory (GSM_StateMachine *s, GSM_MemoryEntry *entry)
GSM_Error	GSM_AddMemory (GSM_StateMachine *s, GSM_MemoryEntry *entry)
GSM_Error	GSM_DeleteMemory (GSM_StateMachine *s, GSM_MemoryEntry *entry)
GSM_Error	GSM_DeleteAllMemory (GSM_StateMachine *s, GSM_MemoryType MemoryType)
GSM_Error	GSM_GetSpeedDial (GSM_StateMachine *s, GSM_SpeedDial *Speed)
GSM_Error	GSM_SetSpeedDial (GSM_StateMachine *s, GSM_SpeedDial *Speed)
unsigned char *	GSM_PhonebookGetEntryName (const GSM_MemoryEntry *entry)
void	GSM_PhonebookFindDefaultNameNumberGroup (const GSM_MemoryEntry *entry, int *Name, int *Number, int *Group)
GSM_Error	GSM_EncodeVCARD (GSM_Debug_Info *di, char *Buffer, const size_t buff_len, size_t *Pos, GSM_MemoryEntry *pbk, const gboolean header, const GSM_VCardVersion Version)
GSM_Error	GSM_DecodeVCARD (GSM_Debug_Info *di, char *Buffer, size_t *Pos, GSM_MemoryEntry *Pbk, const GSM_VCardVersion Version)

Detailed Description

Memory entries manipulations.

Macro Definition Documentation

GSM_MemoryTypeToString

#define GSM_MemoryTypeToString

(

x

)

Value:

((x) == MEM_ME ? "ME" : \
        ((x) == MEM_SM ? "SM" : \
        ((x) == MEM_ON ? "ON" : \
        ((x) == MEM_DC ? "DC" : \
        ((x) == MEM_RC ? "RC" : \
        ((x) == MEM_MC ? "MC" : \
        ((x) == MEM_MT ? "MT" : \
        ((x) == MEM_FD ? "FD" : \
        ((x) == MEM_VM ? "VM" : \
        ((x) == MEM_QD ? "QD" : \
        ((x) == MEM_SL ? "SL" : "XX")))))))))))

Returns string representation of a memory type.

Parameters

x	Memory type to convert

Returns

Static string.

Definition at line 95 of file gammu-memory.h.

Referenced by DUMMY_AddMemory(), DUMMY_DeleteAllMemory(), DUMMY_GetMemoryStatus(), DUMMY_GetNextMemory(), DUMMY_MemoryPath(), and GSM_EncodeVCARD().

Enumeration Type Documentation

GSM_EntryLocation

enum GSM_EntryLocation

Location of memory contact.

Enumerator
PBK_Location_Unknown	No/Unknown location.
PBK_Location_Home	Home
PBK_Location_Work	Work

Definition at line 348 of file gammu-memory.h.

             {
        PBK_Location_Unknown = 0,
        PBK_Location_Home,
        PBK_Location_Work,
} GSM_EntryLocation;

GSM_EntryType

enum GSM_EntryType

Type of specific phonebook entry. In parenthesis is specified in which member of GSM_SubMemoryEntry value is stored.

Enumerator
PBK_Number_General	General number. (Text)
PBK_Number_Mobile	Mobile number. (Text)
PBK_Number_Fax	Fax number. (Text)
PBK_Number_Pager	Pager number. (Text)
PBK_Number_Other	Other number. (Text)
PBK_Text_Note	Note. (Text)
PBK_Text_Postal	Complete postal address. (Text)
PBK_Text_Email	Email. (Text)
PBK_Text_Email2
PBK_Text_URL	URL (Text)
PBK_Date	Date and time of last call. (Date)
PBK_Caller_Group	Caller group. (Number)
PBK_Text_Name	Name (Text)
PBK_Text_LastName	Last name. (Text)
PBK_Text_FirstName	First name. (Text)
PBK_Text_Company	Company. (Text)
PBK_Text_JobTitle	Job title. (Text)
PBK_Category	Category. (Number, if -1 then text)
PBK_Private	Whether entry is private. (Number)
PBK_Text_StreetAddress	Street address. (Text)
PBK_Text_City	City. (Text)
PBK_Text_State	State. (Text)
PBK_Text_Zip	Zip code. (Text)
PBK_Text_Country	Country. (Text)
PBK_Text_Custom1	Custom information 1. (Text)
PBK_Text_Custom2	Custom information 2. (Text)
PBK_Text_Custom3	Custom information 3. (Text)
PBK_Text_Custom4	Custom information 4. (Text)
PBK_RingtoneID	Ringtone ID. (Number)
PBK_PictureID	Picture ID. (Number)
PBK_Text_UserID	User ID. (Text)
PBK_CallLength	Length of call (Number)
PBK_Text_LUID	LUID - Unique Identifier used for synchronisation (Text)
PBK_LastModified	Date of last modification (Date)
PBK_Text_NickName	Nick name (Text)
PBK_Text_FormalName	Formal name (Text)
PBK_Text_PictureName	Picture name (on phone filesystem). (Text)
PBK_PushToTalkID	Push-to-talk ID (Text)
PBK_Number_Messaging	Favorite messaging number. (Text)
PBK_Photo	Photo (Picture).
PBK_Text_SecondName	Second name. (Text)
PBK_Text_VOIP	VOIP address (Text).
PBK_Text_SIP	SIP address (Text).
PBK_Text_DTMF	DTMF (Text).
PBK_Number_Video	Video number. (Text)
PBK_Text_SWIS	See What I See address. (Text)
PBK_Text_WVID	Wireless Village user ID. (Text)
PBK_Text_NamePrefix	Name prefix (Text)
PBK_Text_NameSuffix	Name suffix (Text)

Definition at line 144 of file gammu-memory.h.

             {
        PBK_Number_General = 1,
        PBK_Number_Mobile,
        PBK_Number_Fax,
        PBK_Number_Pager,
        PBK_Number_Other,
        PBK_Text_Note,
        PBK_Text_Postal,
        PBK_Text_Email,
        /*
         * Second email. (Text)
         */
        PBK_Text_Email2,
        PBK_Text_URL,
        PBK_Date,
        PBK_Caller_Group,
        PBK_Text_Name,
        PBK_Text_LastName,
        PBK_Text_FirstName,
        PBK_Text_Company,
        PBK_Text_JobTitle,
        PBK_Category,
        PBK_Private,
        PBK_Text_StreetAddress,
        PBK_Text_City,
        PBK_Text_State,
        PBK_Text_Zip,
        PBK_Text_Country,
        PBK_Text_Custom1,
        PBK_Text_Custom2,
        PBK_Text_Custom3,
        PBK_Text_Custom4,
        PBK_RingtoneID,
        PBK_PictureID,
        PBK_Text_UserID,
        PBK_CallLength,
        PBK_Text_LUID,
        PBK_LastModified,
        PBK_Text_NickName,
        PBK_Text_FormalName,
        PBK_Text_PictureName,
        PBK_PushToTalkID,
        PBK_Number_Messaging,
        PBK_Photo,
        PBK_Text_SecondName,
        PBK_Text_VOIP,
        PBK_Text_SIP,
        PBK_Text_DTMF,
        PBK_Number_Video,
        PBK_Text_SWIS,
        PBK_Text_WVID,
        PBK_Text_NamePrefix,
        PBK_Text_NameSuffix,
} GSM_EntryType;

GSM_MemoryType

enum GSM_MemoryType

Enum defines ID for various phone and SIM memories. Phone modules can translate them to values specific for concrete models. Two letter codes (excluding VM and SL) are from GSM 07.07.

Enumerator
MEM_ME	Internal memory of the mobile equipment
MEM_SM	SIM card memory
MEM_ON	Own numbers
MEM_DC	Dialled calls
MEM_RC	Received calls
MEM_MC	Missed calls
MEM_MT	Combined ME and SIM phonebook
MEM_FD	Fixed dial
MEM_VM	Voice mailbox
MEM_SL	Sent SMS logs
MEM_QD	Quick dialing choices.
MEM_INVALID	Invalid memory type.

Definition at line 31 of file gammu-memory.h.

             {
        MEM_ME = 1,
        MEM_SM,
        MEM_ON,
        MEM_DC,
        MEM_RC,
        MEM_MC,
        MEM_MT,
        MEM_FD,

        MEM_VM,

        MEM_SL,

        MEM_QD,

        MEM_INVALID
} GSM_MemoryType;

GSM_VCardVersion

enum GSM_VCardVersion

Types of vCard.

Enumerator
Nokia_VCard10	vCard 1.0 hacked for Nokia.
Nokia_VCard21	vCard 2.1 hacked for Nokia.
SonyEricsson_VCard10	vCard 1.0 hacked for Sony-Ericsson (should be standard vCard).
SonyEricsson_VCard21	vCard 2.1 hacked for Sony-Ericsson (should be standard vCard).
SonyEricsson_VCard21_Phone	vCard 2.1 hacked for Sony-Ericsson (should be standard vCard) from phone (no parsing of location and memory type).

Definition at line 602 of file gammu-memory.h.

             {
        Nokia_VCard10 = 1,
        Nokia_VCard21,
        SonyEricsson_VCard10,
        SonyEricsson_VCard21,
        SonyEricsson_VCard21_Phone,
} GSM_VCardVersion;

Function Documentation

GSM_AddMemory()

GSM_Error GSM_AddMemory	(	GSM_StateMachine *	s,
		GSM_MemoryEntry *	entry
	)

Adds memory (phonebooks or calls) entry.

Parameters

s	State machine pointer.
entry	Entry to add, Location is ignored, MemoryType has to be set.

Returns

Error code.

Deletes memory (phonebooks or calls) entry.

Definition at line 561 of file api.c.

References GSM_Phone_Functions::AddMemory, CHECK_PHONE_CONNECTION, GSM_Phone::Functions, _GSM_StateMachine::Phone, PRINT_LOG_ERROR, and PRINT_MEMORY_INFO.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();
        PRINT_MEMORY_INFO();

        err = s->Phone.Functions->AddMemory(s, entry);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_DecodeVCARD()

GSM_Error GSM_DecodeVCARD	(	GSM_Debug_Info *	di,
		char *	Buffer,
		size_t *	Pos,
		GSM_MemoryEntry *	Pbk,
		GSM_VCardVersion	Version
	)

Decodes memory entry from vCard.

Parameters

	di	Pointer to debugging description.
[in]	Buffer	Buffer to readCard text.
[in,out]	Pos	Position in output buffer.
[out]	Pbk	Phonebook data read from vCard.
[in]	Version	What vCard version to parse.

Returns

Error code.

Bug:

We should avoid using static buffers here.

Definition at line 677 of file gsmpbk.c.

References GSM_BinaryPicture::Buffer, CHECK_NUM_ENTRIES, CopyUnicodeString(), GSM_SubMemoryEntry::Date, dbgprintf, DecodeBASE64(), DecodeUnicodeString(), GSM_MemoryEntry::Entries, GSM_MemoryEntry::EntriesNum, GSM_SubMemoryEntry::EntryType, ERR_EMPTY, ERR_MOREMEMORY, ERR_NONE, GSM_GetVCSLine(), GSM_StringToMemoryType(), GSM_TweakInternationalNumber(), GSM_BinaryPicture::Length, GSM_SubMemoryEntry::Location, GSM_MemoryEntry::Location, MEM_MT, GSM_MemoryEntry::MemoryType, GSM_SubMemoryEntry::Number, NUMBER_INTERNATIONAL_NUMBERING_PLAN_ISDN, PBK_Caller_Group, PBK_Category, PBK_Date, PBK_LastModified, PBK_Location_Unknown, PBK_Number_Fax, PBK_Number_General, PBK_Number_Mobile, PBK_Number_Other, PBK_Number_Video, PBK_Photo, PBK_Private, PBK_PushToTalkID, PBK_Text_City, PBK_Text_Company, PBK_Text_Country, PBK_Text_DTMF, PBK_Text_Email, PBK_Text_FirstName, PBK_Text_FormalName, PBK_Text_JobTitle, PBK_Text_LastName, PBK_Text_LUID, PBK_Text_Name, PBK_Text_NamePrefix, PBK_Text_NameSuffix, PBK_Text_NickName, PBK_Text_Note, PBK_Text_Postal, PBK_Text_SIP, PBK_Text_State, PBK_Text_StreetAddress, PBK_Text_SWIS, PBK_Text_URL, PBK_Text_VOIP, PBK_Text_WVID, PBK_Text_Zip, GSM_SubMemoryEntry::Picture, PICTURE_JPG, ReadVCALDateTime(), ReadVCALText(), GSM_SubMemoryEntry::SMSList, SonyEricsson_VCard21_Phone, GSM_SubMemoryEntry::Text, TRUE, GSM_BinaryPicture::Type, UnicodeLength(), VCALGetTextPart(), and GSM_SubMemoryEntry::VoiceTag.

{
        char   Buff[20000];
        int          Level = 0;
        char   *s;
        int             pos;
        int             version = 1;
        GSM_Error       error;
        char    *Line = NULL;
        GSM_EntryLocation location;

        Buff[0]  = 0;
        Pbk->EntriesNum = 0;
        if (Version != SonyEricsson_VCard21_Phone) {
                Pbk->Location = 0;
                Pbk->MemoryType = MEM_MT;
        }

        while (1) {
                free(Line);
                Line = NULL;
                error = GSM_GetVCSLine(&Line, Buffer, Pos, strlen(Buffer), TRUE);
                if (error != ERR_NONE) goto vcard_done;
                if (strlen(Line) == 0) break;
                switch (Level) {
                case 0:
                        if (strstr(Line,"BEGIN:VCARD")) Level = 1;
                        break;
                case 1:
                        CHECK_NUM_ENTRIES;
                        if (strstr(Line,"END:VCARD")) {
                                goto vcard_complete;
                        }
                        if (strstr(Line, "VERSION:") != NULL) {
                                version = atoi(Line + 8);
                                dbgprintf(di, "vCard version %d\n", version);
                        }
                        if (ReadVCALText(Line, "N", Buff,  (version >= 3), NULL)) {
                                pos = 0;
                                s = VCALGetTextPart(Buff, &pos);
                                if (s == NULL) {
                                        CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                        Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_Name;
                                        Pbk->Entries[Pbk->EntriesNum].Location = PBK_Location_Unknown;
                                        Pbk->EntriesNum++;
                                        continue;
                                } else {
                                        CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text, s);
                                        /* Skip empty name */
                                        if (UnicodeLength(Pbk->Entries[Pbk->EntriesNum].Text) > 0) {
                                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_LastName;
                                                Pbk->Entries[Pbk->EntriesNum].Location = PBK_Location_Unknown;
                                                Pbk->EntriesNum++;
                                        }

                                        s = VCALGetTextPart(Buff, &pos);
                                        if (s == NULL) continue;
                                        CHECK_NUM_ENTRIES;
                                        CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text, s);
                                        Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_FirstName;
                                        Pbk->Entries[Pbk->EntriesNum].Location = PBK_Location_Unknown;
                                        Pbk->EntriesNum++;
                                        continue;
                                }
                        }
                        if (strncmp(Line, "PHOTO;JPEG;BASE64:", 18) == 0 ||
                                strncmp(Line, "PHOTO;BASE64;JPEG:", 18) == 0 ||
                                strncmp(Line, "PHOTO;TYPE=JPEG;BASE64:", 23) == 0 ||
                                strncmp(Line, "PHOTO;BASE64;TYPE=JPEG:", 23) == 0 ||
                                strncmp(Line, "PHOTO;TYPE=JPEG;ENCODING=BASE64:", 32) == 0 ||
                                strncmp(Line, "PHOTO;ENCODING=BASE64;TYPE=JPEG:", 32) == 0 ||
                                strncmp(Line, "PHOTO;JPEG;ENCODING=BASE64:", 27) == 0 ||
                                strncmp(Line, "PHOTO;ENCODING=BASE64;JPEG:", 27) == 0) {
                                /* Find : (it should be there we matched it above) */
                                s = strchr(Line, ':');
                                s++;
                                /* Skip whitespace */
                                while (isspace((int)*s) && *s) s++;

                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Photo;
                                Pbk->Entries[Pbk->EntriesNum].Location = PBK_Location_Unknown;
                                Pbk->Entries[Pbk->EntriesNum].Picture.Type = PICTURE_JPG;

                                /* We allocate here more memory than is actually required */
                                Pbk->Entries[Pbk->EntriesNum].Picture.Buffer = (unsigned char *)malloc(strlen(s));
                                if (Pbk->Entries[Pbk->EntriesNum].Picture.Buffer == NULL)
                                        return ERR_MOREMEMORY;

                                Pbk->Entries[Pbk->EntriesNum].Picture.Length =
                                        DecodeBASE64(s, Pbk->Entries[Pbk->EntriesNum].Picture.Buffer, strlen(s));
                                Pbk->EntriesNum++;
                                continue;
                        }

                        if (ReadVCALText(Line, "TEL",              Buff,  (version >= 3), &location) ||
                            ReadVCALText(Line, "TEL;VOICE",          Buff,  (version >= 3), &location) ||
                            ReadVCALText(Line, "TEL;MAIN",           Buff,  (version >= 3), &location)) {
                                if (Buff[1] == '+') {
                                        GSM_TweakInternationalNumber(Buff, NUMBER_INTERNATIONAL_NUMBERING_PLAN_ISDN);
                                }
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Number_General;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->Entries[Pbk->EntriesNum].SMSList[0] = 0;
                                Pbk->Entries[Pbk->EntriesNum].VoiceTag = 0;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "TEL;VIDEO",          Buff,  (version >= 3), &location)) {
                                if (Buff[1] == '+') {
                                        GSM_TweakInternationalNumber(Buff, NUMBER_INTERNATIONAL_NUMBERING_PLAN_ISDN);
                                }
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Number_Video;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->Entries[Pbk->EntriesNum].SMSList[0] = 0;
                                Pbk->Entries[Pbk->EntriesNum].VoiceTag = 0;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "TEL;CELL",            Buff,  (version >= 3), &location) ||
                            ReadVCALText(Line, "TEL;CELL;VOICE",        Buff,  (version >= 3), &location)) {
                                if (Buff[1] == '+') {
                                        GSM_TweakInternationalNumber(Buff, NUMBER_INTERNATIONAL_NUMBERING_PLAN_ISDN);
                                }
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Number_Mobile;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->Entries[Pbk->EntriesNum].SMSList[0] = 0;
                                Pbk->Entries[Pbk->EntriesNum].VoiceTag = 0;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "TEL;OTHER",           Buff,  (version >= 3), &location) ||
                            ReadVCALText(Line, "TEL;OTHER;VOICE",       Buff,  (version >= 3), &location)) {
                                if (Buff[1] == '+') {
                                        GSM_TweakInternationalNumber(Buff, NUMBER_INTERNATIONAL_NUMBERING_PLAN_ISDN);
                                }
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Number_Other;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->Entries[Pbk->EntriesNum].SMSList[0] = 0;
                                Pbk->Entries[Pbk->EntriesNum].VoiceTag = 0;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "TEL;PAGER",           Buff,  (version >= 3), &location) ||
                            ReadVCALText(Line, "TEL;PAGER;VOICE",       Buff,  (version >= 3), &location)) {
                                if (Buff[1] == '+') {
                                        GSM_TweakInternationalNumber(Buff, NUMBER_INTERNATIONAL_NUMBERING_PLAN_ISDN);
                                }
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Number_Other;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->Entries[Pbk->EntriesNum].SMSList[0] = 0;
                                Pbk->Entries[Pbk->EntriesNum].VoiceTag = 0;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "TEL;MSG",             Buff,  (version >= 3), &location) ||
                            ReadVCALText(Line, "TEL;MSG;VOICE", Buff,  (version >= 3), &location)) {
                                if (Buff[1] == '+') {
                                        GSM_TweakInternationalNumber(Buff, NUMBER_INTERNATIONAL_NUMBERING_PLAN_ISDN);
                                }
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Number_Other;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->Entries[Pbk->EntriesNum].SMSList[0] = 0;
                                Pbk->Entries[Pbk->EntriesNum].VoiceTag = 0;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        /* FAX + VOICE looks like nonsense */
                        if (ReadVCALText(Line, "TEL;FAX",              Buff,  (version >= 3), &location) ||
                            ReadVCALText(Line, "TEL;FAX;VOICE",  Buff,  (version >= 3), &location)) {
                                if (Buff[1] == '+') {
                                        GSM_TweakInternationalNumber(Buff, NUMBER_INTERNATIONAL_NUMBERING_PLAN_ISDN);
                                }
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Number_Fax;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->Entries[Pbk->EntriesNum].SMSList[0] = 0;
                                Pbk->Entries[Pbk->EntriesNum].VoiceTag = 0;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "TITLE", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_JobTitle;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "NOTE", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_Note;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "LABEL", Buff,  (version >= 3), &location) ||
                            ReadVCALText(Line, "ADR", Buff,  (version >= 3), &location)) {
                                pos = 0;
                                s = VCALGetTextPart(Buff, &pos); /* PO box, ignore for now */
                                if (s == NULL) {
                                        CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                        Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_Postal;
                                        Pbk->Entries[Pbk->EntriesNum].Location = location;
                                        Pbk->EntriesNum++;
                                        continue;
                                } else {
                                        s = VCALGetTextPart(Buff, &pos); /* Don't know ... */

                                        s = VCALGetTextPart(Buff, &pos);
                                        if (s == NULL) continue;
                                        CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text, s);
                                        Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_StreetAddress;
                                        Pbk->Entries[Pbk->EntriesNum].Location = location;
                                        Pbk->EntriesNum++;
                                        CHECK_NUM_ENTRIES;

                                        s = VCALGetTextPart(Buff, &pos);
                                        if (s == NULL) continue;
                                        CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text, s);
                                        Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_City;
                                        Pbk->Entries[Pbk->EntriesNum].Location = location;
                                        Pbk->EntriesNum++;
                                        CHECK_NUM_ENTRIES;

                                        s = VCALGetTextPart(Buff, &pos);
                                        if (s == NULL) continue;
                                        CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text, s);
                                        Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_State;
                                        Pbk->Entries[Pbk->EntriesNum].Location = location;
                                        Pbk->EntriesNum++;
                                        CHECK_NUM_ENTRIES;

                                        s = VCALGetTextPart(Buff, &pos);
                                        if (s == NULL) continue;
                                        CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text, s);
                                        Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_Zip;
                                        Pbk->Entries[Pbk->EntriesNum].Location = location;
                                        Pbk->EntriesNum++;
                                        CHECK_NUM_ENTRIES;

                                        s = VCALGetTextPart(Buff, &pos);
                                        if (s == NULL) continue;
                                        CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text, s);
                                        Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_Country;
                                        Pbk->Entries[Pbk->EntriesNum].Location = location;
                                        Pbk->EntriesNum++;
                                        continue;
                                }
                        }
                        if (ReadVCALText(Line, "EMAIL", Buff,  (version >= 3), &location) ||
                            ReadVCALText(Line, "EMAIL;OTHER", Buff,  (version >= 3), &location) ||
                            ReadVCALText(Line, "EMAIL;INTERNET", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_Email;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "X-IRMC-LUID", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_LUID;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "X-DTMF", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_DTMF;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "X-SIP", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_SIP;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "X-SIP;VOIP", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_VOIP;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "X-WV-ID", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_WVID;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "X-SIP;SWIS", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_SWIS;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "X-SIP;POC", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_PushToTalkID;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "URL", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_URL;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "ORG", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_Company;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "NICKNAME", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_NickName;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "FN", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_FormalName;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "X-NAME-PREFIX", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_NamePrefix;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "X-NAME-SUFFIX", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Text_NameSuffix;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "CATEGORIES", Buff,  (version >= 3), &location)) {
                                CopyUnicodeString(Pbk->Entries[Pbk->EntriesNum].Text,Buff);
                                Pbk->Entries[Pbk->EntriesNum].Number = -1;
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Category;
                                Pbk->Entries[Pbk->EntriesNum].Location = location;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "BDAY", Buff,  (version >= 3), NULL)) {
                                if (ReadVCALDateTime(DecodeUnicodeString(Buff), &Pbk->Entries[Pbk->EntriesNum].Date)) {
                                        Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Date;
                                        Pbk->Entries[Pbk->EntriesNum].Location = PBK_Location_Unknown;
                                        Pbk->EntriesNum++;
                                        continue;
                                }
                        }
                        if (ReadVCALText(Line, "LAST-MODIFIED", Buff,  (version >= 3), NULL)) {
                                if (ReadVCALDateTime(DecodeUnicodeString(Buff), &Pbk->Entries[Pbk->EntriesNum].Date)) {
                                        Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_LastModified;
                                        Pbk->Entries[Pbk->EntriesNum].Location = PBK_Location_Unknown;
                                        Pbk->EntriesNum++;
                                        continue;
                                }
                        }
                        if (ReadVCALText(Line, "X-PRIVATE", Buff,  (version >= 3), NULL)) {
                                Pbk->Entries[Pbk->EntriesNum].Number = atoi(DecodeUnicodeString(Buff));
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Private;
                                Pbk->Entries[Pbk->EntriesNum].Location = PBK_Location_Unknown;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "X-CALLER-GROUP", Buff,  (version >= 3), NULL)) {
                                Pbk->Entries[Pbk->EntriesNum].Number = atoi(DecodeUnicodeString(Buff));
                                Pbk->Entries[Pbk->EntriesNum].EntryType = PBK_Caller_Group;
                                Pbk->Entries[Pbk->EntriesNum].Location = PBK_Location_Unknown;
                                Pbk->EntriesNum++;
                                continue;
                        }
                        if (ReadVCALText(Line, "X-GAMMU-LOCATION", Buff,  (version >= 3), NULL)) {
                                Pbk->Location = atoi(DecodeUnicodeString(Buff));
                        }
                        if (ReadVCALText(Line, "X-GAMMU-MEMORY", Buff,  (version >= 3), NULL)) {
                                Pbk->MemoryType = GSM_StringToMemoryType(DecodeUnicodeString(Buff));
                        }
                        break;
                }
        }

vcard_complete:
        if (Pbk->EntriesNum == 0) error = ERR_EMPTY;
        else error = ERR_NONE;

vcard_done:
        free(Line);
        Line=NULL;
        return error;
}

GSM_DeleteAllMemory()

GSM_Error GSM_DeleteAllMemory	(	GSM_StateMachine *	s,
		GSM_MemoryType	MemoryType
	)

Deletes all memory (phonebooks or calls) entries of specified type.

Parameters

s	State machine pointer.
MemoryType	Where to delete all entries.

Returns

Error code.

Deletes all memory (phonebooks or calls) entries of specified type.

Definition at line 589 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone_Functions::DeleteAllMemory, GSM_Phone::Functions, _GSM_StateMachine::Phone, and PRINT_LOG_ERROR.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->DeleteAllMemory(s, MemoryType);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_DeleteMemory()

GSM_Error GSM_DeleteMemory	(	GSM_StateMachine *	s,
		GSM_MemoryEntry *	entry
	)

Deletes memory (phonebooks or calls) entry.

Parameters

s	State machine pointer.
entry	Entry to delete, Location and MemoryType has to be set.

Returns

Error code.

Deletes memory (phonebooks or calls) entry.

Definition at line 575 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone_Functions::DeleteMemory, GSM_Phone::Functions, _GSM_StateMachine::Phone, PRINT_LOG_ERROR, PRINT_MEMORY_INFO, and RUN_RESTARTABLE.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();
        PRINT_MEMORY_INFO();

        RUN_RESTARTABLE(err, s->Phone.Functions->DeleteMemory(s, entry));
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_EncodeVCARD()

GSM_Error GSM_EncodeVCARD	(	GSM_Debug_Info *	di,
		char *	Buffer,
		const size_t	buff_len,
		size_t *	Pos,
		GSM_MemoryEntry *	pbk,
		const gboolean	header,
		const GSM_VCardVersion	Version
	)

Encodes memory entry to vCard.

Parameters

	di	Pointer to debugging description.
[out]	Buffer	Buffer to store vCard text.
[in]	buff_len	Size of output buffer.
[in,out]	Pos	Position in output buffer.
[in,out]	pbk	Phonebook data, AddError will be set on non converted entries.
[in]	header	Whether to include vCard header in output.
[in]	Version	What vCard version to create.

Returns

Error code.

Definition at line 126 of file gsmpbk.c.

References GSM_SubMemoryEntry::AddError, GSM_BinaryPicture::Buffer, CopyUnicodeString(), GSM_SubMemoryEntry::Date, DecodeUnicodeString(), GSM_MemoryEntry::Entries, GSM_MemoryEntry::EntriesNum, GSM_SubMemoryEntry::EntryType, ERR_NONE, ERR_NOTSUPPORTED, FALSE, GSM_MemoryTypeToString, GSM_PhonebookFindDefaultNameNumberGroup(), GSM_BinaryPicture::Length, GSM_SubMemoryEntry::Location, GSM_MemoryEntry::Location, GSM_MemoryEntry::MemoryType, Nokia_VCard10, Nokia_VCard21, GSM_SubMemoryEntry::Number, PBK_Caller_Group, PBK_CallLength, PBK_Category, PBK_Date, PBK_LastModified, PBK_Location_Home, PBK_Location_Unknown, PBK_Location_Work, PBK_Number_Fax, PBK_Number_General, PBK_Number_Messaging, PBK_Number_Mobile, PBK_Number_Other, PBK_Number_Pager, PBK_Number_Video, PBK_Photo, PBK_PictureID, PBK_Private, PBK_PushToTalkID, PBK_RingtoneID, PBK_Text_City, PBK_Text_Company, PBK_Text_Country, PBK_Text_Custom1, PBK_Text_Custom2, PBK_Text_Custom3, PBK_Text_Custom4, PBK_Text_DTMF, PBK_Text_Email, PBK_Text_Email2, PBK_Text_FirstName, PBK_Text_FormalName, PBK_Text_JobTitle, PBK_Text_LastName, PBK_Text_LUID, PBK_Text_Name, PBK_Text_NamePrefix, PBK_Text_NameSuffix, PBK_Text_NickName, PBK_Text_Note, PBK_Text_PictureName, PBK_Text_Postal, PBK_Text_SecondName, PBK_Text_SIP, PBK_Text_State, PBK_Text_StreetAddress, PBK_Text_SWIS, PBK_Text_URL, PBK_Text_UserID, PBK_Text_VOIP, PBK_Text_WVID, PBK_Text_Zip, GSM_SubMemoryEntry::Picture, PICTURE_BMP, PICTURE_GIF, PICTURE_ICN, PICTURE_JPG, PICTURE_PNG, smfprintf(), SonyEricsson_VCard10, SonyEricsson_VCard21, SonyEricsson_VCard21_Phone, GSM_SubMemoryEntry::Text, TRUE, GSM_BinaryPicture::Type, UnicodeLength(), VC_Store(), VC_StoreBase64(), VC_StoreDate(), VC_StoreDateTime(), VC_StoreLine(), and VC_StoreText().

Referenced by GSM_EncodeMultiPartSMS().

{
        int Name, Number, Group, i;
        int firstname = -1, secondname = -1, lastname = -1;
        int address = -1, city = -1, state = -1, zip = -1, country = -1;
        int workaddress = -1, workcity = -1, workstate = -1, workzip = -1, workcountry = -1;
        unsigned char buffer[1024];
        int pos;
        gboolean ignore;
        GSM_Error error;
        GSM_BinaryPicture *bitmap;

        GSM_PhonebookFindDefaultNameNumberGroup(pbk, &Name, &Number, &Group);

        if (header) {
                error = VC_StoreLine(Buffer, buff_len, Length, "BEGIN:VCARD");
                if (error != ERR_NONE) return error;
        }
        if (Version == Nokia_VCard10 || Version == SonyEricsson_VCard10) {
                if (Name != -1) {
                        error = VC_StoreLine(Buffer, buff_len, Length, "N:%s",
                                DecodeUnicodeString(pbk->Entries[Name].Text));
                        if (error != ERR_NONE) return error;
                }
                if (Number != -1) {
                        error = VC_StoreLine(Buffer, buff_len, Length, "TEL:%s",
                                DecodeUnicodeString(pbk->Entries[Number].Text));
                        if (error != ERR_NONE) return error;
                }
        } else if (Version == Nokia_VCard21 || Version == SonyEricsson_VCard21_Phone || Version == SonyEricsson_VCard21) {
                if (header) {
                        error = VC_StoreLine(Buffer, buff_len, Length, "VERSION:2.1");
                        if (error != ERR_NONE) return error;
                }

                if (Version != SonyEricsson_VCard21_Phone) {
                        error = VC_StoreLine(Buffer, buff_len, Length, "X-GAMMU-LOCATION:%d", pbk->Location);
                        if (error != ERR_NONE) return error;

                        error = VC_StoreLine(Buffer, buff_len, Length, "X-GAMMU-MEMORY:%s", GSM_MemoryTypeToString(pbk->MemoryType));
                        if (error != ERR_NONE) return error;
                }

                for (i=0; i < pbk->EntriesNum; i++) {
                        ignore = FALSE;
                        pbk->Entries[i].AddError = ERR_NONE;
                        switch(pbk->Entries[i].EntryType) {
                                case PBK_Text_Name:
                                        error = VC_Store(Buffer, buff_len, Length, "N");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_NickName:
                                        error = VC_Store(Buffer, buff_len, Length, "NICKNAME");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_FormalName:
                                        error = VC_Store(Buffer, buff_len, Length, "FN");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_NamePrefix:
                                        error = VC_Store(Buffer, buff_len, Length, "X-NAME-PREFIX");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_NameSuffix:
                                        error = VC_Store(Buffer, buff_len, Length, "X-NAME-SUFFIX");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_FirstName:
                                        firstname = i;
                                        ignore = TRUE;
                                        break;
                                case PBK_Text_SecondName:
                                        secondname = i;
                                        ignore = TRUE;
                                        break;
                                case PBK_Text_LastName:
                                        lastname = i;
                                        ignore = TRUE;
                                        break;
                                case PBK_Text_StreetAddress:
                                        if (pbk->Entries[i].Location == PBK_Location_Work) {
                                                workaddress = i;
                                        } else {
                                                address = i;
                                        }
                                        ignore = TRUE;
                                        break;
                                case PBK_Text_City:
                                        if (pbk->Entries[i].Location == PBK_Location_Work) {
                                                workcity = i;
                                        } else {
                                                city = i;
                                        }
                                        ignore = TRUE;
                                        break;
                                case PBK_Text_State:
                                        if (pbk->Entries[i].Location == PBK_Location_Work) {
                                                workstate = i;
                                        } else {
                                                state = i;
                                        }
                                        ignore = TRUE;
                                        break;
                                case PBK_Text_Zip:
                                        if (pbk->Entries[i].Location == PBK_Location_Work) {
                                                workzip = i;
                                        } else {
                                                zip = i;
                                        }
                                        ignore = TRUE;
                                        break;
                                case PBK_Text_Country:
                                        if (pbk->Entries[i].Location == PBK_Location_Work) {
                                                workcountry = i;
                                        } else {
                                                country = i;
                                        }
                                        ignore = TRUE;
                                        break;
                                case PBK_Date:
                                        error = VC_StoreDate(Buffer, buff_len, Length, &(pbk->Entries[i].Date), "BDAY");
                                        if (error != ERR_NONE) return error;
                                        ignore = TRUE;
                                        break;
                                case PBK_LastModified:
                                        error = VC_StoreDateTime(Buffer, buff_len, Length, &(pbk->Entries[i].Date), "LAST-MODIFIED");
                                        if (error != ERR_NONE) return error;
                                        ignore = TRUE;
                                        break;
                                case PBK_Number_General:
                                case PBK_Number_Video:
                                case PBK_Number_Other:
                                case PBK_Number_Pager:
                                case PBK_Number_Mobile  :
                                case PBK_Number_Fax     :
                                case PBK_Number_Messaging    :
                                        if (UnicodeLength(pbk->Entries[i].Text) == 0) {
                                                ignore = TRUE;
                                                break;
                                        }
                                        error = VC_Store(Buffer, buff_len, Length, "TEL");
                                        if (error != ERR_NONE) return error;

                                        if (Version != SonyEricsson_VCard21 && Number == i) {
                                                error = VC_Store(Buffer, buff_len, Length, ";PREF");
                                                if (error != ERR_NONE) return error;
                                        }
                                        switch (pbk->Entries[i].Location) {
                                                case PBK_Location_Home:
                                                        error = VC_Store(Buffer, buff_len, Length, ";HOME");
                                                        if (error != ERR_NONE) return error;
                                                        break;
                                                case PBK_Location_Work:
                                                        error = VC_Store(Buffer, buff_len, Length, ";WORK");
                                                        if (error != ERR_NONE) return error;
                                                        break;
                                                case PBK_Location_Unknown:
                                                        break;
                                        }
                                        switch (pbk->Entries[i].EntryType) {
                                                case PBK_Number_Other:
                                                        error = VC_Store(Buffer, buff_len, Length, ";OTHER");
                                                        if (error != ERR_NONE) return error;
                                                        break;
                                                case PBK_Number_Pager:
                                                        error = VC_Store(Buffer, buff_len, Length, ";PAGER");
                                                        if (error != ERR_NONE) return error;
                                                        break;
                                                case PBK_Number_Mobile:
                                                        error = VC_Store(Buffer, buff_len, Length, ";CELL");
                                                        if (error != ERR_NONE) return error;
                                                        break;
                                                case PBK_Number_Fax:
                                                        error = VC_Store(Buffer, buff_len, Length, ";FAX");
                                                        if (error != ERR_NONE) return error;
                                                        break;
                                                case PBK_Number_Messaging:
                                                        error = VC_Store(Buffer, buff_len, Length, ";MSG");
                                                        if (error != ERR_NONE) return error;
                                                        break;
                                                case PBK_Number_Video:
                                                        error = VC_Store(Buffer, buff_len, Length, ";VIDEO");
                                                        if (error != ERR_NONE) return error;
                                                        break;
                                                default:
                                                        break;
                                        }
                                        break;
                                case PBK_Text_Note      :
                                        if (UnicodeLength(pbk->Entries[i].Text) == 0) {
                                                ignore = TRUE;
                                                break;
                                        }
                                        error = VC_Store(Buffer, buff_len, Length, "NOTE");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_Postal    :
                                        if (UnicodeLength(pbk->Entries[i].Text) == 0) {
                                                ignore = TRUE;
                                                break;
                                        }
                                        /* Don't ask why. Nokia phones save postal address
                                         * double - once like LABEL, second like ADR
                                         */
                                        error = VC_StoreText(Buffer, buff_len, Length, pbk->Entries[i].Text, "LABEL", FALSE);
                                        if (error != ERR_NONE) return error;
                                        if (pbk->Entries[i].Location == PBK_Location_Work) {
                                                error = VC_Store(Buffer, buff_len, Length, "ADR;WORK");
                                        } else if (pbk->Entries[i].Location == PBK_Location_Home) {
                                                error = VC_Store(Buffer, buff_len, Length, "ADR;HOME");
                                        } else {
                                                error = VC_Store(Buffer, buff_len, Length, "ADR");
                                        }
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_Email     :
                                case PBK_Text_Email2    :
                                        if (UnicodeLength(pbk->Entries[i].Text) == 0) {
                                                ignore = TRUE;
                                                break;
                                        }
                                        error = VC_Store(Buffer, buff_len, Length, "EMAIL");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_URL       :
                                        if (UnicodeLength(pbk->Entries[i].Text) == 0) {
                                                ignore = TRUE;
                                                break;
                                        }
                                        error = VC_Store(Buffer, buff_len, Length, "URL");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_LUID      :
                                        if (UnicodeLength(pbk->Entries[i].Text) == 0) {
                                                ignore = TRUE;
                                                break;
                                        }
                                        error = VC_Store(Buffer, buff_len, Length, "X-IRMC-LUID");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_VOIP      :
                                        if (UnicodeLength(pbk->Entries[i].Text) == 0) {
                                                ignore = TRUE;
                                                break;
                                        }
                                        error = VC_Store(Buffer, buff_len, Length, "X-SIP;VOIP");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_SWIS      :
                                        if (UnicodeLength(pbk->Entries[i].Text) == 0) {
                                                ignore = TRUE;
                                                break;
                                        }
                                        error = VC_Store(Buffer, buff_len, Length, "X-SIP;SWIS");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_WVID      :
                                        if (UnicodeLength(pbk->Entries[i].Text) == 0) {
                                                ignore = TRUE;
                                                break;
                                        }
                                        error = VC_Store(Buffer, buff_len, Length, "X-WV-ID");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_SIP      :
                                        if (UnicodeLength(pbk->Entries[i].Text) == 0) {
                                                ignore = TRUE;
                                                break;
                                        }
                                        error = VC_Store(Buffer, buff_len, Length, "X-SIP");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_DTMF      :
                                        if (UnicodeLength(pbk->Entries[i].Text) == 0) {
                                                ignore = TRUE;
                                                break;
                                        }
                                        error = VC_Store(Buffer, buff_len, Length, "X-DTMF");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_PushToTalkID:
                                        if (UnicodeLength(pbk->Entries[i].Text) == 0) {
                                                ignore = TRUE;
                                                break;
                                        }
                                        error = VC_Store(Buffer, buff_len, Length, "X-SIP;POC");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_JobTitle:
                                        if (UnicodeLength(pbk->Entries[i].Text) == 0) {
                                                ignore = TRUE;
                                                break;
                                        }
                                        error = VC_Store(Buffer, buff_len, Length, "TITLE");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Text_Company:
                                        if (UnicodeLength(pbk->Entries[i].Text) == 0) {
                                                ignore = TRUE;
                                                break;
                                        }
                                        error = VC_Store(Buffer, buff_len, Length, "ORG");
                                        if (error != ERR_NONE) return error;
                                        break;
                                case PBK_Photo:
                                        bitmap = &(pbk->Entries[i].Picture);
                                        error = VC_Store(Buffer, buff_len, Length, "PHOTO;TYPE=");
                                        if (error != ERR_NONE) return error;
                                        switch (bitmap->Type) {
                                                case PICTURE_BMP:
                                                        error = VC_Store(Buffer, buff_len, Length, "BMP;");
                                                        break;
                                                case PICTURE_GIF:
                                                        error = VC_Store(Buffer, buff_len, Length, "GIF;");
                                                        break;
                                                case PICTURE_JPG:
                                                        error = VC_Store(Buffer, buff_len, Length, "JPEG;");
                                                        break;
                                                case PICTURE_ICN:
                                                        error = VC_Store(Buffer, buff_len, Length, "ICO;");
                                                        break;
                                                case PICTURE_PNG:
                                                        error = VC_Store(Buffer, buff_len, Length, "PNG;");
                                                        break;
                                                default:
                                                        smfprintf(di, "Unknown picture format: %d\n", bitmap->Type);
                                                        error = VC_Store(Buffer, buff_len, Length, "UNKNOWN;");
                                                        break;
                                        }
                                        if (error != ERR_NONE) return error;
                                        error = VC_Store(Buffer, buff_len, Length, "ENCODING=BASE64:");
                                        if (error != ERR_NONE) return error;
                                        error = VC_StoreBase64(Buffer, buff_len, Length, bitmap->Buffer, bitmap->Length);
                                        if (error != ERR_NONE) return error;
                                        ignore = TRUE;
                                        break;
                                case PBK_Caller_Group:
                                        error = VC_StoreLine(Buffer, buff_len, Length, "X-CALLER-GROUP:%d", pbk->Entries[i].Number);
                                        if (error != ERR_NONE) return error;
                                        ignore = TRUE;
                                        break;
                                case PBK_Private:
                                        error = VC_StoreLine(Buffer, buff_len, Length, "X-PRIVATE:%d", pbk->Entries[i].Number);
                                        if (error != ERR_NONE) return error;
                                        ignore = TRUE;
                                        break;
                                /* Not supported fields */
                                case PBK_Category:
                                case PBK_RingtoneID:
                                case PBK_PictureID:
                                case PBK_Text_UserID:
                                case PBK_CallLength:
                                case PBK_Text_Custom1:
                                case PBK_Text_Custom2:
                                case PBK_Text_Custom3:
                                case PBK_Text_Custom4:
                                case PBK_Text_PictureName:
                                        pbk->Entries[i].AddError = ERR_NOTSUPPORTED;
                                        ignore = TRUE;
                                        break;
                        }
                        if (!ignore) {
                                error = VC_StoreText(Buffer, buff_len, Length, pbk->Entries[i].Text, "", FALSE);
                                if (error != ERR_NONE) return error;
                        }
                }
                /* Save name if it is composed from parts */
                if (firstname != -1 || secondname != -1 || lastname != -1) {
                        pos = 0;
                        if (lastname != -1) {
                                CopyUnicodeString(buffer + 2*pos, pbk->Entries[lastname].Text);
                                pos += UnicodeLength(pbk->Entries[lastname].Text);
                        }
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = ';';
                        pos++;
                        if (firstname != -1) {
                                CopyUnicodeString(buffer + 2*pos, pbk->Entries[firstname].Text);
                                pos += UnicodeLength(pbk->Entries[firstname].Text);
                        }
                        if (secondname != -1) {
                                buffer[2*pos] = 0;
                                buffer[2*pos + 1] = ' ';
                                pos++;
                                CopyUnicodeString(buffer + 2*pos, pbk->Entries[secondname].Text);
                                pos += UnicodeLength(pbk->Entries[secondname].Text);
                        }
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = 0;
                        error = VC_StoreText(Buffer, buff_len, Length, buffer, "N", FALSE);
                        if (error != ERR_NONE) return error;
                }
                /* Save workaddress if it is composed from parts */
                if (workaddress != -1 || workcity != -1 || workstate != -1 || workzip != -1 || workcountry != -1) {
                        pos = 0;
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = ';';
                        pos++;
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = ';';
                        pos++;
                        if (workaddress != -1) {
                                CopyUnicodeString(buffer + 2*pos, pbk->Entries[workaddress].Text);
                                pos += UnicodeLength(pbk->Entries[workaddress].Text);
                        }
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = ';';
                        pos++;
                        if (workcity != -1) {
                                CopyUnicodeString(buffer + 2*pos, pbk->Entries[workcity].Text);
                                pos += UnicodeLength(pbk->Entries[workcity].Text);
                        }
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = ';';
                        pos++;
                        if (workstate != -1) {
                                CopyUnicodeString(buffer + 2*pos, pbk->Entries[workstate].Text);
                                pos += UnicodeLength(pbk->Entries[workstate].Text);
                        }
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = ';';
                        pos++;
                        if (workzip != -1) {
                                CopyUnicodeString(buffer + 2*pos, pbk->Entries[workzip].Text);
                                pos += UnicodeLength(pbk->Entries[workzip].Text);
                        }
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = ';';
                        pos++;
                        if (workcountry != -1) {
                                CopyUnicodeString(buffer + 2*pos, pbk->Entries[workcountry].Text);
                                pos += UnicodeLength(pbk->Entries[workcountry].Text);
                        }
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = 0;
                        error = VC_StoreText(Buffer, buff_len, Length, buffer, "ADR;WORK", FALSE);
                        if (error != ERR_NONE) return error;
                }
                /* Save address if it is composed from parts */
                if (address != -1 || city != -1 || state != -1 || zip != -1 || country != -1) {
                        pos = 0;
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = ';';
                        pos++;
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = ';';
                        pos++;
                        if (address != -1) {
                                CopyUnicodeString(buffer + 2*pos, pbk->Entries[address].Text);
                                pos += UnicodeLength(pbk->Entries[address].Text);
                        }
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = ';';
                        pos++;
                        if (city != -1) {
                                CopyUnicodeString(buffer + 2*pos, pbk->Entries[city].Text);
                                pos += UnicodeLength(pbk->Entries[city].Text);
                        }
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = ';';
                        pos++;
                        if (state != -1) {
                                CopyUnicodeString(buffer + 2*pos, pbk->Entries[state].Text);
                                pos += UnicodeLength(pbk->Entries[state].Text);
                        }
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = ';';
                        pos++;
                        if (zip != -1) {
                                CopyUnicodeString(buffer + 2*pos, pbk->Entries[zip].Text);
                                pos += UnicodeLength(pbk->Entries[zip].Text);
                        }
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = ';';
                        pos++;
                        if (country != -1) {
                                CopyUnicodeString(buffer + 2*pos, pbk->Entries[country].Text);
                                pos += UnicodeLength(pbk->Entries[country].Text);
                        }
                        buffer[2*pos] = 0;
                        buffer[2*pos + 1] = 0;
                        error = VC_StoreText(Buffer, buff_len, Length, buffer, "ADR;HOME", FALSE);
                        if (error != ERR_NONE) return error;
                }
        } else {
                return ERR_NOTSUPPORTED;
        }
        if (header) {
                error = VC_StoreLine(Buffer, buff_len, Length, "END:VCARD");
                if (error != ERR_NONE) return error;
        }
        return ERR_NONE;
}

GSM_GetMemory()

GSM_Error GSM_GetMemory	(	GSM_StateMachine *	s,
		GSM_MemoryEntry *	entry
	)

Reads entry from memory (phonebooks or calls). Which entry should be read is defined in entry.

Parameters

s	State machine pointer.
entry	Storage for retrieved entry, MemoryType and Location has to be set.

Returns

Error code.

Reads entry from memory (phonebooks or calls). Which entry should be read is defined in entry.

Definition at line 517 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone::Functions, GSM_Phone_Functions::GetMemory, _GSM_StateMachine::Phone, PRINT_LOG_ERROR, and PRINT_MEMORY_INFO.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();
        PRINT_MEMORY_INFO();

        err = s->Phone.Functions->GetMemory(s, entry);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_GetMemoryStatus()

GSM_Error GSM_GetMemoryStatus	(	GSM_StateMachine *	s,
		GSM_MemoryStatus *	status
	)

Gets memory (phonebooks or calls) status (eg. number of used and free entries).

Parameters

s	State machine pointer.
status	Storage for status information, MemoryType has to be set.

Returns

Error code.

Gets memory (phonebooks or calls) status (eg. number of used and free entries).

Definition at line 503 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone::Functions, GSM_Phone_Functions::GetMemoryStatus, _GSM_StateMachine::Phone, and PRINT_LOG_ERROR.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->GetMemoryStatus(s, status);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_GetNextMemory()

GSM_Error GSM_GetNextMemory	(	GSM_StateMachine *	s,
		GSM_MemoryEntry *	entry,
		gboolean	start
	)

Reads entry from memory (phonebooks or calls). Which entry should be read is defined in entry. This can be easily used for reading all entries.

Parameters

s	State machine pointer.
entry	Storage for retrieved entry. MemoryType has to be set for first call (with start set to TRUE), for subsequent calls Location has to stay intact from previous reading.
start	Whether we should start from beginning.

Returns

Error code.

Reads entry from memory (phonebooks or calls). Which entry should be read is defined in entry. This can be easily used for reading all entries.

Definition at line 532 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone::Functions, GSM_Phone_Functions::GetNextMemory, _GSM_StateMachine::Phone, PRINT_LOG_ERROR, PRINT_MEMORY_INFO, and PRINT_START.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();
        PRINT_START();
        PRINT_MEMORY_INFO();

        err = s->Phone.Functions->GetNextMemory(s, entry, start);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_GetSpeedDial()

GSM_Error GSM_GetSpeedDial	(	GSM_StateMachine *	s,
		GSM_SpeedDial *	Speed
	)

Gets speed dial.

Parameters

s	State machine pointer.
Speed	Storage for speed dial, Location has to be set.

Returns

Error code.

Gets speed dial.

Definition at line 602 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone::Functions, GSM_Phone_Functions::GetSpeedDial, _GSM_StateMachine::Phone, and PRINT_LOG_ERROR.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->GetSpeedDial(s, Speed);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_PhonebookFindDefaultNameNumberGroup()

void GSM_PhonebookFindDefaultNameNumberGroup	(	const GSM_MemoryEntry *	entry,
		int *	Name,
		int *	Number,
		int *	Group
	)

Finds default name, number and group for entry.

Parameters

entry	Entry to process.
Name	Output index of name.
Number	Output index of number.
Group	Output index of group.

Definition at line 78 of file gsmpbk.c.

References GSM_MemoryEntry::Entries, GSM_MemoryEntry::EntriesNum, GSM_SubMemoryEntry::EntryType, PBK_Caller_Group, PBK_Number_Fax, PBK_Number_General, PBK_Number_Mobile, PBK_Number_Other, PBK_Number_Pager, PBK_Text_FirstName, PBK_Text_LastName, and PBK_Text_Name.

Referenced by GSM_EncodeVCARD().

{
        int i;

        *Name   = -1;
        *Number = -1;
        *Group  = -1;
        for (i = 0; i < entry->EntriesNum; i++) {
                switch (entry->Entries[i].EntryType) {
                case PBK_Number_General : if (*Number   == -1) *Number  = i; break;
                case PBK_Text_Name      : if (*Name     == -1) *Name    = i; break;
                case PBK_Caller_Group   : if (*Group    == -1) *Group   = i; break;
                default          :                                  break;
                }
        }
        if ((*Number) == -1) {
                for (i = 0; i < entry->EntriesNum; i++) {
                        switch (entry->Entries[i].EntryType) {
                                case PBK_Number_Mobile:
                                case PBK_Number_General:
                                case PBK_Number_Fax:
                                case PBK_Number_Pager:
                                case PBK_Number_Other:
                                        *Number = i;
                                        break;
                                default:
                                        break;
                        }
                        if (*Number != -1) break;
                }
        }
        if ((*Name) == -1) {
                for (i = 0; i < entry->EntriesNum; i++) {
                        if (entry->Entries[i].EntryType != PBK_Text_LastName) continue;
                        *Name = i;
                        break;
                }
        }
        if ((*Name) == -1) {
                for (i = 0; i < entry->EntriesNum; i++) {
                        if (entry->Entries[i].EntryType != PBK_Text_FirstName) continue;
                        *Name = i;
                        break;
                }
        }
}

GSM_PhonebookGetEntryName()

unsigned char* GSM_PhonebookGetEntryName

(

const GSM_MemoryEntry *

entry

)

Returns name of entry. It might be possibly concatenated from first and last names.

Parameters

entry

Entry to process.

Returns

Static unicode string containing name.

Definition at line 33 of file gsmpbk.c.

References CopyUnicodeString(), GSM_MemoryEntry::Entries, GSM_MemoryEntry::EntriesNum, GSM_SubMemoryEntry::EntryType, GSM_PHONEBOOK_TEXT_LENGTH, PBK_Text_FirstName, PBK_Text_LastName, PBK_Text_Name, GSM_SubMemoryEntry::Text, and UnicodeLength().

{
        /* We possibly store here "LastName, FirstName" so allocate enough memory */
        static char     dest[(GSM_PHONEBOOK_TEXT_LENGTH*2+2+1)*2];
        static char     split[] = { '\0', ',', '\0', ' ', '\0', '\0'};
        int          i;
        int          first = -1, last = -1, name = -1;
        int          len = 0;

        for (i = 0; i < entry->EntriesNum; i++) {
                switch (entry->Entries[i].EntryType) {
                        case PBK_Text_LastName:
                                last = i;
                                break;
                        case PBK_Text_FirstName:
                                first = i;
                                break;
                        case PBK_Text_Name:
                                name = i;
                                break;
                        default:
                                break;
                }
        }

        if (name != -1) {
                CopyUnicodeString(dest, entry->Entries[name].Text);
        } else {
                if (last != -1 && first != -1) {
                        len = UnicodeLength(entry->Entries[last].Text);
                        CopyUnicodeString(dest, entry->Entries[last].Text);
                        CopyUnicodeString(dest + 2*len, split);
                        CopyUnicodeString(dest + 2*len + 4, entry->Entries[first].Text);
                } else if (last != -1) {
                        CopyUnicodeString(dest, entry->Entries[last].Text);
                } else if (first != -1) {
                        CopyUnicodeString(dest, entry->Entries[first].Text);
                } else {
                        return NULL;
                }
        }

        return dest;
}

GSM_SetMemory()

GSM_Error GSM_SetMemory	(	GSM_StateMachine *	s,
		GSM_MemoryEntry *	entry
	)

Sets memory (phonebooks or calls) entry.

Parameters

s	State machine pointer.
entry	Entry to set, Location and MemoryType has to be set.

Returns

Error code.

Sets memory (phonebooks or calls) entry.

Definition at line 547 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone::Functions, _GSM_StateMachine::Phone, PRINT_LOG_ERROR, PRINT_MEMORY_INFO, RUN_RESTARTABLE, and GSM_Phone_Functions::SetMemory.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();
        PRINT_MEMORY_INFO();

        RUN_RESTARTABLE(err, s->Phone.Functions->SetMemory(s, entry));
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_SetSpeedDial()

GSM_Error GSM_SetSpeedDial	(	GSM_StateMachine *	s,
		GSM_SpeedDial *	Speed
	)

Sets speed dial.

Parameters

s	State machine pointer.
Speed	Sspeed dial to set.

Returns

Error code.

Sets speed dial.

Definition at line 615 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone::Functions, _GSM_StateMachine::Phone, PRINT_LOG_ERROR, and GSM_Phone_Functions::SetSpeedDial.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->SetSpeedDial(s, Speed);
        PRINT_LOG_ERROR(err);
        return err;
}