ltc6811.h

Go to the documentation of this file.

#ifndef LTC6811_H_
#define LTC6811_H_
#include <hal.h>
#include <i2c.h>
#include <adc.h>
#include <spi.h>
 
struct adc_ltc6811;
struct ltc6811 {
        struct hal gen;
        const uint32_t numberOfSlaves;
        const uint32_t allSlavesMask;
        const uint32_t cellUnderVoltage;
        const uint32_t cellOverVoltage;
        uint32_t index;
        OS_DEFINE_TASK(adcTask, 500);
        bool adcIsRunning;
        int32_t selectSlaves;
        struct ltc6811_slave **slaves;
        struct spi_slave *spi;
        bool (*callback)(struct ltc6811 *ltc, void *data);
        void *callbackData;
#ifdef CONFIG_LTC6811_I2C
 
        bool sendI2CToAll;
#endif
};
 
#ifdef CONFIG_LTC6811_I2C
struct i2c_ltc6811;
#endif
struct ltc6811_slave {
        struct hal gen;
        uint32_t index;
        struct ltc6811 *master;
        struct adc_ltc6811 **adcs;
        struct adc_ltc6811 **gpioADCS;
#ifdef CONFIG_LTC6811_I2C
 
        struct i2c_ltc6811 *i2c;
#endif
};
 
#ifdef CONFIG_LTC6811_I2C
 
struct i2c_ltc6811 {
        struct i2c_generic gen;
        struct ltc6811_slave *ltc;
};
#endif
 
struct adc_ltc6811 {
        struct adc_generic gen;
        struct ltc6811_slave *ltc;
        uint16_t value;
};
 
/*
 * TDOD Missing Commands?
 * 
 * Write Configuration Register Group B (WRCFGB)
 * Read Configuration Register Group A (RDCFGA)
 * Read Configuration Register Group B (RDCFGB)
 * Read Cell Voltage Register Group E (RDCVE)
 * Read Cell Voltage Register Group F (RDCVF)
 * Read Auxiliary Register Group C (RDAUXC)
 * Read Auxiliary Register Group D (RDAUXD)
 * Write PWM/S Control Register Group B (WRPSB)
 * Read PWM/S Control Register Group B (RDPSB)
 */
#define LTC_CMD_WRCFGA (0x1)
 
#define LTC_CMD_WRCFGA_0_GPIO_PULLUP(gpio) ((1 << gpio) << 3)
 
#define LTC_CMD_WRCFGA_0_REFON BIT(2)
 
#define LTC_CMD_WRCFGA_0_DTEN BIT(1)
 
#define LTC_CMD_WRCFGA_0_ADCOPT BIT(0)
 
#define LTC_CMD_WRCFGA_4_DCC(x) BIT(x)
 
#define LTC_CMD_WRCFGA_5_DCTO(DCTO) (DCTO << 4)
 
#define LTC_CMD_RDCFGA (0x2)
 
#define LTC_CMD_RDCVA (0x4)
 
#define LTC_CMD_RDCVB (0x6)
 
#define LTC_CMD_RDCVC (0x8)
 
#define LTC_CMD_RDCVD (0xA)
 
#define LTC_CMD_RDAUXA (0xC)
 
#define LTC_CMD_RDAUXB (0xE)
 
#define LTC_CMD_RDSTATA (0x10)
 
#define LTC_CMD_RDSTATB (0x12)
 
#define LTC_CMD_WRSCTRL (0x14)
 
#define LTC_CMD_WRPWM (0x20)
 
#define LTC_CMD_RDSCTRL (0x16)
 
#define LTC_CMD_RDPWM (0x22)
 
#define LTC_CMD_STSCTRL (0x19)
 
#define LTC_CMD_CLRSCTRL (0x18)
 
#define LTC_CMD_ADCV(CH, DCP, MD) (BIT(5) | BIT(6) | BIT(9) | (((CH) & 0x7) << 0) | (((DCP) & 0x1) << 4) | (((MD) & 0x3) << 7))
#define LTC_CMD_ADCV_NORM_DCP_ALL (0x370)
 
#define LTC_CMD_ADOW(CH, DCP, PUP, MD) (BIT(3) | BIT(5) | BIT(9) | (((CH) & 0x7) << 0) |(((PUP) & 0x1) << 6) ((DCP & 0x1) << 4) | (((MD) & 0x3) << 7))
#define LTC_CMD_ADOW_NORM_PUP_ALL (0x378)
#define LTC_CMD_ADOW_NORM_PDN_ALL (0x338)
 
#define LTC_CMD_CVST(ST, MD) (BIT(0) | BIT(1) | BIT(2) | BIT(9) | (((ST) & 0x3) << 5) | (((MD) & 0x3) << 7))
#define LTC_CMD_CVST_NORM_ST1 (0x327)
 
#define LTC_CMD_ADOL(DCP, MD) (BIT(0) | BIT(9) | (((DCP) & 0x1) << 4) | (((MD) & 0x3) << 7))
#define LTC_CMD_ADOL_NORM_DCP (0x311)
 
#define LTC_CMD_ADAX(CHG, MD) (BIT(5) | BIT(6) | BIT(10) | (((CHG) & 0x7) << 0) | (((MD & 0x3) << 7)))
#define LTC_CMD_ADAX_NORM_GPIO1 (0x561)
#define LTC_CMD_ADAX_NORM_GPIO2 (0x562)
 
#define LTC_CMD_ADAXD(CHG, MD) (BIT(10) | (((CHG) & 0x7) << 0) | (((MD & 0x3) << 7)))
#define LTC_CMD_ADAXD_NORM_GPIO1 (0x501)
#define LTC_CMD_ADAXD_NORM_GPIO2 (0x502)
 
#define LTC_CMD_AXST(ST, MD) (BIT(0) | BIT(1) | BIT(2) | BIT(10) | (((ST) & 0x3) << 5) | (((MD) & 0x3) << 7))
#define LTC_CMD_AXST_NORM_ST1 (0x527)
 
#define LTC_CMD_ADSTAT(CHST, MD) (BIT(3) | BIT(5) | BIT(6) | BIT(10) | (((CHST) & 0x7) << 0) | (((MD) & 0x3) << 7))
#define LTC_CMD_ADSTAT_NORM_ALL (0x568)
 
#define LTC_CMD_ADSTATD(CHST, MD) (BIT(3) | BIT(10) | (((CHST) & 0x7) << 0) | (((MD) & 0x3) << 7))
#define LTC_CMD_ADSTATD_NORM_ALL (0x508)
 
#define LTC_CMD_STATST(ST, MD) (BIT(0) | BIT(1) | BIT(2) | BIT(3) | BIT(10) | (((ST) & 0x3) << 5) | (((MD) & 0x3) << 7))
#define LTC_CMD_STATST_NORM_ST1 (0x52F)
 
#define LTC_CMD_ADCVAX(DCP, MD) (BIT(0) | BIT(1) | BIT(2) | BIT(3) | BIT(6) | BIT(10) | (((DCP) & 0x1) << 4) | (((MD) & 0x3) << 7))
#define LTC_CMD_ADCVAX_NORM_DCP (0x57F)
 
#define LTC_CMD_ADCVSC(DCP, MD) (BIT(0) | BIT(1) | BIT(2) | BIT(6) | BIT(10) | (((DCP) & 0x1) << 4) | (((MD) & 0x3) << 7))
#define LTC_CMD_ADCVSC_NORM_DCP (0x577)
 
#define LTC_CMD_CLRCELL (0x711)
 
#define LTC_CMD_CLRAUX (0x712)
 
#define LTC_CMD_CLRSTAT (0x713)
 
#define LTC_CMD_PLADC (0x714)
 
#define LTC_CMD_DIAGN (0x715)
 
#define LTC_CMD_WRCOMM (0x721)
 
#define LTC_CMD_RDCOMM (0x722)
 
#define LTC_CMD_STCOMM (0x723)
 
typedef int16_t ltc_cmd_t;
 
struct ltc6811 *ltc6811_init(uint32_t index);
struct ltc6811_slave *ltc6811_slave_init(uint32_t index);
int32_t ltc6811_connect(struct ltc6811 *ltc, struct spi *spi, uint8_t cs, uint16_t gpio, uint32_t baudrate);
int32_t ltc6811_write(struct ltc6811 *ltc, ltc_cmd_t cmd, uint8_t *data, uint32_t len);
int32_t ltc6811_read(struct ltc6811 *ltc, ltc_cmd_t cmd, uint8_t *data, uint32_t len);
uint16_t ltc6811_calcPEC(uint8_t* data, uint8_t len);
int32_t ltc6811_writeRegister(struct ltc6811 *ltc, ltc_cmd_t cmd, uint8_t *newData, uint8_t *oldData);
int32_t ltc6811_readRegister(struct ltc6811 *ltc, ltc_cmd_t cmd, uint8_t *registerContent);
int32_t ltc6811_setADCCallback(struct ltc6811 *ltc, bool (*callback)(struct ltc6811 *ltc, void *data), void *data);
int32_t ltc6811_startADC(struct ltc6811 *ltc);
int32_t ltc6811_stopADC(struct ltc6811 *ltc);
 
#define LTC6811_ADC_DEV(masterid, id, adcID) \
        struct adc_ltc6811 ltc6811_adc_##masterid##_##id##_##adcID = { \
                ADC_INIT_DEV(ltc6811), \
                .ltc = &ltc6811_slave_##masterid##_##id, \
        }; \
        ADC_ADDDEV(ltc6811, ltc6811_adc_##masterid##_##id##_##adcID)
#define ADC_PRV
#include <adc_prv.h>
extern const struct adc_ops ltc6811_adc_ops;
#define LTC6811_ADDDEV(id, numberofslave, _cellUnderVoltage, _cellOverVoltage) \
        struct ltc6811_slave *ltc6811_slaves_##id[numberofslave]; \
        struct ltc6811 ltc6811_dev_##id = { \
                HAL_NAME("LTC6811 " #id) \
                .gen.init = false, \
                .numberOfSlaves = numberofslave, \
                .allSlavesMask = ((1 << numberofslave) - 1), \
                .selectSlaves = ((1 << numberofslave) - 1), \
                .slaves = ltc6811_slaves_##id, \
                .cellUnderVoltage = (((_cellUnderVoltage) / (16 * 100E-3)) - 1), \
                .cellOverVoltage = ((_cellOverVoltage) / (16 * 100E-3)), \
        }; \
        HAL_ADD(ltc6811, ltc6811_dev_##id);
 
#define LTC6811_SLAVE_ADDDEV(masterid, id) \
        extern struct adc_ltc6811 *ltc6811_adcs_##id[12]; \
        struct ltc6811_slave ltc6811_slave_##masterid##_##id = { \
                HAL_NAME("LTC6811 " #id) \
                .gen.init = false, \
                .master = &ltc6811_dev_##masterid,\
                .adcs = ltc6811_adcs_##id, \
        }; \
        HAL_ADD(ltc6811, ltc6811_slave_##masterid##_##id); \
        LTC6811_ADC_DEV(masterid, id, 0); \
        LTC6811_ADC_DEV(masterid, id, 1); \
        LTC6811_ADC_DEV(masterid, id, 2); \
        LTC6811_ADC_DEV(masterid, id, 3); \
        LTC6811_ADC_DEV(masterid, id, 4); \
        LTC6811_ADC_DEV(masterid, id, 5); \
        LTC6811_ADC_DEV(masterid, id, 6); \
        LTC6811_ADC_DEV(masterid, id, 7); \
        LTC6811_ADC_DEV(masterid, id, 8); \
        LTC6811_ADC_DEV(masterid, id, 9); \
        LTC6811_ADC_DEV(masterid, id, 10); \
        LTC6811_ADC_DEV(masterid, id, 11); \
        struct adc_ltc6811 *ltc6811_adcs_##id[12] = { \
                &ltc6811_adc_##masterid##_##id##_0, \
                &ltc6811_adc_##masterid##_##id##_1, \
                &ltc6811_adc_##masterid##_##id##_2, \
                &ltc6811_adc_##masterid##_##id##_3, \
                &ltc6811_adc_##masterid##_##id##_4, \
                &ltc6811_adc_##masterid##_##id##_5, \
                &ltc6811_adc_##masterid##_##id##_6, \
                &ltc6811_adc_##masterid##_##id##_7, \
                &ltc6811_adc_##masterid##_##id##_8, \
                &ltc6811_adc_##masterid##_##id##_9, \
                &ltc6811_adc_##masterid##_##id##_10, \
                &ltc6811_adc_##masterid##_##id##_11, \
        };
 
#define LTC6811_ID(id) HAL_GET_ID(hal, ltc6811, ltc6811_dev_##id)
#define LTC6811_SLAVE_ID(masterid, id) HAL_GET_ID(hal, ltc6811, ltc6811_slave_##masterid##_##id)
#define LTC6811_ADC_ID(masterid, id, adcid) HAL_GET_ID(adc, ltc6811, ltc6811_adc_##masterid##_##id##_##adcid)
#define LTC6811_GET_ALL_ADCS(masterid, id, adcs) { \
        (adcs)[0] = adc_init(LTC6811_ADC_ID(masterid, id, 0), 12,0); \
        (adcs)[1] = adc_init(LTC6811_ADC_ID(masterid, id, 1), 12,0); \
        (adcs)[2] = adc_init(LTC6811_ADC_ID(masterid, id, 2), 12,0); \
        (adcs)[3] = adc_init(LTC6811_ADC_ID(masterid, id, 3), 12,0); \
        (adcs)[4] = adc_init(LTC6811_ADC_ID(masterid, id, 4), 12,0); \
        (adcs)[5] = adc_init(LTC6811_ADC_ID(masterid, id, 5), 12,0); \
        (adcs)[6] = adc_init(LTC6811_ADC_ID(masterid, id, 6), 12,0); \
        (adcs)[7] = adc_init(LTC6811_ADC_ID(masterid, id, 7), 12,0); \
        (adcs)[8] = adc_init(LTC6811_ADC_ID(masterid, id, 8), 12,0); \
        (adcs)[9] = adc_init(LTC6811_ADC_ID(masterid, id, 9), 12,0); \
        (adcs)[10] = adc_init(LTC6811_ADC_ID(masterid, id, 10), 12,0); \
        (adcs)[11] = adc_init(LTC6811_ADC_ID(masterid, id, 11), 12,0); \
} \
 
 
#endif