libhomeradar

Building your program with libhomeradar support

Include the libhomeradar headers into your program

#include "libhomeradar.h" or #include <libhomeradar.h>

Initialize libhomeradar within your program

LHR H = homeradar_init(128,LHR_AUTOCONNECT|LHR_LOOKUP_ALL|LHR_NOAIRCONTACTS,&e,NULL);

The first parameter is the maximum size of the internal message queue. If the queue is full the system will throw the fullqueue event and will start your callback function (if you have one registered with the homeradar_onhandler() function)
The second parameter is a bitmask of libhomeradar flags. You can later modify all settings with the homeradar_config() function.
 
The third parameter is a pointer to an integer to hold the error code which can be returned by the init function.
The last parameter should be the path to the folder where the text databases are located or NULL if you do not wish the autoload feature.
You can use the homeradar_load_databases() function to start the initialisation of your databases.
 
If the homeradar_init() return NULL you should check the errorcode and fix it before continue using the library functions.
 
If the function returns the LHR type pointer you can use all other functions from the lib. libhomeradar will create a thread into the background during the homeradar_init() call.

Removing libhomeradar from memory

Before your programm will be finished you should call the libhomeradar_destroy() function to stop the collector thread (and any other running thread) and to disconnect from any connected host and to free all allocated memory.