Communicate via AX.25, using an AGWPE-compatible TNC (e.g. Direwolf, SoundModem or AGWPE).
To get started, navigate to your package and run:
npm install @jmkristian/node-agwpe
The programming interface is similar to node Net. For example, connect to another station:
const AGWPE = require('@jmkristian/node-agwpe');
const connection = AGWPE.createConnection ({
remoteAddress: 'their call sign',
localAddress: 'your call sign',
localPort: 0, // TNC port (sound card). default: 0
host: 'TNC-server-host', // TNC's TCP host. default: 127.0.0.1
port: 8000, // TNC's TCP port. default: 8000
}, function connectListener() {
connection.write(...); // transmit data
connection.pipe(...); // receive data
});
connection.on('error', function(err) {console.log('Uh oh! ' + err);})
Listen for incoming connections:
const AGWPE = require('@jmkristian/node-agwpe');
const Bunyan = require('bunyan');
var server = new AGWPE.Server ({
host: 'tnc-server-host', // TNC's TCP host. default: 127.0.0.1
port: 8000, // TNC's TCP port. default: 8000
logger: Bunyan.createLogger({name: "AGWPE"}), /* default: no logging
An object compatible with the Bunyan logger interface, or null. */
});
server.on('connection', function(connection) {
console.log('connection'
+ ' from ' + connection.remoteAddress
+ ' to ' + connection.localAddress);
connection.write(...); // transmit data
connection.pipe(...); // receive data
});
server.listen({
host: ['A1CALL-1', 'B2CALL-10'], // This server's call signs.
port: [0, 1], // TNC ports to listen to. Default: all ports
},
function onListening(info) { // called when the server begins listening
console.log('TNC listening %o', info);
});
Monitor all received packets or send any packet:
var socket = server.createSocket({
recvBufferSize: 8, // The default is 16 packets
sendBufferSize: 3, // The default is 16 packets
});
socket.on('error', function(err) {
console.log('bind failed ' + err);
}
socket.bind(function success() {
socket.pipe(...);
socket.write({
port: 0,
type: 'UI',
toAddress: 'ID',
fromAddress: 'TAC',
info: Buffer.from('A1CALL'),
});
});
This is somewhat similar to dgram sockets. Unlike dgram, a socket is a duplex stream operating in object mode. Each object in the stream represents a packet, with various possible fields:
{
port: 0, // TNC port (usually identifies a sound card)
type: 'UI', // or 'I', 'SABM', 'RR' etc.
toAddress: 'A6CALL', // the call sign of the intended receiver
fromAddress: 'N0CALL', // the call sign of the sender
via: ['DIGIA*', 'DIGIB*', 'DIGIC'], // digipeater call signs
info: Buffer.from([0x56, 0x23, ...]), // data in an I or UI packet
NS: 7, // N(S) sequence number of this packet
NR: 3, // N(R) acknowledges a previous packet
PID: 2, // protocol ID
command: true,
response: true,
P: true, // poll
F: true, // final
}
Most of these fields are optional. Many combinations are invalid.
In the via
array, call signs with an asterisk at the end represent
digipeaters that retransmitted the packet.
Every packet the TNC receives on any port will appear in the Readable stream, regardless of whether the server is listening for them. Packets transmitted by this TNC don't appear in the Readable stream.
Received packets may be discarded if nobody reads from the socket or pipes it to something. (The flow of received packets can't be controlled.) Transmission is flow controlled: a pipeline might stop flowing or writers might see slow callbacks, if packets are offered faster than the TNC can transmit them. Written packets might be discarded if a writer doesn't wait for callbacks.
This package requires node.js version 8.17.0 or later. It works on Windows 8 and Ubuntu 20, with Direwolf version 1.7 and UZ7HO SoundModem version 1.13. It might work with other versions or on Mac.