GSM

Description

This command can be used to change settings that are relevant for GSM functionality. The local GSM client can also be startet and stopped by this command and AT and USSD queries can be executed. The command requires always two arguments. The following options are possible:

 

GSM CMD <...>
This executes either an USSD query or an AT command. If the first character in the third argument is an asterisk (*), the third argument is interpreted as USSD query. Otherwise, if it begins with 'a' ore 'A' followed by 't' or 'T', it is interpreted as AT-command. Any argument that doesn't fit these requirements is rejected.

 

GSM NET <START|STOP>
This forces a startup or shutdown of the local GSM client regardless of dial-in policy. However, if dial-in policy is set to PERMANENT, the network will automatically reconnect after a GSM NET STOP. GSM NET START will fail if the module is not configured to use GSM as networking interface. Please see the NET command.

 

GSM APN <...>
This sets the APN (Access Point Name) required by GSM/GPRS networks. Contact your GSM provider for your APN or seek for it here.

 

GSM PIN <...>
This sets the PIN, usually a 4-digit number, to unlock your SIM card used by the GSM modem. You should get this number from your GSM provider. Often it can be found on the package that contains the SIM card.

 

GSM DIAL <...>
This sets "Dial String", that is something like a telephone number to attach to the GSM/GPRS network. Often this string is "*99#" (without the quotes).

 

GSM PASS <...>
This sets PPP (Pomt-to-Point Protocol) password used for access to the GSM/GPRS network. Contact your GSM provider for the password or seek for it here.

 

GSM USER <...>
This sets PPP (Pomt-to-Point Protocol) user name used for access to the GSM/GPRS network. Contact your GSM provider for the user name or seek for it here.

 

GSM POLICY <AUTO|PERM>
This sets the dial-in policy. There are currently two exclusive options defined: PERM and AUTO. If GSM POLICY PERM is given, the module aggressively tries to reconnect whenever the conenction is lost. On GSM POLICY AUTO, the module connects 'on demand', that is, it connects to the GSM network when any local socket is open and disconnects when the last socket is closed.

Return Value

ERR_NET_DOWN (39) if GSM NET START failded.
ERR_ARGUMENT (4) if one or more arguments do not match.

ERR_REJECTED (12) if GSM CMD <...> was called with invalid input.
ERR_OK (0) if command was accepted. 

Example

GSM CMD AT+CPIN?

This shows the status of the modem regarding to a SIM card.

Remarks

This command is available on firmware version 6.05 and above. There must be a GSM modem attached to the module.

 

---

 

GSM?

Description

This command simpy shows the settings of the local GSM client separated by CR/LFs.

Example

pinternet.interkom.de
9778
*99#
PPPUSER
PPPASS
PERM

This means, from top to bottom: APN, PIN, Dial-String, PPP Username, PPP Password, Dial-In Policy