Différences

Ci-dessous, les différences entre deux révisions de la page.

--- documentation:microcontroleurs:arduino:modules:ina219_va_meter:index [2025/05/01 13:56] – [I2C] f1sls
+++ documentation:microcontroleurs:arduino:modules:ina219_va_meter:index [2025/05/04 14:42] (Version actuelle) – f1sls
@@ Ligne 1: / Ligne 1: @@
-====== Voltmètre / Ampèremètre INA219 ======
+====== Voltmètre / Ampèremètre INA219/GY-219 ======
 {{:documentation:microcontroleurs:arduino:modules:ina219_va_meter:ina219_01.jpg?300&nolink|}}
 \\
@@ Ligne 11: / Ligne 11: @@
 ===== I2C =====
-I2C Address
 The INA219 uses the I2C protocol to communicate with microcontrollers, and each device on the I2C bus must have a unique address. The default I2C address for the INA219 is 0x40 (or 1000000 in binary).
@@ Ligne 39: / Ligne 37: @@
 So, if you want to have multiple INA219 modules in the same system, you just need to set a unique address for each one by configuring the A0 and A1 pins accordingly. Remember, any time you change the I2C address, you must update the address in your microcontroller’s software so it knows where to find each INA219 on the I2C bus.
-===== WIRING =====
+===== REGISTERS & VALUES CALCULATIONS =====
+The INA219 has a set of internal registers that hold measurement data and control settings. They can be accessed via the I2C interface to configure the chip, initiate measurements, and read measurement results.
+{{:documentation:microcontroleurs:arduino:modules:ina219_va_meter:ina219-register-address.jpg?nolink|}}
+==== Configuration Register (Address = 00h) ====
+This register is used to control various aspects of the INA219, such as the bus voltage range, PGA gain, ADC resolution/averaging, operating mode, and more. It can be read or written to configure the INA219 as needed.
+==== Shunt Voltage Register (Address = 01h) ====
+This register holds the raw measurement result for the shunt voltage. It can be read to obtain the shunt voltage measurement, and the value must be processed as per the datasheet’s guidance to get the actual voltage in volts.
+Shunt voltage (in volts) is calculated by taking the raw reading from the Shunt Voltage Register and multiplying it by 10 µV. The formula is:
+''Shunt Voltage (V) = Shunt Voltage Register Value * 10 µV''
+==== Bus Voltage Register (Address = 02h) ====
+This register holds the raw measurement result for the bus voltage. It can be read to obtain the bus voltage measurement, and the value must be processed as per the datasheet’s guidance to get the actual voltage in volts.
+Bus voltage (in volts) is calculated by taking the raw reading from the Bus Voltage Register and multiplying it by 4 mV. The formula is:
+''Bus Voltage (V) = Bus Voltage Register Value * 4 mV''
+==== Power Register (Address = 03h) ====
+This register holds the calculated power value. It can be read to obtain the power measurement, and the value must be processed as per the datasheet’s guidance to get the actual power in watts.
+Power (in watts) is calculated by taking the raw reading from the Power Register and multiplying it by the Power_LSB value (defined when the calibration register is set). The formula is:
+''Power (W) = Power Register Value * Power_LSB''
+==== Current Register (Address = 04h) ====
+This register holds the calculated current value. It can be read to obtain the current measurement, and the value must be processed as per the datasheet’s guidance to get the actual current in amperes.
+Current (in amperes) is calculated by taking the raw reading from the Current Register and multiplying it by the Current_LSB value (defined when the calibration register is set). The formula is:
+''Current (A) = Current Register Value * Current_LSB''
+==== Calibration Register (Address = 05h) ====
+This register is used to set the calibration value for the current and power calculations. It can be read or written to set the correct calibration value.
 ===== PINOUT =====
@@ Ligne 50: / Ligne 85: @@
   * **Vin+** this pin connects to the positive terminal of the voltage supply that you want to measure.
+===== WIRING =====
+{{:documentation:microcontroleurs:arduino:modules:ina219_va_meter:interfacing-ina219-dc-current-sensor-module-with-arduino.jpg?600|}}
+{{:documentation:microcontroleurs:arduino:modules:ina219_va_meter:ina219-arduino-nano_steckplatine.png?600|}}
 ===== Librairie(s) =====
   * [[https://github.com/adafruit/Adafruit_INA219|Adafruit INA219]]
@@ Ligne 59: / Ligne 97: @@
 ==== ARDUINO CODE ====
 <code cpp>
+#include <Wire.h>
+#include <Adafruit_INA219.h>
+Adafruit_INA219 ina219;
+void setup(void)
+{
+  Serial.begin(9600);
+  while (!Serial)
+  {
+    delay(1);
+  }
+  // Initialize the INA219.
+  if (! ina219.begin())
+  {
+    Serial.println("Failed to find INA219 chip");
+    while (1)
+    {
+      delay(10);
+    }
+  }
+  // To use a slightly lower 32V, 1A range (higher precision on amps):
+  //ina219.setCalibration_32V_1A();
+  // Or to use a lower 16V, 400mA range, call:
+  //ina219.setCalibration_16V_400mA();
+  Serial.println("Measuring voltage, current, and power with INA219 ...");
+}
+void loop(void)
+{
+  float shuntvoltage = 0;
+  float busvoltage = 0;
+  float current_mA = 0;
+  float loadvoltage = 0;
+  float power_mW = 0;
+  shuntvoltage = ina219.getShuntVoltage_mV();
+  busvoltage = ina219.getBusVoltage_V();
+  current_mA = ina219.getCurrent_mA();
+  power_mW = ina219.getPower_mW();
+  loadvoltage = busvoltage + (shuntvoltage / 1000);
+  Serial.print("Bus Voltage:   "); Serial.print(busvoltage); Serial.println(" V");
+  Serial.print("Shunt Voltage: "); Serial.print(shuntvoltage); Serial.println(" mV");
+  Serial.print("Load Voltage:  "); Serial.print(loadvoltage); Serial.println(" V");
+  Serial.print("Current:       "); Serial.print(current_mA); Serial.println(" mA");
+  Serial.print("Power:         "); Serial.print(power_mW); Serial.println(" mW");
+  Serial.println("");
+  delay(1000);
+}
+</code>
+<code cpp>
+#include "Wire.h"
+#include "Adafruit_INA219.h"
+Adafruit_INA219 ina219;
+void setup() {
+  // Open serial communications and wait for port to open:
+  Serial.begin(9600);
+  while (!Serial) {
+    ; // wait for serial port to connect. Needed for native USB port only
+  }
+  if (! ina219.begin()) {
+    Serial.println("Failed to find INA219 chip");
+    while (1) { delay(10); }
+  }
+  Serial.print("BV"); Serial.print("\t"); // Bus Voltage
+  Serial.print("SV"); Serial.print("\t"); // Shunt Voltage
+  Serial.print("LV"); Serial.print("\t"); // Load Voltage
+  Serial.print("C"); Serial.print("\t");  // Current
+  Serial.println("P");  // Power
+}
+void loop() {
+  float shuntvoltage = 0;
+  float busvoltage = 0;
+  float current_mA = 0;
+  float loadvoltage = 0;
+  float power_mW = 0;
+  shuntvoltage = ina219.getShuntVoltage_mV();
+  busvoltage = ina219.getBusVoltage_V();
+  current_mA = ina219.getCurrent_mA();
+  power_mW = ina219.getPower_mW();
+  loadvoltage = busvoltage + (shuntvoltage / 1000);
+  Serial.print(busvoltage); Serial.print("\t");
+  Serial.print(shuntvoltage); Serial.print("\t");
+  Serial.print(loadvoltage); Serial.print("\t");
+  Serial.print(current_mA); Serial.print("\t");
+  Serial.println(power_mW);
+  delay(1000);
+}
 </code>

Outils pour utilisateurs

Outils du site

Différences

Outils de la page