Skip to main content

SCTools

The sctools utility program is used to test sending and receiving packets and to download SMCU firmware. sctools is built as part of the pkt-forwarder project. You will need to load sctools onto your Gateway hardware (I.E. Raspberry Pi) and then run it via command line.

Download Firmware​

Firmware can be downloaded via the UART on the mPCIe connector. The bootloader uses XMODEM transfer. sctools can perform the download easly with the following command.

 $ sctools download -f app.bin_signed -s /dev/serial0 -r 17

The reset pin is pin 22 of the mPCIe connector. Your platform will need to connect the reset pin to a GPIO. When using a Raspberry Pi and RAK2287/RAK5146 Pi HAT, the reset pin is 17.

Receive Test​

Put the Concentrator Card into continus receive mode and prints info about every packet received.

 $ sctools rx --config conf.json.kompressor.US915.SPI 
----- 2023-05-08T00:54:07.495909+00:00 packet: 747d1476 -----
freq: 904900391
datr: SF7BW125
snr : 1350
tmst: 1561313651
rssi_sig (raw): 172
rssi_sig (dBm): -43.4
rssi_chn (raw): 172
gps time: 2023-05-08T00:54:25.210954959Z
gps_pos : [43.5434116, -72.3927785]
data: AG5fb9qT+YFgoWmSZYf5gWDA6H4nJZQ

----- 2023-05-08T00:54:07.673058+00:00 sig packet: 747d1476 -----
sig: EpljJAeaxTU2GAxN8XcRnjRycklrYmIiQXzW8aYhD22ik3/SjPPVSWSGE+Gd84VVnqAj+G8WzClDsp3xE05BAQ
verify: true

Transmit Test​

Test sending packets

$ ./sctools tx -f 915.2 -d SF7BW125 --config conf.json.kompressor.US915.SPI
Sending 915.2MHz SF7BW125 10dBm
sent