/** * 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 * */ /* * Copyright (C) 2022 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(__P25_LC__TSBK_H__) #define __P25_LC__TSBK_H__ #include "Defines.h" #include "p25/edac/Trellis.h" #include "p25/lc/LC.h" #include "p25/lc/TDULC.h" #include "p25/SiteData.h" #include "edac/RS634717.h" #include "lookups/IdenTableLookup.h" #include namespace p25 { namespace dfsi { // --------------------------------------------------------------------------- // Class Prototypes // --------------------------------------------------------------------------- class HOST_SW_API LC; } namespace lc { // --------------------------------------------------------------------------- // Class Prototypes // --------------------------------------------------------------------------- class HOST_SW_API LC; class HOST_SW_API TDULC; // --------------------------------------------------------------------------- // Class Declaration // Represents link control data for TSDU packets. // --------------------------------------------------------------------------- class HOST_SW_API TSBK { public: /// Initializes a copy instance of the TSBK class. TSBK(const TSBK& data); /// Initializes a new instance of the TSBK class. TSBK(LC* lc); /// Initializes a new instance of the TSBK class. TSBK(); /// Finalizes a instance of the TSBK class. virtual ~TSBK(); /// Decode a trunking signalling block. virtual bool decode(const uint8_t* data, bool rawTSBK = false) = 0; /// Encode a trunking signalling block. virtual void encode(uint8_t* data, bool rawTSBK = false, bool noTrellis = false) = 0; /// Sets the flag indicating verbose log output. static void setVerbose(bool verbose) { m_verbose = verbose; } /// Sets the flag indicating CRC-errors should be warnings and not errors. static void setWarnCRC(bool warnCRC) { m_warnCRC = warnCRC; } /** Local Site data */ /// Sets the callsign. static void setCallsign(std::string callsign); /// Gets the local site data. static SiteData getSiteData() { return m_siteData; } /// Sets the local site data. static void setSiteData(SiteData siteData) { m_siteData = siteData; } public: /** Common Data */ /// Flag indicating the link control data is protected. __PROTECTED_PROPERTY(bool, protect, Protect); /// Link control opcode. __PROTECTED_PROPERTY(uint8_t, lco, LCO); /// Manufacturer ID. __PROTECTED_PROPERTY(uint8_t, mfId, MFId); /// Source ID. __PROTECTED_PROPERTY(uint32_t, srcId, SrcId); /// Destination ID. __PROTECTED_PROPERTY(uint32_t, dstId, DstId); /// Flag indicating this is the last TSBK in a sequence of TSBKs. __PROTECTED_PROPERTY(bool, lastBlock, LastBlock); /// Flag indicating this TSBK contains additional information. __PROTECTED_PROPERTY(bool, aivFlag, AIV); /// Flag indicating this TSBK contains extended addressing. __PROTECTED_PROPERTY(bool, extendedAddrFlag, EX); /// Service type. __PROTECTED_PROPERTY(uint8_t, service, Service); /// Response type. __PROTECTED_PROPERTY(uint8_t, response, Response); /// Configured network ID. __PROTECTED_READONLY_PROPERTY(uint32_t, netId, NetId); /// Configured system ID. __PROTECTED_READONLY_PROPERTY(uint32_t, sysId, SysId); /// Voice channel ID. __PROTECTED_PROPERTY(uint32_t, grpVchId, GrpVchId); /// Voice channel number. __PROTECTED_PROPERTY(uint32_t, grpVchNo, GrpVchNo); /** Common Service Options */ /// Flag indicating the emergency bits are set. __PROTECTED_PROPERTY(bool, emergency, Emergency); /// Flag indicating that encryption is enabled. __PROTECTED_PROPERTY(bool, encrypted, Encrypted); /// Priority level for the traffic. __PROTECTED_PROPERTY(uint8_t, priority, Priority); /// Flag indicating a group/talkgroup operation. __PROTECTED_PROPERTY(bool, group, Group); /** Local Site data */ /// Local Site Identity Entry. __PROTECTED_PROPERTY_PLAIN(::lookups::IdenTable, siteIdenEntry, siteIdenEntry); protected: friend class dfsi::LC; friend class LC; friend class TDULC; edac::RS634717 m_rs; edac::Trellis m_trellis; static bool m_verbose; static bool m_warnCRC; /** Local Site data */ static uint8_t* m_siteCallsign; static SiteData m_siteData; /// Internal helper to convert TSBK bytes to a 64-bit long value. static ulong64_t toValue(const uint8_t* tsbk); /// Internal helper to convert a 64-bit long value to TSBK bytes. static std::unique_ptr fromValue(const ulong64_t tsbkValue); /// Internal helper to decode a trunking signalling block. bool decode(const uint8_t* data, uint8_t* tsbk, bool rawTSBK = false); /// Internal helper to encode a trunking signalling block. void encode(uint8_t* data, const uint8_t* tsbk, bool rawTSBK = false, bool noTrellis = false); __PROTECTED_COPY(TSBK); }; } // namespace lc } // namespace p25 #endif // __P25_LC__TSBK_H__