Detailed information on the _SMS data point type

The _SMS data point type is provided for the send and receive SMS facility. New SMS data points are created as data points of type _SMS. You can create several _SMS data points for your application. If you use the WinCC OA default panels for configuration, sending and receiving of messages you can however only use the _SMS_1 data point. The _SMS data point type consists of general settings, values that are automatically set by control script at runtime, values for incoming (In) and outgoing (Out) messages as well as AT commands (AT). The tables below describe the meaning of these data point elements:

Data point type _SMS (general settings)

Element	Data type	Meaning
SMSC	String	If the element is set, the value of SMSC is saved permanent into the GSM device.
SIM	String	If the element is set, the value for SIM code is sent to the GSM device when initializing
ComPort	String	Is used when opening the interface
BaudRate	Int	Is used when opening the interface
PortSetting	String	Is used when opening the interface
AutoDelete	Bool	Defines if the received SMS messages should be deleted from the device. Can be changed dynamically.
SmscHeader	Int	The SmscHeader flag is an indicator which shows what kind of device is connected to WinCC OA. The value is initialized with 0. If the connected device is a Siemens TC35i GSM modem, the value is set automatically to 1. If the connected device again is a cell phone or a newer modem, the value is set to either 2 or 3, depending on the mode (2=PDU mode, 3=text mode).

Values that are set automatically by the control script at runtime

Element	Data type	Meaning
DeviceReady	Bool	GSM device ready for use
ReceiveActive	Unsigned	Shows if the receive mode is active.
Quality	Int	Current field strength as a percent value. It is evaluated at every request and is available only when the receive mode is active.
Status	Int	Status of successfully executed actions or error messages. If the return value (saved in the status element) of an action equals 0, the action was executed successfully. If the return value is different than 0, the value is an error code. The errors are output via the SMS.cat. For information on possible error codes, see the control function sendSMS()
FileHandle	Int	Each connected device has to have a FileHandle. This is used only internal for a locking mechanism.
MemReset	Bool	Resets the device memory if this element is set.

Values for outgoing messages (Out)

Element	Data type	Meaning
SendTel	String	Phone number of the recipient (of message)
Msg	String	The message
MsgSent	Bool	"True" if the sending of message was successful

Values for incoming messages (In)

Element	Data type	Meaning
RecvTel	String	Phone number of the sender (of message)
Msg	String	The message
Time	Time	Reception time (of message)

AT commands (AT)

Element	Data type	Meaning
SendDirect	String	At command that is sent to the device. The validity of the command is not controlled. The value of SendDirect is deleted after sending.
SendDirectResult	Dyn_string	The result from the device