Home

ENET-UM527 - Literature Library

1. 4 Install a power supply and other modules 5 Close all the DIN rail latches 6 Obtain an IP address For more information see chapter 2 Publication ENET UM527E EN P October 2006 Getting Started 19 System Requirements Browser Requirements The following table describes browser requirements for specific tasks related to the Enhnaced Web Server module To You Need Access web pages generated by the Any standard web browser Enhanced Web Server module Create and edit data view web pages on the Internet Explorer 5 5 or 6 with XML support Enhanced Web Server module View sample code Internet Explorer 5 5 or 6 Display Size The supported display size is 640 x 480 or greater Smaller display sizes work but might require extensive scrolling to view the information Access the Module Using Use the following steps to access your EWEB module using you web b Your Web Browser oor 1 In the address field of your web browser enter the IP address of the module to access the module s home page 4M Rockwell Automation Microsoft Internet File Edit View Favorites Tools Help _ Explorer provided by Rockwell Automation Specify the IP address of the web Heak gt O A A Qsean S Sere server module in the Address _ gt Address http 10 88 61 6 window of your web browser Allen Bradley EV ESAE AS CIE
2. Data Type Style Description SockAddr Family INT Decimal 2 for IP4 family Port INT Decimal Port number Addr DINT Hex Local IP 0 BufLen DINT Decimal Bu SINT 480 Decimal we where Element Element Description FromAddr structure A user defined structure that contains the address to read Family INT Contains the address family Must be 2 Port INT Contains a local port number Addr DINT Contains an IP address BufLen DINT Contains the number of bytes of data received Buf SINT array Contains the data Considerations See Programming Considerations on page 135 for more information Publication ENET UM527E EN P October 2006 Socket Interface 151 Write Parameter Value Service Type Write Service Code 4e Class 342 Instance from CreateSocket Attribute 0 The Write service sends data on a socket You specify the number of bytes to send The Write service attempts to send the requested number of bytes and returns the number of bytes sent MSG Configuration Parameters To call this service click Ll in the MSG instruction and enter the values displayed below Message Configuration WriteMSGO Configuration Communication Tag Message Type cP Generic z Service fWriteSocket v Source Element Sockw riteParams 0 Type Source Length 232 t Bytes Service e a2 Code 4e Hex Class 342 Hex Destination Sock writeResponse Di In
3. H __ The response is returned to the lt controller as soon as the data is sent Read a Send Data To Data xyz n 10 10 10 10 Port 49100 Read Response lt a 10 10 10 11 Port 49200 Data xyz Publication ENET UM527E EN P October 2006 Socket Interface 131 Typical Sequence of Transactions For UDP With OpenConnection The following diagram shows a typical sequence of socket interface transactions for UDP communications when using the OpenConnection service to specify the destination address Each transaction between the Logix controller and the web server is a MSG instruction The following is a typical sequence of transactions The exact sequence of sending and receiving data depends on the application protocol Logix Web Server Module controller 10 10 10 10 CreateSocket Port 49100 gt CreateSocket lt 4 Response Instance 102 re Ss __ sOOpeenConnection 10 10 10 11 Port 49200 OpenConnection ___ lt A i Response EEEE EN Write Data abc Data abe oe Write Response The response is returned to the controller as soon as the data is sent Read p q Data xyz Read Response oa 10 10 10 11 Port 49200 Data xyz Device 10 10 10 11 Receive Data From Port 49200 Send Data To 10 10 10 10 port 49100 Publication ENET UM527E EN P October 2006 132 Socket Interface Communicate With the In Logix
4. Reproduction of the contents of this manual in whole or in part without written permission of Rockwell Automation Inc is prohibited Throughout this manual when necessary we use notes to make you aware of safety considerations Identifies information about practices or circumstances that can cause an explosion in a hazardous environment which may lead to personal injury or death property damage or economic loss Identifies information that is critical for successful application and IMPORTANT understanding of the product Identifies information about practices or circumstances that can lead to personal injury or death property damage or economic loss Attentions help you identify a hazard avoid a hazard and recognize the consequence ATTENTION TU avai Labels may be located on or inside the equipment for example a drive or motor to alert people that dangerous voltage may be present PTT avai Labels may be located on or inside the equipment for example a drive or motor to alert people that surfaces may be at dangerous temperatures gt gt eiie Allen Bradley ControlLogix RSLinx and TechConnect are trademarks of Rockwell Automation Inc Trademarks not belonging to Rockwell Automation are property of their respective companies Summary of Changes This document describes how to use the EtherNet IP Web server module Revision bars in the margin identify updated information Changes for
5. x lt XK user web xmlSample htmi Administrators Group Administrators add RA System Access Limits M Hide systern Access Limits Restore Default System Limits 4 ES Done Internet This method updating the data view is geared toward programmatic updates When an external application that loads a data view wants to change values in that data view the application can post a modified version of the data view to a special URL on the web server module 1 Load the XML data view from its URL for example user Web system dataviews myview xml 2 Systematically modify the values of any tags 3 Remove any tags that were not modified from the XML document 4 Either post the XML file as a file attachment or include its contents in a parameter named xml posted to the URL of the data view iteself 5 Include a redirect parameter to direct a user to a page showing an up to date copy of the data view being modified Consider e Only tags marked as Write or Administrator can be changed All changes to the values of Read tags are ignored e When the program posts an update to the data view it must present the same user authentication that was necessary to initially load the data view e Any errors in the XML whether valid Gn XML manipulations of the original document or malformed XML content return an HTTP error to the client program
6. 88 Access Files in the Web Server Module Back Up Files You must have Administrator access to back up files To back up files that reside on the web server module 1 Select Administrative Settings gt Server Management gt Backup Restore and click Lock Site to lock access to the web server module You must lock access to the web server module to gain FTP access to the user directory The web server module asks to confirm that you want to lock the site Microsoft Internet Explorer x C This will disable normal web site operation CIP performance may also be impacted cmi This automatically enables FTP access to the web server module 2 Click the link to the web server module This appears on the locked backup restore page Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation 8 xi File Edit View Favorites Tools Help Ea EBak gt A A Asearch Favorites CBristory B Sp w ES Address http 10 88 81 6findex htl G0 Links gt Allen Bradley EA E EA Cae EA evel cred maaa Backup Restore In Progress The administrator has temporarily disabled this site to perform a backup or restore process All diagnostics and data views are unaccessable until the backup restore process is complete To perform a backup use FTP to copy files out of the user directories To perform a restore use FTP to copy files into the user Mrecto
7. Ethemet Address MAC 00 00 BC 21 1 20 14 IPAddess 10 88 98 Q Hostname l Description Cancel Enter the IP address of the module You can also enter the host name and a description of the module Click OK The device is added to the Relation List Clear History Add to Relation List Ethemet Address MAC IP Address 8 12 32 DHCP 00 00 BC 21 20 14 10 88 98 2 8 12 32 DHCP 00 00 BC 21 20 14 8 12 24 DHCP 00 00 BC 21 20 14 8 12 21 DHCP 00 00 BC 21 20 14 8 12 13 DHCP 00 00 BC 21 20 14 8 11 57 DHCP 00 00 BC 21 20 14 8 11 48 DHCP 00 00 BC 21 20 14 Hostname m Relation List New Delete Enable BOOTP Enable DHCP Disable BOOTP DHCP Ethemet Address MAC Type IP Address Hostname Description 00 00 B0 21 20 14 DHCP 10 88 98 2 r Status Entries Sent 10 88 98 2 to Ethemet address 00 00 B0 21 20 14 1 of 256 5 To permanently assign this configuration to the module highlight the module and click on the Disable BOOTP DHCP button When power is recycled the module uses the configuration you assigned and does not issue a request Publication ENET UM527E EN P October 2006 38 Configure a Network Address For a Web Server Module If you do not select the Disable BOOTP DHCP button on a power cycle the web server module clears the current IP configuration and will again begin sending requests If
8. In the web server module the data view looks like this Z Rockwell Automation Microsoft Internet Explorer 5 xj File Edit Yiew Favorites Tools Help SBak gt O A Qsearch Favorites Ameda A Ay GSE HB Address http 10 88 81 8 index html 7 c Allen Bradley EAAS CME nocne Automation Data Views NU New Data View Y Sample aj Dhome Zi Data views iG Data Views New Data View Diplay Gd Diagnostics Decimal Administrative Settings Device Configuration User Management Meneses _Updete 5 Edit Access Limits A servar Management Browse Chassis Copyright 2004 Rockwell Automation Inc All Rights Reserved L Send an Email ni Internet Publication ENET UM527E EN P October 2006 Rockwell Automation Microsoft Internet Explorer i File Edit View Favorites Tools Help Create Custom Web Pages 107 This example also requires a custom access level Back gt 2 a Search Favorites meda S D GA4HR D Home Data Views Data Views New Data View Gi Diagnostics Administrative Settings Device Configuration User Management Edit Users Edit Access Limits a soyar Management Browse Chassis L send an Email Address http 81 8 index html x Pc ne F Edit Users Edit Access Limits A Delete Access Limit Group With Access Add an Access Limit fuserfsysleniydalaviews Saniple xial Adininistraturs URL
9. Description The IP address uniquely identifies the module The IP address is in the form XXX XXX XXX XXX where each xxx is a number between 0 255 You cannot use these reserved values e 127 0 0 1 e 0 0 0 0 e 255 255 255 255 Subnet mask Subnet addressing is an extension of the IP address scheme that lets a site to use a single network ID for multiple physical networks Routing outside of the site continues by dividing the IP address into a net ID and a host ID via the class Inside a site the subnet mask is used to redivide the IP address into a custom network ID portion and host ID Gateway A gateway connects individual physical networks into a system of networks When a node needs to communicate with a node on another network a gateway transfers the data between the two networks Publication ENET UM527E EN P October 2006 32 Configure a Network Address For a Web Server Module Ethernet Parameter If you use the module to initiate MSG instructions that use host names or to initiate emails you must also define these parameters Description Host Name A host name is part of a text address that identifies the host for a module The full text address of a module is host_name domain_name Domain Name A domain name is part of a text address that identifies the domain in which the module resides The full text address of a module is host_name domain_name The domain name has a 48 character limit If you specify
10. POST gt lt input type hidden name path value 1 1 gt lt input type hidden name service value 5 gt lt input type hidden name class value 1 gt lt input type hidden name instance value 1 gt lt input type hidden name attribute value gt lt input type hidden name member value gt lt input type hidden name data value gt lt input type hidden name Cconnected value false gt lt input type submit name submit value RESET gt lt form gt lt body gt lt html gt Publication ENET UM527E EN P October 2006 Chapter 9 About This Chapter Web Server Module Diagnostics Monitor Diagnostics The web server modules provide several levels of diagnostics There are user oriented diagnostics as well as more detailed diagnostics for technical support personnel This chapter describes the diagnostics presented on the user oriented diagnostic pages Topic Page Web Server Module Diagnostics 113 Diagnostics Overview 114 Network Settings 116 Message Connections 117 Ethernet Statistics 119 The web server module provides four diagnostic pages of user oriented diagnostics Topic Access This Web Page Overview of the current configuration of the web server module Diagnostics gt Diagnostic Overview Summary of the network settings configured for the web server module Diagnostics gt Network Settings Statistics about
11. Server Management page User Management page Send Email page In Data Views the access limits you specify for a tag applies to the whole data view not just the tag If you have multiple tags with different access levels in the same data view the web server assigns the highest most access level to the data view For more information see chapter 3 If you develop custom web pages you must explicitly specify the access limits for the page if you want access protection Otherwise the custom web page will have no access limits You need Administrator access to modify access limits for web pages You specify the access limit for a web page by selecting Administrative Settings gt User Management gt Edit Access Limits E Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation Manage User Accounts and Access Levels 79 You can change the default access limits for the predefined web pages or you can add pages to the protection list such as custom web pages The Edit Access Limits page shows the current list of pages the user has selected for protection The predefined pages though they have default protection do not show up in the list l l xi File Edit View Favorites Tools Help Back At search Favorites Bristory hy A Address http 10 88 81 6findex html Go Links Allen Bradley GY ESEAS eluate Home Gi Data Views C
12. Then click this button to display the String 1756EWEB demo COM r 1 This is a test Browser so you can enter the email text Srs1 Position 65 Count 65 of 520 L Enos _ gt gt ca w ee The text of the email does not have to be static You can program a controller project to collect specific data to be sent in an email For more information on using ladder logic to manipulate string data see the Logix5000 Controllers Common Procedures Programming Manual publication 1756 PM001 Enter the Ladder Logic Add the MSG instruction that triggers the email Execute this email MSG instruction as often as needed trigger SG Type CIP Generic Message Control SendEmail_EvVEB Publication ENET UM527E EN P October 2006 Send Email 73 Configure the MSG Instruction Use the following process configure the MSG instruction that contains the email text Click to view the Message Configuration dialog trigger Type CIP Generic Message Control On the Configuration tab of the MSG instruction configure the MSG parameters for sending an email Message Configuration SendEmail_EWEB Configuration Communication Tag Message Type CIP Generic v The Source Length is the number of characters in the TE Custom Source Element EWEB_EMAIL 7 email tag plus 4 characters Bp Source Length 69 2 Bytes Service ab Ba In thi le th il nsG5th Code Ab ess Mazs E Hes Destination EmailDst
13. Whether the port speed and duplex mode were determined via autonegotiation or whether they were manually configured Interface Counters In Octets Octets received on the Ethernet interface In Ucast Packets Unicast packets received on the Ethernet interface In NUcast Packets Non unicast packets received on the Ethernet interface In Discards Inbound packets received on the Ethernet interface but discarded In Errors Inbound packets that contain errors does not include In Discards Publication ENET UM527E EN P October 2006 120 Monitor Diagnostics This Field Specifies In Unknown Protos Inbound packets with unknown protocol Out Octets Octets sent on the Ethernet interface Out Ucast Packets Unicast packets sent on the Ethernet interface Out NUcast Packets Non unicast packets sent on the Ethernet interface Out Discards Outbound packets discarded Out Errors Outbound packets that contain errors Media Counters Alignment Errors FCS Errors Frames received that are not an integral number of octets in length Frames received that do not pass the FCS check Single Collisions Successfully transmitted frames which experienced exactly one collision Multiple Collisions Successfully transmitted frames which experienced more than one collision SOE Test Errors Number of times SOE test error message is generated Deferred Transmissions Late
14. oe vo gt H D o n GS 2 m PE 29 a aS feos ETS 2 JZ A S oz g 2 Ha 3 pees ETT puss ay Ae Important User Information Solid state equipment has operational characteristics differing from those of electromechanical equipment Safety Guidelines for the Application Installation and Maintenance of Solid State Controls publication SGI 1 1 available from your local Rockwell Automation sales office or online at http literature rockwellautomation com describes some important differences between solid state equipment and hard wired electromechanical devices Because of this difference and also because of the wide variety of uses for solid state equipment all persons responsible for applying this equipment must satisfy themselves that each intended application of this equipment is acceptable In no event will Rockwell Automation Inc be responsible or liable for indirect or consequential damages resulting from the use or application of this equipment The examples and diagrams in this manual are included solely for illustrative purposes Because of the many variables and requirements associated with any particular installation Rockwell Automation Inc cannot assume responsibility or liability for actual use based on the examples and diagrams No patent liability is assumed by Rockwell Automation Inc with respect to use of information circuits equipment or software described in this manual
15. 00 Publication ENET UM527E EN P October 2006 Function Create Custom Web Pages 99 Javascript Library Conversion js The conversion js library contains six functions To include this library in your custom web page include this line lt script type text javascript src scripts conversion js gt lt script gt TThe conversion js library contains these functions Description The parseStruct function is the main function where parseStruct structStr type stringlength structStr Contains the string returned from the ASP call or a substring thereof beginning at the hex number which starts the value to be retrieved from the string type Indicates the data type to be parsed from the string It should be one of SINT USINT INT UINT WORD DINT UDINT DWORD or STRING stringlength Optional only used when the type to be parsed is a STRING In this case it identifies how many digits of the input string to parse into ASCII characters For example to retrieve the device name from a device in slot 1 of the local chassis var idobj lt CIPMessage 1 1 1 1 1 0 0 0 STRING gt var namelen parseStruct idobj substring 42 idobj length USINT var name parseStruct idobj substring 45 idobj length STRING namelen The Device Name attribute of the identity object instance starts 14 bytes into the GET_A
16. 5m 4 Address http 10 88 81 6findex html Go Links Allen Bradley ENA EA EAS CE Minimize D Home Gi Data Views CA Diagnostics Administrative Settings Device Configuration 1 device tdentity Network Configuration Device Services Email Configuration Gd User management Server Management Server Settings Backup Restore Browse Chassis L Send an Email Publication ENET UM527E EN P October 2006 Rockwell Automation Server Settings NC backup Restore Time Settings Y Server Log Timestamp URL HTTP Code 2 IP Address Access JAN 15 19 04 37 2004 fserverlog asp 200 131 200 155 114 Administrator JAN 15 19 04 43 2004 frokform webTime 200 131 200 155 114 Administrator JAN 15 19 04 45 2004 frokform webTime 302 131 200 155 114 Administrator JAN 15 19 04 46 2004 frokform webTime 200 131 200 155 114 Administrator JAN 15 19 04 47 2004 fbackupRestore html 200 131 200 155 114 Administrator JAN 15 19 04 49 2004 frokform webManage 200 131 200 155 114 Administrator JAN 15 19 04 53 2004 fidentity asp 200 131 200 155 114 Administrator JAN 15 19 05 09 2004 frokform UpdateldentityInfo 302 131 200 155 114 Administrator JAN 15 19 05 09 2004 fidentity asp 200 131 200 155 114 Administrator Clear Log Copyright 2004 Rockwell Automation Inc All Rights Reserved This Field Timestamp Timestamp of HTTP request access URL Specifies Requested URL on the web server mod
17. 94 Read CIP data CIPMessage 95 CIPMessageUnconnected 96 Retrieve information about the module GetSetting 97 Publication ENET UM527E EN P October 2006 94 Create Custom Web Pages Read Controller Tags There are two ASP functions you can use to read controller tags If You Want Use This ASP Function See Page Connected messaging ReadLogixTag 94 Unconnected messaging ReadLogixTagUnconnected 94 Function Parameters Parameter path ReadLogixTag path tagname tagtype The ReadLogixTag function connects to a controller at a specified path retrieves the value of a tag with a name tagname and of tagtype Description The path is a CIP path with no spaces and segments separated by commas For example Path Example Description 1 3 1 backplane 3 slot 3 tagname The tagname identifies a controller scoped tag tagtype Example Function Publication ENET UM527E EN P October 2006 The tagtype must be an atomic type BOOL SINT INT DINT REAL or string Use standard dot notation to specify a member of an array or a user defined structure for example timer1 ACC for the accumulator of a timer tag named timer1 For example retrieve a DINT tag named my_dint_tag from a controller in slot 3 of the local chassis lt p gt my_dint_tag value lt ReadLogixTag 1 3 my_dint_tag DINTI gt lt p gt ReadLogixTagUnconnected path tagname tagtype Th
18. Collisions Frames for which first transmission attempt is delayed because the medium is busy Number of times a collision is detected later than 512 bit times into the transmission of a packet Excessive Collisions Frames for which transmission fails due to excessive collisions MAC Transmit Errors Frames for which transmission fails due to an internal MAC sublayer transmit error Carrier Sense Errors Frame Too Long MAC Receive Errors Times that the carrier sense condition was lost or never asserted when attempting to transmit a frame Frames received that exceed the maximum permitted frame size Frames for which reception on the Ethernet interface failed due to an internal MAC sublayer receive error Publication ENET UM527E EN P October 2006 Appendix A About This Appendix CIP Connections Use the Web Server Module To Connect Over Ethernet A connection is a communication association between two devices The web server modules uses different types of communications connections Since connections use internal module resources the web server module has limits on the number of connections it supports This appendix discusses these types of connections CIP connections The web server module uses CIP connections to read data view data to communicate with a module in the local chassis and to communicate with another EtherNet IP module For example CIP connections are used when a Logix control
19. DATATYPES_NAMESPACE http www rockwellautomation com technologies data_access data_types 1 0 var ARR_ACTIVEX MSXML4 DOMDocument MSXML3 DOMDocument MSXML2 DOMDocument MSXML DOMDocument Microsoft XmlDom var STR_ACTIVEX var isIE navigator userAgent toLowerCase indexOf msie gt 1 if isIE var bFound false for var i 0 i lt ARR_ACTIVEX length amp amp bFound i try var objJXML new ActiveXObject ARR_ACTIVEX i STR_ACTIVEX ARR_ACTIVEX i bFound true catch objException if bFound No DOM found so throw a message and go back alert Creating editing a data view requires Internet Explorer 5 5 or greater with XML support Please upgrade your browser or load the appropriate patches to support XML history go 1 else Not IE so throw a message and go back alert Creating editing a data view requires Internet Explorer 5 5 or greater with XML support Please upgrade your browser or load the appropriate patches to support XML history go 1 xmlDoc new ActiveXObject STR_ACTIVEX xmlDoc async false xmlDoc setProperty SelectionLanguage XPath Publication ENET UM527E EN P October 2006 Create Custom Web Pages 105 if STR_ACTIVEX indexOf DOMDocument 1 xmlhttp new ActiveXObject STR_ACTIVEX substring 0 STR_ACTIVEX indexOf DOMDocument XMLHTTP else alert Creating editing a
20. DINT Specify an IP address Typically set to 0 any address Publication ENET UM527E EN P October 2006 Select the data type you created in the Source Element field of the Message Configuration dialog MSG Source Length Specify the size of the user defined structure for the Source Element In this example CreateParams is 12 bytes MSG Destination Element The MSG instruction returns the instance number of the socket it just created to the Destination Element Specify a DINT tag in this example SockInstance OpenConnection Parameter Value Service Type OpenConnection Service Code Ac Class 342 Instance from CreateSocket Attribute 0 Socket Interface 143 Considerations Use the instance returned by CreateSocket on subsequent service requests Use a MOV instruction to move the instance to another MSG tag the Instance field If you use a local port number that is already in use by the web server you receive an EADDRINUSE error see Error Codes section The web server uses these port numbers e 20 21 FTP e 25 SMTP e 80 HTTP e 123 NTP e 161 SNMP e 2222 EtherNet IP e 44818 EtherNet IP The OpenConnection service does one of the following e Opens a TCP connection with the specified destination address e For UDP associates a destination IP address and port number with the specified socket MSG Configuration Parameters To call this service
21. Hour Min Second 0 a o0 FJ joo E c C Manual Time Entry c Disabled Local Time Offsets Time Zone UTC Coordinated Universal Time Dublin Edinburgh Lisbon London 7 adjust for Daylight Saving Time Update Time at Constant Interval Time Between Updates 1 Minute z Set Controller Wall Clock Controller Slot JO Z I enabled Apply Changes Copyright 2004 Rockwell Automation Inc All Rights Reserved al a Internet to your system Select SNTP Time Server To Get the date and time from an SNTP server on the network Get the time and date from the local Query Controller controller 27 2 Click the radio button to specify the time date source according Manual Time Entry Specify your own date and time For more information see chapter 3 Publication ENET UM527E EN P October 2006 28 Getting Started Enable disable Other Services Use this procedure to enable other services 1 In the organizer select Administrative Settings gt Device Configuration gt Device Services E Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation 8 x File Edit View Favorites Tools Help Ea Sepak gt At Qsearch Favorites CBristory hy Sp B Address http 10 88 81 6findex html Go Links Y Rockwell Allen Bradley EV ESA EAS CE inkGusation Minimize Device Identity X Net
22. MSG is unconnected e ConnectionRate and TimeoutMultiplier if the MSG is connected The MSG timeout is determined by multiplying the ConnectionRate by the TimeoutMultiplier Note TimeoutMultiplier of 0 corresponds to multiplier of 4 1 corresponds to multiplier of 8 and so on Socket Instance Timeouts Each socket instance has an Inactivity Timeout default of 5 minutes If a socket instance receives no service requests for the amount of time specified by the Inactivity Timeout the socket instance is deleted If you then try to use the socket instance the MSG instruction receive the error Class or instance not supported You can change the timeout by setting the Inactivity Timeout attribute via the Set Attribute service See Socket Object Instance Attributes on page 159 If you put the controller in Program mode and then back into Run mode before existing socket instances time out you can receive errors when the program tries to create socket instances Eventually the socket instances time out and you can create more instances IMPORTANT Make sure the Inactivity Timeout is longer than the longest interval between socket operations If the Inactivity Timeout is too short socket instances may time out resulting in MSG instruction errors Publication ENET UM527E EN P October 2006 Socket Interface 135 Programming Considerations Observe these programming considerations TCP Connection Loss Your application progra
23. The web browser accesses the defined web page for the web server module If you specify a custom page as the default home page you can still access the predefined home page by entering http ip_address index html Not configured as the default home page Enter http ip_address user Web my_file html but is copied into the user Web directory The web browser displays any custom file if you specify the complete URL to that file Develop a Custom Web Custom web pages can contain standard web content such as a Page company logo contact information and links to other web pages In addition you can use ASP functions and other features that come with the web server module to display and manipulate live controller data An ASP file is essentially the same as an HTML file with embedded scripting constructs supported by ASP An ASP file has the file extension asp When an ASP file is requested by a browser the web server interprets the ASP file and executes the ASP specific scripts The browser sees only the resulting HTML not the embedded ASP scripts Use See Page ASP function calls Display controller data 93 Javascript libraries Manipulate the controller data returned by ASP function calls 98 Web page forms and POST handlers Change controller data 102 ASP Function Calls The web server module provides these ASP functions To Use This ASP Function See Page Read controller tags ReadLogixTag 94 ReadLogixTagUnconnected
24. a Heak gt search Favorites CBristory hy B Address http 10 88 81 6 index html z co Links Allen Bradley ENA ES EAS CE Automation Minimize D Home Gi Data Views Diagnostics Administrative Settings Device Configuration User Management Server Management Server Settings Backup Restore Time Settings Server Log P Browse Chassis L Send an Email Publication ENET UM527E EN P October 2006 Server Settings N _Backup Restore Time Settings Server Log X Web Home Page custom userAveb mypage htmll 1756 EWEB Default index html Server Port Number 1756 EWEB Default 80 custom Server Log Disabled Enabled i M Timestamp M ur M HTP Code Log Filters M ipaddress M access Apply Changes Copyright 2004 Rockwell Automation Inc All Rights Reserved 5 Determine whether you want to set access limits such as Administrator Write or Read on the custom page Select Administrative Settings gt User Management gt Edit Access Limits page to set access limits on specific pages See chapter 6 for more information Create Custom Web Pages 93 Access Custom Web Pages Once a custom web page is copied into the web server module you can display that page from your web browser If You Custom Web Page Is In Your Web Browser Configured as the default home Enter the IP address of the web server module
25. a DNS server you must enter a domain name Also if you send email from the module some mail relay servers require a domain name be provided during the initial handshake of the SMTP session Primary DNS Server Address This identifies the DNS server s if used in the network You must have a DNS server Secondary DNS Server Address Assign Network Parameters When the Network Has a DHCP Server Publication ENET UM527E EN P October 2006 configured if you specified a domain name or a host name in the module s configuration The DNS server converts the domain name or host name to an IP address that can be used by the network Check with your network administrator to determine if you need to specify all of the above parameters How you configure these network parameters depends on whether the Ethernet network has a DHCP server By default the web server module is DHCP enabled DHCP Dynamic Host Configuration Protocol software automatically assigns IP addresses to client stations logging onto a TCP IP network If you connect the web server module to a network that has a DHCP server that server will assign an IP address to the web server module and the four digit display on the front of the web server module will display each of the four numbers of the IP address In the Address field of your web browser enter the IP address that displays on the front of the module Configure a Network Address For a Web Server Modu
26. and receive data To communicate with another device you must understand the other device s application protocol The web server module has no application protocol knowledge it simply makes the socket services available to programs in Logix controllers Number and Type of Sockets You can create as many as 20 socket instances Each socket instance can be one of these socket types e UDP socket to send receive UDP datagrams e TCP client socket your Logix5000 program initiates the connection e TCP server socket another device initiates the connection to your Logix5000 program e TCP listen socket to listen on a specified port number for incoming connections You must have a listen socket for each TCP port number that accepts connections Multiple TCP server sockets can share a listen socket if the connections are made to the same port number Publication ENET UM527E EN P October 2006 Socket Interface 127 You can partition the 20 available socket instances between UDP and TCP sockets For example e Use all 20 instances for client TCP connections e Use one instance to listen for incoming TCP connections and then accept 19 connections from other device e Perform both TCP client and server operations e Perform both TCP and UDP operations These socket services are available This Socket Service The Socket Instance Is See Page CreateSocket Server or client 141 OpenConnection Client 143 AcceptCon
27. and written over this connection After the module retrieves the data view or updates the data view the module closes the connection If someone changes tag names in the target controller and does not update the tags in the data view the data view will display an error message indicating that the tag was not available Publication ENET UM527E EN P October 2006 Use Data Views to Access Controller Data 61 Edit a Data View Follow this procedure to edit an existing data view 1 Click the edit symbol next to the data view you want to edit 2 Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation 3 la x File Edit View Favorites Tools Help eBak gt A Asearch Favorites CHristory EY SH B Rockwell Allen Bradiey EVA EEAS CE Mitematien Minimize Data Views J Edit Data View j Home E vata views Slot Tag Name Data Type Display As Access Add Edit Data View Data Views inte Decimal E admin name New Data View quick_start_example Gi viagnosti PE tipia Delete Edit Slot Tag Name Data Type Display As Access BLEUE Administrative Settings o 7 example of adding a tag amp ERIE x B 1 TEST DINT Decimal Admin to a new data view X send an Email Save View Cancel Copyright 2004 Rockwell Automation Inc All Rights Reserved At this screen you can add additional tags or edit existing tags 2 To edit an ex
28. browser Using an EWEB module you can monitor and modify control system data remotely using XML web pages Publication ENET UM527E EN P October 2006 14 Getting Started Publication ENET UM527E EN P October 2006 Enhanced Web Server Module Applications The following features and applications are available with your Enhanced Web Server Module e Remote access to controller data using a standard web browser Use a standard web browser to monitor live controller data in two ways use data views that you create in the web server module or custom develop your own web pages For example create a custom web page for managers to monitor production processes directly from their desks Use data views or custom web pages for OEMs to remotely monitor controller data and reduce support costs e Deliver data initiated by the control system System data and information can be sent via email when initiated by a controller in the system The controller uses a message instruction to initiate an email Use the email to notify a maintenance person or an engineer of an alarm or alert so that corrective actions can be done in a timely fashion The system can also send system status or production reports The module supports all email clients such as email applications and text pagers e Share system data with external applications The module stores data in its data views in XML files This generic XML data presentation allows external
29. browser to render the data view page Tags Per Data View Time Per Data View wooo ooms 100 350 ms 1000 3 sec Use Data Views to Access Controller Data 57 Create a Data View Each data view contains a group of tags that you want to monitor Each module can support multiple data views You create a data view by selecting Data Views gt New Data View 1 Use the Create Data View window on the right of the window to enter a data view name required and description optional E Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation la x File Edit View Favorites Tools Help Ea Back gt A A Asearch Favorites Huistory B S w A Address http 10 88 81 6findexhtl Go lsa Allen Bradley EA EEAS CE Autousntion Minimize Data Views Y New Data View Home G vata views Slot Tag Name Data Type Display As Access Add Create Data View D pata views 1 rest DINT Decimal aj admin gt ey Name D nev Data view quick_start_example id Diagnostics ETE a Delete Edit slot Tag Name Data Type Display As Access Description Administrative Settings example of adding a tag Device Configuration to a new data view X a User Management Create View Cancel Server Management eronsa chassis Teena ee Copyright 2004 Rockwell Automation Inc All Rights Reserved 2 Add at least one tag to the data view E Rockwell Automati
30. e display a server log Customize Server Settings Select Administrative Settings gt Server Management gt Server Settings to customize the web home page and server settings of the web server module 2 Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation 8 x Fie Edt view Favorites Tools Help Ea Back gt gt search Favorites CBristory hy 8B Address hetp 10 88 81 6 index html z co Links gt Home Data Views dl Diagnostics Administrative Settings Gd Device Configuration User Management Server Management Server Settings Backup Restore Time Settings Server Log Diareya L Send an Email Minimize Allen Bradley EUA EEAS CE Automation Server Settings N _Backup Restore Time Settings NC Server Log zj Web Home Page 1756 EWEB Default index html custom Server Port Number 1756 EWEB Default 80 custom Server Log Disabled Enabled sda Pavan M Timestamp M ur M HTP Code M IPAddress M Access Apply Changes Copyright 2004 Rockwell Automation Inc All Rights Reserved Publication ENET UM527E EN P October 2006 52 Manage Module Settings In The Field Web Home Page Take This Action Select which home page is the default 1756 EWEB Default index html or select and specify a custom home page address For example a custom web page could be user Web mypage html mypage is t
31. for more information name description location contact1 contact2 These fields as configured on the Administrative Settings gt Device Configuration Device Identity page See page 48 for more information ip_address subnet_mask default_gateway primary_name_server secondary_name_server domain_name hostname obtain_configuration dns_enable smtp_server nu athernet_address autonegotiation port_speed duplex_mode These fields as configured on the Administrative Settings gt Device Configuration Network Configuration page See page 49 for more information nu cpu_utilization file_sys_utilization server_errors server_redirects server_timeouts server_access_violations server_page_hits server_form_hits nu server_total_hits user_free_space server_data_views server_total_tags tcp_conns tcp_conn_limit tcp_max_conns cip_conns cip_conn_limit cip_max_conns cip_conn_opens cip_conn_open_errors cip_conn_closes cip_conn_close_errors cip_conn_timeouts cip_msg_sent cip_msg_rcv cip_ucmm_sent cip_ucmm_rcv The diagnostic information on the Diagnostics Diagnostic Overview page See page 114 for more information Publication ENET UM527E EN P October
32. gt For example OK 10 88 60 196 Duplicate IP 00 00 BC 02 34 B4 To correct this conflict use the instructions in this chapter to change the IP address of the module Then cycle power to the module or reset the module such as disconnecting the EtherNet IP cable and reconnecting the cable There is also the possibility that two modules can detect a conflict simultaneously If this occurs remove the module that has the incorrect IP address or correct its conflict To get the second module out of conflict mode cycle power to the module or disconnect its EtherNet IP cable and reconnect the cable Publication ENET UM527E EN P October 2006 42 Configure a Network Address For a Web Server Module IP Address Swapping DNS Addressing Publication ENET UM527E EN P October 2006 Duplicate Detection Scenarios The behavior of devices that are in conflict over an IP address varies depending on whether connections have been established to either of the modules and whether both modules support duplicate IP address detection If Both modules support duplicate IP address detection Then The module that powers up first and uses the IP address keeps the IP address The other module will detect a conflict give up the IP address and enter conflict mode Both modules support duplicate IP address detection and both modules power up at roughly the same time Both modules give up the IP address and enter conflict mode
33. in a readable ASCII format It contains the tag name data type path display formatting and privilege access level Each tag value is exposed as a separate element and an error attribute is optional Publication ENET UM527E EN P October 2006 56 Use Data Views to Access Controller Data Publication ENET UM527E EN P October 2006 Tags Supported In Data Views To configure tags in data views e You can only access tags in controllers that reside in the local chassis same chassis as the web server module Tags must be controller scoped Tags must be an atomic type BOOL SINT INT DINT REAL STRING You can specify a member of a structure or an array but you cannot specify an entire structure or array BOOL arrays are not supported A tag can appear only once in a particular data view You cannot for example have two instances of the same tag with different display formats There is no limit to the number of data views as long as the total number of entries in all data views on one web server module does not exceed 2500 entries Each tag you configure on a data view is one entry If you configure the same tag in multiple data views each tag is considered one entry Performance Estimates For access to the XML data views the module can produce data according to the values listed in this table This table assumes the absence of significant CIP traffic and does not take into account the amount of the time for the
34. input type hidden name t_1_changed value 1 gt lt input type hidden name t_1_value value 0 gt lt Read the current tag value gt lt font color lt ReadLogixTag 1 1 test_tag_string STRING gt gt lt SReadLogixTag 1 1 TEST DINT gt lt font gt lt input type submit name submit value Clear Alarms gt lt form gt lt body gt lt html gt Publication ENET UM527E EN P October 2006 110 Create Custom Web Pages ACTION rokform ReadLogixTag This method performs an instant data table read The response is an HTML stream The form accepts these parameters Input Description Path Path to the data such as 1 1 Name Name of tag you want to read Tag names are case sensitive Type Any of the following types BOOL SINT INT DINT REAL or STRING Connected For an unconnected request enter one of the following optional FALSE false F f 0 NO no OFF off For a connected request enter one of the following TRUE true T t 1 YES yes ON on For example lt html gt lt head gt lt meta http equiv Content Type content text html charset windows 1252 gt lt script language JavaScript gt function post document getElementById submitit submit lt script gt lt head gt lt body onload post gt lt form action rokform ReadLogixTag id submitit method POST gt lt input type hidden n
35. messages initiated by the web server module and their associated connections Diagnostics gt Message Connections Ethernet statistics Diagnostics gt Ethernet Statistics Publication ENET UM527E EN P October 2006 114 Monitor Diagnostics Diagnostics Overview The Diagnostics gt Diagnostic Overview page presents a summary of the current configuration and overall status of the web server module This summary includes e Ethernet configuration e Web server file use e Web server statistics e TCP connection use e CIP connection use e Message statistics Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation J l x Fie Edt View Favorites Tools Help Back gt O A A Qsearch Favorites lt Bristory G3 Sp fia Address hetp 10 88 81 index html so Links Allen Bradley Rockwell Web Server Example Mutaneatiot Expand Cine Cisgnostic Overview N Network Settings NC Message Connections NU Ethernet Statistics D Home Ed Data views Ethernet Link TCP Connections CIP Diagnostics Speed 100 Mbps Current TCP Connections o Diagnostic Overview Duplex Half Duplex TCP Connection Limit 64 Network Settings stiate S Obs g Autonegotiate Status Autonegotiate peed and Maximum Observed o Message Connections AIPE Ethernet Statistics CIP Connection Statistics Advanced Diagnostics Syrian Revource Uiire ton Current CIP Connecti
36. of symbolic links 65 41 EHOSTUNREACH No route to host 66 42 ENOTBLK Block device required 67 43 EHOSTDOWN Host is down 68 44 EINPROGRESS Operation now in progress 69 45 EALREADY Operation already in progress 70 46 EWOULDBLOCK Operation would block 71 47 ENOSYS Function not implemented Errors for any of the Socket Object calls not covered by CIP general status codes contain a general status code of OxFF Object Specific General Error and an extended status code The extended status codes are standard error codes returned by common socket API implementations Additional information can be found on the Internet or in socket API programming guides Publication ENET UM527E EN P October 2006 Socket Interface 157 Socket Attributes If You Want To Change an attribute value for a socket You access these attributes by configuring the CIP Generic MSG instruction to get or set the specific attribute Use This CIP Generic MSG Type SetAttribute Message Configuration SocketLogMSG Configuration Communication Tag Message Type Type Instance 0 Service Set Attribute Single x Servi i raat 10 Hex Class 342 Hex ttribute 8 Hex CIP Generic i Source Element SocketLogEnable z Source Length 4 Bytes New Tag Get a socket value If You Want Attribute Information For All sockets GetAttribute Configuration Communication Tag Message Type Instance 0 Me
37. protocol dictates that all messages are 100 bytes then you must issue additional Reads until you receive 100 bytes If the application protocol uses variable size messages your program needs additional logic to handle variable message sizes as defined by the application protocol When issuing multiple Read services be careful to adjust the destination tag that receives the data so that data is not overwritten This fragment of Structured Text logic shows an example of handling a partial Read service copy the message we just read COP ReadResponse Buf 0 ReadBuf CurrentLen ReadResponse BufLen CurrentLen CurrentLen ReadResponse BufLen do we need to read more data get a complete message if CurrentLen lt ApplicationMsgLen then issue another read ReadParams BufLen ApplicationMsgLen CurrentLen MSG ReadMSGO end_if Publication ENET UM527E EN P October 2006 138 Socket Interface Publication ENET UM527E EN P October 2006 Partial Writes Your program may need to handle the situation although uncommon where the Write service is unable to send all the specified bytes Such a situation can occur if the Write service is called multiple times before the target application can receive the data If the Write service is not able to send all of the requested data your program should issue subsequent Writes to send the remaining data Your program should also adjust the s
38. server module Important For security purposes keep FIP disabled unless you frequently transfer files to or from the web server module SNMP SNMP Simple Network Management Protocol agent Enable SNMP if your system uses SNMP management software SMTP SMTP Simple Mail Transfer Protocol agent SMTP manages email capability Disable SMTP if you do not send emails from the web server module CIP Bridge Ethernet to Backplane CIP Common Industrial Protocol bridging Enable this CIP bridging to allow EtherNet IP devices to bridge through the web server module to devices in the chassis CIP Bridge Backplane to Ethernet CIP Common Industrial Protocol bridging Enable this CIP bridging to allow other devices in the chassis to bridge through the web server module to EtherNet IP devices XML ASP Publication ENET UM527E EN P October 2006 XML ASP Extended Markup Language Active Server Page support Enable XML ASP to allow web access to control system data Manage Module Settings 51 Manage Server Settings Select Administrative Settings gt Server Management to customize some of the server settings of the module as well as back up the file system on the web server module You can e customize server settings including web home page e lock access to the module during backup or restore procedures See chapter 6 for more information on backing up the web server module e configure the time server
39. server module uses one TCP connection for each IP address to which the module is connected Multiple CIP connections can go through a single TCP connection Examples of TCP connections are e HMI human machine interface to a controller that supports EtherNet IP communications e Logix MSG instruction to a controller or workstation e OPC or DDE accessing a controller The web server module supports 64 TCP connections that handle CIP connections Consult the following publication for more information Publication Title Publication No EtherNet IP CIP connections EtherNet IP Performance and Application Guide ENET AP001 You can view or download publications at http www literature rockwellautomation com To order paper copies of technical documentation contact your local Rockwell Automation distributor or sales representative Publication ENET UM527E EN P October 2006 124 Use the Web Server Module To Connect Over Ethernet Notes Publication ENET UM527E EN P October 2006 Appendix B About This Appendix Socket Interface The socket interface lets you use a Logix controller to communicate via the web server module with Ethernet devices that do not support the EtherNet IP application protocol such as bar code scanners RFID readers or other standard Ethernet devices Firmware revision 3 1 or later of the 1756 EWEB module and any firmware revision of the 1768 EWEB module supports this socket interfac
40. that were written Specify a DINT tag Considerations See Programming Considerations on page 135 for more information DeleteSocket Parameter Value Service Type DeleteSocket Service Code Af Class 342 Instance from CreateSocket Attribute 0 Socket Interface 153 The DeleteSocket service deletes a socket instance For a TCP connection the DeleteSocket service also closes the connection prior to deleting the instance MSG Configuration Parameters To call this service click in the MSG instruction and enter the values displayed below Message Configuration DeleteMSG Configuration Communication Tag Message Type z T DeleteSocket Service ap Hex Class 342 Hex Instance 32647 Attribute D Hes jee MSG Source Element Not used MSG Source Length 0 MSG Destination Element Not used Considerations Delete a socket instance if it is no longer needed If unused instances are not deleted and you continue to create additional instances you can exceed the maximum number of instances Publication ENET UM527E EN P October 2006 154 Socket Interface DeleteAllSockets Parameter Value Service Type Custom Service Code 51 Class 342 Instance 0 Attribute 0 IMPORTANT Publication ENET UM527E EN P October 2006 The DeleteAllSockets service deletes all currently created socket instances For TCP the DeleteAllSockets service also closes all connecti
41. the destination address Publication ENET UM527E EN P October 2006 146 Socket Interface AcceptConnection Parameter Value Service Type AcceptConnection Service Code 50 Class 342 Instance from CreateSocket Attribute 0 Publication ENET UM527E EN P October 2006 The AcceptConnection service accepts a TCP connection request from a remote destination Before calling AcceptConnection call CreateSocket and specify the local port number that will accept the connection When AcceptConnection completes it returns a socket instance that you use for sending and receiving data on the newly created connection The AcceptConnection service is not valid for UDP sockets MSG Configuration Parameters To call this service click m in the MSG instruction and enter the values displayed below Message Configuration AcceptMSGO Configuration Communication Tag Message Type CIP Generic v Service AcceptConnection v Source Element SockAcceptTimeout l_ w Type Service 50 Ba Code 50 Hex Class 342 Hex Destination SockAcceptRespons x Instance 13650 Attribute 0 Hex How Tag MSG Source Element Specify a DINT tag to contain the timeout in milliseconds MSG Source Length Specify 4 bytes Timeout Socket Interface 147 MSG Destination Element Create a user defined data type Name AcceptR esponse Description Members Data Type Size 12 byte s Nam
42. the organizer on the left select Administrative Settings gt Device Configuration gt Network Configuration Publication ENET UM527E EN P October 2006 Getting Started 21 6 Confirm the network configuration by verifying the IP address and other network settings 2 Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation File Edit View Favorites Tools Help Back gt GY Bsearch Favorites CBristory Ey SH B Address http 10 88 81 6 index htmi z so Links Allen Bradley EVA ESEAS lanl Automation Minimize Device Identity Y Network Configuration Device Services S Email Configuration Home Gh vata views Talal Natuone Configurator Diagnostics Ethernet Interface Configuration D a f FF Administrative Settings Expand Administrative ll Device configuration Neprorts tntarfece m P y IP Address Settings to Network aa EE Confirm network onfiguration DE ETE cases settings in these g 0 Email Configuration Default Gateway fields User Management Primary Name Server Server Management 5 Browse Chassis Secondary Name Serve L send an Email Domain Name na home ra int com Hostname Name Resolution DNS DNS Enabled z Ethernet Link Autonegotiste Status Autonegotiate Speed and Duplex Select Port Speed 100 Mbps Select Duplex Mode Half Duple z Apply Changes Copyright 2004 Rockwell Automation Inc All Right
43. type text xsl gt www rockwellautomation com technologies data_access data_views 1 0 http www w3 0org 2001 XMLSchema instance ocation http www rockwellautomation com technologies data_access data_ schema dataview xsd http www rockwellautomation com technologies data_access data_types 1 0 ltypes description gt e test_tag_bool valueType cip dt_BOOL path 1 1 display String lt valu lt tag gt lt tag nam te error Couldn t read tag gt e xSi nil true gt e test_tag_sint valueType cip dt_SINT path 1 1 display Decimal access wrl lt valu lt tag gt lt tag nam access wrl te error Couldn t read tag gt e xsSi nil true gt e test_tag_int valueType cip dt_INT path 1 1 display Decimal lt valu lt tag gt lt tag nam access wrl te error Couldn t read tag gt e xsi nil true gt e test_tag_dint valueType cip dt_DINT path 1 1 display Decimal lt valu lt tag gt lt tag nam te error Couldn t read tag gt e xsi nil true gt e test_tag_real valueType cip dt_REAL path 1 1 display Decimal access wrl lt valu lt tag gt lt tag nam display St lt valu lt tag gt lt view gt te error Couldn t read tag gt e xsi nil true gt e test_tag_string valueType cip dt_STRINGI path 1 1 ring access write error Couldn t read tag gt e xsi nil true
44. you use the BOOTP DHCP utility in an uplinked subnet where an enterprise DHCP server exists the module may get an IP address from the enterprise server before the BOOTP DHCP utility even sees the module To avoid this disconnect from the uplink to set the address and have the module remember its static address before reconnecting to the uplink This is not a problem if you have node names configured in the module and leave DHCP enabled Use RSLinx Software to Configure the IP Address To use RSLinx software to configure the IP address 1 Make sure the web server module is installed and powered 2 Start RSLinx software 3 Click the RSWho icon I VS RSLinx Classic Gateway File Edit View Communications Station DDE OPC Security Window Help RSWho Icon o il gll amp liz 4 Expand the network configuration organizer until you reach the module 5 Right click on the module and select Module Configuration sts RSLinx Gateway RSWho 1 Eile Edit View Communications Station DDE OPC Security Window Help amp g lie Ea RSWho 1 Not Browsing Workstation USM amp YRDCOLLINL1 ley Linx Gateways Ethernet de 1784 PCD 1 DeviceNet A Ethernet Hs AB_DF1 1 DF1 B p 01 CompactLogix Processor Ricks _L35E Backplane CompactLogix System H 00 CompactLogix Processor 1769 L35E Ethernet Port 1769 L35E Ethernet Port J 03 Local 1769 Bus Adapter VA1769 A s AB_ETHIP 1 Ethernet P
45. 2006 98 Create Custom Web Pages Value Description if_in_octets if_in_ucast The diagnostic information on the Diagnostics thernet if_in_nucast if_in_discards Statistics page f_in_errors if_in_unknown_protos nu if_out_octets if_out_ucast See page 119 for more information if_out_nucast if_out_discards f_out_errors media_alignment_errors media_fcs_errors media_single_collisions media_multiple_collisions media_sqe_test_errors nu media_deferred_trans media_late_collisions media_excessive_collisions media_mac_trans_errors media_carrier_sense_errors media_frame_too_long media_mac_receive_errors time Time in seconds since January 1 1970 asc_local_time ASCII string of time and date These values display the time the web page is accessed J avascript Libraries The web server module provides built in Javascript functions designed to help manage control system data in custom web pages Use This Javascript Library To See Page conversion js Convert values in the string returned from CIPMessage and 99 CIPMessageUnconnected functions using the STRING data type into atomic numeric or string values XMLObjectLoaderLib js Convert the string returned from a GET_ATTRIBUTE_ALL service into a Javascript object which lets you refer to the object or instance attributes by name
46. 55 performance estimates 56 post tags 102 sort 60 supported tags 56 DeleteAllSockets 154 DeleteSocket 153 device configuration 47 device services 28 50 DHCP server 32 diagnostics diagnostics overview 114 Ethernet statistics 119 message connections 117 network settings 116 web server module 113 directories 83 DNS addressing 42 duplicate address detection 40 E edit data views 61 email configure web server 69 MSG instruction 73 overview 67 send via MSG instruction 71 send via web page 70 status codes 75 text format 75 typical application 14 example data view 64 65 66 external applications 63 Publication ENET UM527E EN P October 2006 F file names 85 file system 87 file types 85 forms 102 FTP enable 28 ftp user web 85 back up the file system 87 backup procedure 88 connect 84 directories 83 file names 85 file types 85 restore files 89 function calls 93 H Home page 48 IP addresses 31 33 duplication address detection 40 swapping in redundant systems 42 J Javascript libraries conversion js 99 overview 98 XMLObjectLoaderLib js 100 L log 54 log on 19 Logix5000 controllers 60 module information device configuration 47 MSG instructions 73 132 navigate 22 network parameters BOOTP DHCP utility 36 configure 31 DNS addressing 42 modity 49 RSLinx software 38 RSLogix 5000 software 39 verify 44 with DHCP server 32 without DHCP server 35 0 OpenConnection 143 P password 77 81
47. 7E EN P October 2006 80 Manage User Accounts and Access Levels To see the protection limits for predefined web pages and directories unclick the Hide System Access Limits selection This also provides access to change the predefined protection limits You can then use the Restore System Access Limits selection to return to the default protection limits Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation E la x File Edit View Favorites Tools Help Ea eBak gt A Bsearch Favorites CHristory Gy SH 3 Address http 10 88 81 6 index html z so Links Allen Bradley ENA EEAS lanl ce ze Edit Users Y Edit Access Limits B D Home Ca vata Views Delete Access Limit Group With Access Add an Access Limit ld Diagnostics X fuser systemn dataviews Demo xml Administrators URL Administrative Settings X fuser systern dataviews quick_start_example xml Administrators user web myfile html Device Configuration ictounl i User Management Administrators z D edit users Edit Access Limits Server Management Browse Chassis L Send an Email RA System Access Limits IV Hide System Access Limits Restore Default System Limits Copyright 2004 Rockwell Automation Inc All Rights Reserved Create User Accounts You need Administrator access to create and modify user accounts You can create as many as 25 indivi
48. A Diagnostics Administrative Settings Device Configuration User Management Edit Users Edit Access Limits ad Server Management Browse Chassis Send an Email Minimize Rockwell Automation zl Edit Users J Edit Access Limits Add an Access Limit Delete Access Limit Group With Access X X user system dataviews quick_start_example xml Administrators URL user web myfile html Group fuser systern dataviews Demo xml Administrators RA System Access Limits M Hide System Access Limits Restore Default System Limits Copyright 2004 Rockwell Automation Inc All Rights Reserved In This Field Do This URL Enter the URL for the web page 80 characters maximum including slashes Enter only the relative path of where the page is stored on the web server module such as user Web mypage html Group Select Administrator Write or Read access limit for the specified URL You can configure protection limits for predefined pages as well as for user supplied pages You can also apply protection to directories so that all the files in a specified directory have the same access limit To specify a directory enter the URL with a front slash on the end If you do not enter the front slash the protection limit you select is assigned to the web page To specify an access limit for the entire web site enter only a front slash Publication ENET UM52
49. Ate Ie alee i Bij 1 ravortes Kat A mece K Opa K compar J Controller Ricks_L35E E Module Properties Controller 1 1769 L35E Ethernet Port 12 1 A Controller Tags Controller Fault Handler General Connection Module Info ort Diagnostics EI Power Up Handler ess IP Address 130 151 217 3 aN M a E MainTask Must Match IP Address on General Tab i wr 2 MainProgram a Host Name E Unscheduled Programs Subnet Mask 255 255 224 0 Saec Pat Spoed A Motion Groups Ca Ungrouped Axes Gateway Address 0 0 0 0 Current Port Speed 100 Mbps o at Primary DNS a a fka Server Address DIENER Select Duplex E Data Types Secondary DNS Gi User Defined Sone Adee 0 0 0 0 Current Duplex Full Duplex E Strings Changes to Port Speed and E Predefined I Enable Bootp Duplex require module reset I En yg Module Defined e configu J addre E 0 Configuration IV Auto Negotiate Port Speed and Duplex Refresh Set 1 1769 L35E Ethernet Port LocalENB CompactBus Local J 1 1769 SDN B Devicenet_Scanner Status Running Cancel Es 2 1769 1Q16 A Discrete_Input 3 1769 0816 6 Discrete_Output B 4 1769 IF4x0F2 4 Analog_InOut DHCP DHCP r retum a 6 Select the Port Configuration tab and specify the IP address and the other network parameters if needed 7 Click Apply 8 Click OK This sets the IP address in the hardware This IP address should be the same
50. Binary or String Both ReadLogixTagand ReadLogixTagUnconnected return numbers in decimal format Unless you convert these numbers into another format use Decimal for these values t_ _changed Hidden A 0 or a 1 to indicate whether or not the value has been changed from its time of display This can either be statically set to 1 or you can update this variable when the data field changes to indicate to the web server module that the value should be written to the controller t_ _value Text The data value to be written to the controller tag Publication ENET UM527E EN P October 2006 Create Custom Web Pages 109 The following example page displays a DINT tag from a controller and lets you update the tag with a Submit button lt html gt lt head gt lt meta http equiv Content Type content text html charset windows 1252 gt lt script language JavaScript gt lt script gt lt head gt lt body gt lt form action rokform WriteLogixTags method POST gt TEST lt input type hidden name redirect value user Web writeOneTag asp gt lt input type hidden name numtags value 1 gt lt input type hidden name t_1_tagname value TEST gt lt input type hidden name t_l1_slot value 1 gt lt input type hidden name t_1_type value DINT gt lt input type hidden name t_1_display value Decimal gt lt
51. Device Services Email Configuration aj D home Data Views Initial Network Configuration Diagnostics Ethernet Interface Configuration Administrative Settings Network Interface Gil Device Configuration P Device Identity IP Address 10 88 81 6 1 network Configuration Pear Sees dea Device Services iG Email Configuration Default Gateway 10 88 80 1 DA User Management Ga Primary Name Server 10 88 128 138 Server Management 5 Browse Chassis Secondary Name Server 10 88 128 139 L Send an Email Domain Name na home ra int com Hostname Name Resolution DNS DNS Enabled Ethernet Link Autonegotiate Status Autonegotiate Speed and Duplex E Select Port Speed 100 Mbps Select Duplex Mode Half Duplex i Apply Changes Copyright 2004 Rockwell Automation Inc All Rights Reserved ria ba a Internet Publication ENET UM527E EN P October 2006 36 Configure a Network Address For a Web Server Module Use the Rockwell Automation BOOTP DHCP Utility The module ships with DHCP enabled The BOOTP DHCP utility is a stand alone program that lets you interactively define the IP address of a module that is issuing DHCP or BOOTP requests The utility is located in the e BOOTP DHCP Server folder in the Rockwell Software program folder on the Start menu The utility is automatically installed when you install RSLinx software e Tools directory on the RSLogix 5000 installation CD Before you s
52. IP address you assigned under the General tab On this screen you can also specify port speed 10 Mbps or 100 Mbps and duplex mode autonegotiate half duplex or full duplex The module configuration needs to agree with how the switch is configured See your network administrator for more information Duplicate IP Address 1756 EWEB modules with firmware revision 2 2 or later support Detection duplicate IP address detection All 1768 EWEB module firmware revisions support duplicate IP address detection For more information about EtherNet IP modules that support duplicate IP address detection see the EtherNet IP Modules in Logix5000 Control Systems User Manual publication ENET UMO001 Publication ENET UM527E EN P October 2006 Configure a Network Address For a Web Server Module m When you change the IP address or connect a web server module to an EtherNet IP network the module checks to make sure that the IP address assigned to this module is not the same as that for any other device already on the network If the module determines that there is a conflict some other device on the network already has the IP address the EtherNet IP port of the module goes into conflict mode where the module s e OK LED indicator blinks red e network NET LED indicator is solid red e front display indicates the conflict The display scrolls OK lt IP_address_of_this_module gt Duplicate IP lt Mac_address_of_duplicate_node_detected
53. NBT to another controller End node connection An end node connection is a connection whose end point is the web server module itself Example a connection from RSLinx to the web server module to set the IP address You cannot bridge I O or produced consumed tags through the web server module CIP Connected Messaging Limits Product 1756 EWEB 1768 EWEB CIP Connected Messaging Limits Each module supports e 128 connections for any combination of data views bridged messages and ASP function calls e 32 connections which can be end node connections CIP Unconnected Messaging Limits The following limits of unconnected messages are the maximum number of outstanding unconnected messages These are unconnected messages that are sent to the or bridged through the web server module Product CIP Unconnected Messaging Limits 1756 EWEB 1768 EWEB Each module supports 256 CIP unconnected messages of which e 128 can be unconnected messages from the Ethernet port to an object on the module or to the backplane e 128 can be unconnected messages from the backplane to an object on the module or to the Ethernet port Publication ENET UM527E EN P October 2006 See the EtherNet IP Performance and Application Guide publication number ENET AP001 for more information on connections TCP Connections Additional Resources Topic Use the Web Server Module To Connect Over Ethernet 123 The web
54. One module supports duplicate IP address detection and a second module does not the second module generally keeps its IP address regardless of which module obtains the IP address first The module that supports duplicate IP address detection will detect the conflict and give up the IP address 1756 EWEB modules with firmware revision 2 2 or later support IP address swapping During a switchover in ControlLogix redundancy systems these modules swap their IP addresses with their partner modules in the other redundant chassis For more information about IP address swapping see the ControlLogix Redundancy User Manual publication 1756 UM523 To further qualify an address of a module you can use DNS addressing to specify a host name for a module which also includes specifying a domain name and DNS servers DNS addressing lets you set up similar network structures and IP address sequences under different domains DNS addressing is necessary only if you refer to the module by host name and use the web server module to initiate MSG instructions out of the web server module to another device To use DNS addressing you must 1 Assign a host name to the module Configure a Network Address For a Web Server Module 43 Your network administrator should be able to assign a host name Valid host names should be IEC 1131 3 compliant 2 Configure the module parameters In addition to the IP address subnet mask and gateway addre
55. P server that manages email You can also select whether the web server module should authenticate to the SMTP server The web server module supports only LOGIN authentication Check with your network administrator for more information Publication ENET UM527E EN P October 2006 70 Send Email Send an Email Via the Web Use the Send an Email link to enter and send email text This method Page is a One time approach to sending an email because you have to enter all the email information each time you use the link This link is most useful for testing the email configuration you specified on the Administrative Settings gt Device Configuration gt Email Configuration 2 Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation File Edit View Favorites Tools Help eBak gt t search Favorites CHristory hy Sp amp D Home Data Views Diagnostics Administrative Settings Browse Chassis f send an Email Allen Bradley NYT ESEAS eluant Address hetp 10 88 81 6 index html x ec Send an Email Rockwell Automation Send an Email To personi xyz com From thisperson here com Subject example email lt Enter your email text here Clear Copyright 2004 Rockwell Automation Inc All Rights Reserved In This Field Enter the To Email address of the recipient From Email addre
56. POST handlers 102 pre defined pages 79 R Read 148 Read access 78 read CIP data 95 read controller tags 94 ReadLogixTag 94 ReadLogixTags 110 ReadLogixTagUnconnected 94 recover 81 requirements browser 19 restore files 89 retrieve web server information 97 routing 15 RSLinx software 38 RSLogix 5000 software 39 Index 165 S server log 54 server settings 51 services 28 AcceptConnection 146 attributes 157 CreateSocket 141 DeleteAllSockets 154 DeleteSocket 153 error codes 155 OpenConnection 143 Read 148 socket object 140 troubleshoot 160 Write 151 SMTP 28 SNMP 28 socket interface AcceptConnection 146 application messages 137 architecture 126 attributes 157 change controller mode 136 CreateSocket 141 DeleteAllSockets 154 DeleteSocket 153 error codes 155 instance timeouts 134 MSG instruction timeouts 134 MSG instructions 132 OpenConnection 143 overview 125 partial reads 137 partial writes 138 programming considerations 135 Read 148 service timeouts 134 services 140 TCP client 128 TCP connection loss 135 TCP server 129 troubleshoot 160 UDP with OpenConnection 131 UDP without OpenConnection 130 web server module reset 135 Write 151 sort data views 60 status codes email 75 string tags 71 swap IP addresses 42 Publication ENET UM527E EN P October 2006 166 Index T tags 56 timer server 53 U update control system data 96 user accounts classes 77 create 80 V ve
57. Publication ENET UM527E EN P October 2006 108 Create Custom Web Pages ACTION rokform WriteLogixTags This method is a web POST form handler that requires Administrator access With the correct access level a user can access and post to any tag in the controller not just tags in a data view You can lower the access restriction but this opens access to all controller data to more users The form must include the following hidden inputs Hidden Input redirect An URL where the browser should be redirected after the tag values have been written Usually equal to the URL of the current page numtags The total number of controller tags on the page For each controller tag define these input fields where represents the index of the tag on the page for example 1 for the first tag 2 for the second Description Input Description t_ _tagname Hidden The name of the controller tag to be updated Should be the same as the name used in a data view or in a call to ReadLogixTag t_ slot Hidden The slot number of the controller containing the tag to be written t_ _type Hidden The data type of the tag to be written Should be one of the types defined in schema ClPDatalypes xsd on the web server module for example DINT t display Hidden The display format of the tag to be written Should be Decimal Hexadecimal Octal
58. Publication ENET UM527E EN P October 2006 50 Manage Module Settings Enable and Disable Communication Services Select Administrative Settings gt Device Configuration gt Device Services to specify which communication services are enabled or disabled on the web server module E Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation l8 xj File Edt View Favorites Tools Help EBak gt A A Asearch Favorites CBristory Eh S A Address http 10 88 81 6findex html v Go Links 2 Rockwell Allen Bradley EA EEAS CME eae Device Identity N Network Configuration Y Device Services N Email Configuration X aj Home a Data views Service Description Current Status Enable Diagnostics FTP Copy Files Stopped E Administrative Settings SNMP Station Management Running Vv Device Configuration Device Identity SMTP Email Client Running v Network Configuration CIP Bridge EtherNet IP to Backplane Running Vv Device Services Email Configuration cIP Bridge Backplane to EtherNet IP Running Vv ld User Management Gi GarveriMannerent XML amp ASP Web Access to Control Data Running Vv 1 Browse Chassis L send an Email Apply Changes Copyright 2004 Rockwell Automation Inc All Rights Reserved In This Field Select Whether To Enable Or Disable the FTP FTP File Transfer Protocol server Disable FIP to prevent users from accessing the file system on the web
59. Str X n this example the email text contains 65 characters 3 a Instance 1 Attribute 0 Hex Enea Enable Enable Waiting Start Done Done Length 58 Eror Code Extended Error Code I Timed Out Error Path Error Text Ook Cancel Arey Hebb Publication ENET UM527E EN P October 2006 74 Send Email where In This Field Enter Service Type Custom Service Code Ab Instance 1 Class 32f Attribute 0 Source Element The tag that contains the email text This tag is of the STRING data type you created to contain the email text In this example enter EWEB_EMAIL which is of type EmailString Source Length The number of characters in the email text plus 4 In this example enter 69 65 characters in the email 4 Destination Publication ENET UM527E EN P October 2006 A tag to contain the status of the email transmission This tag is also of the STRING data type you created to contain the email text In this example enter EmailDstStr which is of type EmailString On the Communication tab of the MSG instruction configure the path from the controller to the web server module Message Configuration SendEmail_EWEB Configuration Communication Tag Pati JE Bowo ike I Connected Vv Enable Enable Waiting D Start Done Done Lenath 58 Error Code Extended Error Code I Timed Out Error Path Error Text The path starts with the co
60. TTRIBUTE_ALL response Each byte of the response in the STRING return style takes 3 bytes 2 hex digits and a space so the Device Name attribute begins at the 42nd character of the string The first byte of the string contains the number of characters in the string After parsing this string length pass the length on to the next function which parses the actual string beginning at the 15th byte 45 character of the string decToHex decimalnumber The decToHex function takes an unsigned decimal number as a parameter and returns a string representing decimalnumber in hexadecimal notation The return value does not have a preceding Ox and the returned string is always 8 characters long with leading zeros when necessary hexToDec hexnumber The hexToDec function takes a string containing a hexadecimal number with no preceding 0x as a parameter and returns a decimal number with the value of hexnumber decToOct dintnumber The decToOct function takes an unsigned decimal number as a parameter and returns an 11 character string representing dintnumber in octal notation The return value does not have a preceding O and the returned string is always 11 characters long with leading zeros when necessary Publication ENET UM527E EN P October 2006 100 Create Custom Web Pages Function decToBin decimalnumber Description The decToBin function takes an unsigned decimal number as a para
61. XML files The XSD schema files validate data views Description An XML data view specifies an external XSL stylesheet that contains the rules for transforming this XML information into HTML A web browser uses the XSL stylesheet to display the data view The XSL file is stored in address dataview dataview xsl where address is the IP address or host name of the web server module The web server module provides an XML schema dataview xsd for validating data views This schema also references the ClPDataTypes xsd schema The XSD files are stored in address schema dataview xsd and address schema ClPDataTypes xsd where address is the IP address or host name of the web server module Read a Data View with an External Application For an external application to read a data view the application issues an HTTP GET command that specifies the location and filename of the data view Data views are located in the user system dataviews directory The URL for a data view named myview would be http IP_address user system dataviews myview xml Change Data In a Data View with an External Application When an external application completes modifying tag data in a data view it should post the modified data view either as a file attachment Gn a multi part form or in a single form field named xml to the URL of the data view itself Publication ENET UM527E EN P October 2006 64 Example Data View XML lt xml versi Use Dat
62. a Views to Access Controller Data If all the modified tags are successfully written the web server module redirects the application to the newly modified data view If any tag cannot be written to the controller the web server module returns an HTTP error code with a status message indicating the error This is an example XML markup for a data view named alltypes The data view contains one tag for each of the supported data types The tags are in the controller residing in slot 1 on 1 0 gt lt xml styl lt view ins http ins xsi xSi schemaL views 1 0 Ins cip name al xm xm xm lt tag nam access wri lt valu lt tag gt lt tag nam access wri lt valu lt tag gt lt tag nam access wri lt valu lt tag gt lt tag nam access wri lt valu lt tag gt lt tag nam access wri lt valu lt tag gt lt tag nam display St lt valu lt tag gt lt view gt sheet href dataview dataview xsl type text xs1 gt www rockwellautomation com technologies data_access data_views 1 0 http www w3 org 2001 XMLSchema instance ocation http www rockwellautomation com technologies data_access data_ schema dataview xsd http www rockwellautomation com technologies data_access data_types 1 0 ltypes description gt e test_tag_bool valueType cip dt_BOOL path 1 1 display String tels e xsi nil true gt e test_tag_sint valueType ci
63. alid subnet mask and gateway address CreateSocket service Make sure the Destination tag is of type of DINT After creating the socket with the CreateSocket service make sure you use the instance number that CreateSocket returns in the subsequent socket services you call MSG instruction Make sure the Source Element is of a type that matches the request parameters for the requested service Also make sure the Source Length is the correct length for the service parameters There is a limit to the number of active MSG instructions in a Logix controller If a MSG instruction is enabled and exceeds the maximum number of active MSG instructions the MSG instruction receives an error ER bit set OpenConnection service Publication ENET UM527E EN P October 2006 Make sure the Source Length includes the size of the Timeout parameter Address Length parameter the Length of the address itself Category Socket Interface 161 Consideration Service Timeout parameter Make sure the Timeout parameter is sufficient for the service Also make sure the Timeout parameter is less than the MSG instruction timeout If the timeout set to 0 the service returns immediately TCP protocol Your program should handle the possibility of loss of TCP connections A TCP connection is a byte stream with no inherent message boundaries The application defines how to interpret message boundaries For example the applicatio
64. all the CreateSocket service with instance 0 Socket object class MSG Configuration Parameters To call this service click in the MSG instruction and enter the values Message Configuration CreateMSG Configuration Communication Tag Message Type CIP Generic x zene CreateSocket X Source Element SockCreateParams zi ype Service ab To Code 4b Hex Class 342 Hex Destination Socklnstance ha Instance 0 Attribute 0 Hex New Tag MSG Source Element Create a user defined data type Name CreateParams Description Parameters for the Create service Members Data Type Size 12 byte s Name Data Type Style Decimal 1 for TCP Decimal 2 for IP4 family Decimal Port number Hex Local IP 0 Publication ENET UM527E EN P October 2006 142 Socket Interface Element Data Type Description Type DINT Specify e 1 for TCP e 2 for UDP Addr structure A user defined structure that specifies the address for the socket Family INT Specify the address family Must be 2 Port INT Specify a local port number or set to 0 the local port number will be chosen by the web server For TCP client operations specify 0 unless you want a specific local port number For TCP server communications specify the port number on which to accept incoming connection requests For UDP to receive datagrams ona specific port you must specify a local port number Addr
65. ame name value test_tag_dint gt lt input type hidden name path value 1 1 gt lt input type hidden name type value DINT gt lt input type hidden name connected value true gt lt form gt lt body gt lt html gt Publication ENET UM527E EN P October 2006 Create Custom Web Pages 111 ACTION rokform CIPMessage This method performs an instant CIP message request The response is an HTML stream The form accepts these parameters Input Description Path Path to the data such as 1 1 Service Enter the CIP service name Class Enter the class ID number Instance Enter the instance number optional Attribute Enter the attribute number optional Member Enter the CIP member optional Data Size of the data optional Type Any of the following types BOOL SINT INT DINT REAL or STRING Connected For an unconnected request enter one of the following optional FALSE false F f 0 NO no OFF off For a connected request enter one of the following TRUE true T t 1 YES yes ON on Publication ENET UM527E EN P October 2006 112 Create Custom Web Pages For example lt html gt lt head gt lt meta http equiv Content Type content text html charset windows 1252 gt lt script language JavaScript gt lt script gt lt head gt lt body gt lt form action rokform CIPMessage method
66. an Email Publication ENET UM527E EN P October 2006 Allen Bradiey EVA EEAS lanl Data Views New Data View N Rockwell Automation Delete Edit View Name View Filename Number of Tags Description X Bal Demo Damo xm 1 z ATAA r A Browse Download XML File Test of 1 tag read write example of adding a tag to a new data view Copyright 2004 Rockwell Automation Inc All Rights Reserved 2 Click on the filename of the Data View you just created Getting Started 25 The created tags appear E Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation aj x File Edit View Favorites Tools Help Ea Back gt A Bsearch fayravorites CBristory Fy SH 4 Address http 10 88 81 6 index html z Go Links gt i Rockwell Allen Bradley ENA EEAS CE Paroman Minimize Data Views New Data View quick_start_example Bi D home E bata wi bpi example of adding a tag to a new data view Data Views New Data View Gani 3 Slot Tag Name Data Type Display Value Access Diagnostics Gil administrative Settings 1 TEST DINT Decimal 12345 Admin Device Configuration User Management fd server Management a Update 5 Browse Chassis L Send an Email Copyright 2004 Rockwell Automation Inc All Rights Reserved TIP To change a data value you need Administrator or Write access 3 If you
67. applications to easily access and manipulate system data XML support is also platform and operating system neutral so you can share data between different applications For example design a database application to obtain controller data from the web server module to streamline the data acquisition process In addition the module supports an open socket interface that lets a Logix controller communicate with Ethernet devices that do not support the EtherNet IP application protocol such as bar code scanners or RFID readers Getting Started 15 Features of EtherNet IP Web Server Module in a Control System The module provides the following features and services in the control system Bridging and routing of messages Like other EtherNet IP modules you can route messages upload download programs and flash upgrade modules using the web server module as part of the communication path to access the target device Data access read and write to controllers Access the XML pages in the Enhanced Web Server module to view and modify data that resides in a controller that is in the same chassis as the EWEB module Custom web pages Create custom web pages that are tailored to your application Use ASP functions to populate your web pages with live controller data Email capability You can initiate email messages from the embedded email composer in the module You can also use the module to send an email initiated by a Logix controller
68. ata view files in an XML format You can only access this directory via FTP when the web server module is in backup restore mode schema dataview IMPORTANT IMPORTANT Publication ENET UM527E EN P October 2006 This directory contains dataview xsd and ClPDataTypes xsd schema files for validating data views You can only access these xsd files with a web browser e http ip_address schema dataview xsd e http ip_address schema ClPDataTypes xsd This predefined directory contains dataview xsl which is the external XSL stylesheet for data views You can only access xsl file http ip_address dataview dataview xsl with a web browser There are no restrictions on the type of files you can copy to the web server module You are restricted only by the amount of memory available You access this file system using any standard FTP client By default FTP is disabled for the web server module You enable FTP by selecting Administrative Settings gt Device Configuration gt Device Services Connect to the Web Server Module FIP access must be enabled for the web server module before you can use FIP to access the module You enable FIP on the Administrative Settings gt Device Configuration gt Device Services page To establish a FTP connection to the web server module you need Administrator access to the module You will also need to enter your user name and password The password is transmitted over the network i
69. ation x File Edit View Favorites Tools Help eBak gt At Qsearch Favorites CHristory hy Sp amp Address http 10 88 81 6findex html Go Links z Rockwell Allen Bradley EA E EAS lanl mutccintion Minimize Device Identity NC Network Configuration NC Device Services NU Email Configuration X j Home ed Data views Name and Contact Information Diagnostics Device Name web Server Example Gal Administrative Settings Device Configuration Device Description fremote gar aT anui Device Location site 1 Network Configuration Device Services Contac Info person1 xyz com Email Configuration Gl User Management conachints person2 xyz coml lid server Management O Browse chassis Apply Changes L Send an Email Copyright 2004 Rockwell Automation Inc All Rights Reserved Specify A name for the web server module 32 characters maximum The device name you enter appears in the title bar of the web server module s web pages This device name also appears in RSLinx when you browse the network Device Location Description of the location of the web server module 64 characters maximum Device Description Description of the web server module 64 characters maximum Contact Information Publication ENET UM527E EN P October 2006 Contact information such as name phone number or email address 512 characters maximum There are two fields so that you can specify contact in
70. before the timeout period the Read service returns a status of success 0 and a BufLen of 0 The Read service can return fewer bytes than were requested Your application might need to issue multiple Read requests to receive an entire application message For UDP the Read service completes when a datagram is available MSG Configuration Parameters To call this service click in the MSG instruction and enter the values displayed below Message Configuration ReadMSGO Configuration Communication Tag Message Type CIP Generic F TN ReadSocket gt Source Element SockReadParams 0 v Servi jad 342 pple 4d Hex Class 342 Hex Destination SockReadResponse z Instance 18434 Attribute 0 Hex enon Socket Interface 149 MSG Source Element Create a user defined data type Name ReadParams Description Parameters for Read service Members Data Type Size 8 byte s Name Data Type Style Description Timeout DINT Decimal _ Buflen DINT Decimal Fa where Element Element Description Timeout DINT Specify the timeout in milliseconds BufLen DINT Specify the number of bytes of data to receive MSG Source Length Specify 8 bytes Timeout BufLen Publication ENET UM527E EN P October 2006 150 Socket Interface MSG Destination Element Create a user defined data type Name ReadResponse Description Members Data Type Size 492 byte s
71. ble Email Status Codes Examine the destination element of the email MSG to see whether the email was successfully delivered to the mail relay server This indicates that the mail relay server placed the email message in a queue for delivery It does not mean the intended recipient successfully received the email message Here are possible codes that could be in this destination element Error Code Hex Extended error Description Code Hex 0x00 None Delivery successful to the mail relay server 0x02 None Resource unavailable The email object was unable to obtain memory resources to initiate the SMTP session 0x08 None Unsupported Service Request Make sure the service code is 0x4B and the Class is 0x32F Publication ENET UM527E EN P October 2006 76 Send Email Error Code Hex Extended error Description Code Hex 0x11 None Reply data too large The Destination string must reserve space for the SMTP server reply message The maximum reply can be 470 bytes 0x13 None Configuration data size too short The Source Length is less than the Source Element string size plus the 4 byte length The Source Length must equal the Source Element string size 4 0x15 None Configuration data size too large The Source Length is greater than the Source Element string size plus the 4 byte length The Source Length must equal the Source Element string size 4 0x19 None Data write failure An erro
72. can be described by declaring an object element then describing the members of the structure under consideration The names of the elements are used to construct the Javascript object and the members of the Javascript object have names that match the name attributes in the description file The index attributes describe the order in which these elements occur in the object each attribute and object except the root object must contain an index attribute Create Custom Web Pages 101 These functions are contained in the XMLObjectLoaderLib js library Function Description XMLOb ject Loader This routine initializes the XMLOb ject Loader object used to parse the CIP return data Set it to a declared variable in the Javascript For example var xol new XMLObDjJectLoader LoadOb ject objectname The LoadOb ject function is a member function of the XMLObjectLoader object that xmlfilename objectstruct parses the CIP object return string passed in objectstruct using the XML description file xmlfilename and placing the result in the objectname variable where objectnameglobal variable that contains the result accessible to all scripts within the page xmlfilenameabsolute or relative path to the XML file containing the object description objectstruct CIP object return string For example the following code is a snippet from a web page which displays information about the identity object of a device in slot 1 o
73. ceive or send the entire application message For UDP sockets the size application data cannot exceed the maximums listed for Read and Write services For more information on MSG instructions see e Logix5000 Controllers General Instructions Reference Manual 1756 RMO003 e Logix5000 Controllers Common Procedures Programming Manual 1756 PM001 e EtherNet IP Modules in Logix5000 Control Systems User Manual ENET UMO01 Publication ENET UM527E EN P October 2006 134 Socket Interface Service Timeouts You must specify a Timeout parameter in milliseconds for any service that might not complete immediately OpenConnection AcceptConnection Read and Write The timeout tells the Socket Object the maximum amount of time it should wait when attempting to complete the service While waiting for the service to complete the MSG instruction is enabled If the requested service does not complete before the Timeout period expires the Socket Object returns a response to the service request See the service descriptions for the content of the response IMPORTANT Make the value of the service Timeout parameter shorter than the MSG instruction timeout otherwise application data could be lost MSG Instruction Timeouts The default MSG instruction timeout is 30 seconds the maximum MSG timeout is approximately 35 minutes Specify the MSG instruction timeout by setting the appropriate member of the MSG tag e UnconnectedTimeout member if the
74. ch Favorites History e S B v Go Links http 10 88 81 6findex html Allen Bradley EVA EACS CAE Automation Back Address Minimize Diagnostic Overview X Network Settings N Message Connections Y Ethernet Statistics Home ad Data Views Ethernet Link Media Counters Diagnostics Speed 100 Mbps Alignment Errors Diagnostic Overview Duplex Half Duplex FCS Errors Network Settings Autonegotiate Speed and Duplex si Collisions Autonegotiate Status Single Collisions Message Connections Ethernet Statistics Multiple Collisions SQE Test Errors Advanced Diagnostics Interface Counters Deferred Transmissions e078 00 GO O O GO Ga Administrative Settings In Octets 3869075 Late Collisions Weravseichassls In Ucast Packets 6891 Excessive Collisions L Send an Email In NUcast Packets 16309 MAC Transmit Errors In Discards o Carrier Sense Errors In Errors o Frame Too Long In Unknown Protos 10988 MAC Receive Errors Out Octets 1576727 Out Ucast Packets 7091 Out NUcast Packets 17 Out Discards o Out Errors o Seconds Between Refresh 15 Disable Refresh with 0 Copyright 2004 Rockwell Automation Inc All Rights Reserved am p a a P a internet i This Field Specifies Ethernet Link Speed Whether the Ethernet port is operating at 10 Mbps or 100 Mbps Duplex Whether the Ethernet port is operating at half duplex or full duplex Autonegotiate Status
75. click l in the MSG instruction and enter the values displayed below Message Configuration OpenMSG Configuration Communication Tag CIP Generic X Message Type Source Element SockOpenParams x Source Length 29 Bytes Service Code 4c Hex Class 1342 Hex E Instance 14737 Attribute 0 Hex Hae Service QpenConnection z Type p xl Publication ENET UM527E EN P October 2006 144 Socket Interface MSG Source Element Create a user defined data type Name OpenConnParams Params for the OpenConnection service Description Members Data Type Size 92 byte s Data Type Style Description DINT Decimal DINT Decimal DATA SINT 82 ASCII where Element Element Description Timeout DINT Specify the timeout in milliseconds DestAddr STRING Specify an array of characters maximum of 64 to define the destination of the connection Specify either of these e Hostname port xxx e PAddr port xxx For example to specify an IP address enter 10 88 81 10 port 2813 LEN DINT The length of the destination address DATA SINT array The array containing the destination address Publication ENET UM527E EN P October 2006 You can use a single string tag for the combination of AddrLen and DestAddr since the string data type is a DINT followed by the string characters Note that the quotes displayed on the RSLogix 5000 Data Monitor are not counted in the st
76. controller programs use a CIP Generic MSG instruction to Socket Object Via a MSG request socket services Instruction Message Configuration CreateMSG x Configuration Communication Tag Message Type CIP Generic hates Custom Source Element SockCreateParams x ype Source Length fiz Bytes Service ade Jab Hex Class 242 Hex Destination Socklnstance v Instance jo Attribute f0 Hex ie Enable Enable Waiting Start Done Done Lenath 2 Eror Code Extended Error Code I Timed Out Error Path Error Text Configure the MSG with these values CIP Generic Msg Parameter Description MSG Type CIP Generic Service Type With RSLogix software version 15 select a socket service type from the drop down The software automatically fills in the appropriate Service Code and Class values With RSLogix 5000 software prior to version 15 select Custom You have to specify the Service Code and Class values Select Get Attributes Single or Set Attributes Single when getting or setting a Socket Object attribute see Socket Attributes on page 157 Service Code Each socket service has a unique service code Class Specify 342 hexadecimal for the Socket Object Instance Attribute Specify e 0 for CreateSocket and DeleteAllSockets services e Instance number returned by CreateSocket for other services Use a relay ladder instruction or structured text statemen
77. data view requires Internet Explorer 5 5 or greater with XML support Please upgrade your browser or load the appropriate patches to support XML history go 1 function refresh_value xmlDoc load DATAVIEW_URI xmlDoc setProperty SelectionNamespaces xmlns dv DATAVIEW_NAMESPACE document getElementById tagvalue value xmlDoc selectSingleNode dv view dv tag name TEST dv value childNodes 0 nodeValue function update_value xmlDoc selectSingleNode dv view dv tag name TEST dv value childNodes 0 nodeValue document getElementById tagvalue value xmlhttp Open POST DATAVIEW_URI false xmlhttp Send xmlDoc refresh_value lt script gt lt head gt lt body onLoad refresh_value gt TEST value is lt input type text name tagvalue id tagvalue gt lt br gt lt input type button onClick refresh_value value Refresh gt lt input type button onClick update_value value Update gt lt body gt lt html gt Publication ENET UM527E EN P October 2006 106 Create Custom Web Pages displays this screen Data View Javascript Demo Page Microsoft Internet Explorer 5 x File Edit Yiew Favorites Tools Help Back gt A A Asearch Favorites meda A S SS Sl Q Address http 10 88 81 8 user web dataviewtest html 60 TEST value is 125 E Refresh Update E Done
78. ddress for the web server module If you want to specify a static IP address for the web server module you must also select Static for the Ethernet Interface Configuration field towards the bottom of this page Subnet Mask Subnet mask for the web server module Default Gateway Gateway address for the web server module Primary Server Name DNS server names if using DNS addressing Secondary Server Name Domain Name Domain name for the web server module if using DNS addressing Host Name Host name for the web server module if using DNS addressing Name Resolution DNS Whether the web server module uses DNS addressing Publication ENET UM527E EN P October 2006 In This Field Autonegotiate Status Configure a Network Address For a Web Server Module 45 Specify How to determine port speed and duplex e Autonegotiate speed and duplex e Force speed and duplex Select Port Speed Port speed 10 Mbps or 100 Mbps if you selected to force speed and duplex Select Duplex Mode Additional Resources Duplex full or half if you selected to force speed and duplex Consult the following publications for more information Topic Publication Title EtherNet IP modules and networks EtherNet IP Modules in Logix5000 Control Systems User Manual EtherNet IP modules IP swapping and ControlLogix Redundancy User Manual redundancy systems You can view or download publications at Publicat
79. ds CIP error status codes are Error Code Mnemonic Description Decimal Hexadecimal 22 16 EINVAL Invalid argument 32 20 EPIPE Broken pipe 40 28 EDESTADDRREQ Destination address required 41 29 EPROTOTYPE Protocol wrong type for socket 42 2A ENOPROTOOPT Protocol not available 43 2B EPROTONOSUPPORT Protocol not supported 44 2C ESOCKTNOSUPPORT Socket type not supported 45 2D EOPNOTSUPP Operation not supported on socket 46 2E EPFNOSUPPORT Protocol family not supported 47 2F EAFNOSUPPORT Addr family not supported 48 30 EADDRINUSE Address already in use 49 31 EADDRNOTAVAIL Can t assign requested address 50 32 ENOTSOCK Socket operation on non socket 51 33 ENETUNREACH Network is unreachable 52 34 ENETRESET Network dropped connection on reset 53 35 ECONNABORTED Software caused connection abort 54 36 ECONNRESET Connection reset by peer 55 37 ENOBUFS No buffer space available 56 38 EISCONN Socket is already connected 57 39 ENOTCONN Socket is not connected 58 3A ESHUTDOWN Can t send after socket shutdown 59 3B ETOOMANYREFS Too many references can t splice 60 3C ETIMEDOUT Connection timed out 61 3D ECONNREFUSED Connection refused 62 3E ENETDOWN Network is down Publication ENET UM527E EN P October 2006 156 Socket Interface Error Code Mnemonic Description Decimal Hexadecimal 63 3F ETXTBSY Text file busy 64 40 ELOOP Too many levels
80. dual accounts You manage accounts by selecting Administrative Settings gt User Management gt Edit Users 2 Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation iaixi File Edit View Favorites Tools Help eBack gt O A Bsearch GaFavorites Hristory yv BH B Address http 10 66 81 index html z so Links i Rockwell Allen Bradley EVA ESEAS CE istouaatcans Minimize Edit Users N Edit Access Limits al D Home Cl vata views Delete Edit User Name Group Add a User ad Diagnostica X ES Administrator Administrators User ID Administrative Settings user1 Device Configuration Group Ca Uso Management Write X D edit users Password Edit Access Limits rene Cd server Management a D Browse Chassis E L Send an Email Copyright 2004 Rockwell Automation Inc All Rights Reserved Publication ENET UM527E EN P October 2006 Manage User Accounts and Access Levels 81 Field Action User ID Enter the user name for the account 80 characters maximum Can contain these characters A Z a z 0 9 underscore _ and dash Group Select Administrator Write or Read access for the user account Password Enter the password for the account 80 characters maximum Confirm Password IMPORTANT Recover with Unknown Password Re enter the same password for the account If you use Internet Explorer the number of c
81. dule Using Your Web Browser 19 Navigate the Web Server Module onanan anana aaa 22 Use the Web Server Module 64 9 ee anaana aaa 23 Create a Data View eo goa e a a a a a ee 23 Access a Data View auauna aaa 24 Configure Email oaaao auaa aaa 26 Configure the Time Server Ss paces Wael as Ha Ee Ow 5 27 Eoable disable Other Services 5 6 8 kr wk 28 Additional Resources nanana dm eaad amend GaSe deeded 29 Chapter 2 How to Use This Chapters 6 4 8o wip Fades hog BG GPa nied 31 Determine Which Network Parameters Are Required 31 Assign Network Parameters When the Network Has a DHCP SEVERS uS doc Se At hgh aaa e BAG th al eos A a aa e a E 32 Assign Network Parameters Without A DHCP Server 35 Use the Rockwell Automation BOOTP DHCP Utility 36 Use RSLinx Software to Configure the IP Address 38 Use RSLogix 5000 Software to Configure the IP Address 39 Duplicate IP Address DetechiOntsa ity gies cea eee es 40 Duplicate Detection Scenanios s 26444 e280 Sooo ee Pee 42 IP Address Swapping osoa balay Rate S odtick Glee eds 4 42 DNS Addressing oh pedeos ocx sched cater fe Aged Soh nae ete 4 42 Verify Network Settines 4594s ea Sk ook EASE ERR ES Od 44 OL CE TES Ee OE eee Tee ee ee Se ere 45 Additional Resources 22 wis e ote Hin ne bcN Seba tals es 45 Publication ENET UM527E EN P October 2006 6 Table of Contents Manage Module Settings Use Data Views to Access Controller Data Send Ema
82. dule is not in backup restore mode If you have a standard FTP session open to the web server module close this before placing the module in backup restore mode Once in backup restore mode the previously open FTP session will no longer point to the correct directory and files File Names and Types File names can have no more than 80 characters In addition the complete path for any file in the file system can have no more than 80 characters For example the user created web pages go in the uset Web folder which is actually in the file system as root uset Web already 14 characters Any path underneath this must have 65 or less characters including slashes dots and extensions File names are case insensitive and can contain any characters including spaces except for the following characters lt gt Publication ENET UM527E EN P October 2006 86 Access Files in the Web Server Module Publication ENET UM527E EN P October 2006 When user files are accessed via HTTP certain file extensions result in specific values returned in the Content Type field Here are some Content Types for the more commonly used files File Extension Content Type htm text html html text html asp text html git image gif Jpg image jpeg CSS text cascading style sheet txt text plain Js application x javascript exe application binary Z application compressed gz ap
83. e Topic Page Socket Interface Architecture 126 Communicate With the Socket Object Via a MSG Instruction 132 Service Timeouts 134 MSG Instruction Timeouts 134 Socket Instance Timeouts 134 Programming Considerations 135 Socket Object Services 140 CreateSocket 141 OpenConnection 143 AcceptConnection 146 Read 148 Write 151 DeleteSocket 153 DeleteAllSockets 154 Possible Error Codes for Socket Services 155 Socket Attributes 157 Troubleshoot Socket Applications 160 Publication ENET UM527E EN P October 2006 126 Socket Interface Before You Begin Before you use the socket interface you should be familiar with e basic TCP IP UDP and socket programming concepts e how to write socket programs in a programming language such as C or Visual Basic e how to use diagnostic tools such as a network sniffer e the application protocols of the devices and applications with which the Logix controller will communicate e how to write ladder logic or structured text for a Logix controller Socket Interface The socket interface is implemented via the Socket Object in the web Architecture server module Logix controller programs communicate with the Socket Object via MSG instructions MSG requests to the Socket Object are similar to socket API calls in most computer operating systems The Socket Object services let you open connections accept incoming connections send data
84. e Data Type Style Description Instance INT Decimal Ad Sock Family INT Decimal 2 for IP4 family Port INT Decimal Port number Addr DINT Hex Local IP 0 Ms where Element Element Description Instance DINT Contains the instance for this service Use this Instance on subsequent Read and Write services for this connection Addr structure A user defined structure that contains the address for the socket Family INT Contains the address family Must be 2 Port INT Contains a local port number Addr DINT Contains an IP address Considerations Create a separate socket instance CreateSocket for each port number that will accept connections After you create a socket instances call AcceptConnection to wait for an incoming connection request You can accept connections on the same port number Each call to AcceptConnection returns a different instance number to use when subsequently reading and writing data Publication ENET UM527E EN P October 2006 148 Socket Interface Read Parameter Value Service Type Read Service Code Ad Class 342 Instance from CreateSocket Attribute 0 Publication ENET UM527E EN P October 2006 The Read service reads data on a socket You specify a number of bytes to receive The Read service returns the number of bytes received For TCP the Read service returns when any data is received up to the requested number of bytes If no data is received
85. e ReadLogixTagUnconnected function performs the same task as ReadLogixTag function and uses the same parameters This function however retrieves the tag value through unconnected messaging rather than connected messaging Read CIP Data Create Custom Web Pages 95 There are two ASP functions you can use to read CIP data If You Want Use This ASP Function See Page Connected messaging CIPMessage 96 Unconnected messaging CIPMessageUnconnected 96 Function CIPMessage path service class instance attribute member data returntype The CIPMessage function performs the CIP service specified by the service parameter on an object or object instance specified by the class instance attribute and member parameters using the data passed in the data parameter Cif necessary and returning the value with a type specified by the returntype parameter if appropriate Parameters Parameter Description path The path is a CIP path with no spaces and segments separated by commas This is the same as the path parameter in the read controller tag functions service The service identifies the CIP function to perform class The class instance attribute and member parameters identify the object for the service tnstance If a service does not use an instance attribute and or member pass the parameters as 0 attribute member data The data to be passed If no data is passed in the request set the data paramet
86. e following publications for more information Topic Publication Title Publication No Creating controller tags using Logix5000 Controllers Common Procedures 1756 PM001 RSLogix5000 EtherNet IP network EtherNet IP Modules in Logix5000 Control Systems ENET UMO01 User Manual 1756 EWEB module installation EtherNet IP Web Server Module Installation 1756 IN588 Instructions 1768 EWEB module installation EtherNet IP Web Server Module Installation 1768 IN007 Instructions You can view or download publications at http www literature rockwellautomation com To order paper copies of technical documentation contact your local Rockwell Automation distributor or sales representative Publication ENET UM527E EN P October 2006 30 Getting Started Publication ENET UM527E EN P October 2006 Chapter 2 How to Use This Chapter Configure a Network Address For a Web Server Module This chapter describes how to configure a module to operate on an Ethernet network Topic Page Determine Which Network Parameters Are Required 31 Assign Network Parameters When the Network Has a DHCP 32 Server Assign Network Parameters Without A DHCP Server 35 Duplicate IP Address Detection 40 IP Address Swapping 42 DNS Addressing 42 Verify Network Settings 44 Determine Which Network For the module to operate on an Ethernet network you must define Parameters Are Required Ethernet Parameter IP Address these parameters
87. e the controller slot Rockwell Automation Microsoft Internet fxplarer provided by Rockwell Automation zll xj Fie Edt Wew Fawortes Too Hep Pok Bld A Geer Faroes Grew SM J z ce Adress E hetp 10 00 01 index html z Set et exambis Automation Minimize BB A GAGA Ga Ga ca Ga Ga Copright D 2004 Rockwall Avtomaticn Inc All Rights Rererved Tag Name Name of the tag These fields must match exactly what is specified for the tag in the selected controller To verify tag information you can use Data Type Data type of the tag Display As Display type to use for the tag e RSLogix 5000 software to view the controller project e RSLinx software to navigate to the controller and view tags Access Whether you require Administrator Write or Read access to view the tags in this data view Publication ENET UM527E EN P October 2006 The default access level is Administrator The access you specify applies to the whole data view not just the tag If you have multiple tags with different access levels in the same data view the web server assigns the highest most access level to the data view See chapter 6 for details on access levels Use Data Views to Access Controller Data 59 Monitor Data Views and Select Data Views gt Data Views to view existing data views Tag Data Click on the file name to view the tags within a data view 2 Rockwell Auto
88. eate Data View 1 TEST DINT Decimal z Admin za amp Name quick_start_example Delete Edit Slot Tag Name Data Type Display As Access Riescrnuens example of adding a tag to a new data view E Create View Cancel Copyright 2004 Rockwell Automation Inc All Rights Reserved Publication ENET UM527E EN P October 2006 24 Getting Started 2 In the Create Data View box specify a name for the data view and enter an optional description 3 Specify the slot number of the controller tag name case sensitive must be exactly as it is specified in the controller type of tag how to display the tag data access limit of the data view Click on the Add g button to add the tag to the data view Continue adding as many tags as you want to configure 5 Click Create View For more information see chapter 4 Access a Data View 1 In the organizer on the left select Data Views gt Data View OR Click the Data Views tab Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation laj xj File Edit View Favorites Tools Help SBa gt Bsearch Favorites CHristory hy Sp 4 Address http 10 68 81 6 index ht z 60 Links gt Home Data Views Data Views New Data View Cd diagnostics Administrative Settings Device Configuration User Management lid server Management Browse Chassis L send
89. eb Server Module Device 10 10 10 10 10 10 10 11 Open TCP Connection a fi onnection o Port 49100 Send 4 Data abc Data Te am Data xyz p Receive Data controller as soon as the data is sent Publication ENET UM527E EN P October 2006 130 Socket Interface Typical Sequence of Transactions For UDP Without OpenConnection The following diagram shows a typical sequence of socket interface transactions for UDP communications without using the OpenConnection service to specify the destination address In this case the Logix controller specifies the destination for each datagram and receives the sender s address along with each datagram it receives Each transaction between the Logix controller and the web server is a MSG instruction The example below shows the Logix controller sending data to a device and then the device sending a response This is a typical sequence of transactions Depending on the application protocol the device could instead initiate sending data to the Logix controller Additionally each Write does not require an application response or acknowledgement The application protocol determines the exact sequence of application transactions Logix Web Server Module Device controller 10 10 10 10 10 10 10 11 CreateSocket Port 49100 CreateSocket n Response Instance 102 Write 10 10 10 11 Port 49200 aes Data abe Data abe _ a Receive Data From Port 49200 Write Response
90. ee 141 MSG Configuration Parameters 22 0 cae lt 2 das aaea 141 OpenGonnecion ss ei ecu e exe Peace Pe Pee hd exe eee 143 MSG Configuration Parameters 005 143 ACKEMICONMECHON s e reedi malta ken ee RS Eek ae tek BS 146 MSG Configuration Parameters 2 44 eww ies Bowne 146 GAG a Tedis ana e sect Saeed ea te ies ui andlor sh eee Ete 148 MSG Configuration Parameters 00 148 WV TILE cede BAe a mdi E toe tke RG oust Aad Se Sle S 151 MSG Configuration Parameters 005 151 DeleteSocket aie grap ime a foe E A E p a ae Hb 4 153 MSG Configuration Parameters sa kai soho ee wha 153 Delete AlSOCk eS ns gt co OA eed a Sa eas 154 Index Table of Contents 9 MSG Configuration Parameters 005 154 Possible Error Codes for Socket Services 0 4 ac eee ee 4 155 SOCKEE Attributes ios tihoti Gah a di 157 Socket Object Class Attributes onnaa op 7 S445 aS 158 Socket Object Instance Attributes 159 Troubleshoot Socket Applications 04 160 Debugging Hints and Tips eexs 48 Week hes 160 Additional Resources ih widsaw ceee hk ee ke hh an Beene 161 Publication ENET UM527E EN P October 2006 10 Table of Contents Publication ENET UM527E EN P October 2006 About This Publication Who Should Use This Publication Conventions Preface Use this manual as a reference when installing using and troubleshooting your EtherNet IP Web Server Module Thi
91. entative or visit http support rockwellautomation com Installation Assistance If you experience a problem with a hardware module within the first 24 hours of installation please review the information that s contained in this manual You can also contact a special Customer Support number for initial help in getting your module up and running United States 1 440 646 3223 Monday Friday 8am 5pm EST Outside United Please contact your local Rockwell Automation representative for any States technical support issues New Product Satisfaction Return Rockwell tests all of its products to ensure that they are fully operational when shipped from the manufacturing facility However if your product is not functioning it may need to be returned United States Contact your distributor You must provide a Customer Support case number see phone number above to obtain one to your distributor in order to complete the return process Outside United Please contact your local Rockwell Automation representative for States return procedure Power Control and Information Solutions Headquarters Americas Rockwell Automation 1201 South Second Street Milwaukee WI 53204 2496 USA Tel 1 414 382 2000 Fax 1 414 382 4444 Europe Middle East Africa Rockwell Automation Vorstlaan Boulevard du Souverain 36 1170 Brussels Belgium Tel 32 2 663 0600 Fax 32 2 663 0640 Asia Pacific Rockwell Automation Level 14 Core F Cyb
92. er Module Expand Data View to New Data View 2 Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation To help familiarize yourself with the web server module perform these basic tasks ifYouWantTo SeePage Create a Data View 23 Access a Data View 24 Configure Email 26 Configure the Time Server 27 Enable disable Other Services 28 Create a Data View Before you can create a data view in the web server the tags you want to view must exist in the local controller that is the controller in the same chassis as the EWEB module program To complete these example use programming software to create a tag with the following Alias TEST Type DINT Controller scope Value 12345 Create a Data View To create a data view you need Administrator or Write access 1 In the organizer on the left select Data Views gt New Data View al xi File Edit View Favorites Tools Help a Back gt gt Qsearch Favorites CBristory hy B Address http 10 88 81 6findex html z so Links Allen Bradley ENA ESEAS CE Automation D Home Data Views nl Data Views New Data View Gi Diagnostics Administrative Settings fd Device Configuration User Management Server Management 5 Browse Chassis L Send an Email Minimize Data Views Y New Data View Slot2 Tag Name Data Type Display As Access Add Cr
93. er to an empty string returntype The returntype parameter is the same as the tagtype parameter used in the read controller tag functions except when a returntype of STRING is specified the data returned from the service is written to the browser as a space delimited string of hex digits Example For example a GET_ATTRIBUTE_ALL to the identity object of a device in slot 1 of the local chassis lt o CIPMessage 1 1 1 1 1 0 0 STRING gt This ASP call returns a string similar to 01 00 OE 36 2D 4C 52 47 SF 00 03 00 0C OC 70 30 63 2E 31 2F 41 20 31 37 35 36 2D 31 32 5F 33 38 08 00 1D 31 37 35 4D 30 2F 30 20 41 Publication ENET UM527E EN P October 2006 96 Create Custom Web Pages Function Publication ENET UM527E EN P October 2006 While the value returned by specifying the STRING data type may not be very useful to display in the browser by itself some built in Javascript libraries help the ASP developer parse and use the information contained in these string structures See page 98 for more information on the Javascript libraries CIPMessageUnconnected path service class instance attribute member data returntype The CIPMessageUnconnected function performs the same task as the CIPMessage function and expects exactly the same parameters This function however performs the specified service through unconnected messaging rather than connected me
94. ere change_method is one of these Use This Method To See Page user system dataviews filename xml Change all data in a data view or only specific data ina data view 102 rokform WriteLogixTags Change any data in a controller whether it is in a data view or not 108 rokform ReadLogixTags Enter a tag name and receive its current value 110 rokform CIPMessage Send an instant CIP message request 111 ACTION user system dataviews filename xml This method follows the same user access restrictions as the restrictions for the user requesting the data view You can only post the tags that appear on the data view You must have the same access level as the level configured for the data view You can post the same XML that you got in the requested file with the desired data values changed or only the controller tags you want to change To recreate the following example 1 Create a Logix controller tag named TEST of data type DINT 2 In the web server module create a data view named Sample Include tag TEST of data type DINT in this data view All names are case sensistive 3 Verify that the data view Sample works 4 Copy the example code from a PDF version of the user manual and paste it into a text editor Publication ENET UM527E EN P October 2006 Create Custom Web Pages 103 Remove the newlines from the alert text or shorten the alert text to one line IMPORTANT In alert statements the text of the alert mu
95. erport 3 100 Cyberport Road Hong Kong Tel 852 2887 4788 Fax 852 2508 1846 Publication ENET UM527E EN P October 2006 Supersedes Publication ENET UM527D EN P May 2006 PN 953030 29 Copyright 2006 Rockwell Automation Inc All rights reserved Printed in the U S A
96. erver to Send Email The web server module uses the standard SMTP protocol to forward an email to a mail relay server You must configure the web server module to recognize the appropriate mail relay server Some mail servers require a domain name be provided during the initial handshake of the SMTP session For these mail servers make sure you specify a domain name when you configure the network settings for the module You configure the SMTP server and domain name by selecting Administrative Settings gt Device Configuration gt Email Configuration Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation 2 18 xj File Edit View Favorites Tools Help Back gt A A Asearch Favorites Bristory Gy B Address BT httpfio eseteindchim NT a Minimize E Home Data Views Diagnostics Administrative Settings Device Configuration Device Identity Device Services Email Configuration Gil User Management lid server Management Browse Chassis L Send an Email Network Configuration Allen Bradley EVES Eg Example Automation Device Identity NU Network Configuration N Device Services Y Email Configuration E Mail Client SMTP Server IP or Hostname 1 0 88 69 9 M SMTP Authentication UserName ewebEmail Password Prmmeccann _ Apply Changes Copyright 2004 Rockwell Automation Inc All Rights Reserved Enter the address of the SMT
97. erver Module Select Administrative Settings gt Device Configuration gt Network Configuration An authenticated user may modify network parameters Verify Network Settings alas Fie Edt View Favortes Tools Help 7 p ll Back gt O A A Bsearch Favorites CBristory B 3 w S Address http y 10 88 81 6findexht Links Allen Bradley RV ESENCAS C E Automation Minimize Device Identity Y Network Configuration Device Services M Email Configuration D home Ga Data Views Gi Diagnostics Administrative Settings Device Configuration Device Identity Network Configuration Device Services Email Configuration al User Management Gi Server Management iG Browse Chassis L send an Email Initial Network Configuration Ethernet Interface Configuration Network Interface IP Address Subnet Mask Default Gateway Primary Name Server Secondary Name Server Domain Name Hostname Name Resolution DNS Ethernet Link Autonegotiate Status Select Port Speed Select Duplex Mode DNS Enabled Autonegotiate Speed and Duplex l 100 Mbps Half Duplex E Apply Changes Copyright 2004 Rockwell Automation Inc All Rights Reserved a E http www rockwellautomation com a Internet In This Field Ethernet Interface Configuration Specify The network configuration scheme e Dynamic BOOTP e Dynamic DHCP default e Static IP Address IP a
98. ervice with 1 DINT that DINT is sent over a TCP connection or in a UDP datagram in CIP byte order If you issue a Read service and your destination tag for the response contains a DINT the Logix controller assumes the incoming data is in CIP byte order Depending on the native byte order of the application you are communicating with you may have to convert the byte order in your Logix5000 program and or in the application To check your MSG configuration in RSLogix software version 15 or later select a service type from the drop down when you configure the MSG instruction Configuration tab The software automatically fills in the appropriate Service Code and Class values With RSLogix 5000 software prior to version 15 select Custom You have to specify the Service Code and Class values With RSLogix software version 15 you can select a socket service type from the drop down The software automatically fills in the appropriate Service Code and Class values With RSLogix 5000 software prior to version 15 you must select Custom for the service type Then specify the Service Code and Class value for the appropriate service Socket Interface 141 CreateSocket Parameter Value Service Type CreateSocket Service Code Ab Class 342 Instance 0 Attribute 0 The CreateSocket service creates an instance of the Socket object The service returns an instance number that you use in the subsequent socket operations C
99. etwork Configuration Device Services Y Email Configuration fiosscor ooo DNS Enabled Autonegotiate Speed and Duplex Copyright 2004 Rockwell Automation Inc All Rights Reserved gl Publication ENET UM527E EN P October 2006 Internet Configure a Network Address For a Web Server Module 35 Assign Network If a DHCP server is not available you must assign a static IP address Parameters Without A to the module Select one of these methods DHCP Server If You Are Working in These Conditions Use This Method For Assigning Network See Page Parameters In any condition the Rockwell Automation BOOTP DHCP Rockwell BOOTP DHCP utility 36 utility is recommended available with RSLinx and RSLogix 5000 software The module is connected to other NetLinx networks RSLinx software 38 The RSLogix 5000 project is online with the controller that RSLogix 5000 software 39 communicates to or through the web server module After using one of these utilities select Administrative Settings gt Device Configuration gt Network Configuration to set additional parameters EJ Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation xj Fie Edit View Favorites Tools Help eBak gt At Qsearch Favorites CBristory hy S A Allen Bradley EA EEAS CME Automation Expand item Device Identity Y Network Configuration N
100. f the local chassis lt script type text javascript srce scripts conversion js gt lt script gt lt script type text javascript src scripts XMLOb ject LoaderLib js gt lt script gt lt script type text javascript language javascript gt var idobj function loadPage document getElementById vendor innerText idobj VendorID document getElementById type innerText idobj DeviceType document getElementById code innerText idobj ProductCode document getElementById rev innerText idobj Revision MajorRevision idobj Revision MinorRevision document getElementById status innerText 0x decToHex idobj Status document getElementById serial innerText 0x decToHex idobj SerialNumber document getElementById prodname innerText idobj ProductName function loadme var id lt CIPMessage 1 1 1 1 1 0 0 0 STRING gt var xl new XMLObjJectLoader xl LoadObject idobj CIPXMLobj CN_0O1_Identity xml id loadPage lt script gt lt body onload loadme gt Publication ENET UM527E EN P October 2006 102 Create Custom Web Pages Web Page Forms and POST ny web page that displays controller data can include a way to change that data by creating a form on the web page Handlers Include this statement in your web page file ACTION change_method METHOD POST wh
101. formation for two individuals Manage Module Settings 49 Modify Network Parameters Select Administrative Settings gt Device Configuration gt Network Configuration lets to modify network parameters 2 Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation Tools Help File Edit view Favorites 2181 x SBak gt A Bsearch fayravorites CBristory Ey SH Address http 10 88 81 6findex html Go Links gt Expand tome Gi Data Views Minimize Diagnostics Administrative Settings Device Configuration Device Identity Network Configuration Device Services Email Configuration User Management Server Management 5 Browse Chassis L send an Email nE Allen Bradley EUA EAE AS CE Aaro AT On Initial Network Configuration Ethernet Interface Configuration Network Interface IP Address Subnet Mask Default Gateway Primary Name Server Secondary Name Server Domain Name Hostname Name Resolution DNS Ethernet Link Autonegotiate Status Select Port Speed Select Duplex Mode Apply Changes Device Identity Y Network Configuration N Device Services Email Configuration A na home ra int com DNS Enabled Autonegotiate Speed and Duplex 100 Mbps Half Duplex Copyright 2004 Rockwell Automation Inc All Rights Reserved a http www rockwellautomation comf a Internet
102. gn a static IP address Publication ENET UM527E EN P October 2006 Configure a Network Address For a Web Server Module If your network configuration requires a static IP address configure the IP address by selecting Administrative Settings gt Device Configuration gt Network Configuration T Do not simply configure the initial address assigned by the DHCP server as a static IP address Contact your network administrator for an appropriate static IP address 1 Access the Network Configuration page 2 Enter the static IP address 3 Select Static for the Ethernet Interface Configuration File Edit View Favorites Tools Help la x Back gt gt search Favorites CBristory hy B Address http 10 88 81 6 index html Go Links Minimize D Home G Data Views Diagnostics Administrative Settings Device Configuration Device Identity Network Configuration p Device Services Email Configuration adver Management Server Management Browse Chassis L Send an Email Bis Initial Netyosd Network Int IP Address Subnet Mask Default Gateway Primary Name Server Secondary Name Server Domain Name Hostname Name Resolution DNS Ethernet Link Autonegotiate Status Select Port Speed Select Duplex Mode Apply Changes Ethernet Interface Configuration Allen Bradley UNV oust a lal gt Clan Automation Device Identity Y N
103. gnostics Administrative Settings Device Configuration User Management Server Management Server Settings Backup Restore Time Settings Server Log Diae Chassis L Send an Email Select This Field SNTP Time Server Minimize Address http 10 88 81 6findex html Go Links Allen Bradley EAA CAS Clune Automation Server Settings N Backup Restore Y Time Settings N Server Log a Server Time Snapshot THU JAN 01 01 39 29 1970 Get Time Method sntp Time Server IP or Hostname 10 88 69 10 SNTP Timeout sec ji Controller Slot 0 E Month Day Year Jan 01 J 2004 amp C Query Controller Clock Hour Min Second OO ey OO Sy 00 Manual Time Entry C Disabled Local Time Offsets UTC Coordinated Universal Time Dublin Edinburgh Lisbon London I Adjust for Daylight Saving Time Update Time at Constant Interval Time Between Updates 1 Minute X Set Controller Wall Clock Controller Slot 0 E I Enabled Apply Changes If You Want To Use the time from the Network Time Protocol NTP Specify the IP address or host name of an SNTP server on the network The web server uses port 123 for this service The IP address you enter persists over power cycles Query Controller Clock Use the time from the local Logix controller Wall Clock Time Specify the slot number of the controller The web server module queries the Wall Clock Time of the contr
104. gt Home D Home Data Views Device Name Web Server Example Diagnostics Device Description remote A administrative Settings Device Location site 1 Browse Chassis Ethernet Address MAC 00 00 BC 22 A0 07 Q send an Email IP Address 10 88 81 6 Product Revision 1 2 1 The module s home page displays Firmware Version Date Jan 15 2004 02 10 55 Serial Number SN 001C82C6 Status Unkeyed Uptime 01h 21m 56s Copyright 2004 Rockwell Automation Inc All Rights Reserved Publication ENET UM527E EN P October 2006 20 Getting Started 2 Log into the module TIP Many of the features of the web server module require you to log in with appropriate access If you select a feature such as New Data View the web server module prompts you to enter your user name and password 3 If logging into the module for the first time enter the default user name Administrator and leave the Password field blank Enter Network Password x fey This secure Web Site at 10 88 80 78 requires you to log on Default Access qo Please type the User Name and Password that you use for DA 1756 EWEB User Name Administrator not case sensitive UserName JAdminstrato a Password Password I Save this password in your password list leave blank no password ae 4 Click OK TIP You can set up as many as 25 user accounts Each account can have read read and write or administrator access For more information see chapter 6 5 In
105. gt Publication ENET UM527E EN P October 2006 Chapter 5 Send Email About This Chapter This chapter describes how to send an email message Topic Page Overview 67 Configure the Web Server to Send Email 69 Send an Email Via the Web Page 70 Send an Email with a Controller initiated Message 71 Instruction For email the web server module can be located locally or remotely to the controller chassis Overview The web server module is an email client that uses a mail relay server to send email There are two ways you can use the web server modules to send email If You Want To Send an email to specific personnel when a controller application generates an alarm or reaches a certain condition Send controller or application status information on a regular basis to a project manager Then Program the controller to send a MSG instruction to the web server module The MSG instruction then instructs the web server module to send the email text contained within the MSG instruction to the mail relay server Multiple controllers can use the same web server module to initiate email Test the email configuration of the web server module Use the web server email interface to send an email you must enter all email information each time you use this interface Use the Send an Email link on the web server s Home page The web server module only sends the content of a MSG instruction or
106. h tori late hee SDR Eee 67 OVERVIEW A We 8455 AE OEE EE NR Kaha on Gaba A beara 67 Configure the Web Server to Send Email 69 Send an Email Via the Web Page 004 70 Send an Email with a Controller initiated Message Instruction 71 Greate SIS LASS iy hg Os ka OA BER CE ORES THOR 71 Enter the Ladder Logic n nananana 72 Configure the MSG Instruction o o aaa aaaea 73 Enter the Text of the Email nananana aaa 75 Possible Email Status Codes oona naaa aaa 75 Manage User Accounts and Access Levels Access Files in the Web Server Module Create Custom Web Pages Monitor Diagnostics Table of Contents 7 Chapter 6 ADOUE THIS Chapters iain ay aes eae ee es 77 User Accounts and Privilege Classes 77 Configure Access Limits For Web Pages 78 Create User ACCOUNTS 5 a cide he ts anes ae owes 80 Recover with Unknown Password e 4 645 890246 028965 81 Chapter 7 About This Chapter naana aaaea od nee lohan wedeod ee 83 Access the Web Server s File System n on anaana naaa 83 Connect to the Web Server Module 84 File Names and Types nannaa aana 85 Back Up the File System On the Web Server Module 87 Back Up Files sorain a ek N 88 Restore Fil s y potee pakpa ana ees eE ha RSE OER Ped 89 Chapter 8 About This Chapters recos nae Teer Rea dec Ee Seth ht a Pad Ge Sb 91 OQVERMIEW iis chile tO had mah Rie ee Gordo h ge Peed 4 91 Access Cust
107. haracters allowed for a user ID or password depends on how many characters fit in the box Larger characters such as W take more room and reduce the total number of allowed characters This limitation does not apply if you use Netscape Mozilla or some other browser There are no back door accounts or passwords in the event that you forget the web server module s passwords or inadvertently delete all the Administrator accounts To recover a web server module with unknown passwords you must use ControlFlash to restore the web server s flash file system to the factory default This operation deletes all user accounts data views and user loaded web pages Contact technical support for the appropriate recovery script and binary file Publication ENET UM527E EN P October 2006 82 Manage User Accounts and Access Levels Publication ENET UM527E EN P October 2006 Chapter Access Files in the Web Server Module About This Chapter This chapter describes how to use FTP to access the file system on the web server module Topic Page Access the Web Server s File System 83 Back Up the File System On the Web Server Module 87 You use FTP access to store custom web pages and applications on the web server module e web server module has a flash file system that stores web pages ccess the Web Servers The wel dule has a flash fil h File System and data views The following table contains the amount of space e oyste a
108. he name of the file for the custom web page You must copy a custom home page to the web server module before you can use it See chapter 8 for information on creating a custom web page Server Port Number Select the default port number 80 for the HTTP port on the web server module or specify a custom port number Server Log Enable or disable the server log You view the server log from the Server Log page under the Server Management folder See page 54 for how to display the server log Log Filters If you enable the Server Log specify which of the following information you want to be Publication ENET UM527E EN P October 2006 recorded for the web server log Timestamp of HTTP request access URL requested on the web server module Server HTTP Code IP Address of the requestor Access Administrator Write or Read Manage Module Settings 53 Configure the Time Server To configure the Time Server select Administrative Settings gt Server Management Server gt Time Settings Doing so helps makes sure that files you save to the web server module have accurate date and time stamps You can also enable the local controller to get its time and date from the web server module 18 x 3 Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation Fie Edt View Favorites Tools Help lt Back gt 0 search Favorites CBristory hy B Home Gi Data Views Dia
109. ied to the web server module The Administrative Settings gt Server Management gt Backup Restore lets you lock access to the module while you back up or restore files Fie Edit View Favorites Tools Help Ea Data Views i biagnostics Administrative Settings fld Device Configuration User Management Server Management Server Settings Backup Restore Time Settings Server Log 5 Browse Chassis L Send an Email Back gt A Bsearch Favorites CBristory Gy SH B 1 v Go Links gt Rockwell Automation Server Settings N Backup Restore N Time Settings N Server Log N B Backup Restore To perform a backup or a restore lock the website using the button below While the site is locked users will be unable to access any diagnostic or data view content and will be redirected to a backup restore notification page Administrators will have the ability to unlock the site when the backup restore process is complete Begin Backup Restore Lock Site Copyright 2004 Rockwell Automation Inc All Rights Reserved Locking the site prevents other users from HTTP access to the web server module Locking the site does not affect bridge functionality through the web server module however restoring files to the web server module that modify network or module configuration settings such as IP address can affect bridge functionality Publication ENET UM527E EN P October 2006
110. il Publication ENET UM527E EN P October 2006 Chapter 3 How to Use This Chapter 2a sce wit Se tien BO 47 Manage Module Information n on 4d be ORY 4nd ek 47 Define Module specific Information For the Home Page 48 Modify Network Parameters 20 000 49 Enable and Disable Communication Services 50 Manage Server Settings ig ek aid bale aa eee RG es 51 Customize Server Settings i ehh ably wate ates DoS a 51 Configure the Time Servers x 944 24 wk ee OK see O4 s 53 Display the Server Log n n anaana 54 Chapter 4 About This Chapter 7 a 0 had aaa eat ioari edeu mS 55 Data Views Overview 6 6 gk ick hbk re Ree 55 Tags Supported In Data Views 2 444 naaa asana aaua 56 Performance Estimates o n aaa 56 Create a Dat Viewin ae e E eee E E 57 Add Tags to a Data View anaua aaaea 58 Monitor Data Views and Tag Data 0005 59 Soit D ta Views minip roa teh 4 hee ee Be aed tek AY 60 Interface with the Logix Controller n oonan anaa 60 Edita D ta View n u ae A a ee a O E eae 61 Create Data Views Offline ehh ea rece ee DE et 62 Use an External Application to Access Data Views 63 Read a Data View with an External Application 63 Change Data In a Data View with an External Application 63 Example Data View XML noa baby wags a 64 Example Data View XML with Tag Values 65 Example Data View XML with Tag Errors 66 Chapter 5 About This Chapters c c
111. il it snaps into place 3 Connect the module to the network The RJ 45 connector is on the bottom front of the module 1756 EWEB Bottom RJ 45 EtherNet IP Connector Connect the cable here 4 Obtain an IP address For more information see chapter 2 By default the web server module is DHCP enabled If you connect the web server module to a network that has a DHCP server that server will assign a dynamic IP address to the web server module and the four digit display on the front of the web server module will display each of the four numbers of the IP address If your network does not have a DHCP server use one of the methods described in chapter 2 to assign an IP address to the web server module Publication ENET UM527E EN P October 2006 18 Getting Started 1768 EWEB Installation To install a CompactLogix Enhanced web Server module complete the following steps 1 Open the DIN rail latches on the module EtherNet IP om 2 Align and press the module onto the DIN rail to the left of the controller 3 Slide module snugly against the controller a c ETETE 00 0000 0000 ooo T 7 e
112. il to create and send email TIP You can have a controller execute a MSG instruction that initiates email through the web server module For more information see chapter 5 Publication ENET UM527E EN P October 2006 Getting Started Configure the Time Server Configuring the Time Server helps ensure that files you save to the web server module have accurate date and time stamps Complete the following steps to configure the time server 1 In the organizer on the left select Administrative Settings gt E Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation File Edit View Favorites Tools Help Server Management gt Time Settings lal xi Bak gt A Bsearch Favorites CBristory B 3 w A Address http 10 88 81 6 index html Go Links Minimize Home al Data Views Diagnostics Administrative Settings Device Configuration User Management Server Management Server Settings Backup Restore Time Settings Server Log 5 Browse Chassis L Send an Email nE Allen Bradley ENA EEAS CE Automation Server Settings N Backup Restore Y Time Settings N Server Log aj Server Time Snapshot THU JAN 01 01 39 29 1970 et Time Method SNTP Timeout sec 1 i IP or Hostname fio e8 69 10 Controller Slot 0 z Month Day Year Jan 01 Z 2004 Z SNTP Time Server Query Controller Clock
113. in e Internet Explorer select View Source and save the resulting text e Netscape or Mozilla select This Frame gt Save As You can also use the backup restore function to FTP a copy of the XML file See chapter 7 2 Scroll to the bottom of the Data Views page on the web server module a Use the Browse button to locate the XML data view file b Use the Download XML File button to copy the XML data view file to the module Data Views Xx Ba pemo Demo xrl 1 Test of 1 tag read write E New Data View ld Dinon x Ba quick_start_example quick start example xm 1 example of adding a tag to a new data view Administrative Settings Browse Chassis A send an Email I LBiowse _ Download xmL File Copyright 2004 Rockwell Automation Inc All Rights Reserved Data views are stored in the user system dataviews directory on the web server module Publication ENET UM527E EN P October 2006 Use an External Application to Access Data Views File Format XSL XSD Use Data Views to Access Controller Data 63 The XML format of data views makes the data views files accessible by user written programs Many programming languages such as Java and Visual Basic can process XML files User programs access data views by making HTTP requests This is just like a web browser except instead of displaying the data view the user program processes the XML data The browser uses an XSL stylesheet to display the
114. inistrator or Write access Enter the new value and click Update TIP To avoid impacting controller execution data view pages do not auto refresh Publication ENET UM527E EN P October 2006 60 Use Data Views to Access Controller Data Sort Data Views You can sort data views alphabetically by name filename or description or numerically by number of tags 1 Click a column name File Edit View Favorites Tools Help Back E ea a Bsearch Gia Favorites Bristory Es 3 m X a Address http 10 88 81 6 index html Anen Bradiey EVA EEE AS CE Minimize Data Views New Data View Click a column heading B home to sort the column View Name View Filename Number of Tags Description 1 bata views New Data View A Diagnostics Administrative Settings X Ba Demo Demo xml 1 Test of 1 tag read write x Ba quick_start_example quick start example xml 1 example of adding a tag to a new data view The first click sorts in ascending order 2 Click again to sort in descending order An arrow next to the column name shows the direction of the current sort You can also sort the tags within a data view by clicking on the slot tag name data type display as value or access headings in the column title Interface with the Logix Controller When you request to display a data view the module establishes one connection to the target controller Tag values are read
115. ion No ENET UMO001 1756 UM523 http www literature rockwellautomation com To order paper copies of technical documentation contact your local Rockwell Automation distributor or sales representative Publication ENET UM527E EN P October 2006 46 Configure a Network Address For a Web Server Module Publication ENET UM527E EN P October 2006 Chapter 3 How to Use This Chapter Manage Module Information Manage Module Settings This chapter describes how to configure module settings other than network parameters for the web server module Topic Page Manage Module Information 47 Manage Server Settings 51 To access and modify module specific information select Administrative Settings gt Device Configuration from the organizer on the left You can e define the module specific information that displays on the Home page e modify network parameters e enable disable communication services These settings are stored in flash memory and persist over power cycles Publication ENET UM527E EN P October 2006 48 Manage Module Settings In This Field Device Name Define Module specific Information For the Home Page Select Administrative Settings gt Device Configuration gt Device Identity to set specific text that identifies the module This information appears on the home page E Rockwell Automation Microsoft Internet Explorer provided by Rockwell Autom
116. ion Phone ___No there is no need to contact me Yes please call me Yes please email me at Yes please contact me via Return this form to Rockwell Automation Technical Communications 1 Allen Bradley Dr Mayfield Hts OH 44124 9705 Fax 440 646 3525 Email RADocumentComments ra rockwell com Publication ClG C0521C EN P May 2003 PN957988 64957782 91 Other Comments PLEASE FASTEN HERE DO NOT STAPLE PLEASE FOLD HERE BUSINESS REPLY MAIL FIRST CLASS MAIL PERMIT NO 18235 CLEVELAND OH POSTAGE WILL BE PAID BY THE ADDRESSEE Allen Bradley Erecraicly ROCKWELL SOFTWARE DOGE Rockwell Automation 1 ALLEN BRADLEY DR MAYFIELD HEIGHTS OH 44124 9705 NO POSTAGE NECESSARY IF MAILED IN THE UNITED STATES PLEASE REMOVE Rockwell Automation Support www rockwellautomation com Rockwell Automation provides technical information on the web to assist you in using its products At http support rockwellautomation com you can find technical manuals a knowledge base of FAQs technical and application notes sample code and links to software service packs and a MySupport feature that you can customize to make the best use of these tools For an additional level of technical phone support for installation configuration and troubleshooting we offer TechConnect Support programs For more information contact your local distributor or Rockwell Automation repres
117. ions PJ ftp administrator 10 88 81 8 Microsoft Internet Ex File Edit View Favorites Tools Help Back gt Qsearch Gyrolders CBristory This is the user directory _____ gy Address a ftp administrator 10 88 81 8 7 a 9 system x Li CI web 10 88 81 8 Server 10 88 81 8 User Name administrator 3 Select the files from your computer that you want to restore to the web server module 4 Copy the selected files to a directory on the web server module 5 Unlock access to the module by selecting Administrative Settings gt User Management gt Backup Restore Publication ENET UM527E EN P October 2006 Chapter 8 About This Chapter IMPORTANT Overview Create Custom Web Pages This chapter describes how to use ASP functions in custom web pages and how to load custom web pages into the web server module Topic Page Overview 91 Develop a Custom Web Page 93 ASP Function Calls 93 Javascript Libraries 98 Web Page Forms and POST Handlers 102 The web server module provides access to tags within a local controller via a web browser However the web server module is not recommended for use as a real time HMI or operator interface The predefined web pages that come with the module provide one method of accessing these tags The ability to load and run custom web pages gives you the flexibility to design web pages that better fit your application For exam
118. isting tag click the edit symbol name next to the tag 3 When you edit a tag the tag you selected is highlighted and the tag fields are populated with the previously configured information 2 Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation 218 x File Edit View Favorites Tools Help Ea Bak gt gt QO A Bsearch Favorites CBristory E4 SH B Address http 710 88 81 6 indexshtl G0 sa Allen Bradley EVE EEA SCE P esaia Data Views Y Edit Data View a Home a Data Views Data Views Ih TEST DINT f Decimal Admin 7 4 Name New Data View quick_start_example i disgnostics P p S EIA 3 Delete Edit Slot Tag Name Data Type Display As Access Descriptions Administrative Settings example of adding a tag 2 eee x Bay TEST DINT Decimal Admin ha anea data view v Slot Tag Name Data Type Display As Access Cancel Update Edit Data View L Send an Email Save View Cancel Copyright 2004 Rockwell Automation Inc All Rights Reserved 4 Change entries in the fields to meet your needs Publication ENET UM527E EN P October 2006 62 Use Data Views to Access Controller Data Create Data Views Offline You can create data views offline as XML files and later copy them into the web server module To create a data view offline 1 Use a text editor to create an XML data view file Right click in the data view and
119. ld Specifies Ethernet Interface Configuration Obtain Network Configuration Whether the module is configured to obtain its network parameters such as IP address via BOOTP DHCP or from static configuration Ethernet Link Autonegotiate Status Whether the port speed and duplex mode were determined via autonegotiation or whether they were manually configured Port Speed Whether the Ethernet port is operating at 10 Mbps or 100 Mbps Duplex Mode Message Connections Whether the Ethernet port is operating at half duplex or full duplex The Diagnostics gt Message Connections page presents a summary of messages bridged through or initiated by the web server module Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation File Edit View Favorites Tools Help 18 x Back gt A A Asearch Gayravorites Bristory B 3 fal A Address http 10 88 81 6 index html Go Links gt Rockwell Allen Bradley EVA CAS CE aia creas tha Diagnostic Overview NU Network Settings Y Message Connections N Ethernet Statistics Home id Data views Conn Connection Id Originator Target Bridged State Diagnostics 1 0x08501 10 88 69 9 10 88 81 6 Yes Active Diagnostic Overview ri Ox08D02 10 88 81 4 10 88 81 6 Yes Active Network Settings Message Connections Seconds Between Refresh 15 Disable Refresh with 0 Etherne
120. le 28 function calls 93 read CIP data 95 read controller tags 94 ReadLogixTag 94 ReadLogixTagUnconnected 94 retrieve web server information 97 authentication 77 back up file system 87 backup procedure 88 BOOTP DHCP utility 36 bridging 15 browser requirements 19 C CIP connections 121 CiPMessage 95 111 CiPMessageUnconnected 96 configure access limits 78 device services 50 DHCP server 32 DNS addressing 42 Index email 69 Home page 48 module information 47 MSG instructions 73 network parameters 31 49 server log 54 server settings 51 services 28 C configure con t timer server 53 user accounts 80 connect 84 connections CIP 121 overview 121 125 TCP TCP connections 123 control system data 96 create data views 57 62 offline 62 CreateSocket 141 custom web pages access 93 ASP function calls 93 ClPMessage 95 111 ClIPMessageUnconnected 96 conversion js 99 data views 102 develop 93 forms 102 Javascript libraries 98 overview 91 POST handlers 102 read CIP data 95 read controller tags 94 ReadLogixTag 94 ReadLogixTags 110 ReadLogixTagUnconnected 94 retrieve web server information 97 update control system data 96 WriteLogixTags 108 XMLObjectLoaderLib js 100 Publication ENET UM527E EN P October 2006 D data views user system dataviews 62 add tags 58 create 57 edit 61 examples 64 65 66 external application 63 interface with Logix5000 controller 60 monitor 59 offline 62 overview
121. le 33 The module home page displays Rockwell Automation Microsoft Internet File Edit View Favorites Tools Help r g Specify the IP address of the web etek gt OA Qoomn Gewa Gem GR a server module in the Address _ gt Address bttp 10 88 81 6 window of your web browser This is the module s Home page gt Allen Bradley EV ESA EAS lanl Home D Home Gi Data Views Device Name Web Server Example ay Diagnostics Device Description remote Administrative Settings Device Location site 1 Browse Chassis Ethernet Address MAC 00 00 BC 22 A0 07 1 Send an Email IP Address 10 88 81 6 Product Revision 1 2 1 Firrnware Version Date Jan 15 2004 02 10 55 Serial Number SN 001C82C6 Status Unkeyed Uptime 01h 21m 56s Copyright 2004 Rockwell Automation Inc All Rights Reserved The IP address from the DHCP server provides initial access to the web server module Check with your network administrator on whether you need to modify the IP address for future access to the module The network administrator might have you e convert the initial IP address to a static IP address e enter a different unique IP address and configure that new address as a static address e do nothing because the DHCP server was configured so that the initial IP address is already permanently assigned to the web server module e assi
122. le asks to confirm that you want to lock the site Microsoft Internet Explorer x P This will disable normal web site operation CIP performance may also be impacted cms This automatically enables FTP access to the web server module 2 Click the link to the web server module Publication ENET UM527E EN P October 2006 Access Files in the Web Server Module This appears on the locked backup restore page laix Fie Edit View Favorites Tools Help Ea Bak gt gt A search GaFavorites Hristory yx BH B Address http 10 88 81 6 index html c Jinks Allen Bradley ENA ESEE Example Locked y Heiek Backup Restore In Progress The administrator has temporarily disabled this site to perform a backup or restore process All diagnostics and data views are unaccessable until the backup restore process is complete To perform a backup use FTP to copy files out of the user directories To perform a restore use FTP to copy files into the user pinamana C ftp 10 88 81 6 After the backup restore operation is complete unlock the site to return to the home page Exit Backup Restore Unlock Site The module will require that you enter a valid user name and password that allows administrator access Once authenticated you have access to the user directory This is one directory higher than the user Web directory available during normal FTP operat
123. ler sends messages through the web server module to another Logix controller over Ethernet TCP IP connections for EtherNet IP communications As specified by the EtherNet IP protocol when the web server module communicates with another EtherNet IP module it first establishes a TCP connection with the target module The TCP connection is then used for CIP connected and unconnected messages Multiple CIP connections may be established over a single TCP connection Topic Page CIP Connections 121 TCP Connections 123 Connections are allocations of resources that provide more reliable communications between modules than unconnected messages Examples of web server functions that use CIP connections include data views one connection per controller slot sending email initiated by controller MSG instructions bridging messages through the web server module Publication ENET UM527E EN P October 2006 122 Use the Web Server Module To Connect Over Ethernet CIP communications take priority over HTTP communications Generally in the presence of heavy CIP traffic HTTP traffic may appear sluggish There are different types of CIP connections CIP Connection Type Description Bridged connection A bridged connection is a connection that passes through the web server module The end point of the connection is a module other than the web server module Example a connection from a controller through a 1756 E
124. m may encounter conditions that result in TCP connection loss For example a network cable can be unplugged or a target device can be turned off Your application program should detect the loss of TCP connections and handle those events appropriately You can detect connection loss when a e Read service returns with an error e Write service returns with an error other than EWOULDBLOCK See Possible Error Codes for Socket Services on page 155 Depending on the application you might want to e fault the controller e try to re establish the connection n the case of a client connection e wait for another incoming connection to be established Cin the case of a server connection If you want to re establish communications with the other device you must e delete the socket instance for the lost connection e if the connection is a client connection create a new socket instance and issue an OpenConnection service to the target device e if the connection is a server connection issue an AcceptConnection service to wait for another connection from the remote device Web Server Module Reset If the web server module is reset for example by cycling power or with Removal and Insertion Under Power RIUP all socket instances are lost If you create new socket instances while MSG instructions are still using the the old instance numbers there is a possibility that the new instance numbers will match the old instance n
125. mation Microsoft Internet Explorer provided by Rockwell Automation zg xj File Edit View Favorites Tools Help Bak gt search Favorites Bristory hy B Address http 10 88 81 6findex html Go Links Allen Bradley UNV omg lg eluate Automation Expand Eee Data views N New Data View aj tome Data Views Delete Edit View Name View Filename Number of Tags Description D vats views Xx Ba Demo Demo xml 1 Test of 1 tag read write New Data View rire x Ba quick_start_example quick start example xml 1 example of adding a tag to a new data view Administrative Settings Eid Device Configuration Ga User Management I Browse Download XML File Server Management browse Chassis C Sand n Email Copyright 2004 Rockwell Automation Inc All Rights Reserved The data view displays in an XML format using an XSL style sheet To quickly access the XML file right click in the data view and in e Internet Explorer select View Source and save the resulting text e Netscape or Mozilla select This Frame gt Save As You can also use the backup restore function to FTP a copy of the XML file See chapter 7 If the fields specified for the tag do not match the tag as it is specified in the controller this page indicates an error and the tag value shows xsi nil for its value From this page you can modify the value of a tag if you have Adm
126. meouts CIP Messaging Statistics umber of CIP connection timeouts Messages Sent umber of CIP connected messages sent Messages Received umber of CIP connected messages received UCMM Sent umber of CIP unconnected messages sent UCMM Received 2l z2 Z 2 umber of CIP unconnected messages received CIP connections are for Logix based communications such as MSG instructions RSLinx communications and PanelView communications A CIP connection transfers data from one Logix application running on one end node to a second Logix application running on another end node A CIP connection is established over a TCP connection Publication ENET UM527E EN P October 2006 116 Monitor Diagnostics Network Settings The Diagnostics gt Network Settings page presents a summary of the current Ethernet configuration for the web server module This summary includes e Ethernet address details e Ethernet interface type e Ethernet network configuration laixi Fie Edt View Favorites Tools Help Bak gt gt A Bsearch Favorites CBristory E4 SH Address http 10 88 81 6 index html z so Links E Rockwell Allen Bradley EA EEAS CME saat Gan tho Diagnostic Overview Y Network Settings N Message Connections Ethernet Statistics Minimize Home Gi Data Views Network Interface Diagnostics Ethernet Address MAC 00 00 BC 22 A0 07 Diagnostic O
127. meter and returns a string representing decimalnumber in binary notation The return value does not have a prefix and breaks the resulting binary string into groups of four characters Javascript Library XMLObjectLoaderLib js This library uses the conversion js library To include these libraries in your custom web page include these lines lt script type text javascript src scripts conversion js gt lt script gt lt script type text javascript src scripts XMLObjectLoaderLib js gt lt script gt The XMLObjectLoaderLib library requires an input file in XML format which describes the CIP object being returned from a GET_ATTRIBUTE_ALL service The following example shows the format of this input file lt object name IdentityInstance gt lt attribute index 1 name VendorID type UINT gt lt attribute index 2 name DeviceType type UINT gt lt attribute index 3 name ProductCode type UINT gt lt object index 4 name Revision gt type USINT gt type USINT gt lt object gt lt attribute index 5 lt attribute index 6 lt attribute index 7 lt object gt Publication ENET UM527E EN P October 2006 lt attribute index 1 name MajorRevision lt attribute index 2 name MinorRevision name Status type WORD gt name SerialNumber type DWORD gt name ProductName type STRING gt This description format is recursive structures within the object
128. n might use a fixed length for all messages For a variable length message the application might use a fixed length header that contains the length of the remainder of the message Both ends of the TCP connection must agree on the application protocol that is used Ethernet sniffer Additional Resources Topic MSG intructions An Ethernet sniffer is useful to monitor the messages between the web server and other devices You can capture network traffic and set up filters to isolate messages between particular devices and particular messages between those devices Consult the following publications for more information Publication Title Publication No Logix5000 Controllers Common Procedures 1756 PM001 EtherNet IP Modules in Logix5000 Control Systems ENET UMO001 User Manual Logix5000 Controllers General Instructions 1756 RMO01 Reference Manual You can view or download publications at http www literature rockwellautomation com To order paper copies of technical documentation contact your local Rockwell Automation distributor or sales representative Publication ENET UM527E EN P October 2006 162 Socket Interface Notes Publication ENET UM527E EN P October 2006 A AcceptConnection 146 access custom web pages 93 access levels classes 77 access limits configure 78 pre defined pages 79 Administrator access 78 ASP CIPMessage 95 ClIPMessageUnconnected 96 custom web pages 91 develop 93 enab
129. n plain text We recommend that you create a temporary Administrator account for use when you use FIP to access to the web server module Leave FIP disabled except for when actively copying files to or from the web server module Specify the IP address of the web server module _ gt Address Ftp 10 88 81 6 This is the user Web directory te Access Files in the Web Server Module 85 To connect to the web server module via FTP specify the IP address of the module 4 RAIN Top Index Microsoft Internet Exp File Edit View Favorites Tools Help 0 88 81 8 Microsoft Internet Ex jack v K g 4 sa gt GY Qsearch rites Tools Help Search yFolders lt 4distory Address a ftp administrator 10 88 81 8 a bei 7 system ea 2 Ld web 10 88 81 8 Server 10 88 81 8 User Name administrator Once connected to the web server module you have access to the user Web directory You can create subdirectories but you cannot access any directories higher than this user directory which contain predefined web pages and files The web server module supports four FTP sessions four different users with simultaneous FTP access to the module If you use Internet Explorer to FTP to the web server module there are only two FTP sessions available When the web server module is in backup restore mode an FTP session points to a different directory than when the web server mo
130. name DNS query did not complete A previous send service Publication ENET UM527E EN P October 2006 request with a host name as the SMTP mail server address did not yet complete Note that a timeout for a DNS lookup with an invalid host name can take up to 3 minutes Long timeouts can also occur if a domain name or name server is not configured correctly Chapter 6 About This Chapter User Accounts and Privilege Classes Manage User Accounts and Access Levels This chapter describes how to configure levels of user access to different information on the module Topic Page User Accounts and Privilege Classes 77 Configure Access Limits For Web Pages 78 Create User Accounts 80 Recover with Unknown Password 81 By assigning user accounts with different access levels you can manage which users have access to change network configuration or have access to view and change data views Several pages on the web server module such as module configuration pages and data views pages have default access protection Before accessing these pages you must authenticate your access by entering a user name and password The module displays the log in box when you access these web pages IMPORTANT Once authenticated you do not have to re enter a user name or password when accessing subsequent pages You must close your browser to log out The default user name is Administrator with no password IMPORTANT It is stro
131. nection e if you issue an AcceptConnection service the instance is listen type 146 e if the AcceptConnection service returns an instance as a result of an incoming connection request the socket instance Is server type Read Server or client 148 Write Server or client 151 DeleteSocket Server or client 153 DeleteAllSockets Server or client 154 Once you open a connection on a client socket instance you cannot use the same socket instance to accept incoming connections Similarly if you accept connections on a socket instance you cannot then use the instance to open outgoing connections This behavior is consistent with standard socket API behavior Publication ENET UM527E EN P October 2006 128 Socket Interface Logix Controller CreateSocket __ gt CreateSocketResponse_ lt a Instance 102 OpenConnection 10 10 10 11 Port 49200 lt 4 2ppenConnection Response ____ Write Data abe Read Read Response __ lt 4 Data xyz Publication ENET UM527E EN P October 2006 Typical Sequence of Transactions For a TCP Client The following diagram shows a typical sequence of socket interface transactions with the Logix controller acting as a TCP client Each transaction between the Logix controller and the web server is a MSG instruction The following example shows the Logix controller sending data to a device and then the device
132. ngly recommended that you set a password for the default Administrator account The web server module supports multiple user accounts each with a user name and password Each user account is configured for one of these access levels e Administrator all access e Write read and write access e Read read access only The access level determines which web pages each user can access You configure access limits for individual web pages Publication ENET UM527E EN P October 2006 78 Manage User Accounts and Access Levels Configure Access Limits For Web Pages Publication ENET UM527E EN P October 2006 You protect individual web pages and data views on a per URL basis Each page in the web server module has one of these protection levels e Administrator e Write e Read The protection levels are hierarchical Administrator users can access Write and Read protected pages and Write users can access Read protected pages These predefined pages those web pages that come with the web server module in the web server module have these default access levels You can change these access levels if needed Web Page Home page Required Protection Level No protection Diagnostics pages Chassis Browse page Data Views with read only tags Data Views with write tags Read protection Write protection Data Views with administrator tags Administrator protection Device configuration pages
133. ntain the status of the email transmission These tags can contain as many as 474 characters You must create a user defined STRING data type the default STRING data type in RSLogix 5000 software is not large enough for most email text For example create a STRING data type named EmailString Name EmailString Description Maximum Characters 520 A EmailString 0 Oi Predefined Oi Module Defined E3 1 0 Configuration B Members Data Type Size 524 Description LEN DINT Decimal DATA SINT 520 ASCII Publication ENET UM527E EN P October 2006 72 Send Email Create one controller scoped tag of this new data type to contain the email text Create a controller scoped second tag of this new data type to contain the transmission status For example create tag EWEB_EMAIL to contain the email text and EmailDstStr to contain the transmission status Both of these tags are of type EmailString Scope email controller v Show Show All v Sot Tag Name z Force Mask Style Type EmailConfigstring 10 88 128 111 array STRING Tag For Status p EmailDstStr 1 fea EmailString Tag For Email Text gt EWEB_EMAIL Ea Wforpersoni iye coated From n Gan EmailString SendEmailE up S MESSAGE SetupMailServer a ay MESSAGE Click in the Value box to display this button f String Browser EWEB_EMAIL 3 z A To personl xyz com r l1 From
134. ntroller initiating the MSG instruction module Then enter the port the message exits and the address of the next module in the path For example if the web server module is in the same chassis as the controller and is in slot 2 the path is 1 2 If all the devices in the path are configured in the initiating controller s I O Configuration tree you can use the Browse button to select the Send Email 75 target web server module and the software automatically fills in the path For more information on configuring the path of a MSG instruction see the Logix5000 Controllers General Instructions Reference Manual publication 1756 RMO003 Enter the Text of the Email Use the string browser to enter the text of the email In the example above you enter the email text into the EWEB_EMAIL tag To include To From and Subject fields in the email use lt CR gt lt LF gt symbols to separate each of these fields The To and From fields are required the Subject field is optional Use a second set of lt CR gt lt LF gt symbols after the last one of these fields you enter For example To email address of recipient r 1 From email address of sender r 1 Subject subject of message r 1 r 1 body of email message The maximum length of an email message is 474 characters An additional 4 byte string length value is added to the tag As a result the maximum source length is 478 characters Possi
135. oller for both time and date At subsequent power ups the web server module queries the controller Manual Time Entry Manually set the time and date Manual settings do not persist over power cycles Local Time Offsets Select the appropriate time zone This selection is only available when you select SNTP time server as your Get Time Method Update Time at Constant Interval Select how often the web server module updates its date and time Set Controller Date Time Use the date and time in the web server module to set the date and time in the local controller You must also specify the slot number of the local controller Important This feature provides accurate time synchronization to within one second Publication ENET UM527E EN P October 2006 54 Manage Module Settings 2 Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation Display the Server Log To display the server log select Administrative Settings gt Server Management Server gt Server Log This page when enabled displays records of web accesses to the web server module Only those information fields that are enabled on the Server Setting page see page 51 appear in the server log The information displayed on this page is stored in RAM and does not persist over power cycles 181 x File Edit View Favorites Tools Help SBa gt A Bsearch Favorites CHristory F
136. om Web Pages 43 tk ee RAL as 93 Develop a Custom Web Page a anaana naaa 93 ASP F nctjon Calls ogmissa hg eea Peewee Guhl Ge a ewes cans 93 Read Controller Tags es ce dhe seen ek es 94 Read CIP AA prre pea tr ose fac Baa Ads Bee os EG ae AE Eee ae 95 Update Control System Data o Pek 2 el tne BS 96 Retrieve Information About the Web Server Module 97 Javascript Libraries nnana aaa 98 Javascript Library Conversion js o oo asaue 99 Javascript Library XMLObjectLoaderLib js 100 Web Page Forms and POST Handlers 2 8 5 44 444 944 102 ACTION user system dataviews filename xml 102 ACTION rokform WriteLogixTags 108 ACTION rokform ReadLogixTag 5 110 ACTION rokform CIPMessage 0005 111 Chapter 9 About This Chapter i dep shi h 4 be Se Bed ete Rear MS Redes 113 Web Server Module Diagnostics 00 5 113 Diagnostics Overview 2 4 euteds ois Olek S Ain Sexe es 114 Network Settings n o cute oe aaaea 116 Message Connections e e awata tanao e e e eia a i 117 Ethernet Statistics s s man g e EES ERLE RaSh EEN A 119 Publication ENET UM527E EN P October 2006 8 Table of Contents Use the Web Server Module To Connect Over Ethernet Socket Interface Publication ENET UM527E EN P October 2006 Appendix A ADOUR This Appendix se css wes oe te ee ee eb 121 CIP COMME CIOS sene oiee ea aa Be Me a Sy Be Tn 121 CIP Connected Me
137. on Microsoft Internet Explorer provided by Rockwell Automation _ lalxi Fie Edit View Favorites Tools Help Ea SBa gt A Bsearch fayravorites CHristory yv SH Address httpufio ss ai eindechim G0 Links Allen Bradley ENESA EAS eluate Automation Data Views Y New Data View P Home Data Views slg Tame Data Type Display As Access dd Create Data View Data Views TEST DINT Decimal a admin a e Oime New Data View quick_start_example el A Delete Edit slot Tag Name Data Type Display As Access Description Administrative Settings example of adding a tag amp P Device Configuration to a new data view 7 Ci User management Create View Cancel fd server Management O srowse chassis Bia eee Copyright 2004 Rockwell Automation Inc All Rights Reserved Publication ENET UM527E EN P October 2006 58 Use Data Views to Access Controller Data In This Field Slot 3 Click the Add button g to add the tag you just specified You can add multiple tags to the data view as long as there are no more than 2500 tags in all the data views of one web server module 4 Click the Create View button to create the data view Add Tags to a Data View When you add a tag to a data view you specify the following information Specify Slot number of the controller Details Click on the question mark next to Slot Slot 2 OR Use the Chassis Browse page to validat
138. ons o P Administrative Settings CPU 0 30 CIP Connection Limit 126 i File System 8 16 erowse chassis DE Max Connections Observed o L Send an Email Conn Opens o Web Server Open Errors o Available User Space 4458496 bytes Conn Closes o Data Views Configured 2 Close Errors o Total Controller Tags 2 Conn Timeouts o Server Errors 12 Redirects 24 y FEA CIP Messaging Statistics Timeouts o Messages Sent 19 Access Violations o Messages Received 19 Page Hits 658 UCMM Sent 46 Form Hits 42 UCMM Received 46 Total Hits 734 Seconds Between Refresh 15 Disable Refresh with 0 Copyright 2004 Rockwell Automation Inc All Rights Reserved sl pH Done Internet This Field Specifies Ethernet Link Speed Whether the Ethernet port is operating at 10 Mbps or 100 Mbps Duplex Whether the Ethernet port is operating at half duplex or full duplex Autonegotiate Status Whether the port speed and duplex mode were determined via autonegotiation or whether they were manually configured System Resource Utilization CPU Current percent CPU utilization for the web server module File System Utilization Current percent utilization of the space available for user files Publication ENET UM527E EN P October 2006 This Field Web Server Monitor Diagnostics 115 Specifies Available User Space Current number of bytes available for user files Data Views Configured Total number of data vie
139. ons prior to deleting the instances MSG Configuration Parameters To call this service click in the MSG instruction and enter the values displayed below Message Configuration msg1 Configuration Communication Tag Message Type CIP Genetic v Service Custom Source Element ha Type Source Length d Bytes Service Code 51 Hex Class 342 Hex DEEN E Instance 0 Attribute 0 Hex New Tag You must specify Custom for the Service Type There is no drop down selection for Delete All Sockets MSG Source Element Not used MSG Source Length 0 MSG Destination Element Not used Considerations Call the DeleteAllSockets service with instance 0 Be careful when using DeleteAllSockets when there are multiple controllers using the socket interface of the web sever module DeleteAllSockets deletes all socket instances created by all controllers not just the controller calling the service Possible Error Codes for Socket Services Socket Interface 155 A typical use of DeleteAllSockets is when application development and debugging is complete Use DeleteAllSockets as the first operation when the program first begins to operate If the Socket Object encounters an error with a service request or while processing the service request e The Socket Object returns an error code e The MSG instruction sets the ER bit e The MSG instruction sets error codes in the ERR and EXTERR fiel
140. ource tag so that old data is not sent Socket Interface 139 This fragment Structured Text logic shows an example of handling a partial Write service if WriteMSGO ER then write failed if error was EWOULDBLOCK then it means less than the requested byte were sent aA if WriteMSGO EXERR 70 then need to issue another write with the data that was not sent SentLen WriteResponse here s what was sent adjust the size WriteParams BufLen WriteParams BufLen SentLen copy remaining data to send to MSG buffer COP WriteBuf SentLen WriteParams Buf 0 WriteParams BufLen BufLen Timeout Sockaddr data length WriteMSGO REQ_LEN 4 12 WriteParams BufLen MSG WriteMSGO end_if end_if Publication ENET UM527E EN P October 2006 140 Socket Interface Socket Object Services IMPORTANT Publication ENET UM527E EN P October 2006 The Socket Object supports these services For This Socket Service See Page CreateSocket 141 OpenConnection 143 AcceptConnection 146 Read 148 Write 151 DeleteSocket 153 DeleteAllSockets 154 From the perspective of the Socket Object application data has no inherent byte order The service receives data in the same byte order as it is sent However the Logix controllers stores data on CIP byte order little endian For example if you issue a Write s
141. p dt_SINT path 1 1 display Decimal te gt e xsi nil true gt e test_tag_int valueType cip dt_INT path 1 1 display Decimal tets e xsi nil true gt e test_tag_dint valueType cip dt_DINT path 1 1 display Decimal tats e xsi nil true gt e test_tag_real valueType cip dt_REAL path 1 1 display Decimal terts e xsi nil true gt e test_tag_string valueType cip dt_STRINGI path 1 1 ring access write gt e xsi nil true gt Publication ENET UM527E EN P October 2006 Use Data Views to Access Controller Data 65 Example Data View XML This is an example XML markup for a data view named alltypes loaded with current tag values The data view contains one tag for with Tag Values each of the supported data types The tags are in the controller residing in slot 1 lt xml version 1 0 gt lt xml stylesheet href dataview dataview xsl type text xsl gt lt v1lew xmlns http www rockwellautomation com technologies data_access data_views 1 0 xmlns xsi http www w3 org 2001 XMLSchema instance xsi schemaLocation http www rockwellautomation com technologies data_access data_ views 1 0 schema dataview xsd xmlns cip http www rockwellautomation com technologies data_access data_types 1 0 name alltypes description gt lt tag name test_tag_bool valueType cip dt_BOOL path 1 1 display String access write gt lt value xsi ty
142. pe cip dt_BOOL gt TRUE lt value gt lt tag gt lt tag name test_tag_sint valueType cip dt_SINT path 1 1 display Decimal access write gt lt value xsi type cip dt_SINT gt 123 lt value gt lt tag gt lt tag name test_tag_int valueType cip dt_INT path 1 1 display Decimal access write gt lt value xsi type cip dt_INT gt 28416 lt value gt lt tag gt lt tag name test_tag_dint valueType cip dt_DINT path 1 1 display Decimal access write gt lt value xsi type cip dt_DINT gt 1459879936 lt value gt lt tag gt lt tag name test_tag_real valueType cip dt_REAL path 1 1 display Decimal access write gt lt value xsi type cip dt_REAL gt 247882776235710380000000000000000000 000000 lt value gt lt tag gt lt tag name test_tag_string valueType cip dt_STRINGI path 1 1 display String access write gt lt value xsi type cip dt_STRINGI gt aazz lt value gt lt tag gt lt view gt Publication ENET UM527E EN P October 2006 66 Use Data Views to Access Controller Data Example D with Tag Er lt xml versi ata View XML rors This example a data view named alltypes with error messages for tags that could not be retrieved on 1 0 gt lt xml styl lt view ins http ins xsi xSi schemaL views 1 0 xm xm xm lns cip name al lt tag nam access wri sheet href dataview dataview xsl
143. ple you can define a web page with standard web content such as a company logo contact information and links to other web pages Add the ASP functions to display live controller data Use your own editor or application to develop the appropriate HTML and ASP files for your custom web pages Once these files are ready you copy the files to the web server module and configure the pages as needed The following steps outline the process of developing custom web pages and getting them ready to use 1 Develop the appropriate HTML and ASP files See Develop a Custom Web Page on page 93 for information about the available ASP functions and other features for displaying and changing controller data 2 Use FTP to copy the custom pages to the web server module Publication ENET UM527E EN P October 2006 92 Create Custom Web Pages 3 Copy your files into the user Web directory See chapter 7 for more information 4 Decide whether to make your custom page the default Home page for the web server module Select Administrative Settings gt Server Management Server gt Server Settings When you click the Custom button the web server module automatically fills in the user Web portion of the location of the custom file Enter in any further directories and the file name Click Apply Changes TIP 2 Rockwell Automati Microsoft Internet Explorer provided by Rockwell Automation xi File Edit View Favorites Tools Help
144. plication gzip bin application octet stream oda application oda pdf application pdf al application postscript eps application postscript ps application postscript xml text xml xsl text xml In addition files with an asp extension are processed by the web server as Active Server Pages For more information on creating custom web pages see chapter 8 Access Files in the Web Server Module 87 Back Up the File System On the Web Server Module E Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation There are several items stored on the web server module that you might want to archive in a backup copy e User accounts and passwords e List of URLs selected for read write or administrator protection e Data views e Custom web pages e Module configuration data To back up these files you use standard FTP to access the web server module and then copy or restore files Using FTP lets you copy files to or from the web server module without interrupting operation of the module FTP also lets your standard FTP capable clients such as Internet Explorer or WinZip to copy the system files FTP access during a backup restore procedure differs from normal FTP access in that you get access to the user directory which contains the Web directory that is accessible during normal FTP access This lets you back up predefined web pages and data views as well as any custom files you have cop
145. r occurred when attempting to write the SMTP server address attribute 4 to non volatile memory OxFF 0x0100 Error returned by email server check the Destination string for reason The email message was not queued for delivery 0x0101 SMTP mail server not configured Attribute 5 was not set with a SMTP server address 0x0102 To address not specified Attribute 1 was not set with a To address AND there is not a To field header in the email body 0x0103 From address not specified Attribute 2 was not set with a From address AND there is not a From field header in the email body 0x0104 Unable to connect to SMTP mail server set in Attribute 5 If the mail server address is a hostname make sure that the device supports DNS and that a Name Server is configured If the hostname is not fully qualified i e mailhost and not mailhost xx yy com then the domain must be configured as xx yy com Try ping lt mail server address gt to insure the mail server is reachable from your network Also try telnet lt mail server address gt 25 which attempts to initiate a SMTP session with the mail server via telnet over port 25 If you connect then enter QUIT 0x0105 Communication error with SMTP mail server An error occurred after the initial connection with the SMTP mail server See the ASCII text following the error code for more details as to the type of error 0x0106 SMTP mail server host
146. ries ftp 10 88 81 6 pfrestore operation is complete unlock the site to return to the home page Exit Backup Restore Unlock Site Publication ENET UM527E EN P October 2006 Access Files in the Web Server Module 89 The module will require that you enter a valid user name and password that allows administrator access Once authenticated you have access to the user directory This is one directory higher than the user Web directory available during normal FTP operations ftp administrator 10 88 81 8 Microsoft Internet Ex File Edit View Favorites Tools Help Back Search Gyrolders lt 4distory This is the user directory fj address a ftp Jadministrator 10 88 81 8 3 system H Q Ll web 10 88 81 8 Server 10 88 81 8 User Name administrator 3 Select the files you want to back up 4 Copy the selected files to a directory on your computer 5 Unlock access to the module by selecting Administrative Settings gt User Management gt Backup Restore Restore Files You must have Administrator access to restore files To restore files from your computer to a web server module 1 Select Administrative Settings gt Server Management gt Backup Restore and click Lock Site to lock access to the web server module You must lock access to the web server module to gain FTP access to the user directory The web server modu
147. rify network parameters 44 Publication ENET UM527E EN P October 2006 W Write 151 Write access 78 WriteLogixTags 108 X XML data views 55 enable 28 example data view 64 65 66 format 59 typical application 14 How Are We Doing PANE Your comments on our technical publications will help us serve you better in the future Thank you for taking the time to provide us feedback wy You can complete this form and mail or fax it back to us or email us at RADocumentComments ra rockwell com Pub Title Type EtherNet IP Web Server Module Cat No 1756 EWEB Pub No ENET UM527D EN P Pub Date May 2006 PartNo 957988 64 Please complete the sections below Where applicable rank the feature 1 needs improvement 2 satisfactory and 3 outstanding Overall Usefulness 1 2 3 How can we make this publication more useful for you 2 3 Can we add more information to help you Completeness all necessary information procedure step illustration feature is provided ere example guideline other explanation definition Technical Accuracy 1 2 3 Can we be more accurate all provided information l is correct text illustration Clarity 1 2 3 How can we make things clearer all provided information is easy to understand Other Comments You can add additional comments on the back of this form Your Name Your Title Function Would you like us to contact you regarding your comments Locat
148. ring length The MSG instruction that issues the OpenConnection service should have a Source Length of 8 Timeout AddrLen plus the number of characters in the destination address MSG Source Length Specify 8 bytes Timeout AddrLen number of characters in the destination address Socket Interface 145 MSG Destination Element Not used the MSG instruction does not return any data Considerations In some cases the OpenConnection service can return before the timeout period without creating a TCP connection For example if the destination device is running but is not listening for connections on the specified port number OpenConnection returns with an error before the timeout period For UDP if you use OpenConnection you do not have to specify the IP address and port number each time you send data If you do not specify an IP address and port number you can only receive data from the previously specified IP address and port number until you call OpenConnection to specify a different IP address and port number For UDP if you do not use OpenConnection you must specify the destination address each time you call the Write service to send data When you call the Read service in addition to the data you receive the address of the sender You can then use the address of the sender to send a response via the Write service If you call OpenConnection on a UDP socket with an AddrLen of 0 this removes the association with
149. s Reserved n a http www rockwellautomation com a Internet For more information see chapter 2 Publication ENET UM527E EN P October 2006 22 Getting Started Navigate the Web Server You navigate the web server s web pages using the organizer on the Module Use the organizer to navigate folders left of the screen You can also use the tabs across the top to navigate the sections within folders Use tabs to navigate pages within folders 2 Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation File Edit View Favorites Tools Help Bak gt A Bsearch fayravorites CBristory Ey SH B Address http 10 88 81 6findex html Allen Bradley GNP omst 1a l l gt eluate i vata views Device Name Web Server Example Diagnostics Device Description remote Administrative Settings Device Location site 1 Device Configuration Ethernet Address MAC 00 00 8C 22 A0 07 Okara Identity IP Address 10 88 81 6 Network Configuration Product Revision 1 24 Device Services Firmware Version Date Jan 15 2004 02 10 55 Email cenfiatratery Serial Number SN 001C82C6 User Management Status Unkeyed Server Management Uptime 01h 45m 47s 5 Browse Chassis L Send an Email Copyright 2004 Rockwell Automation Inc All Rights Reserved Publication ENET UM527E EN P October 2006 Getting Started 23 Use the Web Serv
150. s manual explains the use of the following EtherNet IP Web Server modules e 1756 EWEB e 1768 EWEB This manual is intended for anyone who accesses configures or manages the web pages EWEB module Bold Avaluethatyoumustenterexactlyasshown Italic A variable that you replace with your own text or value courier Example programming code shown in a monospace font so you can identify each character and space enclosed in brackets A keyboard key Publication ENET UM527E EN P October 2006 12 Publication ENET UM527E EN P October 2006 Chapter 1 Getting Started Introduction This chapter describes procedures for getting started with your EtherNet IP Web Server module It includes information about the module and quick start procedures Topic Page About the Enhanced Web Server Module 13 Enhanced Web Server Module Applications 14 Features of EtherNet IP Web Server Module in a 15 Control System 1756 EWEB Installation 17 1768 EWEB Installation 18 Access the Module Using Your Web Browser 19 Access the Module Using Your Web Browser 19 Use the Web Server Module 23 Create a Data View 23 Access a Data View 24 Configure Email 26 Configure the Time Server 28 Enable disable Other Services 28 About the Enhanced Web Both the 1756 EWEB and 1768 EWEB modules known as Enhanced Web Server modules provide access to information from the control Server Module system using a web
151. sending a response This is a typical sequence of transactions Depending on the application protocol the device could instead initiate sending data to the Logix controller once the connection is open Additionally each Write does not require an application response or acknowledgement The application protocol determines the exact sequence of application transactions Web Server Module Device 10 10 10 10 10 10 10 11 p BEERE Open TCP Connection gt Accept Connection a Oa Dele abe Receive Write Response Data The response is returned to the controller as soon as the data is sent Send y Data lt Data xyz Socket Interface 129 Typical Sequence of Transactions For a TCP Server The following diagram shows a typical sequence of socket interface transactions with the Logix controller as a TCP server Each transaction between the Logix controller and web server is a MSG instruction The following is a typical sequence of transactions The exact sequence of sending and receiving data depends on the application protocol Logix controller CreateSocket p Port 49100 CreateSocket Response lt Instance 102 AcceptConnection ae AcceptConnection m Response Read a A Read Response _ Data abc Write Data xyz SS MW a ee a Write Response a _ _ The response is returned to the W
152. sockets you need your program may encounter errors during Run Program Run transitions because all of the available socket instances are in use To alleviate this situation 1 Wait for all socket instances to time out before putting the controller in Run mode 2 When the Logix5000 program starts use the DeleteAllSockets service to delete any previous instances The DeleteAllSockets service deletes ALL socket instances not just those created by the controller calling the service Socket Interface 137 Application Messages and TCP A TCP connection is a byte stream between two application entities The application protocol determines the message formats Messages can be fixed size or variable size If an application sends variable size messages a common strategy is to first send a fixed size header containing the size of the message followed by the message The receiving device can first issue a Read of the fixed size header to determine the remaining size and then issue a subsequent Read to receive the remaining data Partial Reads It is possible for a Read service to return a BufLen that is less that the requested amount of data For example your program may request 100 bytes of data Because TCP is a byte stream and not a datagram protocol you can receive less than 100 bytes when the Read service returns Depending on the application protocol issue additional Read requests to receive all the data If the application
153. sponse contains all of the above attributes in the order shown above total size of 36 bytes If you use Set Attributes All the request must include attributes 3 4 5 6 and 7 in that order total size of 20 bytes Publication ENET UM527E EN P October 2006 160 Socket Interface Troubleshoot Socket Applications Web Page To help debug and troubleshoot applications the socket interface provides a set of web pages located in the web server s Advanced Diagnostics folder Description Socket Object Diagnostics Displays information about on each existing instance e Instance number e Socket type client server or listen e Local and remote ports and IP addresses e Send and receive buffer sizes e Socket up time and inactivity time e Socket state and last error state Socket Object Statistics Displays attribute settings for each instance Socket Object Log Displays a log of service requests maximum of 50 log entries e Service requests made to the socket object e For each request shows parameters passed and the result of service success failure You can enable disable logging for some services by setting Class attribute 8 Log Enable See Socket Object Class Attributes on page 158 Debugging Hints and Tips Category Consideration Web server module Make sure the web server module has a valid IP address Also if you communicate with devices on different subnets configure the web server with a v
154. ss you must also configure a host name for the module domain name and primary secondary DNS server addresses In the DNS server the host name must match the IP address of the module Make sure the DNS enable bit is set If you configure your module using RSLinx software version 2 41 00 or later the enable bit is cleared and DNS addressing will not work If you configure your module using the Port Configuration tab in RSLogix 5000 software the enable bit is set so DNS addressing should work 3 In RSLogix 5000 software add the module to the I O configuration tree and enter the host name in the General tab of the module If a child module resides in the same domain as its parent module just enter the host name If the child module is in a different domain that its parent module you must enter the host name and the domain name host domain You can also use DNS addressing in a module profile in the I O controller tree or in a message path If the domain name of the destination module is different from the source module use a fully qualified DNS name hostname domainname For example to send a message from ENBT1 locationl companyA to ENTB1 location2 companyA the host names are the same but the domains are different If you do not enter a fully qualified DNS name the module appends the default domain name to the specified host name Publication ENET UM527E EN P October 2006 44 Configure a Network Address For a Web S
155. ss of the sender This address is where you want any replies to this email to go It is not an email address of the web server module The web server module only sends email and does not receive email Subject Subject line of the email Text window The email text Click Send after you specify the email address and enter the text Publication ENET UM527E EN P October 2006 Send Email n Send an Email with a Controller initiated Message Instruction f RSLogix 5000 email in email sample ACD File Edit View Search Logic Communications Tools alia 8 EEN Offline 1 E RUN l H No Forces b a No Edits Ar sh 4 Fea Controller email I Controller Tags Controller Fault Handler CI Power Up Handler Tasks EE MainTask amp MainProgram C3 Unscheduled Programs Motion Groups CI Ungrouped Axes Trends Sj Data Types Ci User Defined A Logix controller can send a generic CIP message instruction to the web server module that instructs the web server module to send an email message to a SMTP mail server using the standard SMTP protocol This is useful to automatically communicate controller data and or application conditions to appropriate personnel IMPORTANT Be careful to write the ladder logic to ensure the MSG l instructions are not continuously triggered to send email messages Create String Tags You need two controller scoped string tags one to contain the email text and the other to co
156. ssage Configuration SocketClassMSG Service Get Attribute Single v Type Service em 3 j2 Code 2 bes Be pa Hex Destination Attribute 3 Hex CIP Generic F Numlnstances X New Tag Some socket attributes apply to all sockets and some apply to specific socket instances In the CIP Generic MSG Type Specify 0 for the Instance socket class Refer To Attributes for All Socket Services on page 146 A specific socket instance The specific socket instance number for the Instance the instance number is returned by a CreateSocket or AcceptConnection service Attributes for Specific Socket Instances on page 147 Publication ENET UM527E EN P October 2006 158 Socket Interface Socket Object Class Attributes The Class attributes apply to the Socket Object not to specific socket instances When you get or set a Class attribute set the instance to 0 Class Name Data Type Access Description Attribute 1 Revision INT Get Object revision 2 Max Instance INT Get Largest socket instance number currently created 3 Number of Instances INT Get Number of socket instances currently created 8 Log Enable DINT Get Enable or disable logging to the Socket Object Log web page Set Each socket service has a corresponding bit If enabled Publication ENET UM527E EN P October 2006 requests for that service request are logged If clear then requests for that service are not logged Bi
157. ssaging Update Control System Data You can use the CIPMessage and CIPMessageUnconnected functions to perform any CIP service such as a SET_ATTRIBUTE_SINGLE RESET or any other type of write or update service to an object or object instance However since ASP pages are parsed and executed server side it is impossible to send any dynamic data to these services As an example consider a page which performs a reset to the identity object of a device in slot 1 then immediately redirects the browser to the main user page lt HTML gt lt HEAD gt lt CIPMessageUnconnected 1 1 5 1 1 0 0 STRING gt lt META HTTP EQUIV refresh content 0 URL user index html gt lt HEAD gt lt BODY gt lt BODY gt lt HTML gt T Create Custom Web Pages 97 Retrieve Information About the Web Server Module Function Parameters Parameter settingname Value nu uptime device_status firmware_revision firmware_version serial_number GetSetting You can retrieve specific information about the web server module settingname The Get Setting function retrieves a specific piece of information about the web server module itself and writes this data to the browser The settingname specifies the piece of information to retrieve where settingname can be Description These fields as displayed on the predefined home page See page 22
158. ssaging Limits 122 CIP Unconnected Messaging Limits 122 TEP CONNECHONS 2 ofthe ee ie ease aE a es eae SHAS 123 Additional Resources noana aaau 4 9 by SO RG REE Boke 123 Appendix B About This Appendix 3 05040 4a sw aslate oon e205 125 Before VOW Bea isu cine tt arated ence Aaieteieh ois 126 Socket Interface Architecture 0 ee 126 Number and Type of Sockets nnna naaa 126 Typical Sequence of Transactions For a TCP Client 128 Typical Sequence of Transactions For a TCP Server 129 Typical Sequence of Transactions For UDP Without OpenConnectiONn erie ak i i a aa i ane Meee 130 Typical Sequence of Transactions For UDP With OPENCONNe HOM esna e aa e e ie Roa we EE a gaa 131 Communicate With the Socket Object Via a MSG Instruction 132 Message Transfer Sizes odin Ara he Kee Hanes 133 Service TIMES aay aon A a E E bed 134 MSG Instruction Timeouts o a aaa we oe ee Sy ade brads 134 Socket Instance Timeouts o oo naana a 134 Programming Considerations sso do ed eee Ae ee ed 135 TCP Connection LOSS osasu aaa 135 Web Server Module Reset nonna anaana aaa 135 Change Controller Mode Between Run and Program 136 Application Messages and TCP nananana anaana 137 Partal RCAC S aoe ip iat dant cok e Gia aeae e in pee sae 137 PATA WES B Seos aged e veka eee aa ee ei ek a 138 Socket Object Services Sea CES S58 S 4 85 4 2S Pet ES AS 140 GreateSocket ios no ae enh ie a ae eee ER oe ere
159. st be one complete line that can wrap within your text editor or you must enter line continuation characters to separate lines All data view and tag names are case sensitive If you copy the following example you must either shorten the example alert text or remove the newlines carriage returns or linefeeds that appear when you paste the code into your text editor For example either of these alert statements follows correct syntax alert You need Internet Explorer 5 5 or greater with XML support or alert Creating editing a data view requires Internet Explorer 5 5 or greater with XML support Please upgrade your browser or load the appropriate patches to support XML 5 Save the edited code as an html file such as xmlSample html 6 FTP the file Transfer xmlSample html to the web server module 7 Test http ip_address user Web xmlSample html You can download application example files from the RA Knowledgebase See Technote A142365164 Example files for 1756 EWEB module Publication ENET UM527E EN P October 2006 104 Create Custom Web Pages For example this code lt html gt lt head gt lt title gt Data View Javascript Demo Page lt title gt lt script type text javascript gt var xmlDoc var xmlhttp var DATAVIEW_URI user system dataviews Sample xml var DATAVIEW_NAMESPACE http www rockwellautomation com technologies data_access data_views 1 0 var
160. stance 25964 Attribute 0 Hex New Tag MSG Source Element Create a user defined data type Name WriteParams Description Parameters for Write service Members Data Type Size 496 byte s milliseconds Decimal Decimal 2 for IP4 family Decimal Port number Hex Local IP 0 BufLen DINT Decimal Num bytes to send Buf SINT 480 Decimal Data to send Publication ENET UM527E EN P October 2006 152 Socket Interface where Element Data Type Description Timeout DINT Specify the timeout in milliseconds ToAddr structure A user defined structure that specifies the address to write Family INT Specify the address family Must be 2 Port INT Specify a local port number or set to 0 the local port number will be chosen by the web server For TCP client operations specify 0 unless you want a specific local port number For TCP server communications specify the port number on which to accept incoming connection requests For UDP to receive datagrams ona specific port you must specify a local port number Addr DINT Specify an IP address Typically set to 0 any address BufLen DINT Specify the number of bytes of data to write Buf SINT array Specify the data to write MSG Source Length Publication ENET UM527E EN P October 2006 Specify 16 bytes Timeout Addr BufLen number of bytes to write MSG Destination Element The MSG instruction returns the number of bytes
161. t 0 CreateSocket requests Bit 1 OpenConnection requests Bit 2 AcceptConnection requests Bit 3 Read requests Bit 4 Write requests Bit 5 DeleteSocket and DeleteAllSockets requests Bit 6 Get Set Attribute requests Bit 7 Log all service errors If you use Get Attributes All to get the class attributes the response contains all of the above attributes in the order shown above total size of 10 bytes Since there is only one attribute Log Enable a Set Attributes All request contains only the Log Enable attribute Socket Interface 159 Socket Object Instance Attributes The Socket Object provides a number of instance attributes that apply to specific socket instances To get or set an instance attribute specify a valid instance number Instance Name Data Type Access Description Attribute 1 LocalAddr Struct SockAddr Get Local address for the socket 2 RemoteAddr Struct SockAddr Get Remote address for the socket 3 SendBufSize DINT Get Size of the socket send buffer bytes Set 4 RecvBufSize DINT Get Size of the socket receive buffer bytes Set 5 TCPKeepAlive DINT Get Enable 1 or disable 0 TCP Keep Alive for the socket Enabled by default Set 6 TCPNoDelay DINT Get Enable 1 or disable 0 the TCP No Delay behavior Enabled by default Set 7 Inactivity Timeout DINT Get See above section on Inactivity Timeout Set If you use Get Attributes All to get the instance attributes the re
162. t Statistics Advanced Diagnostics P Copyright 2004 Rockwell Automation Inc All Rights Reserved Administrative Settings Browse Chassis L Send an Email ri Internet This Field Specifies Conn Connection ID The relative index of this connection on the Message Connections page The unique identifier for each connection Originator The IP address of the device that originated the connection on Ethernet network Publication ENET UM527E EN P October 2006 118 Monitor Diagnostics This Field Specifies Target The IP address of the device that is the target of the connection on Ethernet This may not be the ultimate target of the connection e g the target could be a Logix controller in a chassis Bridged Whether the connection bridges through the web server module State The current state of the connection e Active e Closing e Faulted e Reserved Publication ENET UM527E EN P October 2006 Monitor Diagnostics 119 Ethernet Statistics The Diagnostics gt Ethernet Statistics page presents a summary of the status of communication activity on the Ethernet network This summary includes e Ethernet network configuration e Packets sent and received over the Ethernet network e Frames sent and received over the EThernet network 3 Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation xj File Edit View Favorites Tools Help A Qsear
163. t to move the returned instance number from a CreateSocket service into the Instance member of a MSG instruction Specify the attribute value only when getting or setting an attribute not when using other services Source Element Contains the request parameters for the socket service Create a user defined type for the request parameters for each service Publication ENET UM527E EN P October 2006 Socket Interface 133 CIP Generic Msg Parameter Description Source Length Specify the length of the Source Element Destination Contains the response data returned by the service Create a user defined type for the response data for each service Communication The communication path must point to the web server For details on specific services see See Socket Object Services on page 140 Message Transfer Sizes The maximum amount of application data you can send or receive depends on whether you configure the MSG instruction as connected or unconnected The size of the application data does not include the parameters in the Read and Write services Service Connected or Unconnected Maximum Amount Of Configured On the MSG Application Data Communications tab Read Connected 484 bytes Unconnected 484 bytes Write Connected 472 bytes Unconnected 462 bytes For TCP sockets if the application data is larger than the maximum size you can issue multiple Reads or Writes to re
164. tart the BOOTP DHCP utility make sure you have the hardware MAC address of the web server module The hardware address is on a sticker located on the side of the module The hardware address in a format similar to 00 Ob db 14 55 35 IMPORTANT To use the BOOTP DHCP utility 1 Launch the BOOTP DHCP software In the Request History panel you see the hardware addresses of modules issuing requests fg BOOTP DHCP Server 2 3 File Tools Help m Request History Clear History Add to Relation List Ethernet Address MAC IP Address Hostname Publication ENET UM527E EN P October 2006 DHCP 00 00 BC 21 20 14 8 09 26 DHCP 00 00 B0 21 20 14 8 09 22 DHCP 00 00 B0 21 20 14 8 09 13 DHCP 00 00 B0 21 20 14 8 08 57 DHCP 00 00 B0 21 20 14 Relation RE New Delete En BOOT Ethemet Address MAC IP Address r Status Unable to service DHCP request from 00 00 6C 21 20 14 Entries 0 of 256 2 Double click on the hardware MAC address of the module you want to configure inii File Tools Help gt Request History Configure a Network Address For a Web Server Module 37 The hardware address is on a sticker located on the side of the web server module The hardware address will be in a format similar to 00 Ob db 14 55 35 The New Entry window displays the MAC address you selected and prompts you to enter the IP address New Entry J x
165. the content of the message entered on the email web page as an email to a mail relay server Delivery of the email depends on the mail server The web server module does not receive email Publication ENET UM527E EN P October 2006 68 Send Email 1768 L43 CompactLogix Controller with 1768 EWEB Module This Device ControlLogix controller FlexLogix controller See the following sample system Firewall Router m ControlLogix Controller With 1756 EWEB Module Ethernet Switch 1768 or 1769 CompactLogix controller Mail Relay Server sa FlexLogix Controller Ethernet Switch i Bo SE 1769 L35E CompactLogix vm Controller Can Send a MSG instruction to the 1756 EWEB web server module to initiate sending an email to the mail relay server Use the path of the MSG instruction to identify the web server module as the target of the MSG instruction 1756 EWEB or 1768 EWEB module Send an email to the mail relay server from the email interface on the Send an Email link Each time you use this interface you must enter all email information Mail relay server Publication ENET UM527E EN P October 2006 Send email to specified recipients The mail relay server determines the delivery of any email send through a web server module whether via a MSG instruction or from its built in interface Send Email 69 Configure the Web S
166. this version of the document include the addition of the 1768 EWEB module and related information Enhanced Web Server Module User Manual Changes Topic Chapter Page No Browser Requirements Chapter 1 Getting Started 17 1768 EWEB Installation Chapter 1 Getting Started 18 1768 EWEB Flash File Space Chapter 7 Access Files in the 83 Web Server Module CIP Connected Messaging Limits Appendix A Use the Web 122 Server Module To Connect Over Ethernet CIP Unconnected Messaging Appendix A Use the Web 122 Limits Server Module To Connect Over Ethernet Publication ENET UM527E EN P October 2006 4 Summary of Changes Notes Publication ENET UM527E EN P October 2006 Getting Started Configure a Network Address For a Web Server Module Table of Contents Preface About This Publication abit tide eo bah ated 4 5 8 eee as 11 Who Should Use This Publication n aoaaa aaaea 11 GONVENUONS ag as de 2a a a aaua a yer heathen dds SPR aa a 11 Chapter 1 IOtLOGUCHOR t iaa Li Bt Dec Shed wre aw BAe hl wh RESTS hf 13 About the Enhanced Web Server Module 13 Enhanced Web Server Module Applications 14 Features of EtherNet IP Web Server Module in a Control SV SCSI i Fean 159 oa EAEE Sarna Hed E AN dos A ekg Oe 15 1 56 EWE mstallation 42s exs 23 loos Skok Ree ex 17 1768 EWEB Installation ooann auaa 18 System Requirements saati eu nia oa a e e a are ee eee 19 Access the Mo
167. ublication ENET UM527E EN P October 2006 Configure a Network Address For a Web Server Module 39 6 Select the Port Configuration tab xi Generol Port Contgarason Network Configuention Type G Syd Drome e e IP Address Network Mask 255 255 24 Gotewsy Addross 1 0 1 Primary Name Server Secondary Name Server Domain Name How Naene Sistas Network Intedace Conigured Jw 7 In the Network Configuration box click Static to permanently assign the configuration If you select Dynamic on a power cycle the controller clears the current IP configuration and will again begin sending requests 8 Enter the IP address and the other network parameters if needed Use RSLogix 5000 Software to Configure the IP Address To use RSLogix 5000 software to configure the IP address 1 Make sure the module is installed and powered up 2 Connect to the controller via a serial or other network connection 3 Start RSLogix 5000 software 4 In the Controller Organizer select the EtherNet IP module and right click Publication ENET UM527E EN P October 2006 40 Configure a Network Address For a Web Server Module 5 Select Properties fg RSLogix 5000 Ricks_L35E 1769 L35E File Edit Yiew Search Logic Communications Tools Window Help alsa S seel ol geak Ci Ael Rem Run E M Run Mode Path AB_DF1 1 1 v amp PL amp Controller OK a Battery OK 4 ee ae gt m 0 ok 4
168. ule HTTP code IP address Access HTTP code request IP address of the requestor Type of access The web server module has 30 K memory allocated for server log entries If all the log options are enabled the server log memory can hold about 200 entries Once this allocation is full the web server module stops storing server log entries Click Clear Log to empty the server log so that the web server module can again log entries Chapter 4 About This Chapter Data Views Overview Use Data Views to Access Controller Data The module provides access to controller data for monitoring and data modification of controller tags This chapter shows you how to set up data views of controller tags Topic Page Data Views Overview 55 Create a Data View 57 Monitor Data Views and Tag Data 59 Create Data Views Offline 62 Edit a Data View 62 Use an External Application to Access Data Views 63 Example Data View XML 64 Example Data View XML with Tag Values 65 Example Data View XML with Tag Errors 66 For data views the module must be in the same chassis as the controller Data views give you the ability to read from and write to RSLogix controller tags from a browser interface or an external application The module provides web pages that let you configure a set of tags a data view that can be read or written A data view consists of an XML file with data tag information The XML file is
169. umbers In this Publication ENET UM527E EN P October 2006 136 Socket Interface Publication ENET UM527E EN P October 2006 situation your old MSG instructions may succeed but may not be communicating with the correct remote device Handle this situation by monitoring the status of the web server via a GSV instruction If you lose communication with the web server the Logix5000 program should re initialize its socket communications For more information on the GSV instruction see the Logix5000 Controllers Common Procedures Programming Manual publication number 1756 PMO001 Change Controller Mode Between Run and Program If the Logix controller transitions from Run to Program mode while socket requests are active the transition does not complete until all the outstanding MSG requests complete or time out If you have long timeout values you can experience an unexpectedly long time for the Run to Program transition to complete Alleviate long transition times by appropriately setting the Timeout parameter for the socket services In the Logix5000 program you can also set the TO bit for any outstanding socket related MSG instruction This causes the MSG instruction to timeout and set the ER bit If the controller transitions from Run mode to Program mode then back to Run mode again previous socket instances may still exist on the web server The previous socket instances time out eventually Depending on the number of
170. vailable in each EWEB module s flash file system Catalog No Mbytes Available 1756 EWEB 5 1768 EWEB 2 Some predefined directories exist to store specific types of data Use This Directory For user This is the highest directory level you can access on the web server module It contains two subdirectories e Web for you to store your custom created pages or other files e system to store configuration files and data views You can only access this directory via FTP when the web server module is in backup restore mode user We se this directory to store your custom created pages or own files Standar provides user Web Use this directory to st t ted files Standard FTP d access to this directory the module does not need to be in any special mode user system This predefined directory contains two predefined directories e configuration to store network and module configuration files e dataviews to store data view files You can only access this directory via FTP when the web server module is in backup restore mode user system configuration This predefined directory contains network and module configuration files in an XML format You can only access this directory via FTP when the web server module is in backup restore mode Publication ENET UM527E EN P October 2006 84 Access Files in the Web Server Module Use This Directory user system dataviews For This predefined directory contains d
171. verview IP Address 10 88 81 6 Network Settings Subnet Mask 255 255 254 0 Message Connections Ethernet Statistics Default Gateway 10 88 80 1 A Advanced Diagnostics i administrative Settings Primary Name Server Secondary Name Server Default Domain Name 10 88 128 138 10 88 128 139 na home ra int com Browse Chassis Host Name L Send an Email Name Resolution DNS Enabled SMTP Server 10 88 69 9 Ethernet Interface Configuration Obtain Network Configuration Dynamic DHCP Ethernet Link Autonegotiate Status Autonegotiate Speed and Duplex Port Speed 100 Mbps Duplex Mode Half Duplex Copyright 2004 Rockwell Automation Inc All Rights Reserved i Internet Any fields not configured remain blank This field Specifies Network Interface Ethernet Address MAC Ethernet MAC address of the module IP Address IP address for the module Subnet Mask Subnet mask for the module Default Gateway Gateway address for the module Primary Name Server Primary name server Secondary Name Server Secondary name server Default Domain Name Host Name Default domain name for the module Host name for the module Name Resolution Whether Domain Name System DNS resolution is enabled SMTP Server SMTP server address for the module required for email Publication ENET UM527E EN P October 2006 Monitor Diagnostics 117 This fie
172. via a MSG instruction Open socket interface You can open TCP or UDP communication links to other standard Ethernet devices via the module Publication ENET UM527E EN P October 2006 16 Getting Started 1768 L43 CompactLogix Controller with 1768 EWEB ControlLogix Controller With 1756 EWEB Module Computer with RSLogix RSLinx and Web Browser Software Ethernet Switch The following diagram shows how EWEB modules might fit in your control system on an EtherNet IP network Firewall Router PanelView Terminal E FLEX 1 0 System with MicroLogix Controller m a 1794 AENT Adapter with 1761 NET ENI PowerMonitor 300 With Ethernet Card io io io m Publication ENET UM527E EN P October 2006 1769 L35E CompactLogix Controller If both the ControlLogix and CompactLogix chassis in this sample system contain an EWEB module you could access either module to monitor and modify data in the controllers using a computer with standard Web browser software 1756 EWEB Installation Getting Started 17 To install a ControlLogix Enhanced Web Server Module 1756 EWEB follow these steps 1 Align the module with a slot in the 1756 chassis 2 Slide the module back into the chassis unt
173. want to change a tag value enter the new value in the Value field the tag and click the Update button This changes the value in the controller You can use RSLogix5000 software to monitor tags and verify that the value changed For more information see chapter 4 Publication ENET UM527E EN P October 2006 26 Getting Started Configure Email To configure the SMTP server that manages email follow this procedure 1 In the organizer on the left select Administrative Settings gt Device Configuration gt Email Configuration Rockwell Automation Microsoft Internet Explorer provided by Rockwell Automation 3 la xj Fie Edt View Favorites Tools Help Back gt A A Asearch Favorites Bristory Gh a Address http 10 88 81 6findex html z so Links Allen Bradle Rockwell Ja Web Server Example Automation Expand Minimize a Device Identity Network Configuration Device Services Email Configuration Dome Gk vata views E Mail Client Diagnostics SMTP Server IP or Hostname 10 88 69 9 a Administrative Settings E configuration I smtp Authentication UserName JewebEmail Device Identity Password orreen ooa Network Configuration Device Services P email Configuration Apply Changes ld User Management Server Management Copyright 2004 Rockwell Automation Inc All Rights Reserved Browse Chassis L Send an Email 2 In the organizer select Send an Ema
174. work Configuration Y Device Services N Email Configuration N j Home pata Vias Service Description Current Status Enable Diagnostics FTP Copy Files Stopped Cr Administrative Settings S s 5 SNMP Station Management Running Vv Device Configuration Device Identity SMTP Email Client Running v Network Configuration CIP Bridge EtherNet IP to Backplane Running Vv Device Services Email Configuration CIP Bridge Backplane to EtherNet IP Running Vv id User Management XML amp ASP Web Access to Control Data Running Vv 2d server Management M arovse Chassis L Send an Email Apply Changes Copyright 2004 Rockwell Automation Inc All Rights Reserved 2 Select the services you want to use by checking the appropriate checkboxes Use the following table as a reference To Enable Allow file tyransfers to and from the web server File Transfer Protocol FTP module Use SNMP management software if your Simple Network Mangament Protocol system has it SNMP Service email Simple Mail Transfer Protocol SMTP Allow Ethernet IP devices to bridge through the Common Industrial Protocol CIP bridge web server module to devices in the chassis backplane to EtherNet IP service Allow web access to control system data Extended Markup Language Active Server Page XML ASP For more information see chapter 3 Publication ENET UM527E EN P October 2006 Getting Started 29 Additional Resources Consult th
175. ws configured Total Controller Tags Total number of tags in data views Server Errors Number of requests to the web server module with an invalid URL Redirects Number of requests for a web page that were redirected by the web server e g requesting is redirected to index html Timeouts Number of times a connection timeout occurred while processing a web page Access Violations Number of times a page has been requested for which the user has insufficient privilege Page Hits Number of times a web page was successfully accessed Form Hits Number of times a web page form was accessed Total Hits Total number of web page access attempts TCP Connections CIP Current TCP Connections TCP Connection Limit Current number of active TCP connections for CIP messaging Maximum number of TCP connections for CIP messaging allowed Maximum Observed Maximum observed number of TCP connections for CIP messaging CIP Connection Statistics Current CIP Connections Current number of CIP connections CIP Connection Limit Max Connections Observed Conn Opens Maximum number of CIP connections allowed Maximum observed number of CIP connections Number of CIP connection open requests Open Errors umber of CIP connection open request errors Conn Closes umber of CIP connection close requests Close Errors umber of CIP connection close errors Conn Ti

ENET-UM527 - Literature Library

Contents

Download Pdf Manuals

Related Search

Related Contents