Specifications

BASIC commands
PROGRAMMING MANUAL 87
Revision 5.0
3.2.123 FINS_COMMS
/i
Type Communication command
Syntax FINS_COMMS(type, network, node, unit, remote_area, remote_offset,
length, local_area, local_offset, timeout [, ip1, ip2, ip3, ip4])
Description FINS (Factory Interface Network Service) is a Proprietary OMRON communi-
cation protocol. A subset of this protocol has been implemented in Trajexia.
The FINS protocol has been implemented with the intention of enabling
seamless communication with other OMRON devices (PLCs, HMIs, etc.) and
software (CX-Drive, CX-Server, etc.). For more information on FINS commu-
nication protocol, see section 4.2.2 and the Communication Commands Ref-
erence Manual, cat. num. W342-E1, Sections 3 and 5.
Trajexia has built in FINS client capabilities, so it can initiate the FINS commu-
nications with FINS slave devices using FINS_COMMS. Only FINS 0101
(Read Memory) and FINS 0102 (Write Memory) commands are implemented
at the moment of this writing. With FINS 0101, memory can be read from
other devices with FINS server capability. FINS 0102 can be used to write
data to devices with FINS server capability.
This command returns one of the following values, depending on outcome of
the execution:
-1: The command executed successfully.
0: The command failed.
1: Request not sent because the client or the FINS protocol is busy.
2: One or more of the request parameters are invalid.
3: Invalid source memory area.
4: Request was sent, but no response from remote server received within
timeout period.
5: Error response code received from remote server.
Arguments • type
The type of the FINS command. 0 means FINS 0101, read memory from
remote FINS server. 1 means FINS 0102, write memory to the remote
server.
• network
The destination network. For more details, see the Communication Com-
mands Reference Manual, cat. num. W342-E1, Section 3.
• node
The node of the destination FINS server. For more details, see the Com-
munication Commands Reference Manual, cat. num. W342-E1, Section
3.
• unit
The unit number of the destination FINS server. For more details, see the
Communication Commands Reference Manual, cat. num. W342-E1,
Section 3.
• remote_area
The area of memory accessed on the destination FINS server. Range:
128..255. Note that this area must be one of the following values if the
destination is another Trajexia system: 0xB0: Integer VR value; 0x82:
Integer TABLE value; 0xC2: float TABLE value.
• remote_offset
The memory offset on the destination FINS server. Range: 0..65535.
Note that this range will be more limited to the maximum TABLE or VR
addresses if the destination is another Trajexia system.
• length
The number of items to be transferred. The range will depend upon the
FINS frame length and the capabilities of the client and remote servers.
The range for a Trajexia system is from 1 to 700 integer values, or 1 to
350 floating point values.
• local_area
The local (source) memory area. Note that this area must be one of the
following values: 0x00: Integer VR value; 0x01: Integer TABLE value;
0x02 : float TABLE value.