No patent liability is assumed with respect to the use of the information contained herein. While every precaution has been taken in
the preparation of this manual, Exegin Te chnologies Limited assumes no liability for errors or omissions contained herein or for
any damages in connection with the performance or use of this material.
All rights reserved. All other product names are trademarks of their respective manufacturers or providers.
This manual was written, illustrated, and produced using FrameMaker publishing software.
Figure 26: Help Page.................................................................................................................................56
Figure 27: Q53 Declaration of Conformity...............................................................................................74
Figure 28: Power Socket............................................................................................................................7 6
This manual describes the installation and configuration of the Q53 ZigBee / 802.15.4
Gateway Bridge on your network. For the latest information on the Q53, please see the
Technical Support section of Exegin’s Web site:
Contents of the Manual
This manual contains the following chapters:
2: Introduction to the Q53 ZigBee / 802.15.4 Gateway Bridge. A description of how
the Q53 works, and its main features.
3: Installing the Q53. Installing and connecting the Q53 ZigBee / 802.15.4 Gateway
Bridge to a TCP/IP network.
http://www.exegin.com/
4: Configuration Tools. Utilities provided with the Q53 ZigBee / 802.15.4 Gateway
Bridge and some basic TCP/IP commands that you will need to configure the Q53.
5: Configuring the Q53 on Your Network. Describes how to set up the TCP/IP network
parameters on the Q53.
6: Q53 Zigbee PAN and Bridge Configuration. Describes how to set up the Zigbee and
bridging parameters on the Q53 to establish a Zigbee bridge over your TCP/IP network.
7: Using HTML Pages to Configure the Q53. Descriptions of the Q53 web pages for
configuring the Zigbee gateway bridge device and viewing its status.
8: Reference Information. Provides a complete command list and information about
using the Q53’s command line interface shell. Describes the Q53 naming scheme, how
to reset units to factory defaults and how to upgrade the firmware.
9: Extra Features/Additional Information. Topics covered include product
architecture, general options, security features, using the FTP daemon to access the Q53,
and managing the Q53 with SNMP.
10: Q53 Specifications. Providing hardware and software specifications for the Q53,
connector pinouts, LED status indicators and variable definitions.
11: Getting Help. Where to find help and how to return the Q53 for repair.
12: Glossary.
ii. Introduction to the Q53 ZigBee / 802.15.4 Gateway Bridge
What is the Q53?
INTRODUCTIONTOTHE Q53 ZIGBEE / 802.15.4
ii
GATEWAY BRIDGE
This chapter describes the Q53’s architecture and special features. The topics included
are:
•What is the Q53? on page 11
•Physical Features on page 11
•How Does the Q53 Work? on page 12
•Product Features on page 12
What is the Q53?
The Q53 ZigBee / 802.15.4 Gateway Bridge allows the connection of disparate Zigbee
wireless meshes over a TCP/IP network to form a single PAN (Personal Area Network).
Using the Q53, low-latency PANs may be created that span buildings, campuses or
continents via local TCP/IP intranets or over the Internet.
Typical applications for the Q53 include: interconnection of out-of-range devices;
interconnection of 2.4 GHz PANs; or extension of a PAN to a central management and
control facility.
Physical Features
The key physical components of the Q53 are:
•a 10/100 network interface connector to connect to the network
•2.4 GHz radio for connection to Zigbee PANs
•Flash memory to store firmware and user-configurable settings
•High-performance internal 32-bit microprocessor subsystem for speed, efficiency
and reliability
For more detailed specifications of the Q53, please see chapter xi, Q53 Specifications.
ii. Introduction to the Q53 ZigBee / 802.15.4 Gateway Bridge
How Does the Q53 Work?
How Does the Q53 Work?
The Q53 implements the Zigbee Bridge Device Specification as defined by the Zigbee
Alliance. This standard specifies a method for bridging Zigbee endpoints over TCP/IP
networks, such that remote PANs may be bridged together into a single virtual network
with high performance and low latency.
Product Features
The Q53 offers an extensive list of features including:
•internal radio circuitry supporting 2.4 GHz PANs
•simple and fast configuration of Zigbee, TCP/IP and bridge operating parameters
•built-in HTML forms for easy cross-platform configuration and status monitoring
with any web browser
•Gecko, a utility for automated TCP/IP configuration (included on the CD ROM
supplied with the Q53 or the latest version online at http://www.exegin.com/)
•A detailed and easy-to-use command line interface shell
•TCP/IP configuration through static settings or via DHCP
•configuration security through passwords
•remote management through telnet session and SNMP
Prepare to install the Q53 in a clean, well-ventilated environment protected from
extremes of temperature, humidity, mechanical shock, or vibration. Provide enough
space at the front and back of the unit for cable connections.
Depending upon the specific options selected at time of ordering, the Q53 may be
powered from a 115 or 230 VAC outlet using the supplied external transformer through
a output cord to a barrel-style power connector, or over the Ethernet cable (Power Over
Ethernet - POE) from an Ethernet switch providing power as defined in the IEEE
standard 802.11af. If using the external AC transformer, prepare to install the Q53 within
four meters (13 feet) of a grounded 115 or 230 VAC outlet.
The Q53 must be installed within RF range of the local Zigbee wireless PAN, in order to
connect to the PAN and therefore bridge it over the TCP/IP network to the remote PAN.
The maximum distance from the Q53 to the nearest Zigbee PAN node will vary
depending upon the installation environment and capabilities of the other Zigbee
node(s).
The Q53 is an intentional radiator of Radio Freq uency (RF) energy. In order to limit RF
exposure to personnel in the immediate area, the Q53 should be located and installed
such that a separation of at least 20 centimeters is maintained between the Q53’s antenna
and personnel in the vicinity of the device.
Note:ESD precautions should be used when attaching or removing the antenna.
Upon receiving the Q53, check the packaging for any damage or missing pieces.
Immediately report problems to the shipping company or vendor.
Table 1—Q53 Packing List
ZigBee / 802.15.4
Gateway Bridge
CD-ROM• Q53 Installation and Configuration Guide (PDF format)
•Q53
• Power Supply
• Software utilities for the Q53
Connecting the Q53 to a Network
There are two dipswitches on the rear surface (Figure 1) of the Q53. Table 2 on page 16
lists the different modes controlled by dipswitch 1 and 2. Ensure that dipswitch 1 and dipswitch 2 are set to the "off" position for normal operations. They are in the "off"
postion when shipped from the factory.
OFFOFFNormal operation. With both dipswitches in the "OFF" position, the unit
ONOFFFactory default settings. With the dipswitches in this configuration, the
OFFONDefault IP (0.0.0.0). With the dipswitches in this configuration, the unit will
ONONFactory bootloader mode. Do not use this mode except as directed by
Table 2—Q53 Dipswitch Settings
will boot up using the settings in Flash rather than the default settings.
Dipswitch 2 is in the "
OFF" position from the factory so that the new settings
that you store will be used.
unit will boot up and all settings stored in Flash will be erased except the
Ethernet address and key value.
boot with factory default settings, but the stored settings in Flash remain intact. This enables you to set an IP Address of your own. Setting dipswitch
2 to "
ON" will not clear any settings that you have stored in Flash. It simply
boots the unit in a different state with the settings in Flash temporarily
ignored.
Exegin technical support.
Use the RJ45 network connector, located on the side panel of the Q53 (see Figure 2), for
attaching to a 10/100Base-T (UTP) network. Plug a network cable into the network
connector. If installing a Q53 without the Power Over Ethernet (POE) option, insert the
three-prong power cable of the AC adapter into an AC outlet, and insert the barrel power
connectors into the POWER connector on the side panel of the Q53; this will power on
the device.
Two LED indicators are used to indicate Ethernet link integrity (see Figure 2). The green
LED at the bottom left of the UTP network connector will be illuminated when a 100
MB/S link is established over the network connection, or extinguished otherwise. The
red LED at the bottom right of the UTP network connector will be illuminated when a
10 MB/S link is established over the network connection, or extinguished otherwise.
Figure 3—Q53 Top View: LED Status Indicators
Watch the LED indicators on the top panel as they cycle through the power-on self-test.
When the test is complete, the STAT LED will flash once per second or, if there is no IP
address configured, twice per second (see Gecko on page 19 for instruction on how to
configure an IP address).
This chapter briefly describes some of the Q53 utilities provided to help you setup your
Q53 ZigBee / 802.15.4 Gateway Bridge:
•HTML forms on page 18
•Gecko on page 19
In addition, two TCP/IP commands that you will need are briefly described:
•Telnet on page 20
•Ping on page 20
Q53 Utilities
HTML forms
The Q53’s settings can be configured over TCP/IP using a standard Web browser. The
Q53’s Web pages provide a user-friendly way to access some of the commands built into
the Zigbee gateway bridge device.
To access the Q53’s home page, do the following:
1.Ensure that the ZigBee / 802.15.4 Gateway Bridge has an IP address and subnet
mask so that it is identifiable on your TCP/IP network.
2.Ensure that your network station can successfully "
network.
3.Direct your Web browser to the Uniform Resource Locator (URL):
http://Q53IPaddress
For example: http://192.168.11.9
4.When prompted for a User ID and Password, type in "root" for the ID and either
press ENTER at the password prompt or, if a password has been set, type the
password and then press ENTER.
The Q53’s HTML structure is divided into several menus as shown in Figure 4. More
detailed information about Q53 web pages is found in chapter vii, Using HTML Pages
Gecko is a Windows tool for discovering, monitoring, and configuring Exegin devices
on a TCP/IP network. The program is a Java stand alone program.
The Q53 can be configured on a TCP/IP network using Gecko. Two steps are involved:
1.Identify the Q53 on the network using TCP/IP as the underlying protocol
Gecko
Environment
Requirements
2.Configure the Q53 with its required TCP/IP settings (i.e. IP address and subnet
mask).
Additional settings like routing entries can also be configured allowing for
communications across subnets. Once Gecko is up and running, select Help Topics from
the help menu for more detailed information about Gecko.
The installation procedure for Gecko is described below; Using Gecko (Windows) on
page 24 describes how to use Gecko to configure your Q53.
Before installing Gecko, ensure that you have met the following system environment
requirements:
•the Java Runtime Environment™ (JRE) from Sun Microsystems. JRE consists of
the Java virtual machine, the java platform core classes, and supporting files. The
latest supported version of JRE is available at Exegin’s website:
http://www.exegin.com/.
•the TCP/IP protocol installed and configured on your workstation.
To install Gecko on a Windows workstation, you will need to:
1.Insert the Q53 CD ROM and bring up the CD directory listing in My Computer or
Windows Explorer
2.Double click on setupex.exe in the Gecko directory to run the InstallShield Wizard.
3.Answer the prompts throughout the Wizard.
Once the install process is complete, you will be prompted to view the ReadMe file.
Select "Yes" to read this and when done, close the file.
Note: The latest version of Gecko is available on Exegin’s website:
http://www.exegin.com/.
TCP/IP Commands
Telnet
Telnet can be used to access a remote computer on a network. To use this command, you
must know the IP address of the Q53 ZigBee / 802.15.4 Gateway Bridge. You can start
a Telnet session on a UNIX- or Windows-based computer which is connected to the
network, to log in to the Q53 command line interface shell to alter and view settings.
Syntax:
telnet ipaddress
Example:
telnet 192.168.11.9
This will bring up the Q53 login prompt. Enter "root" for the User ID and press either
ENTER at the password prompt or, if a password has been set, then type it in and press
ENTER.
Ping
You can use the "ping" command to check that an assigned IP address (for example, the
IP address for the Q53) is active.
Syntax:
ping IPaddress
For example:
ping 192.168.11.9
The response will indicate whether the IP address is active or not.
This chapter describes how to configure the required and optional TCP/IP settings for the
Q53 on your network. The following steps are covered:
•Required TCP/IP Settings:
•Configuring an initial IP address for the Q53 on page 21
•Configure the Q53 IP address and subnet mask on page 22
•Optional TCP/IP Settings:
•Communicating across routers on page 26
•Using Host and Domain Names on page 27
•Troubleshooting Tips on page 28.
Once the TCP/IP network port is configured on the Q53, additional configuration is
required to connect the Q53 to the local Zigbee Personal Area Network (PAN), and also
to bridge that local PAN to another remote PAN over TCP/IP. Please refer to Q53 Zigbee
PAN and Bridge Configuration on page 31 for details on Zigbee and bridge
configuration.
Required TCP/IP Settings
Configuring an initial IP address for the Q53
Since the Q53 has no physical user interface such as a display or keyboard, all operating
parameters must be configured by means of a TCP/IP network connection from a
separate computer. However, the Q53 must first be assigned an IP address in order to
function on a TCP/IP network. This raises the question of how to configure a Q53 when
it is first installed on the network fresh from the factory.
As delivered from the factory, the Q53 is configured to request an IP address from a
DHCP server when attached to a TCP/IP network. If a DHCP server exists on the
network, then the IP address assigned to the Q53 may be determined by querying the
DHCP server using its administration interface and locating the IP address of the desired
Q53 by matching its Ethernet MAC address. Please refer to the documentation for the
particular DHCP server used to determine how this may be done.
As an alternative, Exegin provides a utility program called Gecko which is capable of
locating any configured or unconfigured Q53 device attached to the TCP/IP subnet, and
assigning an initial IP address to it to facilitate subsequent configuration through a telnet
or HTTP connection. Please refer to Using Gecko (Windows) on page 24 for details on
how to do this.
Once the IP address has been created, you can configure the remaining TCP/IP
parameters of the Q53 ZigBee / 802.15.4 Gateway Bridge using one of the following:
•Q53 HTML forms, page 22
•the Q53 Gecko utility (Windows only), page 24
•the TCP/IP telnet command, page 25.
Using HTML
forms
1.Load the Q53 HTML forms as described in HTML forms on page 18, then select
"Network" from the Main Menu.
Or, go directly to the Network Configuration form by typing the following into your
browser:
2.If dynamic addressing is desired, then click on the radio button to the left of the
label Obtain an IP address automatically, then proceed directly to step 9 below;
this will cause the Q53 to request its TCP/IP parameters from a DHCP server over
the network.
To specify a static IP address, click on the radio button to the left of the label Use the following IP address: and proceed to step 3 below.
3.Enter the IP address in the IP Address field.
4.Enter the Q53’s subnet ma sk in the Subnet Mask field.
5.[Optional setting] In order to communicate across subnets with the Q53, enter the
address of the default gateway in the Default Gateway field.
6.[Optional setting] In order to use host and domain names in addition to dotted quad
IP addresses, enter the address of the domain name server in the DNS Server Address field.
7.[Optional setting] Enter the suffix of the domain name for the Q53 in the DNS Domain Suffix field.
8.[Optional setting] To change the TCP window size, select the desired value in the
TCP Window Size combo box.
9.Click on "Su bmit" when done.
10. Go to the Restart page and click on "Restart" to apply the new settings to your
system.
Ensure that you have installed Gecko on your Windows PC (see Installing Gecko in
Windows on page 20). To configure the Q53 with its required TCP/IP settings (i.e. IP
address and subnet mask), do the following:
1.Select Programs → Exegin → Gecko → Gecko in the Windows Start menu.
The Gecko main screen is displayed, as in Figure 6.
2.Click on "Search…" to open the Discover Devices dialog box.
3.Select "local" and click on "OK".
Or, click on "Add..." to find a device on another subnet.
The main dialog box will now build up a list of Exegin devices. This process may
take a minute or two to find the devices on the network.
4.Click on "Stop Searching" after the device has been found.
5.Select the Q53's ethernet address from the list box and press "Assign IP…".
6.In the Assign IP dialog box, fill in the IP address and subnet mask for this Q53.
You can also assign a default router/gateway entry in this dialog box to allow your
Q53 to communicate across subnets. Please see Communicating across routers on
page 26 for further details.
7.Click "Assign" when done to assign these TCP/IP settings to the Q53. Gecko will
then display its progress status in a separate dialog box.
After successfully assigning the settings you will see the Q53 with its new IP address in
the device list.
Using Telnet1. Start a Telnet session with the Q53. Type:
telnet Q53IPaddress
where Q53IPaddress is the IP address of the Q53 unit. This will bring up a login
prompt.
2. Enter "
root" for the User ID and press ENTER at the Password prompt, as by
default there is no password set.
The following WARNING message is normal at this point and may be ignored.
STORED AND CURRENT VALUES DIFFER
You should now see the prompt:
Q53IPaddress:root>
3. Store the new IP address and netmask in EEPROM so that the setting will remain
intact after restart. To do this, enter:
store net addr Q53IPaddress
store net mask Q53netmask
where:
Q53netmask is the netmask address for the Q53.
If you would like to communicate with the Q53 from across routers, you will need
to make an entry in the "Routing" section. See Communicating across routers on
page 26 for further details.
4. [Optional, but recommended] Configure root and guest user passwords with the
following commands:
An Important
Note
set user passwd root newRootPssswd
set user passwd guest newGuestPasswd
5. Save these configurations to EEPROM. Enter:
save
6. Verify the IP address and netmask. Enter:
list stored net
7. Log out of the telnet session with "quit" then restart the Q53 by powering the unit
off and then back on again.
8. Test the equipment and configuration after installation is complete.
ping Q53IPaddress
Once you have configured the unit using any of the above methods, the STAT LED will
flash once per second. This means the Q53 is configured and recognizable on the
network.
The ST AT LED will flash when the IP Address is configured; it does not mean that
the unit is properly configured, only that an IP address has been saved.
Since Windows and UNIX environments depend on TCP/IP to communicate with the
Q53, crossing routers can be an issue.
After following one of the Q53 configuration methods described above, you will only be
able to communicate with the Zigbee gateway bridge device from the same subnet. This
means that the Q53 will not be able to communicate across a router (i.e., to another
subnet).
To allow the Q53 to communicate across a router, it is best to store a default
router/gateway within the Zigbee gateway bridge device so that any packets destined for
another subnet are forwarded to this router automatically. The router (or series of routers)
can then ensure the packets arrive at their final destination on the other subnet.
You can configure a default router/gateway within the Q53 using either the Q53 HTML
forms or the TCP/IP telnet command.
Using HTML
forms
1. Follow the instructions for accessing the Network TCP/IP form (page 22).
2. Enter the address of the default gateway in the Default Gateway field.
3. Click on "Submit" when done.
4. Go to the Restart page and click on "Restart" to apply the new settings to your
system.
Using Telnet1. Telnet to the Zigbee gateway bridge device as described on page 25.
telnet Q53ipaddress
2. Enter "root" for the User ID and press ENTER at the Password prompt, as by
default there is no password set.
The following WARNING message is normal at this point and may be ignored.
STORED AND CURRENT VALUES DIFFER
You should now see the prompt:
Q53IPaddress:root>
3. Type "list net" to view the Zigbee gateway bridge device’ s current settings, then
configure the Q53’s default router/gateway as follows:
store net gateway routerIPaddress
4. Logout of the Telnet session with "quit". Then restart the Q53 by powering the
unit off and then on again.
Using Host and Domain Names
Using HTML
forms
The Q53 allows entry of most IP addresses either in ’dotted quad’ form or as a symbolic
host names. Host names have the advantage that they are easier to remember and are not
tied to a specific IP address.
The translation from host name to IP address is performed by a Domain Name Server
(DNS). In order to use host names, the IP address for the DNS server as well as the
domain name suffix must be specified at configuration time.
1. Follow the instructions for accessing the TCP/IP Settings form (page 22).
2. Enter the IP address of the Domain Name Server in the DNS Server Address field.
Note: this address must be entered in dotted quad format.
3. Enter the suffix of the domain name in the DNS Domain Suffix field.
4. Click on "Submit" when done.
5. Go to the Restart page and click on "Restart" to apply the new settings to your
system.
Using Telnet1. Telnet to the Zigbee gateway bridge device as described on page 25.
telnet Q53ipaddress
2. Enter "root" for the User ID and press ENTER at the Password prompt, as by
default there is no password set.
The following WARNING message is normal at this point and may be ignored.
STORED AND CURRENT VALUES DIFFER
You should now see the prompt:
Q53IPaddress:root>
3. Type "list net" to view the Zigbee gateway bridge device’ s current settings, then
configure the Q53’s Domain Name Server address and Domain Name Suffix as
follows:
store net dns dnsIPaddress
store net domain domainsuffix
4. Logout of the Telnet session with "quit". Then restart the Q53 by powering the
unit off and then on again.
Troubleshooting Tips
Gecko error messages: Q53 will not talk on the network
Unable to assign temporary IP. The address is already in use.
•Ensure that you have assigned an IP address that is not being use by another device.
Unable to assign temporary IP. The device is not responding. The network may be down,
or an invalid IP address has been used.
•Ensure that the IP address that you used is valid for your network.
Q53 will not talk on the network
•Have you assigned it a unique and valid IP address which corresponds with the
other IP addresses on your network? For example, are you sure no other device is
using this IP address, that the subnet mask is the same as other hosts on the
network, and that the unique IP address is part of the network specified by the
subnet mask specified?
•Are you sure you are trying to talk to the Q53 from a host on the same subnet? The
Zigbee gateway bridge device can only be seen locally unless you configured a
routing entry earlier on.
•Is the STAT LED on the front of the Q53 flashing once per second or is it flashing
faster? A slower, once-a-second rate indicates that the Zigbee gateway bridge
device is in fact configured with an IP address. A faster rate indicates that the Q53
is unaware of the IP address and you may need to try the configuration process
again.
•Have you confirmed the network connection to the Q53 is working correctly?
Trying different network cables and locations will help narrow down the problem.
Cannot ping the Q53
There are a number of possible reasons for this:
•Have you restarted the Q53? Sometimes this will solve various communication
problems.
•Is the network cable securely connected?
•Have you checked your network connection to the Q53? T ry it at a new lo cation o n
your network if possible or swap in another device.
•Have you made an entry in your computer’s host table (/etc/hosts, host nis map, or
DNS name table) for the Q53?
•Have you tried to ping with the IP address instead of the IP name? This will
eliminate any name-lookup issues and focus more on the communications between
the Q53 and your host.
•Is it possible that a duplicate IP address has been assigned?
•Did you use the correct netmask for your particular environment?
•Has the Q53 been moved from another network? If so, it will likely need to be
reconfigured to integrate with its new location. This includes at minimum a new IP
address and netmask. Please see Resetting to Factory Defaults on page 66 for
possible configuration methods.
•Is there a router between the Q53 and your host? If so, a default router or a static
route must be configured on the unit so the Q53 knows how to get i ts response b ack
to the originating host. Please see Communicating across routers on page 26.
•Do you have a DHCP or BOOTP server running on your network? By default, the
Q53 comes with the DHCP and BOOTP request turned on so although you may
have stored a particular network configuration in the unit’s EEPROM, a DHCP or
BOOTP server may supply new network parameters upon bootup. To turn off
DHCP and BOOTP on the unit, please see Configure the Q53 IP address and
subnet mask on page 22.
If none of these help, try the following:
•Reset the unit to default settings. Please see Resetting to Factory Defaults on page
66. Once the unit is in the default state, use one of the configuration options listed in
the "Q53 Configuration" above in the manual to reconfigure it.
Cannot Telnet to the Q53
If you are unable to ping the Q53 as well, please see Cannot ping the Q53 on page 29. If
it is telnet only that you are having problems with, these points should be considered:
•Are you able to telnet to another host on your network or telnet from another host?
If not, look into your host’s TELNET configuration.
This chapter describes how to configure the required and optional Zigbee Personal Area
Network (PAN) and bridge settings for the Q53. The following steps are covered:
•Required Zigbee Settings
•Selecting the RF Channels on page 31
•Optional Zigbee Settings
•Setting the PAN Filter on page 33
•Setting Extended Address Filters on page 33
•Required Bridging Settings
•Setting the remote bridge host name on page 34
•Optional Bridging Settings
•Setting additional remote bridge host names on page 35
•Troubleshooting Tips
Using HTML
forms
•Zigbee PAN on page 36
•Zigbee Bridge on page 37
Required Zigbee Settings
Selecting the RF Channels
As shipped from the factory the Q53 is configured to operate on channel 11 for the 2.4
GHz radio.
The Q53 must be configured to use the same radio channel(s) as the other nodes in the
local Zigbee PAN. This configuration may be performed using HTML forms.
1. Load the Q53 HTML forms as described in HTML forms on page 18, then select
"Zigbee" from the Main Menu.
Or, go directly to the Zigbee Configuration form by typing the following into your
browser:
http://Q53IPaddress/zigbeeConf.html
The Zigbee Settings configuration form is displayed (Figure 7).
2. Select the desired RF Channel for 2.4 GHz operation by clicking on the
down-arrow indicator of the combo box for the 2.4 GHz radio.
3. Click on "Submit" when done.
4. Go to the Restart page and click on "Restart" to apply the new settings to your
system.
Optional Zigbee Settings
Enabling Zigbee Coordinator functionality
By default, the Q53 acts only as a Zigbee Bridge Device (ZBD) to bridge Zigbee network
messages over TCP/IP. However, the Q53 is also capable of acting as Zigbee
Coordinator for the local Zigbee PAN.
1. Load the Q53 HTML forms as described in HTML forms on page 18, then select
"Zigbee" from the Main Menu.
Or, go directly to the Zigbee Configuration form by typing the following into your
browser:
http://Q53IPaddress/zigbeeConf.html
The Zigbee Settings configuration form is displayed (Figure 7).
2. If the Q53 should act as Zigbee PAN Coordinator for the wireless network, enter the
desired P AN ID and check the bo x labelled ’PAN Coordinator’; otherwise leave this
box un-checked.
3. Click on "Submit" when done.
4. Go to the Restart page and click on "Restart" to apply the new settings to your
system.
Setting the PAN Filter
By default, the Q53 will bridge all PAN ID’s encountered on the Zigbee network.
However, some installations may require filtering of PAN ID’s.
Using HTML
forms
1. Load the Q53 HTML forms as described in HTML forms on page 18, then select
"Zigbee" from the Main Menu.
Or, go directly to the Zigbee Configuration form by typing the following into your
browser:
http://Q53IPaddress/zigbeeConf.html
The Zigbee Settings configuration form is displayed (Figure 7).
2. Enter the desired P AN ID into the PAN ID Filter field. The P AN ID is expressed as
a four-digit hexadecimal value. To disable PAN ID Filtering (ie: to accept all PAN
ID’s), enter the value ’ffff ’ into this field.
3. Click on "Submit" when done.
4. Go to the Restart page and click on "Restart" to apply the new settings to your
system.
Setting Extended Address Filters
The Q53 may be optionally configured to respond to specific Zigbee MAC addresses.
These addresses are referred to as Extended Address Filters. A maximum of ten
Extended Address Filters may be configured.
1. Load the Q53 HTML forms as described in HTML forms on page 18, then select
"Zigbee" from the Main Menu.
Or, go directly to the Zigbee Configuration form by typing the following into your
browser:
http://Q53IPaddress/zigbeeConf.html
The Zigbee Settings configuration form is displayed (Figure 7).
2. Enter the desired Zigbee MAC addresses into the Extended Address Filter field.
Each address should be entered on its own line, separated by a carriage return from
the next. Each MAC address is expressed as a twelve-digit hexadecimal value.
3. To enable extended address filtering, ensure that the ’Extended Address Filter ’
checkbox is checked.
4. Click on "Submit" when done.
5. Go to the Restart page and click on "Restart" to apply the new settings to your
system.
Required Bridging Settings
Using HTML
forms
Setting the remote bridge host name
In order to successfully bridge a Zigbee PAN across TCP/IP, at least two Zigbee bridge
devices are required. The Q53 ZigBee / 802.15.4 Gateway Bridge which is currently
being configured requires at least one other Zigbee gateway bridge device available on
the TCP/IP network with which it may establish a bridge connection. This configuration
may be performed using HTML forms.
1. Load the Q53 HTML forms as described in HTML forms on page 18, then select
"Bridge" from the Main Menu.
Or, go directly to the Bridge Configuration form by typing the following into your
browser:
http://Q53IPaddress/bridgeConf.html
The Bridge Settings configuration form is displayed (Figure 8).
2. Enter the IP address of the remote zigbee bridge device into the Hostname 1 field.
The IP address may be entered in dotted quad form, or as a host name if the Domain
Name Server (DNS) parameters have been configured in the Q53. Please refer to
Optional TCP/IP Settings on page 26 for details on how to configure the DNS
settings.
3. Click on "Submit" when done.
Optional Bridging Settings
Setting additional remote bridge host names
While at least one remote Zigbee bridge device is required for successful bridging
operation, the Q53 can support up to four remote Zigbee bridge devices. These additional
bridge devices may be configured using HTML forms.
1. Load the Q53 HTML forms as described in HTML forms on page 18, then select
"Bridge" from the Main Menu.
Or, go directly to the Bridge Configuration form by typing the following into your
browser:
http://Q53IPaddress/bridgeConf.html
The Bridge Settings configuration form is displayed (Figure 8).
2. Enter the IP address of up to three additional remote zigbee bridge device into the
Hostname 2, Hostname 3 and Hostname 4 fields. Each IP address may be entered
in dotted quad form, or as a host name if the Domain Name Server (DNS)
parameters have been configured in the Q53. Please refer to Optional TCP/IP
Settings on page 26 for details on how to configure the DNS settings.
3. Click on "Submit" when done.
Troubleshooting Tips
Zigbee PAN
The Q53 can display a Zigbee Status HTML form wh ich may be very helpful in resolving
connection issues with the Zigbee PAN.
1. Load the Q53 HTML forms as described in HTML forms on page 18, then select
"Zigbee" from the Main Menu. The Zigbee Settings form will be displayed.
2. From the Zigbee Settings form, select "Status".
Or, go directly to the Zigbee Status form by typing the following into your browser:
•Is the IP address of the remote bridge device entered correctly?
•If the IP address of the remote bridge device(s) is(are) entered as host names as
opposed to a dotted-quad numeric values, have the Domain Name Server (DNS)
configuration settings been entered? Please refer to Optional TCP/IP Settings on
page 26 for details on how to configure the DNS settings.
•Are you able to ’ping’ the remote bridge device(s)?
This chapter describes the HTML pages provided with the Q53. The Zigbee gateway
bridge device settings can be configured and its status observed at any time, by calling
up these pages.
The following HTML pages are described here:
•Accessing the Q53 HTML Pages on page 39
•Password Protection on page 40
•Q53 Home Page on page 41
•Zigbee Forms
•Zigbee Settings Form on page 43
•Zigbee Status Page on page 44
•Bridge Forms
•Bridge Settings Form on page 45
•Bridge Status Page on page 46
•TCP/IP Forms
•TCP/IP Settings Form on page 47
•TCP/IP Status Page on page 48
•Administration Forms
•System Information Form on page 49
•Password Form on page 50
•SNTP Settings Form on page 51
•Firmware Upgrade Form on page 52
•Restart Page on page 54
•Help Page on page 55
Accessing the Q53 HTML Pages
To access the Q53’s HTML pages, do the following:
1. Ensure that the Zigbee gateway bridge device has an IP address and subnet mask so
that it is identifiable on your TCP/IP network.
2. Ensure that your network station can successfully "ping" the Q53 over the
network.
3. Direct your Web browser to the Uniform Resource Locator (URL):
http://Q53IPaddress
For example: http://192.168.11.9
4. When prompted for a User ID and Password, type in "root" for the ID and press
ENTER at the password prompt.
By default, no password is set. However, if a password has been configured, then
type it in and then press ENTER.
Each page can be accessed directly by directing your browser to the URL:
http://Q53IPaddress/filename.html
where "filename" is one of:
zigbeeConfZigbee Settings form
zigbeeStatusZigbee Status form
bridgeConfBridge Settings form
bridgeStatusBridge Status form
tcpipConfTCP/IP (network) Settings form
tcpipStatusTCP/IP (network) Status form
adminConfAdministration form
pswdConfSystem Password form
sntpConfSNTP Settings form
upgradeFirmware Upgrade form
restartSystem Restart page
helpHelp page.
Password Protection
Some of the Q53 configuration forms are password-protected. When first accessing these
forms, a password dialog will be displayed as shown in Figure 11.
Figure 11—Password Dialog for Access to Administration Forms
By default, the Q53 implements two user names: ’root’ and ’guest’. Individu al
passwords may be set for each user name. As shipped from the factory, the password for
both user names is blank. Passwords may be set for each user ID; please refer to
Password Form on page 50 for details on how this is done.
To access a password-protected form, enter the desired user name (’root’ or ’guest’) and
the associated password, then click the ’OK’ button at the bottom of the dialog.
Q53 Home Page
The Home page for the Q53 ZigBee / 802.15.4 Gateway Bridge p rovides a menu of pages
(see Figure 12) that facilitate viewing and changing the status and operating parameters
of the Q53. It also provides some basic system information for the Q53, and a link to the
Exegin web site.
The first three fields of this page, Hostname, Location and Contact, can be changed by
going to the Administration page. The other fields are information provided by the Q53
itself.
the Zigbee Settings form appears as shown in Figure 14.
Figure 14—Zigbee Settings Form
Radio
Channels
A combo box is provided to select the desired channel for the 2.4 GHz radio.
Default: Set to the channel 11
Zigbee
Coordinator
By default, the Q53 acts only as a Zigbee Bridge Device (ZBD) to bridge Zigbee network
messages over TCP/IP. However, the Q53 is also capable of acting as Zigbee
Coordinator for the local Zigbee PAN. A check box is provided to enable the Q53 to act
as Zigbee Coordinator for the local PAN. If this functionality is enabled, the local PAN
ID must also be set; the ’PAN ID’ field is provided for this purpose.
Default: Zigbee Coordinator functionality is disabled.
PAN ID FilterThe PAN ID Filter field configures the Q53 to bridge only Zigbee messages for a
To enable PAN ID filtering, enter the desired PAN ID into the PAN ID Filter field. The
P AN ID is expressed as a four -digit hexadecimal value. To disable PAN ID Filtering (ie:
to accept all PAN ID’s), enter the value ’ffff’ into this field.
Extended
Address Filter
Saving
Configuration
Changes
The Q53 may be optionally configured to respond to specific Zigbee MAC addresses.
These addresses are referred to as Extended Address Filters. A maximum of ten
Extended Address Filters may be configured.
To enable Extended Address filters, check the ’Extended Address Filter’ checkbox and
enter one or more Zigbee MAC addresses into the associated text box. To disable
Extended Address filters, un-check the ’Extended Address Filter’ checkbox.
Any changes on this page will be saved only when the ’Submit’ button is clicked. In
order for the new values to actually take effect, the Q53 must be re-started. To re-start
the Q53, please refer to Restart Page on page 54.
To erase all changes, click the ’Revert’ button.
Zigbee Status Page
The Zigbee Status page is shown in Figure 15. Use this page to troubleshoot
Zigbee-related problems. Network status indicators are recorded in this page; there are
no configuration settings. The page refreshes every minute. The Radio status, Zigbee
Network Neightbour table, and Zigbee Network Routing table are displayed.
The Bridge Settings form allows specification of up to four remote Zigbee bridge
devices. The Q53 will attempt to connect to all specified bridge devices to bridge Zigbee
messages to and from the local PAN.
Remote Zigbee bridge devices are specified by IP address. At least one device should be
specified in order to bridge Zigbee message over the TCP/IP network.
IP addresses may be specified in dotted quad format, for example:
172.16.16.1
Alternatively, host names may be used to specify the IP address of each bridge device.
The Q53 requires access to a Domain Name Server (DNS) in order for host names to
work. Please refer to DNS Server Address on page 48 for more details on configuring the
DNS server address.
Hostname 1At a minimum, the IP address one remote Zigbee bridge device should be entered into
the Hostname 1 field.
Default: Unconfigured (blank) IP address.
Hostname 2
Hostname 3
Hostname 4
The IP addresses of up to three additional Zigbee bridge devices may be specified, using
the Hostname 2 through Hostname 4 fields respectively.
Default: Unconfigured (blank) IP address.
Bridge Status Page
The Bridge Status page is shown in Figure 17. Use this page to troubleshoot
bridge-related problems. Only bridge status indicators are recorded in this page; there are
no configuration settings. The page refreshes every minute. The packet statistics are
displayed for each bridge connection.
The TCP/IP Settings form appears as is shown in Figure 18.
Figure 18—TCP/IP Settings Form
Static vs
Dynamic
Addressing
The Q53 may be set up to automatically request its TCP/IP parameters over the network
from a DHCP (Dynamic Host Configuration Protocol) server. To enable this feature,
click on the radio button labelled ’Obtain an IP address automatica lly’. When this feature
is enabled, the DHCP server will provide all TCP/IP configuration data; in this case,
none of the other fields on the TCP/IP Settings form need to be filled in.
If static addressing is desired, then click on the radio button labelled ’Use the following
IP address’. For static addressing, the IP address and Subnet mask are required to be
entered. All other parameters are optional, depending upon your installation
requirements.
Default: Unconfigured (blank) IP address and subnet mask; dynamic addressing
enabled.
If static addressing is used, and the Q53 will be required to communicate to a different
subnet, then the IP address of a default gateway is required in order to route traffic from
the Q53 to devices on remote subnets. You can leave this field blank if you are not
communicating across a router (from one network to another). In most other situations,
you simply enter your router's IP address in the Default Gateway field.
Default: Unconfigured (blank).
Enter the IP address of the local domain name service (DNS) host in this field. This
allows the Zigbee gateway bridge device to automatically resolve hostnames (e.g.
host.domain.com) to IP addresses (e.g. 192.168.0.42).
Default: Unconfigured (blank).
Enter the domain name suffix which will be appended to the host name of the Q53 to
form a complete fully-qualified host name. For example, if the fully-qualified host name
of a particular Q53 is host.domain.com, then the string ’host’ would be the device’s host
name and ’domain.com’ would be the DNS Domain Suffix.
Default: Unconfigured (blank).
To change the TCP window size, select the desired value in the TCP Window Size
combo box.
Default: 2 MSS packets.
TCP/IP Status Page
The TCP/IP Status page is shown in Figure 19. Use this page to troubleshoot
network-related problems. Network status indicators are recorded in this page; there are
no configuration settings. The page refreshes every minute. The TCP, UDP and DHCP
connection information is displayed.
Free format fields for user. A host namefor the Zigbee gateway bridge device, its location
and contact information for support can be entered in these fields and they will appear
on the Q53 home page.
Default: Unconfigured (blank).
Password Form
The Password administration form is shown in Figure 21.
All settings are protected by a password so that only authorized users can make
changes. When you try to open any configuration page, you will be asked for a
user name and password. At the prompt, you will need to enter root (unless you
have another user configured with root privileges) followed by the associated
password. If there is no password, leave the field blank and press ENTER.
Settings can only be altered by a user with root privileges; guest users can only view
settings. Both types of users can be assigned passwords. To change a password, type the
old password in the "Old" field. Then type the new password twice: once in the "New"
field and once in the "Confirm" field.
Default: Blank passwords for root and guest users.
SNTP Settings Form
the SNTP Settings Form (Figure 22) facilitates configuration of the Simple Network
Time Protocol (SNTP) client in the Q53. SNTP is used by the Q53 to synchronize its
local time-of-day clock with that of a central server.
The NTP Server field specifies the IP address of the NTP server from which the Q53 will
obtain time of day information. The IP address may be specified in dotted quad numeric
form. Alternatively, if a Domain Name Service (DNS) server have been configured, the
server’s host name may be entered. Please refer to Using Host and Domain Names on
page 27 for details on setting up the DNS server.
Default: Unconfigured (blank).
Poll IntervalThe Poll Interval combo box facilitates selection of the desired NTP polling interval. A
range of values between 1 and 17 minutes may be selected.
Default: 1024 Sec (17 minutes).
Firmware Upgrade Form
The Firmware Upgrade Form (Figure 23) facilitates uploading of new firmware to the
Q53.
The firmware upgrade procedure uploads a new firmware image from your workstation
into the flash memory of the Q53. This firmware image file must have been previously
obtained from Exegin technical support personnel or downloaded directly from Exegin’s
web site:
http://www.exegin.com/
Please refer to Contacting Exegin on page 80 for more details on how to contact Exegin
technical support.
File to UploadEnter the location of the new firmware file on your computer’s hard drive. The full path
to the file must be entered. Alternatively, clicking the the ’Browse...’ button will open a
file selection dialog (Figure 24) which will allow you to navigate your computer’s hard
drive and select the firmware file interactively.
Restart the Zigbee gateway bridge device with any new settings that have been
configured or changed in these forms.
DefaultRestart the Zigbee gateway bridge device with the factory default settings.
Help Page
Selecting "Help" from the main menu opens the Help information page (see Figure 26)
with all of the Help information available for these forms. This page can also be opened
at the appropriate location by clicking on the Help (question mark) icon at the top of each
HTML form or page.
This chapter describes some of the most common features of the Q53 including:
•Q53 Command Line Interface Shell on page 57: a description of the built-in
command line interface shell, along with a table of the most common commands
•Complete Command Reference on page 59: syntax and descriptions of all
commands available in the command line interface shell
•Q53 Naming Scheme on page 66: important predefined names
•User Accounts and Permissions on page 66: logging in as a "root" or "guest" user
•Resetting to Factory Defaults on page 66: how to reset the unit to factory default
settings
•Performing Firmware Upgrades on page 67: a complete overview of the Flash
upgrade procedure.
Q53 Command Line Interface Shell
Within the Q53, the command line interface shell is built into the firmware. It allows you
to manipulate objects such as snmp, sntp, and sysinfo and also provides some monitoring
and troubleshooting capabilities.
Command Line Interface access methods
Access the command line interface shell using these methods:
HTML FormsWhen you configure a setting using the built-in HTML
configuration forms, shell commands are actually
executed remotely on the Q53.
Telnet SessionOpening a Telnet session with the Q53 allows you to
log into the device and access the command line
interface shell. (e.g. "
The three main command prefixes within the command line interface shell are:
storechange settings stored in Flash. When the "store" prefix is used, the
setchange current/working settings in memory. When the "set" prefix is
listview current/working settings in memory.
Command shell prompt
When the command shell is accessed through a Telnet session, a prompt is displayed
after login to indicate that it is ready to accept a command from the user. The Telnet
prompt is formatted
and userid is the user ID of the currently logged-in user. For example,
Q53 must be restarted to apply the changes to the system. Since
store" affects Flash settings only, the Zigbee gateway bridge device
"
must reset and read the new settings now in Flash.
used, a "
settings are retained after power cycles. Since "
save" command must be executed as well so that the new
set" only affects the
settings in memory, they will be lost after a power cycle unless they are
saved into Flash ROM.
ipaddress:userid> where IPaddress is the IP address of the Q53
192.168.11.32:root>
where 192.168.11.32 is the Q53’s IP address and the user is root.
Getting command help
The Q53’s command line interface shell provides several on-line help tools. These
include:
"?" CommandTyping "
?" once logged in to the command line interface
shell will produce a full listing of all commands available.
Command PrefixesTyping in the beginning of a command will produce an
error message showing the correct syntax. For example,
typing in "
store tcpip" will produce a list of all
commands that start with this prefix.
Common command shell commands
The command line interface shell consists of more than 50 commands. Table 3 outlines
some of the more common commands. For a complete command reference, please refer
to Complete Command Reference on page 59.
list net
list sysinfo
save
reset
ping IPaddress
quit
Table 3—Common Commands
Command SyntaxDescription
Store the subnet mask for the Q53.
Store a default router/gateway for the Q53 to
forward remote packets to.
Enable or disable DHCP requests for IP
addresses.
List the current TCP/IP network settings.
List current system information for the Q53.
Save all current settings to Flash.
Reset the Q53.
"ping" another TCP/IP host on the network.
"Quit" out of the command line interface
shell.
Complete Command Reference
This section outlines the entire Q53 command set including the command syntax, a
description, and in most cases, an example for each command listed. These commands
are available in the command line interface shell. See Q53 Command Line Interface Shell
on page 57 for information on accessing these commands
These commands list the current or working settings for a particular section within the
command line interface shell. To view stored settings in Flash memory, you’ll need to
stored" to the beginning of any of the following commands. For example, "list
add "
" shows you the current network settings but "list stored net" shows you the
net
settings sitting in Flash. Normally these should match. You may also type "
default
list all
list diff
list date
list dhcp
list [default|stored] ifc
" to view the factory default settings.
Table 4—List Command Options
Command SyntaxDescription
List all current settings.
List the differences between the current
settings and the stored settings in Flash.
Normally, you want these values to match,
so issue a "
"
restart".
save" command followed by a
List the current time and date on the Q53.
Display the current status of the DHCP
client in the Q53. Data includes the client
state, server IP address, and the length of the
current lease.
Display the module’s physical network
interface properties. There is one interface
parameter (mode) which denotes the
operating mode of the network interface’s
physical layer:
list
list [default|stored] key
list [default|stored] net
mode auto - the Q53 will automatically
negotiate link speed and duplex with the link
peer.
mode 10half - the network interface is
forced to 10 MB/Sec, half duplex mode.
mode 10full - the network interface is
forced to 10 MB/Sec, full duplex mode.
mode 100half - the network interface is
forced to 100 MB/Sec, half duplex mode.
mode 100full - the network interface is
forced to 10 MB/Sec, full duplex mode.
List the license details and license key
number.
List all current TCP/IP network settings
(e.g. IP address and subnet mask).
list [default|stored] snmp
list [default|stored] sysinfo
list [default|stored] user
list uptime
list [default|stored] zbmac
list zbnwk
list zbnwktest
list zipt
Table 4—List Command Options
Command SyntaxDescription
Lists the version, model number, RF
channel and receiver state for each Zigbee
radio in the Q53.
List SNMP configuration.
List the current Q53 system information
(e.g. contact name and protocol stacks
enabled).
List the current user definitions (e.g. user
names and types).
List the time the unit has been powered up
since the last power cycle. (e.g. "Uptime: 12
days, 22:50:23").
List all current Zigbee settings (e.g. RF
channel selections, PAN ID filter and
Extended Address Filters).
Displays the current Zigbee network status,
including the MAC address, PAN ID,
Network Neighbour Table and Network
Routing Table.
Displays whether the Zigbee network test is
currently running, along with the test
results.
Displays the host names of the remote
Zigbee bridge devices, as well as the UDP
port number used to transport Zigbee
messages over the IP network.
Set commands
These commands alter the current or working settings in memory only. They will be lost
if the Q53 is turned off then on. To ensure this does not happen, be sure to issue a "
command so the current settings get written to Flash.
Set a person or department to contact in case
of Zigbee gateway bridge device trouble.
For example:
set sysinfo contact
HelpDeskx255
Set a descriptive name defined by newname
for the Q53 for identification purposes. This
is not used in the operation of the Zigbee
gateway bridge device in any way.
For example:
set sysinfo name
southwall_level2
Set all sysinfo settings back to factory
defaults.
Assign a password to a defined user on the
Q53. This password must be less than
eleven characters. The username must be
either root or guest. If the new password is
not entered, the user’s old password will be
cleared.
set user from default
set user from stored
For example:
set user passwd root mplex1
If you forget the root password, you can set
the dipswitchs to restore settings to factory
defaults. See Resetting to Factory Defaults
on page 66.
Set all user settings back to factory defaults.
Set all current user settings to the stored
These commands change the settings stored in Flash (permanent memory) and do not
affect the current or working settings in memory. A power cycle is needed before the
stored settings become current.
store ifc from default
store ifc from current
store ifc mode
[auto|10half|10full|100half|1
00full]
store net addr IPaddress
Table 6—Store Command Options
Command SyntaxDescription
Set all network settings back to factory
defaults.
Store all current network settings to Flash so
they are retained after a power cycle. This
ensures all current settings match what is
stored in Flash.
Set the line speed for the UTP Ethernet
interface.
Store a static IP address for the Q53.
store net dns domainName
store net domain domainName
store net from default
store net from current
store net gateway
routerIPaddress
For example:
store net addr 192.168.11.9
Store the IP address of the Domain Name
Server (DNS) for the Q53.
For example:
store net dns 192.168.1.254
Store the domain name suffix for the Q53.
For example:
store net domain
microplex.com
Set all TCP/IP network settings back to
factory defaults.
Store all current TCP/IP network settings to
Flash so they are retained after a power
cycle. This ensures all current settings
match what’s stored in Flash.
Store a default router/gateway defined by
routerIPaddress so the Q53 knows where to
direct packets destined for another subnet.
Enable or disable the automatic DHCP
requests for IP addresses upon bootup.
Prefix the ‘DHCP’ option with a dash (‘-’) to
disable the option; otherwise it is enabled.
For example:
store tcpip 1 opts -dhcp
Determine the receive window size for the
Q53. Usually the packets value ranges from
2-8 with the lower number allowing for
more simultaneous TCP connections with
the Zigbee gateway bridge device.
For example:
store net rxbuf 2
store zbnwk opts [-]edscan
Enable/disable power-up energy scan on the
Zigbee radios.
store zbmac freqband [[-]868]
[[-]915] [[-]2400]
store zipt port portnumber
Sets the freqency band for each Zigbee
radio.
Sets the UDP port number to be used for
bridging Zigbee traffic over the IP network.
The default port number is 17755.
Miscellaneous commands
These commands do not fall under any specific section of the command line interface
shell but they are used quite frequently.
Table 7—Miscellaneous Commands
Command SyntaxDescription
close <sd>|all
Close the network connection defined by the
socket descriptor. Socket descriptors can be
obtained using the
netstat command.
If the argument
all is entered, then all
active network connections will be
terminated, including the telnet session in
which the command was entered.
Load the settings stored in Flash and use
them as the current or working settings. If
default is specified as well, factory
settings will be loaded. Use this after power
failure to restore settings saved in Flash.
Display current network status, including
TCP packet statistics and the current state of
each TCP and UDP socket in the system.
"ping" another TCP/IP host, specified by
hostIPaddress, on the network. datasize is
the datagram packet size which defaults to
64 bytes if no size is included in the syntax
and packetnumber is the number of requests
to be sent.
To use a host or IP name instead of the
address, you must have set the DNS server
on the Q53. Use the command "
sysinfo dns...
" to do this.
set
quit
restart
save [default]
For example:
ping 192.168.11.30
Close the telnet command session.
Perform a warm boot or hardware reset
simulating a power-on reset. This will
restore current settings to those stored in
Flash as the Flash settings will be read and
loaded into memory upon bootup.
Save the current settings to Flash so they are
remembered after power cycles. Sysinfo,
snmp, user, and sntp settings will be saved.
If
default is specified as well, factory
settings will be saved to Flash overwriting
any new settings you have configured.
Resetting the unit is not required.
exgnxxxxxA default name of ‘exgn’ is followed by "xxxxx", the serial
User Accounts and Permissions
When you log into the Q53, you either log in as a guest or as a root user. The commands
you will be able to utilize on the print server depend on which login name you use. By
default, there is one root user and one guest user; users can then be added to this with
either permission level.
Users with root permission can execute all commands: users with guest permission can
not do any configuration and can only execute commands that display settings on the
Q53. However, they can use ping and telnet as well.
number found on the bottom of the Zigbee gateway bridge
device. For example: exgn00091
Use list [default|stored] user on page 61 to look at current user definitions. Use set user
passwd usernamepassword on page 62 to see how the root user can change these
settings.
Resetting to Factory Defaults
Sometimes it is beneficial to return the Q53 to its factory default state. For example, if
you are having problems communicating with the Zigbee gateway bridge device over the
network, you may want to put it back to a default state and reconfigure the network
settings.
To reset to factory defaults:
1. Move dipswitch 1 to the "off" position and dipswitch 2 to the "on" position as
described in Table 2, Q53 Dipswitch Settings, on page 16. This is the Factory
Settings mode
2. Restart the unit by cycling the power off, then on.
You now have the Q53 booted into a default state, meaning its current/working settings
are those stored at the factory. All settings configured and stored in Flash are ignored
while the dipswitches are in the "Factory Settings" position.
At this point, you can use shell commands on the Q53 to configure certain settings. Here
are some common examples of steps taken when the device is in a default state:
If you have forgotten a password set on the Q53, you can reset the user settings using
these commands:
2. Restore All Settings in Flash to Defaults
Since this default state is temporary and you may want to make sure all settings
sitting in Flash are back to their factory default values, you will need to use these
commands:
or set dipswitch 1=on and 2=off. See Table 2, Q53 Dipswitch Settings, on page 16.
3. Set dipswitches for normal operation.
Set dipswitch 1=off and 2=off. See Table 2, Q53 Dipswitch Settings, on page 16.
set user from default
save
save default
store tcpip from default
Performing Firmware Upgrades
Since the Q53’s firmware is stored in Flash ROM, upgrading is easy. Using a computer
with a web browser on a TCP/IP network, the Zigbee gateway bridge device can be
upgraded to a newer firmware version without needing new hardware. Please refer to
Firmware Upgrade Form on page 52 for step-by-step instructions on how to load new
firmware into the Q53.
Firmware File
The latest firmware file is always available at Exegin’s FTP site ("ftp.exegin.com")
and web site ("
Technical Support. Please see Help Methods Available on page 80 for further
information.
http://www.exegin.com/"), or it can be ordered through Exegin
•Q53 Security on page 68: how to use the Q53’s built-in security features as well as
taking advantage of your Network’s security features.
•Managing with SNMP on page 70.
General Options
Manipulating the Q53’s UTP Interface
You have some control over the UTP interface and its properties on the Q53.
By default, the UTP interface is set to automatically negotiate the communications speed
and duplex settings with its link peer. You can change this to force the Q53 to use a
specific speed and duplex setting.
To see the current UTP interface settings for the UTP network interface, please see list ifc in Table 4 on page 60. To manipulate the UTP interface, please see store ifc in Table
6 on page 63.
Remotely Managing the Q53
In a TCP/IP environment, various methods are available for remotely monitoring the
Print Server. These include using:
•the built-in HTML forms,
•a Telnet session,
•SNMP management.
Q53 Security
This touches upon the most popular built-in security feature - permission levels and
passwords. Setting passwords and assigning a permission level to users makes it difficult
for unauthorized users to gain access to the Q53’s command set and manipulate the
settings.
However, the Zigbee gateway bridge device also uses TCP access lists to restrict host
connections with the device and allows scrambling/descrambling of print jobs.
Users and Passwords
The Q53 supports two users:
rootAccess to everything within the Zigbee gateway bridge device including
all configurable settings.
guestAbility to list settings but not configure them.
For each user, a password can be set. However, you would normally only set a password
for the root user to protect the Q53’s configuration. Guest users cannot alter the Zigbee
gateway bridge device’s configuration in any way.
To configure the root password on your Q53, you will need to:
HTML Method1. Load a Web browser on a network station that can communicate with the Zigbee
gateway bridge device over TCP/IP.
Manual (Telnet)
Method
2. Direct your Web browser to URL "
http://192.168.11.9/pswdConf.html").
(e.g. "
Note:If prompted for a "User ID" and password first, type in "
http://Q53IPaddress/pswdConf.html"
root" for the ID and
press ENTER at the password prompt as there is no password by default.
3. Click within the "Old" field beside the "Root Password" heading and enter the
existing root password. By default, there is no root password; in this case, this step
can be skipped.
4. Within the "Root Password" section, click within the "New" field and enter the new
root password.
5. Within the "Root Password" section, click within the "Confirm" field and enter the
new root password again. Remember this the password is case sensitive.
6. Click on the "Submit" button when done.
7. Go to the Restart page and click on "Restart" to apply the new settings to your
system.
1. Start a Telnet session with the Q53. Type:
telnet Q53IPaddress
2. Login to the Q53 through a command line shell session as a root user.
Note:If prompted for a "User ID" and password first, type in "
root" for the ID and
press ENTER at the password prompt since there’s no password by default.
3. At the command shell prompt, follow this syntax:
set user passwd usernamepassword
For example, to set the root password to "mplex1" type:
From this point on, anytime you log in to the Q53 as "root", you will need to specify
this password or else your login attempt will fail.
Note:This process can be repeated to clear or change the password. An alternate
method to clear the password has the following syntax:
set user from default
save
SNMP Security
SNMP does not include any formal type of security definition. However, security can be
accomplished using communities. A community is a string that is sent with every SNMP
request and is used to define a certain view of the MIB. By doing this, you can control
what parts of the MIB are accessed by an SNMP manager.
To restrict write access, there is an additional security step, involving defining a user
named snmp on the Q53 with root privileges. The password defined for this snmp user
will then be used as the community string which allows write access.
Note:If no snmp user is defined with root privileges, no write requests will be
accepted by the Q53.
Managing with SNMP
SNMP (Simple Network Management Protocol) is a protocol for internetwork
management services. This protocol provides a means for computers (or agents) to be
managed remotely by managers. The level of management depends on the manager and
agent. The level of management ranges from providing information such as statistics to
providing full management capabilities.
MIB (Management Information Base) files are a description of managed objects
available in an agent. MIB files provide the data for the manager so they can remotely
manage the agent. A MIB file is simply a formal description of the way an agent can be
accessed using SNMP and what functions can be managed.
The Q53 is a fully manageable SNMP agent that supports MIB-II and traps.
This equipment has been tested and found to comply with the limits for a Class B digital
device, pursuant to part 15 of the FCC Rules. These limits are designed to provide
reasonable protection against harmful interference in a residential installation. This
equipment generates, uses and can radiate radio frequency energy and, if not installed
and used in accordance with the instructions, may cause harmful interference to radio
communications. However, there is no guarantee that interference will not occur in a
particular installation.
If this equipment does cause harmful interference to radio or television reception, which
can be determined by turning the equipment off and on, the user is encouraged to try to
correct the interference by one or more of the following measures:
•Reorient or relocate the receiving antenna.
•Increase the separation between the equipment and receiver.
•Connect the equipment into an outlet on a circuit different from that to which the
receiver is connected.
•Consult the dealer or an experienced radio/ TV technician for help.
Radio Frequency Notifications
FCC Notifications
RF RadiationThe Q53 is an intentional radiator of Radio Freq uency (RF) energy. In order to limit RF
exposure to personnel in the immediate area, the Q53 should be located and installed
such that a separation of at least 20 centimeters is maintained between the Q53’s antenna
and personnel in the vicinity of the device.
Modification
warning
Caution: changes or modifications to this equipment, not expressly approved by Exegin
Technologies Limited could void the user’s authority to operate the equipment.
Industry Canada Notifications
This Class B digital apparatus complies with Canadian ICES-003. Operation is subject
to the following two conditions: (1) this device may not cause interference, and (2) this
device must accept any interference, including interference that may cause undesired
operation of the device.
Cet appareil numérique de la classe B est conforme à la norme NMB-003 du Canada.
To reduce potential radio interference to other users, the antenna type and its gain should
be so chosen that the equivalent isotropically radiated power (e.i.r.p.) is not more than
that permitted for successful communication.
This device has been designed to operate with the antennas listed below, and having a
maximum gain of 3 dB. Antennas not included in this list or having a gain greater than
3 dB are strictly prohibited for use with this device. The required antenna impedance is
50 ohms.
•Antenna Factor Corp: Part no ANT-2.4-CW-RCL
CE Mark Conformity
Exegin Technologies Limited declares that this product conforms to the specifications
listed in this manual, following the provisions of the European R&TTE directive
1999/5/EC:
Exegin Technologies Limited vakuuttaa täten että dieses produkt tyyppinen laite on
direktiivin 1999/5/EY oleellisten vaatimusten ja sitä koskevien näiden direktiivien
muiden ehtojen mukainen.
Exegin Technologies Limited déclare que le produit est conforme aux conditions
essentielles et aux dispositions relatives à la directive 1999/5/EC.
•EN 301 489-1, 301 489-17 General EMC requirements for Radio equipment.
•EN 60950 Safety
•EN 300 328 Technical requirements for Radio equipment.
CAUTION—This equipment is intended to be used in all EU and EFTA countries.
Outdoor use may be restricted to certain frequencies and/or may r equire a license for
operation. Contact local Authority for procedure to follow.
Note:ESD precautions should be used when attaching or removing the antenna.
Note:Combinations of power levels and antennas resulting in a radiated power level of
above 100 mW equivalent isotropic radiated power (EIRP) are considered as not
compliant with the above mentioned directive and are not allowed for use within
the European community and countries that have adopted the European R&TTE
directive 1999/5/EC. For more details on legal combinations of power levels and
antennas, contact Exegin Technologies Limited
Do not use this product near water, for example, in a wet basement or near a swimming
pool.
Avoid using this product during an electrical storm. There may be a remote risk of
electric shock from lightning.
BelgiqueDans le cas d'une utilisation privée, à l'extérieur d'un bâtiment, au-dessus d'un espace
public, aucun enregistrement n'est nécessaire pour une distance de moins de 300m. Pour
une distance supérieure à 300m un enregistrement auprès de l'IBPT est requise. Pour une
utilisation publique à l'extérieur de bâtiments, une licence de l'IBPT est requise. Pour les
enregistrements et licences, veuillez contacter l'IBPT.
France2.4 GHz Bande : les canaux 10, 11, 12, 13 (2457, 2462, 2467, et 2472 MHz
respectivement) sont complétement libres d'utilisation en France (en utilisation
intérieur). Pour ce qui est des autres canaux, ils peuvent être soumis à autorisation selon
le départment. L'utilisation en extérieur est soumis à autorisation préalable et très
restreint. Vous pouvez contacter l'Autorité de Régulation des Télécommunications
(http://www.art-telecom.fr) pour de plus amples renseignements.
are in conformity with the provisions of the following EC Directives, including all
amendments, and with national legislation implementing these directives:
European Council Directive 1999/5/EC
and that the following harmonized standards have been applied:
RF: EN 300 328 v1.6.1
EMC: EN 301 489-01 v1.6.1, EN 301 489-17 v1.2.1
Electrical Safety: EN 60950-1:2001 +A11:2004
Full name and identification of the person empowered to sign on behalf of the
manufacturer:
STATSystem Status
NETData to Ethernet
RFData to Zigbee PAN
5.0
-5.0
-15.0
-25.0
-35.0
-45.0
Run and
auto-reset
mode
Run Mode is the normal operating state of the Q53. Auto-reset mode is entered when the
watchdog timer is triggered and the Zigbee gateway bridge device has reset itself. The
STAT LED flashes differently depending on whether the device’s IP address is
configured.
Table 8—STAT LED Patterns
FLASH RATEINDICATES
Green, on once per second
(i.e., more off than on)
Green, on twice per secondIP address not configured
Amber, off once per second
(i.e., more on than off)
Amber, off twice per secondDownload (MOS), no IP address configured
Red, off twice per secondSystem error
OnNetwork link present
OffNetwork link not present
Blinking, off 1/3 secondNetwork link present and transmitting; flashes off 1/3
second each time a packet is transmitted
Table 10—RF LED Patterns
FLASH RATEINDICATES
OnNetwork link present
OffNetwork link not present
Blinking, off 1/3 secondNetwork link present and transmitting; flashes off 1/3
second each time a packet is transmitted
Network Interfaces
The Q53 network interfaces provide compatibility with TCP/ICMP/IP and 802.3
Ethernet protocols with an IEEE 802.3 10/100Base-T UTP Ethernet female RJ45
connector.
Network Connector Pinouts
Table 11 shows the pinout for the UTP (RJ45) connector.
ARCEthernet Address Control Protocol
ARPAddress Resolution Protocol
DHCPDynamic Host Configuration Protocol
ICMP Internet Control Message Protocol
IPInternet Protocol
SNMP Simple Network Management Protocol
TCPTransmission Control Protocol
TELNETTelnet Protocol
UDP User Datagram Protocol
TCP port numbers used on the Q53
23TCP Protocol for TELNETD port
8200Exegin Communications Protocol Port for Gecko
UDP port numbers used on the Q53
161UDP port for SNMP
514SYSLOG client support
68DHCP client port
17755ZIPT Zigbee Bridge Device Protocol
Error conditions
Firmware
panic
Watchdog haltThe watchdog timer is a hardware device that resets the system if not serviced regularly
Spurious haltUnsupported interrupts force the Q53 into this non-operational mode and typically
Unrecoverable errors detected by the Q53 firmware force it into panic mode. Manually
reset the Q53 to resume normal operation.
by the CPU. It’s purpose is to prevent the CPU from entering an infinite loop because of
a hardware or firmware problem. After a watchdog interrupt, some diagnostic
information is saved for debugging and the device resumes operation in Auto-reset
Mode. The Q53 will auto-reset up to 16 times before entering non-operational Watchdog
Halt.
Internal errors such as bus errors, address errors or illegal instructions force the Q53 into
this non-operational mode.
xii. Getting Help
Help Methods Available
xii
GETTING HELP
This chapter identifies other sources of Help for installing and configuring your Q53
ZigBee / 802.15.4 Gateway Bridge and defines the repair procedure.
Help Methods Available
"T roubleshooting Tips" sections
Troubleshooting tips are listed at the end of each network configuration chapter. These
are the most commonly asked relevant questions. There are additional troubleshooting
tips in the appendices as well.
Web site
Exegin’s Web site, http://www.exegin.com/, contains information about the company
and its products. You will find a link to the Technical Support page that contains the
"Support Shack", a central location for technical bulletins and firmware and software
histories and files.
FTP site
Exegin’s FTP site, "ftp.exegin.com" contains firmware and software for the Q53. Once
logged in anonymously, you will need to change to the Q53 directory. Here, you will find
several subdirectories pointing to software, firmware, documentation, and miscellaneous
files.
Contacting Exegin
If you need technical assistance from Exegin, please have this information on hand:
•Q53 serial number found on the bottom of the Zigbee gateway bridge device.
•Description of your network environment and peripherals attached.
•Description of the problem.
Contact options
Email "support@exegin.com"
Fax to "Support" at +1 604 468-2445
Call +1 604 468-3639 and select Technical Support from the list of options (#3)
Note: Email queries will have the fastest response time.
Repair Procedure
Warranty description
Exegin Systems Ltd. warrants this product to be free from defects in workmanship and
material for one (1) year from the time of the original purchase date.
During this period, Exegin will repair or replace a defective product with a new or rebuilt
product at no extra charge except as stipulated below.
At no time shall Exegin’s liability exceed the replacement cost of the subject item.
All expressed and implied warranties for this product including all warranties of
Merchantability, Suitability, and Fitness for a particular application are limited to one (1)
year from the time of the original purchase date. In no event shall Exegin be liable for
Loss of Use, Loss of Profits or Revenues, or other Indirect, Incidental , or Consequential
Damages. This warranty does not imply the right to loaner or replacement un its d uring the time required to perform repairs.
This warranty does not cover any losses or damage caused by:
•shipping,
•improper installation, use, or maintenance,
•unauthorized repair, modification, alteration, or replacement of components,
•excessive environmental conditions including electrical power surges, temperature,
humidity, or any other irregularities,
•negligence or abuse.
Returning for repair
To obtain service under this warranty, you must first contact Exegin’s Technical Support
department to rule out configuration errors. A Support Technician will ensure the
problem is related to the hardware. If so, a Return Merchandise Authorization (RMA)
number will be given to you by the technician. The defective product should then be
returned to Exegin for repair.
Please use the following guidelines when shipping goods back for warranty claim:
•Package the product securely, in original packaging if possible, to prevent damage
during shipping.
•Indicate the RMA number clearly on the address label of the shipping carton.
PingA program used to test reachability of destinations by sending them
an ICMP echo request and waiting for a reply. It is a standard
command to test a TCP/IP connection. (e.g. "
192.168.11.9
")
ping
RAMRandom Access Memory. Volatile memory within the Q53 that
contains current/working settings. Settings are lost once the power
is removed.
RARPReverse Address Resolution Protocol. Allows a network device to
discover its IP address dynamically upon bootup. The IP address
does not need to be stored within the device permanently.
RFRadio Frequency. A radio signal that propagates through the
environment via electromagnetic radiation.
RouterA device that forwards IP packets to their destination. Also called a
gateway. See Default Router.
Serial numberNumber found on the bottom of the Q53. Each Q53 is assigned a
unique serial number.
SNMPSimple Network Management Protocol. A standard protocol used
to monitor network devices called "SNMP agents".
SocketTCP connection between two hosts consisting of a source and
destination TCP port number at each end.
Subnet maskA binary value used to divide IP networks into smaller
subnetworks or subnets. This mask is used to help determine
whether IP packets need to be forwarded on to other subnets.
TarUNIX command for archiving data onto a permanent storage
medium.
TCP/IPTransmission Control Protocol/Internet Protocol. Suite of
protocols that act as the base protocol for the Internet.
TCP portA logical connection point in the software of a TCP host or device.
When two IP devices talk, they establish a socket which consists of
a source and destination TCP port number on both ends.
TelnetCommand and protocol to establish a terminal connection between
two hosts on an IP network.
ZigbeeA set of electrical and protocol standards defining a means by
which low-cost control devices may communicate over low-power
wireless links within a building. Defined and maintained by the
Zigbee Alliance. More information may be obtained from the
Alliance’s web site: http://www.zigbee.org/
ZigbeeA set of electrical and protocol standards defining a means by
which low-cost control devices may communicate over low-power
wireless links within a building. Defined and maintained by the
Zigbee Alliance. More information may be obtained from the
Alliance’s web site: http://www.zigbee.org/