Track status display

Author: Ash-4

docs/_static/images/ex-csb1/track-status-display.png

@@ -1,3 +1,4 @@
 nav:
   - Display Locos On Oled: display-locos-on-oled.md
+  - Display Track Status: display-track-status.md
   - "*"

docs/products/ex-commandstation/exrail/cookbooks/advanced/.nav.yml

@@ -0,0 +1,77 @@
+# Display Track Status on OLED
+
+![Track Status Display](/_static/images/ex-csb1/track-status-display.png)
+
+To display track status, add a line in myAutomation.h
+```cpp
+#include "myTrackStatus.example.h"
+```
+
+If using Mega, a line will be needed in config.h to allocate memory for additional lines on the first display.  
+```cpp
+#define MAX_CHARACTER_ROWS 17
+```
+
+9 plus number of tracks; 17 for 8 tracks.
+CSB1, ESP32-WROOM and Nucleo-F4 have this setting as default.
+
+In addition to displaying track status, myTrackStatus.example.h will update the second line on the display, to show the motor shield type after 10 seconds.
+
+myTrackStatus.example.h can be used by adding the `#include` line in myAutomation.h, or you can copy/rename the file in your backup folder and customize it so that the information is displayed on a different screen.
+
+```
+// myAutomation.h - as used in the above example
+
+#include "myTrackStatus.example.h"
+
+AUTOSTART
+SET_TRACK(A,MAIN)
+SET_TRACK(B,PROG)
+POWEROFF         // power command follows change in track mode
+  DELAYMINS(2)   // do not change defaults for 2 minutes
+  SCREEN(0, 0, "")    // clear two static rows
+  SCREEN(0, 1, "")    // to avoid scrolling
+DONE
+```
+
+
+Contents of the example file -- suggested for review/reference on how various EXRAIL commands have been used.
+```cpp
+// myTrackStatus.example.h
+
+// Reporting power status and mA for each track on the LCD
+HAL(Bitmap,8236,1) // create flag 8236
+AUTOSTART DELAY(5000) 
+ ROUTE("TRACKSTATUS"_hk, "Resume/Pause JL Display")
+  IF(8236) 
+    RESET(8236)
+     ROUTE_CAPTION("TRACKSTATUS"_hk, "Paused") ROUTE_INACTIVE("TRACKSTATUS"_hk)
+      SCREEN(0, 8, "Track status paused")
+      SCREEN(0, 9, "")
+      SCREEN(0,10, "")   // several blank lines as needed
+      SCREEN(0,11, "")
+      SCREEN(0,12, "")
+      SCREEN(0,13, "")
+      SCREEN(0,14, "")
+      SCREEN(0,15, "")
+      SCREEN(0,16, "")
+      PRINT("to pause/resume: </START TRACKSTATUS> \n")
+    DONE ENDIF
+  SET(8236) 
+   ROUTE_CAPTION("TRACKSTATUS"_hk, "Running") ROUTE_ACTIVE("TRACKSTATUS"_hk)
+    PRINT("Resume JL Display")
+   FOLLOW("PAUSETRACKSTATUS"_hk)
+  SEQUENCE("PAUSETRACKSTATUS"_hk)
+   PARSE("<JL 0 8>")  // screen 0  start on line 8
+    PRINT("to pause/resume: </START TRACKSTATUS> \n")
+    DELAY(3000)
+  IF(8236) FOLLOW("PAUSETRACKSTATUS"_hk) ENDIF
+  DONE
+// ************ End OLED JL Display Track mA Amperage ************** //
+
+// Display motor shield after 10 seconds
+AUTOSTART
+  DELAY(10000)
+  STEALTH(StringFormatter::lcd(1, F("MS: %S"), DCC::getMotorShieldName());)
+DONE
+```