Info¶
-
const unsigned char*
GSM_GetNetworkName
(const char * NetworkCode)¶ Find network name from given network code.
-
const unsigned char*
GSM_GetCountryName
(const char * CountryCode)¶ Find country name from given country code.
-
const char*
GSM_FeatureToString
(GSM_Feature feature)¶ Converts feature value to string.
- Return
- Pointer to static string with string for specified feature, NULL on failure.
- Parameters
feature
: GSM_Feature to convert.
-
GSM_Feature
GSM_FeatureFromString
(const char * feature)¶ Converts feature string to value.
- Return
- GSM_Feature value, 0 on failure.
- Parameters
feature
: GSM_Feature string to convert.
-
gboolean
GSM_IsPhoneFeatureAvailable
(GSM_PhoneModel * model, GSM_Feature feature)¶ Checks whether phone supports features.
- Return
- True if phone has defined this feature.
- Parameters
model
: Model information (you can get it using GSM_GetModelInfo).feature
: GSM_Feature to check for.
-
gboolean
GSM_AddPhoneFeature
(GSM_PhoneModel * model, GSM_Feature feature)¶ Adds feature to phone configuration.
- Return
- True if phone has defined this feature.
- Parameters
model
: Model information (you can get it using GSM_GetModelInfo).feature
: GSM_Feature to check for.
-
GSM_Error
GSM_GetManufacturer
(GSM_StateMachine * s, char * value)¶ Reads manufacturer from phone.
- Return
- Error code.
- Parameters
s
: State machine pointer.value
: Pointer where to store manufacturer name
-
GSM_Error
GSM_GetModel
(GSM_StateMachine * s, char * value)¶ Reads model from phone.
- Return
- Error code.
- Parameters
s
: State machine pointer.value
: Pointer where to store model name
-
GSM_PhoneModel*
GSM_GetModelInfo
(GSM_StateMachine * s)¶ Reads model info from state machine.
- Return
- Pointer to phone information structure.
- Parameters
s
: State machine pointer.
-
GSM_Error
GSM_GetFirmware
(GSM_StateMachine * s, char * value, char * date, double * num)¶ Reads firmware information from phone.
- Return
- Error code.
- Parameters
s
: State machine pointer.value
: Pointer where to store revision textdate
: Pointer where to store revision datenum
: Pointer where to store revision number
-
GSM_Error
GSM_GetIMEI
(GSM_StateMachine * s, char * value)¶ Reads IMEI/serial number from phone.
- Return
- Error code.
- Parameters
s
: State machine pointer.value
: Pointer where to store IMEI, NULL to ignore.
-
GSM_Error
GSM_GetOriginalIMEI
(GSM_StateMachine * s, char * value)¶ Gets date and time from phone.
-
GSM_Error
GSM_GetManufactureMonth
(GSM_StateMachine * s, char * value)¶ Gets month when device was manufactured.
-
GSM_Error
GSM_GetProductCode
(GSM_StateMachine * s, char * value)¶ Gets product code of device.
-
GSM_Error
GSM_GetHardware
(GSM_StateMachine * s, char * value)¶ Gets hardware information about device.
-
GSM_Error
GSM_GetPPM
(GSM_StateMachine * s, char * value)¶ Gets PPM (Post Programmable Memory) info from phone (in other words for Nokia get, which language pack is in phone)
-
GSM_Error
GSM_GetSIMIMSI
(GSM_StateMachine * s, char * IMSI)¶ Gets SIM IMSI from phone.
-
GSM_Error
GSM_GetBatteryCharge
(GSM_StateMachine * s, GSM_BatteryCharge * bat)¶ Gets information about batery charge and phone charging state.
-
GSM_Error
GSM_GetSignalQuality
(GSM_StateMachine * s, GSM_SignalQuality * sig)¶ Reads signal quality (strength and error rate).
-
GSM_Error
GSM_GetNetworkInfo
(GSM_StateMachine * s, GSM_NetworkInfo * netinfo)¶ Gets network information.
-
GSM_Error
GSM_GetDisplayStatus
(GSM_StateMachine * s, GSM_DisplayFeatures * features)¶ Acquired display status.
-
enum
GSM_NetworkInfo_State
¶ Status of network logging
Values:
-
GSM_HomeNetwork
= 1¶ Home network for used SIM card.
-
GSM_NoNetwork
¶ No network available for used SIM card.
-
GSM_RoamingNetwork
¶ SIM card uses roaming.
-
GSM_RegistrationDenied
¶ Network registration denied - card blocked or expired or disabled.
-
GSM_NetworkStatusUnknown
¶ Unknown network status.
-
GSM_RequestingNetwork
¶ Network explicitely requested by user.
-
-
enum
GSM_GPRS_State
¶ Status of GPRS connection.
Values:
-
GSM_GPRS_Detached
= 1¶ GRPS is detached.
-
GSM_GPRS_Attached
¶ GRPS is attached.
-
-
struct
GSM_NetworkInfo
¶ Structure for getting the current network info.
Public Members
-
char GSM_NetworkInfo::CID[10]
Cell ID (CID)
-
char GSM_NetworkInfo::NetworkCode[10]
GSM network code.
-
GSM_NetworkInfo_State
State
¶ Status of network logging. If phone is not logged into any network, some values are not filled
-
char GSM_NetworkInfo::LAC[10]
LAC (Local Area Code).
-
unsigned char GSM_NetworkInfo::NetworkName[20 *2]
Name of current network returned from phone (or empty). The buffer needs to have twice the capacity of the longest supported network name to account for decoding.
-
GSM_GPRS_State
GPRS
¶ GPRS state.
-
char GSM_NetworkInfo::PacketCID[10]
Cell ID (CID) for packet network
-
GSM_NetworkInfo_State
PacketState
¶ Status of network logging for packet data. If phone is not logged into any network, some values are not filled
-
char GSM_NetworkInfo::PacketLAC[10]
LAC (Local Area Code) for packet data.
-
-
struct
GSM_SignalQuality
¶ Information about signal quality, all these should be -1 when unknown.
-
enum
GSM_ChargeState
¶ Power source
Values:
-
GSM_BatteryPowered
= 1¶ Powered from battery
-
GSM_BatteryConnected
¶ Powered from AC, battery connected
-
GSM_BatteryCharging
¶ Powered from AC, battery is charging
-
GSM_BatteryNotConnected
¶ Powered from AC, no battery
-
GSM_BatteryFull
¶ Powered from AC, battery is fully charged
-
GSM_PowerFault
¶ Power failure
-
-
enum
GSM_BatteryType
¶ Power source
Values:
-
GSM_BatteryUnknown
= 0¶ Unknown battery
-
GSM_BatteryNiMH
= 1¶ NiMH battery
-
GSM_BatteryLiIon
¶ Lithium Ion battery
-
GSM_BatteryLiPol
¶ Lithium Polymer battery
-
-
struct
GSM_BatteryCharge
¶ Battery status
Public Members
-
int
BatteryPercent
¶ Signal strength in percent, -1 = unknown
-
GSM_ChargeState
ChargeState
¶ Charge state
-
int
BatteryVoltage
¶ Current battery voltage (in mV).
-
int
ChargeVoltage
¶ Voltage from charger (in mV)
-
int
ChargeCurrent
¶ Current from charger (in mA)
-
int
PhoneCurrent
¶ Phone current consumption (in mA)
-
int
BatteryTemperature
¶ Battery temperature (in degrees Celsius)
-
int
PhoneTemperature
¶ Phone temperature (in degrees Celsius)
-
int
BatteryCapacity
¶ Remaining battery capacity (in mAh)
-
GSM_BatteryType
BatteryType
¶ Battery type
-
int
-
enum
GSM_DisplayFeature
¶ Display feature
Values:
-
GSM_CallActive
= 1¶
-
GSM_SMSMemoryFull
¶ blinking envelope
-
GSM_FaxCall
¶
-
GSM_UnreadSMS
¶
-
GSM_DataCall
¶
-
GSM_VoiceCall
¶
-
GSM_KeypadLocked
¶
-
-
struct
GSM_DisplayFeatures
¶ Display features
-
enum
GSM_Feature
¶ Phone features definition. This is usually used for things, which can not be determined on run time.
Values:
-
F_CAL33
= 1¶ Calendar,3310 style - 10 reminders, Unicode, 3 coding types
-
F_CAL52
¶ Calendar,5210 style - full Unicode, etc.
-
F_CAL82
¶ Calendar,8250 style - “normal”, but with Unicode
-
F_RING_SM
¶ Ringtones returned in SM format - 33xx
-
F_NORING
¶ No ringtones
-
F_NOPBKUNICODE
¶ No phonebook in Unicode
-
F_NOWAP
¶ No WAP
-
F_NOCALLER
¶ No caller groups
-
F_NOPICTURE
¶ No Picture Images
-
F_NOPICTUREUNI
¶ No Picture Images text in Unicode
-
F_NOSTARTUP
¶ No startup logo
-
F_NOCALENDAR
¶ No calendar
-
F_NOSTARTANI
¶ Startup logo is not animated
-
F_POWER_BATT
¶ Network and battery level get from netmonitor
-
F_PROFILES33
¶ Phone profiles in 3310 style
-
F_PROFILES51
¶ Phone profiles in 5110 style
-
F_MAGICBYTES
¶ Phone can make authentication with magic bytes
-
F_NODTMF
¶ Phone can’t send DTMF
-
F_DISPSTATUS
¶ Phone return display status
-
F_NOCALLINFO
¶ Phone does not return call info
-
F_DAYMONTH
¶ Day and month reversed in pbk, when compare to GSM models
-
F_PBK35
¶ Phonebook in 3510 style with ringtones ID
-
F_PBKIMG
¶ Phonebook in 7250 style with picture ID
-
F_PBKTONEGAL
¶ Phonebook with selecting ringtones from gallery
-
F_PBKSMSLIST
¶ Phonebook with SMS list
-
F_PBKUSER
¶ Phonebook with user ID
-
F_6230iCALLER
¶ Caller groups like in 6230i
-
F_RADIO
¶ Phone with FM radio
-
F_TODO63
¶ ToDo in 6310 style - 0x55 msg type
-
F_TODO66
¶ ToDo in 6610 style - like calendar, with date and other
-
F_NOMIDI
¶ No ringtones in MIDI
-
F_BLUETOOTH
¶ Bluetooth support
-
F_NOFILESYSTEM
¶ No images, ringtones, java saved in special filesystem
-
F_NOMMS
¶ No MMS sets in phone
-
F_NOGPRSPOINT
¶ GPRS point are not useable
-
F_CAL35
¶ Calendar,3510 style - Reminder,Call,Birthday
-
F_CAL65
¶ Calendar,6510 style - CBMM, method 3
-
F_WAPMMSPROXY
¶ WAP & MMS settings contains first & second proxy
-
F_CHAT
¶ Phone with Chat settings
-
F_SYNCML
¶ Phone with SyncML settings
-
F_FILES2
¶ Filesystem version 2
-
F_NOFILE1
¶ No filesystem version 1
-
F_6230iWAP
¶ WAP, MMS, etc. settings like in 6230i - unknown now
-
F_PROFILES
¶ Profiles support available
-
F_SERIES40_30
¶ Series 40 3.0
-
F_SMS_FILES
¶ SMS are read from filesystem files like in Series 40 3.0
-
F_3220_MMS
¶ MMS storage as in 3320
-
F_VOICETAGS
¶ Voice tags available
-
F_CAL62
¶ Calendar,6210 style - Call,Birthday,Memo,Meeting
-
F_NOTES
¶ Notes supported
-
F_SMSONLYSENT
¶ Phone supports only sent/unsent messages
-
F_BROKENCPBS
¶ CPBS on some memories can hang phone
-
F_M20SMS
¶ Siemens M20 like SMS handling
-
F_SLOWWRITE
¶ Use slower writing which some phone need
-
F_SMSME900
¶ SMS in ME start from location 900 - case of Sagem
-
F_ALCATEL
¶ Phone supports Alcatel protocol
-
F_OBEX
¶ Phone can switch to OBEX protocol from AT mode
-
F_IRMC_LEVEL_2
¶ Phone supports IrMC level 2 even if it doesn’t report it
-
F_MODE22
¶ Switching to OBEX mode is done using AT+MODE=22
-
F_SMS_LOCATION_0
¶ Locations of SMS memories start from 0
-
F_NO_UCS2
¶ Phone does not support UCS2 even if it reports it.
-
F_FORCE_UTF8
¶ Phone returns strings in utf-8 even if it reports GSM.
-
F_SMS_SM
¶ Phone supports SM storage for SMS even if it does not report so.
-
F_SMS_ME
¶ Phone supports ME storage for SMS even if it does not report so.
-
F_XLNK
¶ Switching to OBEX mode is done using AT+XLNK.
-
F_SUBMIT_SIM_ONLY
¶ Submit messages can be saved on SM memory only.
-
F_PBK_UNICODE
¶ Prefer Unicode for phone book manipulations.
-
F_SQWE
¶ Switching to OBEX mode using AT^SQWE=3.
-
F_NO_ATOBEX
¶ Do not use OBEX/AT switching even if available.
-
F_LENGTH_BYTES
¶ Length of text for contact is in bytes and not chars.
-
F_BROKEN_CMGL
¶ CMGL does not list real locations for CMGR, these should be sequential.
-
F_EXTRA_PBK_FIELD
¶ Phonebook has extra numeric field at the end.
-
F_CKPD_NO_UNICODE
¶ Key presses can not be in unicode.
-
F_CPROT
¶ OBEX switching using AT+CPROT even if phone does not report it properly.
-
F_PBKFAVORITEMESSAGE
¶ Phonebook with favorite messaging numbers
-
F_PBKNOPOSTAL
¶ No support for postal entry in phonebook.
-
F_PBK_ENCODENUMBER
¶ Encode number in HEX charset.
-
F_NO_CLIP
¶ Do not use CLIP (phone hangs on it).
-
F_ENCODED_USSD
¶ USSD propmts and responses are encoded like PDU in SMS (packed 7-bit GSM encoding).
-
F_USE_SMSTEXTMODE
¶ Phone has better support for SMS text mode (rather than PDU mode)
-
F_CPIN_NO_OK
¶ Phone does not end CPIN reply with OK/ERROR.
-
F_FOUR_DIGIT_YEAR
¶ Phone require four digit year in time.
-
F_SMS_NO_ME
¶ Phone does not have a phone SMS memory even if it reports so.
-
F_SMS_NO_SM
¶ Phone does not have a SIM SMS memory even if it reports so.
-
F_SIEMENS_PBK
¶ Phone supports Siemens style phonebook even if it does not tell so.
-
F_NO_ATSYNCML
¶ Disable AT+SYNCML probing.
-
F_MOBEX
¶ Phone supports m-obex (usually Samsung phones).
-
F_TSSPCSW
¶ Phone supports m-obex (usually Samsung phones) using AT$TSSPCSW=1.
-
F_DISABLE_GETNEXT
¶ Disable GetNext* operations on the dummy phone.
-
F_DISABLE_GETNEXTSMS
¶ Disable GetNextSMS operations on the dummy phone.
-
F_DISABLE_CMGL
¶ CMGL hangs, so should not be used.
-
F_NO_UTF8
¶ Phone does not support UTF8 even if it reports it.
-
F_SAMSUNG_UTF8
¶ Samsung B2100 in UCS-2 mode provides a garbled UTF-8 instead.
-
F_SMS_UTF8_ENCODED
¶ SMS text is always UTF-8 encoded.
-
F_NO_STOP_CUSD
¶ Avoid forcibly stopping CUSD session.
-
F_READ_SMSTEXTMODE
¶ Reading og SMSes in text mode.
-
F_RESET_AFTER_TIMEOUT
¶ Reset phone after timeout.
-
F_HUAWEI_INIT
¶ Huawei style init.
-
F_ZTE_INIT
¶ ZTE style init.
-
F_USSD_GSM_CHARSET
¶ Prefer GSM charset for USSD (default is unicode).
-
F_SMS_SR
¶ Phone supports SR storage even if it does not report so.
-
F_SMS_NO_SR
¶ Phone does not have a SR memory even if it reports so.
-
F_LAST_VALUE
¶ Just marker of highest feature code, should not be used.
-
-
struct
GSM_PhoneModel
¶ Model identification, used for finding phone features.