datarecord.h

Go to the documentation of this file.

/*
 * $COPYRIGHT-BEGIN$
 * libasterix
 * Copyright [2013-2026] SinoATC <http://www.sinoatc.com>.
 * All Rights Reserved.
 *
 * NOTICE:  All information contained herein is, and remains
 * the property of SinoATC and its suppliers, if any.
 * The intellectual and technical concepts contained herein
 * are proprietary to SinoATC and its suppliers and may be
 * covered by U.S. and Foreign Patents, patents in process,
 * and are protected by trade secret or copyright law.
 * Dissemination of this information or reproduction of this material
 * is strictly forbidden unless prior written permission is obtained
 * from SinoATC.
 * $COPYRIGHT-END$
 */

 
#ifndef LIBASTERIX_DATARECORD_H
#define LIBASTERIX_DATARECORD_H
 
#include "category.h"
#include "uap.h"
#include "fspec.h"
#include "dataitem.h"
#include "match.h"
#include "type.h"
 
#ifdef __cplusplus
extern "C" {
#endif


#define AST_MAX_DATAITEMS 32

typedef struct _ast_datarecord_t
{
  const unsigned char* data;  
  size_t size;                
 
  ast_category_t category;    
  ast_uap_t uap;              
 
  ast_fspec_t fspec;            
  ast_dataitem_t dataitems[AST_MAX_DATAITEMS];  
  size_t n_dataitems;           
 
  bool valid;               
} ast_datarecord_t;

typedef struct _ast_datarecord_ex_t
{
  ast_category_t category;    
  ast_uap_t uap;              
 
  ast_dataitem_ex_t dataitems[AST_MAX_DATAITEMS];  
  size_t n_dataitems;         
} ast_datarecord_ex_t;

typedef struct _ast_datarecord_modifier_t
{
  ast_dataitem_ex_t dataitems[AST_MAX_DATAITEMS];  
  size_t n_dataitems;         
} ast_datarecord_modifier_t;

AST_API ast_datarecord_t ast_datarecord_decode(const unsigned char* buffer, const size_t bufsize, const ast_category_t category, const ast_uap_t uap);

AST_API ast_datarecord_t ast_datarecord_encode(unsigned char* const buffer, const size_t bufsize, const ast_datarecord_ex_t xdr);

AST_API ast_datarecord_t ast_datarecord_copy(unsigned char* buffer, const size_t bufsize, const ast_datarecord_t src);

AST_API ast_datarecord_t ast_datarecord_modify(unsigned char* buffer, const size_t bufsize, const ast_datarecord_t src, const ast_datarecord_modifier_t mod);

#define AST_DATARECORD_HEX_HTML_PREFERED_CHARS (AST_MAX_DATAITEMS * AST_MAX_DATAITEM_SIZE * 12 + 128)

AST_API void ast_datarecord_get_hex_html(char* html, const size_t html_size, const ast_datarecord_t dr);

#define AST_DATARECORD_DETAIL_HTML_PREFERED_CHARS 20480

AST_API void ast_datarecord_get_detail_html(char* detail, const size_t detail_size, const ast_datarecord_t dr);

AST_API bool ast_datarecord_contain_keyword(const ast_datarecord_t dr, const ast_keyword_t keyword);

AST_API bool ast_datarecord_match_keyword(const ast_datarecord_t dr, const ast_keyword_t keyword, const char* challenge, bool case_sensitive);

#define AST_KEYWORD_VALUE_PREFERRED_CHARS 32

AST_API bool ast_datarecord_get_keyword(char* keystr, const size_t keystr_size, const ast_datarecord_t dr, const ast_keyword_t keyword, const ast_keyword_format_t format);

AST_API ast_sacsic_t ast_datarecord_get_sacsic(const ast_datarecord_t dr);

AST_API ast_timeofday_t ast_datarecord_get_timeofday(const ast_datarecord_t dr);

AST_API ast_msgtype_t ast_datarecord_get_msgtype(const ast_datarecord_t dr);

AST_API ast_tracknum_t ast_datarecord_get_tracknum(const ast_datarecord_t dr);

AST_API ast_squawk_t ast_datarecord_get_squawk(const ast_datarecord_t dr);

AST_API ast_callsign_t ast_datarecord_get_callsign(const ast_datarecord_t dr);

AST_API ast_icaoaddr_t ast_datarecord_get_icaoaddr(const ast_datarecord_t dr);

AST_API ast_wgs84coord_t ast_datarecord_get_wgs84coord(const ast_datarecord_t dr);

AST_API ast_altitude_t ast_datarecord_get_flightlevel(const ast_datarecord_t dr);

AST_API ast_altitude_t ast_datarecord_get_selaltitude(const ast_datarecord_t dr);

AST_API ast_polar_coordinate_t ast_datarecord_get_polarcoord(const ast_datarecord_t dr);

AST_API ast_range_t ast_datarecord_get_range(const ast_datarecord_t dr);

AST_API ast_azimuth_t ast_datarecord_get_azimuth(const ast_datarecord_t dr);

AST_API ast_heading_t ast_datarecord_get_heading(const ast_datarecord_t dr);

AST_API ast_speed_t ast_datarecord_get_speed(const ast_datarecord_t dr);

AST_API ast_cartesian_velocity_t ast_datarecord_get_cartesianvel(const ast_datarecord_t dr);

AST_API ast_doppler_velocity_t ast_datarecord_get_dopplervel(const ast_datarecord_t dr);

AST_API ast_vertical_rate_t ast_datarecord_get_vrate(const ast_datarecord_t dr);
 /* end of group dr_datarecord */
 
#ifdef __cplusplus
     }
#endif // extern "C"
 
#endif //LIBASTERIX_DATARECORD_H
 
// vim:set ft=c.doxygen sw=2 sts=2 fenc=utf8: