added ENCODER_INVERT_ROTATION_WHEN_REVERSED

Author: flash62au

README.md

@@ -669,6 +669,15 @@ To change the configuration so that rotating the encoder clockwise increases spe
 
 <hr style="height: 1px;">
 
+### Direction of rotation of the encoder when the Loco is reversed
+
+By default, when the loco is reversed, to increase the speed of the loco you need to rotate the encoder in the same direction as when the loco direction is forward.  (See the previous heading.)
+If you wish to increase speed by rotating the encoder in the oposite direction when the direction is reverse' you can add the following define.  Uncomment (remove the ``//``) following line in your ``config_buttons.h``.
+
+``#define ENCODER_INVERT_ROTATION_WHEN_REVERSED                     true``
+
+<hr style="height: 1px;">
+
 ### Optional Additional Buttons 
 
 The way to add additional buttons changed in version 1.83.  The old way will continue to work but only the new way is described here.

WiTcontroller.ino

@@ -1437,6 +1437,12 @@ void rotary_loop() {
 }
 
 void encoderSpeedChange(bool rotationIsClockwise, int speedChange) {
+    #ifdef ENCODER_INVERT_ROTATION_WHEN_REVERSED
+      if (currentDirection[currentThrottleIndex] == Reverse) {
+        rotationIsClockwise = !rotationIsClockwise;
+      }
+    #endif
+
   if (encoderRotationClockwiseIsIncreaseSpeed) {
     if (rotationIsClockwise) {
       speedUp(currentThrottleIndex, speedChange);

change_log.md

@@ -1,4 +1,6 @@
 # Change Log
+### V1.104
+- Option to invert the meanaing of the encoder rotation when the loco is reversed ``#define ENCODER_INVERT_ROTATION_WHEN_REVERSED true``
 ### V1.103
 - Option to bypass the initial WiFi scan ``#define BYPASS_WIFI_SCAN_ON_STARTUP true``
 ### V1.102

config_buttons_example.h

@@ -17,6 +17,12 @@
 
 // #define ENCODER_ROTATION_CLOCKWISE_IS_INCREASE_SPEED                     false
 
+// Choose if you want to invert the rotary encoder rotation when the direction is reversed
+// i.e. If the direction of the current loco is 'Rev', turning the encoder clockwise will decrease the speed instead of increase
+// (or the opposite direction if ENCODER_ROTATION_CLOCKWISE_IS_INCREASE_SPEED is true)
+// Uncomment the following line to enable this feature
+// #define ENCODER_INVERT_ROTATION_WHEN_REVERSED true
+
 // Define what the rotary encoder button does.   (Pushing down on the knob)
 // By default it will stop the loco if moving, then a second push will change the direction.
 // Uncomment and change the action if you wish it to do something else.

static.h

@@ -1,4 +1,4 @@
-const String appVersion = "v1.103";
+const String appVersion = "v1.104";
 #ifndef CUSTOM_APPNAME
    const String appName = "WiTcontroller";
 #else