NetBurner SBL2e User manual

SBL2e Dual Serial-to-Ethernet
User's Manual
Downloaded from Elcodis.com electronic components distributor

SBL2e Dual Serial-to-Ethernet User's Manual Page 2
Table of Contents
1. Overview.......................................................................................................................................4
2. IPSetup Software Utility..............................................................................................................4
3. Initial Configuration...................................................................................................................4
3.1 Serial Port Hardware......................................................................................................................5
3.2 Network Configuration...................................................................................................................5
3.3 Operational Configuration.............................................................................................................6
4. Web Page Configuration.............................................................................................................7
4.1 Network IP Settings Configuration...............................................................................................7
4.2 Incoming Connections (Server Mode)...........................................................................................8
4.3 Outgoing Connections (Client Mode)............................................................................................9
4.4 Custom Packetization ...................................................................................................................10
5. Serial Settings............................................................................................................................12
6. Password Settings......................................................................................................................13
7. Multi-Function Pin Control......................................................................................................14
7.1 Multi-Function Pin Control .........................................................................................................15
7.2 Command Syntax..........................................................................................................................15
7.3 Machine Command Mode............................................................................................................17
7.4 Machine Command Examples .....................................................................................................18
7.4.1 Set Pins 14 and 15 to GPIO Outputs..........................................................................................................18
7.4.2 Set All GPIO Pins as Inputs and Readback ...............................................................................................18
7.4.3 Read A/D Inputs ........................................................................................................................................18
8. AT Commands...........................................................................................................................19
8.1 Enter and Exit Command Mode..................................................................................................19
8.2 Command Syntax..........................................................................................................................20
8.3 System/Network Configuration ...................................................................................................21
8.4 Serial Port Configuration.............................................................................................................22
8.4.1 Custom Packetization ................................................................................................................................23
8.5 GPIO Server and Analog to Digital Readback...........................................................................24
8.6 AT Command Examples...............................................................................................................25
8.6.1 Changing the System IP Address...............................................................................................................25
8.6.2 Configuring the Serial Server Listen Port..................................................................................................25
8.6.3 Configure Outgoing Network Client Connection......................................................................................25
8.6.4 Read Analog to Digital Input Channel 1....................................................................................................26
8.6.5 Change Pin to GPIO and Set Output to High ............................................................................................26
9. LEDs ..........................................................................................................................................27
10. RS-232 NULL Modem Wiring..............................................................................................27
11. Network IP Address Configuration......................................................................................27
Downloaded from Elcodis.com electronic components distributor

SBL2e Dual Serial-to-Ethernet User's Manual Page 3
12. Web Browsers and Proxy Servers.........................................................................................28
13. Testing with a Telnet Connection.........................................................................................28
14. Telnet to Serial Test Procedure.............................................................................................29
Revision History ................................................................................................................................30
Downloaded from Elcodis.com electronic components distributor

SBL2e Dual Serial-to-Ethernet User's Manual Page 4
1. Overview
The NetBurner SBL2e is a dual serial-to-Ethernet device that will enable your serial device to
communicate on an Ethernet network using TCP or UDP. In addition to the serial capabilities, the
SBL2e also provides a separate network connection command channel for control of digital I/O
signals and analog-to-digital readback. A list of features and functions is below:
2 Serial UARTs, TTL level, baud rates from 300 to 115,200
4 12-bit analog to digital converters, 0-3.3VDC input
Up to 10 Digital inputs/outputs, also referred to as GPIO
10/100 Ethernet
Serial to Ethernet capability through TCP or UDP
DHCP and Static IP addressing
Custom data packetization options
Web page configuration
AT command set configuration and operation
3.3VDC input power @ 250mA max
2. IPSetup Software Utility
Setup and configuration of your SBL2e requires the IPSetup.exe Windows PC utility available for
download at www.netburner.com, in the Support > Public Downloads section:
http://www.netburner.com/support/public_downloads.html
3. Initial Configuration
Before you can begin using your SBL2e, three areas of configuration are required to tell your
SBL2e what type of serial interface you want to use, the network IP address network port number,
and the serial data baud rate.
1. Hardware configuration
2. Network configuration
3. Operational configuration
Downloaded from Elcodis.com electronic components distributor

SBL2e Dual Serial-to-Ethernet User's Manual Page 5
3.1 Serial Port Hardware
The SBL2e has two asynchronous UART type serial ports, referred to as Port 0 and Port 1. The
SBL2e provides to TTL level UART serial ports:
Port 0 signals : TX, RX, RTS, CTS
Port 1 signals : TX, RX
If you need RS-232 electrical levels, then you must add the appropriate level shifters to the TTL
signals.
The “Debug Serial Port”, or Debug Port for short, is used to display status messages from the
application. If your application needs only a single serial port we recommend setting the other serial
port to “Debug”.
3.2 Network Configuration
1. Run IPSetup.exe (by double clicking its icon). This program is located on the SBL2e product
page at www.netburner.com. To view the Advance Settings, click on the Advanced button (the
button name will change to Basic). In this example, I am using Uart 1 as my Monitor port
(screen shot below).
2. Locate your SBL2e in the "Select a Unit" pane by matching its MAC address. The MAC
address is located on the bottom of your SBL2e. If your SBL2e device does not appear in the list
box, verify the power, speed, and link LEDs are illuminated, and click the Search Again button.
If you are still unable to see your SBL2e, remove power, correct any cabling errors, reapply
power, and click the Search Again button. Note: IP Setup uses a UDP broadcast protocol and
will not operate through a router.
FIREWALLS: IPSetup uses UDP and TCP port number 20034. If your computer’s
firewall is blocking this port number you will need to either disable the firewall, or add a
rule to the firewall to allow communication on this port number.
3. If your network supports DHCP (factory default): The assigned IP Address will appear in the
"Select a Unit" pane. Write down this address. If your network does not support DHCP,
configure the IP Address and Network Mask fields as shown in the screen shot below. If you
need help selecting values, please read the "Selecting an IP Address" section at the end of this
guide. After you have entered all of your values, click the Set button in the center of the IP
Setup window to configure your SBL2e with its new parameters. Note: If you do not click the
Set button, your values will not be saved. If you have multiple NetBurner devices, make sure
you selected your SBL2e in the "Select a Unit" pane (as shown in the screen shot) before you
input your information.
Downloaded from Elcodis.com electronic components distributor

SBL2e Dual Serial-to-Ethernet User's Manual Page 6
A screen-shot of IPSetup is shown below:
3.3 Operational Configuration
Once the network parameters are, you can use the web server interface or serial AT commands to
modify the settings of your SBL2e. We recommend using the web interface first to familiarize
yourself with the operation of the SBL2e. To access the web page, click on the Launch Webpage
button in IP Setup, or you can open your web browser, and enter the numeric IP Address in the
address field (e.g. http://10.1.1.110).
Downloaded from Elcodis.com electronic components distributor

SBL2e Dual Serial-to-Ethernet User's Manual Page 7
4. Web Page Configuration
Once you have configured the IP address of your device you can connect to the SBL2e web server
to configure your serial and network settings. The SBL2e can be configured in one of 3 modes:
1. TCP Server: Listen for incoming TCP connections.
2. TCP Client: Connect to a target network address when serial data is available, or you can
also establish a network connection on SBL2e power-up.
3. UDP: Send and receive using UDP packets
4.1 Network IP Settings Configuration
The first section of the Network Configuration page is used to select DHCP or static IP addressing.
If you select DHCP, and the you have a DHCP server on your network, the DHCP assigned values
will be displayed. To select a static IP address chance the Address Mode to Static, and enter your
values in the Static Settings fields.
Device Name
Specifies the device name to send to your DHCP server.
Address Mode
Select between DHCP and Static IP address settings.
Device IP Address
Device Subnet Mask
Device Gateway
Device DNS
If Address Mode is set to DHCP, your DHCP server will provide these
values and they will be displayed in the DHCP Assigned Values column.
If you wish to specify these values yourself set the Address Mode to
“static” and type the values in the appropriate fields. Note that if you do
not specify a Gateway or DNS server you will not be able to communicate
outside your LAN.
Ethernet Link
Normal = Auto-negotiate. You may also force 10MB or 100MB modes.
Downloaded from Elcodis.com electronic components distributor

SBL2e Dual Serial-to-Ethernet User's Manual Page 8
4.2 Incoming Connections (Server Mode)
This section configures the SBL2e in a device server mode in which it listens for incoming TCP
connections (or UDP packets if enabled) for each serial port.
Listen for incoming network
connections
Select checkbox to enable the port to listen for
incoming TCP connection requests or UDP packets.
Checking this box will override the TCP Client mode.
Listening network port
Port number to listen on. The default port is 23 (telnet).
The listen port numbers for Port0 and Port1 must be
different.
Timeout and disconnect after this many
seconds of inactivity.
Terminate TCP connection if no incoming network
data or outgoing serial data has occurred. This is useful
because there is no way to detect if a client has crashed
or abnormally terminated unless unacknowledged data
exists and times out. A value of 0 disables this feature.
This field has no effect in UDP mode.
Allow new connection if the existing
connection has been idle for this many
seconds.
Similar to the disconnect timeout, but does not
disconnect a connection until a new connection is
requested. A value of 0 disables this feature. This field
has no effect in UDP mode.
Downloaded from Elcodis.com electronic components distributor

SBL2e Dual Serial-to-Ethernet User's Manual Page 9
4.3 Outgoing Connections (Client Mode)
Make outgoing connections
Selects between connect on power-up for a permanent
TCP connection, or make a TCP connection when
serial data available. This feature has no effect on
UDP.
Connect on network port
Specifies destination TCP or UDP port number
Connect to this address
Specifies destination IP address for TCP or UDP.
When using UDP you must specify an address and port
number in this section, or enable the Learn UDP Reply
Address feature in the Custom Packetization section.
Timeout and disconnect after this many
seconds of inactivity.
Terminate TCP connection if no incoming network
data or outgoing serial data has occurred. This is useful
because there is no way to detect if a client has crashed
or abnormally terminated unless unacknowledged data
exists and times out. A value of 0 disables this feature.
This feature has no effect on UDP.
Retry failed outgoing connections after
this many seconds.
Number of seconds to wait before retrying an outgoing
connection. This feature has no effect on UDP.
Downloaded from Elcodis.com electronic components distributor

SBL2e Dual Serial-to-Ethernet User's Manual Page 10
4.4 Custom Packetization
Custom packetization can apply to TCP and UDP communication. Unlike TCP, UDP is a
connectionless protocol. The SBL2e provides two methods to determine the destination network IP
address: you can specify a static IP address, or you can use the source IP address of the last received
UDP packet by selecting the “Learn UDP Reply Address” checkbox.
Use custom packetization logic
Enables/disables custom packetization settings
Use UDP instead of TCP
Check to enable UDP
Learn UDP reply Address
Send outbound serial to the IP address from the last
received UDP packet. Useful for clients that may have
changing IP addresses. If not using this feature, you
must specify the destination IP address and port
number in the Outgoing Connections section.
Number of characters to accumulate
before sending TCP/UDP packet
Maximum number of characters to accumulate from
the serial port before sending them out the network
port. This setting will be overridden if the
accumulation delay time setting is used and the delay
time expires.
Number msec to wait for accumulated
characters (0 waits forever)
Maximum wait time in milliseconds for received serial
characters before sending any available characters out
the network port.
Flush TCP frame when this character is
received (Enter NA to disable)
Send all accumulated serial data upon receipt of this
character from the serial port. Enter the decimal value
of the character. For example, a line feed is 10.
Downloaded from Elcodis.com electronic components distributor