LoRa® Packet Logger

The LoRa® Packet Logger extension records and manages all uplink and downlink LoRa packets with configurable retention periods and health monitoring. It provides a reliable local data source for network analysis, performance monitoring, and troubleshooting.

NOTE

This extension is only compatible with WisGateOS 2 2.2.15 and later.

Install the LoRa® Packet Logger Extension

To install this extension, follow Add an Extension.

Configure the LoRa® Packet Logger Extension

1. To access the LoRa® Packet Logger extension, click Launch.

Figure 1: Extensions tab

2. In Storage Duration, select how long to keep the LoRa logs. The configuration saves automatically after selection.

Figure 1: Set storage duration

• OFF

• 7 Days

• 15 Days

• 30 Days

3. When the status shows Currently recording packet logs to CSV file, the logger is active. Log files will appear under Log File Management, named as lora-packets-YYYY-MM-DD.csv.

Figure 1: Recoding Packet Logs

Manage Packet Logs

1. In Log File Management, check the box log files to select them.

Figure 1: Manage Packet Logs

2. Click Download to save the selected files to your local device, or Delete to remove them from the gateway.

NOTE

To download or delete a single file, click the corresponding or icon under the Actions column.

Viewing CSV Files

Open the downloaded CSV file to view the recorded packet logs.

Figure 1: Check Logs

The downloaded CSV file contains the following columns:

Field Name	Description
Time	Local time when the packet was received or transmitted by the gateway.
FType	Frame type and direction.
Freq	Center frequency (MHz) at which the packet was transmitted or received.
RSSI	Received Signal Strength Indicator (dBm); values closer to 0 indicate stronger signals.
SNR	Signal-to-Noise Ratio (dB), reflecting signal quality.
TxPwr	Transmit power (dBm); - means not recorded for uplink packets.
CRC	CRC check result (CRC_OK means passed, UNKNOWN means no CRC or undetectable).
Mod	Modulation type, e.g., LORA for LoRa modulation.
CR	Coding rate, e.g., CR_4/5.
DataRate	Data rate, e.g., SF10BW125 means spreading factor SF10 and bandwidth 125 kHz.
FCnt	Frame counter.
AirTime	Airtime (ms), the duration the packet occupies the radio channel.
DevAddr	LoRaWAN device address (hexadecimal).
FPort	LoRaWAN port number.
Size	Payload size in bytes.
MacCmd	MAC command(s), if present.
Data	Payload in Base64 encoding.