Инструкции на Электронное устройство WebGate Carel
Руководство пользователя. WebGate - инновационное электронное устройство, для подключения всех контроллеров Carel к локальной сети на основе стандарта Ethernet ™ и TCP / IP.
Загружаем документ…
Текст инструкции
-
User manual
PRELIMINARY VERSION
-
Introduction
WebGate is a innovative electronic device that measures the same size as a normal desktop modem. It features avant-garde technology for connecting all Carel controllers to the local network based on the standard Ethernet™ and TCP/IP. Ethernet™ is a widespread, fast, economical and reliable…
-
1. Installation
Installation Warnings Avoid installing the boards in environments with the following characteristics: relative humidity above 90%; strong vibrations or knocks; exposure to jets of water; exposure to aggressive and polluting agents (e.g.: sulphurous and ammonia gases, saline mists, smoke)…
-
1.1 Connections
V WebGate connections are accessible from the back panel of the unit, as indicated below: Fig. 1.1.1 Ethernet 10BaseT connector to corporate LAN. RS232 DTE interface to connect a local console RS485 interface to Carel Network, used to connect the Carel devices Plug connector for the 18VAC power…
-
'% )HPDOH
'% )HPDOH To connect WebGate to a PC use a shielded null-modem cable. Only TD, RD and SG lines are strictly required. Remember that since the PC and WebGate are provided with a DTE interface, TD and RD lines must be swapped: Fig. 1.1.2.1 1.1.3 Connection of the RS485 interface The wire for the…
-
2. User Interface
All WebGate functions can be controlled using HTML pages or RS232 console interface. However, three multicolor LEDs and a “reset” button are provided to simplify installation. 5HVHW %XWWRQ Fig 2.1: back side of WebGate Fig 2.2: top side of WebGate 2.1 LED 2.1.1 Ethernet The top LED gives information…
-
An example sequencing of colors is reported in the example figure below; the following assumptions are made: 3 units connectable (function “MaxDevs” is set to “3” devices) units 1 and 2 are online, unit 3 is disconnected. <HOORZ *UHHQ *UHHQ 5HG Fig. 2.1.2.1 Network cable disconnected If the…
-
2.2 Reset Button
The reset button is useful to restore the WebGate configuration to its factory default. This may be necessary in particular if the settings of the communication parameters were changed and forgotten. Two reset modes are provided: Configuration Reset and Total Erase. 2.2.1 Configuration Reset To…
-
3. HTML Configuration Interface
WebGate is shipped from the factory with some predefined pages provided to configure easily the unit. As indicated in the following paragraph, every information available from these pages is obtained through the use of a script function: to obtain more information about any function see WebGate…
-
The visible fields are explained below
Field Description REBOOT WEBGATE This checkbox is used to restart the WebGate in a way similar to the power-up. This is used mainly when you want to proceed for a firmware update. To reboot WebGate, simply check the box and press the “Apply” button. Please note that the operation may take some…
-
The visible fields are explained below
Field Baudrate Maximum number of devices Description Baudrate for the RS485 interface Maximum number of devices connected to WebGate. Is suggested to set this value to the number of actually connected units to allow a faster response and a proper “RS485” LED working. Function Baudrate485 MaxDevs…
-
WARNING
The maximum length of each string SNMP is: Max. length of the system variables in the WebGate System Variable Max. Length SysName 39 characters sysContact, sysLocation 79 characters Tab. 8.7.1 Moreover, the string have to be composed only of alphanumeric characters (0…9, A…Z and a…z). No spaces or…
-
4. Interface RS 232 (Console)
4.1 Introduction The console user interface RS232 is a fast and convenient way to configure WebGate and to experiment with its functions. It is basically a command line interface accessed via the RS232 port using a PC and a terminal emulation program. Since WebGate is provided with a DTE interface…
-
Select the COM[x] serial port for the connection between PC and WebGate, i.e. COM1, and click the OK button, so you can choose now the communication parameters from the following window: Fig. 4.3.3 4. Select: 19200 baud, 8 bit data, no parity, 1 stop bit, no flow control and click OK. Now you have…
-
4.4 Additional notes about the console
4.4.1 Prompt When WebGate is ready for a user command, it displays a line beginnig with a “>” sign. 4.4.2 Login By default, console access is restricted to the same rights of the “anonymous” user. Since of this, if you are using the user management capabilities (see User Management) some functions…
-
5. File system
WebGate is based on an embedded file system accessible to the user. File system is used to store HTML pages and any other file that may be useful to the user. The user can store up to 100 user files in the 400 KBytes storage space reserved to this purpose. In addition, WebGate comes with some…
-
6. File Transfer Protocol (FTP)
Note: before reading the following chapter you must be accustomed with the WebGate File System, described in File System. File system read access is provided through HTTP. However FTP is required to store files into WebGate. FTP is a user friendly way to deal with files. Modern FTP clients fully…
-
If you want to upload a file to the WebGate (pwd.html in the example), giving it “supervisor” access-level, you have to load it in the “supervisor” folder. Only a user with “supervisor” or greater membership will then be able to view such a file. To upload the file you have to open the “supervisor”…
-
7. Creating a custom Web page on the WebGate
7.1 Introduction This chapter describes how to create a simple Web page which allows you to monitor and control the values of network variables over a local network (LAN) or wide area network (WAN). It is assumed you have a basic understanding of the HyperText Markup Language (HTML). In order to…
-
Example 1
To create a simple Web page which will monitor the temperature set-point of the device 3 (x=3), rapresented for example by an analogue (y=2) variable having index 123 (z=123), you must insert the tag: <%var(3, 2, 123)%> in the proper position. Example 1 <HTML> <head> <title>Display temperature…
-
Example 2
<HTML> <HEAD> <title>compressor status</title> </HEAD> V <BODY bgcolor=”#FFFFFF” text=”#000000”> <TABLE width=”627” border=”0” cellspacing=”0” align=”center”> <TR> <DIV align=”center”> <FONT face=”Verdana, Arial, Helvetica, sans-serif”> <img src=”IR32.jpg” width=”257” height=”187” align=”top”…
-
7.3.2.1 The form attributes
The form attributes are name, method and action: Form Attributes name method action Tab. 7.3.2.1.1 For example: <form name="form4" method="post" action="mypage.htm">. The second two attributes, method and action, are the most important to make the form work. ACTION attribute: Generally the action…
-
List-Menu
Useful when you want to present multiple choices in a limited space. An example maybe the selection of the baudrates for serial communication in a set of standard values (1200,2400, 4800, 9600, 19200). List-Menu Jump-Menu: A jump menu is a pop up menu that lists options that link to documents or…
-
Example of using text-box and button inside a form
<HTML> <head> <title>Untitled Document</title> <meta http-equiv="Content-Type" content="text/HTML; charset=iso-8859-1"> </head> <body bgcolor="#FFFFFF" text="#000000"> <form name="form1" method="post" action="esform.htm"> <table width="500" border="0" cellspacing="0" align="center"> <tr> <td…
-
Note that
• the form content is a table; the first table data is a figure called “Unit.gif” linked by <a href…> tag to the page detail.htm. Clicking your mouse on the figure from the browser, the WebGate will send the new page detail.htm; • a following table entry displays a temperature using the tag…
-
7.3.2.4 Using List-Menu inside forms
The following table shows the HTML code of a page having a form with a List-Menu inside. Fig. 7.3.2.4.1 Example of using list-menu inside a form <HTML> <head> <title>Untitled Document</title> <meta http-equiv="Content-Type" content="text/HTML; charset=iso-8859-1"> </head> <body bgcolor="#FFFFFF"…
-
As you can see, the second table row <TR> has a <TD> tag to display the current RS232 baudrate by the “Visualization tag” <%Baudrate232%>. The successive boldface text highlights part of the List-Menu HTML language. The size element sets the number of items showing at once. The <option> elements…
-
<select name="menu1" onChange="MM_jumpMenu('parent',this,0)">
<option value="IRcold.htm" selected>IR32 Cold</option> <option value="IRuniv.htm">IR32 Universal</option> </select> <input type="button" name="Button1" value="Go" onClick="MM_jumpMenuGo('menu1','parent',0)"> </font></b></font></div></td> </tr> </table></form></body></HTML> Tab. 7.3.2.5.1 The black…
-
Example of using check-boxes inside a form
<HTML> <head> <title>Untitled Document</title> <meta http-equiv="Content-Type" content="text/HTML; charset=iso-8859-1"> </head> <body bgcolor="#FFFFFF" text="#000000"> <table width="100%" border="0" cellspacing="0" align="center"> <tr align="center"><td colspan="5" bgcolor="#FFCC33"><font…
-
7.3.2.7 Using Radio-Buttons inside a form
The Radio-Buttons are useful when the user must select only one choice from a set of options. The Radio-Buttons are typically used in groups. All the Radio-Buttons in a group must have the same name and must contain different field values. The boldface text for a group of five buttons in the next…
-
The name “RS485” is the same for all
The above figure shows the page displayed when the user selects 4800 baud and the current baudrate is 19200. The next figure displays the result. Note how all the data submitted by the form appear into the URL box of the browser. The ACTION element is GET. Fig. 3.2.7.2 7.3.3 Changing the IP address…
-
Example of HTML code for setting IP and NETMASK
<html> <head> <title>Untitled Document</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> </head> <body bgcolor="#FFFFFF" text="#000000"> <form name="form1" method="post" action="Ipnet.htm"> <table width="382" border="0" cellspacing="0" align="center"> <tr…
-
7.3.4 Warnings pages
These pages are sent by the WebGate to give a “warning message” when the user tries to do a temporary inhibited or absolutely not permitted operation. Fig. 7.3.4.1 If your browser is javascript-enabled clicking on the boldface “click here to go back” you will return to the previous page. 7.4…
-
8. WebGate SNMP Protocol
8.1 A brief overview of the SNMP protocol SNMP (Simple Network Management Protocol) is an Internet-standard protocol, introduced in 1988, for managing devices on IP networks. Network complexity has increased very hard in last years by addition of several different kinds of devices, as routers…
-
The Name or Object IDentifier (OID) uniquely defines a managed object on the network
Object identifier commonly appear in two forms: numeric or “readable”, as we’ll see in the next paragraphs. It can be thought of as an address that specifies uniquely where is the object on the network. Value represents the value of the variable associated to the object. An agent may implement many…
-
8.4 Carel Enterprise SNMP Tree
Using the concept of tree-hierarchy, now we can show how the information about snmp-agent and unit-variables are organised by CAREL. iso(1)org(3)dod(6)internet(1)private(4) enterprises(1) Vendors and other organizations …,…,CAREL(9839),…,…, Fig. 8.4.1 System(1) Instruments(2) Under the node…
-
Consequently, if for example a NMS sends a reading command Get request (see SNMP commands and version) for the “Agent release”, the complete OID is: {iso(1).org(3).dod(6).internet(1).private(4).enterprises(1).carel(9839).carel-system(1).1.0} or {1.3.6.1.4.1.9839.1.1.0}. Please note that the complete…
-
8.4.3 The Agent-parameters node
There are two parameters under this node (Figure 8.4.3.1): Netsize and Baudrate, that have the following definition: Agent-Parameters(1) Netsize (1) Baudrate (2) Fig.8.4.3.1 Netsize OBJECT-TYPE SYNTAX INTEGER ACCESS read-write Status --DESCRIPTION “max number of units connected to the WebGate”…
-
Example: Referring to the Unit-Type node (index=2), the situation for 3 units is the following
Unit-type(2) Unit2-type(2) Unit1-type(1) OID {1.3.6.1.4.1.9839.2.0.2.1.0} Unit3-type(3) OID {1.3.6.1.4.1.9839.2.0.2.2.0} Fig. 8.4.4.2 OID {1.3.6.1.4.1.9839.2.0.2.3.0} Here follows the definition for any type of data object under the eight subtrees. OBJECT-TYPE UnitType(X) SYNTAX DISPLAY-STRING…
-
8.4.5 The Carel-Units-var subtree
Under this node a manager can find all the SNMP objects relative to the variables of the devices connected to the WebGate. Figure 8.4.5.1 shows how this subtree is structured, assuming Netsize=4. Carel-Instruments(2) Units1-Var(1) Units2-Var(2) Units3-Var(3) Units4-Var(4) OID-NAME…
-
Examples
Addressing unit n.1 Carel Variable Type Carel Address OID-name for variables Digital Digital Digital Digital Digital 1.3.6.1.4.1.9839.2.1.1.1.0 1.3.6.1.4.1.9839.2.1.1.2.0 1.3.6.1.4.1.9839.2.1.1.206.0 1.3.6.1.4.1.9839.2.1.1.207.0 Analogue Analogue Analogue Analogue Analogue 1.3.6.1.4.1.9839.2.1.2.1.0…
-
Following, a complete example of MIB tree, supposing a single unit (IR32Cold), with address 1, connected to the WebGate. Fig. 8.4.5.2 8.5 SNMP command and version The agent running on WebGate implements SNMPv.1 protocol. Consequently the handled message types are: SNMPv.1 Message type Get-request…
-
8.7 System MIB-II variables
MIB = Management Information Base is the main informations database for an SNMP network application. One of the most important groups under MIB-II node, is the system group (see Fig. 8.7.1). The three variables sysContact, sysName and sysLocation belonging to the system group are mandatory for any…
-
8.8.1 TRAP destination
If no IP-Address has been ever set up as trap destination on the WebGate, the default destination is: Default TRAP destination = 255.255.255.255 (disabled) It means that no trap messages will be sent by WebGate, until a different destination is defined by the user. 8.9 Error Messages The main…
-
9. User Management
WebGate is provided with some basic user management capabilities. User Management provides access restrictions when using functions and accessing to HTML pages and file system. WebGate provides 4 basic access levels: “Administrator” (maximum access capabilities), “Supervisor”, “User” and “Guest”…
-
9.7 Accessing to Protected HTML Pages
HTML protection is provided through the use of the browser password management capabilities. When you try to view a protected page, the browser will display a password request window similar to the one depicted on the right in fig.9.7.1: If a valid combination of name and password is not provided…
-
10. Firmware Upgrade
WebGate ensures that upgrades can be easily obtain since the firmware is stored into an embedded rewritable memory. The upgrade can be performed remotely copying a file supplied by Carel into the file system root directory using a FTP client program and rebooting the device. Upgrade files have a…
-
11. WebGate Script Functions
The WebGate console and HTML user interface is based on some script “functions”. Script Functions are provided principally to allow the user to read from and write to Carel network devices and to change specific WebGate configuration parameters (for example its IP Address) ), and can be processed if…
-
11.2 Functions sorted by category
Console Login Logout Passwd RS232 Baudrate232 Ctrl232 IsSelBaudrate232 RS485 (Carel Network) Baudrate485 Dev DevInfo IsSelBaudrate485 MaxDevs ScanDevs Status485 Var Ethernet – LAN Gateway IPAddress MACAddress NetMask NetStat SNMP ROCommunity RWCommunity SNMPAgentRel SNMPSyscont SNMPSysloc…
-
11.3 Detailed commands description
In the following paragraphs all commands are described in detail, in alphabetical order. In the upper title, the description items have the following meanings: “Read” indicates whether the command can return a value when read (9) or not (8), “Write” is the minimum user access level required for…
-
%DXGUDWH
V Description Read 9 Get/set the baudrate for the RS232 serial interface Write Administrator Saved 9 This function displays or changes the current RS232 baudrate. Currently, this value is used by the console user interface to communicate with a terminal emulator. Syntax (read): Baudrate232 Syntax…
-
&WUO
V Description Read 9 Give access to specific RS232 control lines Write 8 Saved 8 NOTE: This function is provided for debug purposes only. Write access is always forbidden. Get the value of RS232 status and control lines. Syntax: Ctrl232 Returned Value: It returns a hexadecimal value, with the bit…
-
> Dev(1) ↵
Low-Level Unit ON-LINE: Type code 10 > _ 'HY,QIR V Description Read 9 Get extended information about a device Write 8 Saved 8 Returns a complete status report of a connected Carel device. Syntax: DevInfo(<address>) <address> represents the physical address of the unit of interest. If this value if…
-
)UHH)LOHV
V Description Read 9 Return the amount of memory free for files storage Write 8 Saved 8 Return how many bytes and file locations are free to store files in the WebGate file system. Files can be written to the WebGate using a PC running a FTP client application. Syntax: FreeFiles Returned Value : The…
-
Note
When you change gateway address, WebGate will immediately store the value just selected. However, the old value will be used until a connection (FTP, HTTP or SNMP) is still active. As a consequence, any tentative to obtain a connection through the new gateway during this time interval will fail. To…
-
IsSelUserLevel
Login Logout LumpTest MACAddress MaxDevs NetMask NetStat R- | -W | -C | RW | RW | RW | RW | R- | TRAPIPAddress UpdateStatus UserLevel UserLevelString UserName UserPwd Var WakeOn RW RRW RRW RW RW R- > _ +:9HUVLRQ V Description Read 9 Return the WebGate hardware version Write 8 Saved 8 This function…
-
Note
When you change IP address, WebGate will immediately store the value just selected. However, the old value will be used until a connection (FTP, HTTP or SNMP) is still active. As a consequence, any tentative to obtain a connection using the new IP value during this time interval will fail. To avoid…
-
HTML example
<select name="select3" size="1"> <option value="?script:baudrate232=1200" <%IsSelBaudrate232(1200)%>>1200</option> <option value="?script:baudrate232=2400" <%IsSelBaudrate232(2400)%>>2400</option> <option value="?script:baudrate232=4800" <%IsSelBaudrate232(4800)%>>4800</option> <option…
-
V Description Read Return a specific string when the current user level match the given parameter 9 Write 8 Saved 8 This function returns a value depending on the match of the given user and access level with the current value. It is useful in combination with drop-down selection lists. Please see…
-
/RJLQ
V Description Read 8 Login a new user to the console Write Guest Saved 8 Give console access rights to an user. The console interface fully comply with the restrictions imposed from the users management system, described in chapter User Management. To gain access to WebGate through the console…
-
> Logout ↵
> Login = JohnDoe ↵ > Passwd =↵ Welcome JohnDoe! Your access level is 249 (administrator) > _ 0$&$GGUHVV V Description Read 9 Return the WebGate Ethernet hardware address (MAC) Write 8 Saved 8 This function return the WebGate Ethernet hardware address. Sometimes, this may be useful to configure or…
-
> MaxDevs=4 ↵
> MaxDevs ↵ 4 > _ 1HW0DVN V Description Read 9 Get/set the network mask pattern Write Administrator Saved 9 Displays or changes the network mask pattern (“netmask”). Syntax (read): NetMask Returned value for read: <IPx>.<IPy>.<IPz>.<IPw> Where <IPx>, <IPy>, <IPz> and <IPw> are the four bytes of mask…
-
1HW6WDW
V Description Read 9 Display some network statistics Write 8 Saved 8 This command gets a list of Ethernet network statistics. This may be useful to advanced users or system administrators for debug purposes. Syntax: V Help Returned Value: V The lines returned have the following meanings: Line ARP…
-
3DVVZG
V Description V Read 8 Enter the user password for the console Write Guest Saved 8 Enter the password to login a user. The console interface fully comply with the restrictions imposed from the users management system, described in chapter User Management. To gain access to WebGate through the…
-
5HJLVWHUV
V Description Read 9 Displays a list of all the currently defined registers Write Saved Write Saved 8 8 This command lists all the defined arithmetic registers. Arithmetic registers are explained in chapter About Expressions, Registers and Functions. Please note that some of the listed registers are…
-
5:&RPPXQLW\
V Description Read 9 Get/set the Read/Write Community Name Write Administrator Saved 9 Displays or changes the SNMP Read/Write Community Name. Please see chapter Communities for a description of SNMP communities. Syntax (read): RWCommunity Returned value for read: <name> Where <name> is the…
-
6HW
V Description Read 8 Assigns a numeric value to a register Write Guest Saved 8 This function creates an register and assigns the numeric result of an arithmetic expression to it. Syntax: Set(<register>)=<expression> <register> <expression> Register name. Arithmetic expression: it may be a number…
-
6HW0LQ
V Description Read 8 Set the minimum allowed value for a register Write Guest Saved 8 This function defines a minimum value for a register. Syntax: Setmin(<register>)=<expression> <register> <expression> Register name. Arithmetic expression: it may be a number, register, or a combination of the two.…
-
61036\VORF
V Description Read 9 Get/set the SNMP System Location Write Administrator Saved 9 Displays or changes the SNMP System Location string. Please see chapter SNMP for a description of SNMP. This string is used from SNMP Managers. Syntax (read): SNMPSysloc Returned value for read: <location> Where…
-
6103$JHQW5HO
V Description Read Write Saved Read Write Saved 9 Return the Agent software release 8 8 This function returns the SNMP Agent software version. Syntax: SWVersion Returned value: <Version> <Version> is used to identify a major software change Console example: > SNMPAgentRel ↵ 10 > _ 6WDWXV V…
-
6WDWXV
V Description Read 9 Get information about the RS485 and Carel Network interface Write 8 Saved 8 This command return a syntetic RS485 interface status line. It can be useful when a RS485 configuration trouble is suspected. Syntax: Status485 Returned value: The explanatory string will be one of the…
-
Where <name> is the community name
The name must be a string composed from alphanumeric characters only (0…9, A…Z and a…z). No spacing or punctuation characters are allowed. The maximum name length must not exceed 10 characters. Default Value: “public” Console example: > TrapCommunity = trapcom↵ > TrapCommunity ↵ trapcom > _…
-
8SGDWH6WDWXV
V Description Read 9 Return the last update error code Write 8 Saved 8 This command return a string specifying the error occurred (if any) when the last reboot was performed and a firmware update was tried. Please note that the existence of an updated file is checked at every WebGate reboot, and not…
-
Default Value
“administrator” (249) Console example: > UserLevel(3) = 99↵ > UserLevel(3) ↵ 99 > _ 8VHU/HYHO6WULQJ V Description Read 9 Return the minimum access level descriptive string for a given user Write 8 Saved 8 Displays a string describing the access level of the given user. Please see chapter User…
-
Where <index> represents the user index in the users table (0…5), and
<name> is the new user name. The name must be a string composed from alphanumeric characters only (0…9, A…Z and a…z). No spacing or punctuation characters are allowed. The maximum name length must not exceed 20 characters. If the given name is “anonymous”, the access rules of that table entry will…
-
Where <index> represents the user index in the users table (0…5), and
<password> is the new user name. The password must be a string composed from alphanumeric characters only (0…9, A…Z and a…z). No spacing or punctuation characters are allowed. The maximum password length must not exceed 20 characters. If the given password is an empty string, the user will access to…
-
Where <address>
<type> <index> <min> <max> <value> represents the unit address (from “1” up to the value indicated from the “MaxDevs” function), is the type of variable to write. It can be one of the following values: “1“: digital “2“: analog “3“: integer index of the variable in the unit minimum value allowed.…
-
12. About Expressions, Registers and Functions
To provide HTML pages with greater programming flexibility, some functions allows the use of simple integer arithmetic expression in their parameters or assignments. Arithmetic expressions can consist of numbers, registers (explained in the paragraph below), or a combination of the two in the…
-
13. Technical Specifications
Power Supply: 18Vac -15%…+10%, 50/60Hz or 24Vac -15%…+10%, 50/60Hz Rated Power: 3W • For desktop installation: from mini AC power jack, dia. 5mm. Use ONLY the power adapter supplied on request by Carel P.N. TRA1806ITA. The use of different power adapters may damage the hardware. • For panel…
-
Agency
CAREL S.p.A. Via dell’Industria, 11 - 35020 Brugine - Padova (Italy) Tel. (+39) 049.9716611 Fax (+39) 049.9716600 http://www.carel.com - e-mail: carel@carel.com Cod: +030220230 preliminary version dated 28 november 2002 WebGate
Схемы, таблицы и рисунки — в просмотре документа выше. Клик по номеру страницы открывает её в просмотре.