manualshive.com logo in svg

Digi XGI-20CZ7-E00-W0, User Manual

Share
Download
Digi XGI-20CZ7-E00-W0 User Manual Download Page 54

Program XBee Industrial Gateway using Python

XBee Industrial Gateway features a standard Python 2.7.1 distribution, allowing you to develop and
test applications that are not dependent on Digi-proprietary interface modules. Python is a dynamic,
object-oriented language for developing software applications, from simple programs to complex
embedded applications.

The standard Python 2.7.1 distribution has a more complete library set than the versions supported in
predecessor gateway products, and integrates well with standard Python. You can typically transfer
scripts developed in this manner to the device for final testing at the end of the development cycle,
with a computer serving as a device proxy during the bulk of development.

The following sections contain information about programming XBee Industrial Gateway with Python:

Find Python learning resources

55

Digi-specific Python modules for programming

55

Sample programs

55

XBee Industrial Gateway Python application and Remote Manager

58

Configuring a Python application in the web interface

83

Digi ESP for Python

83

DIA software

87

Linux command shell (command-line interface)

87

Digi XBee Industrial Gateway

54

Summary of Contents for XGI-20CZ7-E00-W0

Page 1: ...Digi XBee Industrial Gateway User Guide...

Page 2: ...kind expressed or implied including but not limited to the implied warranties of fitness or merchantability for a particular purpose Digi may make improvements and or changes in this manual or in the...

Page 3: ...13 Hardware interfaces 14 Configuration and management interfaces 14 XBee Industrial Gateway web interface 14 Remote Manager interface 14 RF Gateway and Python remote device management solutions 15 Pr...

Page 4: ...emote Manager 39 Back up and restore files from the XBee Industrial Gateway web interface 39 Update firmware 41 Update firmware from Remote Manager 41 Update firmware from the XBee Industrial Gateway...

Page 5: ...nnect and log in to the XBee Industrial Gateway device 87 Log in to XBee Industrial Gateway through the Digi ESP for Python command line interface 88 Configure XBee Industrial Gateway Configure settin...

Page 6: ...Configuration page 119 Time Configuration page 119 Configure XBee network settings Configure XBee Networks page in Remote Manager 121 Configure XBee network settings in the web interface 122 XBee Conf...

Page 7: ...n the Python log file for XBee Industrial Gateway 141 Troubleshoot your XBee Industrial Gateway XBee Industrial Gateway system log 146 XBee Industrial Gateway log files and contents 146 Displaying the...

Page 8: ...al Gateway Ethernet and Cellular GSM LTE models are available The XBee Industrial Gateway contains the XBee ZigBee product You can manage XBee Industrial Gateway products remotely via Digi Remote Mana...

Page 9: ...nt 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 and correct the interference by one or mor...

Page 10: ...dustrial Gateway user manual documentation and ensure the final product does not exceed the specified power ratings antenna specifications and or installation requirements as specified in the user man...

Page 11: ...low all safety items listed below n Never install electrical wiring during an electrical storm n Never install an Ethernet connection in wet locations unless that connector is specifically designed fo...

Page 12: ...eless devices transmit radio frequency energy and may affect medical electrical equipment Switch off wireless devices wherever requested to do so in hospitals clinics or health care facilities These r...

Page 13: ...ncies 6 3 mW 5 MHz channel spacing beginning at 2405 MHz and ending at 2480 MHz XBee Industrial Gateway Python application The XBee Industrial Gateway Python application resides on XBee Industrial Gat...

Page 14: ...nterface for configuring monitoring and administering Digi devices n Remote Manager interface A web based remote management interface XBee Industrial Gateway web interface The XBee Industrial Gateway...

Page 15: ...evice functionality or the functionality of the web services and other features However you will find instances of both Device Cloud and Digi Remote Manager in some documentation firmware and user int...

Page 16: ...X2e Wiki page for additional programming content for ConnectPort X2e products information on this Wiki also applies to XBee Industrial Gateway n DIA library documentation n Digi Remote Manager User Gu...

Page 17: ...thernet model l Ethernet model l Ethernet model hardware specifications n Cellular model l Cellular model l Cellular model hardware specifications n Antennas XBee Industrial Gateway antennas n XBee In...

Page 18: ...perating temperature 30 C to 70 C 22 F to 158 F Relative humidity 5 to 95 non condensing Storage and transport temperature 40 to 85 C 40 to 185 F Altitude 2000 meters 6560 feet Ethernet isolation 500...

Page 19: ...with a transmit power of 63 mW 18 dBm n The international product version uses the regular XBee RF module with a transmit power of 6 3 mW 8 dBm Receiver sensitivity 1 PER 102 dBm See the XBee XBee PRO...

Page 20: ...1 Power requirements See Power requirements 2 Ethernet features See Ethernet specifications 3 XBee antenna See XBee Industrial Gateway antennas 4 Cellular features See Cellular specifications 5 SIM c...

Page 21: ...EE 802 3 ANSI X3 263 Power requirements DC power input n Voltage input 5 VDC 5 n Power consumption Typical 3 5 W Max 11 W n Connector 2 5 mm x 5 7 mm center pin positive Dimensions Length 10 16 cm 4 i...

Page 22: ...B Flash available for Python applications XBee Industrial Gateway antennas The XBee Industrial Gateway device uses only external antennas Connecting antenna s to the device is required Note The XBee I...

Page 23: ...ption of how to control the LEDs on XBee Industrial Gateway See Troubleshooting LEDs for troubleshooting information LEDs for the Cellular model LEDs for the Ethernet model Signal strength LED cellula...

Page 24: ...erver to resolve the Remote Manager server address See Cannot connect to DNS server to resolve the Remote Manager server address 2 XBee Industrial Gateway cannot connect to an NTP time server to get t...

Page 25: ...the initial boot of the device All diagnosis related to this LED must be done after the device has been running for at least 60 seconds LED Color and blink pattern Description Solid green The XBee RF...

Page 26: ...ware Setting up the XBee Industrial Gateway Cellular hardware This section walks you through the steps required to set up your XBee Industrial Gateway Cellular hardware and provides additional referen...

Page 27: ...y Setting up the XBee Industrial Gateway Cellular hardware Digi XBee Industrial Gateway 27 Component Description Ethernet cable Power supply Required additional equipment Component Description A compu...

Page 28: ...nect the XBee antenna to the device 4 Connect the cellular antenna s to the device If your device has two cellular antenna locations you must connect an antenna to each location 5 Connect the power su...

Page 29: ...re This section walks you through the steps required to set up your XBee Industrial Gateway Ethernet hardware and provides additional reference information Verify your XBee Industrial Gateway Ethernet...

Page 30: ...roduct page Connect the hardware 1 Optional If using an Ethernet connection in addition to the cellular connect one end of the Ethernet cable to your gateway and the other to a live Ethernet jack 2 Co...

Page 31: ...twork when a DHCP server is available to assign an IP address to it and no firewalls block outgoing traffic to ports 3197 and 3199 If the Ethernet network does not come up see see Cannot connect to DN...

Page 32: ...three substeps a Configure XBee Industrial Gateway as a coordinator b Join XBee nodes to the coordinator c Verify that the XBee nodes are joined to the coordinator See Connect the XBee nodes to XBee I...

Page 33: ...oordinator For that reason each ZigBee network must have one coordinator XBee Industrial Gateway includes a built in XBee ZigBee node already configured as coordinator Therefore as soon as you power o...

Page 34: ...lt the PAN ID of this ZigBee module is configured to 0 Therefore if you power on the XBee ZigBee module and there is no other ZigBee network around the module joins the ZigBee network initialized by X...

Page 35: ...rk follow the steps described in Configuring XBee Industrial Gateway with a custom PAN ID Configuring XBee Industrial Gateway with a custom PAN ID In some cases you want control of the PAN ID used to...

Page 36: ...des connected to the network you must update their PAN IDs so they will join the new one XBee Industrial Gateway and non XBee ZigBee Devices You can refer to additional resources to learn about using...

Page 37: ...to XBee Industrial Gateway and display current information about loaded files You can also use this page to download system log files from XBee Industrial Gateway to view for troubleshooting or other...

Page 38: ...and display current information about loaded files For a description of the XBee Industrial Gateway file system layout see XBee Industrial Gateway file system Access the File Management page Follow th...

Page 39: ...figured and want to use the same configuration settings as the original device In this instance you can load the backup configuration settings from the original device onto other devices Back up and r...

Page 40: ...buttons appear on the Backup Restore page Volume Information section Displays information about the user file system userfs n Current Directory The backup file is temporarily saved in this directory o...

Page 41: ...tificate that is verified before XBee Industrial Gateway accepts an upgrade n XBee RF module on the gateway See Update the local XBee Industrial Gateway firmware n XBee RF modules on your local networ...

Page 42: ...ial Gateway module settings will be preserved when the firmware update completes Some settings such as encryption keys may not be preserved and must be entered again 8 If required type your encryption...

Page 43: ...ugh several states a The web browser uploads the firmware file b The firmware update is applied to the XBee Industrial Gateway operating system If the firmware update is successful the message Firmwar...

Page 44: ...he Firmware Updates option You can select the product and then download the firmware There is only one firmware file for the XBee RF module in XBee Industrial Gateway products It is named XBP24 S2C_40...

Page 45: ...mber stored or it may not be correct SIM IMSI The International Mobile Subscriber Identity IMSI for the SIM card This value is the account number for the mobile subscriber SIM ICCID The Integrated Cir...

Page 46: ...eived cellular signal measured in dB This value is also known as Ec Io Registration status The status of the cellular modem s connection to a cellular network n Not registered n Registered Home networ...

Page 47: ...lways use profile 0 Connection state The operating state of the cellular modem The possible states are as follows n Initializing Resetting and configuring the modem n Registering Searching for the mod...

Page 48: ...n or password entered on the Mobile Configuration page n Connection timeout Connection did not complete n Device reset error The modem could not be reset n Device open error The modem is malfunctionin...

Page 49: ...interval to test the cellular link and or keep it alive Not used by XBee Industrial Gateway cellular products Idle timeout The number of connection resets that occurred because the idle timeout reach...

Page 50: ...lay system information choose one of the following options From Remote Manager 1 Click the Device Management tab 2 From the device list double click the device to display the device properties menu 3...

Page 51: ...xy during the bulk of development For detailed information about programming with Python see Program XBee Industrial Gateway using Python The sections below describe the basic Python applications that...

Page 52: ...ormation on the XBee ZigBee Cloud Kit see the XBee ZigBee Cloud Kit support page Programming calls through Server Command Interface SCI and Remote Command Interface RCI You can use the Web Services Se...

Page 53: ...strial Gateway 53 Industrial Gateway system log Load applications onto XBee Industrial Gateway To load an application onto XBee Industrial Gateway use the File Management function in Remote Manager or...

Page 54: ...ucts and integrates well with standard Python You can typically transfer scripts developed in this manner to the device for final testing at the end of the development cycle with a computer serving as...

Page 55: ...opment Digi encourages an active developer community and welcomes your contributions Digi specific Python modules for programming Several Digi provided built in modules apply to functionality in XBee...

Page 56: ...he logic state of the value parameter A value of True turns on the LED and a value of False turns it off The led parameter indicates which user LED to blink with LED 1 being the default 2 Turn on the...

Page 57: ...h iteration allowing all of the loops to complete 7 Indicate that small loops are complete 8 Sleep for an interval much longer than the timeout 9 This print statement never executes because the system...

Page 58: ...th this script 3 This simple function will simply demonstrate that it received a request that could be parsed and handled however the application saw fit 4 Create a callback object 5 Assign the target...

Page 59: ...s of the network individually Similarly all the XBee modules can report data to Remote Manager and store the data there to be retrieved later Consumer applications such as web apps mobile apps and so...

Page 60: ...plication use the File Management function in Remote Manager or the XBee Industrial Gateway web interface to install the XBee Industrial Gateway Python application again Store status data for XBee lin...

Page 61: ...s and verify that the values are uploaded to Remote Manager To configure XBee node to report line and upload status 1 Ensure the XBee device you are going to configure is attached to an XBee Interface...

Page 62: ...ure I O Pin 1 AT setting D1 to Digital Input 3 and change the value of the DIO Change Detect IC setting to 0x2 These settings configure DIO1 as input Each time the value of DIO1 changes the XBee devic...

Page 63: ...are l xbee digitalIn l xbee analog l xbee serialIn n xbee_mac Is the MAC Address of the XBee node that reported the data in the following format XX XX XX XX XX XX XX XX n dio_number Is the name of the...

Page 64: ...mote Manager using the Web Services API to a specific XBee module or all XBee modules in the network that will be transmitted through its serial interface That serial packet can contain any data inclu...

Page 65: ...serial command definition The send_serial command sends serial data to a specific XBee node in your network To use this command add it to an SCI request inside the RCI do_command element Command synta...

Page 66: ...ssed cleanly through all systems and end to end It is only safe to use ASCII Specifying utf 8 is primarily useful for evaluation only o Default value base64 Command body value The command body contain...

Page 67: ...d encoded in base64 to the XBee node of our network corresponding to the MAC address 00 11 22 33 44 55 65 77 Note The request is using a dummy device ID and XBee MAC address You will need to use your...

Page 68: ...the SCI request fails you will receive an SCI reply containing the send_serial command response element that includes an error element indicating the cause of the error For example sci_reply version...

Page 69: ...m xctu to download and install XCTU To send a Hello World text to an XBee node on your network through Remote Manager 1 Attach the XBee node from your network to an XBIB device and connect it to your...

Page 70: ..._serial addr xbee_mac encoding base64 SGVsbG8sIFdvcmxkIQ send_serial do_command rci_request send_message sci_request Where n device_id is the ID of your XBee Industrial Gateway device xbee_mac is the...

Page 71: ...the send_serial command The XBee Industrial Gateway Python application stores serial data sent from the microcontroller to the XBee Industrial Gateway device and from the XBee Industrial Gateway devic...

Page 72: ...Guide By default the serial data is stored in Remote Manager and encoded in base64 format The reason behind this is that white spaces are not correctly handled by Remote Manager at the moment The XBee...

Page 73: ...d and your XBee node is added to the list select the node and click the Consoles working mode tab The Console log window appears and displays the XBee node s serial console 4 Connect the console 5 Dep...

Page 74: ...nt if the SOURCE is xbee digitalIn or xbee analog One of the streams displayed should correspond to the serial data of your XBee device For example 00000000 00000000 00409DFF FF5C388D xbee serialIn 00...

Page 75: ...request to Remote Manager The SCI command in turn contains a Remote Command Interface RCI do_command element with xbgw as target attribute and the set_digital_output command as content If you never w...

Page 76: ...nd 12 Indices 0 9 map to DIO values That is they set the Dx AT parameter where x is the index For example index 8 is equivalent to setting D8 index 12 is equivalent to setting P2 Indices 10 12 map to...

Page 77: ...9f 6f cb to high The command uses the attribute index to indicate the pin to be configured instead of the name one sci_request version 1 0 send_message targets device id 00000000 00000000 00409DFF FF...

Page 78: ...se element that includes an error element indicating the cause of the error For example sci_reply version 1 0 send_message device id 00000000 00000000 00409DFF FF5C4C66 rci_reply version 1 1 do_comman...

Page 79: ...modifying the value of the DIO4 of the XBee node because they are connected each other 2 From a web browser go to the Home page of your XBee Industrial Gateway web interface 3 Under Configuration clic...

Page 80: ...ice id device_id targets rci_request version 1 1 do_command target xbgw set_digital_output addr xbee_mac name DIO4 low set_ digital_output do_command rci_request send_message sci_request Where n devic...

Page 81: ...ormat The file has the following structure category 1 setting 1 value 1 setting 2 value 2 setting n value n category 2 setting 1 value 1 setting 2 value 2 setting n value n category n setting 1 value...

Page 82: ...ialized XBee Industrial Gateway Python application command errors When you use the Web Service API from Remote Manager to send the commands provided by the XBee Industrial Gateway Python application y...

Page 83: ...cation is running Note that you can stop a configured Python application immediately by clearing the Enable check box and clicking Apply 4 Click Apply to save your changes Digi ESP for Python Digi ESP...

Page 84: ...AC operating systems are supported this procedure shows how to install Digi ESP for Python on a Windows operating system If you are using a MAC operator system click the Digi ESP for Python MAC OS X 1...

Page 85: ...h displays Before the Workbench displays the Welcome page displays for just a moment and then displays along the right side of the Workbench screen Most of the time the Welcome page is minimized When...

Page 86: ...ppears b In the Welcome tab click the Overview icon The Overview page appears c On the overview page click Getting Started The Digi ESP for Python Getting Started Guide is displayed in the Help Digi E...

Page 87: ...ommand shell command line interface XBee Industrial Gateway has a Linux shell command line interface which allows you to experiment with the Python interpreter interactively create scripts launch scri...

Page 88: ...in to XBee Industrial Gateway through the Digi ESP for Python command line interface Within Digi ESP for Python there is a separate login on the Device Manager LAN Connection tab in Digi ESP for Pytho...

Page 89: ...Program XBee Industrial Gateway using Python Linux command shell command line interface Digi XBee Industrial Gateway 89...

Page 90: ...ore information XBee Industrial Gateway uses the following configurable settings to start up the XBee Industrial Gateway device and initiate communication Configure settings from Remote Manager 91 Con...

Page 91: ...r instructions See Remote Manager interface for more basic information about Remote Manager Basic configuration settings In Remote Manager you can access basic configuration settings for XBee Industri...

Page 92: ...the Wireless Access Point wizard you need the Digi Device Discovery Utility to rediscover the device and open its web interface 1 From a web browser go to the Product Support Download page and click...

Page 93: ...he menu allow you to configure settings for various features Some of the configuration settings are organized on sets of linked screens The options in this menu may vary based on product and supported...

Page 94: ...ing Ethernet Settings To configure Ethernet settings choose one of the following options From Remote Manager 1 Click the Device Management tab 2 From the device list double click the device to display...

Page 95: ...dress when an address is not available from other methods For example when the Digi device is configured for DHCP and a DHCP server is not currently available For more information on AutoIP see RFC 39...

Page 96: ...IP Configuration You can set the IP address for XBee Industrial Gateway either automatically using DHCP or by assigning a static IP address You must enable either the DCHP or the Static IP option n D...

Page 97: ...Configuration page n Digi Mobile SureLink settings n Mobile firewall settings Once the mobile settings have been configured you can monitor the status of mobile connections by going to Administration...

Page 98: ...emote Manager n For the web interface open a browser and go to the XBee Industrial Gateway web interface Click Configuration Mobile Connectivity See Configure settings from the XBee Industrial Gateway...

Page 99: ...s may be hidden depending on your model 4 Complete the fields and click Save to save your changes From the XBee Industrial Gateway web interface 1 From the XBee Industrial Gateway web interface click...

Page 100: ...PINs act like ATM PINs in that they require users to authenticate themselves as the true owner of the card before information is released Depending on mobile service provider this value may not be nec...

Page 101: ...rom the number specified in the Phone Number setting Messages from other phone numbers will be passed on to other SMS Services on the device n Reply to Sender Phone Number This is an advanced option t...

Page 102: ...n is established This value must be between 10 and 65535 The default is 240 Only the Ping TCP Connection Test and DNS Lookup Test options use this setting The Device Cloud Connection Test option does...

Page 103: ...tings at any time These changes go into effect at the start of the next test interval Ping Test Enables or disables the use of ping ICMP as a test to verify the integrity of the mobile connection The...

Page 104: ...est is successful if you can establish a connection to the configured Remote Manager server and if you can exchange keep alive messages with the server The test fails if you cannot establish a connect...

Page 105: ...he Device Management tab 2 From the device list double click the device to display the device properties menu 3 Select Advanced Settings Firewall settings 4 Complete the fields and click Save to save...

Page 106: ...lows l No action taken Continue device operation without doing anything about the program l Restart python program Restart the Python program l Reboot the device Reboot the device Configure Remote Man...

Page 107: ...Configuration Device Cloud client initiated connection The Device Cloud client initiated connection page appears a For Connection enable select the On option b Determine the Connection reconnect time...

Page 108: ...ther security measures Proxy server TCP port The port number forwards network connection attempts to the Remote Manager server Obtain these values from your Remote Manager server administrator Connect...

Page 109: ...before dropping the connection The default is enabled Device Cloud client initiated connection page You can use the settings on this page to enable Remote Manager and specify reconnect timeout setting...

Page 110: ...Manager expects to receive either Remote Manager protocol messages or keep alive packets from the Remote Manager registered device at this interval n Maximum consecutive missed keep alives After missi...

Page 111: ...tions Only change these settings when the defaults settings do not work properly n Use an HTTP proxy to connect to Remote Manager Web interface only Configures XBee Industrial Gateway to connect to Re...

Page 112: ...vertently leave the connection in place which could cost money on a cellular connection if Connectware or TCP keepalives are enabled and transferred needlessly between device and server n Enable proto...

Page 113: ...sables the ability to send TCP keep alive packets over the client initiated connection to the Remote Manager server and whether the device waits before dropping the connection The default is enabled C...

Page 114: ...shed You must specify a valid value between 10 and 65535 seconds The default is 240 Only the Ping TCP Connection Test and DNS Lookup Test options use this setting The Device Cloud Connection Test opti...

Page 115: ...st options n Ping Test n TCP Connection Test n DNS Lookup Test n Device Cloud Connection Test Link failure action The action to be performed when a link failure is detected n Reset modem Reset the cel...

Page 116: ...m the XBee Industrial Gateway web interface click Configuration SureLink 3 Determine the network priority By default the Ethernet option should be the first option on the list If it is not follow the...

Page 117: ...e fields See Ethernet SureLink settings for information about the fields Note When selecting the test type option see Link integrity test options and failover for information about how each option wor...

Page 118: ...e across reboots but the availability of an NTP server or servers is important to the long term health of the device In environments where the device cannot directly connect to the Internet you need t...

Page 119: ...ee Industrial Gateway uses to obtain current date and time For XBee Industrial Gateway Ethernet models you can specify up to four NTP server settings to be used as upstream servers in synchronizing ti...

Page 120: ...For XBee Industrial Gateway Ethernet models you can specify up to four NTP server settings to be used as upstream servers in synchronizing time The default settings for the four NTP server settings a...

Page 121: ...ation tab and selecting Remote Manager User Guide Configure XBee Networks page in Remote Manager You can use the XBee Networks page in Remote Manager to manage all the XBee nodes in your inventory The...

Page 122: ...fields under each of the following sections on the Device Details page See Device Details page for more information o Addressing Settings o Radio Settings o Network Settings o Serial Settings o Input...

Page 123: ...te For more information see XBee network OTA firmware updates OTA Firmware Update section This section displays the status of the OTA firmware updates that were configured on the OTA Firmware Update p...

Page 124: ...ilities supported by the node s XBee module Common parameters include the PAN ID firmware and hardware versions and the device type identifier For a detailed description of these parameters see the Xb...

Page 125: ...es a way to automatically schedule XBee Industrial Gateway firmware updates and manage firmware files OTA firmware update files are available for downloading from the Digi Support site Go to the firmw...

Page 126: ...latest firmware version When a node reports its firmware version and a newer version of firmware is available on the gateway schedule a firmware update without user action Use this option to automati...

Page 127: ...ation XBee Network OTA Firmware Update Status page on the web interface l Scheduled A firmware update is scheduled to be performed on this node l Updating A firmware update is currently running on thi...

Page 128: ...information XBee Industrial Gateway network Python log file When you connect XBee node devices with your XBee Industrial Gateway using the XBee Industrial Gateway Python application device data for y...

Page 129: ...arding NTP time server access By default XBee Industrial Gateway accesses an NTP time server to establish its date and time Access to an NTP server is required and there is a default server The first...

Page 130: ...esent any barriers to connectivity given the default behaviors listed above Considerations for each supported network type are in the following configuration settings topics If you have a network that...

Page 131: ...AN ID Join nodes to the coordinator Use XCTU to set PAN ID and encryption settings to match those on the coordinator XBee Industrial Gateway Next configure your ZigBee nodes to connect to XBee Industr...

Page 132: ...ide 7 Click the Write radio settings button to save the new security settings in the XBee module As soon as you save the new PAN ID in the XBee RF module the module tries to connect to the ZigBee netw...

Page 133: ...igBee network addressing parameters for XBee nodes This section describes how to configure the ZigBee network addressing parameters for your XBee nodes If you are unfamiliar with XBee networks see XBe...

Page 134: ...es User Guide n About programming provides several examples of I O configuration Understanding the process for configuring the serial I O The process for configuring the serial I O requires that you 1...

Page 135: ...tached hardware that is XBee pin 2 DOUT and pin 3 DIN Note that the CTS Flow Control D7 and RTS Flow Control D6 and any changes to them are also displayed on the I O Pin Settings page under DIO6 and D...

Page 136: ...g provides several examples of I O configuration Understanding the process for digital and analog I O The process for configuring digital or analog I O requires that you 1 Assess the device hardware c...

Page 137: ...e ZigBee Destination Endpoint The Python application running on XBee Industrial Gateway that interacts with XBee nodes assumes a Destination Endpoint of 0xe8 n ZigBee Cluster ID Cl Sets the ZigBee Clu...

Page 138: ...ted device uses Pin 19 AD1 DIO1 This digital input uses the pullup resistor and change detection sampling l Digital data output to the connected device uses Pin 18 AD2 DIO2 n Analog I O 1 analog input...

Page 139: ...ng l Disabled I O for this DIO is disabled l Analog Input Sets the DIO to analog input l Digital Input Sets the DIO to digital input l Digital Output Low Sets the DIO to digital output and outputs a l...

Page 140: ...ling Rate IR parameter sets the sampling rate in milliseconds Periodic sampling allows an XBee XBee PRO module to take an IO sample and transmit it to a remote device at a periodic rate If IR is set t...

Page 141: ...dules to Remote Manager enabling uploads of data to Remote Manager and receiving remote text and commands The XBee Industrial Gateway Python application is installed in your XBee Industrial Gateway de...

Page 142: ...or digital and analog I O In this log file excerpt n These lines show that the XBee Industrial Gateway Python application has started up successfully Aug 4 19 44 06 none local7 info pylog 2014 08 04 1...

Page 143: ...0 Aug 4 19 47 38 none local7 info pylog 2014 08 04 19 47 38 542 DEBUG xbgw xbee manager Processing IO sample from pin DIO12 Aug 4 19 47 38 none local7 info pylog 2014 08 04 19 47 38 554 DEBUG xbgw xbe...

Page 144: ...gw reporting device_cloud stream_id xbee digitalIn 00 13 A2 00 40 9F 6F CB DIO6 Aug 4 19 47 44 none local7 info pylog 2014 08 04 19 47 44 280 DEBUG xbgw reporting device_cloud data xbee digitalIn 00 1...

Page 145: ...Gateway View your device data Digi XBee Industrial Gateway 145 xbgw reporting device_cloud Upload contains 6 datapoints Aug 4 19 47 44 none local7 info pylog 2014 08 04 19 47 44 526 INFO xbgw reportin...

Page 146: ...igi for analysis by Technical Support and Engineers The event log cannot be turned off so that Digi receives an accurate view of all aspects of the operation of the device The Message Filters for Disp...

Page 147: ...structions explain how to navigate from the Remote Manager interface to the WEB logging directory on the XBee Industrial Gateway system to access the system logs 1 Click File Management under Administ...

Page 148: ...cement can drastically increase the signal strength of a cellular connection Often times moving the gateway closer to an exterior window or to another location within the facility can result in optimu...

Page 149: ...onnection errors are incrementing Ensure that the proper APN is entered by verifying the name entered under Configuration Mobile Connectivity and possibly verifying with the provider Also the provider...

Page 150: ...the computer and the Digi device Another option is to try another Ethernet cable n Ethernet LED Check the Ethernet Link LED Light Emitting Diode on the Digi device Is the light solid If not there is n...

Page 151: ...device to Digi for RMA Network LED is flashing yellow slower than once per second No Ethernet link Attach an Ethernet cable Network LED is flashing yellow faster than twice per second DHCP server not...

Page 152: ...order to verify the security certificate presented by the Remote Manager server The supported means to synchronize time in the device is via NTP See Cannot connect to NTP time server to get correct t...

Page 153: ...ctive to fix the DHCP server to provide the correct networking parameters to the device Otherwise you can manually set the device s network configuration To set the DNS server manually go to Ethernet...

Reviews:

No comments

Brands by name

Popular brands

Load more brands