summaryrefslogtreecommitdiff
path: root/driver/ina231.h
diff options
context:
space:
mode:
Diffstat (limited to 'driver/ina231.h')
-rw-r--r--driver/ina231.h90
1 files changed, 90 insertions, 0 deletions
diff --git a/driver/ina231.h b/driver/ina231.h
new file mode 100644
index 0000000000..56ccb27d4e
--- /dev/null
+++ b/driver/ina231.h
@@ -0,0 +1,90 @@
+/* Copyright (c) 2014 The Chromium OS Authors. All rights reserved.
+ * Use of this source code is governed by a BSD-style license that can be
+ * found in the LICENSE file.
+ *
+ * TI INA231 Current/Power monitor driver.
+ */
+
+#ifndef INA231_H
+#define INA231_H
+
+#define INA231_REG_CONFIG 0x00
+#define INA231_REG_SHUNT_VOLT 0x01
+#define INA231_REG_BUS_VOLT 0x02
+#define INA231_REG_POWER 0x03
+#define INA231_REG_CURRENT 0x04
+#define INA231_REG_CALIB 0x05
+#define INA231_REG_MASK 0x06
+#define INA231_REG_ALERT 0x07
+
+#define INA231_CONFIG_MODE_MASK (7 << 0)
+#define INA231_CONFIG_MODE_PWRDWN (0 << 0)
+#define INA231_CONFIG_MODE_SHUNT (1 << 0)
+#define INA231_CONFIG_MODE_BUS (1 << 1)
+#define INA231_CONFIG_MODE_TRG (0 << 2)
+#define INA231_CONFIG_MODE_CONT (1 << 2)
+
+/* Conversion time for bus and shunt in micro-seconds */
+enum ina231_conv_time {
+ INA231_CONV_TIME_140 = 0x00,
+ INA231_CONV_TIME_204 = 0x01,
+ INA231_CONV_TIME_332 = 0x02,
+ INA231_CONV_TIME_588 = 0x03,
+ INA231_CONV_TIME_1100 = 0x04,
+ INA231_CONV_TIME_2116 = 0x05,
+ INA231_CONV_TIME_4156 = 0x06,
+ INA231_CONV_TIME_8244 = 0x07,
+};
+#define INA231_CONV_TIME_MASK 0x7
+#define INA231_CONFIG_SHUNT_CONV_TIME(t) ((t) << 3)
+#define INA231_CONFIG_BUS_CONV_TIME(t) ((t) << 6)
+
+#define INA231_CONFIG_AVG_1 (0 << 9)
+#define INA231_CONFIG_AVG_4 (1 << 9)
+#define INA231_CONFIG_AVG_16 (2 << 9)
+#define INA231_CONFIG_AVG_64 (3 << 9)
+#define INA231_CONFIG_AVG_128 (4 << 9)
+#define INA231_CONFIG_AVG_256 (5 << 9)
+#define INA231_CONFIG_AVG_512 (6 << 9)
+#define INA231_CONFIG_AVG_1024 (7 << 9)
+
+#define INA231_MASK_EN_LEN (1 << 0)
+#define INA231_MASK_EN_APOL (1 << 1)
+#define INA231_MASK_EN_OVF (1 << 2)
+#define INA231_MASK_EN_CVRF (1 << 3)
+#define INA231_MASK_EN_AFF (1 << 4)
+#define INA231_MASK_EN_CNVR (1 << 10)
+#define INA231_MASK_EN_POL (1 << 11)
+#define INA231_MASK_EN_BUL (1 << 12)
+#define INA231_MASK_EN_BOL (1 << 13)
+#define INA231_MASK_EN_SUL (1 << 14)
+#define INA231_MASK_EN_SOL (1 << 15)
+
+/* Calibration value to get current LSB = 1mA */
+#define INA231_CALIB_1MA(rsense_mohm) (5120/(rsense_mohm))
+
+/* Bus voltage LSB : 1.25mV / bit */
+#define INA231_BUS_MV(reg) ((reg) * 125 / 100)
+
+/* Power LSB : 25mW / current_lsb */
+#define INA231_POW_MW(reg) ((reg) * 25 * 1/*Current mA/LSB*/)
+
+/* Read INA231 register. */
+uint16_t ina231_read(uint8_t idx, uint8_t reg);
+
+/* Write INA231 register. */
+int ina231_write(uint8_t idx, uint8_t reg, uint16_t val);
+
+/* Set measurement parameters */
+int ina231_init(uint8_t idx, uint16_t config, uint16_t calib);
+
+/* Return bus voltage in milliVolts */
+int ina231_get_voltage(uint8_t idx);
+
+/* Return current in milliAmps */
+int ina231_get_current(uint8_t idx);
+
+/* Return power in milliWatts */
+int ina231_get_power(uint8_t idx);
+
+#endif /* INA231_H */