Go to the documentation of this file.
35 #include "mikrosdk_version.h"
38 #if mikroSDK_GET_VERSION < 20800ul
39 #include "rcu_delays.h"
45 #include "drv_digital_out.h"
46 #include "drv_digital_in.h"
47 #include "drv_i2c_master.h"
70 #define BATTMAN2_INT_GLBL0 0x00
71 #define BATTMAN2_INT_GLBL1 0x04
72 #define BATTMAN2_ERCFLAG 0x05
73 #define BATTMAN2_STAT_GLBL 0x06
74 #define BATTMAN2_INTM_GLBL1 0x08
75 #define BATTMAN2_INTM_GLBL0 0x09
76 #define BATTMAN2_CNFG_GLBL 0x10
77 #define BATTMAN2_CNFG_GPIO0 0x11
78 #define BATTMAN2_CNFG_GPIO1 0x12
79 #define BATTMAN2_CNFG_GPIO2 0x13
80 #define BATTMAN2_CID 0x14
81 #define BATTMAN2_CNFG_WDT 0x17
82 #define BATTMAN2_INT_CHG 0x01
83 #define BATTMAN2_STAT_CHG_A 0x02
84 #define BATTMAN2_STAT_CHG_B 0x03
85 #define BATTMAN2_INT_M_CHG 0x07
86 #define BATTMAN2_CNFG_CHG_A 0x20
87 #define BATTMAN2_CNFG_CHG_B 0x21
88 #define BATTMAN2_CNFG_CHG_C 0x22
89 #define BATTMAN2_CNFG_CHG_D 0x23
90 #define BATTMAN2_CNFG_CHG_E 0x24
91 #define BATTMAN2_CNFG_CHG_F 0x25
92 #define BATTMAN2_CNFG_CHG_G 0x26
93 #define BATTMAN2_CNFG_CHG_H 0x27
94 #define BATTMAN2_CNFG_CHG_I 0x28
95 #define BATTMAN2_CNFG_SBB0_A 0x29
96 #define BATTMAN2_CNFG_SBB0_B 0x2A
97 #define BATTMAN2_CNFG_SBB1_A 0x2B
98 #define BATTMAN2_CNFG_SBB1_B 0x2C
99 #define BATTMAN2_CNFG_SBB2_A 0x2D
100 #define BATTMAN2_CNFG_SBB2_B 0x2E
101 #define BATTMAN2_CNFG_SBB_TOP 0x2F
102 #define BATTMAN2_CNFG_LDO0_A 0x38
103 #define BATTMAN2_CNFG_LDO0_B 0x39
104 #define BATTMAN2_CNFG_LDO1_A 0x3A
105 #define BATTMAN2_CNFG_LDO1_B 0x3B
129 #define BATTMAN2_SEL_LED_RED 0x00
130 #define BATTMAN2_SEL_LED_YELLOW 0x01
131 #define BATTMAN2_SEL_LED_BLUE 0x02
132 #define BATTMAN2_PIN_STATE_OFF 0x00
133 #define BATTMAN2_PIN_STATE_ON 0x01
140 #define BATTMAN2_SEL_ALT_GPIO_STANDARD 0x00
141 #define BATTMAN2_SEL_ALT_GPIO_A_OUTPUT_SBB2 0x20
142 #define BATTMAN2_DBEN_GPI_NO_DEBOUNCE 0x00
143 #define BATTMAN2_DBEN_GPI_DEBOUNCE_30_ms 0x10
144 #define BATTMAN2_DO_GPIO_LOGIC_LOW 0x00
145 #define BATTMAN2_DO_GPIO_LOGIC_HIGH 0x08
146 #define BATTMAN2_DRV_OPEN_DRAIN 0x00
147 #define BATTMAN2_DRV_PUSH_PULL 0x04
148 #define BATTMAN2_DI_GPIO_LOGIC_LOW 0x00
149 #define BATTMAN2_DI_GPIO_LOGIC_HIGH 0x02
150 #define BATTMAN2_DIR_OUTPUT 0x00
151 #define BATTMAN2_DIR_INPUT 0x01
158 #define BATTMAN2_THM_HOT_411_mV 0x00
159 #define BATTMAN2_THM_HOT_367_mV 0x01
160 #define BATTMAN2_THM_HOT_327_mV 0x02
161 #define BATTMAN2_THM_HOT_291_mV 0x03
162 #define BATTMAN2_THM_WARM_511_mV 0x00
163 #define BATTMAN2_THM_WARM_459_mV 0x01
164 #define BATTMAN2_THM_WARM_411_mV 0x02
165 #define BATTMAN2_THM_WARM_367_mV 0x03
166 #define BATTMAN2_THM_COOL_923_mV 0x00
167 #define BATTMAN2_THM_COOL_867_mV 0x01
168 #define BATTMAN2_THM_COOL_807_mV 0x02
169 #define BATTMAN2_THM_COOL_747_mV 0x03
170 #define BATTMAN2_THM_COLD_1024_mV 0x00
171 #define BATTMAN2_THM_COLD_976_mV 0x01
172 #define BATTMAN2_THM_COLD_923_mV 0x02
173 #define BATTMAN2_THM_COLD_867_mV 0x03
180 #define BATTMAN2_BIT_MASK_CHARGER_DISABLE 0xFE
181 #define BATTMAN2_BIT_MASK_CHARGER_ENABLE 0x01
182 #define BATTMAN2_SET_CHARGER_DISABLE 0x00
183 #define BATTMAN2_SET_CHARGER_ENABLE 0x01
191 #define BATTMAN2_I_PQ_10_PERCENTAGE 0x00
192 #define BATTMAN2_I_PQ_20_PERCENTAGE 0x01
199 #define BATTMAN2_I_TERM_5_PERCENTAGE 0x00
200 #define BATTMAN2_I_TERM_7_5_PERCENTAGE 0x01
201 #define BATTMAN2_I_TERM_10_PERCENTAGE 0x02
202 #define BATTMAN2_I_TERM_15_PERCENTAGE 0x03
209 #define BATTMAN2_T_TOPOFF_0_MIN 0x00
210 #define BATTMAN2_T_TOPOFF_5_MIN 0x01
211 #define BATTMAN2_T_TOPOFF_10_MIN 0x02
212 #define BATTMAN2_T_TOPOFF_15_MIN 0x03
213 #define BATTMAN2_T_TOPOFF_20_MIN 0x04
214 #define BATTMAN2_T_TOPOFF_25_MIN 0x05
215 #define BATTMAN2_T_TOPOFF_30_MIN 0x06
216 #define BATTMAN2_T_TOPOFF_35_MIN 0x07
223 #define BATTMAN2_TJ_REG_60_C 0x00
224 #define BATTMAN2_TJ_REG_70_C 0x01
225 #define BATTMAN2_TJ_REG_80_C 0x02
226 #define BATTMAN2_TJ_REG_90_C 0x03
227 #define BATTMAN2_TJ_REG_100_C 0x04
234 #define BATTMAN2_T_FAST_CHG_TIMER_DISABLED 0x00
235 #define BATTMAN2_T_FAST_CHG_TIMER_3_HOURS 0x01
236 #define BATTMAN2_T_FAST_CHG_TIMER_5_HOURS 0x02
237 #define BATTMAN2_T_FAST_CHG_TIMER_7_HOURS 0x03
244 #define BATTMAN2_THM_EN_THERMISTOR_DISABLED 0x00
245 #define BATTMAN2_THM_EN_THERMISTOR_ENABLED 0x01
252 #define BATTMAN2_USBS_CHGIN_IS_NOT_SUSPENDED 0x00
253 #define BATTMAN2_USBS_CHGIN_IS_SUSPENDED 0x01
260 #define BATTMAN2_IMON_DISCHG_SCALE_8_2_mA 0x00
261 #define BATTMAN2_IMON_DISCHG_SCALE_40_5_mA 0x01
262 #define BATTMAN2_IMON_DISCHG_SCALE_72_3_mA 0x02
263 #define BATTMAN2_IMON_DISCHG_SCALE_103_4_mA 0x03
264 #define BATTMAN2_IMON_DISCHG_SCALE_134_1_mA 0x04
265 #define BATTMAN2_IMON_DISCHG_SCALE_164_1_mA 0x05
266 #define BATTMAN2_IMON_DISCHG_SCALE_193_7_mA 0x06
267 #define BATTMAN2_IMON_DISCHG_SCALE_222_7_mA 0x07
268 #define BATTMAN2_IMON_DISCHG_SCALE_251_2_mA 0x08
269 #define BATTMAN2_IMON_DISCHG_SCALE_279_3_mA 0x09
270 #define BATTMAN2_IMON_DISCHG_SCALE_300_mA 0x0A
277 #define BATTMAN2_MUX_SEL_MULTIPLEXER_DISABLED 0x00
278 #define BATTMAN2_MUX_SEL_CHGIN_VOLTAGE_MONITOR 0x01
279 #define BATTMAN2_MUX_SEL_CHGIN_CURRENT_MONITOR 0x02
280 #define BATTMAN2_MUX_SEL_BATT_VOLTAGE_MONITOR 0x03
281 #define BATTMAN2_MUX_SEL_BATT_CHARGE_CURRENT_MONITOR 0x04
282 #define BATTMAN2_MUX_SEL_BATT_DISCHARGE_CURRENT_NORMAL 0x05
283 #define BATTMAN2_MUX_SEL_BATT_DISCHARGE_CURRENT_NULLING 0x06
284 #define BATTMAN2_MUX_SEL_THM_VOLTAGE_MONITOR 0x07
285 #define BATTMAN2_MUX_SEL_TBIAS_VOLTAGE_MONITOR 0x08
286 #define BATTMAN2_MUX_SEL_AGND_VOLTAGE_MONITOR 0x09
287 #define BATTMAN2_MUX_SEL_SYS_VOLTAGE_MONITOR 0x0A
294 #define BATTMAN2_OP_MODE_BUCK_AND_BOOST 0x00
295 #define BATTMAN2_OP_MODE_BUCK 0x01
302 #define BATTMAN2_CURRENT_LIMIT_1000_mA 0x00
303 #define BATTMAN2_CURRENT_LIMIT_750_mA 0x01
304 #define BATTMAN2_CURRENT_LIMIT_500_mA 0x02
305 #define BATTMAN2_CURRENT_LIMIT_333_mA 0x03
312 #define BATTMAN2_ACTIVE_DISCHARGE_DISABLE 0x00
313 #define BATTMAN2_ACTIVE_DISCHARGE_ENABLE 0x01
320 #define BATTMAN2_ENABLE_CONTROL_FPS_SLOT_0 0x00
321 #define BATTMAN2_ENABLE_CONTROL_FPS_SLOT_1 0x01
322 #define BATTMAN2_ENABLE_CONTROL_FPS_SLOT_2 0x02
323 #define BATTMAN2_ENABLE_CONTROL_FPS_SLOT_3 0x03
324 #define BATTMAN2_ENABLE_CONTROL_OFF_IRRESPECTIVE_FPS 0x04
325 #define BATTMAN2_ENABLE_CONTROL_ON_IRRESPECTIVE_FPS 0x06
332 #define BATTMAN2_ICHGIN_LIM_95_mA 0x00
333 #define BATTMAN2_ICHGIN_LIM_190_mA 0x01
334 #define BATTMAN2_ICHGIN_LIM_285_mA 0x02
335 #define BATTMAN2_ICHGIN_LIM_380_mA 0x03
336 #define BATTMAN2_ICHGIN_LIM_475_mA 0x04
343 #define BATTMAN2_DRV_SBB_FAST_TRANSITION_TIME 0x00
344 #define BATTMAN2_DRV_SBB_TRANSITION_TIME_1 0x01
345 #define BATTMAN2_DRV_SBB_TRANSITION_TIME_2 0x02
346 #define BATTMAN2_DRV_SBB_TRANSITION_TIME_3 0x03
353 #define BATTMAN2_SBB_CH_0 0x00
354 #define BATTMAN2_SBB_CH_1 0x01
355 #define BATTMAN2_SBB_CH_2 0x02
362 #define BATTMAN2_SET_DEV_ADDR 0x48
380 #define BATTMAN2_CHG_DTLS_OFF 0x00
381 #define BATTMAN2_CHG_DTLS_PREQUALIFICATION_MODE 0x01
382 #define BATTMAN2_CHG_DTLS_FAST_CHARGE_CONSTANT_CURRENT 0x02
383 #define BATTMAN2_CHG_DTLS_JEITA_MODIFIED_FAST_CHRG_CC 0x03
384 #define BATTMAN2_CHG_DTLS_FAST_CHARGE_CONSTANT_VOLTAGE 0x04
385 #define BATTMAN2_CHG_DTLS_JEITA_MODIFIED_FAST_CHRG_CV 0x05
386 #define BATTMAN2_CHG_DTLS_TOP_OFF_MODE 0x06
387 #define BATTMAN2_CHG_DTLS_JEITA_MODIFIED_TOP_OFF_MODE 0x07
388 #define BATTMAN2_CHG_DTLS_DONE 0x08
389 #define BATTMAN2_CHG_DTLS_JEITA_MODIFIED_DONE 0x09
390 #define BATTMAN2_CHG_DTLS_PREQUALIFICATION_TIMER_FAULT 0x0A
391 #define BATTMAN2_CHG_DTLS_FAST_CHARGE_TIMER_FAULT 0x0B
392 #define BATTMAN2_CHG_DTLS_BATTERY_TEMPERATURE_FAULT 0x0C
398 #define BATTMAN2_CHG_NO_CHARGING 0x00
399 #define BATTMAN2_CHG_CHARGING 0x01
417 #define BATTMAN2_MAP_MIKROBUS( cfg, mikrobus ) \
418 cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
419 cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
420 cfg.rst = MIKROBUS( mikrobus, MIKROBUS_RST ); \
421 cfg.irq = MIKROBUS( mikrobus, MIKROBUS_INT )
uint8_t active_discharge_enable
Definition: battman2.h:547
uint8_t tj_reg_stat
Definition: battman2.h:513
uint8_t current_limit
Definition: battman2.h:546
err_t battman2_generic_read(battman2_t *ctx, uint8_t reg, uint8_t *rx_buf, uint8_t rx_len)
BATT-MAN 2 I2C reading function.
battman2_return_value_t
BATT-MAN 2 Click return value data.
Definition: battman2.h:468
uint8_t chg
Definition: battman2.h:517
uint8_t mux_sel
Definition: battman2.h:500
uint8_t current_limit
Definition: battman2.h:530
err_t battman2_check_stat(battman2_t *ctx, uint8_t *stat)
BATT-MAN 2 check states function.
digital_out_t rst
Definition: battman2.h:433
uint8_t thm_cold
Definition: battman2.h:483
pin_name_t irq
Definition: battman2.h:456
i2c_master_t i2c
Definition: battman2.h:439
err_t battman2_get_chg_status(battman2_t *ctx, battman2_stat_chg_t *chg_stat)
BATT-MAN 2 get charger status function.
uint8_t ichgin_lim_stat
Definition: battman2.h:511
uint8_t thm_en
Definition: battman2.h:495
err_t battman2_get_sbb_config(battman2_t *ctx, uint8_t sbb_sel, battman2_sbb_cnfg_t *sbb_cfg)
BATT-MAN 2 get SBB configuration function.
float vsys_reg
Definition: battman2.h:491
float chg_pq
Definition: battman2.h:487
@ BATTMAN2_OK
Definition: battman2.h:469
uint32_t i2c_speed
Definition: battman2.h:458
err_t battman2_default_cfg(battman2_t *ctx)
BATT-MAN 2 default configuration function.
uint8_t thm_cool
Definition: battman2.h:482
pin_name_t scl
Definition: battman2.h:452
err_t battman2_set_gpio_output(battman2_t *ctx, uint8_t gpio_sel, uint8_t led_state)
BATT-MAN 2 set gpio output state function.
uint8_t vchgin_min_stat
Definition: battman2.h:510
BATT-MAN 2 Click LDO configuration object.
Definition: battman2.h:543
@ BATTMAN2_ERROR
Definition: battman2.h:470
float ichgin_lim
Definition: battman2.h:485
void battman2_cfg_setup(battman2_cfg_t *cfg)
BATT-MAN 2 configuration object setup function.
uint8_t usbs
Definition: battman2.h:497
uint8_t enable_control
Definition: battman2.h:548
float chg_cv_jeita
Definition: battman2.h:498
uint8_t t_fast_chg
Definition: battman2.h:493
digital_in_t irq
Definition: battman2.h:436
uint8_t thm_hot
Definition: battman2.h:480
float chg_cv
Definition: battman2.h:496
err_t battman2_hw_reset(battman2_t *ctx)
BATT-MAN 2 hw reset function.
uint8_t t_topoff
Definition: battman2.h:489
float chg_cc
Definition: battman2.h:492
uint8_t battman2_check_interrupt(battman2_t *ctx)
BATT-MAN 2 check interrupt function.
BATT-MAN 2 Click charger status object.
Definition: battman2.h:509
err_t battman2_get_id(battman2_t *ctx, uint8_t *cid)
BATT-MAN 2 get device ID function.
void battman2_led_intro(battman2_t *ctx)
BATT-MAN 2 LED intro function.
uint8_t ichgin_lim_def
Definition: battman2.h:533
err_t battman2_check_int_glbl(battman2_t *ctx, uint8_t *int_glbl0, uint8_t *int_glbl1)
BATT-MAN 2 check global interrupts function.
uint8_t i_pq
Definition: battman2.h:486
err_t battman2_init(battman2_t *ctx, battman2_cfg_t *cfg)
BATT-MAN 2 initialization function.
uint8_t thm_warm
Definition: battman2.h:481
float output_vtg
Definition: battman2.h:544
err_t battman2_set_charger_cfg(battman2_t *ctx, battman2_chg_cnfg_t chg_cnfg)
BATT-MAN 2 set charger configuration function.
uint8_t enable_control
Definition: battman2.h:532
err_t battman2_check_faults_occurred(battman2_t *ctx, uint8_t *faults)
BATT-MAN 2 check faults occurred function.
uint8_t tj_reg
Definition: battman2.h:490
pin_name_t sda
Definition: battman2.h:453
uint8_t drv_sbb
Definition: battman2.h:534
uint8_t op_mode
Definition: battman2.h:529
BATT-MAN 2 Click context object.
Definition: battman2.h:431
uint8_t chg_dtls
Definition: battman2.h:515
BATT-MAN 2 Click Buck and boost configuration object.
Definition: battman2.h:527
pin_name_t rst
Definition: battman2.h:455
float output_vtg
Definition: battman2.h:528
uint8_t time_sus
Definition: battman2.h:518
uint8_t slave_address
Definition: battman2.h:442
uint8_t thm_dtls
Definition: battman2.h:514
err_t battman2_set_ldo_config(battman2_t *ctx, battman2_ldo_cnfg_t ldo_cfg)
BATT-MAN 2 set LDO configuration function.
BATT-MAN 2 Click charger configuration object.
Definition: battman2.h:479
uint8_t i2c_address
Definition: battman2.h:459
float vchgin_min
Definition: battman2.h:484
err_t battman2_set_sbb_config(battman2_t *ctx, uint8_t sbb_sel, battman2_sbb_cnfg_t sbb_cfg)
BATT-MAN 2 set SBB configuration function.
uint8_t active_discharge_enable
Definition: battman2.h:531
uint8_t chgin_dtls
Definition: battman2.h:516
uint8_t imon_dischg_scale
Definition: battman2.h:499
float chg_cc_jeita
Definition: battman2.h:494
BATT-MAN 2 Click configuration object.
Definition: battman2.h:451
err_t battman2_set_charger_enable(battman2_t *ctx, uint8_t en_chg)
BATT-MAN 2 set charger enable function.
err_t battman2_get_ldo_config(battman2_t *ctx, battman2_ldo_cnfg_t *ldo_cfg)
BATT-MAN 2 get LDO configuration function.
uint8_t i_term
Definition: battman2.h:488
err_t battman2_get_charger_cfg(battman2_t *ctx, battman2_chg_cnfg_t *chg_cnfg)
BATT-MAN 2 get charger configuration function.
uint8_t op_mode
Definition: battman2.h:545
err_t battman2_generic_write(battman2_t *ctx, uint8_t reg, uint8_t *tx_buf, uint8_t tx_len)
BATT-MAN 2 I2C writing function.
uint8_t vsys_min_stat
Definition: battman2.h:512