KISS TNC Bridge
Updated:
Share one KISS TNC with many apps over Bluetooth LE and TCP.
KISS TNC Bridge comes in two forms:
- The Linux daemon,
kiss-tnc-bridge, runs on a Raspberry Pi or any other Linux computer. It shares one KISS TNC (the TNC in your radio over Bluetooth or USB, a serial TNC, or a software TNC like Dire Wolf) with any number of KISS TNC apps, over Bluetooth LE and TCP. - The ATOM Lite is a pocket-sized bridge between a radio's Bluetooth Classic TNC, like the one in the Kenwood TH-D75, and the KISS TNC apps on your phone, over Bluetooth LE. Install the firmware from your browser in a few minutes.
Both are free and open source, on GitHub. Announcing kiss-tnc-bridge explains why the project exists.
Vocabulary
These words mean the same thing everywhere in the KISS TNC Bridge project.
- Bridge
- A running KISS TNC Bridge, which shares a TNC with your apps. An ATOM Lite is one bridge. The Linux daemon can run several on one computer, each with its own TNC and name.
- Pair
- Introduce a radio to a bridge over Bluetooth Classic. Once paired, they connect automatically.
- Connect
- Create a link to or from a bridge. Connections can be made from the bridge to a radio, from a KISS TNC app to the bridge, or from a management app to a bridge.
- KISS TNC app
- Any application that can communicate with a TNC using the KISS protocol to do cool radio stuff.
It could be an APRS app on your phone, or a winlink app on your computer. A bridge makes more
TNCs useful to more KISS TNC apps. Sometimes we call these apps
clients. - Management app
- A program that changes a bridge's settings and shows its status. It's separate from the program that
runs the bridge.
ktbctlis the management app today. An iOS app is coming. - Give a management app permission to manage a bridge, once, with the bridge's authorization
code while it's in authorization mode. From then on the app can manage the bridge any time.
Revoke takes the permission away.
ktbctlon the computer running the Linux daemon, or connected to an ATOM Lite by USB, is authorized without the code. - The secret, 16 characters or a QR code, that authorizes a management app. Each ATOM Lite has its own, shown when you install the firmware. Keep it: you'll want it for each new management app. It stays the same until you change it or do a clean install.
- A few minutes when a bridge accepts one new management app. The bridge keeps working the whole time. On an ATOM Lite, hold the top button for 3 seconds: the light blinks magenta for up to 5 minutes, until an app is authorized, or until you press the button.