You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
201 lines
7.3 KiB
201 lines
7.3 KiB
/**
|
|
* Digital Voice Modem - Host Software
|
|
* GPLv2 Open Source. Use is subject to license terms.
|
|
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
|
*
|
|
* @package DVM / Host Software
|
|
*
|
|
*/
|
|
//
|
|
// Based on code from the MMDVMCal project. (https://github.com/g4klx/MMDVMCal)
|
|
// Licensed under the GPLv2 License (https://opensource.org/licenses/GPL-2.0)
|
|
//
|
|
/*
|
|
* Copyright (C) 2015,2016,2017 by Jonathan Naylor G4KLX
|
|
* Copyright (C) 2017,2018 by Andy Uribe CA6JAU
|
|
* Copyright (C) 2017-2021 by Bryan Biedenkapp N2PLL
|
|
*
|
|
* This program 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 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program 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 this program; if not, write to the Free Software
|
|
* Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
*/
|
|
#if !defined(__HOST_CAL_H__)
|
|
#define __HOST_CAL_H__
|
|
|
|
#include "Defines.h"
|
|
#include "edac/AMBEFEC.h"
|
|
#include "modem/Modem.h"
|
|
#include "host/calibrate/Console.h"
|
|
#include "host/Host.h"
|
|
#include "lookups/IdenTableLookup.h"
|
|
#include "yaml/Yaml.h"
|
|
|
|
#include <string>
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// Class Declaration
|
|
// This class implements the interactive calibration mode.
|
|
// ---------------------------------------------------------------------------
|
|
|
|
class HOST_SW_API HostCal {
|
|
public:
|
|
/// <summary>Initializes a new instance of the HostCal class.</summary>
|
|
HostCal(const std::string& confFile);
|
|
/// <summary>Finalizes a instance of the HostCal class.</summary>
|
|
~HostCal();
|
|
|
|
/// <summary>Executes the calibration processing loop.</summary>
|
|
int run();
|
|
|
|
private:
|
|
const std::string& m_confFile;
|
|
yaml::Node m_conf;
|
|
|
|
modem::Modem* m_modem;
|
|
|
|
Console m_console;
|
|
edac::AMBEFEC m_fec;
|
|
bool m_transmit;
|
|
|
|
bool m_duplex;
|
|
|
|
bool m_rxInvert; // dedicated modem - Rx signal inversion
|
|
bool m_txInvert; // dedicated modem - Tx signal inversion
|
|
bool m_pttInvert; // dedicated modem - PTT signal inversion
|
|
|
|
bool m_dcBlocker; // dedicated modem - DC blocker
|
|
|
|
float m_rxLevel; // dedicated/hotspot modem - Rx modulation level
|
|
float m_txLevel; // dedicated/hotspot modem - Tx modulation level
|
|
|
|
bool m_dmrEnabled;
|
|
bool m_dmrRx1K;
|
|
bool m_p25Enabled;
|
|
bool m_p25Rx1K;
|
|
int m_rxDCOffset; // dedicated modem - Rx signal DC offset
|
|
int m_txDCOffset; // dedicated modem - Tx signal DC offset
|
|
|
|
bool m_isHotspot;
|
|
|
|
int8_t m_dmrDiscBWAdj; // hotspot modem - DMR discriminator BW adjustment
|
|
int8_t m_p25DiscBWAdj; // hotspot modem - P25 discriminator BW adjustment
|
|
int8_t m_dmrPostBWAdj; // hotspot modem - DMR post demod BW adjustment
|
|
int8_t m_p25PostBWAdj; // hotspot modem - P25 post demod BW adjustment
|
|
|
|
modem::ADF_GAIN_MODE m_adfGainMode; // hotspot modem - ADF7021 Rx gain
|
|
|
|
int m_dmrSymLevel3Adj; // dedicated modem - +3/-3 DMR symbol adjustment
|
|
int m_dmrSymLevel1Adj; // dedicated modem - +1/-1 DMR symbol adjustment
|
|
int m_p25SymLevel3Adj; // dedicated modem - +3/-3 P25 symbol adjustment
|
|
int m_p25SymLevel1Adj; // dedicated modem - +1/-1 P25 symbol adjustment
|
|
|
|
uint8_t m_fdmaPreamble;
|
|
uint8_t m_dmrRxDelay;
|
|
uint8_t m_p25CorrCount;
|
|
|
|
bool m_debug;
|
|
|
|
uint8_t m_mode;
|
|
std::string m_modeStr;
|
|
|
|
int m_rxTuning;
|
|
int m_txTuning;
|
|
|
|
uint32_t m_rxFrequency; // hotspot modem - Rx Frequency
|
|
uint32_t m_rxAdjustedFreq;
|
|
uint32_t m_txFrequency; // hotspot modem - Tx Frequency
|
|
uint32_t m_txAdjustedFreq;
|
|
uint8_t m_channelId;
|
|
uint32_t m_channelNo;
|
|
|
|
lookups::IdenTableLookup* m_idenTable;
|
|
|
|
uint32_t m_berFrames;
|
|
uint32_t m_berBits;
|
|
uint32_t m_berErrs;
|
|
uint32_t m_berUndecodableLC;
|
|
uint32_t m_berUncorrectable;
|
|
|
|
uint32_t m_timeout;
|
|
uint32_t m_timer;
|
|
|
|
bool m_hasFetchedStatus;
|
|
|
|
/// <summary>Modem port open callback.</summary>
|
|
bool portModemOpen(modem::Modem* modem);
|
|
/// <summary>Modem port close callback.</summary>
|
|
bool portModemClose(modem::Modem* modem);
|
|
/// <summary>Modem clock callback.</summary>
|
|
bool portModemHandler(modem::Modem* modem, uint32_t ms, modem::RESP_TYPE_DVM rspType, bool rspDblLen, const uint8_t* buffer, uint16_t len);
|
|
|
|
/// <summary>Helper to print the calibration help to the console.</summary>
|
|
void displayHelp();
|
|
|
|
/// <summary>Helper to change the Tx level.</summary>
|
|
bool setTXLevel(int incr);
|
|
/// <summary>Helper to change the Rx level.</summary>
|
|
bool setRXLevel(int incr);
|
|
/// <summary>Helper to change the Tx DC offset.</summary>
|
|
bool setTXDCOffset(int incr);
|
|
/// <summary>Helper to change the Rx DC offset.</summary>
|
|
bool setRXDCOffset(int incr);
|
|
/// <summary>Helper to toggle modem transmit mode.</summary>
|
|
bool setTransmit();
|
|
|
|
/// <summary>Helper to change the DMR Symbol Level 3 adjust.</summary>
|
|
bool setDMRSymLevel3Adj(int incr);
|
|
/// <summary>Helper to change the DMR Symbol Level 1 adjust.</summary>
|
|
bool setDMRSymLevel1Adj(int incr);
|
|
/// <summary>Helper to change the P25 Symbol Level 3 adjust.</summary>
|
|
bool setP25SymLevel3Adj(int incr);
|
|
/// <summary>Helper to change the P25 Symbol Level 1 adjust.</summary>
|
|
bool setP25SymLevel1Adj(int incr);
|
|
|
|
/// <summary>Process DMR Rx BER.</summary>
|
|
void processDMRBER(const uint8_t* buffer, uint8_t seq);
|
|
/// <summary>Process DMR Tx 1011hz BER.</summary>
|
|
void processDMR1KBER(const uint8_t* buffer, uint8_t seq);
|
|
/// <summary>Process P25 Rx BER.</summary>
|
|
void processP25BER(const uint8_t* buffer);
|
|
/// <summary>Process P25 Tx 1011hz BER.</summary>
|
|
void processP251KBER(const uint8_t* buffer);
|
|
|
|
/// <summary>Write configuration to the modem DSP.</summary>
|
|
bool writeConfig();
|
|
/// <summary>Write configuration to the modem DSP.</summary>
|
|
bool writeConfig(uint8_t modeOverride);
|
|
/// <summary>Write RF parameters to the air interface modem.</summary>
|
|
bool writeRFParams();
|
|
/// <summary>Write symbol level adjustments to the modem DSP.</summary>
|
|
bool writeSymbolAdjust();
|
|
/// <summary>Helper to sleep the calibration thread.</summary>
|
|
void sleep(uint32_t ms);
|
|
|
|
/// <summary>Helper to clock the calibration BER timer.</summary>
|
|
void timerClock();
|
|
/// <summary>Helper to start the calibration BER timer.</summary>
|
|
void timerStart();
|
|
/// <summary>Helper to stop the calibration BER timer.</summary>
|
|
void timerStop();
|
|
|
|
/// <summary>Retrieve the current status from the air interface modem.</summary>
|
|
void getStatus();
|
|
/// <summary>Prints the current status of the calibration.</summary>
|
|
void printStatus();
|
|
|
|
/// <summary>Counts the total number of bit errors between bytes.</summary>
|
|
uint8_t countErrs(uint8_t a, uint8_t b);
|
|
};
|
|
|
|
#endif // __HOST_CAL_H__
|