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.
398 lines
11 KiB
398 lines
11 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 MMDVMHost project. (https://github.com/g4klx/MMDVMHost)
|
|
// Licensed under the GPLv2 License (https://opensource.org/licenses/GPL-2.0)
|
|
//
|
|
/*
|
|
* Copyright (C) 2015,2016 by Jonathan Naylor G4KLX
|
|
* Copyright (C) 2019-2023 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.
|
|
*/
|
|
#include "Defines.h"
|
|
#include "dmr/lc/CSBK.h"
|
|
#include "edac/BPTC19696.h"
|
|
#include "edac/CRC.h"
|
|
#include "Log.h"
|
|
#include "Utils.h"
|
|
|
|
using namespace dmr::lc;
|
|
using namespace dmr;
|
|
|
|
#include <cstdio>
|
|
#include <cassert>
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// Static Class Members
|
|
// ---------------------------------------------------------------------------
|
|
|
|
bool CSBK::m_verbose = false;
|
|
|
|
SiteData CSBK::m_siteData = SiteData();
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// Public Class Members
|
|
// ---------------------------------------------------------------------------
|
|
|
|
/// <summary>
|
|
/// Initializes a copy instance of the CSBK class.
|
|
/// </summary>
|
|
/// <param name="data"></param>
|
|
CSBK::CSBK(const CSBK& data) : CSBK()
|
|
{
|
|
copy(data);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Initializes a new instance of the CSBK class.
|
|
/// </summary>
|
|
CSBK::CSBK() :
|
|
m_colorCode(0U),
|
|
m_lastBlock(true),
|
|
m_Cdef(false),
|
|
m_CSBKO(CSBKO_NONE),
|
|
m_FID(0x00U),
|
|
m_GI(false),
|
|
m_srcId(0U),
|
|
m_dstId(0U),
|
|
m_dataContent(false),
|
|
m_CBF(0U),
|
|
m_dataType(DT_CSBK),
|
|
m_emergency(false),
|
|
m_privacy(false),
|
|
m_supplementData(false),
|
|
m_priority(0U),
|
|
m_broadcast(false),
|
|
m_proxy(false),
|
|
m_response(0U),
|
|
m_reason(0U),
|
|
m_siteOffsetTiming(false),
|
|
m_logicalCh1(DMR_CHNULL),
|
|
m_logicalCh2(DMR_CHNULL),
|
|
m_slotNo(0U),
|
|
m_siteIdenEntry(::lookups::IdenTable())
|
|
{
|
|
/* stub */
|
|
}
|
|
|
|
/// <summary>
|
|
/// Finalizes a instance of the CSBK class.
|
|
/// </summary>
|
|
CSBK::~CSBK()
|
|
{
|
|
/* stub */
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a string that represents the current CSBK.
|
|
/// </summary>
|
|
/// <returns></returns>
|
|
std::string CSBK::toString()
|
|
{
|
|
return std::string("CSBKO_UNKWN (Unknown CSBK)");
|
|
}
|
|
|
|
/// <summary>
|
|
/// Regenerate a DMR CSBK without decoding.
|
|
/// </summary>
|
|
/// <param name="data"></param>
|
|
/// <param name="dataType"></param>
|
|
/// <returns>True, if TSBK was decoded, otherwise false.</returns>
|
|
bool CSBK::regenerate(uint8_t* data, uint8_t dataType)
|
|
{
|
|
uint8_t csbk[DMR_CSBK_LENGTH_BYTES];
|
|
::memset(csbk, 0x00U, DMR_CSBK_LENGTH_BYTES);
|
|
|
|
// decode BPTC (196,96) FEC
|
|
edac::BPTC19696 bptc;
|
|
bptc.decode(data, csbk);
|
|
|
|
// validate the CRC-CCITT 16
|
|
switch (dataType) {
|
|
case DT_CSBK:
|
|
csbk[10U] ^= CSBK_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_CRC_MASK[1U];
|
|
break;
|
|
case DT_MBC_HEADER:
|
|
csbk[10U] ^= CSBK_MBC_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_MBC_CRC_MASK[1U];
|
|
break;
|
|
}
|
|
|
|
bool valid = edac::CRC::checkCCITT162(csbk, DMR_CSBK_LENGTH_BYTES);
|
|
if (!valid) {
|
|
LogError(LOG_DMR, "CSBK::decode(), failed CRC CCITT-162 check");
|
|
return false;
|
|
}
|
|
|
|
// restore the checksum
|
|
switch (dataType) {
|
|
case DT_CSBK:
|
|
csbk[10U] ^= CSBK_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_CRC_MASK[1U];
|
|
break;
|
|
case DT_MBC_HEADER:
|
|
csbk[10U] ^= CSBK_MBC_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_MBC_CRC_MASK[1U];
|
|
break;
|
|
}
|
|
|
|
// calculate checksum
|
|
switch (dataType) {
|
|
case DT_CSBK:
|
|
csbk[10U] ^= CSBK_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_CRC_MASK[1U];
|
|
break;
|
|
case DT_MBC_HEADER:
|
|
csbk[10U] ^= CSBK_MBC_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_MBC_CRC_MASK[1U];
|
|
break;
|
|
}
|
|
|
|
edac::CRC::addCCITT162(csbk, 12U);
|
|
|
|
switch (dataType) {
|
|
case DT_CSBK:
|
|
csbk[10U] ^= CSBK_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_CRC_MASK[1U];
|
|
break;
|
|
case DT_MBC_HEADER:
|
|
csbk[10U] ^= CSBK_MBC_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_MBC_CRC_MASK[1U];
|
|
break;
|
|
}
|
|
|
|
// encode BPTC (196,96) FEC
|
|
bptc.encode(csbk, data);
|
|
|
|
return true;
|
|
}
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// Protected Class Members
|
|
// ---------------------------------------------------------------------------
|
|
|
|
/// <summary>
|
|
/// Internal helper to convert payload bytes to a 64-bit long value.
|
|
/// </summary>
|
|
/// <param name="payload"></param>
|
|
/// <returns></returns>
|
|
ulong64_t CSBK::toValue(const uint8_t* payload)
|
|
{
|
|
ulong64_t value = 0U;
|
|
|
|
// combine bytes into ulong64_t (8 byte) value
|
|
value = payload[0U];
|
|
value = (value << 8) + payload[1U];
|
|
value = (value << 8) + payload[2U];
|
|
value = (value << 8) + payload[3U];
|
|
value = (value << 8) + payload[4U];
|
|
value = (value << 8) + payload[5U];
|
|
value = (value << 8) + payload[6U];
|
|
value = (value << 8) + payload[7U];
|
|
|
|
return value;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Internal helper to convert a 64-bit long value to payload bytes.
|
|
/// </summary>
|
|
/// <param name="value"></param>
|
|
/// <returns></returns>
|
|
UInt8Array CSBK::fromValue(const ulong64_t value)
|
|
{
|
|
__UNIQUE_UINT8_ARRAY(payload, DMR_CSBK_LENGTH_BYTES - 4U);
|
|
|
|
// split ulong64_t (8 byte) value into bytes
|
|
payload[0U] = (uint8_t)((value >> 56) & 0xFFU);
|
|
payload[1U] = (uint8_t)((value >> 48) & 0xFFU);
|
|
payload[2U] = (uint8_t)((value >> 40) & 0xFFU);
|
|
payload[3U] = (uint8_t)((value >> 32) & 0xFFU);
|
|
payload[4U] = (uint8_t)((value >> 24) & 0xFFU);
|
|
payload[5U] = (uint8_t)((value >> 16) & 0xFFU);
|
|
payload[6U] = (uint8_t)((value >> 8) & 0xFFU);
|
|
payload[7U] = (uint8_t)((value >> 0) & 0xFFU);
|
|
|
|
return payload;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Internal helper to decode a control signalling block.
|
|
/// </summary>
|
|
/// <param name="data"></param>
|
|
/// <param name="payload"></param>
|
|
/// <returns>True, if CSBK was decoded, otherwise false.</returns>
|
|
bool CSBK::decode(const uint8_t* data, uint8_t* payload)
|
|
{
|
|
assert(data != nullptr);
|
|
assert(payload != nullptr);
|
|
|
|
uint8_t csbk[DMR_CSBK_LENGTH_BYTES];
|
|
::memset(csbk, 0x00U, DMR_CSBK_LENGTH_BYTES);
|
|
|
|
// decode BPTC (196,96) FEC
|
|
edac::BPTC19696 bptc;
|
|
bptc.decode(data, csbk);
|
|
|
|
// validate the CRC-CCITT 16
|
|
switch (m_dataType) {
|
|
case DT_CSBK:
|
|
csbk[10U] ^= CSBK_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_CRC_MASK[1U];
|
|
break;
|
|
case DT_MBC_HEADER:
|
|
csbk[10U] ^= CSBK_MBC_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_MBC_CRC_MASK[1U];
|
|
break;
|
|
}
|
|
|
|
bool valid = edac::CRC::checkCCITT162(csbk, DMR_CSBK_LENGTH_BYTES);
|
|
if (!valid) {
|
|
LogError(LOG_DMR, "CSBK::decode(), failed CRC CCITT-162 check");
|
|
return false;
|
|
}
|
|
|
|
// restore the checksum
|
|
switch (m_dataType) {
|
|
case DT_CSBK:
|
|
csbk[10U] ^= CSBK_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_CRC_MASK[1U];
|
|
break;
|
|
case DT_MBC_HEADER:
|
|
csbk[10U] ^= CSBK_MBC_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_MBC_CRC_MASK[1U];
|
|
break;
|
|
}
|
|
|
|
if (m_verbose) {
|
|
Utils::dump(2U, "Decoded CSBK", csbk, DMR_CSBK_LENGTH_BYTES);
|
|
}
|
|
|
|
m_CSBKO = csbk[0U] & 0x3FU; // CSBKO
|
|
m_lastBlock = (csbk[0U] & 0x80U) == 0x80U; // Last Block Marker
|
|
m_FID = csbk[1U]; // Feature ID
|
|
|
|
m_dataContent = false;
|
|
m_CBF = 0U;
|
|
|
|
::memcpy(payload, csbk + 2U, DMR_CSBK_LENGTH_BYTES - 4U);
|
|
return true;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Internal helper to encode a control signalling block.
|
|
/// </summary>
|
|
/// <param name="data"></param>
|
|
/// <param name="payload"></param>
|
|
void CSBK::encode(uint8_t* data, const uint8_t* payload)
|
|
{
|
|
assert(data != nullptr);
|
|
assert(payload != nullptr);
|
|
|
|
uint8_t csbk[DMR_CSBK_LENGTH_BYTES];
|
|
::memset(csbk, 0x00U, DMR_CSBK_LENGTH_BYTES);
|
|
::memcpy(csbk + 2U, payload, DMR_CSBK_LENGTH_BYTES - 4U);
|
|
|
|
csbk[0U] = m_CSBKO; // CSBKO
|
|
csbk[0U] |= (m_lastBlock) ? 0x80U : 0x00U; // Last Block Marker
|
|
if (!m_Cdef) {
|
|
csbk[1U] = m_FID; // Feature ID
|
|
}
|
|
else {
|
|
csbk[1U] = m_colorCode & 0x0FU; // Cdef uses Color Code
|
|
}
|
|
|
|
switch (m_dataType) {
|
|
case DT_CSBK:
|
|
csbk[10U] ^= CSBK_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_CRC_MASK[1U];
|
|
break;
|
|
case DT_MBC_HEADER:
|
|
csbk[10U] ^= CSBK_MBC_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_MBC_CRC_MASK[1U];
|
|
break;
|
|
}
|
|
|
|
edac::CRC::addCCITT162(csbk, 12U);
|
|
|
|
switch (m_dataType) {
|
|
case DT_CSBK:
|
|
csbk[10U] ^= CSBK_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_CRC_MASK[1U];
|
|
break;
|
|
case DT_MBC_HEADER:
|
|
csbk[10U] ^= CSBK_MBC_CRC_MASK[0U];
|
|
csbk[11U] ^= CSBK_MBC_CRC_MASK[1U];
|
|
break;
|
|
}
|
|
|
|
if (m_verbose) {
|
|
Utils::dump(2U, "Encoded CSBK", csbk, DMR_CSBK_LENGTH_BYTES);
|
|
}
|
|
|
|
// encode BPTC (196,96) FEC
|
|
edac::BPTC19696 bptc;
|
|
bptc.encode(csbk, data);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Internal helper to copy the the class.
|
|
/// </summary>
|
|
/// <param name="data"></param>
|
|
void CSBK::copy(const CSBK& data)
|
|
{
|
|
m_colorCode = data.m_colorCode;
|
|
|
|
m_lastBlock = data.m_lastBlock;
|
|
m_Cdef = data.m_Cdef;
|
|
|
|
m_CSBKO = data.m_CSBKO;
|
|
m_FID = data.m_FID;
|
|
|
|
m_GI = data.m_GI;
|
|
|
|
m_srcId = data.m_srcId;
|
|
m_dstId = data.m_dstId;
|
|
|
|
m_dataContent = data.m_dataContent;
|
|
|
|
m_CBF = data.m_CBF;
|
|
|
|
m_emergency = data.m_emergency;
|
|
m_privacy = data.m_privacy;
|
|
m_supplementData = data.m_supplementData;
|
|
m_priority = data.m_priority;
|
|
m_broadcast = data.m_broadcast;
|
|
m_proxy = data.m_proxy;
|
|
|
|
m_response = data.m_response;
|
|
m_response = data.m_reason;
|
|
|
|
m_siteOffsetTiming = data.m_siteOffsetTiming;
|
|
|
|
m_logicalCh1 = data.m_logicalCh1;
|
|
m_logicalCh2 = data.m_logicalCh2;
|
|
m_slotNo = data.m_slotNo;
|
|
|
|
m_siteIdenEntry = data.m_siteIdenEntry;
|
|
}
|