Digi XBee 3 User Manual

Modes USB direct mode
Digi XBee® 3 Cellular LTE Cat 1 AT&T Smart Modem User Guide
136
Configure and use PPP with a Digi XBee 3 Cellular CAT1 AT&T
modem
Your XBee 3 Cellular device can communicate directly with the modem and can drop into PPPmode.
Prerequisites
n A working SIM card to get onto the network.
n Knowledge of the APN for the given network and SIM.
n A Linux distribution with pppd/chat.
Step 1: Configure the device for PPP
USB direct is used to gain access to the underlying modem, which enables the use of PPP.
1. Set up USB direct mode.
2. Issue the WRcommand to save the settings.
Once USB direct is configured, an additional USB device should be attached to the Linux machine. In
order to have a consistent device name on the Linux machine, you should set up a udev rule for the
device, as described in the next step.
Step 2: Set up the USBdevice for use with PPP
A udev rule is needed to give the USB connection a constant name using a symlink.
1. Make sure that the modem is plugged in.
2. Place the following ppp-setup.rules file here: /etc/udev/rules.d
# LE866A1-NA rule
SUBSYSTEM=="tty", ATTRS{bInterfaceNumber}=="02", ENV{ID_VENDOR_ID}=="1BC7",
ENV{ID_MODEL_ID}=="2300", SYMLINK+="ppp_direct_usb"
3. You must run the two commands shown below to restart the udev daemon to apply the new
rule.
sudo udevadm control --reload-rules
sudo udevadm trigger
4. Verify that the new device has been created: /dev/ppp_direct_usb. If was not, make sure the
modem is plugged in and then repeat this process.
Step 3: Configure PPPD
PPPD by default looks in the /etc/ppp/ directory for an options file and a chat script. The option file
configures and specifies the chat script for PPPD. The chat script configures and dials the modem for
the PPP connection.
1. Below is an example of an options file. This file must be in the /etc/ppp/ directory.
## Show debug info
debug
## Modem serial port
/dev/ppp_direct_usb

Digi XBee 3 Specifications

General

Model	XBee 3
Category	Modem
Frequency Bands	2.4 GHz, 868 MHz, 900 MHz
Interface	UART, SPI, I2C
Operating Temperature	-40° C to +85° C
Power Supply	2.1V to 3.6V
Antenna	External or onboard
Transmit Power	up to 20 dBm
Security	AES encryption
Protocols	Zigbee, 802.15.4, DigiMesh

Summary

Getting Started with the XBee Smart Modem

Connect Hardware and Install XCTU

Step-by-step instructions for connecting hardware and installing XCTU utility.

Update Firmware and Check Connection

Procedures for updating device firmware and verifying cellular connection status.

XBee Connection Examples

Getting Started with MicroPython

MicroPython Basics and Setup

Introduction to MicroPython and setting up the environment using XCTU.

MicroPython Examples

Update the Firmware

Plan for Firmware Updates

Update Device and Cellular Firmware

Procedures for updating device and cellular firmware using XCTU.

Update Telit Modem Firmware with XFP Utility

Instructions for updating the Telit modem firmware using the XFP utility.

AT Commands Reference

Special, Cellular, and Network Commands

Reference for special, cellular, and network configuration AT commands.

I/O, Sleep, and Mode Commands

Configuration commands for I/O settings, sleep modes, and operating modes.

File System, BLE, Socket, and API Commands

Commands for file system, BLE, sockets, and API frame management.

Troubleshooting Guide

Serial Port and Driver Issues

macOS Java Errors and Bypass Mode Issues

Network, SMS, and Baud Rate Troubleshooting