igw935 fs a5 b - ssv- · pdf file5.8 access via ftp ... the igw/935 must answer on the same...
TRANSCRIPT
Web Application Gateway IGW/935
with eSOM/3517
First Steps
SSV Embedded Systems Dünenweg 5 D-30419 Hannover Phone: +49 (0)511/40 000-0 Fax: +49 (0)511/40 000-40 E-mail: [email protected]
Document Revision: 1.1 Date: 2013-03-08
FOR FURTHER INFORMATION REGARDING OUR PRODUCTS PLEASE VISIT US AT WWW.SSV-EMBEDDED.DE
Web Application Gateway IGW/935 - First Steps
2 Document Revis ion 1.1
CONTENT
1 INTRODUCTION...............................................................................................................3 1.1 Checklist ................................................................................................................................3
1.2 Conventions ...........................................................................................................................3
2 SAFETY GUIDELINES......................................................................................................4
3 HARD- AND SOFTWARE REQUIREMENTS ...................................................................5
4 CONNECTIONS................................................................................................................6 4.1 Ethernet Link .........................................................................................................................6
4.2 DVI/HDMI Video Link .........................................................................................................7
4.3 RS485 Serial Port COM1 ......................................................................................................8
4.4 Power Supply.........................................................................................................................9
5 OPERATION ...................................................................................................................10 5.1 Booting the IGW/935 ..........................................................................................................10
5.2 Checking the IP Address of the IGW/935 ...........................................................................10
5.3 Testing the TCP/IP Communication....................................................................................12
5.4 Accessing the SSV/WebUI WebConfig ..............................................................................13
5.5 Changing the IP Address .....................................................................................................14
5.6 Accessing the SSV/WebUI Demo Page ..............................................................................15
5.7 Access via Telnet .................................................................................................................16
5.8 Access via FTP ....................................................................................................................17
6 TECHNICAL DATA..........................................................................................................19
7 PINOUT SCREW TERMINALS .......................................................................................19
8 HELPFUL LITERATURE .................................................................................................20
CONTACT..............................................................................................................................20
DOCUMENT HISTORY .........................................................................................................20
Web Application Gateway IGW/935 – First Steps
Document Revis ion 1.1 3
1 INTRODUCTION
This documentation gives you an overview about the initial operation and the first steps of
use with the Web Application Gateway IGW/935.
For further information regarding the Web Application Gateway IGW/935 please visit us at
www.ssv-embedded.de.
1.1 Checklist
Compare the content of your Web Application Gateway start-up package with the checklist
below. If any item is missing or appears to be damaged, please contact SSV.
� Web Application Gateway IGW/935 with eSOM/3517
� Documentation
� Plug-in power supply
� DVI/HDMI video cable
� CD-ROM for eSOM/3517
� Screwdriver
Note: For operation you will need at least one Ethernet cross-over cable or two
Ethernet patch cables and a switch!
1.2 Conventions
Convention Usage
bold Important terms
monospace Filenames, Pathnames, program code, command lines
Table 1: Conventions used in this document
Web Application Gateway IGW/935 – First Steps
4 Document Revis ion 1.1
2 SAFETY GUIDELINES
Please read the following safety guidelines carefully! In case of property or personal
damage by not paying attention to this manual and/or by incorrect handling, we do not
assume liability. In such cases any warranty claim expires.
• The power supply should be in immediate proximity to the device.
• The power supply must provide a stable output voltage between 11 – 28 VDC. The out-
put power should be at least 2.5 W.
• Please pay attention that the power cord or other cables are not squeezed or damaged in
any way when you set up the device.
• The installation of the device should be done only by qualified personnel.
• Discharge yourself electrostatic before you work with the device, e.g. by touching a
heater of metal, to avoid damages.
• Stay grounded while working with the device to avoid damage through electrostatic dis-
charge.
• The case of the device should be opened only by qualified personnel.
Web Application Gateway IGW/935 – First Steps
Document Revis ion 1.1 5
3 HARD- AND SOFTWARE REQUIREMENTS
To work with the Web Application Gateway IGW/935 a software development environment
is needed.
This development environment requires a PC as development system to access the Web Ap-
plication Gateway via TCP/IP. This PC should comply with the following hard- and soft-
ware requirements:
• Windows 7 or Windows 8
• Web browser (e.g. Firefox, Chrome)
• Telnet/SSH client (e.g. TeraTerm)
• FTP client (e.g. FileZilla)
• 10/100 Mbps Ethernet network controller and TCP/IP configuration
• CD-ROM drive
Web Application Gateway IGW/935 - First Steps
6 Document Revis ion 1.1
4 CONNECTIONS
For a quick and easy start with the Web Application Gateway IGW/935 there are a few cable
connections necessary. The following chapters describe how these connections have to be
made.
4.1 Ethernet Link
The Ethernet link can be made on two ways: with an Ethernet cross-over cable or with two
standard Ethernet patch cables and a hub or switch. When using a hub or switch please con-
nect it between the host PC and the IGW/935 like shown fig. 2.
Figure 1: Ethernet link with cross-over cable
Note: For the Ethernet connection in fig. 1 it is absolutely required to use a
cross-over cable. Do not use an ordinary patch cable. Ethernet patch and cross-over
cables are in most cases visual indistinguishable. But the internal wiring is fully dif-
ferent. Mixing up these types of cables leads to LAN errors. Hence pay attention to
the label of the cable or packing.
Figure 2: Ethernet link with hub or switch
Web Application Gateway IGW/935 – First Steps
Document Revis ion 1.1 7
4.2 DVI/HDMI Video Link
Use the DVI/HDMI video cable to connect an external monitor device with the IGW/935
like shown fig. 3.
Figure 3: DVI/HDMI video link
Web Application Gateway IGW/935 - First Steps
8 Document Revis ion 1.1
4.3 RS485 Serial Port COM1
To create an RS485 serial link on port COM1 of the Web Application Gateway IGW/935
connect an RS485 device like shown in the fig. 4.
Figure 4: RS485 link on serial port COM1
Terminal Signal
A1 COM1 RS485 Serial Port RX /TX+
A2 COM1 RS485 Serial Port RX /TX-
A4 Ground
Table 2: Screw terminal COM1
* Please note: The RS485 (officially called TIA/EIA-485-A) connection between
your IGW/935 and the field devices needs termination resistors on both ends for
proper operation. The IGW/935 does not offer internal termination resistors. Please
make sure, that the RS485 cable connection is equipped with external termination re-
sistors.
Web Application Gateway IGW/935 – First Steps
Document Revis ion 1.1 9
4.4 Power Supply
The Web Application Gateway IGW/935 needs a supply voltage of 11 – 28 VDC to work.
Connect the cables of the plug-in power supply to provide the system with the necessary
power like shown in fig. 5.
Figure 5: Power supply for the Web Application Gateway IGW/935
Terminal Signal
A3 Vin (11 .. 28 VDC)
A4 GNDin
Table 3: Screw terminal power
CAUTION: Providing the Web Application Gateway IGW/935 with a higher voltage than
the regular 11 – 28 VDC could cause damaged device components!
CAUTION: Do NOT turn on the power supply while connecting the power adapter cable
with the Web Application Gateway IGW/935. This could cause damaged board components!
First connect the power adapter cable and THEN turn the power supply on.
Web Application Gateway IGW/935 – First Steps
10 Document Revis ion 1.1
5 OPERATION
5.1 Booting the IGW/935
Just power up the IGW/935 and the boot process starts immediately. The IGW/935 boots
thereby an embedded Linux out of its Flash memory. This may take up to one minute.
5.2 Checking the IP Address of the IGW/935
After the boot process is finished, you have to check the current IP address, which is neces-
sary to access the IGW/935 via a Telnet client or a web browser.
Please open in Windows „Control Panel > Network and Internet > View network com-
puters and devices“.
Figure 6: Selecting the IGW/935
Now right-click on the IGW/935 to open the properties dialog, where you can see the cur-
rent IP address of the IGW/935 like shown in fig. 7.
A double-click on the IGW/935 opens the SSV/WebUI demo page in a web browser.
Web Application Gateway IGW/935 – First Steps
Document Revis ion 1.1 11
Figure 7: The properties dialog shows the current IP address
Now you are able to access the IGW/935 via a Telnet client or a web browser.
Web Application Gateway IGW/935 – First Steps
12 Document Revis ion 1.1
5.3 Testing the TCP/IP Communication
To test the Ethernet connection on the basis of TCP/IP-protocols between the IGW/935 and
the host PC use the TCP/IP-utility program ping. Open a DOS window on your host PC (you
find it in the Windows Start menu) and enter:
ping 192.168.0.183 *
Directly after this command test data is send from the host PC to the IGW/935 via Ethernet
LAN. The IGW/935 must answer on the same way within a certain period of time. Fig. 8
shows the entry of the command as well as the successful execution. In case of an error ping
reports a timeout.
Figure 8: Communication check via ping
The IGW/935 must answer every ping. Otherwise an error will occur. In this case you have
to check all parts of your LAN connection, including the IP address of the IGW/935.
*Note: We assume here that the IGW/935 has the IP address 192.168.0.183. Please
refer to chapter 5.2 for the current IP address. If your device has a different IP ad-
dress, you must regard this for the ping parameter.
Once the ping was successful, you are ready to access the IGW/935 with a web browser or a
Telnet client.
Web Application Gateway IGW/935 – First Steps
Document Revis ion 1.1 13
5.4 Accessing the SSV/WebUI WebConfig
To open the login page of the SSV/WebUI WebConfig enter the current IP address of the
IGW/935 in a web browser, e.g.:
http://192.168.0.183:7777 *
The username is admin, the password is ssvadmin.
Figure 9: Login page of the SSV Web WebConfig
*Note: We assume here that the IGW/935 has the IP address 192.168.0.183. Please
refer to chapter 5.2 for the current IP address. If your device has a different IP ad-
dress, you must enter this address in the web browser. The last part “:7777” (the port
number) is important and must NOT be changed!
Web Application Gateway IGW/935 – First Steps
14 Document Revis ion 1.1
5.5 Changing the IP Address
To change the IP address of the IGW/935 enter the SSV/WebUI WebConfig and choose
from the menu “Network > LAN”. In this section you can configure the LAN settings.
Figure 10: LAN settings
• Enable/Disable interface LAN: Enable or disable interface LAN.
• IP address configuration: Manual device configuration or through DHCP server.
• IP address: IP address of the device.
• Subnet mask: Subnet mask of the local network.
• Enable/Disable alias IP address: Enable or disable the alias IP address.
• Alias IP address: Secondary static IP address for the same interface.
• Alias subnet mask: Subnet mask of the alias network.
Note: Please be very careful with IP address changes. If you enter an incorrect IP ad-
dress or parameters it might be impossible to reach the SSV/WebUI WebConfig
again. In this case please start a new UPnP device search with your Windows PC.
Web Application Gateway IGW/935 – First Steps
Document Revis ion 1.1 15
5.6 Accessing the SSV/WebUI Demo Page
To open the demo page of the SSV/WebUI enter the current IP address of the IGW/935 in a
web browser, e.g.:
http://192.168.0.183 *
Figure 11: Demo page of the SSV/WebUI
*Note: We assume here that the IGW/935 has the IP address 192.168.0.183. Please
refer to chapter 5.2 for the current IP address. If your device has a different IP ad-
dress, you must enter this address in the web browser.
The same demo page is visible if an external video monitor is connected to the IGW/935
DVI/HDMI video interface. In this case the IGW/935-internal WebKit GTK+ web browser
shows the demo in full screen mode with a resolution of 1280 x 800 (16:10).
Web Application Gateway IGW/935 – First Steps
16 Document Revis ion 1.1
5.7 Access via Telnet
To access the IGW/935 via Telnet please open a Telnet client program (like e.g. TeraTerm)
on your host PC and enter the current IP address* of the IGW/935 to activate a Telnet ses-
sion.
In the upcoming Telnet window you can login with the username root and the password
root.
Now you can enter any Linux commands, which will be executed by the IGW/935 operating
system.
Figure 12: Access via Telnet client
*Note: Please refer to chapter 5.2 for the current IP address of the IGW/935.
Web Application Gateway IGW/935 – First Steps
Document Revis ion 1.1 17
5.8 Access via FTP
The IGW/935 comes with a pre-installed FTP server, which allows the file transfer via
Ethernet between a PC and the IGW/935. To access the IGW/935 via FTP use an FTP client
like e.g. FileZilla.
Figure 13: FileZilla as FTP client to access the FTP server
Use for the FTP login the current IP address* of the IGW/935, the username root and the
password root. With this login you have FTP read/write permission in the file system.
The default setting of the root file system after the boot process is read-only. There are only
three exceptions, which are shown in the following table:
Directory Remark
/flash R/W directory, non-volatile memory within Flash
/home/root R/W directory, RAM disk, volatile memory
/var/volatile R/W directory, RAM disk, volatile memory
Table 4: R/W directories in the file system
The read-only restriction protects all files of the file system. Under ordinary operating condi-
tions it is not possible to overwrite or delete a file which is necessary for the eSOM/3517
within the IGW/935.
To disable the write protection just login with the username root and the password root and
enter the following command:
Web Application Gateway IGW/935 – First Steps
18 Document Revis ion 1.1
mount / -o remount,rw
This command „mounts„ the file system as read/write. All files are now writable and delet-
able. Please pay attention not to damage important system files! With the command
mount / -o remount,ro
the system is set back to the read-only initial condition after the boot process.
*Note: Please refer to chapter 5.2 for the current IP address of the IGW/935.
Web Application Gateway IGW/935 – First Steps
Document Revis ion 1.1 19
6 TECHNICAL DATA
Supply voltage ................................................................................11 – 28 VDC
Weight ................................................................................................... < 0,5 kg
Mechanical Dimensions (LxWxH) ...........................112 mm x 23 mm x 100 mm
Temperature range .......................................................................... 0° C – 70° C
Rel. air himudity..................................................................................max. 85%
7 PINOUT SCREW TERMINALS
The table 3 shows the pinout of the screw terminals of the IGW/935.
Pin Power RS485
A1 RX/TX +
A2 RX/TX -
A3 V+ IN
A4 GND IN
Table 5: Pinout of the screw terminals
* Please note: The RS485 (officially called TIA/EIA-485-A) connection between
your IGW/935 and the field devices needs termination resistors on both ends for
proper operation. The IGW/935 does not offer internal termination resistors. Please
make sure, that the RS485 cable connection is equipped with external termination re-
sistors.
Web Application Gateway IGW/935 - First Steps
20 Document Revis ion 1.1
8 HELPFUL LITERATURE
• IGW/935 hardware reference manual
• eSOM/3517 hardware reference manual
CONTACT
SSV Embedded Systems Dünenweg 5
D-30419 Hannover
Phone: +49 (0)511/40 000-0
Fax: +49 (0)511/40 000-40
E-mail: [email protected]
Internet: www.ssv-embedded.de
Forum: www.ssv-comm.de/forum
DOCUMENT HISTORY
Revision Date Remarks Name
1.0 2012-12-20 First version WBU
1.1 2013-03-08 Added chapter 4.3 WBU
The content of this document can change any time without announcement. There is taken over no guarantee
for the accuracy of the statements. The user assumes the entire risk as to the accuracy and the use of this
document. Information in this document is provided ‘as is’ without warranty of any kind. Some names within
this document can be trademarks of their respective holders.
© 2013 SSV EMBEDDED SYSTEMS. All rights reserved.