metawatch.h

   1 /*
   2  * (c) 2011 Siegen, Germany by Nils Faerber <nils.faerber@kernelconcepts.de>
   3  *
   4  * license LGPL
   5  */
   6
   7 #ifndef _METAWATCH_H
   8 #define _METAWATCH_H
   9
  10 #include <time.h>
  11 #include "metawatch_protocol.h"
  12
  13 #define MW_PBUF_LEN 512
  14
  15 typedef struct _mwdevice_t {
  16         int mw_fd;              /* file decriptor for MW connection */
  17         char pbuf[MW_PBUF_LEN]; /* protocol receive buffer */
  18         int pbuf_len;
  19         unsigned char devtype;  /* the device type of the connected device */
  20         unsigned char screen_mode; /* the current assumed screen mode */
  21         /* watch message callbacks */
  22         void (*mw_get_device_type_response_cb) (struct _mwdevice_t *mwdevice, unsigned char devtype, void *user_data);
  23         void *mw_gdtypersp_data;
  24         void (*mw_get_real_time_clock_response_cb) (struct _mwdevice_t *mwdevice, struct tm *mw_tm, void *user_data);
  25         void *mw_grtcrsp_data;
  26         void (*mw_get_battery_voltage_response_cb) (struct _mwdevice_t *mwdevice, unsigned short *voltage, unsigned short *voltage_avg, unsigned char *pgood, unsigned char *charging, void *user_data);
  27         void *mw_gbatvrsp_data;
  28         void (*mw_read_button_config_response_cb) (struct _mwdevice_t *mwdevice, void *user_data);
  29         void *mw_rbtncnfrsp_data;
  30         void (*mw_button_event_message_cb) (struct _mwdevice_t *mwdevice, unsigned char buttons, unsigned char options, void *user_data);
  31         void *mw_btnevmsg_data;
  32         void (*mw_read_light_sensor_response_cb) (struct _mwdevice_t *mwdevice, unsigned short *light_level, unsigned short *light_level_avg, void *user_data);
  33         void *mw_rlsrsp_data;
  34         void (*mw_status_change_event_cb) (struct _mwdevice_t *mwdevice, unsigned char *scrmode, unsigned char *status, void *user_data);
  35         void *mw_stchev_data;
  36         void (*mw_low_battery_warning_message_cb) (struct _mwdevice_t *mwdevice, void *user_data);
  37         void *mw_lbatwarnmsg_data;
  38         void (*mw_low_battery_bt_off_message_cb) (struct _mwdevice_t *mwdevice, void *user_data);
  39         void *mw_lbatbtoff_data;
  40 } mwdevice_t;
  41
  42 void dump_frame(unsigned char *frame, int len);
  43
  44
  45 int mw_send_frame(mwdevice_t *mwdevice, unsigned char msg_type, unsigned char options, unsigned char *data, unsigned char len);
  46
  47 int mw_set_rtc(mwdevice_t *mwdevice, struct tm *mw_tm);
  48
  49 int mw_nval_operation(mwdevice_t *mwdevice, unsigned char operation, unsigned short identifier, unsigned char size, void *mdata);
  50
  51 int mw_set_vibrate_mode(mwdevice_t *mwdevice, unsigned char enable, unsigned short on_time, unsigned short off_time, unsigned char cycles);
  52
  53 int mw_configure_watch_mode(mwdevice_t *mwdevice, unsigned char mode, unsigned char save, unsigned char timeout, unsigned char invert);
  54
  55 int mw_update_display(mwdevice_t *mwdevice, unsigned char mode, unsigned char copy);
  56
  57 int mw_load_template(mwdevice_t *mwdevice, unsigned char mode, unsigned char template_select);
  58
  59 int mw_write_buffer(mwdevice_t *mwdevice,
  60                 unsigned char mode,
  61                 unsigned char numlines,         /* number of lines, 0=two lines or 1=one line */
  62                 unsigned char row_offset,       /* start at row_offset in display, e.g. lower part in idle @31 */
  63                 unsigned char *buffer, int buflen);
  64
  65 int mw_write_oled_buffer(mwdevice_t *mwdevice,
  66         unsigned char mode, /* idle or scroll */
  67         unsigned char oled, /* which OLED */
  68         unsigned char numcols,
  69         unsigned char col_index, /* starting index */
  70         unsigned char *buffer, int buflen);
  71
  72 int mw_get_device_type_response(mwdevice_t *mwdevice, unsigned char devtype);
  73 void mw_set_get_device_type_response_cb(mwdevice_t *mwdevice, void (*mw_get_device_type_response_cb) (mwdevice_t *mwdevice, unsigned char devtype, void *user_data), void *user_data);
  74
  75 int mw_get_real_time_clock_response(mwdevice_t *mwdevice, unsigned char *rtcrsp, int len);
  76 void mw_set_get_real_time_clock_response_cb(mwdevice_t *mwdevice, void (*mw_get_real_time_clock_response_cb) (mwdevice_t *mwdevice, struct tm *mw_tm, void *user_data), void *user_data);
  77
  78 int mw_get_battery_voltage_response(mwdevice_t *mwdevice, unsigned char *batrsp, int len);
  79 void mw_set_get_battery_voltage_response_cb(mwdevice_t *mwdevice, void (*mw_get_battery_voltage_response_cb) (mwdevice_t *mwdevice, unsigned short *voltage, unsigned short *voltage_avg, unsigned char *pgood, unsigned char *charging, void *user_data), void *user_data);
  80
  81 int mw_read_button_config_response(mwdevice_t *mwdevice, unsigned char *btnrsp, int len);
  82
  83 int mw_button_event_message(mwdevice_t *mwdevice, unsigned char *btnevt, int len, unsigned char opts);
  84 void mw_set_button_event_message_cb(mwdevice_t *mwdevice, void (*mw_button_event_message_cb) (mwdevice_t *mwdevice, unsigned char buttons, unsigned char options, void *user_data), void *user_data);
  85
  86 int mw_read_light_sensor_response(mwdevice_t *mwdevice, unsigned char *lightrsp, int len);
  87 void mw_set_read_light_sensor_response_cb(mwdevice_t *mwdevice, void (*mw_read_light_sensor_response_cb) (mwdevice_t *mwdevice, unsigned short *light_level, unsigned short *light_level_avg, void *user_data), void *user_data);
  88
  89 int mw_status_change_event(mwdevice_t *mwdevice, unsigned char option, unsigned char *statrsp, int len);
  90 void mw_set_status_change_event_cb(mwdevice_t *mwdevice, void (*mw_status_change_event_cb) (mwdevice_t *mwdevice, unsigned char *scrmode, unsigned char *status, void *user_data), void *user_data);
  91
  92 int mw_low_battery_warning_message(mwdevice_t *mwdevice);
  93 void mw_set_low_battery_warning_message_cb(mwdevice_t *mwdevice, void (*mw_low_battery_warning_message_cb) (mwdevice_t *mwdevice, void *user_data), void *user_data);
  94
  95 int mw_low_battery_bt_off_message(mwdevice_t *mwdevice);
  96 void mw_set_low_battery_bt_off_message_cb(mwdevice_t *mwdevice, void (*mw_low_battery_bt_off_message_cb) (mwdevice_t *mwdevice, void *user_data), void *user_data);
  97
  98 int mw_enable_button(mwdevice_t *mwdevice, unsigned char mode, unsigned char button_index, unsigned char press_type, unsigned char callback_type, unsigned char callback_option);
  99
 100 int mw_disable_button(mwdevice_t *mwdevice, unsigned char mode, unsigned char button_index, unsigned char press_type);
 101
 102 int mw_advance_watch_hands(mwdevice_t *mwdevice, unsigned char hours, unsigned char minutes, unsigned char seconds);
 103
 104 int mw_battery_configuration(mwdevice_t *mwdevice, unsigned char warn_lvl, unsigned char bt_off_lvl);
 105
 106 int mw_decode_frame(mwdevice_t *mwdevice, unsigned char *buf, int len);
 107
 108 int mw_feed_msg_buffer(mwdevice_t *mwdevice, unsigned char *buf, int len);
 109
 110 int mw_init(mwdevice_t *mwdevice, int mw_fd);
 111
 112 /* helper function to flip bit order in a byte and optionally invert the image */
 113 void bmap_buffer_flipinvert(unsigned char flip, unsigned char invert, unsigned char *buf, int len);
 114
 115 void mw_send_bitmap(mwdevice_t *mwdevice, unsigned char mode, int width, int height, int offset, unsigned char *bmapbuf, int buflen);
 116
 117 #endif /* _METAWATCH_H */
 118