Update docs for battery voltage

Author: cesarBLG

Source/Documentation/Manual/cabs.rst

@@ -61,23 +61,25 @@ The following DMI size variants are available: FullSize (displays the whole DMI)
 The information displayed in the DMI is controlled via the TCS script. For more details,
 see :ref:`C# engine scripting - Train Control System <features-scripting-tcs>`.
 
-.. _cabs-battery-switch:
+.. _cabs-battery:
 
-Battery switch
---------------
+Battery
+-------
 
 .. index::
    single: ORTS_BATTERY_SWITCH_COMMAND_SWITCH
    single: ORTS_BATTERY_SWITCH_COMMAND_BUTTON_CLOSE
    single: ORTS_BATTERY_SWITCH_ON
+   single: ORTS_BATTERY_VOLTAGE
 
-The :ref:`battery switch <physics-battery-switch>` controls the low voltage power supply of the locomotive.
+The :ref:`battery subsystem <physics-battery>` controls the low voltage power supply of the locomotive.
 
 The following controls are available for the cabview:
 
-- ``ORTS_BATTERY_SWITCH_COMMAND_SWITCH`` can be used if the switch is directly controlled from the cab
+- ``ORTS_BATTERY_SWITCH_COMMAND_SWITCH`` can be used if the battery switch is directly controlled from the cab
 - ``ORTS_BATTERY_SWITCH_COMMAND_BUTTON_CLOSE`` and ``ORTS_BATTERY_SWITCH_COMMAND_BUTTON_OPEN`` can be used if the switch is controlled with two pushbuttons (one to close the switch and the other to open it)
 - ``ORTS_BATTERY_SWITCH_ON`` can be used to control a light on the cab showing the state of the battery switch
+- ``ORTS_BATTERY_VOLTAGE`` monitors the battery voltage
 
 Other controls can be disabled if the low voltage power supply is not available using the following parameter::
 

Source/Documentation/Manual/features-rollingstock.rst

@@ -149,11 +149,11 @@ block!
 .. index::
    single: Conditions(ORTSBattery
 
-Battery Switch
-''''''''''''''
+Battery
+'''''''
 
 The light condition ``ORTSBattery`` allows a light to respond to the state of
-the :ref:`battery switch subsystem <physics-battery-switch>`. The valid settings
+the :ref:`battery subsystem <physics-battery>`. The valid settings
 and associated conditions for the light to turn *on* are as follows:
 
 - ``ORTSBattery ( 0 )`` Battery state is ignored (default)

Source/Documentation/Manual/physics.rst

@@ -4985,16 +4985,16 @@ outside the usual MSTS folders; e.g. brake parameters.
 Common locomotive subsystems
 ============================
 
-.. _physics-battery-switch:
+.. _physics-battery:
 
-Battery switch
---------------
+Battery
+-------
 
-The battery switch controls the low voltage power supply of the locomotive.
+The battery provides a low voltage power supply of the train car. It is activated via the battery switch.
 If the low voltage power supply is disabled, all of the systems of the locomotive are disabled
 (for example, the circuit breaker opens and the pantograph falls down).
 
-The battery switch of all locomotives in a consist can be controlled by
+The battery switch of all vehicles in a consist can be controlled by
 *Control Battery Switch Close* and *Control Battery Switch Open* commands
 ( ``<Insert>`` and ``<Ctrl+Insert>`` by default ). The status of the battery switch
 is indicated by the *Battery switch* value in the HUD view.
@@ -5020,13 +5020,25 @@ you have to keep pressing the button until the battery is (dis)connected.
 It is possible for the battery switch to be switched on at the start of the simulation.
 To activate this behaviour, you can add the optional parameter ``ORTSBattery( DefaultOn ( 1 ) )``
 
+The voltage and energetic capacity of the battery can be indicated using the ``Voltage`` and ``MaxCapacity``
+parameters. Optionally, it is possible to define a realistic capacity-voltage curve such that voltage becomes
+lower when the battery is discharged, using ``ChargeVoltageCurve``.
+
 Example::
 
     Engine (
       ORTSBattery (
         Mode ( PushButtons )
         Delay ( 2s )
         DefaultOn ( 1 )
+        Voltage ( 72V )
+        MaxCapacity ( 50kWh )
+        ChargeVoltageCurve (
+          0       0
+          5kWh    50V
+          30kWh   72V
+          50kWh   80V
+        )
       )
     )