libhomeradar

Export and import functions

Since version 1.005 libhomeradar has a lot of import functions and a new export function (write all contacts to disc as normal textfile).
There are 4 import functions available. To include a libhomeradar textfile, you should use the homeradar_readfromdisc() function. (see also our samples of export contacts and import contacts)

PLEASE NOTE: Before you'll use one of the import functions you must initialize the libhomeradar import interface with a single call to homeradar_enable_import() and if you have no hosts added, you must also call homeradar_without_hosts() before importing any data.

libhomeradar import functions

/* Set system to import only - no host is needed 
   Useful if you use libhomeradar as importer function 
   If you have no other input (SBS1 or RB), then you'll
   need this function to handle imported data from the
   import functions above.
*/
extern int homeradar_without_hosts(LHR handle);

/* 
   Enable import functions of libhomeradar 
   Without this option none of the following import functions will work
 */
extern void homeradar_enable_import(LHR handle);

/* 
  This import functions reads a normal semicolon separated string
  in libhomeradar format into the internal queue
  Field definition of the string
  
  ICAO24 Address;
  Callsign;
  New Contact; (possible values are 0 or 1)		(*)
  GPS position (LAT);					(*)
  GPS position (LON);					(*)
  Flightlevel;						(*)
  Squawk;						(*)
  Messagetype;						(*)
  Date of contact (format: YYYY/MM/DD);
  Time of contact (format: HH:MM:SS);
  Aircraft registration;
  Aircraft manufacturer;				(**)
  Aircraft model;					(**)
  Aircraft details;					(**)
  Aircraft construction number;				(**)
  Flightnumber;
  Routing;						(*)
  Airline;						(**)
  Airlines IATA code;					(**)
  Airlines ICAO code					(**)

   (*) = can be empty or 0
  (**) = if empty, will be resolved by libhomeradar
*/
extern int homeradar_import_by_string(LHR handle, const char *str);

/*
  ContactImport reads a standard LHR_CONTACT structure and will send
  this structure to the normal working loop of libhomeradar.
  With this function you can bind other sources to libhomeradar

  Function returns TRUE (1) on success, -1 on error or FALSE (0) if 
  the item could not be inserted
*/
extern int homeradar_import_by_struct(LHR handle, const LHR_CONTACT *C);

/* Import data source by given values
   All values must be initialized. If one of the values is NULL, the 
   the import will not start.
   This function returns TRUE (1) on success or FALSE (0) if import failed.
   -1 will returned in case of errors
*/
extern int homeradar_import_by_data(LHR handle, const char *addr, const char *reg, const char *callsign,
                                    const char *flightnumber, const time_t contacted, 
                                    const double LAT, const double LON);

/* Read from disc will read a prev. created textfile with the 'homeradar_dump2disc' function
   The parameter 'file' is the complete path (incl. filename) to the dumpfile
   Function returns how many lines are read or -1 on error */
extern int homeradar_readfromdisc(LHR handle, const char *file, const int type, const int hostid);