Update to spec
[metawatch.git] / 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