The SIM interface is used to access the Subscriber Identification Module (SIM) plugged as a card into a GSM device. Use it to authenticate yourself against the GSM network and read/store data from/to the embedded SIM card memory. Support for accessing the on-card phonebooks and messagebook is also provided.
org.freesmartphone.GSM.SIM
Description: Retrieve the authentication status for the SIM card.
The authentication status for the SIM card. Values to expect:
Description: Send authentication code (PIN) for the SIM card.
The authentication code.
Description: Retrieve the unlock counters for the SIM card.
This is outside the GSM standard and only supported on some devices.
The unlock counters for the SIM card.
Description: Send unlock code (PUK) and new authentication code (PIN).
The unlock code.
s: new_pinThe new authentication code.
Description: Change the authentication code.
The old authentication code.
s: new_pinThe new authentication code.
Description: Enable or disable checking for the SIM card authentification on startup.
True, to turn SIM card authentification on. False, to turn it off.
s: pinA valid authentication code.
Description: Retrieve whether the SIM card checks for authentification on startup.
True, if SIM card authentification is turned on. False, otherwise.
Description: Get information stored on the SIM card.
Information about the SIM card. Possible tuples are:
Description: Send a generic SIM command to the SIM card.
The command to send, encoded as described in GSM 11.11.
The result of the command, encoded as described in GSM 11.11.
Description: Send a restricted SIM command to the SIM card.
The command to send. Valid values are:
The identifier of an elementary datafile on SIM. Mandatory for every command except STATUS.
i: p1Parameter 1 passed to the SIM. Mandatory for every command except STATUS and GET RESPONSE.
i: p2Parameter 1 passed to the SIM. Mandatory for every command except STATUS and GET RESPONSE.
i: p3Parameter 1 passed to the SIM. Mandatory for every command except STATUS and GET RESPONSE.
s: dataThe command data to the SIM, encoded as described in GSM 11.11.
The result of the command, encoded as described in GSM 11.11.
Description: Retrieve the homezones coordinates, if stored on the SIM.
An array containing up to four homezones in Gauss-Krueger coordinates. The array contains of four-tuples with the following format:
Description: Request information about a phonebook.
The phonebook storage category. See GetSimInfo for valid categories.
Capacity of the phonebook.
i: numberlengthMaximum length for the phone number.
i: namelengthMaximum length for the associated name.
Description: Delete an entry in the SIM phonebook.
The phonebook storage category. See GetSimInfo for a list of valid categories.
i: indexIndex of entry to delete.
Description: Store an entry in the SIM phonebook.
The phonebook storage category. See GetSimInfo for a list of valid categories.
i: indexThe index of the entry to store.
s: nameThe name corresponding to the number.
s: numberThe number corresponding to the name.
Description: Retrieve (parts of) a SIM phonebook.
The phonebook storage category. Use GetSimInfo to gather the list of valid categories.
i: mindexThe minimum index of the entry to retrieve.
i: maxdexThe maximum index of entries to receive.
The phonebook entries. This is an array of three-tuples. Every entry has the following structure:
Description: Retrieve phone number of SMS Center.
The SMS Center Number.
Description: Set phone number of SMS Center.
The SMS Center Number.
Description: Delete a message in the SIM messagebook.
The storage index of the message to delete.
Description: Store a message in the SIM messagebook.
The number of the recipient.
s: contentsThe contents of the message.
a{sv}: propertiesFor a list of valid properties see SendMessage
The index of the new message.
Description: Sends a message stored in the SIM messagebook.
The index of the message.
The given transaction index for this message.
s: timestampThe timestamp this message was received by the SMSC
Description: Retrieve a message from the SIM messagebook.
The index of the message to retrieve.
The category the message is in, one of ("read", "sent", "unread", "unsent").
s: sender_numberThe number of the sender.
s: contentsThe contents of the message.
a{sv}: propertiesAdditional properties (TBD).
Description: Sent, when the authentication status for the SIM card changes.
The authentication status for the SIM card. See GetAuthStatus for a list of expected values.
Description: Sent, when a new message has been received and stored on the SIM card.
The storage index of the new message.