Dynamic brake authorization by TCS

Author: cesarBLG

Source/Orts.Simulation/Common/Scripting/TrainControlSystem.cs

@@ -249,6 +249,10 @@ internal void AttachToHost(ScriptedTrainControlSystem host)
         /// </summary>
         public Func<bool> TractionAuthorization;
         /// <summary>
+        /// True if dynamic braking is authorized.
+        /// </summary>
+        public Func<bool> DynamicBrakingAuthorization;
+        /// <summary>
         /// Train brake pipe pressure. Returns float.MaxValue if no data is available.
         /// </summary>
         public Func<float> BrakePipePressureBar;
@@ -387,6 +391,10 @@ internal void AttachToHost(ScriptedTrainControlSystem host)
         /// </summary>
         public Action<bool> SetTractionAuthorization;
         /// <summary>
+        /// Set the dynamic braking authorization.
+        /// </summary>
+        public Action<bool> SetDynamicBrakingAuthorization;
+        /// <summary>
         /// Set the maximum throttle percent
         /// Range: 0 to 100
         /// </summary>

Source/Orts.Simulation/Simulation/RollingStocks/MSTSLocomotive.cs

@@ -2677,7 +2677,7 @@ protected virtual void UpdateDynamicBrakeForce(float elapsedClockSeconds)
                 DynamicBrake = false;
                 DynamicBrakeCommandStartTime = null;
             }
-            float maxdynamic = DynamicBrake ? 1 : 0;
+            float maxdynamic = DynamicBrake ? MaxDynamicBrakePercent / 100 : 0;
             float d = DynamicBrakePercent / 100;
             bool dynamicLimited = d > maxdynamic;
             if (dynamicLimited) d = maxdynamic;

Source/Orts.Simulation/Simulation/RollingStocks/SubSystems/TrainControlSystem.cs

@@ -150,6 +150,7 @@ protected set
         public bool CircuitBreakerClosingOrder { get; private set; }
         public bool CircuitBreakerOpeningOrder { get; private set; }
         public bool TractionAuthorization { get; private set; }
+        public bool DynamicBrakingAuthorization { get; private set; }
         public float MaxThrottlePercent { get; private set; } = 100f;
         public bool FullDynamicBrakingOrder { get; private set; }
 
@@ -187,6 +188,7 @@ public ScriptedTrainControlSystem(MSTSLocomotive locomotive)
             CircuitBreakerClosingOrder = false;
             CircuitBreakerOpeningOrder = false;
             TractionAuthorization = true;
+            DynamicBrakingAuthorization = true;
             FullDynamicBrakingOrder = false;
         }
 
@@ -363,6 +365,7 @@ public void Initialize()
                 Script.MaxThrottlePercent = () => MaxThrottlePercent;
                 Script.DynamicBrakePercent = () => Locomotive.DynamicBrakeController == null ? 0 : Locomotive.DynamicBrakeController.CurrentValue * 100;
                 Script.TractionAuthorization = () => TractionAuthorization;
+                Script.DynamicBrakingAuthorization = () => DynamicBrakingAuthorization;
                 Script.BrakePipePressureBar = () => Locomotive.BrakeSystem != null ? Bar.FromPSI(Locomotive.BrakeSystem.BrakeLine1PressurePSI) : float.MaxValue;
                 Script.LocomotiveBrakeCylinderPressureBar = () => Locomotive.BrakeSystem != null ? Bar.FromPSI(Locomotive.BrakeSystem.GetCylPressurePSI()) : float.MaxValue;
                 Script.DoesBrakeCutPower = () => Locomotive.DoesBrakeCutPower;
@@ -457,6 +460,7 @@ public void Initialize()
                 Script.SetCircuitBreakerClosingOrder = (value) => CircuitBreakerClosingOrder = value;
                 Script.SetCircuitBreakerOpeningOrder = (value) => CircuitBreakerOpeningOrder = value;
                 Script.SetTractionAuthorization = (value) => TractionAuthorization = value;
+                Script.SetDynamicBrakingAuthorization = (value) => DynamicBrakingAuthorization = value;
                 Script.SetMaxThrottlePercent = (value) =>
                 {
                     if (value >= 0 && value <= 100f)

Source/Orts.Simulation/Simulation/RollingStocks/TrainCar.cs

@@ -500,6 +500,21 @@ public int GearboxGearIndex
         }
 
         public float LocalDynamicBrakePercent = -1;
+        public float MaxDynamicBrakePercent
+        {
+            get
+            {
+                float percent = 100;
+                if (RemoteControlGroup == 0 && Train != null && Train.LeadLocomotive is MSTSLocomotive locomotive)
+                {
+                    if (!locomotive.TrainControlSystem.DynamicBrakingAuthorization)
+                    {
+                        percent = 0;
+                    }
+                }
+                return percent;
+            }
+        }
         public float DynamicBrakePercent
         {
             get