Digi XBee User manual

XBee® Gateway
User Guide

Revision history—90001399-13
Revision Date Description
C June 2017 nRebranded the graphics.
nAdded Digi ESPfor Python installation instructions.
nModified regulatory and certification information as required by RED
(Radio Equipment Directive).
D July 2017 Updated the Certificate Management section to specify that this feature is
available only for Wi-Fi devices.
E September
2017
Reorganized and edited the document.
F January
2020
Added information about the unique password for the web interface.
G February
2020
Added link to data sheet specifications.
Trademarks and copyright
Digi, Digi International, and the Digi logo are trademarks or registered trademarks in the United
States and other countries worldwide. All other trademarks mentioned in this document are the
property of their respective owners.
© 2020 Digi International Inc. All rights reserved.
Disclaimers
Information in this document is subject to change without notice and does not represent a
commitment on the part of Digi International. Digi provides this document “as is,” without warranty of
any 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 product(s) and/or the program(s) described in this manual at any time.
Warranty
To view product warranty information, go to the following website:
www.digi.com/howtobuy/terms
Send comments
Documentation feedback: To provide feedback on this document, send your comments to
[e-mail].
XBee Gateway User Guide 2

Customer support
Digi Technical Support: Digi offers multiple technical support plans and service packages to help our
customers get the most out of their Digi product. For information on Technical Support plans and
pricing, contact us at +1 952.912.3444 or visit us at www.digi.com/support.
XBee Gateway User Guide 3

Contents
About Digi XBee Gateway
Regulatory information and certifications 10
RF exposure statement 10
FCC certifications and regulatory information (USA only) 10
Declaration of Conformity (DoC) 11
CE mark (Europe) 11
Industry Canada (IC) certifications 12
Korea Communications Commission (KCC) certifications 12
Safety statements 12
Warnings for Use of Wireless Devices 13
International EMC (Electromagnetic Emissions/Immunity/Safety) standards 14
Maximum power and frequency bands 14
XBee Gateway: Cellular 15
XBee Gateway: Ethernet 15
XBee Gateway: Wi-Fi 15
XBee Gateway Python application 15
XBee ZigBee Cloud Kit 15
Hardware interfaces 16
Configuration and management interfaces 16
XBee Gateway web interface 16
Remote Manager interface 16
RFGateway and Python remote device management solutions 17
Programming interface applications 17
Product differences from predecessor ConnectPort® X products 18
Where to find more information 19
Get started
Set up the XBee Gateway Cellular hardware 20
Verify your components 20
Connect the cellular hardware 22
Connect XBee Gateway to the network 23
Set up the XBee Gateway Wi-Fi hardware 23
Verify your components 24
Connect the Wi-Fi hardware 25
Connect XBee Gateway to the network 26
Set up your XBee Gateway
Set up XBee Gateway summary 28
XBee Gateway User Guide 4

XBee Gateway User Guide 5
Joining ZigBee networks 29
Join XBee Gateway to an existing ZigBee network 30
Configure XBee Gateway with a custom PAN ID 31
XBee Gateway and non-XBee ZigBee Devices 32
Administration and maintenance tasks
Logging in to the web interface 33
File management 33
File Management page in Remote Manager 33
File Management page in the XBee Gateway web interface 34
Certificate Management 35
Certificate Management page in the web interface 35
Back up or restore the configuration 36
Back up and restore files from Remote Manager 36
Back up and restore files from the XBee Gateway web interface 37
Update firmware 38
Update firmware from Remote Manager 38
Update firmware from the XBee Gateway web interface 40
About firmware files 41
Mobile device status 41
Display the mobile device status 42
Mobile Status page 42
Change the password for the web interface 50
Display the XBee Gateway End User License Agreement (EULA) 52
Restore XBee Gateway factory defaults 53
Reboot XBee Gateway 53
Display system information 53
Disconnect XBee Gateway from Remote Manager 53
About programming
Python 54
XBee ZigBee Cloud Kit web application source code 55
Programming calls through Server Command Interface (SCI) and Remote Command Interface
(RCI) 55
XBee Gateway file system 55
Important directories 55
Load applications onto XBee Gateway 56
Program XBee Gateway using Python
Find Python learning resources 58
Python support forum 58
Digi Python Wiki Archive Reference Manual 58
Digi-specific Python modules for programming 58
Sample programs 58
Button handling 59
LED control 59
Watchdog 60
RCI callback 61
XBee functions 62
XBee Gateway Python application and Remote Manager 62

XBee Gateway User Guide 6
How does the XBee Gateway Python application work? 62
XBee Gateway Python application requirements 63
Key features and operations of the XBee Gateway Python application 64
Store status data for XBee lines in Remote Manager 64
Receive serial data from Remote Manager 68
Store serial data in Remote Manager 75
Manage XBee DIO lines though Remote Manager 78
XBee Gateway Python application configuration file 85
XBee Gateway Python application command errors 86
Configure a Python application in the web interface 86
Digi ESP for Python 87
Access the program samples in Digi ESP 87
Install the Digi ESP for Python Development Environment 88
DIA software 91
Linux command shell (command line interface) 91
User name and password for the Linux command shell 91
Connect and log in to the XBee Gateway device 91
Log in to XBee Gateway through the Digi ESP for Python command line interface 92
Configure XBee Gateway
Configure settings from Remote Manager 95
Basic configuration settings 95
Advanced configuration settings 95
Configure settings from the XBee Gateway web interface 96
Access the XBee Gateway web interface 96
Home page 97
Ethernet IP network settings 98
Default Ethernet settings 98
Configure Ethernet Settings 99
Ethernet Network Configuration page 99
Wireless (Wi-Fi) network settings 101
Default wireless (Wi-Fi) settings 101
Configure wireless settings 101
Wi-Fi network settings 101
Mobile connectivity settings 104
Default behavior with the cellular network 104
Set up and configure GSM-based devices 105
Provision a CDMA-based device 106
Configure mobile settings 107
Mobile Connectivity Configuration page 108
Short Message Service (SMS) 109
Digi Mobile SureLink™ settings 112
Configure Mobile SureLink settings 112
Mobile SureLink integrity monitoring settings 112
Link integrity test options 114
DNS settings 115
Configure Domain Name Server (DNS) 115
Domain Name Server (DNS) Configuration page 115
Mobile firewall settings 116
Configure mobile firewall settings 116
Enable or Disable Mobile firewall settings 116
Autostart settings for the Python Program 116
Configure Python settings 117
Python settings 117

XBee Gateway User Guide 7
Button service assignments settings 117
Configure button service assignments 117
Button service assignments page 118
Restore XBee Gateway factory defaults 118
Use discovery tools to enable configuration changes 118
Use the button to enable special-purpose Wi-Fi configuration mode 119
Use the button to enable the web interface 120
Configure Remote Manager connectivity settings 120
Configure connectivity settings 121
Basic connectivity settings 121
Advanced connectivity settings 122
Advanced connectivity settings for the web interface 124
Device Cloud client initiated connection page 127
Device Cloud Configuration page 128
Device Cloud network type page 129
Connect to a different instance of Remote Manager 130
Configure a proxy server 130
Network services settings 131
Configure network services settings 131
Network Services Configuration page 131
GPS static position settings 133
Configure GPS Static Position settings 133
GPS Static Position page 134
Time settings 134
Configure time settings 134
Time Server Configuration page 135
Time Zone Configuration page 135
Time Configuration page 135
Configure XBee network settings
Configure XBee Networks page in Remote Manager 137
Configure XBee network settings in the web interface 138
XBee Configuration page 138
Device Details page 139
XBee network OTA firmware updates 141
Update the XBee network node firmware (OTA updates) from Remote Manager 141
Update the XBee node firmware (OTA updates) from the web interface 142
XBee Gateway network Python log file 144
XBee network troubleshooting resources 144
Learn more about XBee Gateway
Default startup and operation behaviors for XBee Gateway 145
Default behavior regarding NTP time server access 145
Default behavior regarding DNS 145
Firewalls and required open ports 146
Deploying devices over a network 146
Connect the XBee nodes to XBee Gateway 146
Configure XBee Gateway as a coordinator 146
Join nodes to the coordinator 147
Verify that XBee nodes are joined to the coordinator 148
Configure the ZigBee network addressing parameters for XBee nodes 149
Key addressing parameters 149

XBee Gateway User Guide 8
Configure the network addressing parameters 150
Explore serial I/O 150
Understand the process for configuring the serial I/O 150
Example serial I/O configuration 151
Configure the serial I/O 151
Explore digital and analog I/O 152
Understand the process for digital and analog I/O 152
Example digital or analog I/O configuration 153
Configure the digital or analog I/O 154
View your device data 156
View device data from Remote Manager 157
View device data and events in the Python log file for XBee Gateway 157
Hardware
Ethernet and Wi-Fi hardware 162
Cellular hardware 163
Antennas 164
XBee Gateway button 164
XBee Gateway LEDs descriptions 165
Power LED 165
XBee LED 166
Network LED 166
Signal strength LED (cellular models only) 167
Troubleshoot your XBee Gateway
XBee Gateway system log 169
XBee Gateway log files and contents 169
Display the system log 170
Cellular connection issues 171
Common provisioning issues 171
Troubleshooting XBee Gateway GSM devices 172
Troubleshooting XBee Gateway CDMA devices 173
Device Discovery troubleshooting tips 173
Rebooting XBee Gateway 174
Troubleshooting LEDs 174
Firewalls and required open ports 175
Cannot connect to NTP time server to get correct time 176
Cannot connect to DNS server to resolve the Remote Manager server address 176
Need more help? 176

About Digi XBee Gateway
Digi XBee® Gateway provides a low-cost, programmable solution to connect networks of XBee-
enabled devices to IP networks. With a simple, open-source Python™ development environment, this
gateway enables custom applications to run locally while interfacing across existing Ethernet/Wi-
Fi/cellular networks for WAN connectivity to cloud-based software applications.
The XBee Gateway contains the XBeeZigBee product.
You can manage XBee Gateway products remotely via Digi Remote Manager®. Remote Manager
allows users to remotely manage thousands of deployed devices, supporting features like remote
firmware upgrades and event alarms.
This guide describes how to get started with yourXBee Gateway. This guide is intended for a
developer or programmer. It covers the following information:
nHardware
nGet started
nSet up your XBee Gateway
XBee Gateway User Guide 9

About Digi XBee Gateway Regulatory information and certifications
XBee Gateway User Guide 10
nAdministration and maintenance tasks
nAbout programming
nProgram XBee Gateway using Python
nConfigure XBee Gateway
nConfigure XBee network settings
nLearn more about XBee Gateway
nTroubleshoot your XBee Gateway
Regulatory information and certifications
RF exposure statement
In order to comply with RF exposure limits established in the ANSI C95.1 standards, the distance
between the antenna or antennas and the user should not be less than 20 cm.
FCC certifications and regulatory information (USA only)
FCC Part 15 Class B
Radio Frequency Interface (RFI) (FCC 15.105)
This device has been tested and found to comply with the limits for Class B digital devices pursuant to
Part 15 Subpart B, of the FCC rules. These limits are designed to provide reasonable protection
against harmful interference in a residential environment. This equipment generates, uses, and can
radiate radio frequency energy, and if not installed and used in accordance with the instruction
manual, 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 and correct the interference by one or more of the following
measures:
nReorient or relocate the receiving antenna.
nIncrease the separation between the equipment and receiver.
nConnect the equipment into an outlet on a circuit different from that to which the receiver is
connected.
nConsult the dealer or an experienced radio/TV technician for help.
Labeling Requirements (FCC 15.19)
This device complies with Part 15 of FCC rules. Operation is subject to the following two conditions: (1)
this device may not cause harmful interference, and (2) this device must accept any interference
received, including interference that may cause undesired operation.
If the FCC ID is not visible when installed inside another device, then the outside of the device into
which the module is installed must also display a label referring to the enclosed module FCC ID.
Modifications (FCC 15.21)
Changes or modifications to this equipment not expressly approved by Digi may void the user’s
authority to operate this equipment.

About Digi XBee Gateway Regulatory information and certifications
XBee Gateway User Guide 11
Declaration of Conformity (DoC)
Digi has issued Declarations of Conformity for the XBee Gateway concerning emissions, EMC, and
safety. For more information, see www.digi.com/resources/certifications.
Important note
Digi customers assume full responsibility for learning and meeting the required guidelines for each
country in their distribution market. Refer to the radio regulatory agency in the desired countries of
operation for more information.
CE mark (Europe)
The XBee Gateway is certified for use in several European countries. For information, visit
www.digi.com/resources/certifications.
If the XBee Gateway is incorporated into a product, the manufacturer must ensure compliance of the
final product with articles 3.1a and 3.1b of the RE Directive (Radio Equipment Directive). A Declaration
of Conformity must be issued for each of these standards and kept on file as described in the RE
Directive.
Furthermore, the manufacturer must maintain a copy of the XBee 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 manual. If any of these
specifications are exceeded in the final product, a submission must be made to a notified body for
compliance testing to all required standards.
OEM labeling requirements
The CE marking must be affixed to a visible location on the OEM product.
CE labeling requirements
The CE mark shall consist of the initials “CE” taking the following form:
nIf the CE marking is reduced or enlarged, the proportions given in the above graduated
drawing must be respected.

About Digi XBee Gateway Safety statements
XBee Gateway User Guide 12
nThe CE marking must have a height of at least 5 mm except where this is not possible on
account of the nature of the apparatus.
nThe CE marking must be affixed visibly, legibly, and indelibly.
Industry Canada (IC) certifications
This digital apparatus does not exceed the Class B limits for radio noise emissions from digital
apparatus set out in the Radio Interference Regulations of the Canadian Department of
Communications.
This device complies with Industry Canada’s licence-exempt RSSs. 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.
Le présent appareil numerique n’emet pas de bruits radioelectriques depassant les limites applicables
aux appareils numeriques de la class B prescrites dans le Reglement sur le brouillage radioelectrique
edicte par le ministere des Communications du Canada.
Le présent appareil est conforme aux CNR d'Industrie Canada applicables aux appareils radio exempts
de licence. L'exploitation est autorisée aux deux conditions suivantes:
(1) l'appareil ne doit pas produire de brouillage, et
(2) l'utilisateur de l'appareil doit accepter tout brouillage radioélectrique subi, même si le brouillage
est susceptible d'en compromettre le fonctionnement.
Korea Communications Commission (KCC) certifications
We, Digi International, in agreement with Powermat gateway, as per The Radio Research Agency
(RRA), division of the Korea Communications Commission (KCC), consider this device Industrial Class A
Equipment (Industrial Broadcasting & Communication Equipment) and therefore electromagnetic
wave-suitable.
For Class A Equipment (Business Broadcasting and Communications Equipment)
The equipment is for business use (Class A), and has acquired electromagnetic conformity
registration, so sellers and users are required to take caution in this regard.
Safety statements
Important Safety Information
CAUTION! To avoid contact with electrical current, follow all safety items listed below.

About Digi XBee Gateway Safety statements
XBee Gateway User Guide 13
nNever install electrical wiring during an electrical storm.
nNever install an Ethernet connection in wet locations unless that connector is specifically
designed for wet locations.
nUse caution when installing or modifying lines.
nUse a screwdriver and other tools with insulated handles.
nWear safety glasses or goggles.
nDo not place Ethernet wiring or connections in any conduit, outlet or junction box containing
electrical wiring.
nInstallation of inside wire may bring you close to electrical wire, conduit, terminals and other
electrical facilities. Extreme caution must be used to avoid electrical shock from such facilities.
Avoid contact with all such facilities.
nEthernet wiring must be at least 6 feet from bare power wiring or lightning rods and
associated wires, and at least 6 inches from other wire (antenna wires, doorbell wires, wires
from transformers to neon signs), steam or hot water pipes, and heating ducts.
nDo not place an Ethernet connection where it would allow a person to use an Ethernet device
while in a bathtub, shower, swimming pool, or similar hazardous location.
nProtectors and grounding wire placed by the service provider must not be connected to,
removed, or modified by the customer.
nDo not touch uninsulated Ethernet wiring if lightning is likely.
nExternal Wiring: Any external communications wiring installed needs to be constructed to all
relevant electrical codes. In the United States this is the National Electrical Code Article 800.
Contact a licensed electrician for details.
Warnings for Use of Wireless Devices
CAUTION! Observe all warning notices regarding use of wireless devices.
Potentially Hazardous Atmospheres
Observe restrictions on the use of radio devices in fuel depots, chemical plants, etc. and areas where
the air contains chemicals or particles, such as grain, dust, or metal powders, and any other area
where you would normally be advised to turn off your vehicle engine.
Safety in Aircraft
Switch off the wireless device when instructed to do so by airport or airline staff. If the device offers a
‘flight mode’ or similar feature, consult airline staff about its use in flight.

About Digi XBee Gateway Maximum power and frequency bands
XBee Gateway User Guide 14
Safety in Hospitals
Wireless 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
requests are designed to prevent possible interference with sensitive medical equipment.
Pacemakers
Pacemaker manufacturers recommended that a minimum of 15 cm (6 inches) be maintained between
a handheld wireless device and a pacemaker to avoid potential interference with the pacemaker.
These recommendations are consistent with independent research and recommendations by Wireless
Technology Research.
Persons with Pacemakers
nShould ALWAYS keep the device more than 15 cm (6 inches) from their pacemaker when turned
ON.
nShould not carry the device in a breast pocket.
nIf you have any reason to suspect that the interference is taking place, turn OFF your device.
International EMC (Electromagnetic Emissions/Immunity/Safety)
standards
This product complies with the requirements of following Electromagnetic Emissions/Immunity/Safety
standards.
There are no user-serviceable parts inside the product. Contact your Digi representative for repair
information.
Emissions Immunity Safety
AS/NZS 4268:2008 (Amended by A1:2010) Class
B (Wi-Fi only)
AS/NZS CISPR 22:2009 Class B
EN 301 489-17 V2.1.1:2009 Class B (Wi-Fi only)
EN 55022:2010 Class B
EN 61000-3-2:2006
EN 61000-3-3:2008
FCC Part 15 Subpart B Class B
FCC Part 15 Subpart C (Wi-Fi only)
ICES-003:2004 Class B
RSS-Gen:2010 (Wi-Fi only)
RSS-210:2010 (Wi-Fi only)
EN 301 489-17 V2.1.1:2009
(Wi-Fi only)
EN 55024:2010
EN 301 489-24 V1.5.1 (Cellular
only)
IEC 60950-1:2005
EN 60950-1:2006
UL 60950-1
CSA C22.2 No.
60950-1
Maximum power and frequency bands
This section contains the maximum power and frequency bands for the XBee Gateway.

About Digi XBee Gateway XBee Gateway Python application
XBee Gateway User Guide 15
XBee Gateway: Cellular
Maximum power Associated frequencies
6.3 mW 5 MHz channel spacing, beginning at 2405 MHz and ending at
2480 MHz
2 W Cellular 850 and 900 MHz bands
1 W Cellular 1800 and 1900 MHz bands
XBee Gateway: Ethernet
Maximum power Associated frequencies
6.3 mW 5 MHz channel spacing, beginning at 2405 MHz and ending at
2480 MHz
XBee Gateway: Wi-Fi
Maximum power Associated frequencies
6.3 mW 5 MHz channel spacing, beginning at 2405 MHz and ending at
2480 MHz
88 mW 13 overlapping channels each 22 MHz wide and spaced at 5
MHz. Centered at 2.412 to 2.472 MHz.
XBee Gateway Python application
The XBee Gateway Python application resides on XBee Gateway. Its key functions include connecting
your XBee modules to Remote Manager, enabling uploads of data to Remote Manager, and receiving
remote text and commands. The XBee Gateway Python application is installed by default in your XBee
Gateway device and automatically starts when the gateway is initialized.
For more information on the XBee Gateway Python application, see XBee Gateway Python application
and Remote Manager.
XBee ZigBee Cloud Kit
Digi offers a development kit called the XBee ZigBee Cloud Kit.
The XBee ZigBee Cloud Kit is designed to make it easy to set up your XBee ZigBee hardware and
configure its sample web application. You can see sensor data from your development board on the
web, as well as send data and commands from the web to your device. The components in this kit
allow you to create highly customized solutions for connected devices.
To order this kit, go to the XBee Gateway product page for ordering information. For setup
instructions, see the XBeeZigBeeCloudKit Getting Started Guide.

About Digi XBee Gateway Hardware interfaces
XBee Gateway User Guide 16
Hardware interfaces
XBee Gateway hardware interfaces include a button for controlling various device operations, LEDs
that indicate device state and status of connections, and activity for Ethernet, Wi-Fi, cellular, and XBee
network connections. You can control some of these hardware features through programming.
For detailed information about hardware interfaces, see Hardware.
Configuration and management interfaces
To establish network connectivity with an XBee Gateway device, minimal configuration is required in
many environments. This means that you may not need to set or change configuration settings from
their factory defaults to begin developing with the device. There are several user interfaces for
interacting with XBee Gateway, for example to view or change configuration settings or perform
important administrative tasks such as updating firmware or rebooting the device. These include:
nXBee Gateway web interface: A web-based interface for configuring, monitoring, and
administering Digi devices.
nRemote Manager interface: A web-based, remote-management interface.
nRFGateway and Python remote device management solutions
nProgramming interface applications
XBee Gateway web interface
The XBee Gateway web interface, available via a local network connection to XBee Gateway, provides
an easy way to configure device settings and perform administrative tasks. Device information
displayed varies by model.
You are required to log in to the web interface. The default user name and password are described
below:
nUser name:python
nPassword: The unique password printed on the device label. If the password is not on the
device label, the default password is dbps. If these defaults do not work, the password may
have been updated. Contact your system administrator for help.
For more information, see Configure settings from the XBee Gateway web interface.
Remote Manager interface
Remote Manager is a software-as-a-service that empowers IT, network operations and customer
support organizations to conquer the challenges of managing the vast array of equipment in their
device networks. As a network grows, the complexity of effectively managing the network assets
grows exponentially.
When XBee Gateway powers up, the device automatically connects to Remote Manager. Remote
Manager provides the capabilities you need to manage a dynamic device network, including:
nCentralized control over large numbers of devices
nReducing service complexity
nMaintaining high levels of security

About Digi XBee Gateway Configuration and management interfaces
XBee Gateway User Guide 17
nConfiguring and decommissioning of equipment
nAdding functionality to device networks
In addition, you can use the Remote Manager Web Services (API) to provide seamless integration from
Digi gateways into customer back-office applications. You can access these Web Services via the API
Explorer tab of the Documentation tab of the Remote Manager interface. See Digi Remote Manager
Programmer Guide for more information.
Some things to note about using Remote Manager:
nYou must register devices on Remote Manager before you can access them from Remote
Manager.
nTo minimize network traffic, Remote Manager uses caching. As a result, device settings can be
out-of-sync between the device and the settings viewed on the Remote Manager console.
nYou can refresh device information on demand when the device is connected. The device
information refreshes automatically when a device connects.
For more information about configuring settings from Remote Manager, see Configure settings from
Remote Manager.
For more information on Remote Manager as a remote device network management solution, see
these resources:
nDigi Remote Manager User Guide
nDigi Remote Manager Programmer Guide
nRemote Manager tutorials and other documents available on the Digi Remote Manager
product page
Note To serve our customers most effectively, Digi International Inc. is consolidating its cloud
services, Digi Device Cloud and Digi Remote Manager®, under the Remote Manager name. This phased
process does not affect device 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 interfaces.
RFGateway and Python remote device management solutions
XBee Gateway includes Remote Manager functionality by default. This functionality allows you to see
your data in the cloud quickly and with minimal effort.
However, you can extend the system through the Python interpreter and customize the gateway to
connect directly to the environment of your choice. See the Digi XBee, RFGateway and Python
Resource page for more information.
Programming interface applications
XBee Gateway offers a variety of interfaces that produce and/or consume data. Developing software
programs for XBee Gateway products allows Digi customers to provide custom logic to control the
information to and from these interfaces.
For more information, see About programming.

About Digi XBee Gateway Product differences from predecessor ConnectPort® X products
XBee Gateway User Guide 18
Product differences from predecessor ConnectPort® X products
XBee Gateway differs from predecessor ConnectPort X products. These differences are important to
programmers and integrators who are familiar with the predecessor devices and need to develop
applications and install or manage the gateway. These differences include the following.
nOperating system: XBee Gateway is built on the industry-standard Linux operating system,
versus a Digi-proprietary embedded operating system.
nMemory: XBee Gateway has 64 MB of RAM and 128 MB of flash memory. Users have access to
up to 20 MB of RAM and up to 20 MB of flash memory. Predecessor devices had less RAM and
flash memory available for custom Python applications.
nSystem date and time: XBee Gateway, for reasons of improved security, has a greater
dependence on time synchronization than predecessor products. In so doing, XBee Gateway
uses standard Network Time Protocol (NTP) and requires connectivity with an external NTP
time server. Without NTP, the device cannot:
lCorrectly validate security certificate
lDisable the ability to connect to Remote Manager
lDisable the ability to update the firmware
nButton: XBee Gateway features a programmable button. You can configure this button to
activate some Digi native features (such as returning a device to its factory defaults), and you
can also use this button for custom applications. For more information on the button, see XBee
Gateway button. This button behavior differs from the Reset button behavior on other gateway
products.
nUser interfaces:
lXBee Gateway has a web user interface for both network configuration and access to the
log file for troubleshooting the initial connection to Remote Manager. For more information
on the web interface, see Configure XBee Gateway.
lCommand-line interface differences: XBee Gateway allows access to the Linux shell
using SSH. For more information about the shell, see Linux command shell (command line
interface). Access to a command-line interface through Telnet is not supported for network
security reasons. Commands in the command-line interface for predecessor ConnectPort X
products are not supported. However, some ConnectPort X2 command-line interface
commands have equivalents in the Remote Command Interface (RCI).
nFirmware updates: Due to the complexity of the Linux-based system, you cannot use standard
firmware updates to downgrade a system.
nLogging: XBee Gateway supports continuous logging for troubleshooting. You can browse the
log files from the web interface or pull the log files from the device file system in Remote
Manager. They are stored in the Linux file system in the /WEB/logging directory and persist
across reboots and power cycles. For more information, see View the Python log file.

About Digi XBee Gateway Where to find more information
XBee Gateway User Guide 19
nSupported Python version: XBee Gateway uses Python interpreter version 2.7. Many
predecessor ConnectPort X products use Python 2.4.
Any custom-compiled Python code must be recompiled for Python interpreter 2.7. Custom
Python modules are not 100% compatible with XBee Gateway. Therefore, in addition to
recompiling, you may need to port.
Where to find more information
See the following topics in this guide for more information:
nLearn more about XBee Gateway
nAbout programming
The following documents are available on www.digi.com unless otherwise noted:
nFor more information about features and operation of the XBee RF module mounted inside the
gateway, see XBee/XBee-PRO ZigBee RF Module User Guide.
nYou can refer to the ConnectPort X2e section in the Digi Python Wiki Archive Reference Manual
for additional programming content for ConnectPort X2e products. Information in this section
also applies to XBee Gateway.
nDIA section in the Digi Python Reference Manual for Developers guide
nDigi Remote Manager User Guide
nDigi Remote Manager Programmer Guide
nDatasheets and other documents on the Digi Remote Manager product page

Get started
Based on the XBee Gateway model that you have, choose one of the following options:
nSet up the XBee Gateway Cellular hardware
nSet up the XBee Gateway Wi-Fi hardware
Set up the XBee Gateway Cellular hardware
This section walks you through the steps required to set up your XBee Gateway Cellular hardware and
provides additional reference information.
Verify your components
Included equipment
Equipment Description
XBee Gateway
(Cellular model)
XBee Gateway User Guide 20