00193368-02 - 第57页
SIPLACE GEM for S25HM, S27HM, HS50, HS60 SW Version GEM 503.02 HOST Inter fac e Manual ©Siemens AG, all rights reser ved page 57 of 243 Numer ic values s hown are considered dec im al integers unles s otherwise indic ate…
SIPLACE GEM for S25HM, S27HM, HS50 , HS60 SW Version GEM 503.02
HOST Interface Manual
Page 56 of 243 ©Siemens AG, all rights reserved
4 SECS Message Detail
This section describes each message sent or understood by the Equipment.
4.1 SML Notation
Message descriptions are shown using "SECS Message Language" (SML) notation. SML
is a general notation developed by GW Associates for describing SECS messages. SML
is similar to the notation used in the SECS Standards documents, but SML is a more
precise and regular notation. In SML, the format for a data item is as follows:
< type [ count ] value >
The components are:
<> Angle Brackets. Each Data Item is enclosed within angle brackets ("less
than", "greater than"). This notation implies that each Data Item has a
Data Item Format and Data Item Length as required by SECS-II.
type This specifies the SECS-II Data Item format. It will have one of the
following values:
A ASCII
B Binary
JJIS-8
I1, I2, I4, I8 Signed Integers
U1, U2, U4, U8 Unsigned Integers
F4, F8 Floating Point
BOOLEAN True/False
countCount of the element values that make up the item. If present, the count
is enclosed within square brackets "[ ]". The count may be omitted, in
which case the square brackets are also omitted.
The "count" specifies the number of value elements in the Data Item
Value. For String formats (ASCII, Binary, JIS-8), "count" specifies the
number of characters in the string. For Numeric formats (I1, I2, I4, I8, U1,
U2, U4, U8, F4, F8, BOOLEAN), "count" specifies the number of values in
the array. For simple scalar numeric values, "count" is usually "1". For
LIST items, "count" specifies the number of items in the list.
If "count" is omitted, then the length of the Data Item is implied by the
value which follows. The "count" can range between known limits. It may
be specified as minimum and maximum "counts", separated by two dots.
(For example, [0..40]).
value Value of a single item element. Values are shown in a notation that
depends on the item type. For example, ASCII values are shown as
characters enclosed in quotes, Unspecified Binary values are shown in
hexadecimal.
... Ellipsis (...) is used to indicate additional elements may occur, as for
example where substructures may repeat in a List structure.
As an example, a two-byte unsigned integer Data Item with an array of three values 21,
22, and 23 is represented as:
<U2 [3] 21 22 23>
SIPLACE GEM for S25HM, S27HM, HS50, HS60 SW Version GEM 503.02
HOST Interface Manual
©Siemens AG, all rights reserved page 57 of 243
Numeric values shown are considered decimal integers unless otherwise indicated.
negative values shown with a leading minus sign "-". Hexadecimal values are shown in C-
Language convention, with a leading "0x".
10 Decimal Ten
0x10 Hexadecimal 10
-10 Decimal Negative 10
Where a value is not fixed, the SECS variable name is used directly. For Example:
<A [6] SOFTREV>
The format of a complete message is:
SnFn W item .
The components are:
SnFn The Stream and Function Codes, S1F1 for example.
W The W-Bit, if set. Omitted if not set. If the W-Bit is optional, it is coded
within brackets "[W]".
item An item that is formatted as described above.
. A period (.) ends the message definition.
For example, the S1F3 message might be described in SML as follows:
S1F3 W
<L
<U4 13>
<U4 7>
> .
SIPLACE GEM for S25HM, S27HM, HS50 , HS60 SW Version GEM 503.02
HOST Interface Manual
Page 58 of 243 ©Siemens AG, all rights reserved
4.2 Data Item Dictionary
Remarks:
'used in' lists the Events or Variables in which the individual data items are used. Here,
the `x' is used as a substitute for a number of like variables. For example,
PICKINFOREVx stands for: PICKINFOREV1, PICKINFOREV2, PICKINFOREV3 and
PICKINFOREV4
ABS - Any binary string
Format : B
used in : S2F25, S2F26
ACKC5 - Acknowledge Code
Format: B[1]
0 = Accepted
>0 = error, not accepted
1 - 63 reserved
used in : S5F2, S5F73
ACKC6 - Acknowledge Code
Format: B[1]
0 = Accepted
>0 = error, not accepted
1 - 63 reserved
used in : S6F2, S6F3, S6F10, S6F12, S6F14
ACKC7 - Acknowledge Code
Format: B[1]
0 = Accepted
1 = Permission not granted
2 = Length error
3 = Matrix overflow
4 = PPID not found
5 = Mode unsupported
6 = busy
7 = Control state is not „remote“
8 = Control mode is not „GEM-Host“
9 = recipe type is not binary
10 - 63 reserved
used in : S7F4, S7F18
ACKC10 - Acknowledge Code
Format: B[1]
0 = Accepted for display
1 = Message will not be displayed
2 = Terminal not available