LANDSCANTCP/IP communicationsTechnical Guide Programmers Guide Issue 27 March 2013 Language: English MARCOM0232 © Land Instruments International, 2011-2012 VMETEK PROCESS & ANALYTICAL INSTRUMENTS

IMPORTANT INFORMATION - PLEASE READ Health and Safety Information Read all of the instructions in this booklet - including all the WARNINGS and CAUTIONS - before using this product. If there is any instruction which you do not understand. DO NOT USE THE PRODUCT. Safety Signs WARNING Indicates a potentially hazardous situation which, if not avoided, could result in death or personal injury. CAUTION Indicates a potentially hazardous situation which, if not avoided, could result in minor or moderate injury to the user or users, or result in damage to the product or to property. NOTE Indicates a...

Land Instruments International E-Mail: [email protected] E-Mail: [email protected] For further details on all LAND/Ametek offices, distributors and representatives, please visit our websites. Return of Damaged Goods IMPORTANT If any item has been damaged in transit, this should be reported to the carrier and to the supplier immediately. Damage caused in transit is the responsibility of the carrier not the supplier. DO NOT RETURN a damaged instrument to the sender as the carrier will not then consider a claim. Save the packing with the damaged article for inspection by the carrier. Return...

2.9.7 SZV Send Zone Parameter Values 14 2.9.9 SAV Send Alarm Parameter Values 17 2.9.11 SSV Send System Parameter Values 19 2.10.4 Stream Binary Data Commands 27 3.3 Read data from server 42

Service Guide Technical Support This document describes the TCP/IP communications interface to the LSPHD. TCP/IP is based upon socket based communications. Establishing a TCP/IP communications link involves the server (LSPHD) listening for client connection requests on a server listening port (1050). Following the successful creation of a socket between the client and the server the client provides suitable commands as described in the Landscan Protocol to communicate with the server. The Landscan Protocol is described in detail and examples of the appropriate message strings for each command...

Technical Support Service Guide It is the responsibility of the user, when interfacing to the LAND processor, to ensure transmissions were received intact and interpreted as intended and that parameter changes have been accepted. Please allow 6 seconds before attempted reconnections. 2.2 Multiple Clients The LSPHD supports a maximum of four simultaneous client connections. NOTE: It is important that only one LSPHD client is used to change the LSPHD configuration to prevent conflicting client configuration data. 2.3 Reply Code All responses from the processor return a reply code, which conveys...

Technical Support Service Guide 2.5 Parameters The parameters settings are validated by the LSPHD on receipt to be an integer, i.e. a whole number, a floating point value, i.e. with a fractional part or a character string of length. Each individual parameter is checked against the range given in the 'Accepted Values' field. The whole message is rejected if either the format or the range of any individual parameter is invalid. The message is also rejected if the number of parameters is incorrect, either too many or not enough are received. 2.6 Ethernet Message Timing A request for scan line information...

Technical Support Service Guide 2.7 Ethernet TCP/IP Implementation TCP/IP is implemented in the LSPHD using the concept of a socket interface. The LSPHD acts as a server, passively listening for a connection on a selected port. The client can then at any time actively open the connection and establish a channel for communications. Messages can be exchanged whilst the interface remains open. If the LSPHD is removed from service requiring the power to be switched off or if there is a mains supply failure then the client must attempt to re-establish that connection indefinitely until the unit is...

Technical Support Service Guide 2.8 Commands & Responses This type of message can be used by the Master to initiate communications with the LAND LSPHD and checks that it is communicating properly and its current condition. It is the simplest message, and takes the form of a Hello command with an Answer response. The response returns the system reply code followed by the unit identity code. It is recommended that this message precedes any other message. SYSTEM INTEGRITY CHECK Land Processor (Validate integrity) Send Hello Verify the identity of the ReSpond with AnSmr Respond with system...

Service Guide Technical Support 2.9 Configuration Setup This type of message allows interrogation and configuration of the processing parameter settings secured within the LSPHD's non-volatile memory. Groups of functionally similar parameters within the LSPHD are handled by individual messages. 2.9.1 Set Parameters Commands These commands can be used to configure the parameter group within the LSPHD. The LSPHD will reply with an acknowledgment after the data changes have been validated and any new settings have been secured to non-volatile memory. If this process is not completed successfully...

Service Guide Technical Support SYSTEM PROCESSOR PARAMETERS Land Processor (Validate integrity) Send Hello Verify the identity of the processor by recognising its unique identity number. Interpret the reply code to validate the system integrity. A reply code of 0 indicates a healthy processor. Respond with Answer Respond with system integrity and unit integrity If the reply code and unit Set Parameters identity are OK, contruct the message according to this document and send the selected parameter settings to the processor Check that the reply code 0, to indicate a sucessful update Check the...

Service Guide Technical Support 2.9.2 Get Parameter Commands This type of command message can be used to instruct the LSPHD to return the requested parameter group values and transfer the information back to the process computer. This is used to verify that parameter changes made using the 'set parameter' message have been successful by reading back the same parameters which were previously written. PROCESSOR PARAMETERS Land Processor (Validate integrity) Send Hello Verify the identity before changing the processor configuration Respond with Answer Respond with system integrity and unit integrity...