Reference > Gateway properties

GSM Modem properties

COM Port

Select the name of the serial port where the GSM modem is connected. If the GSM modem is connected to a USB port you must select the name of the virtual COM port of the USB port driver.

Baudrate

Select the baudrate (speed) for the serial port. Often the baudrate is detected automatically by the GSM modem but some GSM modems require a fixed baudrate.

TCP/IP connected modems

The GSM Modem Gateway can directly use GSM modems connected over an Internet TCP/IP connection, without the need for additional drivers. To use a TCP/IP connected GSM modem select TCP/IP from the COM port list and enter the host name or IP number and the attached port number. The GSM Modem Gateway can use a raw TCP/IP connection or a Telnet connection to the modem.

PIN code

Type the PIN code of the SIM card. Using a PIN code on your SIM card is not recommended. If your SIM card does not have a PIN code you can leave this field empty.

Reference_GSMModem

Advanced properties

LogCommunicationToFile

Log all modem communication to file. Use this option only if you encounter problems with the GSM modem. If enabled, the status windows of the GSM modem provides a link to the location on you hard disk where the file is stored.

MaximumBatchSize

The maximum number message this gateway will process in one batch. If this value is higher than one and a number of messages are sent at the same time, the gateway loads multiple messages concurrently. This can increase the speed in which the messages are processed but it also might prevent normal load balancing for multiple GSM modems.

Number template

The number template can be used to translate the number from one format to another. For more information see Use number templates.

CompatibilityMode

Besides Normal Mode, two other compatibility mode options are available when you encounter problems with the operation of your GSM modem, Basic PDU Mode and Basic Text Mode.

Basic PDU Mode is a minimal implementation of the GSM 07.05 PDU standard. Only the necessary modem commands are used and options like delivery confirmation or signal quality are not supported. In this mode you will have to set the value for the SMSC number manually since the software will not query the GSM modem for the right SMSC number.

Basic Text Mode is a minimal implementation of the GSM 07.05 text mode standard. Support for unicode characters or binary messages is not available. Use this mode only if your GSM modem does not support PDU mode, some CDMA modems for instance can send and receive SMS messages in text mode only.

ModemInitialization

Additional modem initialization. This modem command is sent to the GSM modem before the rest of the initialization. A possible use for this property is the modem command to select the GSM operator you want to use. E.g. if the network operator code is 26202 (Vodafone Germany) the modem command is:

AT+COPS=1,2,26202

ModemReboot

The modem reboot command, default value is AT+CFUN=1. Some modems require a AT+CFUN=1,1 command for a full reboot. Not all modems support a full reboot of the modem.

ModemRebootTime

After a modem reboot command the GSM modem needs some time for the reboot to complete and to reconnect to the mobile network. The ModemRebootTime specifies the number of seconds before the GSM Modem Gateway sends the next command.

ResetAfterNetworkFailure

If the GSM modem gateway is active, every 10 minutes the gateway queries the signal strength of the GSM modem. If ResetAfterNetworkFailure is enabled the gateway sends a hard reset to the GSM modem when no GSM network is detected.

ResetAfterTimeout

Send a hard reset to the GSM modem if no valid response to a modem command was received after a certain timeout. If supported by the GSM modem it will restart the connection to the GSM network.

ResetAfterSendError

Send a hard reset to the GSM modem if an error is reported after a send SMS command. This is often an indication of a network or GSM modem problem and can sometimes be resolved by a modem reset..

ResetDaily

Send a hard reset to the GSM modem once every day. Use this only if the GSM modem has problems if it runs for long periods.

SendDelayTime

Time (in seconds) between sending two consecutive SMS messages. This option can be used to delay sending of the messages if the mobile network is not able to process the messages fast enough.

SMSOverGPRS

Some GSM operators support sending SMS messages over a GPRS connection. If enabled this will speed up the sending messages considerably. Most GSM operators do not support SMS over GPRS or have only limited support. Sending messages will fail if this option is enabled and the GSM operator does not support it.

DataBits

Serial port data bits. default is 8.

Parity

Serial port parity. default is no parity.

StopBits

Serial port stop bits. default is 1.

GSMNumber

The mobile phone number of the SIM card (optional). This number is only used to identify which GSM modem received an SMS message. If this value is set, it overrides the GSM number found on the SIM card.

SMSCNumber

The SMS Central number is the address of the SMS Central of your GSM operator. This number must be in international format, e.g. +491722270333 for the German Vodafone SMSC and is necessary if you want to send SMS messages. If this value is set, it overrides the SMSC number found on the SIM card.

MaxMessageParts

Messages to send that are longer than 160 characters or 70 characters for unicode messages can be split in multiple SMS messages that are recombined to one message on the handset of the receiver. The MaxMessagePart property limits the amount of partial messages that the gateway sends with a long message. If the message is longer than can be sent with the maximum message parts, the rest of the message is discarded.

MaxShortCodeLength

The maximum number length where the number is regarded as a short code, short codes are encoded as Network Specific numbers.

MessageType

The message type is the default value for the SMS message encoding, the default value may be replaced with the message type specified by the sending Connector.

The gateway uses four possible value for the default message type:

Automatic	Standard Text encoding is the default, Unicode encoding will be used only if the message contains characters that are not in the default GSM SMS character set.
StandardText	The default 7-bit GSM SMS character set is used, all other characters are converted to question marks.
Unicode	All messages are sent in Unicode 16-bit encoding.
Data	All messages are sent in binary 8-bit encoding.

The GSM Modem gateway supports the following custom message types:

sms.automatic	Standard Text encoding is the default, Unicode encoding will be used only if the message contains characters that are not in the default GSM SMS character set.
sms.text	The default 7-bit GSM SMS character set is used, all other characters are converted to question marks.
sms.unicode	The message is sent in Unicode 16-bit encoding.
sms.binary	The message is sent in binary 8-bit encoding.
sms.automatic.flash	Flash SMS, standard Text encoding is the default, Unicode encoding will be used only if the message contains characters that are not in the default GSM SMS character set.
sms.text.flash	Flash SMS, the default 7-bit GSM SMS character set is used, all other characters are converted to question marks.
sms.unicode.flash	Flash SMS, all messages are sent in Unicode 16-bit encoding.
gsm.ussd	Send a USSD command to the GSM operator (e.g. *101#). The response is sent as a received SMS message.

DeliveryConfirmation

Require status updates for the SMS messages after it is sent to the SMSC. If you do not need to know if the SMS messages are delivered on the GSM phone or if the status updates causes errors sending the messages you can disable status updates.

CombineMultiPartMessage

If enabled, partial messages received on the GSM modem are combined to the original message length. Since delivery of some message parts might be delayed this could mean that the delivery of the whole message will be delayed. If, after a certain timeout, not all message parts are received, the partial messages are delivered individually. If disabled the partial messages are delivered individually.

CombineMultipartMessages can also be set to Binary. In this mode the received messages are not decoded and combined but forwarded as message type sms.binary with the message field set to <DCS>,<PID>,<UDL>,<UDH>,<Data>. This may be useful if you intend to use Diafaan SMS Server to retransmit the messages unaltered to one or more alternative receivers.