Kenji Arai / INA226

INA226 (Texas Instruments) High-or Low-Side Measurement,Bi-Directional CURRENT/POWER MONITOR with I2C Interface

INA226.h@3:d4affcc81306, 2017-08-23 (annotated)

Committer:
kenjiArai
Date:
Wed Aug 23 09:25:12 2017 +0000
Revision:
3:d4affcc81306
Parent:
2:b1e759cb121e 
countermeasure for  NonCopyable

Who changed what in which revision?

UserRevisionLine numberNew contents of line
kenjiArai 0:d17469a618b3 1 /*
kenjiArai 0:d17469a618b3 2 * mbed library program
kenjiArai 0:d17469a618b3 3 * INA226 High-or Low-Side Measurement,Bi-Directional CURRENT/POWER MONITOR with I2C Interface
kenjiArai 0:d17469a618b3 4 * by Texas Instruments
kenjiArai 0:d17469a618b3 5 *
kenjiArai 3:d4affcc81306 6 * Copyright (c) 2015,'17 Kenji Arai / JH1PJL
kenjiArai 0:d17469a618b3 7 * http://www.page.sannet.ne.jp/kenjia/index.html
kenjiArai 0:d17469a618b3 8 * http://mbed.org/users/kenjiArai/
kenjiArai 3:d4affcc81306 9 * Created: January 25th, 2015
kenjiArai 3:d4affcc81306 10 * Revised: August 23rd, 2017
kenjiArai 0:d17469a618b3 11 */
kenjiArai 0:d17469a618b3 12 /*
kenjiArai 0:d17469a618b3 13 *---------------- REFERENCE ----------------------------------------------------------------------
kenjiArai 0:d17469a618b3 14 * Original Information
kenjiArai 0:d17469a618b3 15 * http://www.ti.com/product/INA226/description
kenjiArai 0:d17469a618b3 16 * http://www.ti.com/lit/ds/symlink/ina226.pdf
kenjiArai 0:d17469a618b3 17 * Device kit
kenjiArai 0:d17469a618b3 18 * http://strawberry-linux.com/catalog/items?code=12031
kenjiArai 0:d17469a618b3 19 * http://strawberry-linux.com/catalog/items?code=12226
kenjiArai 0:d17469a618b3 20 */
kenjiArai 0:d17469a618b3 21
kenjiArai 0:d17469a618b3 22 #ifndef MBED_INA226
kenjiArai 0:d17469a618b3 23 #define MBED_INA226
kenjiArai 0:d17469a618b3 24
kenjiArai 0:d17469a618b3 25 /////////// ADDRESS /////////////////////////////
kenjiArai 0:d17469a618b3 26 // 7bit address = 0b1000000(0x40)
kenjiArai 0:d17469a618b3 27 // G=GND, V=VS+, A=SDA, L=SCL
kenjiArai 0:d17469a618b3 28 // e.g. _VG: A1=VS+, A0=GND
kenjiArai 0:d17469a618b3 29 // -> Please make sure your H/W configuration
kenjiArai 0:d17469a618b3 30 // Set data into "addr"
kenjiArai 0:d17469a618b3 31 #define INA226_ADDR_GG (0x40 << 1)
kenjiArai 0:d17469a618b3 32 #define INA226_ADDR_GV (0x41 << 1)
kenjiArai 0:d17469a618b3 33 #define INA226_ADDR_GA (0x42 << 1)
kenjiArai 0:d17469a618b3 34 #define INA226_ADDR_GL (0x43 << 1)
kenjiArai 0:d17469a618b3 35 #define INA226_ADDR_VG (0x44 << 1)
kenjiArai 0:d17469a618b3 36 #define INA226_ADDR_VV (0x45 << 1)
kenjiArai 0:d17469a618b3 37 #define INA226_ADDR_VA (0x46 << 1)
kenjiArai 0:d17469a618b3 38 #define INA226_ADDR_VL (0x47 << 1)
kenjiArai 0:d17469a618b3 39 #define INA226_ADDR_AG (0x48 << 1)
kenjiArai 0:d17469a618b3 40 #define INA226_ADDR_AV (0x49 << 1)
kenjiArai 0:d17469a618b3 41 #define INA226_ADDR_AA (0x4a << 1)
kenjiArai 0:d17469a618b3 42 #define INA226_ADDR_AL (0x4b << 1)
kenjiArai 0:d17469a618b3 43 #define INA226_ADDR_LG (0x4c << 1)
kenjiArai 0:d17469a618b3 44 #define INA226_ADDR_LV (0x4d << 1)
kenjiArai 0:d17469a618b3 45 #define INA226_ADDR_LA (0x4e << 1)
kenjiArai 0:d17469a618b3 46 #define INA226_ADDR_LL (0x4f << 1)
kenjiArai 0:d17469a618b3 47
kenjiArai 0:d17469a618b3 48 /////////// REGISTER DEFINITION /////////////////
kenjiArai 0:d17469a618b3 49 #define INA226_CONFIG 0x00
kenjiArai 0:d17469a618b3 50 #define INA226_SHUNT_V 0x01
kenjiArai 0:d17469a618b3 51 #define INA226_BUS_VOLT 0x02
kenjiArai 0:d17469a618b3 52 #define INA226_POWER 0x03
kenjiArai 0:d17469a618b3 53 #define INA226_CURRENT 0x04
kenjiArai 0:d17469a618b3 54 #define INA226_CALBLATION 0x05
kenjiArai 0:d17469a618b3 55 #define INA226_MASK_EN 0x06
kenjiArai 0:d17469a618b3 56 #define INA226_ALERT_LMT 0x07
kenjiArai 0:d17469a618b3 57 #define INA226_DIE_ID 0xff
kenjiArai 0:d17469a618b3 58
kenjiArai 0:d17469a618b3 59 /////////// PARAMETER SETTING for Configuration Reg. //////////////////////////
kenjiArai 0:d17469a618b3 60 // Set data into "shunt_register"
kenjiArai 0:d17469a618b3 61 #define INA226_PAR_R_2MORM 2 // Strawberry Linux borad
kenjiArai 0:d17469a618b3 62 #define INA226_PAR_R_25MOHM 25
kenjiArai 0:d17469a618b3 63 #define INA226_PAR_R_MORM(x) (x)
kenjiArai 0:d17469a618b3 64 // Set data into "average", Averaging Mode
kenjiArai 0:d17469a618b3 65 #define INA226_PAR_A_1 0 // Default
kenjiArai 0:d17469a618b3 66 #define INA226_PAR_A_4 1
kenjiArai 0:d17469a618b3 67 #define INA226_PAR_A_16 2
kenjiArai 0:d17469a618b3 68 #define INA226_PAR_A_64 3
kenjiArai 0:d17469a618b3 69 #define INA226_PAR_A_128 4
kenjiArai 0:d17469a618b3 70 #define INA226_PAR_A_256 5
kenjiArai 0:d17469a618b3 71 #define INA226_PAR_A_512 6
kenjiArai 0:d17469a618b3 72 #define INA226_PAR_A_1024 7
kenjiArai 0:d17469a618b3 73 // Set data into "b_volt_cnv_time" Bus Voltage Conversion Time
kenjiArai 0:d17469a618b3 74 #define INA226_CFG_BUS_V_TR140 0
kenjiArai 0:d17469a618b3 75 #define INA226_CFG_BUS_V_TR204 1
kenjiArai 0:d17469a618b3 76 #define INA226_CFG_BUS_V_TR332 2
kenjiArai 0:d17469a618b3 77 #define INA226_CFG_BUS_V_TR588 3
kenjiArai 0:d17469a618b3 78 #define INA226_CFG_BUS_V_T1R1 4 // Default
kenjiArai 0:d17469a618b3 79 #define INA226_CFG_BUS_V_T2R116 5
kenjiArai 0:d17469a618b3 80 #define INA226_CFG_BUS_V_T4R156 6
kenjiArai 0:d17469a618b3 81 #define INA226_CFG_BUS_V_T8R244 7
kenjiArai 0:d17469a618b3 82 // Set data into "s_volt_cnv_time", Shunt Voltage Conversion Time
kenjiArai 0:d17469a618b3 83 #define INA226_CFG_SHT_V_TR140 0
kenjiArai 0:d17469a618b3 84 #define INA226_CFG_SHT_V_TR204 1
kenjiArai 0:d17469a618b3 85 #define INA226_CFG_SHT_V_TR332 2
kenjiArai 0:d17469a618b3 86 #define INA226_CFG_SHT_V_TR588 3
kenjiArai 0:d17469a618b3 87 #define INA226_CFG_SHT_V_T1R1 4 // Default
kenjiArai 0:d17469a618b3 88 #define INA226_CFG_SHT_V_T2R116 5
kenjiArai 0:d17469a618b3 89 #define INA226_CFG_SHT_V_T4R156 6
kenjiArai 0:d17469a618b3 90 #define INA226_CFG_SHT_V_T8R244 7
kenjiArai 0:d17469a618b3 91 // Set data into "mode", Operating Mode
kenjiArai 0:d17469a618b3 92 #define INA226_PAR_M_PDWN 0
kenjiArai 0:d17469a618b3 93 #define INA226_PAR_M_SHNT_TRG 1
kenjiArai 0:d17469a618b3 94 #define INA226_PAR_M_BUS_TRG 2
kenjiArai 0:d17469a618b3 95 #define INA226_PAR_M_SHNTBUS_TRG 3
kenjiArai 0:d17469a618b3 96 #define INA226_PAR_M_ADC_OFF 4
kenjiArai 0:d17469a618b3 97 #define INA226_PAR_M_SHNT_CONT 5
kenjiArai 0:d17469a618b3 98 #define INA226_PAR_M_BUS_CONT 6
kenjiArai 0:d17469a618b3 99 #define INA226_PAR_M_SHNTBUS_CONT 7 // Default
kenjiArai 0:d17469a618b3 100
kenjiArai 0:d17469a618b3 101 ////////////// DATA TYPE DEFINITION ///////////////////////
kenjiArai 0:d17469a618b3 102 typedef struct {
kenjiArai 0:d17469a618b3 103 uint8_t addr;
kenjiArai 2:b1e759cb121e 104 uint16_t shunt_register;
kenjiArai 0:d17469a618b3 105 uint8_t average;
kenjiArai 0:d17469a618b3 106 uint8_t b_volt_cnv_time;
kenjiArai 0:d17469a618b3 107 uint8_t s_volt_cnv_time;
kenjiArai 0:d17469a618b3 108 uint8_t mode;
kenjiArai 0:d17469a618b3 109 uint16_t calibration_data;
kenjiArai 0:d17469a618b3 110 } INA226_TypeDef;
kenjiArai 0:d17469a618b3 111
kenjiArai 0:d17469a618b3 112 ////////////// DEFAULT SETTING ////////////////////////////
kenjiArai 0:d17469a618b3 113 // Standard parameter for easy set-up
kenjiArai 0:d17469a618b3 114 const INA226_TypeDef ina226_std_paramtr = {
kenjiArai 0:d17469a618b3 115 // I2C Address
kenjiArai 0:d17469a618b3 116 INA226_ADDR_GG,
kenjiArai 0:d17469a618b3 117 // CONFIG REG
kenjiArai 0:d17469a618b3 118 INA226_PAR_R_2MORM, // 2 milli-ohm
kenjiArai 0:d17469a618b3 119 INA226_PAR_A_1, // Averaging Mode
kenjiArai 0:d17469a618b3 120 INA226_CFG_BUS_V_T1R1,
kenjiArai 0:d17469a618b3 121 INA226_CFG_SHT_V_T1R1,
kenjiArai 0:d17469a618b3 122 INA226_PAR_M_SHNTBUS_CONT,
kenjiArai 0:d17469a618b3 123 // CALBLATION REG
kenjiArai 0:d17469a618b3 124 2560
kenjiArai 0:d17469a618b3 125 };
kenjiArai 0:d17469a618b3 126
kenjiArai 0:d17469a618b3 127 /** INA226 High-or Low-Side Measurement,Bi-Directional CURRENT/POWER MONITOR with I2C Interface
kenjiArai 0:d17469a618b3 128 *
kenjiArai 0:d17469a618b3 129 * @code
kenjiArai 0:d17469a618b3 130 * //--------- Default setting -----------------
kenjiArai 0:d17469a618b3 131 * #include "mbed.h"
kenjiArai 0:d17469a618b3 132 * #include "INA226.h"
kenjiArai 0:d17469a618b3 133 *
kenjiArai 0:d17469a618b3 134 * // I2C Communication
kenjiArai 0:d17469a618b3 135 * INA226 current(dp5, dp27, INA226_ADDR_GG);
kenjiArai 0:d17469a618b3 136 * // If you connected I2C line not only this device but also other devices,
kenjiArai 0:d17469a618b3 137 * // you need to declare following method.
kenjiArai 0:d17469a618b3 138 * I2C i2c(dp5, dp27);
kenjiArai 0:d17469a618b3 139 * INA226 current(I2C& p_i2c, INA226_ADDR_GG);
kenjiArai 0:d17469a618b3 140 *
kenjiArai 0:d17469a618b3 141 * int main() {
kenjiArai 0:d17469a618b3 142 * while(1){
kenjiArai 0:d17469a618b3 143 * printf("I=%+6.3f [A]\r\n", current.read_current());
kenjiArai 0:d17469a618b3 144 * wait(1.0):
kenjiArai 0:d17469a618b3 145 * }
kenjiArai 0:d17469a618b3 146 * }
kenjiArai 0:d17469a618b3 147 * //--------- Detail setting -----------------
kenjiArai 0:d17469a618b3 148 * #include "mbed.h"
kenjiArai 0:d17469a618b3 149 * #include "INA226.h"
kenjiArai 0:d17469a618b3 150 *
kenjiArai 0:d17469a618b3 151 * const INA226_TypeDef ina226_my_paramtr = {
kenjiArai 0:d17469a618b3 152 * // I2C Address
kenjiArai 0:d17469a618b3 153 * INA226_ADDR_GG,
kenjiArai 0:d17469a618b3 154 * // CONFIG REG
kenjiArai 0:d17469a618b3 155 * INA226_PAR_R_100MOHM, // 100 milli-ohm
kenjiArai 2:b1e759cb121e 156 * INA226_PAR_A_1, // Averaging Mode
kenjiArai 2:b1e759cb121e 157 * INA226_CFG_BUS_V_T1R1, // Bus Voltage Conversion Time
kenjiArai 2:b1e759cb121e 158 * INA226_CFG_SHT_V_T1R1, // Shunt Voltage Conversion Time
kenjiArai 2:b1e759cb121e 159 * INA226_PAR_M_SHNTBUS_CONT,// Operating Mode
kenjiArai 0:d17469a618b3 160 * // CALBLATION REG
kenjiArai 2:b1e759cb121e 161 * 2560
kenjiArai 0:d17469a618b3 162 * };
kenjiArai 0:d17469a618b3 163 *
kenjiArai 0:d17469a618b3 164 * I2C i2c(dp5,dp27);
kenjiArai 0:d17469a618b3 165 * INA226 current(I2C& p_i2c, &ina226_my_paramtr);
kenjiArai 0:d17469a618b3 166 *
kenjiArai 0:d17469a618b3 167 * int main() {
kenjiArai 0:d17469a618b3 168 * while(1){
kenjiArai 0:d17469a618b3 169 * printf("I=%+6.3f [A]\r\n", current.read_current());
kenjiArai 0:d17469a618b3 170 * wait(1.0):
kenjiArai 0:d17469a618b3 171 * }
kenjiArai 0:d17469a618b3 172 * }
kenjiArai 0:d17469a618b3 173 * @endcode
kenjiArai 0:d17469a618b3 174 */
kenjiArai 0:d17469a618b3 175
kenjiArai 0:d17469a618b3 176 class INA226
kenjiArai 0:d17469a618b3 177 {
kenjiArai 0:d17469a618b3 178 public:
kenjiArai 0:d17469a618b3 179 /** Configure data pin
kenjiArai 0:d17469a618b3 180 * @param data SDA and SCL pins
kenjiArai 0:d17469a618b3 181 * @param parameter address chip (INA226_TypeDef)
kenjiArai 0:d17469a618b3 182 * @param or just set address or just port
kenjiArai 0:d17469a618b3 183 */
kenjiArai 0:d17469a618b3 184 INA226(PinName p_sda, PinName p_scl, const INA226_TypeDef *ina226_parameter);
kenjiArai 0:d17469a618b3 185 INA226(PinName p_sda, PinName p_scl, uint8_t addr);
kenjiArai 0:d17469a618b3 186 INA226(PinName p_sda, PinName p_scl);
kenjiArai 0:d17469a618b3 187
kenjiArai 0:d17469a618b3 188 /** Configure data pin (with other devices on I2C line)
kenjiArai 0:d17469a618b3 189 * @param I2C previous definition
kenjiArai 0:d17469a618b3 190 * @param parameter address chip (INA226_TypeDef)
kenjiArai 0:d17469a618b3 191 * @param or just set address or just port
kenjiArai 0:d17469a618b3 192 */
kenjiArai 0:d17469a618b3 193 INA226(I2C& p_i2c, const INA226_TypeDef *ina226_parameter);
kenjiArai 0:d17469a618b3 194 INA226(I2C& p_i2c, uint8_t addr);
kenjiArai 0:d17469a618b3 195 INA226(I2C& p_i2c);
kenjiArai 0:d17469a618b3 196
kenjiArai 0:d17469a618b3 197 /** Read Current data
kenjiArai 0:d17469a618b3 198 * @param none
kenjiArai 0:d17469a618b3 199 * @return current [mA]
kenjiArai 0:d17469a618b3 200 */
kenjiArai 0:d17469a618b3 201 float read_current(void);
kenjiArai 0:d17469a618b3 202 float read_current_by_shuntvolt(void);
kenjiArai 0:d17469a618b3 203
kenjiArai 0:d17469a618b3 204 /** Read Power data
kenjiArai 0:d17469a618b3 205 * @param none
kenjiArai 0:d17469a618b3 206 * @return power [w]
kenjiArai 0:d17469a618b3 207 */
kenjiArai 0:d17469a618b3 208 float read_power(void);
kenjiArai 0:d17469a618b3 209
kenjiArai 0:d17469a618b3 210 /** Read Bus voltage
kenjiArai 0:d17469a618b3 211 * @param none
kenjiArai 0:d17469a618b3 212 * @return voltage [v]
kenjiArai 0:d17469a618b3 213 */
kenjiArai 0:d17469a618b3 214 float read_bus_voltage(void);
kenjiArai 0:d17469a618b3 215
kenjiArai 0:d17469a618b3 216 /** Read Shunt voltage data
kenjiArai 0:d17469a618b3 217 * @param none
kenjiArai 0:d17469a618b3 218 * @return voltage [v]
kenjiArai 0:d17469a618b3 219 */
kenjiArai 0:d17469a618b3 220 float read_shunt_voltage(void);
kenjiArai 0:d17469a618b3 221
kenjiArai 2:b1e759cb121e 222 /** Read Shunt voltage data
kenjiArai 2:b1e759cb121e 223 * @param none
kenjiArai 2:b1e759cb121e 224 * @return voltage related value
kenjiArai 2:b1e759cb121e 225 */
kenjiArai 2:b1e759cb121e 226 int16_t read_shunt_raw_voltage(void);
kenjiArai 2:b1e759cb121e 227
kenjiArai 0:d17469a618b3 228 /** Read configration reg.
kenjiArai 0:d17469a618b3 229 * @param none
kenjiArai 0:d17469a618b3 230 * @return configrartion register value
kenjiArai 0:d17469a618b3 231 */
kenjiArai 0:d17469a618b3 232 uint16_t read_config(void);
kenjiArai 0:d17469a618b3 233
kenjiArai 0:d17469a618b3 234 /** Set configration reg.
kenjiArai 0:d17469a618b3 235 * @param configuration data
kenjiArai 0:d17469a618b3 236 * @return configrartion register value
kenjiArai 0:d17469a618b3 237 */
kenjiArai 0:d17469a618b3 238 uint16_t set_config(uint16_t cfg);
kenjiArai 0:d17469a618b3 239
kenjiArai 0:d17469a618b3 240 /** Read calibration reg.
kenjiArai 0:d17469a618b3 241 * @param none
kenjiArai 0:d17469a618b3 242 * @return calibration register value
kenjiArai 0:d17469a618b3 243 */
kenjiArai 0:d17469a618b3 244 uint16_t read_calb(void);
kenjiArai 0:d17469a618b3 245
kenjiArai 0:d17469a618b3 246 /** Set calibration reg.
kenjiArai 0:d17469a618b3 247 * @param calibration data
kenjiArai 0:d17469a618b3 248 * @return calibration register value
kenjiArai 0:d17469a618b3 249 */
kenjiArai 0:d17469a618b3 250 uint16_t set_calb(uint16_t clb);
kenjiArai 0:d17469a618b3 251
kenjiArai 0:d17469a618b3 252 /** Read Mask/Enable reg.
kenjiArai 0:d17469a618b3 253 * @param none
kenjiArai 0:d17469a618b3 254 * @return calibration register value
kenjiArai 0:d17469a618b3 255 */
kenjiArai 0:d17469a618b3 256 uint16_t read_msk_enbl(void);
kenjiArai 0:d17469a618b3 257
kenjiArai 0:d17469a618b3 258 /** Set Mask/Enable reg.
kenjiArai 0:d17469a618b3 259 * @param mask enable data
kenjiArai 0:d17469a618b3 260 * @return calibration register value
kenjiArai 0:d17469a618b3 261 */
kenjiArai 0:d17469a618b3 262 uint16_t set_msk_enbl(uint16_t clb);
kenjiArai 0:d17469a618b3 263
kenjiArai 0:d17469a618b3 264 /** Read ID
kenjiArai 0:d17469a618b3 265 * @param none
kenjiArai 0:d17469a618b3 266 * @return ID
kenjiArai 0:d17469a618b3 267 */
kenjiArai 0:d17469a618b3 268 uint8_t read_ID();
kenjiArai 0:d17469a618b3 269
kenjiArai 0:d17469a618b3 270 /** Set I2C clock frequency
kenjiArai 0:d17469a618b3 271 * @param freq.
kenjiArai 0:d17469a618b3 272 * @return none
kenjiArai 0:d17469a618b3 273 */
kenjiArai 0:d17469a618b3 274 void frequency(int hz);
kenjiArai 0:d17469a618b3 275
kenjiArai 0:d17469a618b3 276 /** Read register (general purpose)
kenjiArai 0:d17469a618b3 277 * @param register's address
kenjiArai 0:d17469a618b3 278 * @return register data
kenjiArai 0:d17469a618b3 279 */
kenjiArai 0:d17469a618b3 280 uint8_t read_reg(uint8_t addr);
kenjiArai 0:d17469a618b3 281
kenjiArai 0:d17469a618b3 282 /** Write register (general purpose)
kenjiArai 0:d17469a618b3 283 * @param register's address
kenjiArai 0:d17469a618b3 284 * @param data
kenjiArai 0:d17469a618b3 285 * @return register data
kenjiArai 0:d17469a618b3 286 */
kenjiArai 0:d17469a618b3 287 uint8_t write_reg(uint8_t addr, uint8_t data);
kenjiArai 0:d17469a618b3 288
kenjiArai 0:d17469a618b3 289 protected:
kenjiArai 3:d4affcc81306 290 I2C *_i2c_p;
kenjiArai 3:d4affcc81306 291 I2C &_i2c;
kenjiArai 0:d17469a618b3 292
kenjiArai 0:d17469a618b3 293 void initialize(void);
kenjiArai 0:d17469a618b3 294
kenjiArai 0:d17469a618b3 295 private:
kenjiArai 0:d17469a618b3 296 uint8_t id_number;
kenjiArai 0:d17469a618b3 297 INA226_TypeDef ina226_set_data;
kenjiArai 0:d17469a618b3 298 int32_t scale_factor;
kenjiArai 0:d17469a618b3 299 uint8_t dt[4];
kenjiArai 0:d17469a618b3 300 };
kenjiArai 0:d17469a618b3 301
kenjiArai 0:d17469a618b3 302 #endif // MBED_INA226
kenjiArai 3:d4affcc81306 303