https://github.com/rhodey/zombie-tnc
Working towards a highly programmable, full featured AX.25 terminal node controller.
https://github.com/rhodey/zombie-tnc
Last synced: 5 months ago
JSON representation
Working towards a highly programmable, full featured AX.25 terminal node controller.
- Host: GitHub
- URL: https://github.com/rhodey/zombie-tnc
- Owner: rhodey
- Created: 2013-08-06T01:50:41.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2013-10-09T00:20:06.000Z (over 12 years ago)
- Last Synced: 2025-10-07T00:33:48.305Z (9 months ago)
- Language: Java
- Homepage:
- Size: 383 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Zombie-TNC
==========
Just when you thought the TNC was dead and buried.
Working towards a highly programmable, full featured AX.25 terminal node
controller. Currently Zombie-TNC relies on another TNC running in KISS
mode to provice HDLC framing, radio modulation and radio demodulation.
Eventually these dependencies will hopefully be removed and Zombie-TNC
will be a standalone, platform-independant terminal node controller.
KISS TNC
---------
[KISS Spec](http://www.ka9q.net/papers/kiss.html)
```java
// Open and configure a serial port connected to a TNC in KISS mode.
SerialPort serialPort = new SerialPort("/dev/ttyS0");
serialPort.openPort();
serialPort.setParams(SerialPort.BAUDRATE_9600, SerialPort.DATABITS_8, SerialPort.STOPBITS_1, SerialPort.PARITY_NONE);
// Creating a KISSPort for High-Level Data Link Control port 0.
KISSPort kissTNC0 = new KISSPort(serialPort, 0);
// Adding a KSSDataListener to process data received by the KISSPort.
SimpleKISSDataListener kissDataListener = new SimpleKISSDataListener();
kissTNC0.addKISSDataListener(kissDataListener);
// Transmitting arbitrary data through the TNC.
kissTNC0.transmitData("ChubSat, truth prevails.".getBytes("ASCII"));
// Clean up.
kissTNC0.close();
serialPort.closePort();
```
AX.25
---------
[AX.25 Spec](http://www.tapr.org/pub_ax25.html#2.4.1.2)
```java
// Creating an AX25Port for sending and receiving AX.25 frames through a KISSPort.
AX25Port ax25Port = new AX25Port(kissTNC0);
// Adding an AX25FrameListener to process frames received by the AX25Port.
SimpleAX25FrameListener ax25FrameListener = new SimpleAX25FrameListener();
ax25Port.addFrameListener(ax25FrameListener);
/*
Creating and transmitting Unnumbered Information Frames manually...
AX25Frames default to UI Frames with source and destination SSIDs set to 0, C-bits
set to COMMAND, Control Field set to UI Frame FINAL and PID set to NO LAYER 3 PROTOCOL
implemented (as constructed below).
*/
AX25Frame uiFrame = new AX25Frame("EARTH".getBytes("ASCII"), 0, "CHBSAT".getBytes("ASCII"), 0);
uiFrame.setCommandResponseType(AX25Protocol.CommandResponseType.COMMAND);
uiFrame.setControlField(AX25Protocol.CONTROL_UIFRAME_FINAL);
uiFrame.setPIDField(AX25Protocol.PID_NO_LAYER_3_PROTOCOL);
uiFrame.setInfoField("ChubSat, have it your way.".getBytes("ASCII"));
ax25Port.sendFrame(uiFrame);
// Creating an AX25Operator to transmit and receive frames on behalf of call sign: EARTH.
SimpleAX25Operator earthOperator = new SimpleAX25Operator(ax25Port, "EARTH".getBytes("ASCII"));
earthOperator.sendUnnumberedInformation("CHBSAT".getBytes("ASCII"), "ChubSat, like tears in the rain.".getBytes("ASCII"));
earthOperator.sendUnnumberedInformation("EARTH".getBytes("ASCII"), "Hello Earth, this is Earth.".getBytes("ASCII"));
// Creating an AX25SecondaryStation to transmit and receive frames on behalf of Operator: EARTH, SSID: 4.
SimpleAX25SecondaryStation secondaryStation = new SimpleAX25SecondaryStation(4);
earthOperator.addSecondaryStation(secondaryStation);
secondaryStation.sendUnnumberedInformation("CHBSAT".getBytes("ASCII"), "Hello CHBSAT SSID default, this is EARTH SSID 4.".getBytes("ASCII"));
secondaryStation.sendUnnumberedInformation("CHBSAT".getBytes("ASCII"), 4, "Hello CHBSAT SSID 4, this is EARTH SSID 4.".getBytes("ASCII"));
// Clean up.
earthOperator.removeSecondaryStation(secondaryStation);
earthOperator.quit();
ax25Port.removeFrameListener(ax25FrameListener);
ax25Port.close();
```
HDLC
---------
[High-Level Data Link Control](https://en.wikipedia.org/wiki/High-Level_Data_Link_Control)
is not yet implemented.