Digi XBee Cellular LTE Cat 1 User Manual
Digi XBee® Cellular LTE Cat 1
Embedded Modem
User Guide
Revision history—90001525
Revision Date Description
A
B December
C February
September
2016
2016
2017
Baseline release of the document.
Added API functionality. Many changes to reflect the initial production
release.
Added sleep support. Added SMSencoding information. Added D6, D7, DV,
AM, LA, SH, SL, SM, SP, ST and P1 commands. Noted that ANis not case-
sensitive.
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.
© 2017 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
techcomm@digi.com.
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.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
2
Contents
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
Applicable firmware and hardware 7
Purchase the correct SIM cards 7
Getting started with the XBee Cellular Modem Development Kit
Identify the kit contents 10
Cellular service 10
Connect the hardware 11
Configure the device using XCTU 12
Add a device 12
Update to the latest firmware 12
Software libraries 12
XBIB-U_DEV reference 14
XBee Cellular Modem examples 16
Check for cellular registration and connection 16
Send an SMS message to a phone 16
Connect to the ELIZA server 18
Connect to the echo server 19
Connect to the Daytime server 21
Connect to a TCP/IP address 23
Perform a (GET) HTTP request 24
Configure the XBee Cellular Modem using Device Cloud 25
Create a Device Cloud account 25
Get the XBee Cellular Modem IMEI number 25
Add a Digi XBee to Device Cloud 25
Update the firmware 26
Technical specifications
Interface and hardware specifications 28
RF characteristics 28
Networking and carrier 28
Power requirements 28
Power consumption 29
Electrical specifications 29
Regulatory approvals 30
Hardware
Mechanical drawings 32
Pin signals 32
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
3
Pin connection recommendations 33
Antenna connections 33
Antenna placement 34
SIM card 34
The Associate LED 34
Heat considerations 35
Heat sink considerations 35
Power supply considerations 36
Add a capacitor to the RESET line 36
Add a fan to provide active cooling 37
Cellular connection process
Connecting 39
Cellular network 39
Data network connection 39
Data communication with remote servers (TCP/UDP) 39
Disconnecting 39
SMS encoding 40
Modes
Select an operating mode 42
Transparent operating mode 42
API operating mode 43
Bypass operating mode 43
Enter Bypass operating mode 43
Leave Bypass operating mode 43
Boot the XBee Cellular Modem in Bypass operating mode 44
Restore cellular settings to default in Bypass operating mode 44
Command mode 44
Enter Command mode 44
Send AT commands 45
Apply command changes 45
Make command changes permanent 45
Exit Command mode 45
Sleep modes
About sleep modes 48
Normal mode 48
Pin sleep mode 48
Cyclic sleep mode 48
Cyclic sleep with pin wake up mode 48
Airplane mode 48
The sleep timer 48
AT commands
Special commands 50
AC (Apply Changes) 50
FR (Force Reset) 50
RE (Restore Defaults) 50
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
4
WR (Write) 50
Cellular commands 51
PH (Phone Number) 51
S# (ICCID) 51
IM (IMEI) 51
MN (Operator) 51
MV (Modem Firmware Version) 52
DB (Cellular Signal Strength) 52
AM (Airplane Mode) 52
DV (Antenna Diversity) 52
Network commands 53
IP (IP Protocol) 53
TL (SSL/TLS Protocol Version) 53
TM (TCP Client Connection Timeout) 54
DO (Device Options) 54
EQ (Device Cloud FQDN) 54
Addressing commands 54
SH (Serial Number High) 54
SL (Serial Number Low) 55
DL (Destination Address) 55
P# (Destination Phone Number) 55
DE (Destination Port) 55
TD (Text Delimiter) 56
MY (Module IP Address) 56
LA (Lookup IP Address of FQDN) 56
OD (Operating Destination Address) 56
Serial interfacing commands 57
BD (Baud Rate) 57
NB (Parity) 57
SB (Stop Bits) 58
RO (Packetization Timeout) 58
FT (Flow Control Threshold) 58
AP (API Enable) 59
I/O settings commands 59
D8 (DIO8/SLEEP_REQUEST) 59
D9 (DIO9/ON_SLEEP) 60
P1 (DIO11/PWM1 Configuration) 60
I/O sampling commands 61
TP (Temperature) 61
SM (Sleep Mode) 61
SP (Sleep Period) 62
ST (Wake Time) 62
Command mode options 62
CC (Command Sequence Character) 62
CT (Command Mode Timeout) 62
GT (Guard Times) 63
Firmware version/information commands 63
VR (Firmware Version) 63
VL (Version Long) 63
HV (Hardware Version) 63
HS (Hardware Series) 64
CK (Configuration CRC) 64
Diagnostic interface commands 64
DI (Device Cloud Indicator) 64
CI (Protocol/Connection Indication) 65
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
5
Execution commands 66
AN (APN) 67
NR (Network Reset) 67
!R (Modem Reset) 67
Operate in API mode
API frame specifications 70
API operation (AP parameter = 1) 70
API operation-with escaped characters (AP parameter = 2) 70
Start delimiter 71
Length 71
Frame data 71
Checksum 72
Calculate and verify checksums 72
Frame descriptions 73
AT Command - 0x08 73
AT Command: Queue Parameter Value - 0x09 74
Transmit (TX) SMS - 0x1F 75
Transmit (TX) Request: IPv4 - 0x20 76
AT Command Response - 0x88 77
Transmit (TX) Status - 0x89 78
Modem Status - 0x8A 79
Receive (RX) Packet: SMS - 0x9F 80
Receive (RX) Packet: IPv4 - 0xB0 81
Socket behavior
Secure Sockets Layer (SSL) certificate checking 83
Socket timeouts 83
Troubleshooting
Cannot find the serial port for the device 85
Correct a macOS Java error 86
Unresponsive cellular component in Bypass mode 87
Not on expected network after APN change 88
Certifications
Modification statement 90
Interference statement 90
Wireless notice 90
FCC Class B digital device notice 91
Labelling requirements for the host device 91
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
6
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
The XBee Cellular Modem is an embedded Long-Term Evolution (LTE) Category 1 cellular module that
provides original equipment manufacturers (OEMs) with a simple way to integrate cellular
connectivity into their devices.
The XBee Cellular Modem enables OEMs to quickly integrate cutting edge 4G cellular technology into
their devices and applications without dealing with the painful, time-consuming, and expensive FCC
and carrier end-device certifications.
With the full suite of standard XBee API frames and AT commands, existing XBee customers can
seamlessly transition to this new device with only minor software adjustments. When OEMs add the
XBee Cellular Modem to their product, they create a future-proof design with flexibility to switch
between wireless protocols or frequencies as needed.
Applicable firmware and hardware
This manual supports the following firmware:
n 1005
It supports the following hardware:
n XBC-V1-UT-xxx
Purchase the correct SIM cards
If you order the wrong type of SIM card it will not work with the XBee Cellular Modem.
Verizon recommends SIM SKU: M2MTRI-NONRUG-GT-A or an equivalent that must include a 4FF
punch out. This SKU is in triple punch, so devices with 2FF/3FF or 4FF can use this SIM SKU.
Bulk SIMs for M2M/Io are available from:
National distributor Network Contact
Reliance
Communications
Ingram Micro - Sales
Ingram Micro - Sales
Verizon
direct
Verizon
direct
Verizon
direct
Raja Ali 917-517-
Lesli Reeves 317-707-
Steve Kreiger 317-707-
Phone
number Email
raja.ali@reliance.us
7282
lesli.reeves@ingrammicro.com
2371
steve.kreiger@ingrammicro.com
2474
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
7
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide Purchase the correct SIM cards
Phone
National distributor Network Contact
number Email
Ice Mobility
KORE
KORE
Verizon
direct
Verizon
MVNO
Verizon
MVNO
Tom Puchala 847-876-
1768
Genesis
Crowder
Mike Basso 877-710-
877-7105673
5673
tom.puchala@icemobility.com
gcrowder@korewireless.com
mbasso@korewireless.com
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
8
Getting started with the XBee Cellular Modem Development Kit
This section describes how to set up an XBee network and adjust the XBee Cellular Modem settings.
This section describes how to connect the hardware in the XBee Cellular Modem Development Kit, and
provides some examples you can use to communicate with the device.
Identify the kit contents 10
Cellular service 10
Connect the hardware 11
Configure the device using XCTU 12
Software libraries 12
XBIB-U_DEV reference 14
XBee Cellular Modem examples 16
Configure the XBee Cellular Modem using Device Cloud 25
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
9
Getting started with the XBee Cellular Modem Development Kit Identify the kit contents
Identify the kit contents
The Developer's kit includes the following:
One XBIB-U-DEV board
One 12 V power supply
Two antennas with U.FL connectors
One USB cable
One XBee Cellular Modem
One SIMcard
Cellular service
The XBIB-U-DEV board comes in an anti-static bag. There is a label on the bag that provides the date
that cellular service expires for the SIM card in the XBee Cellular Modem.
Note the expiration date and when cellular service expires, contact us at 1.877.890.4014 for further
instructions on renewing cellular service for the device.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
10
Getting started with the XBee Cellular Modem Development Kit Connect the hardware
Connect the hardware
1. Plug one XBee Cellular Modem into the XBIB-U-DEV board.
2. The SIMcard should be inserted into the XBee Cellular Modem already. If not, install the
SIMcard into the XBee Cellular Modem.
WARNING! Never insert or remove the SIM card while the device is powered!
3. Connect the antennas to the XBee Cellular Modem by aligning the U.FL connectors carefully,
then firmly pressing straight down to seat the connector. U.FL is fragile and is not designed for
multiple insertions, so be careful when connecting or removing the antennas.
4. Plug the 12 V power supply to the power jack on the development board.
5. Connect the USB cable from a PC to the USB port on the development board. The computer
searches for a driver, which can take a few minutes to install.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
11
Getting started with the XBee Cellular Modem Development Kit Configure the device using XCTU
Configure the device using XCTU
XBee Configuration and Test Utility (XCTU) is a multi-platform program that enables users to interact
with Digi radio frequency (RF) devices through a graphical interface. The application includes built-in
tools that make it easy to set up, configure, and test Digi RF devices.
For instructions on downloading and using XCTU, see the XCTU User Guide.
Note If you are on a macOS computer and encounter problems installing XCTU, see Correct a macOS
Java error.
Add a device
These instructions show you how to add the XBee Cellular Modem to XCTU. If XCTU does not find your
serial port, see Cannot find the serial port for the device.
Launch XCTU .
1.
Click the Discover radio modules button .
2.
3. In the Discover radio devices dialog, select the serial ports where you want to look for XBee
modules, and click Next.
4. In the Set port parameters window, maintain the default values and click Finish.
5. As XCTU locates radio modules, they appear in the Discovering radio modules dialog box.
If your module could not be found, XCTU displays the Could not find any radio module dialog
providing possible reasons why the module could not be added.
Update to the latest firmware
Firmware is the program code stored in the device's persistent memory that provides the control
program for the device. Use XCTU to update the firmware.
Click the Configuration working modes button .
1.
2. Select a local or remote XBee module from the Radio Modules list.
Click the Update firmware button .
3.
The Update firmware dialog displays the available and compatible firmware for the selected
XBee module.
4. Select the product family of the XBee module, the function set, and the latest firmware version.
5. Click Update. A dialog displays update progress.
See How to update the firmware of your modules in the XCTU User Guide for more information.
Software libraries
One way to communicate with the XBee device is by using a software library. The libraries available
for use with the XBee Cellular Modem include:
n XBee Java library
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
12
Getting started with the XBee Cellular Modem Development Kit Software libraries
The XBee Java Library is a Java API. The package includes the XBee library, its source code and a
collection of samples that help you develop Java applications to communicate with your XBee devices.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
13
Getting started with the XBee Cellular Modem Development Kit XBIB-U_DEV reference
XBIB-U_DEV reference
This picture shows the XBIB-U development board and the table that follows explains the callouts in
the picture.
Number Item Description
1 Programmingheader Header used to program XBee Programmable devices.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
14
Getting started with the XBee Cellular Modem Development Kit XBIB-U_DEV reference
Number Item Description
2 Self power module
Advanced users only—voids the warranty. Depopulate R31 to
power the device using V+ and GND from J2 and J5. You can
connect sense lines to S+ and S- for sensing power supplies.
CAUTION: Voltage is not regulated. Applying the incorrect
voltage can cause fire and serious injury.
1
3 Current testing Depopulating R31 allows a current probe to be inserted across P6
terminals. The current though P6/R31 powers the device only.
Other supporting circuitry is powered by a different trace.
4 Loopback jumper Populating P8 with a loopback jumper causes serial transmissions
both from the device and from the USB to loopback.
5 DC barrel plug: 6-20V Greater than 500 mA loads require a DC supply for correct
operation. Plug in the external power supply prior to the USB
connector to ensure that proper USB communications are not
interrupted.
6 LED indicator
Yellow: Modem sending serial/UART data to host.
Green: Modem receiving serial/UART data from host.
Red: Associate.
7 USB
8 RSSI indicator
9 User buttons Connected to DIO lines for user implementation.
10 Reset button
11 SPI power Connect to the power board from 3.3 V.
12 SPI Only used for surface-mount devices.
13 Indicator LEDs
DS5: ON/SLEEP
DS2: DIO12, the LED illuminates when driven low.
DS3: DIO11, the LED illuminates when driven low.
DS4: DIO4, the LED illuminates when driven low.
14 Through-hole XBee
sockets
15 20-pin header Maps to standard through-hole XBee pins.
1
Powering the board with J2 and J5 without R31 removed can cause shorts if the USB or barrel plug power are
connected. Applying too high a voltage destroys electronic circuitry in the device and other board components
and/or can cause injury.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
15
Getting started with the XBee Cellular Modem Development Kit XBee Cellular Modem examples
XBee Cellular Modem examples
Check for cellular registration and connection
In the following examples, proper cellular network registration and address assignment must occur
successfully. The LED on the development board blinks when the XBee Cellular Modem registers to the
cellular network; see The Associate LED. If the LEDremains solid, registration has not occurred
properly. Registration can take several minutes.
Note Make sure you are in an area with adequate cellular network reception or the XBee Cellular
Modem will not make the connection.
In addition to the LED confirmation, you can check the AT commands below in XCTU to check the
registration and connection. To view these commands:
Open XCTU and click the Configuration working mode button.
1.
2. Select a device from the Radio Modules list. XCTU displays the current firmware settings for
that device.
On the Configuration toolbar, click the Default button to load the default values
3.
established by the firmware, and click Yes to confirm.
The relevant commands are:
Note To search for an ATcommand in XCTU, use the search box.
n AI (Association Indication) reads zero when the device successfully registers to the cellular
network. If it reads 0x23 it is connecting to the Internet; 0x22 means it is registering to the
cellular network.
n MY (Module IPAddress) should display a valid IPaddress. If it reads 0.0.0.0, it has not
registered yet.
n AN is not visible on the standard settings interface, it is an advanced command. See AN (APN).
Send an SMS message to a phone
The XBee Cellular Modem can send and receive Short Message Service (SMS) transmissions (texts)
while in Transparent mode. This allows you to send and receive text messages to and from an SMS
capable device such as a mobile phone.
The following table explains the AT commands that you use in this example.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
16
Getting started with the XBee Cellular Modem Development Kit XBee Cellular Modem examples
Command Value Description
AP (APIEnable)
IP (IP Protocol)
P#
(DestinationPhone
Number)
TD (Text Delimiter)
PH (Module's SIM
phone number)
1. Ensure that the device is set up correctly with the SIM card installed and the antennas
connected as described in Connect the hardware.
Open XCTU and click the Configuration working mode button.
2.
3. Select a device from the Radio Modules list. XCTU displays the current firmware settings for
that device.
0 Set the device's API mode to Transparent mode.
2 Set the expected transmission mode to SMScommunication.
<Target
phone
number>
D (0x0D)
Read
only
The target phone number that you send to, for example, your
cellular phone. See P# (Destination Phone Number) for instructions
on using this command.
The text delimiter to be used for Transparent mode, as an ASCII hex
code. No information is sent until this character is entered, unless
the maximum number of characters has been reached. Set to zero
to disable text delimiter checking. Set to D for a carriage return.
The value that represents your device's phone number as supplied
by the SIM card. This is used to send text messages to the device
from another cellular device.
On the Configuration toolbar, click the Default button to load the default values
4.
established by the firmware, and click Yes to confirm.
5. Factory settings are loaded but not written to the device. To write them, click the Write button
on the toolbar.
To switch to SMS communication, in the IP field, select 2 and click the Write button .
6.
7. To enter your cell phone number, in the P# field, type the <target phone number> and click
the Write button. Type the phone number using only numbers, with no dashes. You can use the
+ prefix if necessary. The target phone number is the phone number you wish to send a text to.
8. In the TD field, type D and click the Write button.
9. Note the number in the PH field; it is the XBee Cellular Modem phone number, which you see
when it sends an SMS to your phone.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
17
Getting started with the XBee Cellular Modem Development Kit XBee Cellular Modem examples
Click the Consoles working mode button on the toolbar to open a serial console to the
10.
device. For instructions on using the Console, see
http://www.digi.com/resources/documentation/digidocs/90001458-
13/default.htm#reference/r_at_console.htm
Click the Open button to open a serial connection to the device.
11.
12. Click in the left pane of the Console log, type hello world and press Enter. The XBee Cellular
Modem sends the message to the destination phone number set by the P# command.
13. When the phone receives the text, you can see that the sender's phone number matches the
value reported by the XBee Cellular Modem with the PH command.
14. On the phone, reply with the text connect with confidence and the XBee Cellular Modem
outputs this reply from the UART.
Connect to the ELIZA server
You can use the XBee Cellular Modem to chat with the ELIZA Therapist Bot. ELIZAis an artificial
intelligence (AI) bot that emulates a therapist and can perform simple conversations.
The following table explains the AT commands that you use in this example.
At command Value Description
IP (IP Protocol) 1 Set the expected transmission mode to TCP
communications.
DL (Destination
Address)
DE (Destination Port) 0x2328 The target port number of the Eliza server.
To communicate with the ELIZA Therapist Bot:
1. Ensure that the device is set up correctly with the SIM card installed and the antennas
connected as described in Connect the hardware.
Open XCTU and click the Configuration working mode button.
2.
3. Select a device from the Radio Modules list. XCTU displays the current firmware settings for
that device.
52.43.121.77 The target IP address of the Eliza server.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
18
Getting started with the XBee Cellular Modem Development Kit XBee Cellular Modem examples
On the Configuration toolbar, click the Default button to load the default values
4.
established by the firmware, and click Yes to confirm.
5. Factory settings are loaded but not written to the device. To write them, click the Write button
on the toolbar.
To switch to TCP communication, in the IP field, select 1 and click the Write button .
6.
7. To enter the destination address of the ELIZATherapist Bot, in the DL field, type 52.43.121.77
and click the Write button.
8. To enter the destination IP port number, in the DE field, type 2328 and click the Write button.
Click the Consoles working mode button on the toolbar to open a serial console to the
9.
device. For instructions on using the Console, see
http://www.digi.com/resources/documentation/digidocs/90001458-
13/default.htm#reference/r_at_console.htm
Click the Open button to open a serial connection to the device.
10.
11. Click in the left pane of the Console log, then type in the Console to talk to the ELIZA Therapist
Bot. The following screenshot provides an example of this chat.
Connect to the echo server
This server echoes back the messages you type.
The following table explains the AT commands that you use in this example.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
19
Getting started with the XBee Cellular Modem Development Kit XBee Cellular Modem examples
At
command Value Description
IP (IP
Protocol)
TD
(Text
Delimiter)
DL
(Destination
Address)
DE
(Destination
Port)
To communicate with the echo server:
1. Ensure that the device is set up correctly with the SIM card installed and the antennas
connected as described in Connect the hardware.
Open XCTU and click the Configuration working mode button.
2.
3. Select a device from the Radio Modules list. XCTU displays the current firmware settings for
that device.
1 Set the expected transmission mode to TCP communications.
D (0x0D)
52.43.121.77 The target IPaddress of the echo server.
0x2329 The target port number of the echo server.
The text delimiter to be used for Transparent mode, as an ASCII hex
code. No information is sent until this character is entered, unless the
maximum number of characters has been reached. Set to zero to
disable text delimiter checking. Set to D for a carriage return.
On the Configuration toolbar, click the Default button to load the default values
4.
established by the firmware, and click Yes to confirm.
5. Factory settings are loaded but not written to the device. To write them, click the Write button
on the toolbar.
To switch to TCP communication, in the IP field, select 1 and click the Write button .
6.
7. To enable the XBee Cellular Modem to recognize carriage return as a message delimiter, in the
TD field, type D and click the Write button.
8. To enter the destination address of the echo server, in the DL field, type 52.43.121.77 and click
the Write button.
9. To enter the destination IP port number, in the DE field, type 2329 and click the Write button.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
20
Getting started with the XBee Cellular Modem Development Kit XBee Cellular Modem examples
Click the Consoles working mode button on the toolbar to open a serial console to the
10.
device. For instructions on using the Console, see
http://www.digi.com/resources/documentation/digidocs/90001458-
13/default.htm#reference/r_at_console.htm
Click the Open button to open a serial connection to the device.
11.
12. Click in the left pane of the Console log, then type in the Console to talk to the echo server.
The following screenshot provides an example of this chat.
Connect to the Daytime server
The Daytime server reports the current Coordinated Universal Time (UTC) value responding to any
user input.
The following table explains the AT commands that you use in this example.
At
command Value Description
IP (IP
Protocol)
DL
(Destination
Address)
DE
(Destination
Port)
TD (Text
Delimiter)
To communicate with the Daytime server:
1 Set the expected transmission mode to TCP communications.
52.43.121.77 The target IP of the Daytime server.
0x232A The target port number of the Daytime server.
0
The text delimiter to be used for Transparent mode, as an ASCII hex
code. No information is sent until this character is entered, unless the
maximum number of characters has been reached. Set to zero to
disable text delimiter checking.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
21
Getting started with the XBee Cellular Modem Development Kit XBee Cellular Modem examples
1. Ensure that the device is set up correctly with the SIM card installed and the antennas
connected as described in Connect the hardware.
Open XCTU and click the Configuration working mode button.
2.
3. Select a device from the Radio Modules list. XCTU displays the current firmware settings for
that device.
On the Configuration toolbar, click the Default button to load the default values
4.
established by the firmware, and click Yes to confirm.
5. Factory settings are loaded but not written to the device. To write them, click the Write button
on the toolbar.
To switch to TCP communication, in the IP field, select 1 and click the Write button .
6.
7. To enter the destination address of the daytime server, in the DL field, type 52.43.121.77 and
click the Write button.
8. To enter the destination IP port number, in the DE field, type 232A and click the Write button.
9. To disable text delimiter checking, in the TD field, type 0 and click the Write button.
Click the Consoles working mode button on the toolbar to open a serial console to the
10.
device. For instructions on using the Console, see
http://www.digi.com/resources/documentation/digidocs/90001458-
13/default.htm#reference/r_at_console.htm
Click the Open button to open a serial connection to the device.
11.
12. Click in the left pane of the Console log, then type in the Console to query the Daytime server.
The following screenshot provides an example of this chat.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
22
Getting started with the XBee Cellular Modem Development Kit XBee Cellular Modem examples
Connect to a TCP/IP address
The XBee Cellular Modem can send and receive TCP messages while in Transparent mode; see
Transparent operating mode.
You can use this example as a template for sending and receiving data from a user. The following table
explains the AT commands that you use in this example.
Command Value Description
IP (IP
Protocol)
DL
(Destination
IPAddress)
DE
(Destination
Port)
To connect to a TCP/IP address:
1. Ensure that the device is set up correctly with the SIM card installed and the antennas
connected as described in Connect the hardware.
Open XCTU and click the Configuration working mode button.
2.
3. Select a device from the Radio Modules list. XCTU displays the current firmware settings for
that device.
1 Set the expected transmission mode to TCPcommunication.
<Target
IPaddress>
<Target
portnumber>
The target IP address that you send and receive from. For example, a
data logging server’s IP address that you want to send
measurements to.
The target port number that the device sends the transmission to.
This is represented as a hexadecimal value.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
23
Getting started with the XBee Cellular Modem Development Kit XBee Cellular Modem examples
On the Configuration toolbar, click the Default button to load the default values
4.
established by the firmware, and click Yes to confirm.
5. Factory settings are loaded but not written to the device. To write them, click the Write button
on the toolbar.
In the IP field, select 1 and click the Write button .
6.
7. In the DL field, type the <target IP address> and click the Write button. The target IP address
is the IPaddress that you send and receive from.
8. In the DE field, type the <target port number>, converted to hexadecimal, and click the Write
button.
9. Exit Command mode; see Exit Command mode.
After exiting Command mode, any UART data sent to the device is sent to the destination IP address
and port number after the RO (Packetization Timeout) occurs.
Perform a (GET) HTTP request
You can use the XBee Cellular Modem to perform a GET Hypertext Transfer Protocol (HTTP) request
using XCTU. This example uses http://httpbin.org/ (IP address: 54.175.219.8) as the target website
that responds to the HTTP request.
To perform a GETrequest:
1. Ensure that the device is set up correctly with the SIM card installed and the antennas
connected as described in Connect the hardware.
Open XCTU and click the Configuration working mode button.
2.
3. Select a device from the Radio Modules list. XCTU displays the current firmware settings for
that device.
4. To enter the destination address of the target website, in the DL field, type 54.175.219.8 and
click the Write button .
5. To enter the HTTP request port number, in the DE field, type 50 and click the Write button.
Hexadecimal 50 is 80 in decimal.
6. To switch to TCP communication, in the IP field, select 1 and click the Write button.
7. To move into Transparent mode, in the APfield, select 0 and click the Write button.
8. Wait for the AI (Association Indication) value to change to 0 (Connected to the Internet).
Click the Consoles working mode button on the toolbar.
9.
From the AT console, click the Add new packet button in the Send packets dialog. The
10.
Add new packet dialog appears.
11. Enter the name of the data packet.
12. Type the following data in the ASCII input tab:
GET /ip HTTP/1.1
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
24
Getting started with the XBee Cellular Modem Development
Kit
Host: httpbin.org
13. Click the HEX input tab and add 0A (zero A) after each 0D (zero D), and add an additional 0D 0A
at the end of the message body. For example, copy and past the following text into the HEX
input tab:
47 45 54 20 2F 69 70 20 48 54 54 50 2F 31 2E 31 0D 0A 48 6F 73 74 3A 20 68 74 74 70 62 69 6E
2E 6F 72 67 0D 0A 0D 0A
Note The HTTP protocol requires an empty line (a line with nothing preceding the CRLF) to terminate
the request.
14. Click Add packet.
Click the Open button .
15.
16. Click Send selected packet.
17. A GETHTTP response from httpbin.org appears in the Console log.
Configure the XBee Cellular Modem using Device
Configure the XBee Cellular Modem using Device Cloud
Cloud
Create a Device Cloud account
Digi Device Cloud is an on-demand service with no infrastructure requirements. Remote devices and
enterprise business applications connect to Device Cloud through standards-based web services. This
section describes how to configure and manage an XBee using Device Cloud. For detailed information
on using Device Cloud, refer to the Device Cloud User Guide, available via the Documentation tab in
Device Cloud.
Before you can manage an XBee with Device Cloud, you must create a Device Cloud account. To create
a Device Cloud account:
1. Go to www.digi.com/cloud/digi-device-cloud.
2. Click Free Developer Account.
3. Follow the online instructions to complete account registration. You can upgrade your
Developer account to a paid account at any time.
When you are ready to deploy multiple XBee Cellular Modems in the field, upgrade your account to
access additional Device Cloud features.
Get the XBee Cellular Modem IMEI number
Before adding an XBee to your Device Cloud account inventory, you need to determine the
International Mobile Equipment Identity (IMEI) number for the device. Use XCTUto view the IMEI
number by querying the IM parameter.
Add a Digi XBee to Device Cloud
To add an XBee to your Device Cloud account inventory, follow these steps:
Go to devicecloud.digi.com.
1. Log in to your account
2. Click Device Management > Devices.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
25
Getting started with the XBee Cellular Modem Development
Kit
3. Click Add Devices. The Add Devices dialog appears.
You can use the Discover button to discover an XBee device if the XBee is connected to your
local network.
4. Select IMEI#, and type or paste the IMEI number of the XBee you want to add. The IM
(IMEI)command provides this number.
5. Click Add to add the device. The XBee is added to your inventory.
Configure the XBee Cellular Modem using Device
Cloud
6. Click OK to close the Add Devices dialog and return to the Devices view.
Update the firmware
XBee Cellular Modem supports Device Cloud firmware updates. To perform a firmware update, use
the following steps.
1. Download the updated firmware file for your device from Digi's support site. This is a zip file
containing .ebin and .mxi files for import.
2. Unzip the file.
3. In your Device Cloud account, click Device Management > Devices.
4. Select the first device you want to update.
5. To select multiple devices (must be of the same type), press the Control key and select
additional devices.
6. Click More in the Devices toolbar and select Update Firmware from the Update category of
the More menu. The Update Firmware dialog appears.
7. Click Browse to select the .ebin file that you unzipped earlier.
8. Click Update Firmware. The updated devices automatically reboot when the updates are
complete.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
26
Technical specifications
Interface and hardware specifications 28
RF characteristics 28
Networking and carrier 28
Power requirements 28
Power consumption 29
Electrical specifications 29
Regulatory approvals 30
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
27
Technical specifications Interface and hardware specifications
Interface and hardware specifications
The following table provides the interface and hardware specifications for the device.
Specification Value
Dimensions 2.438 x 3.294 cm (0.960 x 1.297 in)
Weight 5 g (0.18 oz)
Operating temperature -40 to +80 °C
Antenna connector U.FL for primary and secondary antennas
Digital I/O 13 I/O lines
ADC 4 10-bit analog inputs
RF characteristics
The following table provides the RF characteristics for the device.
Specification Value
Modulation LTE/4G – QPSK, 16 QAM
Transmit power 23 dBm
Receive sensitivity -102 dBm
Over-the-air maximum data rate 10 Mb/s
Data throughput TBD
Networking and carrier
The following table provides the networking and carrier specifications for the device.
Specification Value
Addressing options TCP/IPand SMS
Carrier and technology Verizon 4G LTE Cat 1
Supported bands 4 and 13
Security SSL/TLS
Power requirements
The following table provides the power requirements for the device.
Digi XBee Cellular LTE Cat 1 Embedded Modem User Guide
28
Loading...