Release Notes for the Cisco LoRaWAN Gateway, Release 2.3.1
These release notes include important information about Cisco LoRaWAN Gateway Software Release 2.3.1 and the limitations, restrictions, and caveats, if any, that apply to this release.
![]() Note |
The Cisco LoRaWAN Gateway was previously named Cisco LoRaWAN Interface Module. |
![]() Note |
Currently, Actility LRR users should remain on the 2.2.0 release. The 2.3.0 release and later should be used for users who desire the new functionality described in this document. Actility ThingPark LRR version 2.6.53 is supported for IXM firmware version 2.2.0. |
Introduction
The Cisco LoRaWAN Gateway is one of the Cisco Internet of Things (IoT) extension module series. It can be connected to the Cisco 809 and 829 Industrial Integrated Services Routers (IR800 series) for virtual mode or standalone for low-power wide-area (LPWA) access and is positioned as a carrier-grade gateway for outdoor deployment, including harsh environments. It adds a ruggedized remote LoRaWAN radio modem interface to create a gateway between the Cisco Field Network Director and a partner’s LoRa network server.
![]() Note |
Currently, Cisco LoRa IXM only supports Actility Thingpark Packet Forwarder or long range relay (LRR), in production, or the Common Packet Forwarder (CPF). CPF enables LoRaWAN gateway as an open platform to operate with the open source LoRa Network Servers implementing Semtech Basic Station. |
There are two LoRaWAN gateway modes as below:
-
Virtual interface mode – IR800 series including the LoRaWAN module as a virtual interface
-
Standalone mode – The LoRaWAN module working alone as an Ethernet backhaul gateway
You can configure the LoRaWAN IXM running on virtual interface mode or standalone mode through CLI or IoT FND. For more information, see the Cisco Wireless Gateway for LoRaWAN Software Configuration Guide.
![]() Note |
The Common Packet Forwarder (CPF) feature is only supported in standalone mode. |
System Requirements
Hardware Supported
Model No. |
Description |
---|---|
IXM-LPWA-800-16-K9 |
Cisco LoRaWAN Gateway, IoT extension module series, radio spectrum from 863–870 MHz, 16 LoRa channels, IP67 |
IXM-LPWA-900-16-K9 |
Cisco LoRaWAN Gateway, IoT extension module series, radio spectrum from 902–928 MHz, 16 LoRa channels, IP67 |
Software Images
Filename |
Description |
---|---|
ixm_mdm_i_k9-2.3.1.tar.gz |
Cisco LoRaWAN Gateway OS Image Version 2.3.1 with Semtech Basic Station Release Version 2.0.5 FPGA Version 61 HAL Version 5.1.0 |
Installation of a New Software Release
For both standalone mode and virtual mode, after you upgrade the LoRaWAN gateway to Release 2.0.30, you can only downgrade to Release 2.0.20. Downgrading to releases earlier than 2.0.20 is not supported. For example, from Release 2.0.30 to Release 2.0.11, or from Release 2.0.30 to Release 2.0.10, is not supported..
To upgrade to Release2.0.x, any older versions must first be upgraded to Release 1.0.20. For example, Release 1.0.4, 1.0.5, or 1.0.6 has to be upgraded to 1.0.20 first and then upgraded to Release 2.0.x. From 2.0.x, the gateway can be upgraded to 2.3.0 and later versions.
Firmware Upgrade From Standalone Mode
![]() Note |
We assume that you have the latest FPGA v61. If you have loaded any recent release on the IXM, use the show inventory command to check the FPGA status. If the FPGA version is not 61, upgrade first with an image that has FPGA v61. Refer to the release support matrix on various FPGA version and LRR version support. |
Follow these steps to install a new software image on the standalone mode LoRaWAN Gateway:
Procedure
Step 1 |
Log into the Cisco LoRaWAN Gateway through the console port, or SSH if configured.
|
||||||||
Step 2 |
Check the current version before upgrade. Example:
|
||||||||
Step 3 |
Download the image file to the Cisco LoRaWAN Gateway from a TFTP server or from a USB device, and install the image.
Use the following command to download and install the firmware.
Example:
|
||||||||
Step 4 |
After the image is installed successfully, verify the status. Example:
|
||||||||
Step 5 |
Check the FPGA status using the following command: Example:
|
Virtual Mode Installation
![]() Note |
Before upgrading to Release 2.0.x from Release 1.0.x, make sure you have the FPGA v58 properly installed. The FPGA upgrade will be triggered once the IXM boots up with the image version 1.0.20. After 10 - 15 minutes, you can use the following command to check the FPGA version. Do not install the packet forwarder software or perform radio related configuration while the FPGA is upgrading or downgrading. |
IR829_1#show virtual-lpwa 3 modem info
Name : Virtual-LPWA 3
ModemImageVer : 2.3.1
BootloaderVer : 20180130_cisco
ModemAgentVer : 1.02
SerialNumber : FOC23126GDH
PID : IXM-LPWA-800-16-K9
UTCTime : 19:04:09.033 UTC Thu Mar 04 2022
IPv4Address : 192.168.100.2
IPv6Address : none
FPGAVersion : 61
TimeZone : PST
LocalTime : Thu Mar 4 11:04:09 PST 2022
ACT2 Authentication : PASS
ModemVersionID : V01
ProtocolVersion : 2
ChipID : LSB = 0x306b0a14 MSB = 0x00f14200
LoRaSerialNumber : FOC22433QLK
LoRaCalc : <135,122,114,106,98,94,90,86,77,69,60,52,43,39,35,31-142,130,122,114,106,102,98,94,85,77,69,60,52,48,44,40>
CalTempCelsius : 40
CalTempCodeAD9361 : 97
RSSIOffset : -202.16,-202.99
AESKey : Unknown
Follow this procedure to upgrade to Release 2.3.1:
Procedure
Step 1 |
Log in to the IR809 or IR829 system with terminal through SSH or Console. |
||||
Step 2 |
Copy the image file into IR809 or IR829 from your host, and the image will be stored in flash. Example:
|
||||
Step 3 |
(Optional) If you are upgrading from an older version to Release 1.0.20, the upgrade will result in updating the FPGA to version 61. After upgrading the image, no action should be taken while the FPGA is upgrading. You must wait until you get the upgrade status of Ready, as the following example shows. Example:
|
||||
Step 4 |
Upgrade the firmware to Release 2.3.1 using the following factory install CLI:
|
||||
Step 5 |
After the image is installed successfully, verify the status. As shown in the following output, ModemImageVer has been updated, but BootloaderVer remains the same. Example:
|
||||
Step 6 |
Upgrade the firmware to Release 2.3.1 using the same CLI with uboot or uboot-only option:
|
||||
Step 7 |
After the image is installed successfully, verify the status. You will find from the output that both ModemImageVer and BootloaderVer have been upgraded. Example:
|
Switching Between Standalone Mode and Virtual Mode
When the LoRaWAN gateway is in standalone mode, use the switchover EXEC command to switch to the virtual mode.
#switchover
You can switch the LoRaWAN gateway from virtual mode to standalone mode through IR8x9, using the following command.
IR800#virtual-lpwa 1 modem standalone mode enable
New Features In This Release
The following new features are introduced in this release:
-
IPSec tunnel traffic flow enhancements
-
CPF connection enhancements
New Commands In This Release
This section contains new commands in this release.
Standalone Mode Commands
The following table provides the new standalone mode command in this release.
Command |
Purpose |
---|---|
ipsec retry retry-count delay delay-time |
Configure number of IPsec retries and delay time (minutes) before IPsec restarts when IPsec is down:
Executed from global configuration prompt. |
Common-Packet-Forwarder (CPF) Commands
The following table provides the Common-Packet-Forwarder (CPF) profile configuration commands.
-
Type “configure terminal” at the exec prompt.
-
Type “common-packet-forwarder profile” at the global configuration prompt.
Command |
Purpose |
---|---|
tcp-user-timeout timeout |
Configure TCP user timeout option:
|
Caveats
You can use the Bug Search Tool to find information about caveats, including a description of the problems and available workarounds. The Bug Search Tool lists both open and resolved caveats.
To use the Bug Search Tool:
-
Log in with your Cisco.com user ID and password.
-
Enter information in the Search For, Product, and Releases field as needed, then press Enter.
For more information about the Bug Search Tool, click Help on the main Bug Search Tool page.
Resolved Caveats
This section contains resolved caveats for this release.
Caveat ID Number |
Description |
---|---|
Add CLI to set IPSEC retry count and delay time when ipsec tunnel is down. |
|
Connection between CPF (on IXM) and Network Server periodically drops for about 15 minutes. |
|
Invalid port range for secure reverse SSH tunnel config. |
|
Typo error in privilege exec command to switch IXM from Standalone to Virtual mode. |
Related Documentation
These documents provide detailed information about the Cisco LoRaWAN Gateway and are available at: www.cisco.com/go/lorawanmodule
Communications, Services, and Additional Information
-
To receive timely, relevant information from Cisco, sign up at Cisco Profile Manager.
-
To get the business impact you’re looking for with the technologies that matter, visit Cisco Services.
-
To submit a service request, visit Cisco Support.
-
To discover and browse secure, validated enterprise-class apps, products, solutions, and services, visit Cisco DevNet.
-
To obtain general networking, training, and certification titles, visit Cisco Press.
-
To find warranty information for a specific product or product family, access Cisco Warranty Finder.
Cisco Bug Search Tool
Cisco Bug Search Tool (BST) is a gateway to the Cisco bug-tracking system, which maintains a comprehensive list of defects and vulnerabilities in Cisco products and software. The BST provides you with detailed defect information about your products and software.
Documentation Feedback
To provide feedback about Cisco technical documentation, use the feedback form available in the right pane of every online document.