/***************************************************************************
* Copyright (C) 2020 - 2025 by Federico Amedeo Izzo IU2NUO, *
* Niccolò Izzo IU2KIN, *
* Frederik Saraci IU2NRO, *
* Silvano Seva IU2KWO *
* *
* 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 3 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, see *
***************************************************************************/
#ifndef CPS_H
#define CPS_H
#include
#include
#include "core/datatypes.h"
#include "rtx/rtx.h"
// Magic number to identify the binary file
#define CPS_MAGIC 0x43585452
// Codeplug version v0.1
#define CPS_VERSION_MAJOR 0
#define CPS_VERSION_MINOR 1
#define CPS_VERSION_NUMBER (CPS_VERSION_MAJOR << 8) | CPS_VERSION_MINOR
#define CPS_STR_SIZE 32
/******************************************************************************
* FM MODE *
******************************************************************************/
/**
* Enumeration type for CTCSS frequencies.
*/
enum CTCSSfreq
{
CTCSS_67_0 = 0,
CTCSS_69_3,
CTCSS_71_9,
CTCSS_74_4,
CTCSS_77_0,
CTCSS_79_7,
CTCSS_82_5,
CTCSS_85_4,
CTCSS_88_5,
CTCSS_91_5,
CTCSS_94_8,
CTCSS_97_4,
CTCSS_100_0,
CTCSS_103_5,
CTCSS_107_2,
CTCSS_110_9,
CTCSS_114_8,
CTCSS_118_8,
CTCSS_123_0,
CTCSS_127_3,
CTCSS_131_8,
CTCSS_136_5,
CTCSS_141_3,
CTCSS_146_2,
CTCSS_151_4,
CTCSS_156_7,
CTCSS_159_8,
CTCSS_162_2,
CTCSS_165_5,
CTCSS_167_9,
CTCSS_171_3,
CTCSS_173_8,
CTCSS_177_3,
CTCSS_179_9,
CTCSS_183_5,
CTCSS_186_2,
CTCSS_189_9,
CTCSS_192_8,
CTCSS_196_6,
CTCSS_199_5,
CTCSS_203_5,
CTCSS_206_5,
CTCSS_210_7,
CTCSS_218_1,
CTCSS_225_7,
CTCSS_229_1,
CTCSS_233_6,
CTCSS_241_8,
CTCSS_250_3,
CTCSS_254_1,
CTCSS_FREQ_NUM
};
/**
* CTCSS tone table for fast index-to-frequency conversion
*/
extern const uint16_t ctcss_tone[];
/**
* Data structure defining an analog-specific channel information such as tones.
*/
typedef struct
{
uint8_t rxToneEn : 1, //< RX CTC/DCS tone enable
rxTone : 7; //< RX CTC/DCS tone index
uint8_t txToneEn : 1, //< TX CTC/DCS tone enable
txTone : 7; //< TX CTC/DCS tone index
}
__attribute__((packed)) fmInfo_t; // 2B
/******************************************************************************
* DMR MODE *
******************************************************************************/
/**
* Data structure containing all and only the information for DMR channels.
*/
typedef struct
{
uint8_t rxColorCode : 4, //< Color code for RX squelch opening
txColorCode : 4; //< Color code sent during transmission
uint8_t dmr_timeslot; //< DMR timeslot, either 1 or 2
uint16_t contact_index; //< Index to retrieve contact from list
}
__attribute__((packed)) dmrInfo_t; // 4B
/**
* Enumeration type defining the types of a DMR contact.
*/
enum dmrContactType_t
{
GROUP = 0, //< Group contact (Talkgroup)
PRIVATE = 1, //< Private contact
ALL = 2 //< Broadcast call
};
/**
* Data structure describing a DMR contact entry.
*/
typedef struct
{
uint32_t id; //< DMR id
uint8_t contactType : 2, //< Call type
rx_tone : 1, //< Call receive tone
_unused : 5; //< Padding
}
__attribute__((packed)) dmrContact_t; // 5B
/******************************************************************************
* M17 MODE *
******************************************************************************/
/**
* M17 channel modes.
*/
enum m17mode_t
{
DIGITAL_VOICE = 1, //< Digital Voice
DIGITAL_DATA = 2, //< Digital Data
DIGITAL_VOICE_DATA = 3 //< Digital Voice and Data
};
/**
* M17 channel encryption.
*/
enum m17crypto_t
{
PLAIN = 0, //< No encryption, plaintext data is sent
SCRAMBLER = 1, //< Scrambler
AES = 2 //< AES
};
/**
* M17 gps operation.
*/
enum m17gps_t
{
NO_GPS = 0, //< No GPS information is sent
GPS_META = 1 //< GPS position is sent along with payload
};
/**
* Data structure containing all and only the information for M17 channels.
*/
typedef struct
{
uint8_t rxCan : 4, //< Channel Access Number for RX
txCan : 4; //< Channel Access Number for TX
uint8_t mode : 4, //< Channel operation mode
encr : 4; //< Encryption mode
uint8_t gps_mode; //< Channel GPS mode
uint16_t contact_index; //< Index to retrieve data from contact list
}
__attribute__((packed)) m17Info_t; // 5B
/**
* Data structure describing M17-specific contact fields.
*/
typedef struct
{
uint8_t address[6]; //< M17 encoded address
}
__attribute__((packed)) m17Contact_t; // 6B
/******************************************************************************
* COMMON DATA STRUCTURES *
******************************************************************************/
/**
* Data structure for geolocation data
*/
typedef struct
{
int8_t ch_lat_int; //< Latitude integer part
uint16_t ch_lat_dec; //< Latitude decimal part
int16_t ch_lon_int; //< Longitude integer part
uint16_t ch_lon_dec; //< Longitude decimal part
uint16_t ch_altitude; //< Meters MSL. Stored +500
}
__attribute__((packed)) geo_t; // 9B
/**
* Data structure containing all the information of a channel.
*/
typedef struct
{
uint8_t mode; //< Operating mode
uint8_t bandwidth : 2, //< Bandwidth
rx_only : 1, //< 1 means RX-only channel
_unused : 5; //< Padding to 8 bits
uint32_t power; //< Tx power, in mW
freq_t rx_frequency; //< RX Frequency, in Hz
freq_t tx_frequency; //< TX Frequency, in Hz
uint8_t scanList_index; //< Scan List: None, ScanList1...250
uint8_t groupList_index; //< Group List: None, GroupList1...128
char name[CPS_STR_SIZE]; //< Channel name
char descr[CPS_STR_SIZE]; //< Description of the channel
geo_t ch_location; //< Transmitter geolocation
union
{
fmInfo_t fm; //< Information block for FM channels
dmrInfo_t dmr; //< Information block for DMR channels
m17Info_t m17; //< Information block for M17 channels
};
}
__attribute__((packed)) channel_t; // 59B
/**
* Data structure describing a codeplug contact.
*/
typedef struct
{
char name[CPS_STR_SIZE]; //< Display name of the contact
uint8_t mode; //< Operating mode
union
{
dmrContact_t dmr; //< DMR specific contact info
m17Contact_t m17; //< M17 specific contact info
}
info; // 6B
}
__attribute__((packed)) contact_t; // 39B
/**
* Data structure describing a bank header.
* A bank is a variable size structure composed of a bank header and a
* variable length array of uint32_t each representing a channel index.
*/
typedef struct
{
char name[CPS_STR_SIZE];
uint16_t ch_count; //< Count of all the channels in this bank
}
__attribute__((packed)) bankHdr_t; // 18B + 2 * ch_count
/**
* The codeplug binary structure is composed by:
* - A header struct
* - A variable length array of all the contacts
* - A variable length array of all the channels
* - A variable length array of the offsets to reach each bank
* - A binary dense structure of all the banks
*/
typedef struct
{
uint64_t magic; //< Magic number "RTXC"
uint16_t version_number; //< Version number for the cps structure
char author[CPS_STR_SIZE]; //< Author of the codeplug
char descr[CPS_STR_SIZE]; //< Description of the codeplug
uint64_t timestamp; //< unix timestamp of the codeplug
uint16_t ct_count; //< Number of stored contacts
uint16_t ch_count; //< Number of stored channels
uint16_t b_count; //< Number of stored banks
}
__attribute__((packed)) cps_header_t; // 88B
/**
* Create and return a viable channel for this radio.
* Suitable for default VFO settings or the creation of a new channel.
* Needs to be generated by a function frequency settings require details from
* the running hardware on limitations.
*/
channel_t cps_getDefaultChannel();
#endif // CPS_H