Skip to content
Pigpen edited this page Aug 17, 2022 · 26 revisions

CatWAN USB Stick

Welcome to the CatWAN USB Stick Wiki!

Revision v0.1

Electronic Cats ® 2022

If you have a CATWAN-USBStick, you have a tool capable of viewing the traffic between two or more LoRa radio nodes and also, the ability to monitor LoRaWAN data packets, which will help you in troubleshooting while developing your applications using LoRa technology.

Thus CATWAN-USBStick becomes a debugging tool, a probe at the hardware level, as is the logic analyzer, the oscilloscope and or the JTAG. Non-intrusiveness is the characteristic or quality of a debugger that allows the software/hardware system to function normally as if the debugger did not exist. In this way, device communications can be monitored without changing the software that performs the communications.

The CATWAN-USBStick has a LoRa RFM95 radio chip.

LoRa Sniffer Tool

CLI

If we type help in the serial terminal we can see the commands that the LoRa Sniffer tool has:

Fw version: 0.2v

Configuration commands:

set_rx
set_tx
set_tx_hex
set_tx_ascii
set_chann
set_freq
set_sf
set_bw
set_cr

Monitor commands:

get_freq
get_sf
get_bw
get_cr
get_config

..help

Usage

set_rx -> LoRa Sniffer goes into rx mode and changes rx_status to 1 if the frequency value is between 902 MHz and 923 MHz, it can accept the frequency value as an argument.

set_freq -> Sets the frequency between 902 MHz and 923 MHz.

set_sf -> Sets the spread factor value between 6 and 12.

set_cr -> Sets the coding rate value between 5 and 8.

set_bw -> Sets the bandwidth value using 0 - 8.

      0 - Bandwidth set to 7.8 kHz
      1 - Bandwidth set to 10.4 kHz
      2 - Bandwidth set to 15.6 kHz
      3 - Bandwidth set to 20.8 kHz
      4 - Bandwidth set to 31.25 kHz
      5 - Bandwidth set to 41.7 kHz
      6 - Bandwidth set to 62.5 kHz
      7 - Bandwidth set to 125 kHz
      8 - Bandwidth set to 250 kHz

set_tx - > Use xxx. The value xxx represents a 3-digit number.

set_tx_hex -> Use 0xyy. The value yy represents any pair of hexadecimal digits.

set_tx_ascii -> Use for send ASCII message.

set_chann -> Sets the LoRaWAN channel value between 0 and 63.

Example

input->

set_freq 903.9
set_sf 8
set_cr 5
set_rx 

output->

Frequency set to 903.90 MHz
Spreading factor set to 8
CodingRate set to 4/5
LoRa radio receiving at 903.90 MHz

Received packet ' 19 bytes ' 401F80C0ED000305018BB696B5827DFEA36D33 ASCII: '@⸮&⸮⸮⸮⸮⸮}⸮⸮m3' with RSSI -81

Received packet ' 19 bytes ' 401F80C0ED00070501D8FF1D53C1976AAEEF71 ASCII: '@⸮&⸮⸮S⸮⸮j⸮⸮⸮q' with RSSI -122