This project aims to provide everything you need to write cross-platform packet radio software in Rust.
The crate ax25 provides:
no_std environmentsThe crate ax25_tnc provides:
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.
This following is one of the included example programs, listen.rs. It is a poor
imitation of axlisten.
```rust use ax25_tnc::tnc::{Tnc, TncAddress}; use std::env; use time::OffsetDateTime;
fn main() -> Result<(), Box
let addr = args[1].parse::<TncAddress>()?;
let tnc = Tnc::open(&addr)?;
let receiver = tnc.incoming();
while let Ok(frame) = receiver.recv().unwrap() {
println!("{}", OffsetDateTime::now_utc());
println!("{}", frame);
}
Ok(())
} ```
It produces output like the following. Note that it must be run with sudo when
using the Linux interface.
$ sudo ./target/debug/examples/listen tnc:linuxif:vk7ntk-2
2020-02-02 21:51:11.017220715 +11:00
Source VK7NTK-1
Destination IDENT
Data "hello this is a test"
The above is the Display implementation for Ax25Frame - full protocol information
is available through its fields which are not printed here.
Planned features:
kissattach