KISSLoRaTNC

KO | EN

gitlite — search

#javascript #typescript #android #machine-learning #linux #docker #macos #java #cli #vue #pytorch #ios #mcp #open-source

(★ 34)

Arduino based LoRa KISS TNC

KISSLoRaTNC Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# KISSLoRaTNC

[![GPLv3 License](https://img.shields.io/badge/License-GPL%20v3-yellow.svg)](https://opensource.org/licenses/)
[![Build Status](https://travis-ci.org/kc1awv/KISSLoRaTNC.svg?branch=master)](https://travis-ci.org/kc1awv/KISSLoRaTNC)

[![GitHub issues](https://img.shields.io/github/issues/kc1awv/KISSLoRaTNC)](https://github.com/kc1awv/KISSLoRaTNC/issues)
[![GitHub forks](https://img.shields.io/github/forks/kc1awv/KISSLoRaTNC)](https://github.com/kc1awv/KISSLoRaTNC/network)
[![GitHub stars](https://img.shields.io/github/stars/kc1awv/KISSLoRaTNC)](https://github.com/kc1awv/KISSLoRaTNC/stargazers)
![GitHub last commit](https://img.shields.io/github/last-commit/kc1awv/KISSLoRaTNC)

## Arduino based LoRa KISS TNC

Currently, build is failing for MoteinoMEGA boards due to an out-of-date pin definition in platformio. See [issue #199 in platform/atmelavr](https://github.com/platformio/platform-atmelavr/issues/199)

To fix locally, go to ~/.platformio/packages/framework-arduino-avr/variants/moteinomega/pins_arduino.h

Add in this line at line #72:

#define digitalPinToInterrupt(p) ((p) == 10? 0: (p) == 11? 1: (p) == 2? 2: NOT_AN_INTERRUPT)
    
Uncomment the last block in platformio.ini and then build again.

---

KISSLoRaTNC is a work derived from code written by [Sandeep Mistry](https://github.com/sandeepmistry/arduino-LoRa) and [Mark Qvist](https://github.com/markqvist)

This code was developed using [VSCode](https://code.visualstudio.com/) and [Platformio](https://platformio.org/).

KISSLoRaTNC is developed for the:
- Arduino Uno, using the [HamShield: LoRa Edition](https://inductivetwig.com/products/hamshield-lora-edition-high-power)
- Arduino Micro, using the [Adafruit RFM96W LoRa Radio Breakout](https://www.adafruit.com/product/3073)
- [MoteinoMEGA-USB with the RFM96 Transceiver](https://lowpowerlab.com/shop/product/138)
- Arduino Nano, using the [Adafruit RFM96W LoRa Radio Breakout](https://www.adafruit.com/product/3073)
- [Heltec WiFi LoRa 32 (V2)](https://heltec.org/project/wifi-lora-32/) Note: should work with
other ESP32 LoRa boards that use the same SPI pins

The Config.h file contains the pinouts for the different Arduino-based boards. These pinouts are specific to the microcontroller board and LoRa device pairings in the list above. If you decide to use a different pairing, please adjust Config.h accordingly. Also, please remember that the power output should also be adjusted, as the RFM96W has a max Tx Power value of 20dBm. The HamShield: LoRa Edition 440MHz can be set to 30dBm (1 watt).

"Default" settings are:
- Frequency: 434.450 MHz
- Spreading Factor: 8
- Coding Rate: 7
- Signal Bandwidth: 125 kHz
- Tx Power: 20 (can be set to 30 for HamShield)
- Serial: 38400, 8N1

Basically, after checking the Config.h file for correctness, build and upload to your Arduino-based board.

The KISS SetHardware (0x06) command supports the follow options (PC to TNC):
| Option | Data | Description |
| --- | --- | --- |
| 0x22 | uint8_t | LoRa Spreading Factor (6 - 12) |
| 0x23 | uint8_t | LoRa Coding Rate (5 - 8) |
| 0x24 | uint32_t | LoRa Bandwidth (MSB first) |
| 0x25 | uint8_t | Transmit Power (0 - 20 dBm) |
| 0x26 | uint32_t | Frequency (MSB first) |
| 0x27 | none | Save hardware parameters in EEPROM |
| 0x28 | none | Restore hardware parameters from EEPROM |

The following examples show what the KISS packet would be (in hex bytes):

To set a Spreading Factor of 12: 0xC0 0x06 0x22 0x0C 0xC0

To set a frequency of 433.775 MHz: 0xC0 0x06 0x25 0x19 0xDA 0xE1 0x98 0xC0

To save hardware parameters in EEPROM: 0xC0 0x06 0x27 0xC0

Note: Follow proper KISS byte escaping if FEND (0xC0) or FESC (0xDB) appear in the data

Preceding each received frame, the SNR and RSSI of the received frame is sent from the TNC to the PC
using a KISS SetHardware (0x06) command:
| Option | Data | Description |
| --- | --- | --- |
| 0x21 | int8_t | SNR (dB) |
| | int16_t | RSSI (dBm, MSB first) |

For example, for SNR of 10 dB and an RSSI of -45 dBm the packet would be (in hex bytes):
0xC0 0x06 0x21 0x0A 0xFF 0xD3 0xC0

For details on the KISS protocol, please refer to [The KISS TNC: A simple Host-to-TNC communications protocol](http://www.ax25.net/kiss.aspx)

Useful applications:
- [Xastir](https://xastir.org/index.php/Main_Page) (APRS)
- [tncattach](https://github.com/markqvist/tncattach) (Ethernet compatible kissattach replacement)
- [BPQ32](http://www.cantab.net/users/john.wiseman/Documents/index.html) (Amateur Radio BBS Application)
- [APRSDroid](https://aprsdroid.org/) (Android APRS Application)
- [APRSICCE/32](http://aprsisce.wikidot.com) (Windows APRS Application)
- [Direwolf](https://github.com/wb2osz/direwolf) (Windows and Linux Packet Modem and Tools)

KISSLoRaTNC

KISSLoRaTNC Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

KISSLoRaTNC

KISSLoRaTNC Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README