Skip to content

Commit

Permalink
fix battery link errors
Browse files Browse the repository at this point in the history
  • Loading branch information
Hwurzburg committed Dec 15, 2024
1 parent 23b9881 commit 867028a
Show file tree
Hide file tree
Showing 6 changed files with 11 additions and 11 deletions.
10 changes: 5 additions & 5 deletions common/source/docs/common-3dr-power-module.rst
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ Most ground stations provide a battery monitor interface but the parameters can
- :ref:`BATT_VOLT_MULT<BATT_VOLT_MULT__AP_BattMonitor_Analog>` converts the analog voltage received from the power module's voltage pin to the battery's voltage
- :ref:`BATT_CURR_PIN<BATT_CURR_PIN__AP_BattMonitor_Analog>` = **3**. The autopilot pin connected to the power module's current pin
- :ref:`BATT_AMP_PERVLT<BATT_AMP_PERVLT__AP_BattMonitor_Analog>` converts the analog voltage received from the power module's current pin to the battery's current
- :ref:`BATT_AMP_OFFSET <BATT_AMP_OFFSET>` voltage offset received from the power module's current pin when ther is no current being pulled from the battery
- :ref:`BATT_AMP_OFFSET <BATT_AMP_OFFSET__AP_BattMonitor_Analog>` voltage offset received from the power module's current pin when ther is no current being pulled from the battery

Instructions for setup and calibration using the :ref:`Mission Planner can be found here <common-power-module-configuration-in-mission-planner>`
A Blog post with instructions for `set-up using QGC can be found here <https://discuss.ardupilot.org/t/power-monitor-setup-on-ardupilot-copter-3-6/35441>`__
Expand All @@ -56,11 +56,11 @@ Dual Battery Monitoring

If the autopilot has additional analog-to-digital pins available, a second battery can be monitored by setting up the ``BATT2_`` parameters. The values below allow reading a second battery's voltage and current using :ref:`The Cube's <common-thecube-overview>` POWER2 port.

- :ref:`BATT2_MONITOR <BATT_MONITOR>` = **4** to measure both voltage and current (you will need to reboot the board after changing this)
- :ref:`BATT2_VOLT_PIN <BATT_VOLT_PIN>` = **13**
- :ref:`BATT2_CURR_PIN <BATT_CURR_PIN>` = **14**
- :ref:`BATT2_MONITOR <BATT2_MONITOR>` = **4** to measure both voltage and current (you will need to reboot the board after changing this)
- :ref:`BATT2_VOLT_PIN <BATT2_VOLT_PIN__AP_BattMonitor_Analog>` = **13**
- :ref:`BATT2_CURR_PIN <BATT2_CURR_PIN__AP_BattMonitor_Analog>` = **14**

The :ref:`BATT2_VOLT_MULT <BATT_VOLT_MULT>` and :ref:`BATT2_AMP_PERVLT <BATT_AMP_PERVLT>` should also be set by comparing the reported values vs values collected using a hand held voltage meter
The :ref:`BATT2_VOLT_MULT <BATT2_VOLT_MULT__AP_BattMonitor_Analog>` and :ref:`BATT2_AMP_PERVLT <BATT2_AMP_PERVLT__AP_BattMonitor_Analog>` should also be set by comparing the reported values vs values collected using a hand held voltage meter

.. image:: ../../../images/powermodule-dual-monitoring.png
:target: ../_images/powermodule-dual-monitoring.png
Expand Down
2 changes: 1 addition & 1 deletion common/source/docs/common-omnibusf7.rst
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ Then reboot.

:ref:`BATT_VOLT_PIN<BATT_VOLT_PIN__AP_BattMonitor_Analog>` 13

:ref:`BATT_AMP_OFFSET<BATT_AMP_OFFSET>` 0.008
:ref:`BATT_AMP_OFFSET<BATT_AMP_OFFSET__AP_BattMonitor_Analog>` 0.008

:ref:`BATT_CURR_PIN<BATT_CURR_PIN__AP_BattMonitor_Analog>` 12

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ Other Parameters
- :ref:`BATT_ARM_MAH<BATT_ARM_MAH>` is the minimum capacity remaining reported from this monitor that will allow arming to occur.
- :ref:`BATT_CURR_MULT<BATT_CURR_MULT>` allows adjusting the current scale for DroneCAN(UAVCAN) monitors which do not have a CAN parameter exposed for adjustment.
- :ref:`BATT_SERIAL_NUM<BATT_SERIAL_NUM>` is used to designate which battery an SMBUS or DroneCAN monitor is associated, since multiple instances of these monitors are possible.
- :ref:`BATT_MAX_AMPS<BATT_MAX_AMPS>` applies only to INA2xx sensors. Controls the maximum current which can be reported. This sensor is usually integrated onto the autopilot board and this value preset appropriately in the firmware. Normally, the user would only adjust this if the power monitor OEM suggest that it be set to a certain value.
- :ref:`BATT_MAX_AMPS<BATT_MAX_AMPS__AP_BattMonitor_INA2XX>` applies only to INA2xx sensors. Controls the maximum current which can be reported. This sensor is usually integrated onto the autopilot board and this value preset appropriately in the firmware. Normally, the user would only adjust this if the power monitor OEM suggest that it be set to a certain value.

Failsafe
--------
Expand Down
2 changes: 1 addition & 1 deletion common/source/docs/common-smartap-pdb.rst
Original file line number Diff line number Diff line change
Expand Up @@ -73,4 +73,4 @@ Set battery parameters as following:
- :ref:`BATT_MONITOR<BATT_MONITOR>` to 4 to Set to analog voltage and current.
- :ref:`BATT_VOLT_MULT<BATT_VOLT_MULT__AP_BattMonitor_Analog>` to 18.4615
- :ref:`BATT_AMP_PERVLT<BATT_AMP_PERVLT__AP_BattMonitor_Analog>` to 37.2300
- :ref:`BATT_AMP_OFFSET<BATT_AMP_OFFSET>` to 0.63
- :ref:`BATT_AMP_OFFSET<BATT_AMP_OFFSET__AP_BattMonitor_Analog>` to 0.63
2 changes: 1 addition & 1 deletion common/source/docs/common-synthetic-current-monitor.rst
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ For Voltage, the normal Analog Sensor parameters apply:
For the Current, some of the normal analog current sensor parameters have been re-tasked to save flash and their names are therefore a bit misleading in this application:

- :ref:`BATT_AMP_PERVLT<BATT_AMP_PERVLT__AP_BattMonitor_Analog>` is the MAXIMUM current at full battery voltage in amps.
- :ref:`BATT_AMP_OFFSET <BATT_AMP_OFFSET>` is the idle current (zero throttle) of the system in amps accounting for peripherals, video,etc. Normally in the 0.3 to 0.5 range.
- :ref:`BATT_AMP_OFFSET <BATT_AMP_OFFSET__AP_BattMonitor_Analog>` is the idle current (zero throttle) of the system in amps accounting for peripherals, video,etc. Normally in the 0.3 to 0.5 range.
- :ref:`BATT_MAX_VOLT<BATT_MAX_VOLT>` is the MAXIMUM fresh battery voltage. Used to scale the estimate as the battery voltage decreases during use.

Calibration of the :ref:`BATT_AMP_PERVLT<BATT_AMP_PERVLT__AP_BattMonitor_Analog>` value can either be done on the bench with a current meter, or iteratively by estimating an initial value, operating for while, measuring the amount of current needed to restore the battery to full charge, and using that value and a flight log's or OSD's total consumed mah for the flight to adjust the parameter value:
Expand Down
4 changes: 2 additions & 2 deletions plane/source/docs/fpv-plane.rst
Original file line number Diff line number Diff line change
Expand Up @@ -200,9 +200,9 @@ On the bench while connected to MP and with propellor removed, make sure that FS
Do NOT use the SETUP tab to setup the Battery Monitor for the newer
Chibios boards. These boards have the default configuration already loaded when installing
the firmware.
You will probably have to slightly adjust the :ref:`BATT_AMP_OFFSET<BATT_AMP_OFFSET>` and :ref:`BATT_AMP_PERVLT<BATT_AMP_PERVLT__AP_BattMonitor_Analog>`
You will probably have to slightly adjust the :ref:`BATT_AMP_OFFSET<BATT_AMP_OFFSET__AP_BattMonitor_Analog>` and :ref:`BATT_AMP_PERVLT<BATT_AMP_PERVLT__AP_BattMonitor_Analog>`
parameters. Most systems will draw 400 to 600 ma when the motor is not running. This is set
with the :ref:`BATT_AMP_OFFSET<BATT_AMP_OFFSET>` parameter. You can adjust the :ref:`BATT_AMP_PERVLT<BATT_AMP_PERVLT__AP_BattMonitor_Analog>` parameter to match the capacity used
with the :ref:`BATT_AMP_OFFSET<BATT_AMP_OFFSET__AP_BattMonitor_Analog>` parameter. You can adjust the :ref:`BATT_AMP_PERVLT<BATT_AMP_PERVLT__AP_BattMonitor_Analog>` parameter to match the capacity used
during your flight by taking the amount of current you recharge the battery with, and the displayed amount of mah used
using the following formula:

Expand Down

0 comments on commit 867028a

Please sign in to comment.