mirrors/mayhem-firmware
1
0
Fork 0
mirror of https://github.com/portapack-mayhem/mayhem-firmware.git synced 2026-03-29 09:53:24 +01:00
Code Issues Projects Releases Packages Wiki Activity
Page: KISS TNC
Pages
2048 3d printed enclosure ACARS (Aircraft Communications Addressing and Reporting System) ACARS ADS B(S) AFSK AIS Boats APRS RX APRS TX About firmwares Access Radio Hardware Add GPIO to H2 Adult Toys Analog TV Receiver Antennas Applications At first glance Audio Receivers Automatic dependent surveillance–broadcast (ADS B) BHT BLESpam Battleship Bitmap reverse decode Blackjack Bluetooth Low Energy Receiver Bluetooth Low Energy Transmitter Boot Process Breakout Burger Pager C16 format CVS Spam Calculator Capture Care Cart Lock ChibiOS Notes Clifford's version Code contribution rules Code formatting Compile firmware Compile on Arch based distro (exclude Asahi) Compile on WSL with ninja Completely reset Config Menu Contributing Guidelines Contributors Create a Custom Map with Offline Map Maker Create a Simple App Create a custom splash screen Create a custom splash screenhome Create a simple external app Creating a prod stable release DFU overlay Dead Coin Cell Battery Debug via SWD & JTAG Debug with serial Debug Decoder for NRF24L01 Description of the Structure Detector Dev build versions Diagnose firmware update in Windows Differences Between H1 and H2 models Digital Rain Dino Game Dissecting the Temperature logger Documentation Standards & Guidelines Doom EPIRB RX (Emergency Position‐Indicating Radio Beacon Receiver) EPIRB RX EPIRB TX ERT Encoder External App Roadmap External apps informations FAQ FPV Detect Factory Defaults Features File manager Firmware Architecture First steps Flash Mayhem onto bare HackRF Flash Utility Flex RX FlipperTX Fox Hunt Freq manager Freqman manager Full reset GPS Sim GSG hackrf GUI Widget Preview Games General Compiling Guide (Linux) H2 Enclosure H2 Plus speaker modifications HackRF Pro HackRF Hardware overview Help! Im not receiving anything! Receive Quality Issues Home Hopper How to Format SDCard How to ask questions in correct way How to collaborate How to compile faster with WSL 2 I2C external device driver integration IQ trim Information on APRS Intended Use and Legality Internal speaker Interpret Guru meditation crashes Jammer KISS TNC KeeLoq TX Key fob TX Keyboard view LCR LGE Tool Level Looking Glass MDC TX MDC 1200 TX Main Controls Main Menu Maintaining rules Make airlines db Make icao24 db Metronome Microphone Tranceiver Microphone Transceiver Morse P Morse RX Morse TX NOAA No TX or RX Notepad Notes About ccache OOK Brute OOK Editor OOK Original GSG HackRF One P25 Tx POCSAG Receiver POCSAG Tx PR process Pac‐Man Persistent Memory Playlist Editor Playlist PortaPack Versions Powering the PortaPack Preamplifier IC replacement ProtoView Push buttons and button caps RDS RTTY RX RTTY TX Radio Radiosonde Random password Receivers Recon Redirections Remote Replay SAME TX SD Card (DEV) SD Card Content SD Over USB SD card not recognized by PC with the SD card over USB selected SMA connector replacement or removal SSTV RX SSTV Scanner Screenshots Search Settings Signal Generator Sleep mode Snake Software Dev Guides Soundboard Space Invaders Spectrum Painter Splash and other images Stealth Mode Stopwatch SubCar SubGhzD TPMS RX TPMS TX TX Carrier Only Tetris Text Entry Theme system Time Sink Title Bar TouchTunes Transceivers Transmitters Troubleshooting Tuner UI Screenshots UI positioning with macros USB Serial Console USB‐C charging modification for older HackRF boards Unit Tests Update firmware for more detailed information Update firmware troubleshooting Update firmware Updating the Xilinx CPLD on hackrf board Usage cautions User interface Using MAC OS Utilities WardriveMap Waterfall Designer Wav viewer Weather WeatherFax Web USB Serial What if I don't like some of the apps Widgets Wipe SD Card Won't boot Won Wont boot Work Needed World map generation gfxEQ imagemagick.org waterfalls color schemes
3 KISS TNC
Speedster04 edited this page 2026-03-24 20:27:40 +01:00
Table of Contents

The KISS TNC app turns the PortaPack into a bidirectional KISS TNC (Terminal Node Controller) over the USB serial port. It receives APRS/AX.25 packets from radio and forwards them to a connected PC as KISS frames, and transmits KISS frames received from the PC over radio as AFSK 1200 baud AX.25.

What is KISS TNC?

KISS (Keep It Simple, Stupid) is a protocol that allows a PC application to send and receive AX.25 packet radio frames through a TNC over a serial connection. With this app, the PortaPack acts as the TNC, and the USB serial port is the link to the host PC. Any APRS or packet radio software that supports a serial KISS TNC can be used — for example Direwolf (as a client), APRSISCE/32, APRSdroid, or custom scripts.

Controls

Field Description
Frequency RX/TX frequency. Default: 144.390 MHz (APRS standard)
RF Amp RF amplifier on/off
LNA LNA gain
VGA VGA gain
RSSI Signal strength indicator
USB Shows Connected or Disconnected — whether the PC has opened the USB serial port
RX Count of AX.25 packets received from radio and forwarded to the PC
TX Count of frames received from the PC and transmitted over radio
Console Live log of received packets, shown as SOURCE>DESTINATION

The status line at the top toggles between Listening (RX active) and Transmitting (TX in progress).

Connecting a PC

Connect the PortaPack to the PC via USB. The USB serial port appears as a standard CDC serial device. Open it in your packet radio software and configure it as a KISS TNC at any baud rate (the USB CDC connection is not baud-rate limited).

Note

On Linux the device typically appears as /dev/ttyACM0. On Windows it appears as a COM port. No driver installation is needed on Linux or macOS; Windows may require the standard CDC driver.

Operation

  • RX: The app continuously listens on the configured frequency. When a valid AX.25 packet is decoded, it is wrapped in a KISS frame and sent to the PC over USB serial. The RX counter increments and the packet's source and destination callsigns appear in the console.
  • TX: When the PC sends a KISS data frame (command byte 0x00) over USB serial, the app switches to transmit mode, sends the AX.25 frame as AFSK 1200 baud Bell 202, then automatically returns to RX mode. The TX counter increments for each transmitted frame.

Warning

The maximum transmittable frame payload is 200 bytes. Frames larger than this are silently discarded.

Technical details

Parameter Value
Modulation AFSK Bell 202
Baud rate 1200 baud
Mark / Space 1200 Hz / 2200 Hz
Default frequency 144.390 MHz
Max TX frame size 200 bytes
KISS framing Standard KISS (0xC0 FEND, 0xDB FESC escaping)
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Start here

Contributors

How to collaborate
Contributing Guidelines
How to ask questions correctly

Hardware

User manual

Intended use and Legality

Applications

Misc

Developer Manual

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Note

The wiki is incomplete. Please add content and collaborate.

Important

  • This is a public wiki. Everything is visible to everyone. Don't use it for personal notes.
  • Avoid linking to external tutorials/articles; they may become outdated or contain false information.