battery.c File Reference

Battery driver. More...

#include "battery.h"
#include "esp_idf_version.h"

Include dependency graph for battery.c:

Macros
#define	ADC_CHANNEL_DEFAULT   ADC1_CHANNEL_7
#define	ADC_WIDTH_DEFAULT   ADC_WIDTH_BIT_12
#define	ADC_ATTENUATION_DEFAULT   ADC_ATTEN_DB_2_5
#define	BATTERY_ENABLE_DEFAULT   17
#define	R2   100
#define	R3   10
#define	V_MAX   4200
#define	V_MIN   3300

Functions
int	battery_percentage (battery_t *const battery)
	Battery percentage. More...
void	battery_ctor (battery_t *const battery, adc1_channel_t ch, adc_bits_width_t width, adc_atten_t atten, gpio_num_t enable)
	Battery object constructor. More...
void	battery_default (battery_t *const battery)
	Set battery to default configuration. More...
void	battery_enable (battery_t *const battery)
	Enable battery reading. More...
void	battery_disable (battery_t *const battery)
	Disable battery reading. More...
esp_err_t	battery_init (battery_t *const battery)
	Initialize battery configuration: adc and gpio. More...
int	battery_read (battery_t *const battery)
	Get battery voltage reading. More...

Detailed Description

Battery driver.

Author

Jesus Minjares (https://github.com/jminjares4)

Version

0.1

Date

2022-09-01

Copyright

Copyright (c) 2022

Macro Definition Documentation

ADC_ATTENUATION_DEFAULT

#define ADC_ATTENUATION_DEFAULT   ADC_ATTEN_DB_2_5

ADC attentuation default

ADC_CHANNEL_DEFAULT

#define ADC_CHANNEL_DEFAULT   ADC1_CHANNEL_7

ADC channel default

ADC_WIDTH_DEFAULT

#define ADC_WIDTH_DEFAULT   ADC_WIDTH_BIT_12

ADC width default

BATTERY_ENABLE_DEFAULT

#define BATTERY_ENABLE_DEFAULT   17

Battery gpio default

R2

#define R2   100

R3

#define R3   10

V_MAX

#define V_MAX   4200

V_MIN

#define V_MIN   3300

Function Documentation

battery_ctor()

void battery_ctor	(	battery_t *const	battery,
		adc1_channel_t	ch,
		adc_bits_width_t	width,
		adc_atten_t	atten,
		gpio_num_t	enable
	)

Battery object constructor.

Parameters

battery	pointer to a const battery object
ch	adc channel
width	adc width
atten	adc attentuation
enable	battery gpio

Warning

Uses ADC1, please

See also

battery_t

battery_default()

void battery_default

(

battery_t *const

battery

)

Set battery to default configuration.

Parameters

battery

pointer to a const battery object

Note

Please

See also

battery_ctor()

Warning

Uses ADC1, please

See also

battery_t

battery_disable()

void battery_disable

(

battery_t *const

battery

)

Disable battery reading.

Parameters

battery

pointer to const battery object

battery_enable()

void battery_enable

(

battery_t *const

battery

)

Enable battery reading.

Parameters

battery

pointer to const battery object

battery_init()

esp_err_t battery_init

(

battery_t *const

battery

)

Initialize battery configuration: adc and gpio.

Parameters

battery

pointer to a const battery object

Returns

esp_err_t status

Note

For esp_err_t

See also

esp_err.h

Warning

Please use battery_ctor() or battery_default() prior of this function.

battery_percentage()

int battery_percentage

(

battery_t *const

battery

)

Battery percentage.

Parameters

battery

pointer to a const battery object

Returns

int percent value

battery_read()

int battery_read

(

battery_t *const

battery

)

Get battery voltage reading.

Parameters

battery

pointer to a const battery object

Returns

int voltage reading

Note

reading will be stored in battery.value