manualshive.com logo in svg

ICP DAS USA U-7500 Series, Руководство пользователя

Поделиться
Скачать
ICP DAS USA U-7500 Series Скачать руководство пользователя страница 50

OPC  UA  I/O  Series  User  Manual  V4.0  –  ICP  DAS 

50 

3.4 RESTful API: Read and Write I/O and Virtual Point 

 
This section describes RESTful API functions and usage. UA I/O supports RESTful API functions. Users can 
remotely read and write the I/O points (include the virtual point) of UA I/O modules through HTTP. 
 

 

What is Restful API? 

REST

  (Representational  state  transfer)  is  a  software  architectural  style  that  was  created  to  guide  the 

design and development of the architecture for the World Wide Web. REST is a widely accepted set of 
guidelines  for  creating  stateless,  reliable  web  APIs.  A  web  API  that  obeys  the  REST  constraints  is 
informally described as 

RESTful

. 

RESTful

 web APIs are typically loosely based on HTTP methods to access 

resources via URL-encoded parameters and transmit data. 
 

 

Use RESTful with UA I/O 

Reading and writing the virtual points are the same as that of physical I/O points. Examples: 
 

[ Example 1. ] 
 
IP/AllVariableName :

 Define 10 virtual points (all types are AO), and the names all start with VirtualTag 

(red box in the figure below). 
 

 

 
Or as following: 
 

 

 
 

Содержание U-7500 Series

Страница 1: ...OPC UA I O User Manual V4 0 2021 09 U 7500 Series IIoT OPC UA I O Module U 7555M U 7560M U 7504M U 7526M Technical support service icpdas com Technical Editor Tim Chen Editor Eva Li...

Страница 2: ...ormation furnished by ICP DAS is believed to be accurate and reliable However no responsibility is assumed by ICP DAS for its use not for any infringements of patents or other rights of third parties...

Страница 3: ...trict remote device connection 8 CH4 1 7 Modify firmware update time 60 seconds 2 minutes V3 0 03 2021 3rd Version Provide New Functions 1 Change the Model Series name all UA 75xxM change to U 75xxM 2...

Страница 4: ...Revision Date Description V2 0 09 2020 2nd version 1 Release new AIO models UA 7504M UA 7526M 2 Provide new function Scaling V1 0 06 2020 Initial issue 1 Release new DIO models UA 7555M UA 7560M 2 Pro...

Страница 5: ...ssignments Jumper Pic 19 1 5 4 U 7526M Wire Connections Pin Assignments Jumper Pic 20 1 6 Dimensions 21 1 6 1 U 7555M U 7560M U 7504M U 7526M Dimensions 21 2 Quick Start Hardware Network Connection 22...

Страница 6: ...ystem Setting 55 4 1 1 Overview 55 4 1 2 Network Setting 56 Network Setting LAN 56 Hostname Setting 57 4 1 3 Time Setting 58 Date and Time Display 58 NTP time calibration 59 Set the time manually 59 4...

Страница 7: ...Main Menu OPC UA Setting 77 4 3 1 Server Setting 78 4 3 2 Certificate 79 4 4 Main Menu MQTT Setting 80 4 4 1 Connection Setting 80 4 4 2 Client Setting 81 4 4 3 Certificate 84 4 5 Main Menu Advanced...

Страница 8: ...services The OPC UA I O module also called UA I O or U 7500 supports the OPC UA server and MQTT client function can execute both communications at the same time in industrial networking communication...

Страница 9: ...THEN ELSE can set up logical condition action for I O and virtual point Support RESTful API function Can read write I O and virtual point through HTTP Built in Web Server to Provide the Web User Inter...

Страница 10: ...U 7560M 6 Wet Sink Source 6 Power Relay Form A SPST N O U 7504M 4 500mV 1V 5V 10V 0 20mA 20mA 4 20mA 4 0 5V 5V 0 10V 10V 0 20mA 4 20mA 4 Dry Source Wet Sink U 7526M 6 500 mV 1V 5V 10V 0 20mA 20mA 4 20...

Страница 11: ...aging mechanism MQTT Ver 3 1 1 TLS Ver 1 2 Can Execute with OPC UA Communication Simultaneously Function Web Interface for Configuration The system operation can be performed through the browser witho...

Страница 12: ...User can read write the I O Virtual points through HTTP Rule Setting Provide simple logic condition rule setting let UA I O do automatic condition judgment and action control to achieve simple AI Eve...

Страница 13: ...OPC UA I O Series User Manual V4 0 ICP DAS 13 1 4 2 U 7555M Specifications...

Страница 14: ...OPC UA I O Series User Manual V4 0 ICP DAS 14 1 4 3 U 7560M Specifications...

Страница 15: ...OPC UA I O Series User Manual V4 0 ICP DAS 15 1 4 4 U 7504M Specifications...

Страница 16: ...OPC UA I O Series User Manual V4 0 ICP DAS 16 1 4 5 U 7526M Specifications...

Страница 17: ...OPC UA I O Series User Manual V4 0 ICP DAS 17 1 5Wire Connections Pin Assignments 1 5 1 U 7555M Wire Connections Pin Assignments...

Страница 18: ...OPC UA I O Series User Manual V4 0 ICP DAS 18 1 5 2 U 7560M Wire Connections Pin Assignments...

Страница 19: ...OPC UA I O Series User Manual V4 0 ICP DAS 19 1 5 3 U 7504M Wire Connections Pin Assignments Jumper Pic...

Страница 20: ...OPC UA I O Series User Manual V4 0 ICP DAS 20 1 5 4 U 7526M Wire Connections Pin Assignments Jumper Pic...

Страница 21: ...OPC UA I O Series User Manual V4 0 ICP DAS 21 1 6Dimensions 1 6 1 U 7555M U 7560M U 7504M U 7526M Dimensions Unit mm...

Страница 22: ...Can connect to the network and set the network 2 Ethernet Switch Hub e g NS 205 or PoE Switch NSM 208SE 3 Power Supply 12 48 VDC e g MDR 60 24 If using PoE Switch user can save a power supply 2 1 2 A...

Страница 23: ...1 Vin0 Vout3 Vout2 Vout1 Vout0 Jumper J4 J3 J2 J1 J8 J7 J6 J5 U 7526M Channel Vout1 Vout0 Vin5 Vin4 Vin3 Vin2 Vin1 Vin0 Jumper J8 J7 J6 J5 J4 J3 J2 J1 Jumper Direction Jumpers default as Input Voltage...

Страница 24: ...switch do not need one more power supply Fig 2 for PoE Switch You can also directly link the U 7500 to PC with an Ethernet cable After power is connected please wait 1 minute for U 7500 start up proce...

Страница 25: ...his method changes the PC network IP to be the same domain with the network IP of the UA I O factory default values to login the Web UI Refer Chapter 2 2 1 B Using Software Utility Suitable for quick...

Страница 26: ...eway 192 168 1 1 Web UI Account Username root After the first login change the default username password to use other functions Password root 1 Change the PC s IP setting as following Write down the P...

Страница 27: ...A I O Series User Manual V4 0 ICP DAS 27 3 Click System Setting Account Setting change the Username password first or user cannot use any other function New design for data security Password Setting r...

Страница 28: ...stem Setting Network Setting Network Setting LAN1 to change the IP setting by user network 5 Save the IP setting restore the PC original IP settings and type the new IP in the browser as step 2 to log...

Страница 29: ...uitable for connecting multiple UA series controllers or I O modules to the Internet but the IP addresses of UA are unknown or need to modify the UA quickly UA Utility is a free tool software to quick...

Страница 30: ...w connection Click New to add a connection item and give a name for it 3 Search the UA controller Mouse double click on the name you created or single click and then click the Connect button this util...

Страница 31: ...default Web browser IE Chrome 5 Connection to the UA Web UI The default web browser will be run and direct go to the UA login web site Please enter the username and password to login the UA Web UI The...

Страница 32: ...nual V4 0 ICP DAS 32 6 Login the Web UI of the UA I O Series When login into the web interface the UA default home page the main configuration screen will as below and will automatically read setting...

Страница 33: ...working mode according to their needs and environment to transmit the values of built in I O channels to the cloud IT system or field control system for reading and writing So the main functions are t...

Страница 34: ...n SSL TLS User Authentication X 509 Certificates Account password Communication Error Detection and Recovery etc to connect SCADA or OPC UA Clients Recommend to keep the maximum number of sessions wit...

Страница 35: ...r Setting Connection Setting 2 When enabling username password login please set the account in the following menu path Menu Path System Setting Account Setting Appendix A If users enable the secure an...

Страница 36: ...configure the OPC UA Client for connection Now go to the Client device that connects with UA I O and set the corresponding data point We recommend using ICP DAS InduSoft products as the Client device...

Страница 37: ...rtificates to each other s trust zones This section will show how to do the steps Menu Path OPC UA Setting Certificate Appendix A A Provide the OPC UA Server Certificate of the UA I O to the Client de...

Страница 38: ...l Provides functions of IoT Active M2M Transmission QoS Quality of Service Retains Mechanism Identity Authentication Encryption Last Will etc MQTT connection includes the following settings that will...

Страница 39: ...nication server UA 2200 5200 2600 series or MQTT Broker BRK 2600M 5200M series Main Menu MQTT Setting Connection Setting Appendix A If users enable the secure and encrypted MQTT Certificate Login need...

Страница 40: ...e publishing on a specified topic The broker then forwards the message to all subscribers of that topic These primitives can be used to build different interaction patterns as the picture below MQTT g...

Страница 41: ...ing as a message or subscribe JSON string to get all I O values back at one time Refer to Appendix B for the detailed JSON format Disable Enter the Singly setting screen the Publish Subscribe message...

Страница 42: ...s Default 2 0 Delivering a message at most once 1 Delivering a message at least once 2 Delivering a message at exactly once Retain Set up if the Broker retains the message Save Click to save the setti...

Страница 43: ...channel which includes MQTT Alias and OPC UA Description MQTT Client setting should cooperate with MQTT Alias of the I O channels for the accuracy readability of MQTT communication settings Menu Modu...

Страница 44: ...e left figure User needs to set up each Topic QoS of Publish Subscribe for each I O channel 1 Set the Publish Topic of DO0 and set each IO Topic means Building A 1F light of U 7555M Topic 2 The level...

Страница 45: ...he type of certificates To perform the One way authentication you need to upload the Trusted Certificate To perform the Two way authentication you need to upload the Trusted Certificate first and then...

Страница 46: ...DAS 46 3 3 Rule Setting UA I O UA I O Manu Path Advanced Setting Scaling Appendix A Setting Steps First click Advanced Setting Rule Setting switch to the rule setting screen to add the condition Selec...

Страница 47: ...OPC UA I O Series User Manual V4 0 ICP DAS 47 Select an I O point to add a condition rule...

Страница 48: ...P DAS 48 Click the Delete icon indicated by the green arrow to delete the rule condition Set up the IF THEN ELSE conditions actions to add the rule according to the above steps Then click the icon on...

Страница 49: ...s that all judgment conditions are AND or OR Example Condition 1 AND Condition 2 AND Condition 3 Example Condition 1 OR Condition 2 OR Condition 3 Changing the sampling interval time to speed up the r...

Страница 50: ...ign and development of the architecture for the World Wide Web REST is a widely accepted set of guidelines for creating stateless reliable web APIs A web API that obeys the REST constraints is informa...

Страница 51: ...tion VirtualTag0 RESTful Read the value of VirtualTag0 Or as following IP VariableInformation U 7504M_DI DI0 RESTful Read the DI DI0 value of U 7504M Example 3 IP VariableInformation RESTful write the...

Страница 52: ...ar1 var2 Read the data of var0 var1 var2 in all variables data are separated by commas Link to Example G1 2 PUT VariableInformation writes the variable data being used Link to Example P1 1 JSON Descri...

Страница 53: ...ctual Application Corresponding to the Resource Definition GET VariableInformation var0 var1 var2 GET VariableInformation U 7560M_DO RL0 U 7560M_DO RL1 Description Back to G1 2 GET Read VariableInform...

Страница 54: ...use RAW Body Var1 Quality Good Value 24 5 Var2 Quality Good Value 24 5 Description Back to P1 1 PUT Write VariableInformation Variable Information RAW Body The JSON format to be written PUT VariableI...

Страница 55: ...elated to the hardware and operating system 4 1 1 Overview Function Display the current information of the hardware and operating system Support Module All UA I O modules support this function Manu Pa...

Страница 56: ...nd Gateway according to customer s network Detail information for the factory default value of UA controller network refers to the Sec 4 1 7 Obtain an IP address automatically DHCP It s the Dynamic Ho...

Страница 57: ...stname Setting System Setting Network Setting Hostname Setting Hostname The host name of this UA I O Default system value User can give a new name but cannot be null Chinese characters or special symb...

Страница 58: ...g Time Setting Appendix A Date and Time Display System Setting Time Setting Date And Time Display Date Display the date of the UA I O module including year month and day Time Display the current time...

Страница 59: ...is item and update the data of Time Setting to the Date And Time Display on the top of this page Set the time manually System Setting Time Setting Set The Time Manually Date Set the system date of the...

Страница 60: ...fault username password first or user cannot use any other function design for data security except the Overview and Account Setting Mouse showing hand shape Password The login password for the UA Web...

Страница 61: ...as display and set the Web Server port Support Module All UA I O modules support this function Manu Path System Setting Web Server Setting Appendix A Http Web Server Setting System Setting Http Web S...

Страница 62: ...unication File name rule A Z a z 0 9 crt only crt files composed of English uppercase and lowercase and numbers are accepted Private Key Server private key required for HTTPS communication File name r...

Страница 63: ...Module All UA I O modules support this function Manu Path System Setting Firewall Setting Appendix A System Setting Firewall Setting Allow all IP Check box to allow all IPs to connect to UA I O Factor...

Страница 64: ...le All UA I O modules support this function Manu Path System Setting Firmware Setting Appendix A Restore Factory Setting 1 Check the Enable box to enable the Restore button and then click on the Resto...

Страница 65: ...estoration fails 4 After restarting the module will restore the factory default settings as follows Web IP address automatically changes to 192 168 255 1 Factory Default Settings of UA I O Modules Net...

Страница 66: ...ersion of Firmware software and then update the firmware of your UA I O module according to the steps in this section UA series download center on the ICP DAS website https www icpdas com en download...

Страница 67: ...te succeeds If the box does not pop up this update fails 6 After restarting the module will recover the UA I O settings as follows Update Firmware of UA I O Modules Network IP LAN Keep the original se...

Страница 68: ...OPC UA I O Series User Manual V4 0 ICP DAS 68 Maintenance This function is only provided to ICP DAS R D personnel for maintenance using It is reserved and not open for use...

Страница 69: ...ion of Chapter 3 Main Function Settings 4 2 1 I O Setting Function Display and change the I O settings of the UA I O module Support Module All UA I O modules support this function Manu Path Module Set...

Страница 70: ...e number of the UA I O hardware MQTT Alias The variable alias of the sending message MQTT JSON format when using MQTT connection OPC UA Description The messages got from the description column of OPC...

Страница 71: ...nel The channel name number of the UA I O hardware MQTT Alias The variable alias of the sending message MQTT JSON format when using MQTT connection OPC UA Description The messages got from the descrip...

Страница 72: ...ble alias of the sending message MQTT JSON format when using MQTT connection OPC UA Description The messages got from the description column of OPC Client when using OPC UA connection Power on Value T...

Страница 73: ...nput Module Setting I O Status Digital Input Channel The channel name number of the UA I O hardware Value Current channel status value When the value changes the signal LED will change Status GOOD BAD...

Страница 74: ...I O hardware Value Current channel status value When the input type is 4 20mA if an abnormal state occurs the value will display as 32 768 Status GOOD BAD or UNCERTAIN Analog Output Module Setting I O...

Страница 75: ...ile of the UA I O module Support Module All UA I O modules support this function Manu Path Module Setting Project File Appendix A Download the file from device Download the project file for back up th...

Страница 76: ...Upload the file to the device Upload the project file into the UA I O This function can quickly replace the previously backed up project file and then restore the project setting parameters Click Upl...

Страница 77: ...sing OPC UA Connection of Chapter 3 Main Function Settings NOTE When the main menu OPC UA Setting has a message of Please remove the server certificate as the picture below that means there is somethi...

Страница 78: ...n Setting Port The communication port number of the OPC UA Server System Default 48010 Anonymous Login Check to enable the anonymous login from clients Username Password Login Check to enable the user...

Страница 79: ...OPC UA Setting Certificate Download the file from device Server Certificate Click Download to download the OPC UA Server Certificate file to PC for the using of the client side device File Name icpdas...

Страница 80: ...T Broker settings for using MQTT connection Support Module All UA I O modules support this function Manu Path MQTT Setting Connection Setting Appendix A MQTT Setting Connection Setting IP Address The...

Страница 81: ...lt 0 Will Topic Enter the title of a disconnect notice Default Null Will Enter a disconnect notice Default Null JSON Format Switch the format for sending MQTT messages If Enable is checked the message...

Страница 82: ...ering a message at most once 1 Delivering a message at least once 2 Delivering a message at exactly once Subscribe Topic The topic of receiving data subscribing message It can copy the Publish Topic o...

Страница 83: ...ivering a message at most once 1 Delivering a message at least once 2 Delivering a message at exactly once Subscribe Topic The topic of receiving data subscribing message It can copy the Publish Topic...

Страница 84: ...Authentication setting item will show up after enable SSL TLS Select one way or two way authentication One way authentication The Client verifies the validity of Broker credentials Two way authenticat...

Страница 85: ...device and upload the MQTT Trusted Certificate file to the UA I O module File format must be PEM Extension name must be pem cer or crt Certificate Upload Click to select the MQTT Certificate file of...

Страница 86: ...dules support this function Manu Path Advanced Setting Scaling Appendix A When the variable value needs to be scaled or converted before output Fill in the Min Max items of the Source Output Variable...

Страница 87: ...n be recorded in each single log file Sampling Interval Time milliseconds Enter the interval time milliseconds to obtain the current value of UA I O Advanced Setting Event Log Digital Input Output Ali...

Страница 88: ...exceeded the log file will store this log message Easy for customers to read Below The Lower Limit log message When it is lower than the lower limit of Deadband the log file will store this log messag...

Страница 89: ...d action control to achieve simple AI Support Module All UA AI AO modules support this function Manu Path Advanced Setting Rule Setting Appendix A Advanced Setting Rule Setting Content Setting Samplin...

Страница 90: ...are as follows 1 Please find the Reset button on the UA I O bottom side and then press the Reset button 2 When starting the recovering process all the LEDs on the panel will light up red or green 3 I...

Страница 91: ...s Recovering Firmware of UA I O Modules Network IP LAN Keep the original setting Assign UA I O a new IP setting according to your case Netmask Keep the original setting Gateway Keep the original setti...

Страница 92: ...as 2 Click Overview function of sub menu appeared on the left side such as 3 Check or set up the information or function items on the setting area of the Overview Menu Path Example 2 Description for t...

Страница 93: ...e 0 Quality Uncertain Name Short_RW 2 Attribute RW Datatype Int16 Value 0 Quality Uncertain Name Descriptions Variable The array name of JSON Its structure includes several member data as below Name T...

Отзывы:

Нет отзывов

Бренды по названию

Популярные бренды

Загрузить еще бренды