Exegin Technologies Q53 ZIGBEE GATEWAY User Manual Q53 Installation and Configuration Guide
Exegin Technologies Limited ZIGBEE GATEWAY Q53 Installation and Configuration Guide
Users Manual
Exegin Q53 ZigBee / 802.15.4 Gateway Bridge Installation and Configuration Guide Version 0.6.4 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 Copyright © Exegin Technologies Limited, 2009 All rights reserved. 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 Technologies 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. Rev:0.6.4 Made in Canada. Exegin Technologies Limited 401 - 2071 Kingsway Avenue Port Coquitlam, B.C. V3C 6N2 http://www.exegin.com/ P/N 79-053-100 ii Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 Table of Contents ii List of Figures ................................................................................................................................ v Overview Of The Manual ............................................................................................................... 8 Contents of the Manual..................................................................................................................... 8 Documentation Conventions ............................................................................................................ 9 ii List of Tables ............................................................................................................................... 10 Introduction to the Q53 ZigBee / 802.15.4 Gateway Bridge ..................................................... 11 What is the Q53? ............................................................................................................................ 11 Physical Features ............................................................................................................................ 11 How Does the Q53 Work?.............................................................................................................. 12 Product Features ............................................................................................................................. 12 iii Installing the Q53......................................................................................................................... 13 Site Requirements........................................................................................................................... 13 Unpacking the Q53......................................................................................................................... 14 Connecting the Q53 to a Network .................................................................................................. 14 iv Configuration Tools .................................................................................................................... 18 Q53 Utilities ................................................................................................................................... 18 TCP/IP Commands ......................................................................................................................... 20 Configuring the Q53 on Your Network ...................................................................................... 21 Required TCP/IP Settings............................................................................................................... 21 Optional TCP/IP Settings ............................................................................................................... 26 Troubleshooting Tips...................................................................................................................... 28 vi Q53 Zigbee PAN and Bridge Configuration .............................................................................. 31 Required Zigbee Settings................................................................................................................ 31 Optional Zigbee Settings ................................................................................................................ 32 Required Bridging Settings ............................................................................................................ 34 Optional Bridging Settings ............................................................................................................. 35 Troubleshooting Tips...................................................................................................................... 36 vii Using HTML Pages to Configure the Q53 ................................................................................. 39 Accessing the Q53 HTML Pages ................................................................................................... 39 Q53 Home Page.............................................................................................................................. 41 Zigbee Forms.................................................................................................................................. 43 Bridge Forms .................................................................................................................................. 45 TCP/IP Forms ................................................................................................................................. 47 Administration Forms..................................................................................................................... 49 Help Page........................................................................................................................................ 55 viii Reference Information ................................................................................................................ 57 Q53 Command Line Interface Shell............................................................................................... 57 Complete Command Reference...................................................................................................... 59 iii Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 Q53 Naming Scheme...................................................................................................................... 66 User Accounts and Permissions ..................................................................................................... 66 Resetting to Factory Defaults ......................................................................................................... 66 Performing Firmware Upgrades ..................................................................................................... 67 ix Extra Features/Additional Information ...................................................................................... 68 General Options.............................................................................................................................. 68 Q53 Security ................................................................................................................................... 68 Managing with SNMP .................................................................................................................... 70 Q53 Regulatory information ....................................................................................................... 71 Radio Frequency Notifications....................................................................................................... 71 xi Q53 Specifications ...................................................................................................................... 75 Physical Features ............................................................................................................................ 75 Electrical Details............................................................................................................................. 76 Antenna Radiation Pattern.............................................................................................................. 76 Q53 LEDs ....................................................................................................................................... 77 Network Interfaces ......................................................................................................................... 78 Software Specifications .................................................................................................................. 79 xii Getting Help ................................................................................................................................. 80 Help Methods Available................................................................................................................. 80 Repair Procedure ............................................................................................................................ 81 xiii iv Glossary ....................................................................................................................................... 84 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 LIST OF FIGURES Figure 1: Figure 2: Figure 3: Figure 4: Figure 5: Figure 6: Figure 7: Figure 8: Figure 9: Figure 10: Figure 11: Figure 12: Figure 13: Figure 14: Figure 15: Figure 16: Figure 17: Figure 18: Figure 19: Figure 20: Figure 21: Figure 22: Figure 23: Figure 24: Figure 25: Figure 26: Figure 27: Figure 28: Figure 29: Figure 30: Q53 Bottom View .................................................................................................................... 15 Q53 Side View ......................................................................................................................... 16 Q53 Top View: LED Status Indicators .................................................................................... 17 Q53 HTML Menu Structure .................................................................................................... 19 TCP/IP Settings Form .............................................................................................................. 22 Gecko Main Screen.................................................................................................................. 24 Zigbee Settings Form ............................................................................................................... 32 Bridge Settings Form ............................................................................................................... 35 Zigbee Status Form .................................................................................................................. 37 Bridge Status Form .................................................................................................................. 38 Password Dialog for Access to Administration Forms............................................................ 41 Q53 HTML Menu Structure .................................................................................................... 42 Q53 Home Page ....................................................................................................................... 42 Zigbee Settings Form ............................................................................................................... 43 Zigbee Status Page ................................................................................................................... 44 Bridge Settings Form ............................................................................................................... 45 Bridge Status Page ................................................................................................................... 46 TCP/IP Settings Form .............................................................................................................. 47 TCP/IP Status Page .................................................................................................................. 49 System Information Form ........................................................................................................ 50 Password Form......................................................................................................................... 51 SNTP Settings Form ................................................................................................................ 52 Firmware Upgrade Form.......................................................................................................... 53 Firmware File Selection Dialog ............................................................................................... 54 Restart Page.............................................................................................................................. 55 Help Page ................................................................................................................................. 56 Q53 Declaration of Conformity ............................................................................................... 74 Power Socket............................................................................................................................ 76 Antenna Radiation Pattern ....................................................................................................... 77 Sample Commercial Invoice.................................................................................................... 83 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 1. Overview Of The Manual Contents of the Manual OVERVIEW OF THE MANUAL 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: http://www.exegin.com/ 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. 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. Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 1. Overview Of The Manual Documentation Conventions Documentation Conventions The document conventions used in this manual and the appendices are as follows: • The Courier font in boldface indicates commands that you type. $ping ftp.exegin.com • Regular Courier font indicates displayed results. ftp.exegin.com is alive • Example names, numbers, and commands are presented in bold. To create an IP address for the Q53 using the TCP/IP arp command, do the following... • Variable values are shown in italics. Italics may also be used to add emphasis. ping ipname ipname is alive Please enter the ipname at the prompt. Make sure you first contact... Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 LIST OF TABLES Table 1: Table 2: Table 3: Table 4: Table 5: Table 6: Table 7: Table 8: Table 9: Table 10: Table 11: 10 Q53 Packing List...................................................................................................................... 14 Q53 Dipswitch Settings ........................................................................................................... 16 Common Commands................................................................................................................ 58 List Command Options ............................................................................................................ 60 Set Command Options ............................................................................................................. 61 Store Command Options.......................................................................................................... 63 Miscellaneous Commands ....................................................................................................... 64 STAT LED Patterns ................................................................................................................. 77 NET LED Patterns ................................................................................................................... 78 RF LED Patterns ...................................................................................................................... 78 UTP (RJ45) Connector Pinout ................................................................................................. 78 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 ii. Introduction to the Q53 ZigBee / 802.15.4 Gateway Bridge What is the Q53? ii INTRODUCTION TO THE Q53 ZIGBEE / 802.15.4 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. 11 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 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: 12 • 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 • extensive built-in troubleshooting tools • built-in "telnet" and "ping" clients • simple flash memory upgrades over TCP/IP Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 iii. Installing the Q53 Site Requirements iii INSTALLING THE Q53 This chapter describes the following: • Site Requirements on page 13 • Unpacking the Q53 on page 14 • Connecting the Q53 to a Network on page 14 Site Requirements 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 Frequency (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. 13 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 iii. Installing the Q53 Unpacking the Q53 Unpacking the Q53 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 • Q53 CD-ROM • Q53 Installation and Configuration Guide (PDF format) • 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. 14 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 iii. Installing the Q53 Connecting the Q53 to a Network Figure 1—Q53 Bottom View 15 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 iii. Installing the Q53 Connecting the Q53 to a Network Table 2—Q53 Dipswitch Settings Dipswitch Comments OFF OFF Normal operation. With both dipswitches in the "OFF" position, the unit 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. ON OFF Factory default settings. With the dipswitches in this configuration, the unit will boot up and all settings stored in Flash will be erased except the Ethernet address and key value. OFF ON Default IP (0.0.0.0). With the dipswitches in this configuration, the unit will 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. ON ON Factory bootloader mode. Do not use this mode except as directed by 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. Figure 2—Q53 Side View 16 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 iii. Installing the Q53 Connecting the Q53 to a Network 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). 17 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 iv. Configuration Tools Q53 Utilities iv CONFIGURATION TOOLS 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 "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 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 to Configure the Q53. 18 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 iv. Configuration Tools Q53 Utilities Figure 4—Q53 HTML Menu Structure Home/Index Zigbee Bridge TCP/IP Admin. Help Settings Settings Settings System Status Status Status Passwords SNTP Upgrade Restart Gecko 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 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. Gecko Environment Requirements 19 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. Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 iv. Configuration Tools TCP/IP Commands Installing Gecko in Windows 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. 20 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 v. Configuring the Q53 on Your Network Required TCP/IP Settings CONFIGURING THE Q53 ON YOUR NETWORK 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. 21 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 v. Configuring the Q53 on Your Network Required TCP/IP Settings Configure the Q53 IP address and subnet mask 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: Using HTML forms • Q53 HTML forms, page 22 • the Q53 Gecko utility (Windows only), page 24 • the TCP/IP telnet command, page 25. 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: http://Q53IPaddress/tcpipConf.html The TCP/IP Settings form is displayed (Figure 5). Figure 5—TCP/IP Settings Form 22 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 v. Configuring the Q53 on Your Network Required TCP/IP Settings 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 mask 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 "Submit" when done. 10. Go to the Restart page and click on "Restart" to apply the new settings to your system. 23 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 v. Configuring the Q53 on Your Network Required TCP/IP Settings Using Gecko (Windows) 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. Figure 6—Gecko Main Screen 24 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 v. Configuring the Q53 on Your Network Required TCP/IP Settings Using Telnet 1. 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: 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 An Important Note 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 STAT 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. 25 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 v. Configuring the Q53 on Your Network Optional TCP/IP Settings Optional TCP/IP Settings Communicating across routers 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. 26 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 v. Configuring the Q53 on Your Network Optional TCP/IP Settings Using Telnet 1. 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 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. Using HTML forms 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. 27 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 v. Configuring the Q53 on Your Network Troubleshooting Tips Using Telnet 1. 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 28 • 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. Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 v. Configuring the Q53 on Your Network Troubleshooting Tips • 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? Try it at a new location on 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 its response back 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: • 29 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. Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 v. Configuring the Q53 on Your Network Troubleshooting Tips • Have you tried restarting the Q53? • Are the dipswitches in the "off" position? • Does the fourth octet of the Q53’s given IP address equal 0 or 255? Each of the four octets in the IP address should be between 1 and 254. HTML configuration forms will not display • Can you "ping" the Q53 from your Windows station? If not, please see Cannot ping the Q53 on page 29. • Have you used the correct URL for the Q53’s home page? It should be: http://Q53IPaddress For example: http://192.168.11.9 30 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vi. Q53 Zigbee PAN and Bridge Configuration Required Zigbee Settings vi Q53 ZIGBEE PAN AND BRIDGE 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 • • • 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 • • Selecting the RF Channels on page 31 Setting additional remote bridge host names on page 35 Troubleshooting Tips • 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. 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). 31 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vi. Q53 Zigbee PAN and Bridge Configuration Optional Zigbee Settings Figure 7—Zigbee Settings Form 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. 32 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vi. Q53 Zigbee PAN and Bridge Configuration Optional Zigbee Settings 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 PAN ID and check the box 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 PAN ID into the PAN ID Filter field. The PAN 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. 33 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vi. Q53 Zigbee PAN and Bridge Configuration Required Bridging Settings 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 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 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. 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). 34 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vi. Q53 Zigbee PAN and Bridge Configuration Optional Bridging Settings Figure 8—Bridge Settings Form 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. 35 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vi. Q53 Zigbee PAN and Bridge Configuration Troubleshooting Tips 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 which 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: http://Q53IPaddress/zigbeeStatus.html The Zigbee Status form is displayed (Figure 9). 36 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vi. Q53 Zigbee PAN and Bridge Configuration Troubleshooting Tips Figure 9—Zigbee Status Form Some things to check: • Do the selected radio channels match the channels in use by the local Zigbee PAN? • If PAN ID filtering is in use, does the PAN ID filter match the PAN ID used by the local Zigbee coordinator? • If Extended Address Filters are in use, do the Zigbee MAC addresses match those of the devices to be bridged? Zigbee Bridge The Zigbee Bridge Status form is helpful in determining the current state of the Zigbee bridge connection. 1. Load the Q53 HTML forms as described in HTML forms on page 18, then select "Bridge" from the Main Menu. The Bridge Settings form will be displayed. 2. From the Bridge Settings form, select "Status". Or, go directly to the Bridge Status form by typing the following into your browser: http://Q53IPaddress/bridgeStatus.html The Bridge Status form is displayed (Figure 10). 37 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vi. Q53 Zigbee PAN and Bridge Configuration Troubleshooting Tips Figure 10—Bridge Status Form Some things to check: 38 • 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)? Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Accessing the Q53 HTML Pages vii USING HTML PAGES TO CONFIGURE THE Q53 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. 39 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Accessing the Q53 HTML Pages 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: zigbeeConf Zigbee Settings form zigbeeStatus Zigbee Status form bridgeConf Bridge Settings form bridgeStatus Bridge Status form tcpipConf TCP/IP (network) Settings form tcpipStatus TCP/IP (network) Status form adminConf Administration form pswdConf System Password form sntpConf SNTP Settings form upgrade Firmware Upgrade form restart System Restart page help Help 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. 40 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Q53 Home Page Figure 11—Password Dialog for Access to Administration Forms By default, the Q53 implements two user names: ’root’ and ’guest’. Individual 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 provides 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. 41 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Q53 Home Page Figure 12—Q53 HTML Menu Structure Home/Index Zigbee Bridge TCP/IP Admin. Help Settings Settings Settings System Status Status Status Passwords SNTP Upgrade Restart System Information 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. Figure 13—Q53 Home Page 42 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Zigbee Forms Zigbee Forms Zigbee Settings Form 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 Filter 43 The PAN ID Filter field configures the Q53 to bridge only Zigbee messages for a specified PAN ID. Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Zigbee Forms To enable PAN ID filtering, enter the desired PAN ID into the PAN ID Filter field. The PAN 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 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. Saving Configuration Changes 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. Figure 15—Zigbee Status Page 44 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Bridge Forms Bridge Forms Bridge Settings Form The Bridge Settings form is shown in Figure 16. Figure 16—Bridge Settings Form 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. 45 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Bridge Forms Hostname 1 At 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. Figure 17—Bridge Status Page 46 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 TCP/IP Forms TCP/IP Forms TCP/IP Settings Form 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 automatically’. 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. 47 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 TCP/IP Forms Default Gateway 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). DNS Server Address 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). DNS Domain Suffix 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). TCP Window Size 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. 48 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Administration Forms Figure 19—TCP/IP Status Page Administration Forms Several forms are available for administering basic system settings, such as host name, passwords, and firmware upgrades. System Information Form The System Information form is shown in Figure 20. It facilitates administration of general device-related settings. 49 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Administration Forms Figure 20—System Information Form Hostname, Location, Contact 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. 50 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Administration Forms Figure 21—Password Form 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. 51 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Administration Forms Figure 22—SNTP Settings Form NTP 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 Interval The 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. 52 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Administration Forms Figure 23—Firmware Upgrade Form 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 Upload 53 Enter 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. Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Administration Forms Figure 24—Firmware File Selection Dialog Upgrade Once the file location has been specified, clicking the ’Upgrade’ button will cause the selected firmware file to be uploaded to the Q53. Restart Page The Restart page (Figure 25) allows you to restart the Zigbee gateway bridge device with one of two options. 54 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Help Page Figure 25—Restart Page Restart Restart the Zigbee gateway bridge device with any new settings that have been configured or changed in these forms. Default Restart 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. 55 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 vii. Using HTML Pages to Configure the Q53 Help Page Figure 26—Help Page 56 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 viii. Reference Information Q53 Command Line Interface Shell viii REFERENCE INFORMATION 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: 57 HTML Forms When you configure a setting using the built-in HTML configuration forms, shell commands are actually executed remotely on the Q53. Telnet Session Opening a Telnet session with the Q53 allows you to log into the device and access the command line interface shell. (e.g. "telnet 192.168.11.9") Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 viii. Reference Information Q53 Command Line Interface Shell Main command prefixes The three main command prefixes within the command line interface shell are: store change settings stored in Flash. When the "store" prefix is used, the 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. set change current/working settings in memory. When the "set" prefix is used, a "save" command must be executed as well so that the new settings are retained after power cycles. Since "set" only affects the settings in memory, they will be lost after a power cycle unless they are saved into Flash ROM. list view 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 ipaddress:userid> where IPaddress is the IP address of the Q53 and userid is the user ID of the currently logged-in user. For example, 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: "?" Command Typing "?" once logged in to the command line interface shell will produce a full listing of all commands available. Command Prefixes Typing 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. Table 3—Common Commands Command Syntax store net addr IPaddress 58 Description Store the IP address for the Q53. Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 viii. Reference Information Complete Command Reference Table 3—Common Commands Command Syntax Description store net mask netmask Store the subnet mask for the Q53. store net gateway routerIPaddress Store a default router/gateway for the Q53 to forward remote packets to. store net opts [[-]dhcp] Enable or disable DHCP requests for IP addresses. list net List the current TCP/IP network settings. list sysinfo List current system information for the Q53. save Save all current settings to Flash. reset Reset the Q53. ping IPaddress "ping" another TCP/IP host on the network. quit "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 59 • List commands on page 60 • Set commands on page 61 • Store commands on page 63 • Miscellaneous commands on page 64. Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 viii. Reference Information Complete Command Reference List 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 add "stored" to the beginning of any of the following commands. For example, "list net" shows you the current network settings but "list stored net" shows you the settings sitting in Flash. Normally these should match. You may also type "list default" to view the factory default settings. Table 4—List Command Options Command Syntax Description list all List all current settings. list diff List the differences between the current settings and the stored settings in Flash. Normally, you want these values to match, so issue a "save" command followed by a "restart". list date List the current time and date on the Q53. list dhcp 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. list [default|stored] ifc 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: 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. 60 list [default|stored] key List the license details and license key number. list [default|stored] net List all current TCP/IP network settings (e.g. IP address and subnet mask). Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 viii. Reference Information Complete Command Reference Table 4—List Command Options Command Syntax Description list [default|stored] radio Lists the version, model number, RF channel and receiver state for each Zigbee radio in the Q53. list [default|stored] snmp List SNMP configuration. list [default|stored] sysinfo List the current Q53 system information (e.g. contact name and protocol stacks enabled). list [default|stored] user List the current user definitions (e.g. user names and types). list uptime List the time the unit has been powered up since the last power cycle. (e.g. "Uptime: 12 days, 22:50:23"). list [default|stored] zbmac List all current Zigbee settings (e.g. RF channel selections, PAN ID filter and Extended Address Filters). list zbnwk Displays the current Zigbee network status, including the MAC address, PAN ID, Network Neighbour Table and Network Routing Table. list zbnwktest Displays whether the Zigbee network test is currently running, along with the test results. list zipt 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 "save" command so the current settings get written to Flash. Table 5—Set Command Options Command Syntax Description set sysinfo hostname hostname Set a hostname for use with DDNS. For example: set sysinfo hostname Q53Plan2 61 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 viii. Reference Information Complete Command Reference Table 5—Set Command Options Command Syntax set sysinfo contact contactname Description Set a person or department to contact in case of Zigbee gateway bridge device trouble. For example: set sysinfo contact HelpDeskx255 set sysinfo location newname 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 sysinfo from default Set all sysinfo settings back to factory defaults. set user passwd username password 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. 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. 62 set user from default Set all user settings back to factory defaults. set user from stored Set all current user settings to the stored values in Flash. Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 viii. Reference Information Complete Command Reference Store commands 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. Table 6—Store Command Options Command Syntax Description store ifc from default Set all network settings back to factory defaults. store ifc from current 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. store ifc mode Set the line speed for the UTP Ethernet [auto|10half|10full|100half|1 interface. 00full] store net addr IPaddress Store a static IP address for the Q53. For example: store net addr 192.168.11.9 store net dns domainName Store the IP address of the Domain Name Server (DNS) for the Q53. For example: store net dns 192.168.1.254 store net domain domainName Store the domain name suffix for the Q53. For example: store net domain microplex.com store net from default Set all TCP/IP network settings back to factory defaults. store net from current 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 net gateway routerIPaddress Store a default router/gateway defined by routerIPaddress so the Q53 knows where to direct packets destined for another subnet. For example: store net gateway 192.168.11.1 1 63 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 viii. Reference Information Complete Command Reference Table 6—Store Command Options Command Syntax store net mask netmask Description Store the subnet mask for the Q53. For example: store tcpip 1 mask 255.255.255.0 store net opts[[-]dhcp] 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 store net rxbuf packets 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] Sets the freqency band for each Zigbee radio. store zipt port portnumber 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 Syntax close|all Description 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. 64 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 viii. Reference Information Complete Command Reference Table 7—Miscellaneous Commands Command Syntax Description load [default] 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. netstat Display current network status, including TCP packet statistics and the current state of each TCP and UDP socket in the system. ping [-s] hostIPaddress [datasize [packetnumber]] "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 "set sysinfo dns..." to do this. For example: ping 192.168.11.30 65 quit Close the telnet command session. restart 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 [default] 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. Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 viii. Reference Information Q53 Naming Scheme Q53 Naming Scheme The Q53 always follows this naming scheme: exgnxxxxx A default name of ‘exgn’ is followed by "xxxxx", the serial number found on the bottom of the Zigbee gateway bridge device. For example: exgn00091 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. Use list [default|stored] user on page 61 to look at current user definitions. Use set user passwd username password 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: 66 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 viii. Reference Information Performing Firmware Upgrades 1. Forgotten Password If you have forgotten a password set on the Q53, you can reset the user settings using these commands: set user from default save 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: save default store tcpip from default 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. 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 ("http://www.exegin.com/"), or it can be ordered through Exegin Technical Support. Please see Help Methods Available on page 80 for further information. 67 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 ix. Extra Features/Additional Information General Options ix EXTRA FEATURES/ADDITIONAL INFORMATION This chapter provides information about additional features available with the Q53. • General Options on page 68: miscellaneous Zigbee gateway bridge device options • 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. 68 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 ix. Extra Features/Additional Information Q53 Security 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: root Access to everything within the Zigbee gateway bridge device including all configurable settings. guest Ability 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 Method 1. Load a Web browser on a network station that can communicate with the Zigbee gateway bridge device over TCP/IP. 2. Direct your Web browser to URL "http://Q53IPaddress/pswdConf.html" (e.g. "http://192.168.11.9/pswdConf.html"). Note: If prompted for a "User ID" and password first, type in "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. Manual (Telnet) Method 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 username password For example, to set the root password to "mplex1" type: 69 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 ix. Extra Features/Additional Information Managing with SNMP set user passwd root mplex1 save 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. 70 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 x. Q53 Regulatory information Radio Frequency Notifications Q53 REGULATORY INFORMATION FCC Part 15 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 Radiation The Q53 is an intentional radiator of Radio Frequency (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. 71 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 x. Q53 Regulatory information Radio Frequency Notifications Approved Antenna 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 require 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. 72 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 x. Q53 Regulatory information Radio Frequency Notifications Belgique Dans 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. France 2.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. 73 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 x. Q53 Regulatory information Radio Frequency Notifications Figure 27—Q53 Declaration of Conformity Declaration of Conformity We, Exegin Technologies Limited, Manufacturer / Importer, 204 – 2071 Kingsway Avenue, Port Coquitlam, BC, V3C 6N2, Canada hereby declare that under sole responsibility the following equipment: x Q51 ZigBee 802.15.4 Transceiver x Q52 ZigBee Bridge Device 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: Name Fred Fierling Signature 74 Title President Date Place 2007/08/31 Port Coquitlam Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 xi. Q53 Specifications Physical Features xi Q53 SPECIFICATIONS Hardware and software specifications are described in this chapter. Hardware specifications are covered in the following sections: • Physical Features on page 75 • Electrical Details on page 76 • Q53 LEDs on page 77 • Network Interfaces on page 78 Software Specifications are covered in the following sections: • Standards supported on page 79 • TCP port numbers used on the Q53 on page 79 • UDP port numbers used on the Q53 on page 79 • Error conditions on page 79 • Internal errors such as bus errors, address errors or illegal instructions force the Q53 into this non-operational mode. on page 79. Physical Features Dimensions Metric Width:65 mm Height: 23.5 mm Length: 111 mm Imperial Width: 2.55" Height: 1.925" Length: 4.4" Weight: 80g or 3 oz (Device); 175g or 6 oz (external transformer) Environmental details Operating: Storage: 0° C to 50° C -40° C to 85° C 95% maximum humidity, non-condensing. 75 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 xi. Q53 Specifications Electrical Details Electrical Details Power socket Figure 28 shows the power socket on the Q53 side panel. Figure 28—Power Socket –VC +VC Power supply options External transformer available in 120V/60Hz or 220-240V/50Hz. Power supply requirements Typical 120VAC +/- 10% 35mA, 60Hz 240VAC +/- 10% 18mA, 50/60Hz Maximum 120VAC +/- 10% 40mA, 60Hz 240VAC +/- 10% 20mA, 50/60Hz DC power requirements Voltage 4.5-6.0 VDC regulated Current, Typical 300 mA Current, Maximum 330 mA DC Power consumption Typical Maximum IEEE 802.3.af Power over Ethernet Class 1 device, 1.2W typical 1.8 W 2.0 W Antenna Radiation Pattern Figure 29 shows the radiation pattern of the standard antenna supplied with the Q53. 76 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 xi. Q53 Specifications Q53 LEDs Figure 29—Antenna Radiation Pattern 0.0 5.0 -10.0 -5.0 -20.0 -15.0 -30.0 -25.0 -40.0 -35.0 -50.0 -45.0 Azimuth Elevation Q53 LEDs STAT NET RF Run and auto-reset mode System Status Data to Ethernet Data to Zigbee PAN 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 RATE 77 INDICATES Green, on once per second (i.e., more off than on) Normal Mode, IP address configured Green, on twice per second IP address not configured Amber, off once per second (i.e., more on than off) Download (MOS) Amber, off twice per second Download (MOS), no IP address configured Red, off twice per second System error Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 xi. Q53 Specifications Network Interfaces Table 9—NET LED Patterns FLASH RATE INDICATES On Network link present Off Network link not present Blinking, off 1/3 second Network link present and transmitting; flashes off 1/3 second each time a packet is transmitted Table 10—RF LED Patterns FLASH RATE INDICATES On Network link present Off Network link not present Blinking, off 1/3 second Network 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. Table 11—UTP (RJ45) Connector Pinout Pin 78 Signal Source Pin Signal Source TX_D1+ Q53 BI-D3- Q53 TX_D1- Q53 RX_D2- Network RX_D2+ Network BI_D4+ Network BI-D3+ Q53 BI_D4- Network Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 xi. Q53 Specifications Software Specifications Software Specifications Standards supported ARC ARP DHCP ICMP IP SNMP TCP TELNET UDP Ethernet Address Control Protocol Address Resolution Protocol Dynamic Host Configuration Protocol Internet Control Message Protocol Internet Protocol Simple Network Management Protocol Transmission Control Protocol Telnet Protocol User Datagram Protocol TCP port numbers used on the Q53 23 8200 TCP Protocol for TELNETD port Exegin Communications Protocol Port for Gecko UDP port numbers used on the Q53 161 514 68 17755 UDP port for SNMP SYSLOG client support DHCP client port ZIPT Zigbee Bridge Device Protocol Error conditions Firmware panic Unrecoverable errors detected by the Q53 firmware force it into panic mode. Manually reset the Q53 to resume normal operation. Watchdog halt The watchdog timer is a hardware device that resets the system if not serviced regularly 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. Spurious halt Unsupported interrupts force the Q53 into this non-operational mode and typically indicate a hardware problem. Hardware exception Internal errors such as bus errors, address errors or illegal instructions force the Q53 into this non-operational mode. 79 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 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 "Troubleshooting 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 80 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 xii. Getting Help Repair Procedure 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 units during 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: 81 • 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. Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 xii. Getting Help Repair Procedure • Include a copy of the invoice/receipt. • You may use any courier company. However, we recommend using Federal Express due to its lower charges for customs. Note: Under a normal warranty repair, Exegin will only pay for the shipping charges to return the Q53 to you. If you ship from a country other than Canada, type (on any paper) a commercial invoice containing the following information: • your address • Exegin’s address (as "consignee") • country of origin of the product (i.e. Canada) • number of packages in the shipment • description of the product • quantity • total value of shipment (i.e. your total purchase price) • reason for return (e.g. warranty repair) • a declaration. Canada Customs requires that this invoice accompany the returned product. For an example, refer to Figure 30. Download a copy from the website: http://www.exegin.com/support/docs/ComInvoice.html 82 Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 xii. Getting Help Repair Procedure Figure 30—Sample Commercial Invoice COMMERCIAL INVOICE from Leslie Smith ABC Corporation 1234 Western Parkway Anycity, NC USA, 27511 DATE OF EXPORT: 22/02/96 AIR WAYBILL NO: 123-12341234 CONSIGNEE: Exegin Systems Ltd. 204 - 2071 Kingsway Avenue Port Coquitlam, B.C. V3C 6N2, Canada IMPORTER (if other than consignee) same as consignee COUNTRY OF ORIGIN: Canada # OF PKGS DESCRIPTION TOTAL QTY VALUE Ethernet Zigbee gateway bridge device 1 100.00 REASON FOR RETURN: warranty repair I declare all information contained in this invoice to be true and correct. 83 _______________ Leslie Smith SIGNATURE NAME 24/03/2002 DATE Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 xiii. Glossary xiii 84 GLOSSARY ARP Address Resolution Protocol. Associates a selected IP address with a network device’s Ethernet address. BPS Bits per second. Daemon A continuously running process that handles system-wide functions such as print spooling. Default router A network device that allows communication to and from external subnets by forwarding any IP packets accordingly. DHCP Dynamic Host Configuration Protocol. Allows a network device to discover its IP address dynamically upon bootup. DNS Domain Name Server. Host providing responses to queries for a given host name’s IP address. EEPROM Electronically-Erasable, Programmable Read-Only Memory. Preserves data after power is removed. Also known as Flash memory. Factory defaults Zigbee gateway bridge device settings shipped with the Q53. Flash Permanent memory in the EEPROM. Stores firmware code and configurable settings. Allows for upgrades without replacing hardware inside the Q53. FTP File Transfer Protocol. Used for transferring files from one TCP/IP host to another and used in the upgrade process. Gecko TCP/IP configuration utility provided with the Q53 ZigBee / 802.15.4 Gateway Bridge. HTML HyperText Markup Language. Format used for documents viewable on the World Wide Web. HTTP HyperText Transport Protocol. Protocol used for the delivery of web pages. IEEE Institute of Electrical and Electronics Engineers. Ifnum Interface Number. Represents the network interface. This will be "1" for an Ethernet network. MIB Management Information Base. A set of variables (a database) managed by an SNMP manager application. Netmask see subnet mask. PAN Personal Area Network. A wireless network made up of Zigbee wireless devices communicating under control of a Zigbee Coordinator device. PDF Portable Document Format. Encodes different types of documents enabling them to be read across multiple platforms. Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 xiii. Glossary 85 Ping A 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. "ping 192.168.11.9") RAM Random Access Memory. Volatile memory within the Q53 that contains current/working settings. Settings are lost once the power is removed. RARP Reverse 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. RF Radio Frequency. A radio signal that propagates through the environment via electromagnetic radiation. Router A device that forwards IP packets to their destination. Also called a gateway. See Default Router. Serial number Number found on the bottom of the Q53. Each Q53 is assigned a unique serial number. SNMP Simple Network Management Protocol. A standard protocol used to monitor network devices called "SNMP agents". Socket TCP connection between two hosts consisting of a source and destination TCP port number at each end. Subnet mask A 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. Tar UNIX command for archiving data onto a permanent storage medium. TCP/IP Transmission Control Protocol/Internet Protocol. Suite of protocols that act as the base protocol for the Internet. TCP port A 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. Telnet Command and protocol to establish a terminal connection between two hosts on an IP network. Zigbee A 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/ Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009 xiii. Glossary Zigbee 86 A 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/ Q53 Installation and Configuration Guide © Exegin Technologies Limited, 2009
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.4 Linearized : No Page Mode : UseNone XMP Toolkit : 3.1-702 Producer : Acrobat Distiller 7.0.5 (Windows) Creator Tool : FrameMaker 7.0 Modify Date : 2009:08:20 16:08:24-07:00 Create Date : 2009:08:20 14:08:44Z Metadata Date : 2009:08:20 16:08:24-07:00 Format : application/pdf Title : Q53 Installation and Configuration Guide Creator : Exegin Description : Q53 Installation and Configuration Guide Document ID : uuid:120ce3ac-8520-4703-8d47-a939734699de Instance ID : uuid:fa028ef6-527b-465b-bd92-376fdc891a30 Page Count : 84 Subject : Q53 Installation and Configuration Guide Author : ExeginEXIF Metadata provided by EXIF.tools