HAL Device templates

Author: Ash-4

docs/products/ex-commandstation/exrail/cookbooks/advanced/display-track-status.md

@@ -4,12 +4,12 @@
 
 To display track status, add a line in myAutomation.h
 ```cpp
-#include "myTrackStatus.example.h"
+  #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
+  #define MAX_CHARACTER_ROWS 17
 ```
 
 9 plus number of tracks; 17 for 8 tracks.
@@ -19,7 +19,9 @@ In addition to displaying track status, myTrackStatus.example.h will update the
 
 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
+
+```cpp
 // myAutomation.h - as used in the above example
 
 #include "myTrackStatus.example.h"
@@ -34,6 +36,7 @@ POWEROFF         // power command follows change in track mode
 DONE
 ```
 
+## myTrackStatus.h
 
 Contents of the example file -- suggested for review/reference on how various EXRAIL commands have been used.
 ```cpp
@@ -75,3 +78,39 @@ AUTOSTART
   STEALTH(StringFormatter::lcd(1, F("MS: %S"), DCC::getMotorShieldName());)
 DONE
 ```
+
+## Lines displayed
+
+Options to adjust lines reported.  
+On the primary display, SCREEN 0, blank lines are not displayed.
+
+There are multiple ways to avoid an extra line on the display; perhaps you just want the display to only contain 8 lines and not scroll.
+
+a.  One way to eliminate the Total line is to blank the line.  
+    Figure out which line is used.  If the `<JL` command results in 3 lines, starting on line 8, then write a blank line on line 10.  
+    .. in your customized myTrackStatus.h file.  
+
+```cpp
+    PARSE("<JL 0 8>")  // screen 0  start on line 8
+    SCREEN(0,10, "")  // blank to remove total
+```
+
+b.  use/change the parameter in config.h  
+
+```cpp
+    #define MAX_CHARACTER_ROWS 10
+```
+
+.. which results in lines 0-9 being available for use; line 10 is not displayed.
+
+c.  If it is the scrolling, and you want fewer lines displayed, select any of the static lines to blank
+    
+```cpp
+    AUTOSTART
+    SET_TRACK(A,MAIN)
+    SET_TRACK(B,PROG)
+      DELAYMINS(2)   // do not change defaults for 2 minutes
+      SCREEN(0, 0, "")
+      SCREEN(0, 1, "")
+    DONE
+```

docs/reference/.nav.yml

@@ -5,6 +5,7 @@ nav:
   - Serial Command Basics: serial-command-basics.md
   - Advanced config.h Options: advanced-config-h.md
   - TrackManager: trackmanager
+  - HAL Device Configuration: hal-device-templates.md
   - Command Station Internal Architecture: command-station-arch.md
   - Throttle Writers Guide: throttle-writers-guide.md
   - Legacy Command Reference: legacy-command-reference.md

docs/reference/ex-csb1/csb1-errors-faq.md

@@ -1,10 +1,50 @@
 # EX-CSB1 FAQ
 
-- Error indicating the need for installing Windows drivers  
-  link to driver
+## CH340 USB Drivers
 
-- Info regarding the need to add capacitor to enable uploading
+Windows USB driver is required.  
+  CH340 driver info [https://learn.sparkfun.com/tutorials/how-to-install-ch340-drivers](https://learn.sparkfun.com/tutorials/how-to-install-ch340-drivers/all)
 
-- asdf
+Note that only one program can use the USB connection simultaneously.  Close the device monitor or other programs when uploading.
 
-- jkl
+## Track voltage
+
+DCC is a square wave signal.  The voltage of the track power supply will be present on each rail 50% of the time.  Use the DC scale to measure voltage -- each rail vs GND should be 50% of track power supply.  
+
+Few digital multimeters will provide a consistent/useful reading on the AC scale.
+
+## OLED
+
+Select 132x64 or 128x64  
+If one results in blank screen or image is shifted, try the other.
+
+## Power supply
+
+If your power supply is less than 5A, add a line in config.h to set overcurrent reporting lower - 90% of track power supply.  
+[motor-shield-max-current](../advanced-config-h.md#motor-shield-max-current)
+
+## Fault reporting
+
+Continuous faults will be reported with power on, if track power supply is not connected.
+
+An initial fault report at power-on is not an issue.
+
+## Overcurrent reporting
+
+Some - 600mA or less - overcurrent reporting on the programming track is not unusual.  This is due to lack of precision of the ESP32-WROOM ADC, and the 250mA trip current for the programming track when not reading/writing CVs.
+
+There is a command `<C PROGBOOST>` to override the 250mA limit.  Do not use it unless you are comfortable that your loco/decoder do not have issues (which 250mA is designed to protect).  
+Note that `<C PROGBOOST>` remains in effect until the command station is restarted.
+
+## WiFi
+
+WiFi configuration is different, starting with version 5.7.0.  
+config.h is used for WiFi configuration in earlier versions.  
+Link to [5.7.0 WiFi Configuration](../../products/ex-commandstation/config-wifi-esp32.md)
+
+Note that if the new WiFi configuration commands are sent via a WiFi connection, your existing connection will drop.  Current connection info should be reported on the OLED.
+
+## Discord
+
+Join the discussion on the discord server.  
+[https://dcc-ex.com/mkdocs-test/support/discord/](../../support/discord.md)