#pragma once #include #include #include #include "AP_BattMonitor_Backend.h" #include #define AP_BATTMONITOR_SMBUS_BUS_INTERNAL 0 #define AP_BATTMONITOR_SMBUS_BUS_EXTERNAL 1 #define AP_BATTMONITOR_SMBUS_I2C_ADDR 0x0B #define AP_BATTMONITOR_SMBUS_TIMEOUT_MICROS 5000000 // sensor becomes unhealthy if no successful readings for 5 seconds class AP_BattMonitor_SMBus : public AP_BattMonitor_Backend { public: // Smart Battery Data Specification Revision 1.1 enum BATTMONITOR_SMBUS { BATTMONITOR_SMBUS_TEMP = 0x08, // Temperature BATTMONITOR_SMBUS_VOLTAGE = 0x09, // Voltage BATTMONITOR_SMBUS_CURRENT = 0x0A, // Current BATTMONITOR_SMBUS_REMAINING_CAPACITY = 0x0F, // Remaining Capacity BATTMONITOR_SMBUS_FULL_CHARGE_CAPACITY = 0x10, // Full Charge Capacity BATTMONITOR_SMBUS_SPECIFICATION_INFO = 0x1A, // Specification Info BATTMONITOR_SMBUS_SERIAL = 0x1C, // Serial Number BATTMONITOR_SMBUS_MANUFACTURE_NAME = 0x20, // Manufacture Name BATTMONITOR_SMBUS_MANUFACTURE_DATA = 0x23, // Manufacture Data }; /// Constructor AP_BattMonitor_SMBus(AP_BattMonitor &mon, AP_BattMonitor::BattMonitor_State &mon_state, AP_BattMonitor_Params ¶ms, AP_HAL::OwnPtr dev); // virtual destructor to reduce compiler warnings virtual ~AP_BattMonitor_SMBus() {} bool has_cell_voltages() const override { return _has_cell_voltages; } // all smart batteries are expected to provide current bool has_current() const override { return true; } // don't allow reset of remaining capacity for SMBus bool reset_remaining(float percentage) override { return false; } void init(void) override; protected: void read(void) override; // reads the pack full charge capacity // returns true if the read was successful, or if we already knew the pack capacity bool read_full_charge_capacity(void); // reads the remaining capacity // returns true if the read was succesful, which is only considered to be the // we know the full charge capacity bool read_remaining_capacity(void); // reads the temperature word from the battery // returns true if the read was successful bool read_temp(void); // reads the serial number if it's not already known // returns true if the read was successful, or the number was already known bool read_serial_number(void); // read word from register // returns true if read was successful, false if failed bool read_word(uint8_t reg, uint16_t& data) const; // get_PEC - calculate PEC for a read or write from the battery // buff is the data that was read or will be written uint8_t get_PEC(const uint8_t i2c_addr, uint8_t cmd, bool reading, const uint8_t buff[], uint8_t len) const; AP_HAL::OwnPtr _dev; bool _pec_supported; // true if PEC is supported int32_t _serial_number = -1; // battery serial number uint16_t _full_charge_capacity; // full charge capacity, used to stash the value before setting the parameter bool _has_cell_voltages; // smbus backends flag this as true once they have recieved a valid cell voltage report virtual void timer(void) = 0; // timer function to read from the battery }; // include specific implementations #include "AP_BattMonitor_SMBus_Solo.h" #include "AP_BattMonitor_SMBus_Maxell.h"