twr_sam_m8q.h

#ifndef _TWR_SAM_M8Q
#define _TWR_SAM_M8Q
 
#include <twr_i2c.h>
#include <twr_scheduler.h>
 
 
 
typedef enum
{
    TWR_SAM_M8Q_EVENT_ERROR = 0,
 
    TWR_SAM_M8Q_EVENT_START = 1,
 
    TWR_SAM_M8Q_EVENT_UPDATE = 2,
 
    TWR_SAM_M8Q_EVENT_STOP = 3
 
} twr_sam_m8q_event_t;
 
 
typedef struct twr_sam_m8q_t twr_sam_m8q_t;
 
 
typedef struct
{
    bool (*on)(twr_sam_m8q_t *self);
 
    bool (*off)(twr_sam_m8q_t *self);
 
} twr_sam_m8q_driver_t;
 
 
typedef struct
{
    int year;
 
    int month;
 
    int day;
 
    int hours;
 
    int minutes;
 
    int seconds;
 
} twr_sam_m8q_time_t;
 
 
typedef struct
{
    float latitude;
 
    float longitude;
 
} twr_sam_m8q_position_t;
 
 
typedef struct
{
    float altitude;
 
    char units;
 
} twr_sam_m8q_altitude_t;
 
 
typedef struct
{
    int fix_quality;
 
    int satellites_tracked;
 
} twr_sam_m8q_quality_t;
 
 
typedef struct
{
    float horizontal;
 
    float vertical;
 
} twr_sam_m8q_accuracy_t;
 
 
typedef enum
{
    TWR_SAM_M8Q_STATE_ERROR = -1,
    TWR_SAM_M8Q_STATE_START = 0,
    TWR_SAM_M8Q_STATE_READ = 1,
    TWR_SAM_M8Q_STATE_UPDATE = 2,
    TWR_SAM_M8Q_STATE_STOP = 3
 
} twr_sam_m8q_state_t;
 
typedef void (twr_sam_m8q_event_handler_t)(twr_sam_m8q_t *, twr_sam_m8q_event_t, void *);
 
struct twr_sam_m8q_t
{
    twr_i2c_channel_t _i2c_channel;
    uint8_t _i2c_address;
    const twr_sam_m8q_driver_t *_driver;
    twr_scheduler_task_id_t _task_id;
    twr_sam_m8q_event_handler_t *_event_handler;
    void *_event_param;
    bool _running;
    bool _configured;
    twr_sam_m8q_state_t _state;
    uint8_t _ddc_buffer[64];
    size_t _ddc_length;
    char _line_buffer[128];
    size_t _line_length;
    bool _line_clipped;
    struct
    {
        bool valid;
        struct
        {
            int year;
            int month;
            int day;
        } date;
        struct
        {
            int hours;
            int minutes;
            int seconds;
        } time;
        float latitude;
        float longitude;
    } _rmc;
    struct
    {
        bool valid;
        int fix_quality;
        float altitude;
        char altitude_units;
    } _gga;
    struct
    {
        bool valid;
        float h_accuracy;
        float v_accuracy;
        float speed;
        float course;
        int satellites;
    } _pubx;
};
 
 
 
void twr_sam_m8q_init(twr_sam_m8q_t *self, twr_i2c_channel_t channel, uint8_t i2c_address, const twr_sam_m8q_driver_t *driver);
 
 
void twr_sam_m8q_set_event_handler(twr_sam_m8q_t *self, twr_sam_m8q_event_handler_t event_handler, void *event_param);
 
 
void twr_sam_m8q_start(twr_sam_m8q_t *self);
 
 
void twr_sam_m8q_stop(twr_sam_m8q_t *self);
 
 
void twr_sam_m8q_invalidate(twr_sam_m8q_t *self);
 
 
bool twr_sam_m8q_get_time(twr_sam_m8q_t *self, twr_sam_m8q_time_t *time);
 
 
bool twr_sam_m8q_get_position(twr_sam_m8q_t *self, twr_sam_m8q_position_t *position);
 
 
bool twr_sam_m8q_get_altitude(twr_sam_m8q_t *self, twr_sam_m8q_altitude_t *altitude);
 
 
bool twr_sam_m8q_get_quality(twr_sam_m8q_t *self, twr_sam_m8q_quality_t *quality);
 
 
bool twr_sam_m8q_get_accuracy(twr_sam_m8q_t *self, twr_sam_m8q_accuracy_t *accuracy);
 
#endif // _TWR_SAM_M8Q