diff options
Diffstat (limited to 'firmware/export/cw2015.h')
-rw-r--r-- | firmware/export/cw2015.h | 57 |
1 files changed, 57 insertions, 0 deletions
diff --git a/firmware/export/cw2015.h b/firmware/export/cw2015.h new file mode 100644 index 0000000000..c810d1b7b5 --- /dev/null +++ b/firmware/export/cw2015.h | |||
@@ -0,0 +1,57 @@ | |||
1 | /*************************************************************************** | ||
2 | * __________ __ ___. | ||
3 | * Open \______ \ ____ ____ | | _\_ |__ _______ ___ | ||
4 | * Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ / | ||
5 | * Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < < | ||
6 | * Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \ | ||
7 | * \/ \/ \/ \/ \/ | ||
8 | * $Id$ | ||
9 | * | ||
10 | * Copyright (C) 2021 Aidan MacDonald | ||
11 | * | ||
12 | * This program is free software; you can redistribute it and/or | ||
13 | * modify it under the terms of the GNU General Public License | ||
14 | * as published by the Free Software Foundation; either version 2 | ||
15 | * of the License, or (at your option) any later version. | ||
16 | * | ||
17 | * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY | ||
18 | * KIND, either express or implied. | ||
19 | * | ||
20 | ****************************************************************************/ | ||
21 | |||
22 | #ifndef __CW2015_H__ | ||
23 | #define __CW2015_H__ | ||
24 | |||
25 | #include <stdint.h> | ||
26 | #include <stdbool.h> | ||
27 | |||
28 | /* Driver for I2C battery fuel gauge IC CW2015. */ | ||
29 | |||
30 | #define CW2015_REG_VERSION 0x00 | ||
31 | #define CW2015_REG_VCELL 0x02 /* 14 bits, registers 0x02 - 0x03 */ | ||
32 | #define CW2015_REG_SOC 0x04 /* 16 bits, registers 0x04 - 0x05 */ | ||
33 | #define CW2015_REG_RRT_ALERT 0x06 /* 13 bit RRT + alert flag, 0x06-0x07 */ | ||
34 | #define CW2015_REG_CONFIG 0x08 | ||
35 | #define CW2015_REG_MODE 0x0a | ||
36 | #define CW2015_REG_BATINFO 0x10 /* cf. mainline Linux CW2015 driver */ | ||
37 | #define CW2015_SIZE_BATINFO 64 | ||
38 | |||
39 | extern void cw2015_init(void); | ||
40 | |||
41 | /* Read the battery terminal voltage, converted to millivolts. */ | ||
42 | extern int cw2015_get_vcell(void); | ||
43 | |||
44 | /* Read the SOC, in percent (0-100%). */ | ||
45 | extern int cw2015_get_soc(void); | ||
46 | |||
47 | /* Get the estimated remaining run time, in minutes. | ||
48 | * Not a linearly varying quantity, according to the datasheet. */ | ||
49 | extern int cw2015_get_rrt(void); | ||
50 | |||
51 | /* Read the current battery profile */ | ||
52 | extern const uint8_t* cw2015_get_bat_info(void); | ||
53 | |||
54 | /* Debug screen */ | ||
55 | extern bool cw2015_debug_menu(void); | ||
56 | |||
57 | #endif /* __CW2015_H__ */ | ||