NI 工业通信以太网IP帮助手册.pdf

Nl-lndustrial Communications for Ethernet/IP2023-03-01Nl-lndustrial Communications for Ethernet/IPContentsNl-lndustrial Communications for EtherNet/IP.3Activating Your Software.3Ethernet/IP Industrial Communication.5Messaging.6I/O Data.84Advanced.99Error Codes.105/Nl-lndustrial Communications for Ethernet/IPJuly 2012,372650G-01The Nl-lndustrial Communications for EtherNet/IP API allows a LabVIEW system to communicate with devices on an EtherNet/IP network.The API supports Explicit Messaging and I/O Data communications.Activating Your SoftwareHow do I activate my software?Use the Nl Activation Wizard to obtain an activation code for your software.You can launch the Nl Activation Wizard two ways:Launch the product and choose to activate your software from the list of options presented.Launch Nl License Manager by selecting StartAll ProgramsNational lnstrumentsNI License Manager.Click the Activate button in the toolbar.Notes If your software is a part of a Volume License Agreement(VLA),contact your VLA administrator for installation and activation instructions.Nl software for Mac OS X and Linux operating systems does not require activation.What is activation?Activation is the process of obtaining an activation code to enable your software to run on your computer.An activation code is an alphanumeric string that verifies the software,version,and computer ID to enable features on your computer.Activation codes are unique and are valid on only one computer.National InstrumentsNl-lndustrial Communications for Ethernet/IPWhat is the Nl Activation Wizard?The Nl Activation Wizard is a part of Nl License Manager that steps you through the process of enabling software to run on your machine.What information do I need to activate?You need your product serial number,user name,and organization.The Nl Activation Wizard determines the rest of the information.Certain activation methods may require additional information for delivery.This information is used only to activate your product.Complete disclosure of the National Instruments software licensing information privacy policy is available at rivacy.If you optionally choose to register your software,your information is protected under the National Instruments privacy policy,available at vacy.How do I find my product serial number?Your serial number uniquely identifies your purchase of Nl software.You can find your serial number on the Certificate of Ownership included in your software kit.If your software kit does not include a Certificate of Ownership,you can find your serial number on the product packing slip or on the shipping label.If you have installed a previous version usingyourserial number,you can find the serial number by selecting the HelpAbout menu item within the application or by selecting your product within Nl License Manager(StartAll ProgramsNational lnstrumentsNI License Manager).You can also contact your local National Instruments branch.What is a Computer ID?The computer ID contains unique information about your computer.National Instruments requires this information to enable your software.You can find your computer ID through the Nl Activation Wizard or by using Nl License Manager,as follows:1.Launch Nl License Manager by selecting StartAU ProgramsNational lnstrumentsNI License Manager.4 Nl-lndustrial Communications for Ethernet/IP2.Click the Display Computer Information button in the toolbar.For more information about product activation and licensing refer to can I evaluate Nl software?You can install and run most Nl application software in evaluation mode.This mode lets you use a product with certain limitations,such as reduced functionality or limited execution time.Refer to your product documentation for specific information on the products evaluation mode.Moving Software After ActivationTo transfer your software to another computer,install and activate it on the second computer.You are not prohibited from transferring your software from one computer to another and you do not need to contact or inform Nl of the transfer.Because activation codes are unique to each computer,you will need a new activation code.Refer to the How do I activate my software?section of this topic to learn how to acquire a new activation code and reactivate your software.Deactivating a ProductTo deactivate a product and return the product to the state it was in before you activated it,right-click the product in the Nl License Manager tree and select Deactivate.If the product was in evaluation mode before you activated it,the properties of the evaluation mode may not be restored.Using Windows Guest AccountsNl License Manager does not support Microsoft Windows Guest accounts.You must log in to a non-Guest account to run licensed Nl application software.Ethernet/IP Industrial CommunicationInstalled With:LabVIEW National InstrumentsNl-lndustrial Communications for Ethernet/IPThe Ethernet/IP Industrial Protocol Support API allows a LabVIEW system to communicate with devices on an EtherNet/IP network.The API supports Explicit Messaging and I/O Data communications.SubpaletteDescriptionMessagingThe Vis on this palette use explicit messaging co nnections to read from or write to a target.I/O DataThe Vis on this palette allow the LabVIEW syste m to create an I/O assembly and function as an adapter for a remote PLC.This type of communi cation is referred to as Class 1 or I/O server com munication.Class 1 communication allows the PLC to establish an implicit I/O data connection with the LabVIEW system and repeatedly exchan ge assembly data at a specific rate.AdvancedUse these Vis to explicitly open or close a sessio n.It is generally not necessary to explicitly man age a session because sessions are opened and closed automatically.Explicitly closing a session will immediately abort any blocking operations which are using that session.MessagingOwning Palette:Ethernet/IP Industrial Communicationlnstalled With:LabVIEW The Vis on this palette use explicit messaging connections to read from or write to a target.Palette Obj ectDescriptionEthernetIP Tag ReadAllows you to read from a target that supports M essaging class communications using Logix tag names.Valid targets include PLCs,such as the R ockwell ControlLogix series.The interface supp orts multiple native PLC data types.Supported numeric types include SINT(U8),INT(U16),DIN T(U32),and REAL(SGL).Supported non-numeri c types include string and Boolean values.The A PI also supports raw data to accommodate unsu6 Nl-lndustrial Communications for Ethernet/IPpported or custom data types.Reading raw data requires familiarity with the data format used fo rtag communications.EthernetIP Tag WriteAllows you to write to a target that supports Mes saging class communications using Logix tag na mes.Valid targets include PLCs,such as the Roc kwell ControlLogix series.The interface support s multiple native PLC data types.Supported nu meric types include SINT(U8),INT(U16),DINT(U32),and REAL(SGL).Supported non-numerict ypes include string and Boolean values.The API also supports raw data to accommodate unsup ported or custom data types.Writing raw data r equires familiarity with the data format used for tag communications.Ethernets P SLC500 ReadAllows you to read from a target that supports M essaging class communications using PCCC com munication.Valid targets include PLCs such as t he SLC 500 and MicroLogix series from Rockwell Automation.The interface supports reading fro m integer,float,and bit register files hosted on t he PLC.The API also supports raw data to acco mmodate unsupported or custom data types.R eading raw data requires familiarity with the dat a format of the raw data.EthernetIP SLC500 WriteAllows you to write to a target that supports Mes saging class communications using PCCC comm unication.Valid targets include PLCs such as the SLC 500 and MicroLogix series from Rockwell Au tomation.The interface supports writing to inte ger,float,and bit register files hosted on the PLC.The API also supports raw data to accommodat e unsupported or custom data types.Writing ra w data requires familiarity with the data format of the raw data.EthernetIP CIP Get Attribute SingleAllows you to read attribute information from a CIP obj ect.National InstrumentsNl-lndustrial Communications for Ethernet/IPEthernetIP CIP Set Attribute SingleAllows you to write attribute information to a Cl P obj ect.EthernetIP Tag Read VIOwning Palette:Messaging Installed With:LabVIEWAllows you to read from a target that supports Messaging class communications using Logix tag names.Valid targets include PLCs,such as the Rockwell ControlLogix series.The interface supports multiple native PLC data types.Supported numeric types include SINT(U8),INT(U16),DINT(U32),and REAL(SGL).Supported nonnumeric types include string and Boolean values.The API also supports raw data to accommodate unsupported or custom data types.Reading raw data requires familiarity with the data format used for tag communications.EthernetIP Tag Read SINTTimeout(ms)is the operation timeout limit in milliseconds.Session in represents the current session used for the operation.Network Path is the routing path for the request to the target.The syntax for a simple system is,A.For example,10.0.0.1,1,0 is the routing path for a ControlLogix 5561 with IP address 10.0.0.1 and with the processor in slot 0 of an AB-1756 4-slot backplane.8 Nl-lndustrial Communications for Ethernet/IPTag Name is the textual name of the tag to read or write.To access a sub-element of a tag,use a period followed by the name of the sub-element.To address an offset into an array,use bracket notation(index).For example,MyOb j ectT ag.InputDataltem.Control3 addresses the fourth element in the Control array within the sub-element InputDatalte m.Number of Elements controls the number of elements read from a tag,starting at the offset specified in the tag name.SetNumber of Elements to greater than one to read more than one element from an array.Number of Elements applies only to tag reading.Tag writing is implicitly controlled by the size of the passed data array.error in describes the error status before this VI or function runs.The default is no error.If an error occurred before this VI or function runs,the VI or function passes the error in value to error out.This VI or function runs normally only if no error occurred before this VI or function runs.If an error occurs while this VI orfunction runs,it runs normally and sets its own error status in error out.Use the Simple Error Handler or General Error Handler Vis to display the description of the error code.Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.status is TRUE(X)if an error occurred before National InstrumentsNl-lndustrial Communications for Ethernet/IPthis VI or function ran or FALSE(checkmark)to indicate a warning orthat no error occurred before this VI or function ran.The default is FALSE.code is the error or warning code.If status is TRUE,code is a nonzero error code.If status is FALSE,code is 0 or a warning code.source describes the origin of the error or warning and is,in most cases,the name of the VI or function that produced the error or warning.The default is an empty string.1回8|1Session out represents the current session used for the operation.The default session name is default.It is possible to perform multiple concurrent reads and writes within the same session.Multiple sessions within a single application are only necessary to programmatically cancel some outstanding requests(by closing the session)while leaving another session running.Data returns data from a tag as an array of 8-bit signed integers.error out contains error information.10 Nl-lndustrial Communications for Ethernet/IPIf error in indicates that an error occurred before this VI or function ran,error out contains the same error information.Otherwise,it describes the error status that this VI or function produces.Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.El status is TRUE(X)if anerror occurred or FALSE(checkmark)to indicate a warning or that no error occurred.code is the error or warning code.If status is TRUE,code is a nonzero error code.If status is FALSE,code is 0 or a warning code.source describes the origin of the error or warning and is,in most cases,the name of the VI or function that produced the error or warning.The default is an empty string.EthernetIP Tag Read INT National InstrumentsNl-lndustrial Communications for Ethernet/IPTimeout(ms)is the operation timeout limit in milliseconds.Session in represents the current session used for the operation.Network Path is the routing path for the request to the target.The syntax for a simple system is A.For example,10.00.1A 1,0 is the routing path for a ControlLogix 5561 with IP address 10.0.0.1 and with the processor in slot 0 of an AB-1756 4-slot backplane.Tag Name is the textual name of the tag to read or write.To access a sub-element of a tag,use a period followed by the name of the sub-element.To address an offset into an array,use bracket notation(index).For example,MyOb j ectT ag.InputDataltem.Control3 addresses the fourth element in the Control array within the sub-element InputDatalte m.Number of Elements controls the number of elements read from a tag,starting at the offset specified in the tag name.SetNumber of Elements to greater than one to read more than one element from an array.Number of Elements applies only to tag reading.Tag writing is implicitly controlled by the size of the passed data array.error in describes the error status before this VI or function runs.上 Nl-lndustrial Communications for Ethernet/IPThe default is no error.If an error occurred before this VI or function runs,the VI or function passes the error in value to error out.This VI orfunction runs normally only if no error occurred before this VI orfunction runs.If an error occurs while this VI orfunction runs,it runs normally and sets its own error status in error out.Use the Simple Error Handler or General Error Handler Vis to display the description of the error code.Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.status is TRUE(X)if an error occurred before thisVI orfunction ran or FALSE(checkmark)to indicate a warning orthat no error occurred before this VI orfunction ran.The default is FALSE.code is the error or warning code.If status is TRUE,code is a nonzero error code.If status is FALSE,code is 0 or a warning code.source describes the origin of the error or warning and is,in most cases,the name of the VI orfunction that produced the error or National InstrumentsNl-lndustrial Communications for Ethernet/IPwarning.The default is an empty string.Session out represents the current session used for the o