kopia lustrzana https://github.com/sq8vps/vp-digi
128 wiersze
3.6 KiB
C
128 wiersze
3.6 KiB
C
/*
|
|
Copyright 2020-2023 Piotr Wilkon
|
|
|
|
This file is part of VP-Digi.
|
|
|
|
VP-Digi is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
VP-Digi is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with VP-Digi. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef AX25_H_
|
|
#define AX25_H_
|
|
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
|
|
#define AX25_NOT_FX25 255
|
|
|
|
//for AX.25 329 bytes is the theoretical max size assuming 2-byte Control, 1-byte PID, 256-byte info field and 8 digi address fields
|
|
#define AX25_FRAME_MAX_SIZE (329) //single frame max length
|
|
|
|
enum Ax25RxStage
|
|
{
|
|
RX_STAGE_IDLE = 0,
|
|
RX_STAGE_FLAG,
|
|
RX_STAGE_FRAME,
|
|
#ifdef ENABLE_FX25
|
|
RX_STAGE_FX25_FRAME,
|
|
#endif
|
|
};
|
|
|
|
struct Ax25ProtoConfig
|
|
{
|
|
uint16_t txDelayLength; //TXDelay length in ms
|
|
uint16_t txTailLength; //TXTail length in ms
|
|
uint16_t quietTime; //Quiet time in ms
|
|
uint8_t allowNonAprs : 1; //allow non-APRS packets
|
|
uint8_t fx25 : 1; //enable FX.25 (AX.25 + FEC)
|
|
uint8_t fx25Tx : 1; //enable TX in FX.25
|
|
};
|
|
|
|
extern struct Ax25ProtoConfig Ax25Config;
|
|
|
|
|
|
/**
|
|
* @brief Write frame to transmit buffer
|
|
* @param *data Data to transmit
|
|
* @param size Data size
|
|
* @return Pointer to internal frame handle or NULL on failure
|
|
* @attention This function will block if transmission is already in progress
|
|
*/
|
|
void *Ax25WriteTxFrame(uint8_t *data, uint16_t size);
|
|
|
|
/**
|
|
* @brief Get bitmap of "frame received" flags for each decoder. A non-zero value means that a frame was received
|
|
* @return Bitmap of decoder that received the frame
|
|
*/
|
|
uint8_t Ax25GetReceivedFrameBitmap(void);
|
|
|
|
/**
|
|
* @brief Clear bitmap of "frame received" flags
|
|
*/
|
|
void Ax25ClearReceivedFrameBitmap(void);
|
|
|
|
/**
|
|
* @brief Get next received frame (if available)
|
|
* @param **dst Pointer to internal buffer
|
|
* @param *size Actual frame size
|
|
<<<<<<< HEAD
|
|
* @param *peak Signak positive peak value in %
|
|
* @param *valley Signal negative peak value in %
|
|
* @param *level Signal level in %
|
|
* @param *corrected Number of bytes corrected in FX.25 mode. 255 is returned if not a FX.25 packet.
|
|
* @return True if frame was read, false if no more frames to read
|
|
*/
|
|
bool Ax25ReadNextRxFrame(uint8_t **dst, uint16_t *size, int8_t *peak, int8_t *valley, uint8_t *level, uint8_t *corrected);
|
|
|
|
/**
|
|
* @brief Get current RX stage
|
|
* @param[in] modemNo Modem/decoder number (0 or 1)
|
|
* @return RX_STATE_IDLE, RX_STATE_FLAG or RX_STATE_FRAME
|
|
* @warning Only for internal use
|
|
*/
|
|
enum Ax25RxStage Ax25GetRxStage(uint8_t modemNo);
|
|
|
|
/**
|
|
* @brief Parse incoming bit (not symbol!)
|
|
* @details Handles bit-stuffing, header and CRC checking, stores received frame and sets "frame received flag", multiplexes both decoders
|
|
* @param[in] bit Incoming bit
|
|
* @param[in] *dem Modem state pointer
|
|
* @warning Only for internal use
|
|
*/
|
|
void Ax25BitParse(uint8_t bit, uint8_t modemNo);
|
|
|
|
/**
|
|
* @brief Get next bit to be transmitted
|
|
* @return Bit to be transmitted
|
|
* @warning Only for internal use
|
|
*/
|
|
uint8_t Ax25GetTxBit(void);
|
|
|
|
/**
|
|
* @brief Initialize transmission and start when possible
|
|
*/
|
|
void Ax25TransmitBuffer(void);
|
|
|
|
/**
|
|
* @brief Start transmitting when possible
|
|
* @attention Must be continuously polled in main loop
|
|
*/
|
|
void Ax25TransmitCheck(void);
|
|
|
|
/**
|
|
* @brief Initialize AX25 module
|
|
*/
|
|
void Ax25Init(void);
|
|
|
|
#endif /* AX25_H_ */
|