[−][src]Crate ax25

Utilities for Packet Radio in Rust.

This crate aims to provide everything you need to write cross-platform packet radio software in Rust.

Main features:

  • Encode and decode AX.25 frames (currently supporting v2.0)
  • KISS protocol
  • Connect to TNCs via multiple methods without needing to change your code

Most developers will want to focus on tnc::TncAddress and tnc::Tnc.

  1. Generate or ask the user to supply an address string. This takes the form:
    tnc:tcpkiss:192.168.0.1:8001 or
    tnc:linuxif:vk7ntk-2
  2. Parse this to an address: let addr = string.parse::<TncAddress>()?;
  3. Attempt to open the TNC: let tnc = Tnc::open(&addr)?;
  4. Use send_frame() and receive_frame() to communicate on the radio.
  5. The Tnc can be cloned for multithreaded use.

If your application requires encoding/decoding AX.25 data directly, see the frame module.

Several sample programs are provided in the source code repository under /examples.

Modules

frame

Encoding and decoding AX.25 v2.0 frames between raw bytes and strongly typed structures.

tnc

Connect to a TNC and use it to send and receive frames.