WebNet User’s Guide
I/O Consulting A/S
Preliminary Version
6 April 2001
2 WebNet User’s Guide
Contents
1 Introduction 7
1.1 What is the WebNet? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.2 The WebNet Start kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.3 About this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2 Unpacking 9
2.1 Package Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.2 The WebNet DIMM Module . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.3 The WebRJS Adapter Board . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.4 Connecting the boards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3 Installation 12
3.1 Connecting to the Network . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3.1.1 Connecting to a hub . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3.1.2 Connecting to a network switch . . . . . . . . . . . . . . . . . . . . . 12
3.1.3 Connecting directly to the computer . . . . . . . . . . . . . . . . . . 12
3.2 Applying power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.3 Assigning an IP Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.3.1 Auto-IP – the details . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.3.2 Auto-IP – how to assign an IP address . . . . . . . . . . . . . . . . . 13
3.4 Browsing the WebNet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4 Configuration 16
4.1 Access Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.1.1 Setup of web users . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.1.2 FTP to the WebNet . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.1.3 Setup of FTP users . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.2 Network Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.3 Software Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4.4 Remote Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
4.5 Serial Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
WebNet User’s Guide 3
5 Monitoring and Statistics 24
5.1 Console output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
5.2 File System Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
5.3 Network Quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
5.4 Socket Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
5.5 Test and Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
5.5.1 Hardware Tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
5.5.2 Firmware Upload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
6 Tools 28
6.1 Adjust Real Time Clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
6.2 Edit File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
6.3 Interface Controller Update . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
6.4 Scheduled Script Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
6.5 WebScript Debugging Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
7 Uploading and Running Scripts 31
7.1 What are Scripts For? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
7.2 Types of Web Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
7.3 Example Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
7.4 Running the Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
7.5 Debugging Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
8 WebNet as an RS232 Gateway 34
8.1 Loopback example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
8.2 Application on the WebNet or on the PC? . . . . . . . . . . . . . . . . . . . 35
8.3 Application on the PC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
8.4 Application distributed on the WebNet and the PC . . . . . . . . . . . . . . 36
8.5 Architecture Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
A How To Get Started 38
B WebNet IP configuration 39
B.1 Secure Restart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
4 WebNet User’s Guide
B.2 Your ARP table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
B.3 AutoIP Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
C References 41
WebNet User’s Guide 5
List of Figures
1 The WebRJS module with the WebNet module inserted . . . . . . . . . . . 7
2 The WebNet DIMM module . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3 The component side of the WebRJS-DCE board . . . . . . . . . . . . . . . 10
4 The WebNet module is being inserted into the WebRJS module . . . . . . . 11
5 The WebNet module inserted into the WebRJS module . . . . . . . . . . . 11
6 The WebNet home page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
7 Setup of access rights for web users . . . . . . . . . . . . . . . . . . . . . . . 17
8 A list of the most useful ftp commands . . . . . . . . . . . . . . . . . . . . . 17
9 A list of the most important directories on the WebNet . . . . . . . . . . . 18
10 Setup of access rights for the FTP users . . . . . . . . . . . . . . . . . . . . 18
11 The configuration page for network settings . . . . . . . . . . . . . . . . . . 20
12 The System Maintenance Page, for Software installation . . . . . . . . . . . 21
13 Setup page for the Device Sharing service . . . . . . . . . . . . . . . . . . . 22
14 Configuration box for the serial lines . . . . . . . . . . . . . . . . . . . . . . 23
15 The File System Status Page . . . . . . . . . . . . . . . . . . . . . . . . . . 24
16 The Socket Status Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
17 The Test and Service Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
18 The Real Time Clock Setup Page . . . . . . . . . . . . . . . . . . . . . . . . 28
19 The PIC Update Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
20 The WebScript Debugger Tool Page . . . . . . . . . . . . . . . . . . . . . . 30
21 Example script displaying the TCP/IP configuration . . . . . . . . . . . . . 32
22 Principle of the loopback example . . . . . . . . . . . . . . . . . . . . . . . 34
23 Example of a WebNet architecture . . . . . . . . . . . . . . . . . . . . . . . 37
6 WebNet User’s Guide
1 Introduction
1.1 What is the WebNet?
The WebNet is a small electronic device, capable of serving as a gateway between another
electronic device and an ethernet network – for instance an intranet or the Internet. The
WebNet can connect to other electronic devices via e.g. its RS-232 interface.
The user interface of the WebNet consists of a number of web pages contained in the device
and presented by its built-in web server. A standard web browser is used to view and browse
these pages.
Once connected to the user’s RS-232 device, further user interface web pages can easily be
developed by means of the built-in WebScript programming language. Thus, within short
time, the user’s device can be configured and monitored with a standard web browser as
the only necessary application.
1.2 The WebNet Start kit
The WebNet itself is a “sub-credit-card” sized DIMM module, which makes it suitable as an
add-on module for another device. For the benefit of this module, two different start kits, a
“WebRJS-DCE” and a “WebRJS-PIC” adapter board is supplied. The start kits makes it
possible to connect power, ethernet and RS-232 via standard sockets. The WebRJS-DCE
and the “WebRJS-PIC” boards can thus be considered “motherboards” for the WebNet,
with the specialized purpose of providing RS-232 connectivity. Figure 1 shows the WebRJS
module with the WebNet module inserted. The “WebRJS-PIC” adapter board contains an
additional microcontroller, PIC16F876. The microcontroller opens possible connections to
a wide range of different hardware interface types. All I/O ports of the microcontroller is
accessable through a connector on the PCB.
Figure 1: The WebRJS module with the WebNet module inserted
WebNet User’s Guide 7
1.3 About this Manual
The purpose of this manual is to make the new WebNet owner acquainted with the WebNet
start kit and get started using it1. First, in section 2 we unpack and identify the parts of
the start kit. Then, in section 3 we install the unit and connect to it with a web browser.
Sections 4, 5 and 6 are a tour round the various configuration and monitoring/statistics
pages of the WebNet. In section 7 we look at the basics in writing and running scripts for
making dynamic web pages. In section 8, we try to get a “hole through” to the RS-232
interface. Section C contains references to further information.
Updated information, documentation and service can be found on the I/O Consulting’s
WebNet home page [3] http://webnet.iocon.dk. See also I/O Consulting’s home page [2]
http://www.iocon.dk for information on other services offered by I/O Consulting.
1
Most of the information in this manual applies to version 1.93, or later, of the WebNet software. Func-
tionality, user interface and specifications may change in later versions.
8 WebNet User’s Guide
Loading...