/* SPDX-License-Identifier: GPL-2.0 */ /* * Copyright (c) 2012-2015, 2017, 2019 The Linux Foundation. * All rights reserved. */ #ifndef __BMS_BATTERYDATA_H #define __BMS_BATTERYDATA_H #include #define FCC_CC_COLS 5 #define FCC_TEMP_COLS 8 #define PC_CC_ROWS 31 #define PC_CC_COLS 13 #define PC_TEMP_ROWS 31 #define PC_TEMP_COLS 8 #define ACC_IBAT_ROWS 4 #define ACC_TEMP_COLS 3 #define MAX_SINGLE_LUT_COLS 20 #define MAX_BATT_ID_NUM 4 #define DEGC_SCALE 10 struct single_row_lut { int x[MAX_SINGLE_LUT_COLS]; int y[MAX_SINGLE_LUT_COLS]; int cols; }; /** * struct sf_lut - * @rows: number of percent charge entries should be <= PC_CC_ROWS * @cols: number of charge cycle entries should be <= PC_CC_COLS * @row_entries: the charge cycles/temperature at which sf data * is available in the table. * The charge cycles must be in increasing order from 0 to rows. * @percent: the percent charge at which sf data is available in the table * The percentcharge must be in decreasing order from 0 to cols. * @sf: the scaling factor data */ struct sf_lut { int rows; int cols; int row_entries[PC_CC_COLS]; int percent[PC_CC_ROWS]; int sf[PC_CC_ROWS][PC_CC_COLS]; }; /** * struct pc_temp_ocv_lut - * @rows: number of percent charge entries should be <= PC_TEMP_ROWS * @cols: number of temperature entries should be <= PC_TEMP_COLS * @temp: the temperatures at which ocv data is available in the table * The temperatures must be in increasing order from 0 to rows. * @percent: the percent charge at which ocv data is available in the table * The percentcharge must be in decreasing order from 0 to cols. * @ocv: the open circuit voltage */ struct pc_temp_ocv_lut { int rows; int cols; int temp[PC_TEMP_COLS]; int percent[PC_TEMP_ROWS]; int ocv[PC_TEMP_ROWS][PC_TEMP_COLS]; }; struct ibat_temp_acc_lut { int rows; int cols; int temp[ACC_TEMP_COLS]; int ibat[ACC_IBAT_ROWS]; int acc[ACC_IBAT_ROWS][ACC_TEMP_COLS]; }; struct batt_ids { int kohm[MAX_BATT_ID_NUM]; int num; }; enum battery_type { BATT_UNKNOWN = 0, BATT_PALLADIUM, BATT_DESAY, BATT_OEM, BATT_QRD_4V35_2000MAH, BATT_QRD_4V2_1300MAH, }; /** * struct bms_battery_data - * @fcc: full charge capacity (mAmpHour) * @fcc_temp_lut: table to get fcc at a given temp * @pc_temp_ocv_lut: table to get percent charge given batt temp and cycles * @pc_sf_lut: table to get percent charge scaling factor given cycles * and percent charge * @rbatt_sf_lut: table to get battery resistance scaling factor given * temperature and percent charge * @default_rbatt_mohm: the default value of battery resistance to use when * readings from bms are not available. * @delta_rbatt_mohm: the resistance to be added towards lower soc to * compensate for battery capacitance. * @rbatt_capacitve_mohm: the resistance to be added to compensate for * battery capacitance * @flat_ocv_threshold_uv: the voltage where the battery's discharge curve * starts flattening out. * @max_voltage_uv: max voltage of the battery * @cutoff_uv: cutoff voltage of the battery * @iterm_ua: termination current of the battery when charging * to 100% * @batt_id_kohm: the best matched battery id resistor value * @fastchg_current_ma: maximum fast charge current * @fg_cc_cv_threshold_mv: CC to CV threashold voltage */ struct bms_battery_data { unsigned int fcc; struct single_row_lut *fcc_temp_lut; struct single_row_lut *fcc_sf_lut; struct pc_temp_ocv_lut *pc_temp_ocv_lut; struct ibat_temp_acc_lut *ibat_acc_lut; struct sf_lut *pc_sf_lut; struct sf_lut *rbatt_sf_lut; int default_rbatt_mohm; int delta_rbatt_mohm; int rbatt_capacitive_mohm; int flat_ocv_threshold_uv; int max_voltage_uv; int cutoff_uv; int iterm_ua; int batt_id_kohm; int fastchg_current_ma; int fg_cc_cv_threshold_mv; const char *battery_type; }; /** * struct soh_range - * @batt_age_level: Battery age level (e.g. 0, 1 etc.,) * @soh_min: Minimum SOH (state of health) level that this battery * profile can support. * @soh_max: Maximum SOH (state of health) level that this battery * profile can support. */ struct soh_range { int batt_age_level; int soh_min; int soh_max; }; #define is_between(left, right, value) \ (((left) >= (right) && (left) >= (value) \ && (value) >= (right)) \ || ((left) <= (right) && (left) <= (value) \ && (value) <= (right))) #if defined(CONFIG_PM8921_BMS) || \ defined(CONFIG_PM8921_BMS_MODULE) || \ defined(CONFIG_QPNP_BMS) || \ defined(CONFIG_QPNP_VM_BMS) extern struct bms_battery_data palladium_1500_data; extern struct bms_battery_data desay_5200_data; extern struct bms_battery_data oem_batt_data; extern struct bms_battery_data QRD_4v35_2000mAh_data; extern struct bms_battery_data qrd_4v2_1300mah_data; int interpolate_fcc(struct single_row_lut *fcc_temp_lut, int batt_temp); int interpolate_scalingfactor(struct sf_lut *sf_lut, int row_entry, int pc); int interpolate_scalingfactor_fcc(struct single_row_lut *fcc_sf_lut, int cycles); int interpolate_pc(struct pc_temp_ocv_lut *pc_temp_ocv, int batt_temp_degc, int ocv); int interpolate_ocv(struct pc_temp_ocv_lut *pc_temp_ocv, int batt_temp_degc, int pc); int interpolate_slope(struct pc_temp_ocv_lut *pc_temp_ocv, int batt_temp, int pc); int interpolate_acc(struct ibat_temp_acc_lut *ibat_acc_lut, int batt_temp, int ibat); int linear_interpolate(int y0, int x0, int y1, int x1, int x); #else static inline int interpolate_fcc(struct single_row_lut *fcc_temp_lut, int batt_temp) { return -EINVAL; } static inline int interpolate_scalingfactor(struct sf_lut *sf_lut, int row_entry, int pc) { return -EINVAL; } static inline int interpolate_scalingfactor_fcc( struct single_row_lut *fcc_sf_lut, int cycles) { return -EINVAL; } static inline int interpolate_pc(struct pc_temp_ocv_lut *pc_temp_ocv, int batt_temp_degc, int ocv) { return -EINVAL; } static inline int interpolate_ocv(struct pc_temp_ocv_lut *pc_temp_ocv, int batt_temp_degc, int pc) { return -EINVAL; } static inline int interpolate_slope(struct pc_temp_ocv_lut *pc_temp_ocv, int batt_temp, int pc) { return -EINVAL; } static inline int linear_interpolate(int y0, int x0, int y1, int x1, int x) { return -EINVAL; } static inline int interpolate_acc(struct ibat_temp_acc_lut *ibat_acc_lut, int batt_temp, int ibat) { return -EINVAL; } #endif #endif