// Part of dump1090, a Mode S message decoder for RTLSDR devices. // // track.h: aircraft state tracking prototypes // // Copyright (c) 2014-2016 Oliver Jowett // // This file is free software: you may copy, redistribute 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 file 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 . // This file incorporates work covered by the following copyright and // permission notice: // // Copyright (C) 2012 by Salvatore Sanfilippo // // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // // * Redistributions in binary form must reproduce the above copyright // notice, this list of conditions and the following disclaimer in the // documentation and/or other materials provided with the distribution. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT // HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #ifndef DUMP1090_TRACK_H #define DUMP1090_TRACK_H /* Maximum age of tracked aircraft in milliseconds */ #define TRACK_AIRCRAFT_TTL 300000 /* Maximum age of a tracked aircraft with only 1 message received, in milliseconds */ #define TRACK_AIRCRAFT_ONEHIT_TTL 60000 /* Maximum validity of an aircraft position */ #define TRACK_AIRCRAFT_POSITION_TTL 60000 typedef struct { datasource_t source; /* where the data came from */ uint64_t updated; /* when it arrived */ uint64_t stale; /* when it will become stale */ uint64_t expires; /* when it will expire */ } data_validity; /* Structure used to describe the state of one tracked aircraft */ struct aircraft { uint32_t addr; // ICAO address addrtype_t addrtype; // highest priority address type seen for this aircraft uint64_t seen; // Time (millis) at which the last packet was received long messages; // Number of Mode S messages received double signalLevel[8]; // Last 8 Signal Amplitudes int signalNext; // next index of signalLevel to use data_validity callsign_valid; char callsign[9]; // Flight number data_validity altitude_valid; int altitude; // Altitude (Baro) unsigned altitude_modeC; // (as a Mode C value) data_validity altitude_gnss_valid; int altitude_gnss; // Altitude (GNSS) data_validity gnss_delta_valid; int gnss_delta; // Difference between GNSS and Baro altitudes data_validity speed_valid; unsigned speed; data_validity speed_ias_valid; unsigned speed_ias; data_validity speed_tas_valid; unsigned speed_tas; data_validity heading_valid; unsigned heading; // Heading (OK it's really the track) data_validity heading_magnetic_valid; unsigned heading_magnetic; // Heading data_validity vert_rate_valid; int vert_rate; // Vertical rate altitude_source_t vert_rate_source; data_validity squawk_valid; unsigned squawk; // Squawk data_validity category_valid; unsigned category; // Aircraft category A0 - D7 encoded as a single hex byte data_validity airground_valid; airground_t airground; // air/ground status data_validity cpr_odd_valid; // Last seen even CPR message airground_t cpr_odd_airground; unsigned cpr_odd_lat; unsigned cpr_odd_lon; unsigned cpr_odd_nuc; data_validity cpr_even_valid; // Last seen odd CPR message airground_t cpr_even_airground; unsigned cpr_even_lat; unsigned cpr_even_lon; unsigned cpr_even_nuc; data_validity position_valid; double lat, lon; // Coordinated obtained from CPR encoded data unsigned pos_nuc; // NUCp of last computed position long modeAcount; // Mode A Squawk hit Count long modeCcount; // Mode C Altitude hit Count int modeACflags; // Flags for mode A/C recognition int fatsv_emitted_altitude; // last FA emitted altitude int fatsv_emitted_altitude_gnss; // -"- GNSS altitude int fatsv_emitted_heading; // -"- true track int fatsv_emitted_heading_magnetic; // -"- magnetic heading int fatsv_emitted_speed; // -"- groundspeed int fatsv_emitted_speed_ias; // -"- IAS int fatsv_emitted_speed_tas; // -"- TAS airground_t fatsv_emitted_airground; // -"- air/ground state unsigned char fatsv_emitted_bds_10[7]; // -"- BDS 1,0 message unsigned char fatsv_emitted_bds_30[7]; // -"- BDS 3,0 message unsigned char fatsv_emitted_es_status[7]; // -"- ES operational status message unsigned char fatsv_emitted_es_target[7]; // -"- ES target status message uint64_t fatsv_last_emitted; // time (millis) aircraft was last FA emitted struct aircraft *next; // Next aircraft in our linked list struct modesMessage first_message; // A copy of the first message we received for this aircraft. }; /* is this bit of data valid? */ static inline int trackDataValid(const data_validity *v) { return (v->source != SOURCE_INVALID); } /* .. with these constraints? */ static inline int trackDataValidEx(const data_validity *v, uint64_t now, uint64_t maxAge, datasource_t minSource) { if (v->source == SOURCE_INVALID) return 0; if (v->source < minSource) return 0; if (v->updated < now && (now - v->updated) > maxAge) return 0; return 1; } /* what's the age of this data? */ static inline uint64_t trackDataAge(const data_validity *v, uint64_t now) { if (v->source == SOURCE_INVALID) return ~(uint64_t)0; if (v->updated >= now) return 0; return (now - v->updated); } /* Update aircraft state from data in the provided mesage. * Return the tracked aircraft. */ struct modesMessage; struct aircraft *trackUpdateFromMessage(struct modesMessage *mm); /* Call periodically */ void trackPeriodicUpdate(); #endif