# Native Mode Communications

The In-Sight Native Mode protocol is an ASCII protocol that allows an In-Sight vision system to be controlled from any of the following:

- Custom application programs running on a PC.
- Telnet over an Ethernet network.

The following principles apply to Native Mode commands:

- Basic Native Mode commands are two characters long, plus parameters (if any) and a terminator character.

- Commands that set values return 1 for "success", 0 for "unrecognized command", or a negative number for "failure".
- Commands that get values return various values, depending on the command.

Note:

- You can send a subset of Native Mode commands from any PLC (that allows a generic CIP message) over an EtherNet/IP connection using Explicit Messaging or an SLMP connection using the String Command blocks: Delete File, Get File, Get Online, Get Value, Load File, Set Event, Set Float, Set Online, Set String and Store File. For more information, see Native Mode Commands.

## Basic Native Mode Syntax

The general syntax of a Basic Native Mode command is as follows: [command][parameter][terminator]

- Where [command] consists of two characters. Some Native Mode commands take an optional [parameter].
- The Basic Native Mode command is completed with a [terminator] character. The default terminator is CR + LF (ASCII characters 13 + 10) or NUL (ASCII character 0) when sending Native Mode commands using a telnet connection.

- When you remotely issue a Native Mode command to an In-Sight vision system, the vision system processes the command and then returns a response, consisting of an ASCII string followed by the terminator character.

- Basic Native Mode commands are not case-sensitive. No spaces exist between parameters.

Note:

- Native Mode commands that are executed on a Job (such as Write Job and Delete Job) are included primarily for backwards compatibility.
- The checksum that is used by Native Mode file transfer commands is a standard 16-bit Cyclical Redundancy Check. For more information, see Native Mode Checksum.

## Communicate with In-Sight Vision Systems via Telnet Using Native Mode Commands

Telnet is a built-in Microsoft Windows client that you can use to remotely communicate with the sensor using In-Sight Native Mode commands.

Note: You have to enable Telnet in Windows before you can use Telnet for Native Mode commands. Open Control Panel > Programs and Features. Select Turn Windows features on or off. Check the Telnet Client box, then click OK.

1. Enable the Telnet server for the vision system in In-Sight Vision Suite. Open the Industrial Ethernet utility for the vision system, and check the Telnet Server Enabled checkbox:

2. Open the telnet client application on the remote host.
3. In the telnet application, connect to the vision system by either its Host Name or IP address. If the connection is successful, a "Welcome to In-Sight(tm)" message appears, along with the hardware model number (for example: IS8402M) and the session number.

4. Enter a valid user name and password for the In-Sight vision system. The user name and password you enter must exist in the User List for that vision system. If the logon is successful, the message "User Logged In" appears. The default administrator logon is admin and the password field is empty.

You can also write custom applications that you can run on a remote host to automate the telnet logon process, as well as to send and receive Native Mode data.

Note:

- When you connect through telnet, there is a 30 seconds timeout to login. Once you are logged in, there is no timeout.

- Under typical use, password echo is disabled in the telnet client application for security purposes.

- When using telnet to log on to an In-Sight vision system from a Unix-based platform, the telnet command line must be in the following format:

  > telnet <host> <port>

  where <host> is either the Host Name or IP Address of the In-Sight vision system, and <port> is the remote telnet port (default value: 23).

- You can change the default port on the Industrial Ethernet Configuration utility panel.