/*************************************************************************** * Copyright (C) 2020 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 STATE_H #define STATE_H #include #include #include #include #include /** * Data structure representing a single satellite as part of a GPS fix. */ typedef struct { uint8_t id; // ID of the satellite uint8_t elevation; // Elevation in degrees uint16_t azimuth; // Azimuth in degrees uint8_t snr; // Quality of the signal in range 0-99 } sat_t; /** * Data structure representing the last state received from the GPS module. */ typedef struct { curTime_t timestamp; // Timestamp of the latest GPS update uint8_t fix_quality; // 0: no fix, 1: GPS, 2: GPS SPS, 3: GPS PPS uint8_t fix_type; // 0: no fix, 1: 2D, 2: 3D uint8_t satellites_tracked; // Number of tracked satellites uint8_t satellites_in_view; // Satellites in view sat_t satellites[12]; // Details about satellites in view uint32_t active_sats; // Bitmap representing which sats are part of the fix float latitude; // Latitude coordinates float longitude; // Longitude coordinates float altitude; // Antenna altitude above mean sea level (geoid) in m float speed; // Ground speed in km/h float tmg_mag; // Course over ground, degrees, magnetic float tmg_true; // Course over ground, degrees, true } gps_t; /** * Data structure representing the settings of the M17 mode. */ typedef struct { // char callsign[10]; char dst_addr[10]; } m17_t; /** * Part of this structure has been commented because the corresponding * functionality is not yet implemented. * Uncomment once the related feature is ready */ typedef struct { curTime_t time; uint16_t v_bat; uint8_t charge; float rssi; uint8_t ui_screen; uint8_t tuner_mode; //time_t rx_status_tv; //bool rx_status; //time_t tx_status_tv; //bool tx_status; uint16_t channel_index; channel_t channel; channel_t vfo_channel; bool bank_enabled; bank_t bank; uint8_t rtxStatus; bool rtxShutdown; bool emergency; settings_t settings; gps_t gps_data; bool gps_set_time; m17_t m17_data; } state_t; enum TunerMode { VFO = 0, CH, SCAN, CHSCAN }; enum RtxStatus { RTX_OFF = 0, RTX_RX, RTX_TX }; extern state_t state; /** * This function initializes the Radio state, acquiring the information * needed to populate it from device drivers. */ void state_init(); /** * Write default values to OpenRTX settings and VFO Channel configuration. * Writes out to flash and calls state_init again to reload it immediately. */ void defaultSettingsAndVfo(); /** * This function terminates the radio state saving persistent settings to flash. */ void state_terminate(); /** * Update radio state fetching data from device drivers. */ void state_update(); /** * The RTC and state.time are set to UTC time * Use this function to get local time from UTC time based on timezone setting */ curTime_t state_getLocalTime(curTime_t utc_time); /** * The RTC and state.time are set to UTC time * Use this function to get UTC time from local time based on timezone setting */ curTime_t state_getUTCTime(curTime_t local_time); #endif /* STATE_H */