RadioLib Universal wireless communication library for Arduino

AX25.h
1 #if !defined(_RADIOLIB_AX25_H)
2 #define _RADIOLIB_AX25_H
3
4 #include "../../TypeDef.h"
5
6 #if !RADIOLIB_EXCLUDE_AX25
7
8 #include "../PhysicalLayer/PhysicalLayer.h"
9 #include "../AFSK/AFSK.h"
10 #include "../BellModem/BellModem.h"
11 #include "../../utils/CRC.h"
12
13 // macros to access bits in byte array, from http://www.mathcs.emory.edu/~cheung/Courses/255/Syllabus/1-C-intro/bit-array.html
14 #define SET_BIT_IN_ARRAY(A, k) ( A[(k/8)] |= (1 << (k%8)) )
15 #define CLEAR_BIT_IN_ARRAY(A, k) ( A[(k/8)] &= ~(1 << (k%8)) )
16 #define TEST_BIT_IN_ARRAY(A, k) ( A[(k/8)] & (1 << (k%8)) )
17 #define GET_BIT_IN_ARRAY(A, k) ( (A[(k/8)] & (1 << (k%8))) ? 1 : 0 )
18
19 // maximum callsign length in bytes
20 #define RADIOLIB_AX25_MAX_CALLSIGN_LEN 6
21
22 // flag field MSB LSB DESCRIPTION
23 #define RADIOLIB_AX25_FLAG 0b01111110 // 7 0 AX.25 frame start/end flag
24
25 // address field
26 #define RADIOLIB_AX25_SSID_COMMAND_DEST 0b10000000 // 7 7 frame type: command (set in destination SSID)
27 #define RADIOLIB_AX25_SSID_COMMAND_SOURCE 0b00000000 // 7 7 command (set in source SSID)
28 #define RADIOLIB_AX25_SSID_RESPONSE_DEST 0b00000000 // 7 7 response (set in destination SSID)
29 #define RADIOLIB_AX25_SSID_RESPONSE_SOURCE 0b10000000 // 7 7 response (set in source SSID)
30 #define RADIOLIB_AX25_SSID_HAS_NOT_BEEN_REPEATED 0b00000000 // 7 7 not repeated yet (set in repeater SSID)
31 #define RADIOLIB_AX25_SSID_HAS_BEEN_REPEATED 0b10000000 // 7 7 repeated (set in repeater SSID)
32 #define RADIOLIB_AX25_SSID_RESERVED_BITS 0b01100000 // 6 5 reserved bits in SSID
33 #define RADIOLIB_AX25_SSID_HDLC_EXTENSION_CONTINUE 0b00000000 // 0 0 HDLC extension bit: next octet contains more address information
34 #define RADIOLIB_AX25_SSID_HDLC_EXTENSION_END 0b00000001 // 0 0 address field end
35
36 // control field
37 #define RADIOLIB_AX25_CONTROL_U_SET_ASYNC_BAL_MODE 0b01101100 // 7 2 U frame type: set asynchronous balanced mode (connect request)
38 #define RADIOLIB_AX25_CONTROL_U_SET_ASYNC_BAL_MODE_EXT 0b00101100 // 7 2 set asynchronous balanced mode extended (connect request with module 128)
39 #define RADIOLIB_AX25_CONTROL_U_DISCONNECT 0b01000000 // 7 2 disconnect request
40 #define RADIOLIB_AX25_CONTROL_U_DISCONNECT_MODE 0b00001100 // 7 2 disconnect mode (system busy or disconnected)
41 #define RADIOLIB_AX25_CONTROL_U_UNNUMBERED_ACK 0b01100000 // 7 2 unnumbered acknowledge
42 #define RADIOLIB_AX25_CONTROL_U_FRAME_REJECT 0b10000100 // 7 2 frame reject
43 #define RADIOLIB_AX25_CONTROL_U_UNNUMBERED_INFORMATION 0b00000000 // 7 2 unnumbered information
44 #define RADIOLIB_AX25_CONTROL_U_EXHANGE_IDENTIFICATION 0b10101100 // 7 2 exchange ID
45 #define RADIOLIB_AX25_CONTROL_U_TEST 0b11100000 // 7 2 test
46 #define RADIOLIB_AX25_CONTROL_POLL_FINAL_ENABLED 0b00010000 // 4 4 control field poll/final bit: enabled
47 #define RADIOLIB_AX25_CONTROL_POLL_FINAL_DISABLED 0b00000000 // 4 4 disabled
48 #define RADIOLIB_AX25_CONTROL_S_RECEIVE_READY 0b00000000 // 3 2 S frame type: receive ready (system ready to receive)
49 #define RADIOLIB_AX25_CONTROL_S_RECEIVE_NOT_READY 0b00000100 // 3 2 receive not ready (TNC buffer full)
50 #define RADIOLIB_AX25_CONTROL_S_REJECT 0b00001000 // 3 2 reject (out of sequence or duplicate)
51 #define RADIOLIB_AX25_CONTROL_S_SELECTIVE_REJECT 0b00001100 // 3 2 selective reject (single frame repeat request)
52 #define RADIOLIB_AX25_CONTROL_INFORMATION_FRAME 0b00000000 // 0 0 frame type: information (I frame)
53 #define RADIOLIB_AX25_CONTROL_SUPERVISORY_FRAME 0b00000001 // 1 0 supervisory (S frame)
54 #define RADIOLIB_AX25_CONTROL_UNNUMBERED_FRAME 0b00000011 // 1 0 unnumbered (U frame)
55
56 // protocol identifier field
57 #define RADIOLIB_AX25_PID_ISO_8208 0x01
58 #define RADIOLIB_AX25_PID_TCP_IP_COMPRESSED 0x06
59 #define RADIOLIB_AX25_PID_TCP_IP_UNCOMPRESSED 0x07
60 #define RADIOLIB_AX25_PID_SEGMENTATION_FRAGMENT 0x08
61 #define RADIOLIB_AX25_PID_TEXNET_DATAGRAM_PROTOCOL 0xC3
62 #define RADIOLIB_AX25_PID_LINK_QUALITY_PROTOCOL 0xC4
63 #define RADIOLIB_AX25_PID_APPLETALK 0xCA
64 #define RADIOLIB_AX25_PID_APPLETALK_ARP 0xCB
65 #define RADIOLIB_AX25_PID_ARPA_INTERNET_PROTOCOL 0xCC
66 #define RADIOLIB_AX25_PID_ARPA_ADDRESS_RESOLUTION 0xCD
67 #define RADIOLIB_AX25_PID_FLEXNET 0xCE
68 #define RADIOLIB_AX25_PID_NET_ROM 0xCF
69 #define RADIOLIB_AX25_PID_NO_LAYER_3 0xF0
70 #define RADIOLIB_AX25_PID_ESCAPE_CHARACTER 0xFF
71
76 class AX25Frame {
77 public:
81 char destCallsign[RADIOLIB_AX25_MAX_CALLSIGN_LEN + 1];
82
86 uint8_t destSSID;
87
91 char srcCallsign[RADIOLIB_AX25_MAX_CALLSIGN_LEN + 1];
92
96 uint8_t srcSSID;
97
101 uint8_t numRepeaters;
102
106 uint8_t control;
107
111 uint8_t protocolID;
112
116 uint16_t infoLen;
117
121 uint8_t rcvSeqNumber;
122
126 uint16_t sendSeqNumber;
127
128 #if !RADIOLIB_STATIC_ONLY
132 uint8_t* info;
133
137 char** repeaterCallsigns;
138
142 uint8_t* repeaterSSIDs;
143 #else
147 uint8_t info[RADIOLIB_STATIC_ARRAY_SIZE];
148
152 char repeaterCallsigns[8][RADIOLIB_AX25_MAX_CALLSIGN_LEN + 1];
153
157 uint8_t repeaterSSIDs[8];
158 #endif
159
168 AX25Frame(const char* destCallsign, uint8_t destSSID, const char* srcCallsign, uint8_t srcSSID, uint8_t control);
169
180 AX25Frame(const char* destCallsign, uint8_t destSSID, const char* srcCallsign, uint8_t srcSSID, uint8_t control, uint8_t protocolID, const char* info);
181
193 AX25Frame(const char* destCallsign, uint8_t destSSID, const char* srcCallsign, uint8_t srcSSID, uint8_t control, uint8_t protocolID, uint8_t* info, uint16_t infoLen);
194
199 AX25Frame(const AX25Frame& frame);
200
204 ~AX25Frame();
205
210 AX25Frame& operator=(const AX25Frame& frame);
211
219 int16_t setRepeaters(char** repeaterCallsigns, uint8_t* repeaterSSIDs, uint8_t numRepeaters);
220
225 void setRecvSequence(uint8_t seqNumber);
226
231 void setSendSequence(uint8_t seqNumber);
232 };
233
238 class AX25Client {
239 public:
244 explicit AX25Client(PhysicalLayer* phy);
245
246 #if !RADIOLIB_EXCLUDE_AFSK
251 explicit AX25Client(AFSKClient* audio);
252
261 int16_t setCorrection(int16_t mark, int16_t space, float length = 1.0f);
262 #endif
263
264 // basic methods
265
275 int16_t begin(const char* srcCallsign, uint8_t srcSSID = 0x00, uint8_t preLen = 8);
276
277 #if defined(RADIOLIB_BUILD_ARDUINO)
286 int16_t transmit(String& str, const char* destCallsign, uint8_t destSSID = 0x00);
287 #endif
288
297 int16_t transmit(const char* str, const char* destCallsign, uint8_t destSSID = 0x00);
298
304 int16_t sendFrame(AX25Frame* frame);
305
306 #if !RADIOLIB_GODMODE
307 private:
308 #endif
309 friend class APRSClient;
310
311 PhysicalLayer* phyLayer;
312 #if !RADIOLIB_EXCLUDE_AFSK
313 BellClient* bellModem;
314 #endif
315
316 char sourceCallsign[RADIOLIB_AX25_MAX_CALLSIGN_LEN + 1] = {0, 0, 0, 0, 0, 0, 0};
317 uint8_t sourceSSID = 0;
318 uint16_t preambleLen = 0;
319
320 void getCallsign(char* buff);
321 uint8_t getSSID();
322 };
323
324 #endif
325
326 #endif
AFSKClient
Client for audio-based transmissions. Requires Arduino tone() function, and a module capable of direc...
Definition: AFSK.h:16
APRSClient
Client for APRS communication.
Definition: APRS.h:85
AX25Client
Client for AX25 communication.
Definition: AX25.h:238
AX25Client::sendFrame
int16_t sendFrame(AX25Frame *frame)
Transmit arbitrary AX.25 frame.
Definition: AX25.cpp:217
AX25Client::setCorrection
int16_t setCorrection(int16_t mark, int16_t space, float length=1.0f)
Set AFSK tone correction offset. On some platforms, this is required to get the audio produced by the...
Definition: AX25.cpp:168
AX25Client::transmit
int16_t transmit(const char *str, const char *destCallsign, uint8_t destSSID=0x00)
Transmit unnumbered information (UI) frame.
Definition: AX25.cpp:206
AX25Client::begin
int16_t begin(const char *srcCallsign, uint8_t srcSSID=0x00, uint8_t preLen=8)
Initialization method.
Definition: AX25.cpp:180
AX25Client::AX25Client
AX25Client(PhysicalLayer *phy)
Constructor for 2-FSK mode.
Definition: AX25.cpp:154
AX25Frame
Abstraction of AX.25 frame format.
Definition: AX25.h:76
AX25Frame::setSendSequence
void setSendSequence(uint8_t seqNumber)
Method to set send sequence number.
Definition: AX25.cpp:150
AX25Frame::AX25Frame
AX25Frame(const char *destCallsign, uint8_t destSSID, const char *srcCallsign, uint8_t srcSSID, uint8_t control)
Overloaded constructor, for frames without info field.
Definition: AX25.cpp:5
AX25Frame::repeaterCallsigns
char ** repeaterCallsigns
Array of repeater callsigns.
Definition: AX25.h:137
AX25Frame::srcCallsign
char srcCallsign[RADIOLIB_AX25_MAX_CALLSIGN_LEN+1]
Callsign of the source station.
Definition: AX25.h:91
AX25Frame::setRecvSequence
void setRecvSequence(uint8_t seqNumber)
Method to set receive sequence number.
Definition: AX25.cpp:146
AX25Frame::sendSeqNumber
uint16_t sendSeqNumber
Send sequence number.
Definition: AX25.h:126
AX25Frame::srcSSID
uint8_t srcSSID
SSID of the source station.
Definition: AX25.h:96
AX25Frame::operator=
AX25Frame & operator=(const AX25Frame &frame)
Overload for assignment operator.
Definition: AX25.cpp:75
AX25Frame::control
uint8_t control
The control field.
Definition: AX25.h:106
AX25Frame::repeaterSSIDs
uint8_t * repeaterSSIDs
Array of repeater SSIDs.
Definition: AX25.h:142
AX25Frame::infoLen
uint16_t infoLen
Number of bytes in the information field.
Definition: AX25.h:116
AX25Frame::setRepeaters
int16_t setRepeaters(char **repeaterCallsigns, uint8_t *repeaterSSIDs, uint8_t numRepeaters)
Method to set the repeater callsigns and SSIDs.
Definition: AX25.cpp:110
AX25Frame::destCallsign
char destCallsign[RADIOLIB_AX25_MAX_CALLSIGN_LEN+1]
Callsign of the destination station.
Definition: AX25.h:81
AX25Frame::info
uint8_t * info
The info field.
Definition: AX25.h:132
AX25Frame::protocolID
uint8_t protocolID
The protocol identifier (PID) field.
Definition: AX25.h:111
AX25Frame::~AX25Frame
~AX25Frame()
Default destructor.
Definition: AX25.cpp:57
AX25Frame::numRepeaters
uint8_t numRepeaters
Number of repeaters to be used.
Definition: AX25.h:101
AX25Frame::rcvSeqNumber
uint8_t rcvSeqNumber
Receive sequence number.
Definition: AX25.h:121
AX25Frame::destSSID
uint8_t destSSID
SSID of the destination station.
Definition: AX25.h:86
BellClient
Client for Bell modem communication. The public interface is the same as Arduino Serial.
Definition: BellModem.h:57
PhysicalLayer
Provides common interface for protocols that run on LoRa/FSK modules, such as RTTY or LoRaWAN....
Definition: PhysicalLayer.h:54