Interface for communication with a GSM modem attached to a serial port. More...

import"GsmModem.idl";

Classes
struct	Information
	Structure holding information about the modem and the SIM card. More...

struct	Settings
	Structure for holding settings of the GSM modem and its SIM card. More...

Public Types
enum	SimSecurityStatus { UNLOCKED, WAITFORPIN, WAITFORPUK, UNKNOWN }
	Possible security states the sim card can be in at a given time. More...

Public Member Functions
Settings	getSettings ()
	Get modem settings. More...

int	setSettings (in Settings settings)
	Set modem settings. More...

int	sendSms (in string recipient, in string text)
	Send out a SMS message. More...

int	sendTestSms (in string recipient, in Settings testSettings)
	Send out a test SMS message. More...

int	getInformation (out Information info)
	Retrieve low-level information about the modem and the SIM card. More...

int	getInformationWithPin (in string pin, out Information info)
	Retrieve low-level information about the modem and the SIM card. More...

int	getSimSecurityStatus (out SimSecurityStatus simStatus)
	Retrieve security status of the SIM card. More...

int	unlockSimCard (in string puk, in string newPin)
	Unlock SIM card with PUK and set new PIN if the SIM card is in security status WAITFORPUK. More...

Public Attributes
constant int	SUCCESS = 0
	Error codes. More...

constant int	ERR_INVALID_VALUE = 1
	Invalid argument.

constant int	ERR_WRONG_PIN = 2
	The PIN is incorrect or missing.

constant int	ERR_SMS_SEND_FAILED = 3
	SMS delivery failed.

constant int	ERR_COMMUNICATION_FAILURE = 4
	Communication with the modem failed.

constant int	ERR_SIM_LOCKED = 5
	The SIM card is locked and waits for the PUK.

constant int	ERR_WRONG_SIM_STATUS = 6
	The SIM card doesn't wait for the PUK.

constant int	ERR_WRONG_PUK = 7
	The PUK is incorrect or missing.

constant int	ERR_SIM_PROBLEM = 8
	There is a problem with the SIM or service subscription.

valueobject	SimSecurityStatusChangedEvent: idl::Event { SimSecurityStatus newSimStatus
	Sim card security status changed event. More...

valueobject	SimPinUpdatedEvent: idl::Event { string newPin
	Sim pin updated event. More...

Detailed Description

Interface for communication with a GSM modem attached to a serial port.

Member Enumeration Documentation

enum serial::GsmModem_1_0_2::SimSecurityStatus

Possible security states the sim card can be in at a given time.

Enumerator
UNLOCKED	SIM card is unlocked.
WAITFORPIN	PIN must be entered to unlock the SIM card.
WAITFORPUK	PUK and new PIN must be entered to unlock the SIM card.
UNKNOWN	Unkown security status.

Member Function Documentation

int serial::GsmModem_1_0_2::getInformation ( out Information info )

Retrieve low-level information about the modem and the SIM card.

Parameters

info	– structure holding the returned information

Returns: SUCCESS – on success; ERR_WRONG_PIN – if the used PIN is incorrect or missing; ERR_SIM_LOCKED – if the SIM card is locked and waits for the PUK; ERR_COMMUNICATION_FAILURE – if communication with the modem failed

int serial::GsmModem_1_0_2::getInformationWithPin	(	in string	pin,
		out Information	info
	)

Retrieve low-level information about the modem and the SIM card.

Like getInformation, but allows providing a PIN not stored in the settings

Parameters

pin	– PIN to use for authentication
info	– structure holding the returned information

Returns: SUCCESS – on success; ERR_WRONG_PIN – if the used PIN is incorrect or missing; ERR_SIM_LOCKED – if the SIM card is locked and waits for the PUK; ERR_COMMUNICATION_FAILURE – if communication with the modem failed

Settings serial::GsmModem_1_0_2::getSettings ( )

Get modem settings.

Returns: – Current modem settings

int serial::GsmModem_1_0_2::getSimSecurityStatus ( out SimSecurityStatus simStatus )

Retrieve security status of the SIM card.

Parameters

simStatus – SIM card security status

Returns: SUCCESS – on success; ERR_COMMUNICATION_FAILURE – if communication with the modem failed

int serial::GsmModem_1_0_2::sendSms	(	in string	recipient,
		in string	text
	)

Send out a SMS message.

Parameters

recipient	– Phone number of the message recipient in ITU-T E.164 format
text	– Message text (will be sent in multiple messages if longer than 160 characters)

Returns: SUCCESS – on success; ERR_WRONG_PIN – if the PIN currently stored in the settings is incorrect or missing; ERR_SMS_SEND_FAILED – if the delivery of the SMS to the network failed; ERR_SIM_LOCKED – if the SIM card is locked and waits for the PUK; ERR_COMMUNICATION_FAILURE – if communication with the modem failed

int serial::GsmModem_1_0_2::sendTestSms	(	in string	recipient,
		in Settings	testSettings
	)

Send out a test SMS message.

The message will be sent to the selected recipient with the text 'SMS Test'.

Parameters

recipient	– Phone number of the message recipient in ITU-T E.164 format
testSettings	– Modem settings to be used temporarily during testing

Returns: SUCCESS – on success; ERR_WRONG_PIN – if the PIN currently stored in the settings is incorrect or missing; ERR_SMS_SEND_FAILED – if the delivery of the SMS to the network failed; ERR_SIM_LOCKED – if the SIM card is locked and waits for the PUK; ERR_COMMUNICATION_FAILURE – if communication with the modem failed

int serial::GsmModem_1_0_2::setSettings ( in Settings settings )

Set modem settings.

Parameters

settings – New settings

Returns: SUCCESS – on success; ERR_INVALID_VALUE – if any passed value was invalid

int serial::GsmModem_1_0_2::unlockSimCard	(	in string	puk,
		in string	newPin
	)

Unlock SIM card with PUK and set new PIN if the SIM card is in security status WAITFORPUK.

The new PIN is automatically saved in the settings.

Parameters

puk	– PUK to use for authentication
newPin	– new PIN to use for future authentication

Returns: SUCCESS – on success; ERR_WRONG_SIM_STATUS – if the SIM card doesn't wait for the PUK; ERR_WRONG_PUK – if the used PUK is incorrect or missing; ERR_COMMUNICATION_FAILURE – if communication with the modem failed

Member Data Documentation

valueobject serial::GsmModem_1_0_2::SimPinUpdatedEvent

Sim pin updated event.

new PIN for SIM card after Unlock

valueobject serial::GsmModem_1_0_2::SimSecurityStatusChangedEvent

Sim card security status changed event.

new SIM card security status

constant int serial::GsmModem_1_0_2::SUCCESS = 0

Error codes.

No error

The documentation for this interface was generated from the following file:

pdu-json-rpc-api/idl/GsmModem.idl

Classes

Public Types

Public Member Functions

Public Attributes

Detailed Description

Member Enumeration Documentation

Member Function Documentation

Member Data Documentation