00193786-02 - 第64页
S I P L A C E G EM S W V e r s i on G EM 505 . 03 SP 1 H O S T I n t e r f a c e M anua l P age 64 o f 241 ©S i e m en s A G, a ll r i gh t s r e s e r v ed Nu m e r i c v a l ue s s ho w n a r e c on s i de r ed de c i …
SIPLACE GEM SW Version GEM 505.03 SP1 HOST Interface Manual
©Siemens AG, all rights reserved page 63 of 241
4 SECS Message Detail
This section describes each message sent or understood by the Equipment.
4.1 SML Notation{XE "SML Notation "}
Message descriptions are shown using "SECS Message Language" (SML) notation. {XE
"SML"}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
J JIS-8
I1, I2, I4, I8 Signed Integers
U1, U2, U4, U8 Unsigned Integers
F4, F8 Floating Point
BOOLEAN True/False
count Count 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 SW Version GEM 505.03 SP1 HOST Interface Manual
Page 64 of 241 ©Siemens AG, all rights reserved
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 SW Version GEM 505.03 SP1 HOST Interface Manual
©Siemens AG, all rights reserved page 65 of 241
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,
PICKUPINFOx stands for: PICKUPINFO1, PICKUPINFO2, PICKUPINFO3 and
PICKUPINFO4
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