# Error handling

const char *GSM_ErrorString(GSM_Error e)

  Returns text for error.

  Parameters:

    - e – Error code.

  Returns:

    Text (in current locales) describing error

const char *GSM_ErrorName(GSM_Error e)

  Returns name for error.

  Parameters:

    - e – Error code.

  Returns:

    Text with error name

enum GSM_Error

  Error types.

  Values:

  enumerator ERR_NONE

    No error

  enumerator ERR_DEVICEOPENERROR

    Error during opening device

  enumerator ERR_DEVICELOCKED

    Device locked

  enumerator ERR_DEVICENOTEXIST

    Device does not exits

  enumerator ERR_DEVICEBUSY

    Device is busy

  enumerator ERR_DEVICENOPERMISSION

    No permissions to open device

  enumerator ERR_DEVICENODRIVER

    No driver installed for a device

  enumerator ERR_DEVICENOTWORK

    Device doesn’t seem to be working

  enumerator ERR_DEVICEDTRRTSERROR

    Error during setting DTR/RTS in device

  enumerator ERR_DEVICECHANGESPEEDERROR

    10 Error during changing speed in device

  enumerator ERR_DEVICEWRITEERROR

    Error during writing device

  enumerator ERR_DEVICEREADERROR

    Error during reading device

  enumerator ERR_DEVICEPARITYERROR

    Can’t set parity on device

  enumerator ERR_TIMEOUT

    Command timed out

  enumerator ERR_FRAMENOTREQUESTED

    Frame handled, but not requested in this moment

  enumerator ERR_UNKNOWNRESPONSE

    Response not handled by gammu

  enumerator ERR_UNKNOWNFRAME

    Frame not handled by gammu

  enumerator ERR_UNKNOWNCONNECTIONTYPESTRING

    Unknown connection type given by user

  enumerator ERR_UNKNOWNMODELSTRING

    Unknown model given by user

  enumerator ERR_SOURCENOTAVAILABLE

    20 Some functions not compiled in your OS

  enumerator ERR_NOTSUPPORTED

    Not supported by phone

  enumerator ERR_EMPTY

    Empty entry or transfer end.

  enumerator ERR_SECURITYERROR

    Not allowed

  enumerator ERR_INVALIDLOCATION

    Too high or too low location…

  enumerator ERR_NOTIMPLEMENTED

    Function not implemented

  enumerator ERR_FULL

    Memory is full

  enumerator ERR_UNKNOWN

    Unknown response from phone

  enumerator ERR_CANTOPENFILE

    Error during opening file

  enumerator ERR_MOREMEMORY

    More memory required

  enumerator ERR_PERMISSION

    30 No permission

  enumerator ERR_EMPTYSMSC

    SMSC number is empty

  enumerator ERR_INSIDEPHONEMENU

    Inside phone menu - can’t make something

  enumerator ERR_NOTCONNECTED

    Phone NOT connected - can’t make something

  enumerator ERR_WORKINPROGRESS

    Work in progress

  enumerator ERR_PHONEOFF

    Phone is disabled and connected to charger

  enumerator ERR_FILENOTSUPPORTED

    File format not supported by Gammu

  enumerator ERR_BUG

    Found bug in implementation or phone

  enumerator ERR_CANCELED

    Action was canceled by user

  enumerator ERR_NEEDANOTHERANSWER

    Inside Gammu: phone module need to send another answer frame

  enumerator ERR_OTHERCONNECTIONREQUIRED

    40 You need other connectin for this operation.

  enumerator ERR_WRONGCRC

    Wrong CRC

  enumerator ERR_INVALIDDATETIME

    Invalid date/time

  enumerator ERR_MEMORY

    Phone memory error, maybe it is read only

  enumerator ERR_INVALIDDATA

    Invalid data given to phone

  enumerator ERR_FILEALREADYEXIST

    File with specified name already exist

  enumerator ERR_FILENOTEXIST

    File with specified name doesn’t exist

  enumerator ERR_SHOULDBEFOLDER

    You have to give folder (not file) name

  enumerator ERR_SHOULDBEFILE

    You have to give file (not folder) name

  enumerator ERR_NOSIM

    Can not access SIM card

  enumerator ERR_GNAPPLETWRONG

    50 Invalid gnapplet version

  enumerator ERR_FOLDERPART

    Only part of folders listed

  enumerator ERR_FOLDERNOTEMPTY

    Folder is not empty

  enumerator ERR_DATACONVERTED

    Data were converted

  enumerator ERR_UNCONFIGURED

    Gammu is not configured.

  enumerator ERR_WRONGFOLDER

    Wrong folder selected (eg. for SMS).

  enumerator ERR_PHONE_INTERNAL

    Internal phone error (phone got crazy).

  enumerator ERR_WRITING_FILE

    Could not write to a file (on local filesystem).

  enumerator ERR_NONE_SECTION

    No such section exists.

  enumerator ERR_USING_DEFAULTS

    Using default values.

  enumerator ERR_CORRUPTED

    60 Corrupted data returned by phone.

  enumerator ERR_BADFEATURE

    Bad feature string.

  enumerator ERR_DISABLED

    Some functions not compiled in your OS

  enumerator ERR_SPECIFYCHANNEL

    Bluetooth configuration requires channel option.

  enumerator ERR_NOTRUNNING

    Service is not running.

  enumerator ERR_NOSERVICE

    Service setup is missing.

  enumerator ERR_BUSY

    Command failed. Try again.

  enumerator ERR_COULDNT_CONNECT

    Can not connect to server.

  enumerator ERR_COULDNT_RESOLVE

    Can not resolve host name.

  enumerator ERR_GETTING_SMSC

    Failed to get SMSC number from phone.

  enumerator ERR_ABORTED

    70 Operation aborted.

  enumerator ERR_INSTALL_NOT_FOUND

    Installation data not found.

  enumerator ERR_READ_ONLY

    Entry is read only.

  enumerator ERR_NETWORK_ERROR

    Network error.

  enumerator ERR_DB_VERSION

    Invalid database version.

  enumerator ERR_DB_DRIVER

    Failed to initialize DB driver.

  enumerator ERR_DB_CONFIG

    Failed to configure DB driver.

  enumerator ERR_DB_CONNECT

    Failed to connect to database.

  enumerator ERR_DB_TIMEOUT

    Database connection timeout.

  enumerator ERR_SQL

    Error in executing SQL query.

  enumerator ERR_INVALID_OPERATION

    The operation cannot be performed.

  enumerator ERR_MEMORY_NOT_AVAILABLE

    The type of memory is not available or has been disabled.

  enumerator ERR_LAST_VALUE

    Just marker of highest error code, should not be used.