Exegin Technologies Q52 ZIGBEE BRIDGE DEVICE User Manual Q52
Exegin Technologies Limited ZIGBEE BRIDGE DEVICE Q52
UserManual.wiki
>
Exegin Technologies
>
Q52 User Manual
USERS MANUAL
Navigation menu
Upload a User Manual
Namespaces
Wiki Guide
HTML
PDF
Info
Views
User Manual
Discussion / Help
Navigation
![22 Q52 Installation and Configuration Guide © Exegin Technologies Limited, 20075. Configuring the Q52 on Your NetworkRequired TCP/IP Settings2. 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 Q52 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 Q52’s subnet mask in the Subnet Mask field.5. [Optional setting] In order to communicate across subnets with the Q52, 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 Q52 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 Reboot page and click on "Reboot" to apply the new settings to your system.](https://usermanual.wiki/Exegin-Technologies/Q52/User-Guide-816270-Page-21.png)
![24 Q52 Installation and Configuration Guide © Exegin Technologies Limited, 20075. Configuring the Q52 on Your NetworkRequired TCP/IP SettingsUsing Telnet 1. Start a Telnet session with the Q52. Type:telnet Q52IPaddresswhere Q52IPaddress is the IP address of the Q52 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 DIFFERYou should now see the prompt:Q52IPaddress:root>3. Store the new IP address and netmask in EEPROM so that the setting will remain intact after reboot. To do this, enter:store net addr Q52IPaddressstore net mask Q52netmaskwhere: Q52netmask is the netmask address for the Q52.If you would like to communicate with the Q52 from across routers, you will need to make an entry in the "Routing" section. See Communicating across routers on page 25 for further details. 4. [Optional, but recommended] Configure root and guest user passwords with the following commands:set user passwd root newRootPssswdset user passwd guest newGuestPasswd5. Save these configurations to EEPROM. Enter:save6. Verify the IP address and netmask. Enter:list stored net7. Log out of the telnet session with "quit" then reboot the Q52 by powering the unit off and then back on again. 8. Test the equipment and configuration after installation is complete.ping Q52IPaddressAn 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 Q52 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.](https://usermanual.wiki/Exegin-Technologies/Q52/User-Guide-816270-Page-23.png)
![59 Q52 Installation and Configuration Guide © Exegin Technologies Limited, 20078. Reference InformationComplete Command ReferenceComplete Command ReferenceThis section outlines the entire Q52 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 Q52 Command Line Interface Shell on page 57 for information on accessing these commands•List commands on page 60•Set commands on page 61•Store commands on page 63•Miscellaneous commands on page 64.store net mask netmask Store the subnet mask for the Q52.store net gateway routerIPaddress Store a default router/gateway for the Q52 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 Q52.save Save all current settings to Flash.reset Reset the Q52.ping IPaddress "ping" another TCP/IP host on the network.quit "Quit" out of the command line interface shell.Table 3—Common CommandsCommand Syntax Description](https://usermanual.wiki/Exegin-Technologies/Q52/User-Guide-816270-Page-58.png)
![60 Q52 Installation and Configuration Guide © Exegin Technologies Limited, 20078. Reference InformationComplete Command ReferenceList commandsThese 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 OptionsCommand Syntax Descriptionlist 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 Q52.list dhcp Display the current status of the DHCP client in the Q52. 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 Q52 will automatically negotiate link speed and duplex with the link peer.mode 10half - the network interface is forced to 10 MB/Sec, half duplex mode.mode 10full - the network interface is forced to 10 MB/Sec, full duplex mode.mode 100half - the network interface is forced to 100 MB/Sec, half duplex mode.mode 100full - the network interface is forced to 10 MB/Sec, full duplex mode.list [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).](https://usermanual.wiki/Exegin-Technologies/Q52/User-Guide-816270-Page-59.png)
![61 Q52 Installation and Configuration Guide © Exegin Technologies Limited, 20078. Reference InformationComplete Command ReferenceSet commandsThese commands alter the current or working settings in memory only. They will be lost if the Q52 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.list [default|stored] radio Lists the version, model number, RF channel and receiver state for each Zigbee radio in the Q52.list [default|stored] snmp List SNMP configuration.list [default|stored] sysinfo List the current Q52 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.Table 5—Set Command OptionsCommand Syntax Descriptionset sysinfo contact contactname Set a person or department to contact in case of Zigbee bridge device trouble. For example:set sysinfo contact Christopher_OwenTable 4—List Command OptionsCommand Syntax Description](https://usermanual.wiki/Exegin-Technologies/Q52/User-Guide-816270-Page-60.png)
![63 Q52 Installation and Configuration Guide © Exegin Technologies Limited, 20078. Reference InformationComplete Command ReferenceStore commandsThese 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 OptionsCommand Syntax Descriptionstore 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 [auto|10half|10full|100half|100full]Set the line speed for the UTP Ethernet interface.store net addr IPaddress Store a static IP address for the Q52.For example:store net addr 192.168.11.9store net dns domainName Store the IP address of the Domain Name Server (DNS) for the Q52.For example:store net dns 192.168.1.254store net domain domainName Store the domain name suffix for the Q52.For example:store net domain microplex.comstore 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 Q52 knows where to direct packets destined for another subnet.For example:store net gateway 192.168.11.1 1](https://usermanual.wiki/Exegin-Technologies/Q52/User-Guide-816270-Page-62.png)
![64 Q52 Installation and Configuration Guide © Exegin Technologies Limited, 20078. Reference InformationComplete Command ReferenceMiscellaneous commandsThese commands do not fall under any specific section of the command line interface shell but they are used quite frequently. store net mask netmask Store the subnet mask for the Q52.For example:store tcpip 1 mask 255.255.255.0store 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 -dhcpstore net rxbuf packets Determine the receive window size for the Q52. Usually the packets value ranges from 2-8 with the lower number allowing for more simultaneous TCP connections with the Zigbee bridge device.For example:store net rxbuf 2store 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.Table 7—Miscellaneous CommandsCommand Syntax Descriptionclose <sd>|all Close the network connection defined by the socket descriptor. Socket descriptors can be obtained using the netstat command.If the argument all is entered, then all active network connections will be terminated, including the telnet session in which the command was entered.Table 6—Store Command OptionsCommand Syntax Description](https://usermanual.wiki/Exegin-Technologies/Q52/User-Guide-816270-Page-63.png)
![65 Q52 Installation and Configuration Guide © Exegin Technologies Limited, 20078. Reference InformationComplete Command Referenceload [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 Q52. Use the command "set sysinfo dns..." to do this.For example:ping 192.168.11.30quit 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, destination, model, logpath, variable, user, and I/O port 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.Table 7—Miscellaneous CommandsCommand Syntax Description](https://usermanual.wiki/Exegin-Technologies/Q52/User-Guide-816270-Page-64.png)
![66 Q52 Installation and Configuration Guide © Exegin Technologies Limited, 20078. Reference InformationQ52 Naming SchemeQ52 Naming SchemeThe Q52 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 bridge device. For example: exgn00091 User Accounts and PermissionsWhen you log into the Q52, 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 Q52. 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 DefaultsSometimes it is beneficial to return the Q52 to its factory default state. For example, if you are having problems communicating with the Zigbee 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, Q52 Dipswitch Settings, on page 15. This is the Factory Settings mode2. Reboot the unit by cycling the power off, then on. You now have the Q52 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 Q52 to configure certain settings. Here are some common examples of steps taken when the device is in a default state:](https://usermanual.wiki/Exegin-Technologies/Q52/User-Guide-816270-Page-65.png)
![72 Q52 Installation and Configuration Guide © Exegin Technologies Limited, 20079. Extra Features/Additional InformationManaging with SNMPCustom MIB TrapsA trap is an event generated by an agent to indicate a significant event to the manager. By default, the Q52 will generate three traps:coldstart A generic trap generated every time the Q52 is powered on or resetauthenticationFailure A generic trap generated whenever a disallowed access is attemptedlpqIOStatusChanged The only custom trap. This trap is generated whenever the I/O port’s status changes.Compiling and Monitoring the Custom MIBFor read-only SNMP functionality, please follow the steps below:1. Copy the Q52 MIB definition file (Q52mib.txt) from the CD ROM supplied with the Q52. This file can also be downloaded from the Microplex FTP site (ftp.exegin.com) or can be accessed via the Microplex Web site (http://www.exegin.com/).2. Compile this MIB description file to work with your SNMP manager.3. Using your SNMP manager, view the particular MIB variables that you wish to monitor.Notes: If you are using SunNet Manager, you will need to download a special MIB file (Q52mib.txt.SNM) from the Exegin FTP site. This file can also be accessed via the Exegin Web site.If you are using Castle Rock Computing’s SNMPc package, you will need to rename the MIB variable UInteger32 to another name such as U32.Writing to the Custom MIBThe following example explains how to use the custom MIB variables to set the Q52’s parameters. For example, to turn on bb mode and onlcr on the Q52’s prn port, please follow the steps below: Note: This example assumes that the snmp password has been defined as custommib, that the Q52’s ipname is spike, and that the SNMP manager is the Tricklets package.Issue the following configuration commands using the snmp user’s password as the community string. echo "m307IfPrnbbM[1.2]=2" | snmp-set spike custommibecho "m307IfOnlcr[1.2]=2" | snmp-set spike custommib](https://usermanual.wiki/Exegin-Technologies/Q52/User-Guide-816270-Page-71.png)
![73 Q52 Installation and Configuration Guide © Exegin Technologies Limited, 20079. Extra Features/Additional InformationManaging with SNMPConfiguring the Q52 to Send Traps to an SNMP ManagerThe Q52 continuously generates traps but unless the trap table is filled in, no SNMP manager will receive this information. To set the Q52 to send traps to a particular SNMP manager, please follow the steps below:Note: This example assumes that the snmp password has been defined as custommib, that the Q52’s ipname is spike, and that the SNMP manager is the Tricklets package.1. Set up an snmp user with root privileges on the Q52. Please see Compiling and Monitoring the Custom MIB on page 72 for details.2. Set the following Q52 trap variables using your SNMP manager. The actual syntax of the commands will depend on the particular SNMP manager you are using.echo "trapCommunity[1]=\"building-A\"" | snmp-set spike custmmibwhere building-A is the string that you want the Q52 to send with the trap information. This community string has a 14 character maximum.echo "trapDest[1]=192.168.11.11" | snmp-set spike custommibwhere 192.168.11.11 is the IP address of your SNMP manager.Note: To disable the entry in the trap table, set the IP address to 0.0.0.0The Q52 will now send trap information with the community string building-A to the SNMP manager with the IP address 192.168.11.11. For more information on these trap variables, please see their description in the custom MIB definition file.Note: The trap table can hold up to ten entries but only the first entry is stored in Flash memory. If you turn the unit off, you will lose the additional entries.](https://usermanual.wiki/Exegin-Technologies/Q52/User-Guide-816270-Page-72.png)
