Text Message Format - Siemens SIMATIC S7-200 System Manual

S7-200 Programmable Controller System Manual

Text Message Format

The Text Message Format defines the format of text paging or SMS messages. These types of
messages can contain text and embedded variables. The text message is an ASCII string with a
leading length byte followed by ASCII characters. The maximum length of a text message is 120
bytes (which includes the length byte).
Format: <Text><Variable><Text><Variable>...
The Text field consists of ASCII characters.
The Variable field defines an embedded data value which the Modem module reads from the local
CPU, formats, and places in the message. The percent (%) character is used to mark the start
and the end of a variable field. The address and the left fields are separated with a colon. The
delimiter between the Left and Right fields can be either a period or a comma and is used as the
decimal point in the formatted variable. The syntax for the variable field is:
%Address:Left.Right Format%
The Address field specifies the address, data type and size of the embedded data value (i.e.
VD100, VW50, MB20 or T10). The following data types are allowed: I, Q, M, SM, V, T (word only),
C (word only), and AI (word only). Byte, word and double word sizes are allowed.
The Left field defines the number of digits to display left of the decimal point. This value should be
large enough to handle the expected range of the embedded variable including a minus sign if
needed. If Left is zero the value is displayed with a leading zero. The valid range for Left is 0 to 10.
The Right field defines the number of digits to display right of the decimal point. Zeros to the right
of the decimal point are always displayed. If Right is zero the number is displayed without a
decimal point. The valid range for Right is 0 to 10.
The Format field specifies the display format of the embedded value. The following characters are
allowed for the format field:
i -- signed integer
u -- unsigned integer
h -- hexadecimal
f -- floating point/real
Example: "Temperature = %VW100:3.1i% Pressure = %VD200:4.3f%"
328