poslib.h

Go to the documentation of this file.

 
#ifndef _POSLIB_H_
#define _POSLIB_H_
 
 
#if (APP_LIB_STATE_VERSION > 0x205)
//#define DA_SUPPORT
#endif
 
 
#define POS_DESTINATION_ENDPOINT 238
#define POS_SOURCE_ENDPOINT      238
 
#define POSLIB_MIN_MEAS_RATE_S   8 /* FixMe: adjust based on testing*/
#define POSLIB_MAX_MEAS_RATE_S   86400
 
#define POSLIB_VOLTAGE_SAMPLING_MAX_S 60
#define POSLIB_VOLTAGE_FILTER_SAMPLES 30
 
 
typedef enum
{
    POS_RET_OK = 0,
    POS_RET_INVALID_STATE = 1,
    POS_RET_INVALID_PARAM = 2,
    POS_RET_INVALID_DATA = 3,
    POS_RET_LIB_ERROR = 4,
    POS_RET_INTERNAL_ERROR = 5,
    POS_RET_NOT_CONFIGURED = 6,
    POS_RET_EVENT_REG_ERROR = 7,
    POS_RET_MOTION_NOT_ENABLED = 8
} poslib_ret_e;
 
typedef enum
{
    POSLIB_MODE_NRLS_TAG = 1,
    POSLIB_MODE_AUTOSCAN_TAG = 2,
    POSLIB_MODE_AUTOSCAN_ANCHOR = 3,
    POSLIB_MODE_OPPORTUNISTIC_ANCHOR = 4,
    POSLIB_MODE_ENDS = 5
} poslib_mode_e;
 
typedef enum
{
    POSLIB_MOTION_STATIC = 1,
    POSLIB_MOTION_DYNAMIC = 2,
} poslib_motion_mode_e;
 
typedef enum
{
    POSLIB_BLE_OFF = 0,             // OFF
    POSLIB_BLE_ON = 1,              // always ON
    POSLIB_BLE_ON_WHEN_OFFLINE = 2  //activated when outside coverage
} poslib_ble_mode_e;
 
typedef enum
{
    POSLIB_CLASS_NODE_SPECIFIC = 0xF8,
    POSLIB_CLASS_DEFAULT = 0xF9,
    POSLIB_CLASS_A = 0xFA,
    POSLIB_CLASS_B = 0xFB,
    POSLIB_CLASS_C = 0xFC,
    POSLIB_CLASS_D = 0xFD,
    POSLIB_CLASS_E = 0xFE,
    POSLIB_CLASS_F = 0xFF
} poslib_class_e;
 
typedef enum
{
    POSLIB_EDDYSTONE = 1,
    POSLIB_IBEACON,
    POSLIB_BEACON_ALL,
} poslib_ble_type_e;
 
#define POSLIB_FLAG_EVENT_SUBSCRIBERS_MAX 8
 
typedef enum
{
    POSLIB_FLAG_EVENT_NONE = 0,
    POSLIB_FLAG_EVENT_UPDATE_START = 1,
    POSLIB_FLAG_EVENT_UPDATE_END = 2,
    POSLIB_FLAG_EVENT_BLE_START = 4,
    POSLIB_FLAG_EVENT_BLE_STOP = 8,
    POSLIB_FLAG_EVENT_OFLINE = 16,
    POSLIB_FLAG_EVENT_ONLINE = 32,
    POSLIB_FLAG_EVENT_CONFIG_CHANGE = 64,
    POSLIB_FLAG_EVENT_LED_ON = 128,
    POSLIB_FLAG_EVENT_LED_OFF = 256,
    POSLIB_FLAG_EVENT_ALL = 511 /* ! Update when adding a new event */
} poslib_events_e;
 
typedef enum
{
    POSLIB_STOPPED = 0,
    POSLIB_IDLE = 1,
    POSLIB_UPDATE_START = 2,
} poslib_status_e;
 
typedef struct
{
    int8_t tx_power;
    app_lib_beacon_tx_channels_mask_e channels;
    uint16_t tx_interval_ms;
} poslib_ble_mode_config_t;
 
typedef struct
{
    poslib_ble_type_e type;
    poslib_ble_mode_e mode;
    poslib_ble_mode_config_t eddystone;
    poslib_ble_mode_config_t ibeacon;
    uint16_t activation_delay_s;  //BLE beacons activation delay when outside coverage
} ble_beacon_settings_t;
 
typedef struct
{    
    bool enabled;
    uint16_t threshold_mg;
    uint16_t duration_ms;
} poslib_motion_mon_settings_t;
 
typedef struct
{
    /* mode defined using PosLib_setConfig */
    poslib_mode_e node_mode;
    /* class defined using PosLib_setConfig */
    poslib_class_e node_class;
    /* defined using PosLib_setConfig. Used for normal PosLib update period */
    uint32_t update_period_static_s;
    /* defined using PosLib_setConfig. Used when api call PosLib_motion */
    uint32_t update_period_dynamic_s;
    /* defined using PosLib_setConfig. Used when autoscan mode and stack is offline */
    uint32_t update_period_offline_s;
    /* defined using PosLib_setConfig. Configuration of ble */
    ble_beacon_settings_t ble;
    /* Motion settings*/
    poslib_motion_mon_settings_t motion;
} poslib_settings_t;
 
typedef struct
{
    /* duration for LED to be turned on */
    uint16_t led_on_duration_s;
    /* LED control command sequence */
    uint8_t led_cmd_seq;
} poslib_aux_settings_t;
 
typedef struct
{
    uint8_t                        event_id;
    app_lib_time_timestamp_hp_t    time_hp;
    uint32_t                       nrls_sleep_time_sec;
} POSLIB_FLAG_EVENT_info_t;
 
typedef void (*poslib_events_listen_info_f)(POSLIB_FLAG_EVENT_info_t * msg);
 
typedef void (*poslib_events_callback_f) (poslib_events_listen_info_f callback);
 
poslib_ret_e PosLib_setConfig(poslib_settings_t * settings);
 
poslib_ret_e PosLib_getConfig(poslib_settings_t * settings);
 
poslib_ret_e PosLib_startPeriodic(void);
 
poslib_ret_e PosLib_stopPeriodic(void);
 
poslib_ret_e PosLib_startOneshot(void);
 
poslib_ret_e PosLib_motion(poslib_motion_mode_e mode);
 
poslib_status_e PosLib_status(void);
 
poslib_ret_e PosLib_eventRegister(poslib_events_e event,
                            poslib_events_listen_info_f cb, 
                            uint8_t * id);
 
void PosLib_eventDeregister(uint8_t id);
#endif