background image

Operation

X-317™ Users Manual

5.2   XML Operation

Custom XML computer applications may be created to monitor and control the X-317. This method 
does not use a web browser.  Diagnostics.xml is available for troubleshooting and system 
monitoring.  With XML, the analog output values are the “user units” values which are subsequently 
processed by the Y=mX+b equation to drive the digital to analog converter.  The XML data values 
are not the raw output to the digital to analog converter.  As such, the values are in easy to use 
engineering units such as percent (%), feet per minute (fpm) etc as defined in the 

Analog Output 

tab.

5.2.1   XML Monitoring

The state of the analog outputs can be monitored by sending a request to port 80 (or port specified in 
setup). This can be demonstrated by entering the following URL into the address bar of a web browser 
(substituting the IP address as necessary): 

http://192.168.1.2/state.xml

The following state.xml page is returned:

<datavalues>
<an1state>0.0000</an1state>
<an2state>0.0000</an2state>
<an3state>0.0000</an3state>
<an4state>0.0000</an4state>
<an5state>0.0000</an5state>
<extvar1>0.00</extvar1>
<extvar2>0.00</extvar2>
<extvar3>0.00</extvar3>
<extvar4>0.00</extvar4>
<serialNumber>00:0C:C8:00:00:78</serialNumber>
<reloadPage>0</reloadPage>
</datavalues>

The numbers enclosed by the tags, 

<tag>

, indicate the current analog output value. Values for each tag 

are described in the table below. XML computer applications will open a TCP/IP socket with the X-317 
and send a 

GET

 command followed by the state.xml command string. 

XML Tags*

Monitor Values

<anXstate>

The current analog output value 

<extvarX>

Value of each External Variable.

<serialNumber>

00:00:00:00:00:00, serial number of the X-317.

<reloadPage>

* 'X' is replaced by the 

analog channel or extvar number

.

Page 40

Xytronix Research & Design, Inc.

Содержание ControlByWeb X317

Страница 1: ......

Страница 2: ...X 317 Users Manual X 317 User Manual Revisions Revision Description 1 0 Initial release 1 1 Minor grammatical cleanup 1 2 Changed Modbus addressing Page 2 Xytronix Research Design Inc...

Страница 3: ...porary IP Address to Configuration Computer 15 2 6 2 Method 2 Assign a Temporary IP address to the X 317 19 Microsoft Windows Instructions 19 Linux Unix Instructions 19 Mac OS X Instructions 20 Sectio...

Страница 4: ...the Internet 53 Appendix D BASIC Scripts 57 Line Format 57 LET 58 IF THEN ELSE END IF 58 FOR TO NEXT 58 DO WHILE LOOP 58 END 58 CALL 58 SUB END SUB 58 REM or 59 PRINT 59 Timer Variables 59 Analog Outp...

Страница 5: ...X 317 Users Manual Limitation 66 Appendix I FCC Statement 67 Warning 67 Notice 67 Section 6 J Mechanical Dimensions 68 Xytronix Research Design Inc Page 5...

Страница 6: ...o operate as a peripheral for other devices such as a programmable logic controller PLC or the X 600M The X 317 has five precision 16 bit digital to analog converters DACs Each channel can be programm...

Страница 7: ...onverter This allows the user to control the output device using familiar and descriptive engineering units The internal calculations are made with a linear slope and offset equation Y mX b With the d...

Страница 8: ...en Power LED indicator is illuminated whenever the module is powered I O Indicators The four yellow LEDs indicate the output alarms Alarm Condition Yellow LED s Power Up All four yellow LEDs are momen...

Страница 9: ...d web browser This allows users to access the unit with NO SPECIAL SOFTWARE installed on their computer This is ideal for applications that require a quick simple solution that does not need to be acc...

Страница 10: ...o the X 317 and access other devices on your local network The simplicity of the X 317 makes it an inherently secure device Nevertheless as with any device installed on a network appropriate security...

Страница 11: ...ure to the DIN Rail and then snap the bottom hook into place To remove the X 317 from the DIN Rail use a flat head screwdriver Insert the screw driver into the notch in the release tab and pry against...

Страница 12: ...om Analog Ground Common ground for analog outputs Isolated from Vin Aout4 Analog Output 4 0 5V 0 10V 5V 10V 4 20mA Com Analog Ground Common ground for analog outputs Isolated from Vin Aout3 Analog Out...

Страница 13: ...ly connected together Current Output connections Some actuators are designed to respond to a change of DC current instead of the voltage levels To use these devices the Aout and Com outputs are connec...

Страница 14: ...ort on a computer using a crossover cable Otherwise for connection through a hub or router a standard straight through cable should be used The X 317 can be used on a wireless network by connecting th...

Страница 15: ...d on the network with the same factory default IP address at the same time If this approach is used be sure to clear the arp cache after disconnecting each unit arp d 2 6 1 Method 1 Assign a Temporary...

Страница 16: ...Installation and Connections X 317 Users Manual 4 Select View network status and tasks 5 Select Change adapter settings Page 16 Xytronix Research Design Inc...

Страница 17: ...nection shown Right click on the adapter for your connection to the internet A drop down box will appear choose Properties to view edit the settings for this internet connection 7 Select Internet Prot...

Страница 18: ...1 50 Type in the subnet mask 255 255 255 0 No need to change the default gateway field Click OK to accept the new settings 9 Open the setup pages by entering the following URL in the address bar of a...

Страница 19: ...example to set the X 317 with serial number 00 0C C8 01 00 01 to 10 10 10 40 the following command would be used arp s 10 10 10 40 00 0c c8 01 00 01 3 Next type ping l 102 new IP address For example i...

Страница 20: ...te IP address format is xxx xxx xxx xxx The serial number can be found on the label on the module board The format is ss ss ss ss ss ss For example to set the X 317 with serial number 00 0C C8 01 00 0...

Страница 21: ...the facility already has an Ethernet infrastructure you can install an X 317 near the actuator s and eliminate any direct wiring to the controls By using existing Ethernet infrastructure the X 317 can...

Страница 22: ...or other complicated interface With the X 317 you can access its internal web page and manually control the outputs The example below shows how to control a conveyor motor from a web page without usi...

Страница 23: ...appear Enter the username and password The default username is admin and the default password is webrelay password is case sensitive 4 1 1 Main Tab This is the initial page that is displayed when set...

Страница 24: ...n IP network require an IP address This is a unique address that identifies each device on the network DHCP Dynamic Host Control Protocol is a mechanism that automatically assigns an IP address to a c...

Страница 25: ...ry DNS server This is used when the X 317 requires DNS services and the preferred DNS server is not available The default setting for this field is 192 168 1 1 HTTP Port The TCP port used for HTTP com...

Страница 26: ...t used for Modbus TCP communications with the X 317 By default this is set to port 502 which is the standard Modbus port It can be set within the range of 0 to 65535 Remote Services Enabled This optio...

Страница 27: ...connection string This field can be set within the range of 1 to 34452 minutes The default setting for this field is 1 minute IP Filter Range 1 and IP Filter Range 2 For additional security the X 317...

Страница 28: ...the connection to the external web server rather than the web server initiating communications to the X 317 This has two main benefits First the web server does not need to know the IP address of the...

Страница 29: ...be changed Enable Control Password The Control Page can be viewed without entering a password For security purposes a password can be required for access to the Control Page When this field is set to...

Страница 30: ...g with the best dynamic range For example for an actuator with a 2 to 10V input select the 0 10V output range For this example selecting 10V would waste one half of the available dynamic range and hav...

Страница 31: ...and offset settings with the data entered The settings are made by entering two data points X1 Y1 and X2 Y2 The slope is calculated as Y2 Y1 X2 X1 The Y1 and Y2 output values must be within the range...

Страница 32: ...ode Settings 0V to 5V 0V to 10V 5V to 5V 10V to 10V 4mA to 10mA State at Power Up This setting sets the analog output value when the X 317 is powered up This value is not processed or scaled and must...

Страница 33: ...n ASCII standard text file format should be used such as Windows Notepad Programmer s Notepad vi or other text editor that output the file as a txt Rich Text Format rtf used by Microsoft WordPad is NO...

Страница 34: ...react to user input These variables are considered to be floating point numbers just like other variables in the BASIC script The following page is displayed when configuring External Variables Exter...

Страница 35: ...orresponding extVar status Up to 14 characters may be entered here By default this text is OFF with a value of 0 Status 1 Text The text in this field specifies the text that will be displayed when the...

Страница 36: ...be manually refreshed to show the current status of the unit in the control page Refresh Rate When the Auto Refresh Page option is set to Yes this field specifies the time interval in seconds that th...

Страница 37: ...e example above the following control page will be shown Analog 1 Analog value not displayed edit box is not displayed suppressed Analog 2 Analog value not displayed edit box is displayed Analog 3 Ana...

Страница 38: ...s changed from the default the user must use the new IP address Note that if any port is used other than the default port 80 the port must also be included in the request For example accessing the uni...

Страница 39: ...the valid range the setting is automatically forced to the max on min value The display and set fields are typically configured for descriptive user engineering units such as feet meters mph etc These...

Страница 40: ...wing URL into the address bar of a web browser substituting the IP address as necessary http 192 168 1 2 state xml The following state xml page is returned datavalues an1state 0 0000 an1state an2state...

Страница 41: ...rompted for a password If the XML request is sent from an XML application the html request will need to contain the password encoded as Base64 The following is an html request header without the passw...

Страница 42: ...evicePowerUpFlag Loss of power to the device is indicated by 1 A value of 1 means the X 317 has lost power at least one time since the flag was set to 0 By default the flag value is 1 It is not automa...

Страница 43: ...the following function codes Code Name Modbus Function X 317 Address Data Type Read Holding Registers 03 0x0510 to 0x0518 32 bit Write Multiple Registers 16 0x0510 to 0x0518 32 bit Multiple commands...

Страница 44: ...iscrete is a binary or boolean value 1 or 0 Function codes memory types and addresses can be converted to the PLC addressing equivalent using the table below To use the table look up the row correspon...

Страница 45: ...e same regardless of the addressing mode Function Code Address Data Size PLC Address Mode 485 PLC Address Mode 584 984 Read Analog Out 1 03 0x510 32 bit Float 5297 41297 Read Analog Out 2 03 0x512 32...

Страница 46: ...se Each value is returned as two registers in IEEE 754 floating point formats The four data bytes are treated as two individual big endian 16 bit words with the least significant word being sent first...

Страница 47: ...ent 0x0001 Protocol Identifier 2 bytes Zero for Modbus TCP 0x0000 Message Length 2 bytes Number of bytes in frame below 0x0003 Unit Identifier 1 byte Slave Address 0xFF if not used 0xFF Function Code...

Страница 48: ...tifier 1 byte Slave Address 0xff if not used 0xFF Function Code 1 byte Write multiple registers 0x10 Start Address 2 bytes Start Address 0x0510 Quantity of registers 2 bytes Quantity of registers 0x00...

Страница 49: ...lient 0x0001 Protocol Identifier 2 bytes Zero for Modbus TCP 0x0000 Message Length 2 bytes Number of bytes in frame below 0x0003 Unit Identifier 1 byte Slave Address 0xff if not used 0xFF Function Cod...

Страница 50: ...conductive object such as a toothpick to press and hold the small button located on the bottom of the unit When the object is inserted a tactile feedback can be felt as the button is depressed 3 Whil...

Страница 51: ...site Only an X 317 image can be installed on the X 317 so make sure the correct image is being downloaded 2 bootloader exe will connect to the X 317 using default IP address 192 168 1 2 not the addres...

Страница 52: ...Continue to hold the reset button for the next step 4 While holding the reset button press the Upload Firmware button at the bottom of the ControlByWeb Programmer window After the programming process...

Страница 53: ...e 192 168 200 167 is an IP address Every device that is directly connected to the Internet uses a public IP address The X 317 can be assigned a public IP address for direct connection to the Internet...

Страница 54: ...onnection is called a Wide Area Network WAN connection Each network connection on the router has an IP address In our example the IP address on the LAN side of the router has an address of 192 168 1 1...

Страница 55: ...TTP port will be changed to port 8000 and the WebRelay port will be changed to 8001 Once the ports are changed in the two ControlByWeb devices the router must be set up for port forwarding Port forwar...

Страница 56: ...ess the setup pages when the port is set to 8000 the following command would be used http 192 168 1 25 8000 setup html To access the ControlByWeb units from the Internet enter the public IP address of...

Страница 57: ...r command For those not familiar with nesting the following is an example of nested FOR loops FOR a 0 to 100 FOR b 0 to 100 NEXT b NEXT a Every program must end with an END statement Subroutines would...

Страница 58: ...e FOR TO statement loops a section of code a predefined number of times The NEXT statement always follows the section of code to be looped The format is FOR variable expression TO expression code to b...

Страница 59: ...sented by single lower case characters ranging from the letter a to the letter j They are always global and stored internally as floating point numbers Variables are defined using the LET statement Ex...

Страница 60: ...input The following example demonstrates this by creating a script that will turn Relay 1 ON if extvar1 equals 1 and turn Relay 1 OFF if extvar1 equals 0 Example Do If extvar1 1 Then Let relay1 1 Els...

Страница 61: ...nd Remote Services Direct Server Control The first approach is for the external server to create a TCP connection whenever it needs to access the X 317 In this case the external server opens the conne...

Страница 62: ...r defined character string configured in the Advanced Network tab The connection string is also sent at the same interval once the connection is open The external server is responsible for closing the...

Страница 63: ...short circuit Voltage Output Inaccuracy 0 2 FSR includes offset error gain error and non linearity error 40 to 65 C Max Load Capacitance 20nF no load 5nF 1K load Current Output Range 4 20mA Current O...

Страница 64: ...ettings Password protection on setup page Yes Password protection on control page Optional Password encoding Base 64 Max password length 13 character Environmental Environment Indoor use or NEMA 4 pro...

Страница 65: ...scanning for any purpose other than the personal use by the purchaser of this product Xytronix Research Design Inc assumes no responsibility for any errors that may appear in this document Whereas re...

Страница 66: ...n The foregoing warranty shall not apply to defects or damage resulting from improper use or misuse unauthorized repair tampering modification improper connection or operation outside the electrical e...

Страница 67: ...he instructions may cause interference to radio communications There is no guarantee however that interference will not occur in a particular installation If this equipment does cause harmful interfer...

Страница 68: ...J Mechanical Dimensions X 317 Users Manual Section 6 J Mechanical Dimensions Page 68 Xytronix Research Design Inc...

Отзывы: