libGammu

The libGammu library exposes all Gammu functionality for various phones in standard API. It can be used to do anything with your phone, however for easier tasks you might prefer to use Python and python-gammu.

If you intend to use libGammu in your application, all you should need is to #include <gammu.h> and then use Gammu functions. You can check docs/examples/ for some small example applications. You don’t need real phone for testing, use Dummy Driver instead.

• Hints for libGammu Novices
  • Basic library usage
  • Compiling the code
  • Unicode
  • Debugging
  • Waiting for incoming events
• Examples
  • Getting phone information
  • Reading SMS message
  • Sending SMS message
  • Sending Long SMS message
  • SMSD example
  • Custom configuration
• libGammu C API
  • Backup
    • GSM_ReadSMSBackupFile()
    • GSM_AddSMSBackupFile()
    • GSM_ClearSMSBackup()
    • GSM_FreeSMSBackup()
    • GSM_SaveBackupFile()
    • GSM_GuessBackupFormat()
    • GSM_ReadBackupFile()
    • GSM_ClearBackup()
    • GSM_FreeBackup()
    • GSM_GetBackupFormatFeatures()
    • GSM_GetBackupFileFeatures()
    • GSM_SMS_Backup
    • GSM_Backup
    • GSM_BackupFormat
    • GSM_Backup_Info
    • GSM_BACKUP_MAX_SMS
  • Bitmap
    • GSM_GetBitmap()
    • GSM_SetBitmap()
    • GSM_PrintBitmap()
    • GSM_SaveBitmapFile()
    • GSM_ReadBitmapFile()
    • GSM_IsPointBitmap()
    • GSM_SetPointBitmap()
    • GSM_ClearPointBitmap()
    • GSM_ClearBitmap()
    • GSM_BinaryPicture_Types
    • GSM_BinaryPicture
    • GSM_Bitmap_Types
    • GSM_Bitmap
    • GSM_MultiBitmap
    • GSM_GetScreenshot()
  • Calendar
    • GSM_CalendarFindDefaultTextTimeAlarmPhone()
    • GSM_EncodeVTODO()
    • GSM_EncodeVCALENDAR()
    • GSM_DecodeVNOTE()
    • GSM_EncodeVNTFile()
    • GSM_DecodeVCALENDAR_VTODO()
    • GSM_IsCalendarNoteFromThePast()
    • GSM_GetAlarm()
    • GSM_SetAlarm()
    • GSM_GetToDoStatus()
    • GSM_GetToDo()
    • GSM_GetNextToDo()
    • GSM_SetToDo()
    • GSM_AddToDo()
    • GSM_DeleteToDo()
    • GSM_DeleteAllToDo()
    • GSM_GetCalendarStatus()
    • GSM_GetCalendar()
    • GSM_GetNextCalendar()
    • GSM_SetCalendar()
    • GSM_AddCalendar()
    • GSM_DeleteCalendar()
    • GSM_DeleteAllCalendar()
    • GSM_GetCalendarSettings()
    • GSM_SetCalendarSettings()
    • GSM_GetNotesStatus()
    • GSM_GetNote()
    • GSM_GetNextNote()
    • GSM_SetNote()
    • GSM_AddNote()
    • GSM_DeleteNote()
    • GSM_DeleteAllNotes()
    • GSM_CalendarSettings
    • GSM_ToDoStatus
    • GSM_CalendarStatus
    • GSM_CalendarNoteType
    • GSM_CalendarType
    • GSM_SubCalendarEntry
    • GSM_CalendarEntry
    • GSM_ToDoType
    • GSM_ToDo_Priority
    • GSM_SubToDoEntry
    • GSM_ToDoEntry
    • GSM_NoteEntry
    • GSM_Alarm
    • GSM_VToDoVersion
    • GSM_VCalendarVersion
  • Callback
    • GSM_SetIncomingCallCallback()
    • GSM_SetIncomingSMSCallback()
    • GSM_SetIncomingCBCallback()
    • GSM_SetIncomingUSSDCallback()
    • GSM_SetSendSMSStatusCallback()
    • IncomingCallCallback
    • IncomingSMSCallback
    • IncomingCBCallback
    • IncomingUSSDCallback
    • SendSMSStatusCallback
  • Call
    • GSM_DialVoice()
    • GSM_DialService()
    • GSM_AnswerCall()
    • GSM_CancelCall()
    • GSM_HoldCall()
    • GSM_UnholdCall()
    • GSM_ConferenceCall()
    • GSM_SplitCall()
    • GSM_TransferCall()
    • GSM_SwitchCall()
    • GSM_GetCallDivert()
    • GSM_SetCallDivert()
    • GSM_CancelAllDiverts()
    • GSM_SetIncomingCall()
    • GSM_SendDTMF()
    • GSM_CallStatus
    • GSM_Call
    • GSM_Divert_DivertTypes
    • GSM_Divert_CallTypes
    • GSM_CallDivert
    • GSM_MultiCallDivert
    • GSM_CallShowNumber
  • Category
    • GSM_GetCategory()
    • GSM_AddCategory()
    • GSM_GetCategoryStatus()
    • GSM_CategoryType
    • GSM_Category
    • GSM_CategoryStatus
  • Date and time
    • DayOfWeek()
    • GSM_GetCurrentDateTime()
    • Fill_Time_T()
    • GSM_GetLocalTimezoneOffset()
    • Fill_GSM_DateTime()
    • GSM_DateTimeFromTimestamp()
    • OSDateTime()
    • OSDate()
    • CheckDate()
    • CheckTime()
    • GSM_GetDateTime()
    • GSM_SetDateTime()
    • GSM_DateTime
    • GSM_DeltaTime
  • Debug
    • GSM_SetDebugFunction()
    • GSM_SetDebugFile()
    • GSM_SetDebugFileDescriptor()
    • GSM_GetGlobalDebug()
    • GSM_GetDebug()
    • GSM_GetDI()
    • GSM_SetDebugLevel()
    • GSM_SetDebugCoding()
    • GSM_SetDebugGlobal()
    • GSM_LogError()
    • smprintf()
    • GSM_Debug_Info
  • Error handling
    • GSM_ErrorString()
    • GSM_ErrorName()
    • GSM_Error
  • File
    • GSM_JADFindData()
    • GSM_ReadFile()
    • GSM_IdentifyFileFormat()
    • GSM_GetNextFileFolder()
    • GSM_GetFolderListing()
    • GSM_GetNextRootFolder()
    • GSM_SetFileAttributes()
    • GSM_GetFilePart()
    • GSM_AddFilePart()
    • GSM_SendFilePart()
    • GSM_GetFileSystemStatus()
    • GSM_DeleteFile()
    • GSM_AddFolder()
    • GSM_DeleteFolder()
    • GSM_FileSystemStatus
    • GSM_FileType
    • GSM_File
  • Info
    • GSM_GetNetworkName()
    • GSM_GetCountryName()
    • GSM_FeatureToString()
    • GSM_FeatureFromString()
    • GSM_IsPhoneFeatureAvailable()
    • GSM_AddPhoneFeature()
    • GSM_GetManufacturer()
    • GSM_GetModel()
    • GSM_GetModelInfo()
    • GSM_GetFirmware()
    • GSM_GetIMEI()
    • GSM_GetOriginalIMEI()
    • GSM_GetManufactureMonth()
    • GSM_GetProductCode()
    • GSM_GetHardware()
    • GSM_GetPPM()
    • GSM_GetSIMIMSI()
    • GSM_GetBatteryCharge()
    • GSM_GetSignalQuality()
    • GSM_GetNetworkInfo()
    • GSM_GetDisplayStatus()
    • GSM_NetworkInfo_State
    • GSM_GPRS_State
    • GSM_NetworkInfo
    • GSM_SignalQuality
    • GSM_ChargeState
    • GSM_BatteryType
    • GSM_BatteryCharge
    • GSM_DisplayFeature
    • GSM_DisplayFeatures
    • GSM_Feature
    • GSM_PhoneModel
  • INI files
    • INI_Free()
    • INI_ReadFile()
    • INI_FindLastSectionEntry()
    • INI_GetValue()
    • INI_GetInt()
    • INI_GetBool()
    • GSM_StringToBool()
    • INI_Entry
    • INI_Section
    • _INI_Entry
    • _INI_Section
  • Keys
    • MakeKeySequence()
    • GSM_PressKey()
    • GSM_KeyCode
  • Limits
  • Memory
    • GSM_StringToMemoryType()
    • GSM_GetMemoryStatus()
    • GSM_GetMemory()
    • GSM_GetNextMemory()
    • GSM_SetMemory()
    • GSM_AddMemory()
    • GSM_DeleteMemory()
    • GSM_DeleteAllMemory()
    • GSM_GetSpeedDial()
    • GSM_SetSpeedDial()
    • GSM_PhonebookGetEntryName()
    • GSM_PhonebookFindDefaultNameNumberGroup()
    • GSM_EncodeVCARD()
    • GSM_DecodeVCARD()
    • GSM_FreeMemoryEntry()
    • GSM_MemoryType
    • GSM_MemoryStatus
    • GSM_EntryType
    • GSM_EntryLocation
    • GSM_SubMemoryEntry
    • GSM_MemoryEntry
    • GSM_SpeedDial
    • GSM_VCardVersion
  • Messages
    • GSM_DecodePDUFrame()
    • GSM_DecodeSMSFrame()
    • GSM_GetMessageCoding()
    • GSM_EncodeSMSFrame()
    • GSM_DecodeSMSFrameStatusReportData()
    • GSM_DecodeSMSFrameText()
    • GSM_DecodeUDHHeader()
    • GSM_EncodeUDHHeader()
    • GSM_SetDefaultReceivedSMSData()
    • GSM_SetDefaultSMSData()
    • GSM_DecodeSiemensOTASMS()
    • PHONE_EncodeSMSFrame()
    • GSM_EncodeMultiPartSMS()
    • GSM_DecodeMultiPartSMS()
    • GSM_ClearMultiPartSMSInfo()
    • GSM_FreeMultiPartSMSInfo()
    • GSM_LinkSMS()
    • GSM_DecodeMMSFileToMultiPart()
    • GSM_ClearMMSMultiPart()
    • GSM_GetSMSC()
    • GSM_SetSMSC()
    • GSM_GetSMSStatus()
    • GSM_GetSMS()
    • GSM_GetNextSMS()
    • GSM_SetSMS()
    • GSM_AddSMS()
    • GSM_DeleteSMS()
    • GSM_SendSMS()
    • GSM_SendSavedSMS()
    • GSM_SetFastSMSSending()
    • GSM_SetIncomingSMS()
    • GSM_SetIncomingCB()
    • GSM_GetSMSFolders()
    • GSM_AddSMSFolder()
    • GSM_DeleteSMSFolder()
    • GSM_GetMMSFolders()
    • GSM_GetNextMMSFileInfo()
    • GSM_SetIncomingUSSD()
    • GSM_SMSCounter()
    • GSM_MMS_Class
    • GSM_MMSIndicator
    • GSM_CBMessage
    • GSM_USSDStatus
    • GSM_USSDMessage
    • GSM_SMSMemoryStatus
    • GSM_SMSFormat
    • GSM_ValidityPeriod
    • GSM_ValidityPeriodFormat
    • GSM_SMSValidity
    • GSM_SMSC
    • GSM_SMS_State
    • GSM_Coding_Type
    • GSM_UDH
    • GSM_UDHHeader
    • GSM_SMSMessageType
    • GSM_SMSMessage
    • GSM_SMSMessageLayout
    • GSM_OneSMSFolder
    • GSM_SMSFolders
    • GSM_SiemensOTASMSInfo
    • GSM_MultiSMSMessage
    • GSM_OneMMSFolder
    • GSM_MMSFolders
    • EncodeMultiPartSMSID
    • GSM_MultiPartSMSEntry
    • GSM_MultiPartSMSInfo
    • MMSAddressType
    • GSM_EncodedMultiPartMMSEntry
    • GSM_EncodedMultiPartMMSInfo
  • Miscellaneous
    • GetLine()
    • GetGammuVersion()
    • GetCompiler()
    • GetOS()
    • GetGammuLocalePath()
    • GSM_InitLocales()
    • EncodeHexBin()
    • GSM_IsNewerVersion()
  • Nokia
    • NOKIA_GetDefaultCallerGroupName()
    • NOKIA_GetDefaultProfileName()
  • Ringtone
    • PHONE_RTTLPlayOneNote()
    • PHONE_Beep()
    • GSM_GetRingtone()
    • GSM_SetRingtone()
    • GSM_GetRingtonesInfo()
    • GSM_DeleteUserRingtones()
    • GSM_PlayTone()
    • GSM_RingtoneConvert()
    • GSM_ReadRingtoneFile()
    • GSM_SaveRingtoneFile()
    • GSM_SaveRingtoneOtt()
    • GSM_SaveRingtoneMidi()
    • GSM_SaveRingtoneIMelody()
    • GSM_SaveRingtoneWav()
    • GSM_SaveRingtoneRttl()
    • GSM_GetRingtoneName()
    • GSM_RTTLGetTempo()
    • GSM_RingNoteStyle
    • GSM_RingNoteNote
    • GSM_RingNoteDuration
    • GSM_RingNoteDurationSpec
    • GSM_RingNoteScale
    • GSM_RingNote
    • GSM_RingCommandType
    • GSM_RingCommand
    • GSM_NoteRingtone
    • GSM_NokiaBinaryRingtone
    • GSM_BinaryTone
    • GSM_RingtoneFormat
    • GSM_Ringtone
    • GSM_RingtoneInfo
    • GSM_AllRingtonesInfo
  • Security
    • GSM_EnterSecurityCode()
    • GSM_GetSecurityStatus()
    • GSM_SecurityCodeType
    • GSM_SecurityCode
  • Settings
    • GSM_GetLocale()
    • GSM_SetLocale()
    • GSM_GetSyncMLSettings()
    • GSM_SetSyncMLSettings()
    • GSM_GetChatSettings()
    • GSM_SetChatSettings()
    • GSM_GetMMSSettings()
    • GSM_SetMMSSettings()
    • GSM_SetAutoNetworkLogin()
    • GSM_Reset()
    • GSM_ResetPhoneSettings()
    • GSM_GetProfile()
    • GSM_SetProfile()
    • GSM_GetFMStation()
    • GSM_SetFMStation()
    • GSM_ClearFMStations()
    • GSM_GetGPRSAccessPoint()
    • GSM_SetGPRSAccessPoint()
    • GSM_SyncMLSettings
    • GSM_ResetSettingsType
    • GSM_ChatSettings
    • GSM_Profile_Feat_Value
    • GSM_Profile_Feat_ID
    • GSM_Profile
    • GSM_FMStation
    • GSM_GPRSAccessPoint
    • GSM_DateFormat
    • GSM_Locale
    • GSM_Profile_PhoneTableValue
  • SMSD
    • SMSD_InjectSMS()
    • SMSD_GetStatus()
    • SMSD_Shutdown()
    • SMSD_ReadConfig()
    • SMSD_MainLoop()
    • SMSD_NewConfig()
    • SMSD_FreeConfig()
    • GSM_SMSDStatus
    • GSM_SMSDConfig
  • State machine
    • GSM_InitConnection_Log()
    • GSM_InitConnection()
    • GSM_TerminateConnection()
    • GSM_AbortOperation()
    • GSM_Install()
    • GSM_StateMachine
    • GSM_ConnectionType
    • GSM_Config
    • GSM_Log_Function
    • GSM_ReadDevice()
    • GSM_IsConnected()
    • GSM_FindGammuRC()
    • GSM_ReadConfig()
    • GSM_GetConfig()
    • GSM_GetConfigNum()
    • GSM_SetConfigNum()
    • GSM_AllocStateMachine()
    • GSM_FreeStateMachine()
    • GSM_GetUsedConnection()
  • Types
    • gboolean
  • Unicode
    • UnicodeLength()
    • DecodeUnicodeString()
    • DecodeUnicodeConsole()
    • DecodeUnicode()
    • EncodeUnicode()
    • ReadUnicodeFile()
    • CopyUnicodeString()
    • EncodeUTF8QuotedPrintable()
    • DecodeUTF8QuotedPrintable()
    • EncodeWithUTF8Alphabet()
    • DecodeHexUnicode()
    • EncodeHexUnicode()
    • mywstrncmp()
    • mywstrstr()
    • mywstrncasecmp()
    • EncodeUTF8()
    • DecodeUTF8()
    • DecodeHexBin()
  • WAP
    • GSM_EncodeURLFile()
    • GSM_GetWAPBookmark()
    • GSM_SetWAPBookmark()
    • GSM_DeleteWAPBookmark()
    • GSM_GetWAPSettings()
    • GSM_SetWAPSettings()
    • GSM_WAPBookmark
    • WAPSettings_Speed
    • WAPSettings_Bearer
    • GSM_WAPSettings
    • GSM_MultiWAPSettings
• Porting from libGammu older than 1.12.0
  • Rationale for API change
  • Changes you have to do in your code