Solvline PB2xxxUG User Manual
2040 / 2160 / 2161 / 2321
User Guide
Ver. 4.2
2005/3/10
Contents
Chapter 1
1. Package Components .......................................................................................... 4
2. Structure............................................................................................................... 5
3. Features ............................................................................................................... 7
4. Specifications ....................................................................................................... 7
5. Applications .......................................................................................................... 8
Chapter 2
1. Setting address thru serial port .......................................................................... 11
2. Setting network with LAN port ............................................................................ 13
Chapter 3
Chapter 4
1. Getting started .................................................................................................... 16
2. Network Setting .................................................................................................. 18
3. Serial port Setting............................................................................................... 20
4. Applying settings ................................................................................................ 24
Introduction.................................................................................................4
Configuration............................................................................................11
Configuration via Serial Port ...................................................................14
Configuration via Web
..................................................................................16
5. Reset .................................................................................................................. 24
6. Firmware Update................................................................................................ 25
7. Portbase Information .......................................................................................... 27
Chapter 5
1. Connecting Network ........................................................................................... 28
2. Connecting Serial Equipment............................................................................. 28
Chapter 6
1. Redirector Introduction ....................................................................................... 30
2. Installing Redirector............................................................................................ 31
3. Using Redirector................................................................................................. 38
4. Uninstalling Redirector under Windows 2000/XP .............................................. 45
Chapter 7
1. Installation on Linux/Unix ................................................................................... 48
2. RTCP Port Addition ............................................................................................ 49
3. Starting RTCP..................................................................................................... 49
Portbase Installation.................................................................................28
COM Port Redirection ..............................................................................30
TTY Port Redirection................................................................................47
4. Finishing RTCP .................................................................................................. 49
2
Chapter 8
1. Portview Introduction.......................................................................................... 50
2. Installing Portview .............................................................................................. 51
3. Using Portview ................................................................................................... 53
4. Uninstalling Portview .......................................................................................... 71
Management with Portview......................................................................50
Chapter 9
Chapter 10
1. Console Cable.................................................................................................... 74
2. RS232 Serial Cable............................................................................................ 75
3. RS232 Modem Cable......................................................................................... 75
4. RS422 Serial Cable............................................................................................ 76
5. RS485 Serial Cable............................................................................................ 76
6. Direct LAN Cable................................................................................................ 77
7. Cross LAN Cable................................................................................................ 77
8. LoopBack Connector.......................................................................................... 78
Chapter 11
1. Development Environment ................................................................................. 79
2. List of Functions ................................................................................................. 79
3. Sample ............................................................................................................... 85
4. Compile .............................................................................................................. 88
5. Application .......................................................................................................... 89
SNMP .........................................................................................................72
Cable Specifications.................................................................................74
Portbase SDK............................................................................................79
Chapter 12
1. COM Port Communication Program .................................................................. 91
2. TTY Port Communication Program .................................................................... 94
3. Windows Socket Communication Program........................................................ 96
4. Socket Program for Linux/Unix......................................................................... 100
Programming Examples...........................................................................91
3
1
Introduction
Portbase-2040/2160/2161/2321 (hereinafter referred to as “Portbase”) is a multi-functional terminal server
providing one RS232 serial port that can be connected to a network.
1. Package Components
The Portbase consists of:
Portbase unit
Power Cable
Portbase CD including Redirector, Portview, SDK and Manual
Redirector : The network COM port driver enable to use a port of terminal server as like using
PC’s local COM port. (Please refer to the Chapter 6 COM Port Redirection and
Chapter 7 TTY Port Redirection for details.)
Portview : The program that enables you to monitor the Portbase communication status in
real time. Portview displays the data input/output through each serial port as well
as the communication status of Portbase from remote PCs under the Windows
environment. (Please refer to the Chapter 8 Management with Portview for
details.)
SDK : The Portbase SDK (Software Development Kit) is designed for custom Portbase
application developement. (Please refer to the Chapter 11 Portbase SDK for
details.)
4
2. Structure
1
Model 2040:
Front View
2 4 3
LED Description
1 PWR
2 RDY
3 WAN
4 LAN Not used
Rear View
Turns red on power on
Turns green on normal run(Flickers at fault)
Turns green with LAN port is connected
1
2
3
4
5
6
Description
1 POWER
2 WAN
3 LAN
4 RESET
5 CONSOLE
6 SERIAL
Socket to provide 100-220v AC, 50-60Hz power
10 Mbps Ethernet RJ-45
10 Mbps Ethernet RJ-45 (not used)
Hardware reset button
Serial port for environment configuration
RJ-45 type socket for serial ports (RS232/422/485)
5
Model 2160/2161/2321:
1
1
Front View
2 4 3
LED Description
1 PWR
2 LAN10/100
Turns red on power on
Turns green when LAN10/100 port is connected
3 LAN10 Not used
4 RDY
Turns green if the firmware is ready (flickers at fault)
Rear View
2
3
4
5
6
7
Description
1 POWER
2 COOLER F AN
3 RESET
4 LAN10/100
5 LAN10
6 CONSOLE
7 SERIAL
Socket to provide 100-220v AC, 50-60Hz power
To prevent overheating
Hardware reset button
10/100 Mbps Ethernet RJ-45
10 Mbps Ethernet RJ-45 (not used)
Serial port for environment configuration
RJ-45 type socket for serial ports (RS232/422/485)
The above description conforms to both 2321 and 2161 models.
However, 2321 and 2161 have 32 and 16 serial ports respectively beside the
fixed serial modules.
6
3. Features
It enables the access of the serial device thru network.
You can use the existing COMx/TTYx communication programs thru network
4. Specifications
Description
2040 2160 2161 2321
Serial Port
Weight
SDRAM
CPU
LAN 10/100 or
WAN
Size
Flash RAM
LAN 10 or LAN
Serial Port Type
Serial Port
Speed
Console Port
LED
Modem Signal
Line Control
4 (Fixed) 16 (Expandable) 16 (Fixed) 32 (Fixed)
1.3 kg 3.52 kg 2.59 kg 3.04 kg
32 M 64 M
32 Bit RISC Processor
10/100 Mbps Ethernet Port (Model 2040: not used)
439 * 234 * 63 mm (Model 2040: 240 * 157 * 50 mm)
4 MB
10 Mbps Ethernet Port (Model 2040 only)
RS232, RS422, RS485
Maximum 230.4 Kbps
9600 bps / RS232 / DB9
PWR, RDY, WAN, LAN
Controls all modem signal lines except RI
Overvoltage
Protection
Protocol
Environment
Setting
Management
Tool
Redirection
Power
All modem signal lines have surge protection.
Supports TCP, UDP, Telnet, ICMP, DHCP, TFTP, HTTP, PPP, SNMP
Console, Web
Portview, Web
Windows-based COM Port Redirection
Unix/Linux-based TTY Port Redirection
100 - 220 VAC (Free voltage)
7
5. Applications
You can use the Portbase in various ways.
1) Network Serial Communication
This is the most common application of PortBase. By connecting a PC and a PortBase to a network,
you can use serial equipments connected to the Portbase from remote PCs.
2) Serial Communication Tunneling
You can use the network as if it is a serial cable from your PC.
LAN
LAN
Serial Devices
Serial Devices
Serial Devices
Serial Devices
PC
PC
PC
PC
Portbase
Portbase
Portbase
Internet
Internet
Internet
Internet
Internet
Modem
Modem
Modem
Modem
PSTN
PSTN
PSTN
PSTN
PSTN
Modem
Modem
Modem
Modem
Server
Server
Server
Server
PC
PC
PC
PC
Serial
Serial
PC
PC
Portbase Portbase
Portbase Portbase
Internet
Internet
Internet
8
Serial
Serial
PC
PC
3) Serial Port Redirection
By exploiting redirection feature, serial ports of PortBase connected to the network can be used in
the PC as if they belong to the PC.
PC
LAN
LAN
4) Serial Link
COM1
COM1
PC
COM2
COM2
Portbase
Portbase
Serial Devices
Serial Devices
Internet
Internet
Internet
COM3
COM3
Portbase
Portbase
Portbase
Portbase
PC
PC
Serial Link, using network-connected Portbases, enables other Portbases not connected to the
network to be perceived as if they were connected to the network.
PC
PC
LAN
LAN
Portbase
Portbase
Modem
Modem
PSTN
PSTN
PSTN
Serial Devices
Serial Devices
Modem
Modem
Portbase
Portbase
9
Serial Devices
Serial Devices
5) Adding Customized Features
Using Software Development Kit (SDK), you can add any function you want to PortBase. Please
refer to the Chapter 11 Portbase SDK for details.)
6) Console Server
Console server enables monitoring and controlling of multiple serial devices from one PC. These
serial devices can be connected through telnet application, and these may include server, router,
UPS, etc.
LAN
LAN
Portbase
Portbase
Serial Devices
Serial Devices
PC
PC
PC
PC
User Program
User Program
LAN
LAN
Portbase
Portbase
Servers
Servers
10
2
Configuration
PortBase’s IP address is initially set to a default address, so it has to be reconfigured appropriately before
the first use. You can set the IP address and other operation parameters with Web browser or telnet from
PC, using the LAN, serial, or console port.
1. Setting address thru serial port
1) Connect the Console cable (DB9 to DB9) provided into COM port on the rear panel of Portbase.
2) Run the terminal emulator on the PC. This document describes with “hyperterminal” which is the
standard emulator of Windows.
Open COM port of the PC connected with Portbase.
11
3) Set the COM port to 9600 bps, none parity, 8 data bit, and 1 stop bit.
4) Turn on the Portbase (By connecting the power line of Portbase to power).
5) Set the Portbase IP Address.
set ip User IP Address
6) Set the Subnet Mask (Default: 255.255.255.0) .
set mask User Net Mask Address
7) Set the Gateway IP Address(Default: 203.211.173.1) .
set gateway User Gateway Address
8) To confirm the over all setting values, use the command below.
set view
9) To write the Flash memory after altering, use the command below.
set save
10) After the environment settings are applied, you should restart the system
reboot
.
To remember the IP setting, write it down on the sticker below the Portbase
12
2. Setting network with LAN port
1) Connect the PC and Portbase to the network.
There are two ways to connect Portbase to the network : Direct connection with PC and connection
through HUB. (Connection port that can be used is either LAN 10/100 or WAN port of Portbase)
Direct connection with PC Connection through HUB
2) Set the PC IP address among the appropriate range of Portbase IP address.
(The factory default Portbase IP address is “192.168.1.72”.)
3) Run the web browser on the PC Windows and enter the IP address of Portbase in the address field.
(The factory default Portbase IP address is “192.168.1.72”.)
4) Configuration via web browser is discussed in Chapter 4 Configuration via Web
13
3
Configuration via Serial Port
In order to configure the environment in details, you have to connect the serial port of the PC to that of
Portbase.
To do a detailed setup, use commands as follows.
1) Configure the Line Type.
Portbase provides 3 line types as follows.
IP Type Configuration:
DHCP Type Configuration:
PPPoE Type Configuration:
2) Configure the Portbase IP Address.
set ip
(Applicable only when the Line Type is IP.)
3) Configure the Subnet Mask. (Default: 255.255.255.0)
set mask
(Applicable only when the Line Type is IP.)
4) Configure the Gateway IP Address.
set gateway
(Applicable only when the Line Type is IP.)
5) Configure the PPPoE user name.
IP_ address
Net_Mask_Address
Gateway_Address
set line
set line
set line
IP
DHCP
PPPoE
set username
(Applicable only when the Line Type is PPPoE.)
6) Configure the PPPoE user password.
set userpass
(Applicable only if the Line Type is PPPoE.)
username
password
14
7) Configure the Portbase alias name: up to 32 characters (Default: None)
set name
8) Configure the Portbase group name: up to 32 characters (Default: None)
set group
9) Configure the Portbase location name: up to 32 characters (Default: None)
set location location
10) Configure the NMS IP Address : (Default: 0.0.0.0)
set nms
(For more details, refer to PortView manual.)
11) Configure the password: up to 8 characters (Default: 9999)
set password
12) To confirm the configuration set, use command as follows
alias_name
group_name
_name
PortView_server_address
password
set view
13) After completion of configurations, you should
If you made any changes on configuration, you must execute the save command.
save the configurations you applied.
set save
14) After changing the configuration, you should reboot the system.
reboot
15) Write the IP address assigned on the sticker at the bottom side of the Portbase. to remember.
15
Configuration via Web
4
Each Portbase has its own web page in it, and helps you set the operational configuration appropriate to
each individual environment.
The web page for the configuration consists of:
Network Configuration
Serial port Setting
Firmware Update
1. Getting started
1) Set IP address of Portbase first, if you have not set it yet (See Chapter 2 Configuration.)
2) Enter the Web page of Portbase thru browser by IP address.
3) Enter the password, If the initial window as shown below appears.
Password is initially set to '9999'.
Please, try to connect thru serial port, if you forget password.
4) Click “LOGIN” and start Operational Environment Setting.
16
Network Setting : Set networking operational environment
Port Setting : Set serial port operational environment.
Save & Restart : Save settings and starting for normal runs.
Factory Default : Reset all Portbase settings to factory default values.
Firmware Updating : Update Portbase firmware.
About Portbase : shows product information and contact numbers.
17
2. Network Setting
Perform IP address settings when you intend to change the Portbase IP address or password.
1) Click on “Network Setting” and the following window will appear.
2) Click on “Modify” and a window will appear to modify the configuration.
Name
Name the Portbase for the ease of identification by user.
Up to 32 characters
Group
Assigns the group name for the Portbase.
Up to 32 characters
Location
Assigns the name where the Portbase is located.
Up to 32 characters
Line Type (Default: IP)
Select Network Line Type (IP, PPPoE, or DHCP).
IP Address
18
Set the Portbase IP address for network access.
To configure the network through the Link function(cascaded configuration between Portbases)
of other Portbase, you should certainly set the address to ‘0.0.0.0’. (Only IP Line Type)
Subnet Mask (default:255.255.255.0)
Subnet Mask is determined according to the class of IP address.(Only for IP Line Type)
Gateway Address
A router’s IP address in the same LAN segment as the Portbase(Only for IP Line Type)
Password (default:9999)
Sets password to access the Portbase web page via the web browser.
PPPoE UserName (default: None)
Sets an Identification of PPPoE(Only for PPPoE Line Type)
PPPoE Password (default: None)
Sets a Password of PPPoE(Only for PPPoE Line Type)
NMS IP Address (default:0.0.0.0)
Sets an IP address to communicate with PC where the PortView software is installed.
(Refer to the ‘Portview Manual’ for details.)
NMS Socket Number (default:4000)
Type the socket number to communicate with PC where the PortView software is installed.
19
3. Serial port Setting
1) Click on “Port Setting” and the following window will appear
2) Click on “Modify” and the window for modification appears, then you can make new settings.
Select Port.
Port number to be set.
Choose “All Ports “ and all ports can be set to the same value.
Name
Give the port a name that is easily recognized by the users.
Maximum of 16 characters
Status (Default: enable)
Whether the port can be used or not. (enable, disable)
20
Socket Number
The socket number assigned to the port.
Software uses this number for network communication.
Port 1 Socket 4001
Signal (Default: DataOnly)
Select the signal line that the serial port will provide and examine. (Modem, DataOnly)
If the Signal is set to Modem, all modem signals except RI are provided and examined for
communication.
If the Signal is set to DataOnly, communication is performed only with Txd, Rxd, Gnd lines.
Protocol (Default: COM)
J Passive
Portbase plays the role of socket server and enables serial equipment or PCs to directly
access the socket client. If the serial equipment or PC is successfully connected to the
socket client, data transmitting/receiving become possible.
J Active
When the serial equipment or PC is on standby for access as a socket server, Portbase
plays the role of socket client and tries to access the serial equipment or PC. If the
connection fails, Portbase will continuously try to access the serial equipment or PC until
they are successfully connected, thus enabling data transmitting/receiving between them.
J Mpassive
Portbase plays the role of socket server and enables serial equipment or PCs to directly
access the socket client and limits the number of outstanding connections in the socket's
listen queue to the number 5. If the serial equipment or PC is successfully connected to
the socket client, data transmitting/receiving become possible.
J Telnet
A general telnet client program. The program can access any server where the telnet
server is being operated.
J COM
COM is used for PC’s COM port expansion.
21
J TTY
J Link
TTY is used for the Unix/ Linux’s TTY port expansion.
Link enables other Portbase to be connected to the network.
Portbase
Portbase
Portbase
J User
IP 192.168.1.1
IP 192.168.1.1
IP 192.168.1.1
Server
Server
LAN
LAN
LAN
Local IP 10.10.10.100
Local IP 10.10.10.100
Local IP 10.10.10.100
Local IP 10.10.10.100
Remote IP 10.10.10.201
Remote IP 10.10.10.201
Remote IP 10.10.10.201
Remote IP 10.10.10.201
IP 0.0.0.0 IP 0.0.0.0
IP 0.0.0.0 IP 0.0.0.0
IP 0.0.0.0 IP 0.0.0.0
Local IP 10.10.10.201
Local IP 10.10.10.201
Local IP 10.10.10.201
Local IP 10.10.10.201
Remote IP 10.10.10.100
Remote IP 10.10.10.100
Remote IP 10.10.10.100
Remote IP 10.10.10.100
Server
Portbase
Portbase
Portbase
IP 192.168.1.2
IP 192.168.1.2
IP 192.168.1.2
Local IP 10.10.10.100
Local IP 10.10.10.100
Local IP 10.10.10.100
Local IP 10.10.10.100
Remote IP 10.10.10.202
Remote IP 10.10.10.202
Remote IP 10.10.10.202
Remote IP 10.10.10.202
Local IP 10.10.10.202
Local IP 10.10.10.202
Local IP 10.10.10.202
Local IP 10.10.10.202
Remote IP 10.10.10.100
Remote IP 10.10.10.100
Remote IP 10.10.10.100
Remote IP 10.10.10.100
Use user program. You may register your own program as following steps
1) Write your program. (Refer to Chapter 11 Portbase SDK)
2) Compile this code by cross-complier and create object file.
3) Compress the object file to “user.zip” name.
Portbase
Portbase
Portbase
(You should be less than 250000 bytes the size of “user.zip” file.)
4) Upload to Portbase, using ftp program.
(Username: portbase, Default password: 9999)
5) Portbase will reboot automatically, After uploading at “/home/portbase” directory.
6) Set your program to configuration of Portbase, using a telnet or web.
<Telnet program>
% set port 1 protocol user
(Set your program to port number 1)
% set port 1 name user_program_name
(Set the name of user program to port number 1)
% reboot
(System will reboot.)
7) The demon of user program will carry out atomically.
22
Flow Control (Default: None)
J A flow control protocol. You can set it to None, RTS/CTS, Xon/Xoff, Xoff.
Speed (Default: 9600 bps)
J Speed can be set to the communication speed range of 150 bps ~ 230.4 Kbps.
Parity Bit (Default: None)
J A parity check method. You can set it to None, Even, Odd.
Character Size (Default: 8)
J Number of bits constituting one byte. You can set it to 5,6,7,8.
Stop Bit (Default: 1)
J Number of Stop Bits. You can set it to 1, 2.
Keep Alive Time (Default: 0 sec)
J The port is logically connected to PC and if the given time has been passed since
receiving or sending last data, this will automatically disconnect the port from the PC. (0–
connection will be maintained)
MTU Size (Default: 1 byte)
J If there needs a certain volume of incoming data to be continuously received, you can
designate the MTU value.
Local IP Address
J The port’s virtual IP address when it is used as a channel for other Portbase connection.
The address is used in case of Link protocol.
Remote IP Address
J The opponent’s IP address. The address is used in case of Active-TCP; Telnet; Link
protocol.
Remote Socket Number
J The opponent’s socket or port number. The number is used in case of Active-TCP; Telnet;
Link protocol.
23
4. Applying settings
After the operation environment setting is successfully completed, you should click on “Save &
Restart” to apply the new settings to Portbase.
5. Reset
To return the Portbase back to its initial settings, you can click on “Factory Default”.
Please be careful, because you will have return to the first configuration step after
using the Reset function.)
24
6. Firmware Update
Firmware is the Operating System (OS) loaded in the Portbase flash memory.
You can download the latest firmware of Portbase from the SystemBase web site.
The steps to update the firmware are as follows.
1) Access the download page at SystemBase web site at
2XXX firmware file.
2) Access the Portbase web page via the browser.
3) Click on “Firmware Updating” and the following window for firmware updating will appear.
www.sysbas.com and download the pb-
25
4) Click on “Browse” and find the firmware file location.
5) Click on “Updating” and the firmware will be automatically updated.
26
7. Portbase Information
Click on “About Portbase“ and you can see the Portbase information and contact numbers.
27
5
Portbase Installation
1. Connecting Network
Have the Portbase and PC(or server) access the network
Connect the direct LAN cable to LAN1 port on the rear panel of Portbase, and to network(normally to
HUB) to do this
2. Connecting Serial Equipment
LAN
LAN
Connect the serial equipment to the Portbase using serial cable.
(Refer to Chapter 10 Cable Specifications)
Connecting the serial equipment Locally
PC
PC
Portbase
Portbase
LAN
LAN
Server
ServerServer
Portbase
Serial Devices
Serial Devices
Portbase
28
Connecting serial equipment remotely
LAN
LAN
Server
ServerServer
(Protocol: COM)
Portbase
Portbase
(Protocol: COM)
Modem
Modem
PSTN
PSTNPSTN
Connect the serial equipment through Link configuration
Server
LAN
LAN
ServerServer
Modem
Modem
Serial Device
Serial Device
Portbase
Portbase
Modem
Modem
PSTN
PSTNPSTN
Modem
Modem
Portbase
Portbase
Serial Devices
Serial Devices
29
COM Port Redirection
1. Redirector Introduction
Redirector is a network COM port driver, enabling serial ports of Portbase to operate the same way as the
local COM ports of PC.
Upto 255 COM ports can be registered in one PC if Redirector is used.
1) Supported Hardware
Portbase 2010 / 2040 / 2160 / 2160 / 2161 / 2321
2) Supported Software
6
COM Port Redirector for Windows 98/ME
COM Port Redirector for Windows 2000/XP
3) System Requirements
PC system requirement for running Redirector is as follows.
CPU : Pentium 100 MHz or higher
Memory : 16 Mb or more
Operating System : Windows 98/ME/XP/2000/2003/NT
CD-ROM : Faster than 4X
Network : 10M Ethernet or higher
30
Loading...