mirror of https://github.com/arendst/Tasmota.git
828 lines
25 KiB
C++
828 lines
25 KiB
C++
/////////////////////////////////////////////////////////////////
|
||
/*
|
||
MIT License
|
||
|
||
Copyright (c) 2019 lewis he
|
||
|
||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||
of this software and associated documentation files (the "Software"), to deal
|
||
in the Software without restriction, including without limitation the rights
|
||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||
copies of the Software, and to permit persons to whom the Software is
|
||
furnished to do so, subject to the following conditions:
|
||
|
||
The above copyright notice and this permission notice shall be included in all
|
||
copies or substantial portions of the Software.
|
||
|
||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||
SOFTWARE.
|
||
|
||
axp20x.h - Arduino library for X-Power AXP202 chip.
|
||
Created by Lewis he on April 1, 2019.
|
||
github:https://github.com/lewisxhe/AXP202X_Libraries
|
||
*/
|
||
/////////////////////////////////////////////////////////////////
|
||
#pragma once
|
||
|
||
#include <Arduino.h>
|
||
#include <Wire.h>
|
||
|
||
// #define AXP_DEBUG_PORT Serial
|
||
#ifdef AXP_DEBUG_PORT
|
||
#define AXP_DEBUG(fmt, ...) AXP_DEBUG_PORT.printf_P((PGM_P)PSTR(fmt), ##__VA_ARGS__)
|
||
#else
|
||
#define AXP_DEBUG(...)
|
||
#endif
|
||
|
||
#ifndef RISING
|
||
#define RISING 0x01
|
||
#endif
|
||
|
||
#ifndef FALLING
|
||
#define FALLING 0x02
|
||
#endif
|
||
|
||
#ifdef _BV
|
||
#undef _BV
|
||
#endif
|
||
#define _BV(b) (1ULL << (b))
|
||
|
||
//! Error Code
|
||
#define AXP_PASS (0)
|
||
#define AXP_FAIL (-1)
|
||
#define AXP_INVALID (-2)
|
||
#define AXP_NOT_INIT (-3)
|
||
#define AXP_NOT_SUPPORT (-4)
|
||
#define AXP_ARG_INVALID (-5)
|
||
|
||
//! Chip Address
|
||
#define AXP202_SLAVE_ADDRESS (0x35)
|
||
#define AXP192_SLAVE_ADDRESS (0x34)
|
||
#define AXP173_SLAVE_ADDRESS (0x34)
|
||
|
||
//! Chip ID
|
||
#define AXP202_CHIP_ID 0x41
|
||
#define AXP192_CHIP_ID 0x03
|
||
#define AXP173_CHIP_ID 0xAD //!Axp173 does not have a chip ID, given a custom ID
|
||
|
||
//! Logic states
|
||
#define AXP202_ON 1
|
||
#define AXP202_OFF 0
|
||
|
||
//! REG MAP
|
||
#define AXP202_STATUS (0x00)
|
||
#define AXP202_MODE_CHGSTATUS (0x01)
|
||
#define AXP202_OTG_STATUS (0x02)
|
||
#define AXP202_IC_TYPE (0x03)
|
||
#define AXP202_DATA_BUFFER1 (0x04)
|
||
#define AXP202_DATA_BUFFER2 (0x05)
|
||
#define AXP202_DATA_BUFFER3 (0x06)
|
||
#define AXP202_DATA_BUFFER4 (0x07)
|
||
#define AXP202_DATA_BUFFER5 (0x08)
|
||
#define AXP202_DATA_BUFFER6 (0x09)
|
||
#define AXP202_DATA_BUFFER7 (0x0A)
|
||
#define AXP202_DATA_BUFFER8 (0x0B)
|
||
#define AXP202_DATA_BUFFER9 (0x0C)
|
||
#define AXP202_DATA_BUFFERA (0x0D)
|
||
#define AXP202_DATA_BUFFERB (0x0E)
|
||
#define AXP202_DATA_BUFFERC (0x0F)
|
||
#define AXP202_LDO234_DC23_CTL (0x12)
|
||
#define AXP202_DC2OUT_VOL (0x23)
|
||
#define AXP202_LDO3_DC2_DVM (0x25)
|
||
#define AXP202_DC3OUT_VOL (0x27)
|
||
#define AXP202_LDO24OUT_VOL (0x28)
|
||
#define AXP202_LDO3OUT_VOL (0x29)
|
||
#define AXP202_IPS_SET (0x30)
|
||
#define AXP202_VOFF_SET (0x31)
|
||
#define AXP202_OFF_CTL (0x32)
|
||
#define AXP202_CHARGE1 (0x33)
|
||
#define AXP202_CHARGE2 (0x34)
|
||
#define AXP202_BACKUP_CHG (0x35)
|
||
#define AXP202_POK_SET (0x36)
|
||
#define AXP202_DCDC_FREQSET (0x37)
|
||
#define AXP202_VLTF_CHGSET (0x38)
|
||
#define AXP202_VHTF_CHGSET (0x39)
|
||
#define AXP202_APS_WARNING1 (0x3A)
|
||
#define AXP202_APS_WARNING2 (0x3B)
|
||
#define AXP202_TLTF_DISCHGSET (0x3C)
|
||
#define AXP202_THTF_DISCHGSET (0x3D)
|
||
#define AXP202_DCDC_MODESET (0x80)
|
||
#define AXP202_ADC_EN1 (0x82)
|
||
#define AXP202_ADC_EN2 (0x83)
|
||
#define AXP202_ADC_SPEED (0x84)
|
||
#define AXP202_ADC_INPUTRANGE (0x85)
|
||
#define AXP202_ADC_IRQ_RETFSET (0x86)
|
||
#define AXP202_ADC_IRQ_FETFSET (0x87)
|
||
#define AXP202_TIMER_CTL (0x8A)
|
||
#define AXP202_VBUS_DET_SRP (0x8B)
|
||
#define AXP202_HOTOVER_CTL (0x8F)
|
||
#define AXP202_GPIO0_CTL (0x90)
|
||
#define AXP202_GPIO0_VOL (0x91)
|
||
#define AXP202_GPIO1_CTL (0x92)
|
||
#define AXP202_GPIO2_CTL (0x93)
|
||
#define AXP202_GPIO012_SIGNAL (0x94)
|
||
#define AXP202_GPIO3_CTL (0x95)
|
||
#define AXP202_INTEN1 (0x40)
|
||
#define AXP202_INTEN2 (0x41)
|
||
#define AXP202_INTEN3 (0x42)
|
||
#define AXP202_INTEN4 (0x43)
|
||
#define AXP202_INTEN5 (0x44)
|
||
#define AXP202_INTSTS1 (0x48)
|
||
#define AXP202_INTSTS2 (0x49)
|
||
#define AXP202_INTSTS3 (0x4A)
|
||
#define AXP202_INTSTS4 (0x4B)
|
||
#define AXP202_INTSTS5 (0x4C)
|
||
|
||
//Irq control register
|
||
#define AXP192_INTEN1 (0x40)
|
||
#define AXP192_INTEN2 (0x41)
|
||
#define AXP192_INTEN3 (0x42)
|
||
#define AXP192_INTEN4 (0x43)
|
||
#define AXP192_INTEN5 (0x4A)
|
||
//Irq status register
|
||
#define AXP192_INTSTS1 (0x44)
|
||
#define AXP192_INTSTS2 (0x45)
|
||
#define AXP192_INTSTS3 (0x46)
|
||
#define AXP192_INTSTS4 (0x47)
|
||
#define AXP192_INTSTS5 (0x4D)
|
||
|
||
#define AXP192_DC1_VLOTAGE (0x26)
|
||
#define AXP192_LDO23OUT_VOL (0x28)
|
||
#define AXP192_GPIO0_CTL (0x90)
|
||
#define AXP192_GPIO0_VOL (0x91)
|
||
#define AXP192_GPIO1_CTL (0X92)
|
||
#define AXP192_GPIO2_CTL (0x93)
|
||
#define AXP192_GPIO012_SIGNAL (0x94)
|
||
#define AXP192_GPIO34_CTL (0x95)
|
||
|
||
|
||
|
||
/* axp 192/202 adc data register */
|
||
#define AXP202_BAT_AVERVOL_H8 (0x78)
|
||
#define AXP202_BAT_AVERVOL_L4 (0x79)
|
||
#define AXP202_BAT_AVERCHGCUR_H8 (0x7A)
|
||
#define AXP202_BAT_AVERCHGCUR_L4 (0x7B)
|
||
#define AXP202_BAT_AVERCHGCUR_L5 (0x7B)
|
||
#define AXP202_ACIN_VOL_H8 (0x56)
|
||
#define AXP202_ACIN_VOL_L4 (0x57)
|
||
#define AXP202_ACIN_CUR_H8 (0x58)
|
||
#define AXP202_ACIN_CUR_L4 (0x59)
|
||
#define AXP202_VBUS_VOL_H8 (0x5A)
|
||
#define AXP202_VBUS_VOL_L4 (0x5B)
|
||
#define AXP202_VBUS_CUR_H8 (0x5C)
|
||
#define AXP202_VBUS_CUR_L4 (0x5D)
|
||
#define AXP202_INTERNAL_TEMP_H8 (0x5E)
|
||
#define AXP202_INTERNAL_TEMP_L4 (0x5F)
|
||
#define AXP202_TS_IN_H8 (0x62)
|
||
#define AXP202_TS_IN_L4 (0x63)
|
||
#define AXP202_GPIO0_VOL_ADC_H8 (0x64)
|
||
#define AXP202_GPIO0_VOL_ADC_L4 (0x65)
|
||
#define AXP202_GPIO1_VOL_ADC_H8 (0x66)
|
||
#define AXP202_GPIO1_VOL_ADC_L4 (0x67)
|
||
|
||
#define AXP202_BAT_AVERDISCHGCUR_H8 (0x7C)
|
||
#define AXP202_BAT_AVERDISCHGCUR_L5 (0x7D)
|
||
#define AXP202_APS_AVERVOL_H8 (0x7E)
|
||
#define AXP202_APS_AVERVOL_L4 (0x7F)
|
||
#define AXP202_INT_BAT_CHGCUR_H8 (0xA0)
|
||
#define AXP202_INT_BAT_CHGCUR_L4 (0xA1)
|
||
#define AXP202_EXT_BAT_CHGCUR_H8 (0xA2)
|
||
#define AXP202_EXT_BAT_CHGCUR_L4 (0xA3)
|
||
#define AXP202_INT_BAT_DISCHGCUR_H8 (0xA4)
|
||
#define AXP202_INT_BAT_DISCHGCUR_L4 (0xA5)
|
||
#define AXP202_EXT_BAT_DISCHGCUR_H8 (0xA6)
|
||
#define AXP202_EXT_BAT_DISCHGCUR_L4 (0xA7)
|
||
#define AXP202_BAT_CHGCOULOMB3 (0xB0)
|
||
#define AXP202_BAT_CHGCOULOMB2 (0xB1)
|
||
#define AXP202_BAT_CHGCOULOMB1 (0xB2)
|
||
#define AXP202_BAT_CHGCOULOMB0 (0xB3)
|
||
#define AXP202_BAT_DISCHGCOULOMB3 (0xB4)
|
||
#define AXP202_BAT_DISCHGCOULOMB2 (0xB5)
|
||
#define AXP202_BAT_DISCHGCOULOMB1 (0xB6)
|
||
#define AXP202_BAT_DISCHGCOULOMB0 (0xB7)
|
||
#define AXP202_COULOMB_CTL (0xB8)
|
||
#define AXP202_BAT_POWERH8 (0x70)
|
||
#define AXP202_BAT_POWERM8 (0x71)
|
||
#define AXP202_BAT_POWERL8 (0x72)
|
||
|
||
#define AXP202_VREF_TEM_CTRL (0xF3)
|
||
#define AXP202_BATT_PERCENTAGE (0xB9)
|
||
|
||
/* bit definitions for AXP events, irq event */
|
||
/* AXP202 */
|
||
#define AXP202_IRQ_USBLO (1)
|
||
#define AXP202_IRQ_USBRE (2)
|
||
#define AXP202_IRQ_USBIN (3)
|
||
#define AXP202_IRQ_USBOV (4)
|
||
#define AXP202_IRQ_ACRE (5)
|
||
#define AXP202_IRQ_ACIN (6)
|
||
#define AXP202_IRQ_ACOV (7)
|
||
|
||
#define AXP202_IRQ_TEMLO (8)
|
||
#define AXP202_IRQ_TEMOV (9)
|
||
#define AXP202_IRQ_CHAOV (10)
|
||
#define AXP202_IRQ_CHAST (11)
|
||
#define AXP202_IRQ_BATATOU (12)
|
||
#define AXP202_IRQ_BATATIN (13)
|
||
#define AXP202_IRQ_BATRE (14)
|
||
#define AXP202_IRQ_BATIN (15)
|
||
|
||
#define AXP202_IRQ_POKLO (16)
|
||
#define AXP202_IRQ_POKSH (17)
|
||
#define AXP202_IRQ_LDO3LO (18)
|
||
#define AXP202_IRQ_DCDC3LO (19)
|
||
#define AXP202_IRQ_DCDC2LO (20)
|
||
#define AXP202_IRQ_CHACURLO (22)
|
||
#define AXP202_IRQ_ICTEMOV (23)
|
||
|
||
#define AXP202_IRQ_EXTLOWARN2 (24)
|
||
#define AXP202_IRQ_EXTLOWARN1 (25)
|
||
#define AXP202_IRQ_SESSION_END (26)
|
||
#define AXP202_IRQ_SESS_AB_VALID (27)
|
||
#define AXP202_IRQ_VBUS_UN_VALID (28)
|
||
#define AXP202_IRQ_VBUS_VALID (29)
|
||
#define AXP202_IRQ_PDOWN_BY_NOE (30)
|
||
#define AXP202_IRQ_PUP_BY_NOE (31)
|
||
|
||
#define AXP202_IRQ_GPIO0TG (32)
|
||
#define AXP202_IRQ_GPIO1TG (33)
|
||
#define AXP202_IRQ_GPIO2TG (34)
|
||
#define AXP202_IRQ_GPIO3TG (35)
|
||
#define AXP202_IRQ_PEKFE (37)
|
||
#define AXP202_IRQ_PEKRE (38)
|
||
#define AXP202_IRQ_TIMER (39)
|
||
|
||
//Signal Capture
|
||
#define AXP202_BATT_VOLTAGE_STEP (1.1F)
|
||
#define AXP202_BATT_DISCHARGE_CUR_STEP (0.5F)
|
||
#define AXP202_BATT_CHARGE_CUR_STEP (0.5F)
|
||
#define AXP202_ACIN_VOLTAGE_STEP (1.7F)
|
||
#define AXP202_ACIN_CUR_STEP (0.625F)
|
||
#define AXP202_VBUS_VOLTAGE_STEP (1.7F)
|
||
#define AXP202_VBUS_CUR_STEP (0.375F)
|
||
#define AXP202_INTERNAL_TEMP_STEP (0.1F)
|
||
#define AXP202_APS_VOLTAGE_STEP (1.4F)
|
||
#define AXP202_TS_PIN_OUT_STEP (0.8F)
|
||
#define AXP202_GPIO0_STEP (0.5F)
|
||
#define AXP202_GPIO1_STEP (0.5F)
|
||
// AXP192 only
|
||
#define AXP202_GPIO2_STEP (0.5F)
|
||
#define AXP202_GPIO3_STEP (0.5F)
|
||
|
||
// AXP173
|
||
#define AXP173_EXTEN_DC2_CTL (0x10)
|
||
#define AXP173_CTL_DC2_BIT (0)
|
||
#define AXP173_CTL_EXTEN_BIT (2)
|
||
#define AXP173_DC1_VLOTAGE (0x26)
|
||
#define AXP173_LDO4_VLOTAGE (0x27)
|
||
|
||
#define FORCED_OPEN_DCDC3(x) (x |= (AXP202_ON << AXP202_DCDC3))
|
||
#define BIT_MASK(x) (1 << x)
|
||
#define IS_OPEN(reg, channel) (bool)(reg & BIT_MASK(channel))
|
||
|
||
enum {
|
||
AXP202_EXTEN = 0,
|
||
AXP202_DCDC3 = 1,
|
||
AXP202_LDO2 = 2,
|
||
AXP202_LDO4 = 3,
|
||
AXP202_DCDC2 = 4,
|
||
AXP202_LDO3 = 6,
|
||
AXP202_OUTPUT_MAX,
|
||
};
|
||
|
||
enum {
|
||
AXP192_DCDC1 = 0,
|
||
AXP192_DCDC3 = 1,
|
||
AXP192_LDO2 = 2,
|
||
AXP192_LDO3 = 3,
|
||
AXP192_DCDC2 = 4,
|
||
AXP192_EXTEN = 6,
|
||
AXP192_OUTPUT_MAX,
|
||
};
|
||
|
||
enum {
|
||
AXP173_DCDC1 = 0,
|
||
AXP173_LDO4 = 1,
|
||
AXP173_LDO2 = 2,
|
||
AXP173_LDO3 = 3,
|
||
AXP173_DCDC2 = 4,
|
||
AXP173_EXTEN = 6,
|
||
AXP173_OUTPUT_MAX,
|
||
};
|
||
|
||
typedef enum {
|
||
AXP202_STARTUP_TIME_128MS,
|
||
AXP202_STARTUP_TIME_3S,
|
||
AXP202_STARTUP_TIME_1S,
|
||
AXP202_STARTUP_TIME_2S,
|
||
} axp202_startup_time_t;
|
||
|
||
typedef enum {
|
||
AXP192_STARTUP_TIME_128MS,
|
||
AXP192_STARTUP_TIME_512MS,
|
||
AXP192_STARTUP_TIME_1S,
|
||
AXP192_STARTUP_TIME_2S,
|
||
} axp192_startup_time_t;
|
||
|
||
typedef enum {
|
||
AXP_LONGPRESS_TIME_1S,
|
||
AXP_LONGPRESS_TIME_1S5,
|
||
AXP_LONGPRESS_TIME_2S,
|
||
AXP_LONGPRESS_TIME_2S5,
|
||
} axp_loonPress_time_t;
|
||
|
||
typedef enum {
|
||
AXP_POWER_OFF_TIME_4S,
|
||
AXP_POWER_OFF_TIME_65,
|
||
AXP_POWER_OFF_TIME_8S,
|
||
AXP_POWER_OFF_TIME_16S,
|
||
} axp_poweroff_time_t;
|
||
|
||
//REG 33H: Charging control 1 Charging target-voltage setting
|
||
typedef enum {
|
||
AXP202_TARGET_VOL_4_1V,
|
||
AXP202_TARGET_VOL_4_15V,
|
||
AXP202_TARGET_VOL_4_2V,
|
||
AXP202_TARGET_VOL_4_36V
|
||
} axp_chargeing_vol_t;
|
||
|
||
//REG 82H: ADC Enable 1 register Parameter
|
||
typedef enum {
|
||
AXP202_BATT_VOL_ADC1 = 1 << 7,
|
||
AXP202_BATT_CUR_ADC1 = 1 << 6,
|
||
AXP202_ACIN_VOL_ADC1 = 1 << 5,
|
||
AXP202_ACIN_CUR_ADC1 = 1 << 4,
|
||
AXP202_VBUS_VOL_ADC1 = 1 << 3,
|
||
AXP202_VBUS_CUR_ADC1 = 1 << 2,
|
||
AXP202_APS_VOL_ADC1 = 1 << 1,
|
||
AXP202_TS_PIN_ADC1 = 1 << 0
|
||
} axp_adc1_func_t;
|
||
|
||
// REG 83H: ADC Enable 2 register Parameter
|
||
typedef enum {
|
||
AXP202_TEMP_MONITORING_ADC2 = 1 << 7,
|
||
AXP202_GPIO1_FUNC_ADC2 = 1 << 3,
|
||
AXP202_GPIO0_FUNC_ADC2 = 1 << 2
|
||
} axp_adc2_func_t;
|
||
|
||
typedef enum {
|
||
AXP202_LDO3_MODE_LDO,
|
||
AXP202_LDO3_MODE_DCIN
|
||
} axp202_ldo3_mode_t;
|
||
|
||
|
||
|
||
typedef enum {
|
||
//! IRQ1 REG 40H
|
||
AXP202_VBUS_VHOLD_LOW_IRQ = _BV(1), //VBUS is available, but lower than V HOLD, IRQ enable
|
||
AXP202_VBUS_REMOVED_IRQ = _BV(2), //VBUS removed, IRQ enable
|
||
AXP202_VBUS_CONNECT_IRQ = _BV(3), //VBUS connected, IRQ enable
|
||
AXP202_VBUS_OVER_VOL_IRQ = _BV(4), //VBUS over-voltage, IRQ enable
|
||
AXP202_ACIN_REMOVED_IRQ = _BV(5), //ACIN removed, IRQ enable
|
||
AXP202_ACIN_CONNECT_IRQ = _BV(6), //ACIN connected, IRQ enable
|
||
AXP202_ACIN_OVER_VOL_IRQ = _BV(7), //ACIN over-voltage, IRQ enable
|
||
|
||
//! IRQ2 REG 41H
|
||
AXP202_BATT_LOW_TEMP_IRQ = _BV(8), //Battery low-temperature, IRQ enable
|
||
AXP202_BATT_OVER_TEMP_IRQ = _BV(9), //Battery over-temperature, IRQ enable
|
||
AXP202_CHARGING_FINISHED_IRQ = _BV(10), //Charge finished, IRQ enable
|
||
AXP202_CHARGING_IRQ = _BV(11), //Be charging, IRQ enable
|
||
AXP202_BATT_EXIT_ACTIVATE_IRQ = _BV(12), //Exit battery activate mode, IRQ enable
|
||
AXP202_BATT_ACTIVATE_IRQ = _BV(13), //Battery activate mode, IRQ enable
|
||
AXP202_BATT_REMOVED_IRQ = _BV(14), //Battery removed, IRQ enable
|
||
AXP202_BATT_CONNECT_IRQ = _BV(15), //Battery connected, IRQ enable
|
||
|
||
//! IRQ3 REG 42H
|
||
AXP202_PEK_LONGPRESS_IRQ = _BV(16), //PEK long press, IRQ enable
|
||
AXP202_PEK_SHORTPRESS_IRQ = _BV(17), //PEK short press, IRQ enable
|
||
AXP202_LDO3_LOW_VOL_IRQ = _BV(18), //LDO3output voltage is lower than the set value, IRQ enable
|
||
AXP202_DC3_LOW_VOL_IRQ = _BV(19), //DC-DC3output voltage is lower than the set value, IRQ enable
|
||
AXP202_DC2_LOW_VOL_IRQ = _BV(20), //DC-DC2 output voltage is lower than the set value, IRQ enable
|
||
//**Reserved and unchangeable BIT 5
|
||
AXP202_CHARGE_LOW_CUR_IRQ = _BV(22), //Charge current is lower than the set current, IRQ enable
|
||
AXP202_CHIP_TEMP_HIGH_IRQ = _BV(23), //AXP202 internal over-temperature, IRQ enable
|
||
|
||
//! IRQ4 REG 43H
|
||
AXP202_APS_LOW_VOL_LEVEL2_IRQ = _BV(24), //APS low-voltage, IRQ enable（LEVEL2）
|
||
APX202_APS_LOW_VOL_LEVEL1_IRQ = _BV(25), //APS low-voltage, IRQ enable（LEVEL1）
|
||
AXP202_VBUS_SESSION_END_IRQ = _BV(26), //VBUS Session End IRQ enable
|
||
AXP202_VBUS_SESSION_AB_IRQ = _BV(27), //VBUS Session A/B IRQ enable
|
||
AXP202_VBUS_INVALID_IRQ = _BV(28), //VBUS invalid, IRQ enable
|
||
AXP202_VBUS_VAILD_IRQ = _BV(29), //VBUS valid, IRQ enable
|
||
AXP202_NOE_OFF_IRQ = _BV(30), //N_OE shutdown, IRQ enable
|
||
AXP202_NOE_ON_IRQ = _BV(31), //N_OE startup, IRQ enable
|
||
|
||
//! IRQ5 REG 44H
|
||
AXP202_GPIO0_EDGE_TRIGGER_IRQ = _BV(32), //GPIO0 input edge trigger, IRQ enable
|
||
AXP202_GPIO1_EDGE_TRIGGER_IRQ = _BV(33), //GPIO1input edge trigger or ADC input, IRQ enable
|
||
AXP202_GPIO2_EDGE_TRIGGER_IRQ = _BV(34), //GPIO2input edge trigger, IRQ enable
|
||
AXP202_GPIO3_EDGE_TRIGGER_IRQ = _BV(35), //GPIO3 input edge trigger, IRQ enable
|
||
//**Reserved and unchangeable BIT 4
|
||
AXP202_PEK_FALLING_EDGE_IRQ = _BV(37), //PEK press falling edge, IRQ enable
|
||
AXP202_PEK_RISING_EDGE_IRQ = _BV(38), //PEK press rising edge, IRQ enable
|
||
AXP202_TIMER_TIMEOUT_IRQ = _BV(39), //Timer timeout, IRQ enable
|
||
|
||
AXP202_ALL_IRQ = (0xFFFFFFFFFFULL)
|
||
} axp_irq_t;
|
||
|
||
typedef enum {
|
||
AXP202_LDO4_1250MV,
|
||
AXP202_LDO4_1300MV,
|
||
AXP202_LDO4_1400MV,
|
||
AXP202_LDO4_1500MV,
|
||
AXP202_LDO4_1600MV,
|
||
AXP202_LDO4_1700MV,
|
||
AXP202_LDO4_1800MV,
|
||
AXP202_LDO4_1900MV,
|
||
AXP202_LDO4_2000MV,
|
||
AXP202_LDO4_2500MV,
|
||
AXP202_LDO4_2700MV,
|
||
AXP202_LDO4_2800MV,
|
||
AXP202_LDO4_3000MV,
|
||
AXP202_LDO4_3100MV,
|
||
AXP202_LDO4_3200MV,
|
||
AXP202_LDO4_3300MV,
|
||
AXP202_LDO4_MAX,
|
||
} axp_ldo4_table_t;
|
||
|
||
typedef enum {
|
||
AXP202_LDO5_1800MV,
|
||
AXP202_LDO5_2500MV,
|
||
AXP202_LDO5_2800MV,
|
||
AXP202_LDO5_3000MV,
|
||
AXP202_LDO5_3100MV,
|
||
AXP202_LDO5_3300MV,
|
||
AXP202_LDO5_3400MV,
|
||
AXP202_LDO5_3500MV,
|
||
} axp_ldo5_table_t;
|
||
|
||
typedef enum {
|
||
AXP20X_LED_OFF,
|
||
AXP20X_LED_BLINK_1HZ,
|
||
AXP20X_LED_BLINK_4HZ,
|
||
AXP20X_LED_LOW_LEVEL,
|
||
} axp_chgled_mode_t;
|
||
|
||
typedef enum {
|
||
AXP_ADC_SAMPLING_RATE_25HZ = 0,
|
||
AXP_ADC_SAMPLING_RATE_50HZ = 1,
|
||
AXP_ADC_SAMPLING_RATE_100HZ = 2,
|
||
AXP_ADC_SAMPLING_RATE_200HZ = 3,
|
||
} axp_adc_sampling_rate_t;
|
||
|
||
typedef enum {
|
||
AXP_TS_PIN_CURRENT_20UA = 0,
|
||
AXP_TS_PIN_CURRENT_40UA = 1,
|
||
AXP_TS_PIN_CURRENT_60UA = 2,
|
||
AXP_TS_PIN_CURRENT_80UA = 3,
|
||
} axp_ts_pin_current_t;
|
||
|
||
typedef enum {
|
||
AXP_TS_PIN_FUNCTION_BATT = 0,
|
||
AXP_TS_PIN_FUNCTION_ADC = 1,
|
||
} axp_ts_pin_function_t;
|
||
|
||
typedef enum {
|
||
AXP_TS_PIN_MODE_DISABLE = 0,
|
||
AXP_TS_PIN_MODE_CHARGING = 1,
|
||
AXP_TS_PIN_MODE_SAMPLING = 2,
|
||
AXP_TS_PIN_MODE_ENABLE = 3,
|
||
} axp_ts_pin_mode_t;
|
||
|
||
//! Only AXP192 and AXP202 have gpio function
|
||
typedef enum {
|
||
AXP_GPIO_0,
|
||
AXP_GPIO_1,
|
||
AXP_GPIO_2,
|
||
AXP_GPIO_3,
|
||
AXP_GPIO_4,
|
||
} axp_gpio_t;
|
||
|
||
typedef enum {
|
||
AXP_IO_OUTPUT_LOW_MODE,
|
||
AXP_IO_OUTPUT_HIGH_MODE,
|
||
AXP_IO_INPUT_MODE,
|
||
AXP_IO_LDO_MODE,
|
||
AXP_IO_ADC_MODE,
|
||
AXP_IO_FLOATING_MODE,
|
||
AXP_IO_OPEN_DRAIN_OUTPUT_MODE,
|
||
AXP_IO_PWM_OUTPUT_MODE,
|
||
AXP_IO_EXTERN_CHARGING_CTRL_MODE,
|
||
} axp_gpio_mode_t;
|
||
|
||
typedef enum {
|
||
AXP_IRQ_NONE,
|
||
AXP_IRQ_RISING,
|
||
AXP_IRQ_FALLING,
|
||
AXP_IRQ_DOUBLE_EDGE,
|
||
} axp_gpio_irq_t;
|
||
|
||
|
||
typedef enum {
|
||
AXP192_GPIO_1V8,
|
||
AXP192_GPIO_1V9,
|
||
AXP192_GPIO_2V0,
|
||
AXP192_GPIO_2V1,
|
||
AXP192_GPIO_2V2,
|
||
AXP192_GPIO_2V3,
|
||
AXP192_GPIO_2V4,
|
||
AXP192_GPIO_2V5,
|
||
AXP192_GPIO_2V6,
|
||
AXP192_GPIO_2V7,
|
||
AXP192_GPIO_2V8,
|
||
AXP192_GPIO_2V9,
|
||
AXP192_GPIO_3V0,
|
||
AXP192_GPIO_3V1,
|
||
AXP192_GPIO_3V2,
|
||
AXP192_GPIO_3V3,
|
||
} axp192_gpio_voltage_t;
|
||
|
||
typedef enum {
|
||
AXP1XX_CHARGE_CUR_100MA,
|
||
AXP1XX_CHARGE_CUR_190MA,
|
||
AXP1XX_CHARGE_CUR_280MA,
|
||
AXP1XX_CHARGE_CUR_360MA,
|
||
AXP1XX_CHARGE_CUR_450MA,
|
||
AXP1XX_CHARGE_CUR_550MA,
|
||
AXP1XX_CHARGE_CUR_630MA,
|
||
AXP1XX_CHARGE_CUR_700MA,
|
||
AXP1XX_CHARGE_CUR_780MA,
|
||
AXP1XX_CHARGE_CUR_880MA,
|
||
AXP1XX_CHARGE_CUR_960MA,
|
||
AXP1XX_CHARGE_CUR_1000MA,
|
||
AXP1XX_CHARGE_CUR_1080MA,
|
||
AXP1XX_CHARGE_CUR_1160MA,
|
||
AXP1XX_CHARGE_CUR_1240MA,
|
||
AXP1XX_CHARGE_CUR_1320MA,
|
||
} axp1xx_charge_current_t;
|
||
|
||
typedef uint8_t (*axp_com_fptr_t)(uint8_t dev_addr, uint8_t reg_addr, uint8_t *data, uint8_t len);
|
||
|
||
|
||
class AXP20X_Class
|
||
{
|
||
public:
|
||
int begin(TwoWire &port = Wire, uint8_t addr = AXP202_SLAVE_ADDRESS, bool isAxp173 = false);
|
||
int begin(axp_com_fptr_t read_cb, axp_com_fptr_t write_cb, uint8_t addr = AXP202_SLAVE_ADDRESS, bool isAxp173 = false);
|
||
|
||
// Power Output Control
|
||
int setPowerOutPut(uint8_t ch, bool en);
|
||
|
||
bool isBatteryConnect();
|
||
bool isChargeing();
|
||
bool isLDO2Enable();
|
||
bool isLDO3Enable();
|
||
bool isLDO4Enable();
|
||
bool isDCDC3Enable();
|
||
bool isDCDC2Enable();
|
||
bool isChargeingEnable();
|
||
bool isVBUSPlug();
|
||
bool isExtenEnable();
|
||
|
||
//Only axp192 chip
|
||
bool isDCDC1Enable();
|
||
|
||
|
||
//IRQ Status
|
||
bool isAcinOverVoltageIRQ();
|
||
bool isAcinPlugInIRQ();
|
||
bool isAcinRemoveIRQ();
|
||
bool isVbusOverVoltageIRQ();
|
||
bool isVbusPlugInIRQ();
|
||
bool isVbusRemoveIRQ();
|
||
bool isVbusLowVHOLDIRQ();
|
||
|
||
bool isBattPlugInIRQ();
|
||
bool isBattRemoveIRQ();
|
||
bool isBattEnterActivateIRQ();
|
||
bool isBattExitActivateIRQ();
|
||
bool isChargingIRQ();
|
||
bool isChargingDoneIRQ();
|
||
bool isBattTempLowIRQ();
|
||
bool isBattTempHighIRQ();
|
||
|
||
bool isPEKShortPressIRQ();
|
||
bool isPEKLongtPressIRQ();
|
||
bool isTimerTimeoutIRQ();
|
||
|
||
//! Group4 ADC data
|
||
float getAcinVoltage();
|
||
float getAcinCurrent();
|
||
float getVbusVoltage();
|
||
float getVbusCurrent();
|
||
float getTemp();
|
||
float getTSTemp();
|
||
float getGPIO0Voltage();
|
||
float getGPIO1Voltage();
|
||
float getBattInpower();
|
||
float getBattVoltage();
|
||
float getBattChargeCurrent();
|
||
float getBattDischargeCurrent();
|
||
float getSysIPSOUTVoltage();
|
||
uint32_t getBattChargeCoulomb();
|
||
uint32_t getBattDischargeCoulomb();
|
||
float getSettingChargeCurrent();
|
||
|
||
int setChargingTargetVoltage(axp_chargeing_vol_t param);
|
||
int enableChargeing(bool en);
|
||
|
||
int adc1Enable(uint16_t params, bool en);
|
||
int adc2Enable(uint16_t params, bool en);
|
||
|
||
int setTScurrent(axp_ts_pin_current_t current);
|
||
int setTSfunction(axp_ts_pin_function_t func);
|
||
int setTSmode(axp_ts_pin_mode_t mode);
|
||
|
||
|
||
int setTimer(uint8_t minutes);
|
||
int offTimer();
|
||
int clearTimerStatus();
|
||
/**
|
||
* param: axp202_startup_time_t or axp192_startup_time_t
|
||
*/
|
||
int setStartupTime(uint8_t param);
|
||
|
||
/**
|
||
* param: axp_loonPress_time_t
|
||
*/
|
||
int setlongPressTime(uint8_t param);
|
||
|
||
/**
|
||
* @param param: axp_poweroff_time_t
|
||
*/
|
||
int setShutdownTime(uint8_t param);
|
||
|
||
int setTimeOutShutdown(bool en);
|
||
|
||
int shutdown();
|
||
|
||
/**
|
||
* params: axp_irq_t
|
||
*/
|
||
int enableIRQ(uint64_t params, bool en);
|
||
int readIRQ();
|
||
void clearIRQ();
|
||
|
||
int setDCDC1Voltage(uint16_t mv); //! Only AXP192 support and AXP173
|
||
// return mv
|
||
uint16_t getDCDC1Voltage(); //! Only AXP192 support and AXP173
|
||
|
||
// -----------------
|
||
|
||
/*
|
||
!! Chip resource table
|
||
| CHIP | AXP173 | AXP192 | AXP202 |
|
||
| -------- | ---------------- | ---------------- | ---------------- |
|
||
| DC1 | 0v7~3v5 /1200mA | 0v7~3v5 /1200mA | X |
|
||
| DC2 | 0v7~2v275/1600mA | 0v7~2v275/1600mA | 0v7~2v275/1600mA |
|
||
| DC3 | X | 0v7~3v5 /700mA | 0v7~3v5 /1200mA |
|
||
| LDO1 | 3v3 /30mA | 3v3 /30mA | 3v3 /30mA |
|
||
| LDO2 | 1v8~3v3 /200mA | 1v8~3v3 /200mA | 1v8~3v3 /200mA |
|
||
| LDO3 | 1v8~3v3 /200mA | 1v8~3v3 /200mA | 0v7~3v3 /200mA |
|
||
| LDO4 | 0v7~3v5 /500mA | X | 1v8~3v3 /200mA |
|
||
| LDO5/IO0 | X | 1v8~3v3 /50mA | 1v8~3v3 /50mA |
|
||
*/
|
||
int setDCDC2Voltage(uint16_t mv);
|
||
uint16_t getDCDC2Voltage();
|
||
|
||
int setDCDC3Voltage(uint16_t mv);
|
||
uint16_t getDCDC3Voltage();
|
||
|
||
int setLDO2Voltage(uint16_t mv);
|
||
uint16_t getLDO2Voltage();
|
||
|
||
int setLDO3Voltage(uint16_t mv);
|
||
uint16_t getLDO3Voltage();
|
||
|
||
|
||
int setLDO4Voltage(axp_ldo4_table_t param); //! Only axp202 support
|
||
int setLDO4Voltage(uint16_t mv); //! Only axp173 support
|
||
|
||
// return mv
|
||
uint16_t getLDO4Voltage(); //! Only axp173/axp202 support
|
||
|
||
|
||
/**
|
||
* @param mode: axp_chgled_mode_t
|
||
*/
|
||
int setChgLEDMode(axp_chgled_mode_t mode);
|
||
|
||
/**
|
||
* @param mode: axp202_ldo3_mode_t
|
||
*/
|
||
int setLDO3Mode(uint8_t mode); //! Only AXP202 support
|
||
|
||
int getBattPercentage();
|
||
|
||
int debugCharging();
|
||
int debugStatus();
|
||
int limitingOff();
|
||
|
||
int setAdcSamplingRate(axp_adc_sampling_rate_t rate);
|
||
uint8_t getAdcSamplingRate();
|
||
float getCoulombData();
|
||
uint8_t getCoulombRegister();
|
||
int setCoulombRegister(uint8_t val);
|
||
int EnableCoulombcounter(void);
|
||
int DisableCoulombcounter(void);
|
||
int StopCoulombcounter(void);
|
||
int ClearCoulombcounter(void);
|
||
|
||
|
||
int setGPIOMode(axp_gpio_t gpio, axp_gpio_mode_t mode);
|
||
int setGPIOIrq(axp_gpio_t gpio, axp_gpio_irq_t irq);
|
||
int setLDO5Voltage(axp_ldo5_table_t vol);
|
||
|
||
int gpioWrite(axp_gpio_t gpio, uint8_t vol);
|
||
int gpioRead(axp_gpio_t gpio);
|
||
|
||
// When the chip is axp192 / 173, the allowed values are 0 ~ 15, corresponding to the axp1xx_charge_current_t enumeration
|
||
// When the chip is axp202 allows maximum charging current of 1800mA, minimum 300mA
|
||
int getChargeControlCur();
|
||
int setChargeControlCur(uint16_t mA);
|
||
|
||
private:
|
||
uint16_t _getRegistH8L5(uint8_t regh8, uint8_t regl5)
|
||
{
|
||
uint8_t hv, lv;
|
||
_readByte(regh8, 1, &hv);
|
||
_readByte(regl5, 1, &lv);
|
||
return (hv << 5) | (lv & 0x1F);
|
||
}
|
||
|
||
uint16_t _getRegistResult(uint8_t regh8, uint8_t regl4)
|
||
{
|
||
uint8_t hv, lv;
|
||
_readByte(regh8, 1, &hv);
|
||
_readByte(regl4, 1, &lv);
|
||
return (hv << 4) | (lv & 0x0F);
|
||
}
|
||
|
||
int _readByte(uint8_t reg, uint8_t nbytes, uint8_t *data)
|
||
{
|
||
if (_read_cb != nullptr) {
|
||
return _read_cb(_address, reg, data, nbytes);
|
||
}
|
||
if (nbytes == 0 || !data)
|
||
return -1;
|
||
_i2cPort->beginTransmission(_address);
|
||
_i2cPort->write(reg);
|
||
_i2cPort->endTransmission();
|
||
_i2cPort->requestFrom(_address, nbytes);
|
||
uint8_t index = 0;
|
||
while (_i2cPort->available())
|
||
data[index++] = _i2cPort->read();
|
||
return 0;
|
||
}
|
||
|
||
int _writeByte(uint8_t reg, uint8_t nbytes, uint8_t *data)
|
||
{
|
||
if (_write_cb != nullptr) {
|
||
return _write_cb(_address, reg, data, nbytes);
|
||
}
|
||
if (nbytes == 0 || !data)
|
||
return -1;
|
||
_i2cPort->beginTransmission(_address);
|
||
_i2cPort->write(reg);
|
||
for (uint8_t i = 0; i < nbytes; i++) {
|
||
_i2cPort->write(data[i]);
|
||
}
|
||
_i2cPort->endTransmission();
|
||
return 0;
|
||
}
|
||
|
||
int _setGpioInterrupt(uint8_t *val, int mode, bool en);
|
||
int _axp_probe();
|
||
int _axp_irq_mask(axp_gpio_irq_t irq);
|
||
|
||
int _axp192_gpio_set(axp_gpio_t gpio, axp_gpio_mode_t mode);
|
||
int _axp192_gpio_0_select( axp_gpio_mode_t mode);
|
||
int _axp192_gpio_1_select( axp_gpio_mode_t mode);
|
||
int _axp192_gpio_3_select( axp_gpio_mode_t mode);
|
||
int _axp192_gpio_4_select( axp_gpio_mode_t mode);
|
||
|
||
int _axp202_gpio_set(axp_gpio_t gpio, axp_gpio_mode_t mode);
|
||
int _axp202_gpio_0_select( axp_gpio_mode_t mode);
|
||
int _axp202_gpio_1_select( axp_gpio_mode_t mode);
|
||
int _axp202_gpio_2_select( axp_gpio_mode_t mode);
|
||
int _axp202_gpio_3_select( axp_gpio_mode_t mode);
|
||
int _axp202_gpio_irq_set(axp_gpio_t gpio, axp_gpio_irq_t irq);
|
||
int _axp202_gpio_write(axp_gpio_t gpio, uint8_t val);
|
||
int _axp202_gpio_read(axp_gpio_t gpio);
|
||
|
||
|
||
static const uint8_t startupParams[], longPressParams[], shutdownParams[], targetVolParams[];
|
||
static uint8_t _outputReg;
|
||
uint8_t _address, _irq[5], _chip_id, _gpio[4];
|
||
bool _init = false;
|
||
axp_com_fptr_t _read_cb = nullptr;
|
||
axp_com_fptr_t _write_cb = nullptr;
|
||
TwoWire *_i2cPort;
|
||
bool _isAxp173;
|
||
};
|