etc

reuse, update lcd_preheat
misc
2025-03-17 21:00:23 -05:00 · 2025-03-17 20:29:54 -05:00 · 2025-03-17 20:10:00 -05:00 · 2025-03-17 20:04:33 -05:00 · 2025-03-17 20:00:16 -05:00 · 2025-03-18 00:28:49 +00:00
1218 changed files with 54031 additions and 68371 deletions
@@ -0,0 +1,21 @@
 # Build artifacts
 buildroot/
 *.o
 *.a
 *.so
 *.dylib
 *.dll
 *.exe
 # Web assets
 *.min.js
 *.min.css
 # Generated files
 __pycache__/
 *.pyc
 .DS_Store
 # IDE files
 .vscode/
 .idea/
@@ -7,7 +7,7 @@ contact_links:
    url: https://www.facebook.com/groups/1049718498464482
    about: Please ask and answer questions here.
  - name: 🕹 Marlin on Discord
-    url: https://discord.gg/n5NJ59y
+    url: https://discord.com/servers/marlin-firmware-461605380783472640
    about: Join the Discord server for support and discussion.
  - name: 🔗 Marlin Discussion Forum
    url: https://reprap.org/forum/list.php?415
@@ -43,7 +43,7 @@ We have a Message Board and a Facebook group where our knowledgable user communi
 If chat is more your speed, you can join the MarlinFirmware Discord server:
-* Use the link https://discord.gg/n5NJ59y to join up as a General User.
+* Use the link https://discord.com/servers/marlin-firmware-461605380783472640 to join up as a General User.
 * Even though our Discord is pretty active, it may take a while for community members to respond &mdash; please be patient!
 * Use the `#general` channel for general questions or discussion about Marlin.
 * Other channels exist for certain topics or are limited to Patrons. Check the channel list.
@@ -14,7 +14,7 @@ jobs:
  autolabel:
    name: Auto Label
    if: github.repository == 'MarlinFirmware/Marlin'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
    steps:
    - name: Auto Label for [BUG]
      uses: actions/github-script@v7
@@ -14,7 +14,7 @@ jobs:
    name: Bump Distribution Date
    if: github.repository == 'MarlinFirmware/Marlin'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
    steps:
@@ -18,7 +18,7 @@ jobs:
    name: PR Bad Target
    if: github.repository == 'MarlinFirmware/Marlin'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
    steps:
    - uses: superbrothers/close-pull-request@v3
@@ -34,14 +34,19 @@ jobs:
    name: Build Test
    if: github.repository == 'MarlinFirmware/Marlin'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
    strategy:
      fail-fast: true
      matrix:
        test-platform:
        # RP2040
        - SKR_Pico
        # Native
        - linux_native
        - simulator_linux_release
        # AVR
        - mega2560
@@ -104,11 +109,11 @@ jobs:
        # STM32F4
        - ARMED
-        - BIGTREE_BTT002
+        - BTT_BTT002
-        - BIGTREE_GTR_V1_0
+        - BTT_GTR_V1_0
-        - BIGTREE_SKR_PRO
+        - BTT_SKR_PRO
        - FLYF407ZG
-        - FYSETC_S6
+        - STM32F446VE_fysetc
        - LERDGEK
        - LERDGEX
        - mks_robin_pro2
@@ -181,6 +186,14 @@ jobs:
        pio upgrade --dev
        pio pkg update --global
    - name: Install Simulator dependencies
      run: |
        sudo apt-get update
        sudo apt-get install build-essential
        sudo apt-get install libsdl2-dev
        sudo apt-get install libsdl2-net-dev
        sudo apt-get install libglm-dev
    - name: Run ${{ matrix.test-platform }} Tests
      run: |
        make tests-single-ci TEST_TARGET=${{ matrix.test-platform }}
@@ -36,7 +36,7 @@ jobs:
    # pulls them into additional branches.
    if: github.repository == 'MarlinFirmware/Marlin'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
    steps:
    - name: Check out the PR
@@ -0,0 +1,48 @@
 #
 # ci-validate-boards.yml
 # Validate boards.h to make sure it's all set up correctly
 #
 name: CI - Validate boards.h
 # We can do the on: section as two items, one for pull requests and one for pushes...
 on:
  pull_request:
    branches:
    - bugfix-2.1.x
    paths:
    - 'Marlin/src/core/boards.h'
  push:
    branches:
    - bugfix-2.1.x
    paths:
    - 'Marlin/src/core/boards.h'
 jobs:
  validate_pins_files:
    name: Validate boards.h
    if: github.repository == 'MarlinFirmware/Marlin'
    runs-on: ubuntu-22.04
    steps:
    - name: Check out the PR
      uses: actions/checkout@v4
    - name: Cache pip
      uses: actions/cache@v4
      with:
        path: ~/.cache/pip
        key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
        restore-keys: |
          ${{ runner.os }}-pip-
    - name: Select Python 3.9
      uses: actions/setup-python@v5
      with:
        python-version: '3.9'
        architecture: 'x64'
    - name: Validate core/boards.h
      run: |
        make validate-boards -j
@@ -26,7 +26,7 @@ jobs:
    name: Validate Pins Files
    if: github.repository == 'MarlinFirmware/Marlin'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
    steps:
    - name: Check out the PR
@@ -13,7 +13,7 @@ on:
 jobs:
  remove_label:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
    strategy:
      matrix:
@@ -14,7 +14,7 @@ jobs:
    name: Close Stale Issues
    if: github.repository == 'MarlinFirmware/Marlin'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
    steps:
    - uses: actions/stale@v9
@@ -14,7 +14,7 @@ jobs:
    name: Lock Closed Issues
    if: github.repository == 'MarlinFirmware/Marlin'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
    steps:
    - uses: dessant/lock-threads@v5
@@ -14,7 +14,7 @@ jobs:
    name: Unlock Reopened
    if: github.repository == 'MarlinFirmware/Marlin'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
    steps:
    - uses: OSDKDev/unlock-issues@v1.1
@@ -125,6 +125,7 @@ vc-fileutils.settings
 # Visual Studio Code
 .vscode/*
 !.vscode/extensions.json
 *.code-workspace
 # Simulation files
 imgui.ini
@@ -168,3 +169,6 @@ __pycache__
 tags
 *.logs
 *.bak
 .aider*
 !.aiderignore
 .env
@@ -0,0 +1,16 @@
 /**
 * Marlin-specific settings for Zed
 *
 * For a full list of overridable settings, and general information on folder-specific settings,
 * see the documentation: https://zed.dev/docs/configuring-zed#settings-files
 */
 {
  "languages": {
    "C": {
      "enable_language_server": false
    },
    "C++": {
      "enable_language_server": false
    }
  }
 }
@@ -6,9 +6,10 @@ UNIT_TEST_CONFIG ?= default
 help:
 	@echo "Tasks for local development:"
-	@echo "make marlin                    : Build marlin for the configured board"
+	@echo "make marlin                    : Build Marlin for the configured board"
 	@echo "make format-pins -j            : Reformat all pins files (-j for parallel execution)"
 	@echo "make validate-pins -j          : Validate all pins files, fails if any require reformatting"
 	@echo "make validate-boards -j        : Validate boards.h and pins.h for standards compliance"
 	@echo "make tests-single-ci           : Run a single test from inside the CI"
 	@echo "make tests-single-local        : Run a single test locally"
 	@echo "make tests-single-local-docker : Run a single test locally, using docker"
@@ -102,3 +103,11 @@ format-pins: $(PINS)
 validate-pins: format-pins
 	@echo "Validating pins files"
 	@git diff --exit-code || (git status && echo "\nError: Pins files are not formatted correctly. Run \"make format-pins\" to fix.\n" && exit 1)
 BOARDS_FILE := Marlin/src/core/boards.h
 .PHONY: validate-boards
 validate-boards:
 	@echo "Validating boards.h file"
 	@python $(SCRIPTS_DIR)/validate_boards.py $(BOARDS_FILE) || (echo "\nError: boards.h file is not valid. Please check and correct it.\n" && exit 1)
@@ -50,7 +50,7 @@
 *
 * Calibration Guides:  https://reprap.org/wiki/Calibration
 *                      https://reprap.org/wiki/Triffid_Hunter%27s_Calibration_Guide
- *                      https://web.archive.org/web/20220907014303/https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
+ *                      https://web.archive.org/web/20220907014303/sites.google.com/site/repraplogphase/calibration-of-your-reprap
 *                      https://youtu.be/wAL9d7FgInk
 *                      https://teachingtechyt.github.io/calibration.html
 *
@@ -61,7 +61,7 @@
 // @section info
 // Author info of this build printed to the host during boot and M115
-#define STRING_CONFIG_H_AUTHOR "(none, default config)" // Who made the changes.
+#define STRING_CONFIG_H_AUTHOR "(none, default config)" // Original author or contributor.
 //#define CUSTOM_VERSION_FILE Version.h // Path from the root directory (no quotes)
 // @section machine
@@ -71,13 +71,15 @@
  #define MOTHERBOARD BOARD_RAMPS_14_EFB
 #endif
 // @section serial
 /**
 * Select the serial port on the board to use for communication with the host.
 * This allows the connection of wireless adapters (for instance) to non-default port pins.
 * Serial port -1 is the USB emulated serial port, if available.
 * Note: The first serial port (-1 or 0) will always be used by the Arduino bootloader.
 *
- * :[-1, 0, 1, 2, 3, 4, 5, 6, 7]
+ * :[-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
 */
 #define SERIAL_PORT 0
@@ -99,24 +101,35 @@
 /**
 * Select a secondary serial port on the board to use for communication with the host.
 * Currently Ethernet (-2) is only supported on Teensy 4.1 boards.
- * :[-2, -1, 0, 1, 2, 3, 4, 5, 6, 7]
+ * :[-2, -1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
 */
 //#define SERIAL_PORT_2 -1
 //#define BAUDRATE_2 250000   // :[2400, 9600, 19200, 38400, 57600, 115200, 250000, 500000, 1000000] Enable to override BAUDRATE
 /**
 * Select a third serial port on the board to use for communication with the host.
- * Currently only supported for AVR, DUE, LPC1768/9 and STM32/STM32F1
+ * Currently supported for AVR, DUE, SAMD51, LPC1768/9, STM32/STM32F1/HC32, and Teensy 4.x
- * :[-1, 0, 1, 2, 3, 4, 5, 6, 7]
+ * :[-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
 */
 //#define SERIAL_PORT_3 1
 //#define BAUDRATE_3 250000   // :[2400, 9600, 19200, 38400, 57600, 115200, 250000, 500000, 1000000] Enable to override BAUDRATE
 /**
 * Select a serial port to communicate with RS485 protocol
 * :[-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
 */
 //#define RS485_SERIAL_PORT 1
 #ifdef RS485_SERIAL_PORT
  //#define M485_PROTOCOL 1   // Check your host for protocol compatibility
  //#define RS485_BUS_BUFFER_SIZE 128
 #endif
 // Enable the Bluetooth serial interface on AT90USB devices
 //#define BLUETOOTH
 // Name displayed in the LCD "Ready" message and Info menu
 //#define CUSTOM_MACHINE_NAME "3D Printer"
 //#define CONFIGURABLE_MACHINE_NAME // Add G-code M550 to set/report the machine name
 // Printer's unique ID, used by some programs to differentiate between machines.
 // Choose your own or use a service like https://www.uuidgenerator.net/version4
@@ -375,14 +388,15 @@
 *   PRUSA_MMU1           : Průša MMU1 (The "multiplexer" version)
 *   PRUSA_MMU2           : Průša MMU2
 *   PRUSA_MMU2S          : Průša MMU2S (Requires MK3S extruder with motion sensor, EXTRUDERS = 5)
 *   PRUSA_MMU3           : Průša MMU3  (Requires MK3S extruder with motion sensor and MMU firmware version 3.x.x, EXTRUDERS = 5)
 *   EXTENDABLE_EMU_MMU2  : MMU with configurable number of filaments (ERCF, SMuFF or similar with Průša MMU2 compatible firmware)
 *   EXTENDABLE_EMU_MMU2S : MMUS with configurable number of filaments (ERCF, SMuFF or similar with Průša MMU2 compatible firmware)
 *
 * Requires NOZZLE_PARK_FEATURE to park print head in case MMU unit fails.
 * See additional options in Configuration_adv.h.
- * :["PRUSA_MMU1", "PRUSA_MMU2", "PRUSA_MMU2S", "EXTENDABLE_EMU_MMU2", "EXTENDABLE_EMU_MMU2S"]
+ * :["PRUSA_MMU1", "PRUSA_MMU2", "PRUSA_MMU2S", "PRUSA_MMU3", "EXTENDABLE_EMU_MMU2", "EXTENDABLE_EMU_MMU2S"]
 */
-//#define MMU_MODEL PRUSA_MMU2
+//#define MMU_MODEL PRUSA_MMU3
 // @section psu control
@@ -573,7 +587,7 @@
 #define DUMMY_THERMISTOR_998_VALUE  25
 #define DUMMY_THERMISTOR_999_VALUE 100
-// Resistor values when using MAX31865 sensors (-5) on TEMP_SENSOR_0 / 1
+// Resistor values when using MAX31865 sensors (-5) on TEMP_SENSOR_0 / 1 / 2 / BED
 #if TEMP_SENSOR_IS_MAX_TC(0)
  #define MAX31865_SENSOR_OHMS_0      100 // (Ω) Typically 100 or 1000 (PT100 or PT1000)
  #define MAX31865_CALIBRATION_OHMS_0 430 // (Ω) Typically 430 for Adafruit PT100; 4300 for Adafruit PT1000
@@ -586,6 +600,10 @@
  #define MAX31865_SENSOR_OHMS_2      100
  #define MAX31865_CALIBRATION_OHMS_2 430
 #endif
 #if TEMP_SENSOR_IS_MAX_TC(BED)
  #define MAX31865_SENSOR_OHMS_BED      100
  #define MAX31865_CALIBRATION_OHMS_BED 430
 #endif
 #if HAS_E_TEMP_SENSOR
  #define TEMP_RESIDENCY_TIME         10  // (seconds) Time to wait for hotend to "settle" in M109
@@ -678,6 +696,7 @@
 #define PID_K1     0.95   // Smoothing factor within any PID loop
 #if ENABLED(PIDTEMP)
  //#define MIN_POWER 0
  //#define PID_DEBUG             // Print PID debug data to the serial port. Use 'M303 D' to toggle activation.
  //#define PID_PARAMS_PER_HOTEND // Use separate PID parameters for each extruder (useful for mismatched extruders)
                                  // Set/get with G-code: M301 E[extruder number, 0-2]
@@ -703,10 +722,13 @@
 * Use a physical model of the hotend to control temperature. When configured correctly this gives
 * better responsiveness and stability than PID and removes the need for PID_EXTRUSION_SCALING
 * and PID_FAN_SCALING. Enable MPC_AUTOTUNE and use M306 T to autotune the model.
- * @section mpctemp
+ * @section mpc temp
 */
 #if ENABLED(MPCTEMP)
  #define MPC_AUTOTUNE                                // Include a method to do MPC auto-tuning (~6.3K bytes of flash)
  #if ENABLED(MPC_AUTOTUNE)
    //#define MPC_AUTOTUNE_DEBUG                      // Enable MPC debug logging (~870 bytes of flash)
  #endif
  //#define MPC_EDIT_MENU                             // Add MPC editing to the "Advanced Settings" menu. (~1.3K bytes of flash)
  //#define MPC_AUTOTUNE_MENU                         // Add MPC auto-tuning to the "Advanced Settings" menu. (~350 bytes of flash)
@@ -788,6 +810,40 @@
  //#define BED_LIMIT_SWITCHING   // Keep the bed temperature within BED_HYSTERESIS of the target
 #endif
 /**
 * Peltier Bed - Heating and Cooling
 *
 * A Peltier device transfers heat from one side to the other in proportion to the amount of
 * current flowing through the device and the direction of current flow. So the same device
 * can both heat and cool.
 *
 * When "cooling" in addition to rejecting the heat transferred from the hot side to the cold
 * side, the dissipated power (voltage * current) must also be rejected. Be sure to set up a
 * fan that can be powered in sync with the Peltier unit.
 *
 * This feature is only set up to run in bang-bang mode because Peltiers don't handle PWM
 * well without filter circuitry.
 *
 * Since existing 3D printers are made to handle relatively high current for the heated bed,
 * we can use the heated bed power pins to control the Peltier power using the same G-codes
 * as the heated bed (M140, M190, etc.).
 *
 * A second GPIO pin is required to control current direction.
 * Two configurations are possible: Relay and H-Bridge
 *
 * (At this time only relay is supported. H-bridge requires 4 MOS switches configured in H-Bridge.)
 *
 * Power is handled by the bang-bang control loop: 0 or 255.
 * Cooling applications are more common than heating, so the pin states are commonly:
 *   LOW  = Heating = Relay Energized
 *   HIGH = Cooling = Relay in "Normal" state
 */
 //#define PELTIER_BED
 #if ENABLED(PELTIER_BED)
  #define PELTIER_DIR_PIN           -1  // Relay control pin for Peltier
  #define PELTIER_DIR_HEAT_STATE   LOW  // The relay pin state that causes the Peltier to heat
 #endif
 // Add 'M190 R T' for more gradual M190 R bed cooling.
 //#define BED_ANNEALING_GCODE
@@ -828,14 +884,16 @@
  // Lasko "MyHeat Personal Heater" (200w) modified with a Fotek SSR-10DA to control only the heating element
  // and placed inside the small Creality printer enclosure tent.
  //
-  #define DEFAULT_chamberKp 37.04
+  #define DEFAULT_chamberKp  37.04
-  #define DEFAULT_chamberKi 1.40
+  #define DEFAULT_chamberKi   1.40
  #define DEFAULT_chamberKd 655.17
  // M309 P37.04 I1.04 D655.17
  // FIND YOUR OWN: "M303 E-2 C8 S50" to run autotune on the chamber at 50 degreesC for 8 cycles.
 #endif // PIDTEMPCHAMBER
 // @section pid temp
 #if ANY(PIDTEMP, PIDTEMPBED, PIDTEMPCHAMBER)
  //#define PID_OPENLOOP          // Puts PID in open loop. M104/M140 sets the output power from 0 to PID_MAX
  //#define SLOW_PWM_HEATERS      // PWM with very low frequency (roughly 0.125Hz=8s) and minimum state time of approximately 1s useful for heaters driven by a relay
@@ -891,7 +949,7 @@
 //============================= Mechanical Settings =========================
 //===========================================================================
-// @section machine
+// @section kinematics
 // Enable one of the options below for CoreXY, CoreXZ, or CoreYZ kinematics,
 // either in the usual order or reversed
@@ -915,6 +973,15 @@
 // Enable for a belt style printer with endless "Z" motion
 //#define BELTPRINTER
 // Articulated robot (arm). Joints are directly mapped to axes with no kinematics.
 //#define ARTICULATED_ROBOT_ARM
 // For a hot wire cutter with parallel horizontal axes (X, I) where the heights of the two wire
 // ends are controlled by parallel axes (Y, J). Joints are directly mapped to axes (no kinematics).
 //#define FOAMCUTTER_XYUV
 // @section polargraph
 // Enable for Polargraph Kinematics
 //#define POLARGRAPH
 #if ENABLED(POLARGRAPH)
@@ -1101,15 +1168,6 @@
  #define FEEDRATE_SCALING                  // Convert XY feedrate from mm/s to degrees/s on the fly
 #endif
 // @section machine
 // Articulated robot (arm). Joints are directly mapped to axes with no kinematics.
 //#define ARTICULATED_ROBOT_ARM
 // For a hot wire cutter with parallel horizontal axes (X, I) where the heights of the two wire
 // ends are controlled by parallel axes (Y, J). Joints are directly mapped to axes (no kinematics).
 //#define FOAMCUTTER_XYUV
 //===========================================================================
 //============================== Endstop Settings ===========================
 //===========================================================================
@@ -1454,7 +1512,7 @@
 * A lightweight, solenoid-driven probe.
 * For information about this sensor https://github.com/bigtreetech/MicroProbe
 *
- * Also requires: PROBE_ENABLE_DISABLE
+ * Also requires PROBE_ENABLE_DISABLE
 */
 //#define BIQU_MICROPROBE_V1  // Triggers HIGH
 //#define BIQU_MICROPROBE_V2  // Triggers LOW
@@ -1593,14 +1651,15 @@
 // with NOZZLE_AS_PROBE this can be negative for a wider probing area.
 #define PROBING_MARGIN 10
-// X and Y axis travel speed (mm/min) between probes
+// X and Y axis travel speed between probes.
-#define XY_PROBE_FEEDRATE (133*60)
+// Leave undefined to use the average of the current XY homing feedrate.
 #define XY_PROBE_FEEDRATE    (133*60) // (mm/min)
-// Feedrate (mm/min) for the first approach when double-probing (MULTIPLE_PROBING == 2)
+// Feedrate for the first approach when double-probing (MULTIPLE_PROBING == 2)
-#define Z_PROBE_FEEDRATE_FAST (4*60)
+#define Z_PROBE_FEEDRATE_FAST  (4*60) // (mm/min)
-// Feedrate (mm/min) for the "accurate" probe of each point
+// Feedrate for the "accurate" probe of each point
-#define Z_PROBE_FEEDRATE_SLOW (Z_PROBE_FEEDRATE_FAST / 2)
+#define Z_PROBE_FEEDRATE_SLOW (Z_PROBE_FEEDRATE_FAST / 2) // (mm/min)
 /**
 * Probe Activation Switch
@@ -1624,6 +1683,7 @@
  #define PROBE_TARE_DELAY 200    // (ms) Delay after tare before
  #define PROBE_TARE_STATE HIGH   // State to write pin for tare
  //#define PROBE_TARE_PIN PA5    // Override default pin
  //#define PROBE_TARE_MENU       // Display a menu item to tare the probe
  #if ENABLED(PROBE_ACTIVATION_SWITCH)
    //#define PROBE_TARE_ONLY_WHILE_INACTIVE  // Fail to tare/probe if PROBE_ACTIVATION_SWITCH is active
  #endif
@@ -1661,8 +1721,8 @@
 * probe Z Offset set with NOZZLE_TO_PROBE_OFFSET, M851, or the LCD.
 * Only integer values >= 1 are valid here.
 *
- * Example: `M851 Z-5` with a CLEARANCE of 4  =>  9mm from bed to nozzle.
+ * Example: 'M851 Z-5' with a CLEARANCE of 4  =>  9mm from bed to nozzle.
- *     But: `M851 Z+1` with a CLEARANCE of 2  =>  2mm from bed to nozzle.
+ *     But: 'M851 Z+1' with a CLEARANCE of 2  =>  2mm from bed to nozzle.
 */
 #define Z_CLEARANCE_DEPLOY_PROBE   10 // (mm) Z Clearance for Deploy/Stow
 #define Z_CLEARANCE_BETWEEN_PROBES  5 // (mm) Z Clearance between probe points
@@ -1713,18 +1773,20 @@
  #define PROBING_BED_TEMP     50
 #endif
 // @section stepper drivers
 // For Inverting Stepper Enable Pins (Active Low) use 0, Non Inverting (Active High) use 1
-// :{ 0:'Low', 1:'High' }
+// :['LOW', 'HIGH']
-#define X_ENABLE_ON 0
+#define X_ENABLE_ON LOW
-#define Y_ENABLE_ON 0
+#define Y_ENABLE_ON LOW
-#define Z_ENABLE_ON 0
+#define Z_ENABLE_ON LOW
-#define E_ENABLE_ON 0 // For all extruders
+#define E_ENABLE_ON LOW // For all extruders
-//#define I_ENABLE_ON 0
+//#define I_ENABLE_ON LOW
-//#define J_ENABLE_ON 0
+//#define J_ENABLE_ON LOW
-//#define K_ENABLE_ON 0
+//#define K_ENABLE_ON LOW
-//#define U_ENABLE_ON 0
+//#define U_ENABLE_ON LOW
-//#define V_ENABLE_ON 0
+//#define V_ENABLE_ON LOW
-//#define W_ENABLE_ON 0
+//#define W_ENABLE_ON LOW
 // Disable axis steppers immediately when they're not being stepped.
 // WARNING: When motors turn off there is a chance of losing position accuracy!
@@ -1886,6 +1948,8 @@
 #endif
 /**
 * @section filament runout sensors
 *
 * Filament Runout Sensors
 * Mechanical or opto endstops are used to check for the presence of filament.
 *
@@ -1997,9 +2061,9 @@
        //#define FIL_MOTION8_PULLUP
        //#define FIL_MOTION8_PULLDOWN
      #endif
-    #endif
+    #endif // FILAMENT_MOTION_SENSOR
-  #endif
+  #endif // FILAMENT_RUNOUT_DISTANCE_MM
-#endif
+#endif // FILAMENT_RUNOUT_SENSOR
 //===========================================================================
 //=============================== Bed Leveling ==============================
@@ -2045,6 +2109,12 @@
 //#define AUTO_BED_LEVELING_UBL
 //#define MESH_BED_LEVELING
 /**
 * Commands to execute at the start of G29 probing,
 * after switching to the PROBING_TOOL.
 */
 //#define EVENT_GCODE_BEFORE_G29 "M300 P440 S200"
 /**
 * Commands to execute at the end of G29 probing.
 * Useful to retract or move the Z probe out of the way.
@@ -2282,6 +2352,9 @@
 // Homing speeds (linear=mm/min, rotational=°/min)
 #define HOMING_FEEDRATE_MM_M { (50*60), (50*60), (4*60) }
 // Edit homing feedrates with M210 and MarlinUI menu items
 //#define EDITABLE_HOMING_FEEDRATE
 // Validate that endstops are triggered on homing moves
 #define VALIDATE_HOMING_ENDSTOPS
@@ -2408,9 +2481,9 @@
 #define PREHEAT_2_TEMP_CHAMBER 35
 #define PREHEAT_2_FAN_SPEED     0 // Value from 0 to 255
 // @section motion
 /**
 * @section nozzle park
 *
 * Nozzle Park
 *
 * Park the nozzle at the given XYZ position on idle or G27.
@@ -2433,6 +2506,8 @@
 #endif
 /**
 * @section nozzle clean
 *
 * Clean Nozzle Feature
 *
 * Adds the G12 command to perform a nozzle cleaning process.
@@ -2593,9 +2668,24 @@
  //#include "Configuration_Secure.h"       // External file with PASSWORD_DEFAULT_VALUE
 #endif
-//=============================================================================
+// @section media
-//============================= LCD and SD support ============================
+
-//=============================================================================
+/**
 * SD CARD
 *
 * SD Card support is disabled by default. If your controller has an SD slot,
 * you must uncomment the following option or it won't work.
 */
 //#define SDSUPPORT
 /**
 * SD CARD: ENABLE CRC
 *
 * Use CRC checks and retries on the SD communication.
 */
 #if ENABLED(SDSUPPORT)
  //#define SD_CHECK_AND_RETRY
 #endif
 // @section interface
@@ -2642,21 +2732,6 @@
 */
 #define LCD_INFO_SCREEN_STYLE 0
 /**
 * SD CARD
 *
 * SD Card support is disabled by default. If your controller has an SD slot,
 * you must uncomment the following option or it won't work.
 */
 //#define SDSUPPORT
 /**
 * SD CARD: ENABLE CRC
 *
 * Use CRC checks and retries on the SD communication.
 */
 //#define SD_CHECK_AND_RETRY
 /**
 * LCD Menu Items
 *
@@ -2785,7 +2860,7 @@
 //
 // Original RADDS LCD Display+Encoder+SDCardReader
-// https://web.archive.org/web/20200719145306/http://doku.radds.org/dokumentation/lcd-display/
+// https://web.archive.org/web/20200719145306/doku.radds.org/dokumentation/lcd-display/
 //
 //#define RADDS_DISPLAY
@@ -2824,13 +2899,15 @@
 //
 //#define MAKEBOARD_MINI_2_LINE_DISPLAY_1602
-//
+/**
-// ANET and Tronxy 20x4 Controller
+ * ANET and Tronxy 20x4 Controller
-//
+ * LCD2004 display with 5 analog buttons.
-//#define ZONESTAR_LCD            // Requires ADC_KEYPAD_PIN to be assigned to an analog pin.
+ *
-                                  // This LCD is known to be susceptible to electrical interference
+ * NOTE: Requires ADC_KEYPAD_PIN to be assigned to an analog pin.
-                                  // which scrambles the display.  Pressing any button clears it up.
+ * This LCD is known to be susceptible to electrical interference which
-                                  // This is a LCD2004 display with 5 analog buttons.
+ * scrambles the display. Press any button to clear it up.
 */
 //#define ZONESTAR_LCD
 //
 // Generic 16x2, 16x4, 20x2, or 20x4 character-based LCD.
@@ -2851,7 +2928,7 @@
 //
 // Elefu RA Board Control Panel
-// https://web.archive.org/web/20140823033947/http://www.elefu.com/index.php?route=product/product&product_id=53
+// https://web.archive.org/web/20140823033947/www.elefu.com/index.php?route=product/product&product_id=53
 //
 //#define RA_CONTROL_PANEL
@@ -2983,7 +3060,7 @@
 //
 // Cartesio UI
-// https://web.archive.org/web/20180605050442/http://mauk.cc/webshop/cartesio-shop/electronics/user-interface
+// https://web.archive.org/web/20180605050442/mauk.cc/webshop/cartesio-shop/electronics/user-interface
 //
 //#define CARTESIO_UI
@@ -3107,14 +3184,14 @@
 //
 // Tiny, but very sharp OLED display
 //
-//#define MKS_12864OLED          // Uses the SH1106 controller (default)
+//#define MKS_12864OLED          // Uses the SH1106 controller
 //#define MKS_12864OLED_SSD1306  // Uses the SSD1306 controller
 //
 // Zonestar OLED 128×64 Full Graphics Controller
 //
 //#define ZONESTAR_12864LCD           // Graphical (DOGM) with ST7920 controller
-//#define ZONESTAR_12864OLED          // 1.3" OLED with SH1106 controller (default)
+//#define ZONESTAR_12864OLED          // 1.3" OLED with SH1106 controller
 //#define ZONESTAR_12864OLED_SSD1306  // 0.96" OLED with SSD1306 controller
 //
@@ -3220,6 +3297,11 @@
 //
 //#define ANYCUBIC_LCD_VYPER
 //
 // Sovol SV-06 Resistive Touch Screen
 //
 //#define SOVOL_SV06_RTS
 //
 // 320x240 Nextion 2.8" serial TFT Resistive Touch Screen NX3224T028
 //
@@ -3358,7 +3440,7 @@
 #if ENABLED(TFT_COLOR_UI)
  /**
-   * TFT Font for Color_UI. Choose one of the following:
+   * TFT Font for Color UI. Choose one of the following:
   *
   * NOTOSANS  - Default font with anti-aliasing. Supports Latin Extended and non-Latin characters.
   * UNIFONT   - Lightweight font, no anti-aliasing. Supports Latin Extended and non-Latin characters.
@@ -3367,7 +3449,7 @@
  #define TFT_FONT  NOTOSANS
  /**
-   * TFT Theme for Color_UI. Choose one of the following or add a new one to 'Marlin/src/lcd/tft/themes' directory
+   * TFT Theme for Color UI. Choose one of the following or add a new one to 'Marlin/src/lcd/tft/themes' directory
   *
   * BLUE_MARLIN  - Default theme with 'midnight blue' background
   * BLACK_MARLIN - Theme with 'black' background
@@ -3391,6 +3473,8 @@
 *   TFT_ROTATE_180, TFT_ROTATE_180_MIRROR_X, TFT_ROTATE_180_MIRROR_Y,
 *   TFT_ROTATE_270, TFT_ROTATE_270_MIRROR_X, TFT_ROTATE_270_MIRROR_Y,
 *   TFT_MIRROR_X, TFT_MIRROR_Y, TFT_NO_ROTATION
 *
 * :{ 'TFT_NO_ROTATION':'None', 'TFT_ROTATE_90':'90°', 'TFT_ROTATE_90_MIRROR_X':'90° (Mirror X)', 'TFT_ROTATE_90_MIRROR_Y':'90° (Mirror Y)', 'TFT_ROTATE_180':'180°', 'TFT_ROTATE_180_MIRROR_X':'180° (Mirror X)', 'TFT_ROTATE_180_MIRROR_Y':'180° (Mirror Y)', 'TFT_ROTATE_270':'270°', 'TFT_ROTATE_270_MIRROR_X':'270° (Mirror X)', 'TFT_ROTATE_270_MIRROR_Y':'270° (Mirror Y)', 'TFT_MIRROR_X':'Mirror X', 'TFT_MIRROR_Y':'Mirror Y' }
 */
 //#define TFT_ROTATION TFT_NO_ROTATION
@@ -3415,7 +3499,9 @@
  #define BUTTON_DELAY_EDIT      50 // (ms) Button repeat delay for edit screens
  #define BUTTON_DELAY_MENU     250 // (ms) Button repeat delay for menus
-  //#define DISABLE_ENCODER         // Disable the click encoder, if any
+  #if ANY(TFT_CLASSIC_UI, TFT_COLOR_UI)
    //#define NO_BACK_MENU_ITEM     // Don't display a top menu item to go back to the parent menu
  #endif
  #define TOUCH_SCREEN_CALIBRATION
@@ -3439,7 +3525,9 @@
 // https://reprapworld.com/products/electronics/ramps/keypad_v1_0_fully_assembled/
 //
 //#define REPRAPWORLD_KEYPAD
-//#define REPRAPWORLD_KEYPAD_MOVE_STEP 10.0 // (mm) Distance to move per key-press
+#if ENABLED(REPRAPWORLD_KEYPAD)
  //#define REPRAPWORLD_KEYPAD_MOVE_STEP 10.0 // (mm) Distance to move per key-press
 #endif
 //
 // EasyThreeD ET-4000+ with button input and status LED
@@ -3456,22 +3544,26 @@
 // :[1,2,3,4,5,6,7,8]
 //#define NUM_M106_FANS 1
-// Use software PWM to drive the fan, as for the heaters. This uses a very low frequency
+/**
-// which is not as annoying as with the hardware PWM. On the other hand, if this frequency
+ * Use software PWM to drive the fan, as for the heaters. This uses a very low frequency
-// is too low, you should also increment SOFT_PWM_SCALE.
+ * which is not as annoying as with the hardware PWM. On the other hand, if this frequency
 * is too low, you should also increment SOFT_PWM_SCALE.
 */
 //#define FAN_SOFT_PWM
-// Incrementing this by 1 will double the software PWM frequency,
+/**
-// affecting heaters, and the fan if FAN_SOFT_PWM is enabled.
+ * Incrementing this by 1 will double the software PWM frequency, affecting heaters, and
-// However, control resolution will be halved for each increment;
+ * the fan if FAN_SOFT_PWM is enabled. However, control resolution will be halved for each
-// at zero value, there are 128 effective control positions.
+ * increment; at zero value, there are 128 effective control positions.
-// :[0,1,2,3,4,5,6,7]
+ * :[0,1,2,3,4,5,6,7]
 */
 #define SOFT_PWM_SCALE 0
-// If SOFT_PWM_SCALE is set to a value higher than 0, dithering can
+/**
-// be used to mitigate the associated resolution loss. If enabled,
+ * If SOFT_PWM_SCALE is set to a value higher than 0, dithering can be used to mitigate the
-// some of the PWM cycles are stretched so on average the desired
+ * associated resolution loss. If enabled, some of the PWM cycles are stretched so on average
-// duty cycle is attained.
+ * the desired duty cycle is attained.
 */
 //#define SOFT_PWM_DITHER
 // @section extras
@@ -3481,9 +3573,11 @@
 // @section lights
-// Temperature status LEDs that display the hotend and bed temperature.
+/**
-// If all hotends, bed temperature, and target temperature are under 54C
+ * Temperature status LEDs that display the hotend and bed temperature.
-// then the BLUE led is on. Otherwise the RED led is on. (1C hysteresis)
+ * If all hotends, bed temperature, and target temperature are under 54C
 * the BLUE led is on. Otherwise the RED led is on. (1C hysteresis)
 */
 //#define TEMP_STAT_LEDS
 // Support for BlinkM/CyzRgb
@@ -47,8 +47,9 @@
 *  2 = config.ini - File format for PlatformIO preprocessing.
 *  3 = schema.json - The entire configuration schema. (13 = pattern groups)
 *  4 = schema.yml - The entire configuration schema.
 *  5 = Config.h - Minimal configuration by popular demand.
 */
-//#define CONFIG_EXPORT 2 // :[1:'JSON', 2:'config.ini', 3:'schema.json', 4:'schema.yml']
+//#define CONFIG_EXPORT 105 // :[1:'JSON', 2:'config.ini', 3:'schema.json', 4:'schema.yml', 5:'Config.h']
 //===========================================================================
 //============================= Thermal Settings ============================
@@ -173,9 +174,10 @@
 * Thermocouple Options — for MAX6675 (-2), MAX31855 (-3), and MAX31865 (-5).
 */
 //#define TEMP_SENSOR_FORCE_HW_SPI                // Ignore SCK/MOSI/MISO pins; use CS and the default SPI bus.
-//#define MAX31865_SENSOR_WIRES_0 2               // (2-4) Number of wires for the probe connected to a MAX31865 board.
+//#define MAX31865_SENSOR_WIRES_0   2             // (2-4) Number of wires for the probe connected to a MAX31865 board.
-//#define MAX31865_SENSOR_WIRES_1 2
+//#define MAX31865_SENSOR_WIRES_1   2
-//#define MAX31865_SENSOR_WIRES_2 2
+//#define MAX31865_SENSOR_WIRES_2   2
 //#define MAX31865_SENSOR_WIRES_BED 2
 //#define MAX31865_50HZ_FILTER                    // Use a 50Hz filter instead of the default 60Hz.
 //#define MAX31865_USE_READ_ERROR_DETECTION       // Treat value spikes (20°C delta in under 1s) as read errors.
@@ -187,6 +189,7 @@
 //#define MAX31865_WIRE_OHMS_0              0.95f // For 2-wire, set the wire resistances for more accurate readings.
 //#define MAX31865_WIRE_OHMS_1              0.0f
 //#define MAX31865_WIRE_OHMS_2              0.0f
 //#define MAX31865_WIRE_OHMS_BED            0.0f
 /**
 * Hephestos 2 24V heated bed upgrade kit.
@@ -202,7 +205,7 @@
 //
 #if DISABLED(PIDTEMPBED)
  #define BED_CHECK_INTERVAL 5000   // (ms) Interval between checks in bang-bang control
-  #if ENABLED(BED_LIMIT_SWITCHING)
+  #if ANY(BED_LIMIT_SWITCHING, PELTIER_BED)
    #define BED_HYSTERESIS 2        // (°C) Only set the relevant heater state when ABS(T-target) > BED_HYSTERESIS
  #endif
 #endif
@@ -210,18 +213,19 @@
 //
 // Heated Chamber options
 //
 #if DISABLED(PIDTEMPCHAMBER)
  #define CHAMBER_CHECK_INTERVAL 5000   // (ms) Interval between checks in bang-bang control
  #if ENABLED(CHAMBER_LIMIT_SWITCHING)
    #define CHAMBER_HYSTERESIS 2        // (°C) Only set the relevant heater state when ABS(T-target) > CHAMBER_HYSTERESIS
  #endif
 #endif
 #if TEMP_SENSOR_CHAMBER
  //#define HEATER_CHAMBER_PIN      P2_04   // Required heater on/off pin (example: SKR 1.4 Turbo HE1 plug)
  //#define HEATER_CHAMBER_INVERTING false
  //#define FAN1_PIN                   -1   // Remove the fan signal on pin P2_04 (example: SKR 1.4 Turbo HE1 plug)
  #if DISABLED(PIDTEMPCHAMBER)
    #define CHAMBER_CHECK_INTERVAL 5000   // (ms) Interval between checks in bang-bang control
    #if ENABLED(CHAMBER_LIMIT_SWITCHING)
      #define CHAMBER_HYSTERESIS 2        // (°C) Only set the relevant heater state when ABS(T-target) > CHAMBER_HYSTERESIS
    #endif
  #endif
  //#define CHAMBER_FAN               // Enable a fan on the chamber
  #if ENABLED(CHAMBER_FAN)
    //#define CHAMBER_FAN_INDEX   2   // Index of a fan to repurpose as the chamber fan. (Default: first unused fan)
@@ -303,9 +307,9 @@
 * If you get false positives for "Thermal Runaway", increase
 * THERMAL_PROTECTION_HYSTERESIS and/or THERMAL_PROTECTION_PERIOD
 */
-#if ENABLED(THERMAL_PROTECTION_HOTENDS)
+#if ALL(HAS_HOTEND, THERMAL_PROTECTION_HOTENDS)
-  #define THERMAL_PROTECTION_PERIOD 40        // (seconds)
+  #define THERMAL_PROTECTION_PERIOD        40 // (seconds)
-  #define THERMAL_PROTECTION_HYSTERESIS 4     // (°C)
+  #define THERMAL_PROTECTION_HYSTERESIS     4 // (°C)
  //#define ADAPTIVE_FAN_SLOWING              // Slow down the part-cooling fan if the temperature drops
  #if ENABLED(ADAPTIVE_FAN_SLOWING)
@@ -334,7 +338,7 @@
 /**
 * Thermal Protection parameters for the bed are just as above for hotends.
 */
-#if ENABLED(THERMAL_PROTECTION_BED)
+#if TEMP_SENSOR_BED && ENABLED(THERMAL_PROTECTION_BED)
  #define THERMAL_PROTECTION_BED_PERIOD        20 // (seconds)
  #define THERMAL_PROTECTION_BED_HYSTERESIS     2 // (°C)
@@ -348,7 +352,7 @@
 /**
 * Thermal Protection parameters for the heated chamber.
 */
-#if ENABLED(THERMAL_PROTECTION_CHAMBER)
+#if TEMP_SENSOR_CHAMBER && ENABLED(THERMAL_PROTECTION_CHAMBER)
  #define THERMAL_PROTECTION_CHAMBER_PERIOD    20 // (seconds)
  #define THERMAL_PROTECTION_CHAMBER_HYSTERESIS 2 // (°C)
@@ -362,7 +366,7 @@
 /**
 * Thermal Protection parameters for the laser cooler.
 */
-#if ENABLED(THERMAL_PROTECTION_COOLER)
+#if TEMP_SENSOR_COOLER && ENABLED(THERMAL_PROTECTION_COOLER)
  #define THERMAL_PROTECTION_COOLER_PERIOD     10 // (seconds)
  #define THERMAL_PROTECTION_COOLER_HYSTERESIS  3 // (°C)
@@ -590,6 +594,8 @@
  // Use TEMP_SENSOR_SOC as a trigger for enabling the controller fan
  //#define CONTROLLER_FAN_MIN_SOC_TEMP 40  // (°C) Turn on the fan if the SoC reaches this temperature
  #define CONTROLLER_FAN_BED_HEATING        // Turn on the fan when heating the bed
  //#define CONTROLLER_FAN_EDITABLE         // Enable M710 configurable settings
  #if ENABLED(CONTROLLER_FAN_EDITABLE)
    #define CONTROLLER_FAN_MENU             // Enable the Controller Fan submenu
@@ -604,6 +610,8 @@
 */
 //#define FAN_KICKSTART_TIME  100  // (ms)
 //#define FAN_KICKSTART_POWER 180  // 64-255
 //#define FAN_KICKSTART_LINEAR     // Set kickstart time linearly based on the speed, e.g., for 20% (51) it will be FAN_KICKSTART_TIME * 0.2.
                                   // Useful for quick speed up to low speed. Kickstart power must be set to 255.
 // Some coolers may require a non-zero "off" state.
 //#define FAN_OFF_PWM  1
@@ -1014,7 +1022,7 @@
 #endif // BLTOUCH
-// @section calibration
+// @section calibrate
 /**
 * Z Steppers Auto-Alignment
@@ -1079,9 +1087,11 @@
  #define HOME_AFTER_G34
 #endif
-//
+/**
-// Add the G35 command to read bed corners to help adjust screws. Requires a bed probe.
+ * Assisted Tramming
-//
+ *
 * Add the G35 command to measure bed corners and help adjust screws. Requires a bed probe.
 */
 //#define ASSISTED_TRAMMING
 #if ENABLED(ASSISTED_TRAMMING)
@@ -1102,29 +1112,35 @@
  //#define ASSISTED_TRAMMING_WAIT_POSITION { X_CENTER, Y_CENTER, 30 } // Move the nozzle out of the way for adjustment
  /**
-   * Screw thread:
+   * Screw Thread. Use one of the following defines:
-   *   M3: 30 = Clockwise, 31 = Counter-Clockwise
+   *
-   *   M4: 40 = Clockwise, 41 = Counter-Clockwise
+   *   M3_CW = M3 Clockwise, M3_CCW = M3 Counter-Clockwise
-   *   M5: 50 = Clockwise, 51 = Counter-Clockwise
+   *   M4_CW = M4 Clockwise, M4_CCW = M4 Counter-Clockwise
   *   M5_CW = M5 Clockwise, M5_CCW = M5 Counter-Clockwise
   *
   * :{'M3_CW':'M3 Clockwise','M3_CCW':'M3 Counter-Clockwise','M4_CW':'M4 Clockwise','M4_CCW':'M4 Counter-Clockwise','M5_CW':'M5 Clockwise','M5_CCW':'M5 Counter-Clockwise'}
   */
-  #define TRAMMING_SCREW_THREAD 30
+  #define TRAMMING_SCREW_THREAD M3_CW
 #endif
 // @section motion control
 /**
- * Fixed-time-based Motion Control -- EXPERIMENTAL
+ * Fixed-time-based Motion Control -- BETA FEATURE
 * Enable/disable and set parameters with G-code M493.
 * See ft_types.h for named values used by FTM options.
 */
 //#define FT_MOTION
 #if ENABLED(FT_MOTION)
-  #define FTM_DEFAULT_MODE        ftMotionMode_DISABLED // Default mode of fixed time control. (Enums in ft_types.h)
+  //#define FTM_IS_DEFAULT_MOTION                 // Use FT Motion as the factory default?
-  #define FTM_DEFAULT_DYNFREQ_MODE dynFreqMode_DISABLED // Default mode of dynamic frequency calculation. (Enums in ft_types.h)
+  #define FTM_DEFAULT_DYNFREQ_MODE dynFreqMode_DISABLED // Default mode of dynamic frequency calculation. (DISABLED, Z_BASED, MASS_BASED)
-  #define FTM_SHAPING_DEFAULT_X_FREQ   37.0f      // (Hz) Default peak frequency used by input shapers
+  #define FTM_DEFAULT_SHAPER_X      ftMotionShaper_NONE // Default shaper mode on X axis (NONE, ZV, ZVD, ZVDD, ZVDDD, EI, 2HEI, 3HEI, MZV)
-  #define FTM_SHAPING_DEFAULT_Y_FREQ   37.0f      // (Hz) Default peak frequency used by input shapers
+  #define FTM_DEFAULT_SHAPER_Y      ftMotionShaper_NONE // Default shaper mode on Y axis
  #define FTM_SHAPING_DEFAULT_FREQ_X   37.0f      // (Hz) Default peak frequency used by input shapers
  #define FTM_SHAPING_DEFAULT_FREQ_Y   37.0f      // (Hz) Default peak frequency used by input shapers
  #define FTM_LINEAR_ADV_DEFAULT_ENA   false      // Default linear advance enable (true) or disable (false)
-  #define FTM_LINEAR_ADV_DEFAULT_K      0.0f      // Default linear advance gain
+  #define FTM_LINEAR_ADV_DEFAULT_K      0.0f      // Default linear advance gain. (Acceleration-based scaling factor.)
  #define FTM_SHAPING_ZETA_X            0.1f      // Zeta used by input shapers for X axis
  #define FTM_SHAPING_ZETA_Y            0.1f      // Zeta used by input shapers for Y axis
@@ -1147,18 +1163,13 @@
  #define FTM_FS                     1000         // (Hz) Frequency for trajectory generation. (Reciprocal of FTM_TS)
  #define FTM_TS                        0.001f    // (s) Time step for trajectory generation. (Reciprocal of FTM_FS)
  // These values may be configured to adjust the duration of loop().
  #define FTM_STEPS_PER_LOOP           60         // Number of stepper commands to generate each loop()
  #define FTM_POINTS_PER_LOOP         100         // Number of trajectory points to generate each loop()
  #if DISABLED(COREXY)
    #define FTM_STEPPER_FS          20000         // (Hz) Frequency for stepper I/O update
    // Use this to adjust the time required to consume the command buffer.
    // Try increasing this value if stepper motion is choppy.
    #define FTM_STEPPERCMD_BUFF_SIZE 3000         // Size of the stepper command buffers
-                                                  // (FTM_STEPS_PER_LOOP * FTM_POINTS_PER_LOOP) is a good start
+
                                                  // If you run out of memory, fall back to 3000 and increase progressively
  #else
    // CoreXY motion needs a larger buffer size. These values are based on our testing.
    #define FTM_STEPPER_FS          30000
@@ -1180,7 +1191,7 @@
 #endif
 /**
- * Input Shaping -- EXPERIMENTAL
+ * Input Shaping
 *
 * Zero Vibration (ZV) Input Shaping for X and/or Y movements.
 *
@@ -1252,8 +1263,8 @@
 #define DISABLE_IDLE_E    // Shut down all idle extruders
 // Default Minimum Feedrates for printing and travel moves
-#define DEFAULT_MINIMUMFEEDRATE       0.0     // (mm/s. °/s for rotational-only moves) Minimum feedrate. Set with M205 S.
+#define DEFAULT_MINIMUMFEEDRATE       0.0     // (mm/s) Minimum feedrate. Set with M205 S.
-#define DEFAULT_MINTRAVELFEEDRATE     0.0     // (mm/s. °/s for rotational-only moves) Minimum travel feedrate. Set with M205 T.
+#define DEFAULT_MINTRAVELFEEDRATE     0.0     // (mm/s) Minimum travel feedrate. Set with M205 T.
 // Minimum time that a segment needs to take as the buffer gets emptied
 #define DEFAULT_MINSEGMENTTIME        20000   // (µs) Set with M205 B.
@@ -1331,8 +1342,6 @@
  //#define CALIBRATION_SCRIPT_PRE  "M117 Starting Auto-Calibration\nT0\nG28\nG12\nM117 Calibrating..."
  //#define CALIBRATION_SCRIPT_POST "M500\nM117 Calibration data saved"
  #define CALIBRATION_MEASUREMENT_RESOLUTION     0.01 // mm
  #define CALIBRATION_FEEDRATE_SLOW             60    // mm/min
  #define CALIBRATION_FEEDRATE_FAST           1200    // mm/min
  #define CALIBRATION_FEEDRATE_TRAVEL         3000    // mm/min
@@ -1410,24 +1419,24 @@
 #define MICROSTEP_MODES { 16, 16, 16, 16, 16, 16 } // [1,2,4,8,16]
 /**
- *  @section  stepper motor current
+ * @section stepper motor current
 *
- *  Some boards have a means of setting the stepper motor current via firmware.
+ * Some boards have a means of setting the stepper motor current via firmware.
 *
- *  The power on motor currents are set by:
+ * The power on motor currents are set by:
- *    PWM_MOTOR_CURRENT - used by MINIRAMBO & ULTIMAIN_2
+ *   PWM_MOTOR_CURRENT - used by MINIRAMBO & ULTIMAIN_2
- *                         known compatible chips: A4982
+ *                        known compatible chips: A4982
- *    DIGIPOT_MOTOR_CURRENT - used by BQ_ZUM_MEGA_3D, RAMBO & SCOOVO_X9H
+ *   DIGIPOT_MOTOR_CURRENT - used by BQ_ZUM_MEGA_3D, RAMBO & SCOOVO_X9H
- *                         known compatible chips: AD5206
+ *                        known compatible chips: AD5206
- *    DAC_MOTOR_CURRENT_DEFAULT - used by PRINTRBOARD_REVF & RIGIDBOARD_V2
+ *   DAC_MOTOR_CURRENT_DEFAULT - used by PRINTRBOARD_REVF & RIGIDBOARD_V2
- *                         known compatible chips: MCP4728
+ *                        known compatible chips: MCP4728
- *    DIGIPOT_I2C_MOTOR_CURRENTS - used by 5DPRINT, AZTEEG_X3_PRO, AZTEEG_X5_MINI_WIFI, MIGHTYBOARD_REVE
+ *   DIGIPOT_I2C_MOTOR_CURRENTS - used by 5DPRINT, AZTEEG_X3_PRO, AZTEEG_X5_MINI_WIFI, MIGHTYBOARD_REVE
- *                         known compatible chips: MCP4451, MCP4018
+ *                        known compatible chips: MCP4451, MCP4018
 *
- *  Motor currents can also be set by M907 - M910 and by the LCD.
+ * Motor currents can also be set by M907 - M910 and by the LCD.
- *    M907 - applies to all.
+ *   M907 - applies to all.
- *    M908 - BQ_ZUM_MEGA_3D, RAMBO, PRINTRBOARD_REVF, RIGIDBOARD_V2 & SCOOVO_X9H
+ *   M908 - BQ_ZUM_MEGA_3D, RAMBO, PRINTRBOARD_REVF, RIGIDBOARD_V2 & SCOOVO_X9H
- *    M909, M910 & LCD - only PRINTRBOARD_REVF & RIGIDBOARD_V2
+ *   M909, M910 & LCD - only PRINTRBOARD_REVF & RIGIDBOARD_V2
 */
 //#define PWM_MOTOR_CURRENT { 1300, 1300, 1250 }          // Values in milliamps
 //#define DIGIPOT_MOTOR_CURRENT { 135,135,135,135,135 }   // Values 0-255 (RAMBO 135 = ~0.75A, 185 = ~1A)
@@ -1491,8 +1500,17 @@
  #define FEEDRATE_CHANGE_BEEP_FREQUENCY 440
 #endif
 /**
 * Probe Offset Wizard
 * Add a Probe Z Offset calibration option to the LCD menu.
 * Use this helper to get a perfect 'M851 Z' probe offset.
 * When launched this powerful wizard:
 *  - Measures the bed height at the configured position with the probe.
 *  - Moves the nozzle to the same position for a "paper" measurement.
 *  - The difference is used to set the probe Z offset.
 */
 #if HAS_BED_PROBE && ANY(HAS_MARLINUI_MENU, HAS_TFT_LVGL_UI)
-  //#define PROBE_OFFSET_WIZARD       // Add a Probe Z Offset calibration option to the LCD menu
+  //#define PROBE_OFFSET_WIZARD
  #if ENABLED(PROBE_OFFSET_WIZARD)
    /**
     * Enable to init the Probe Z-Offset when starting the Wizard.
@@ -1509,6 +1527,10 @@
 #if HAS_MARLINUI_MENU
  #if HAS_BED_PROBE
    // Show Deploy / Stow Probe options in the Motion menu.
    #define PROBE_DEPLOY_STOW_MENU
    // Add calibration in the Probe Offsets menu to compensate for X-axis twist.
    //#define X_AXIS_TWIST_COMPENSATION
    #if ENABLED(X_AXIS_TWIST_COMPENSATION)
@@ -1523,14 +1545,13 @@
      #define XATC_Z_OFFSETS { 0, 0, 0 }    // Z offsets for X axis sample points
    #endif
    // Show Deploy / Stow Probe options in the Motion menu.
    #define PROBE_DEPLOY_STOW_MENU
  #endif
  // Include a page of printer information in the LCD Main Menu
  //#define LCD_INFO_MENU
  #if ENABLED(LCD_INFO_MENU)
    //#define LCD_PRINTER_INFO_IS_BOOTSCREEN // Show bootscreen(s) instead of Printer Info pages
    //#define BUILD_INFO_MENU_ITEM           // Add a menu item to display the build date and time
  #endif
  /**
@@ -1555,6 +1576,9 @@
  // BACK menu items keep the highlight at the top
  //#define TURBO_BACK_MENU_ITEM
  // BACK menu items show "Back" instead of the previous menu name
  //#define GENERIC_BACK_MENU_ITEM
  // Insert a menu for preheating at the top level to allow for quick access
  //#define PREHEAT_SHORTCUT_MENU_ITEM
@@ -1595,6 +1619,10 @@
  //#define SOUND_MENU_ITEM   // Add a mute option to the LCD menu
  #define SOUND_ON_DEFAULT    // Buzzer/speaker default enabled state
  #if ENABLED(U8GLIB_SSD1309)
    //#define LCD_DOUBLE_BUFFER           // Optimize display updates. Costs ~1K of SRAM.
  #endif
  #if HAS_WIRED_LCD
    //#define DOUBLE_LCD_FRAMERATE        // Not recommended for slow boards.
  #endif
@@ -1846,7 +1874,7 @@
   *
   *    SCLK, MOSI, MISO --> SCLK, MOSI, MISO
   *    INT              --> SD_DETECT_PIN [1]
-   *    SS               --> SDSS
+   *    SS               --> SD_SS_PIN
   *
   * [1] On AVR an interrupt-capable pin is best for UHS3 compatibility.
   */
@@ -1873,7 +1901,7 @@
    //#define USE_OTG_USB_HOST
    #if DISABLED(USE_OTG_USB_HOST)
-      #define USB_CS_PIN    SDSS
+      #define USB_CS_PIN    SD_SS_PIN
      #define USB_INTR_PIN  SD_DETECT_PIN
    #endif
  #endif
@@ -1984,7 +2012,7 @@
  #if IS_U8GLIB_ST7920
    // Enable this option and reduce the value to optimize screen updates.
    // The normal delay is 10µs. Use the lowest value that still gives a reliable display.
-    //#define DOGM_SPI_DELAY_US 5
+    //#define DOGM_SPI_DELAY_US      5  // (µs) Delay after each SPI transfer
    //#define LIGHTWEIGHT_UI
    #if ENABLED(LIGHTWEIGHT_UI)
@@ -2014,17 +2042,17 @@
  //#define STATUS_HEAT_PERCENT       // Show heating in a progress bar
  //#define STATUS_HEAT_POWER         // Show heater output power as a vertical bar
  // Frivolous Game Options
  //#define MARLIN_BRICKOUT
  //#define MARLIN_INVADERS
  //#define MARLIN_SNAKE
  //#define GAMES_EASTER_EGG          // Add extra blank lines above the "Games" sub-menu
 #endif // HAS_MARLINUI_U8GLIB
 #if HAS_MARLINUI_U8GLIB || IS_DWIN_MARLINUI
  #define MENU_HOLLOW_FRAME           // Enable to save many cycles by drawing a hollow frame on Menu Screens
  //#define OVERLAY_GFX_REVERSE       // Swap the CW/CCW indicators in the graphics overlay
  // Frivolous Game Options
  //#define MARLIN_BRICKOUT
  //#define MARLIN_INVADERS
  //#define MARLIN_SNAKE
  //#define GAMES_EASTER_EGG          // Add extra blank lines above the "Games" sub-menu
 #endif
 //
@@ -2203,7 +2231,7 @@
  // Developer menu (accessed by touching "About Printer" copyright text)
  //#define TOUCH_UI_DEVELOPER_MENU
-#endif
+#endif // TOUCH_UI_FTDI_EVE
 //
 // Classic UI Options
@@ -2237,7 +2265,7 @@
 // ADC Button Debounce
 //
 #if HAS_ADC_BUTTONS
-  #define ADC_BUTTON_DEBOUNCE_DELAY 16  // Increase if buttons bounce or repeat too fast
+  #define ADC_BUTTON_DEBOUNCE_DELAY 16  // (count) Increase if buttons bounce or repeat too fast
 #endif
 // @section safety
@@ -2278,7 +2306,7 @@
  //#define DOUBLECLICK_FOR_Z_BABYSTEPPING  // Double-click on the Status Screen for Z Babystepping.
  #if ENABLED(DOUBLECLICK_FOR_Z_BABYSTEPPING)
-    #define DOUBLECLICK_MAX_INTERVAL 1250   // Maximum interval between clicks, in milliseconds.
+    #define DOUBLECLICK_MAX_INTERVAL 1250   // (ms) Maximum interval between clicks.
                                            // Note: Extra time may be added to mitigate controller latency.
    //#define MOVE_Z_WHEN_IDLE              // Jump to the move Z menu on double-click when printer is idle.
    #if ENABLED(MOVE_Z_WHEN_IDLE)
@@ -2329,6 +2357,7 @@
 *
 * Control extrusion rate based on instantaneous extruder velocity. Can be used to correct for
 * underextrusion at high extruder speeds that are otherwise well-behaved (i.e., not skipping).
 * For better results also enable ADAPTIVE_STEP_SMOOTHING.
 */
 //#define NONLINEAR_EXTRUSION
@@ -2556,27 +2585,28 @@
 //#define MINIMUM_STEPPER_PRE_DIR_DELAY 650
 /**
- * Minimum stepper driver pulse width (in µs)
+ * Minimum stepper driver pulse width (in ns)
- *   0 : Smallest possible width the MCU can produce, compatible with TMC2xxx drivers
+ * If undefined, these defaults (from Conditionals-4-adv.h) apply:
- *   0 : Minimum 500ns for LV8729, adjusted in stepper.h
+ *     100 : Minimum for TMC2xxx stepper drivers
- *   1 : Minimum for A4988 and A5984 stepper drivers
+ *     500 : Minimum for LV8729
- *   2 : Minimum for DRV8825 stepper drivers
+ *    1000 : Minimum for A4988 and A5984 stepper drivers
- *   3 : Minimum for TB6600 stepper drivers
+ *    2000 : Minimum for DRV8825 stepper drivers
- *  30 : Minimum for TB6560 stepper drivers
+ *    3000 : Minimum for TB6600 stepper drivers
 *   30000 : Minimum for TB6560 stepper drivers
 *
 * Override the default value based on the driver type set in Configuration.h.
 */
-//#define MINIMUM_STEPPER_PULSE 2
+//#define MINIMUM_STEPPER_PULSE_NS 2000
 /**
 * Maximum stepping rate (in Hz) the stepper driver allows
- *  If undefined, defaults to 1MHz / (2 * MINIMUM_STEPPER_PULSE)
+ * If undefined, these defaults (from Conditionals-4-adv.h) apply:
 *  5000000 : Maximum for TMC2xxx stepper drivers
 *  1000000 : Maximum for LV8729 stepper driver
- *  500000  : Maximum for A4988 stepper driver
+ *   500000 : Maximum for A4988 stepper driver
- *  250000  : Maximum for DRV8825 stepper driver
+ *   250000 : Maximum for DRV8825 stepper driver
- *  150000  : Maximum for TB6600 stepper driver
+ *   150000 : Maximum for TB6600 stepper driver
- *   15000  : Maximum for TB6560 stepper driver
+ *    15000 : Maximum for TB6560 stepper driver
 *
 * Override the default value based on the driver type set in Configuration.h.
 */
@@ -2608,19 +2638,23 @@
 #define MAX_CMD_SIZE 96
 #define BUFSIZE 4
-// Transmission to Host Buffer Size
+/**
-// To save 386 bytes of flash (and TX_BUFFER_SIZE+3 bytes of RAM) set to 0.
+ * Host Transmit Buffer Size
-// To buffer a simple "ok" you need 4 bytes.
+ *  - Costs 386 bytes of flash and TX_BUFFER_SIZE+3 bytes of SRAM (if not 0).
-// For ADVANCED_OK (M105) you need 32 bytes.
+ *  - 4 bytes required to buffer a simple "ok".
-// For debug-echo: 128 bytes for the optimal speed.
+ *  - 32 bytes for ADVANCED_OK (M105).
-// Other output doesn't need to be that speedy.
+ *  - 128 bytes for the optimal speed of 'debug-echo:'
-// :[0, 2, 4, 8, 16, 32, 64, 128, 256]
+ *  - Other output doesn't need to be that speedy.
 * :[0, 2, 4, 8, 16, 32, 64, 128, 256]
 */
 #define TX_BUFFER_SIZE 0
-// Host Receive Buffer Size
+/**
-// Without XON/XOFF flow control (see SERIAL_XON_XOFF below) 32 bytes should be enough.
+ * Host Receive Buffer Size
-// To use flow control, set this buffer size to at least 1024 bytes.
+ * Without XON/XOFF flow control (see SERIAL_XON_XOFF below) 32 bytes should be enough.
-// :[0, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048]
+ * To use flow control, set this buffer size to at least 1024 bytes.
 * :[0, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048]
 */
 //#define RX_BUFFER_SIZE 1024
 #if RX_BUFFER_SIZE >= 1024
@@ -2704,7 +2738,7 @@
 /**
 * Set the number of proportional font spaces required to fill up a typical character space.
- * This can help to better align the output of commands like `G29 O` Mesh Output.
+ * This can help to better align the output of commands like 'G29 O' Mesh Output.
 *
 * For clients that use a fixed-width font (like OctoPrint), leave this set to 1.0.
 * Otherwise, adjust according to your client and font.
@@ -2969,7 +3003,7 @@
  #if AXIS_IS_TMC_CONFIG(X)
    #define X_CURRENT       800        // (mA) RMS current. Multiply by 1.414 for peak current.
-    #define X_CURRENT_HOME  X_CURRENT  // (mA) RMS current for sensorless homing
+    #define X_CURRENT_HOME  X_CURRENT  // (mA) RMS current for homing. (Typically lower than *_CURRENT.)
    #define X_MICROSTEPS     16        // 0..256
    #define X_RSENSE          0.11
    #define X_CHAIN_POS      -1        // -1..0: Not chained. 1: MCU MOSI connected. 2: Next in chain, ...
@@ -3179,6 +3213,13 @@
    //#define E7_HOLD_MULTIPLIER 0.5
  #endif
  /**
   * Use the homing current for all probing. (e.g., Current may be reduced to the
   * point where a collision makes the motor skip instead of damaging the bed,
   * though this is unlikely to save delicate probes from being damaged.
   */
  //#define PROBING_USE_CURRENT_HOME
  // @section tmc/spi
  /**
@@ -3443,7 +3484,7 @@
  /**
   * Step on both rising and falling edge signals (as with a square wave).
   */
-  //#define EDGE_STEPPING
+  #define EDGE_STEPPING
  /**
   * Enable M122 debugging command for TMC stepper drivers.
@@ -3525,7 +3566,7 @@
  //#define PHOTOGRAPH_PIN 23
  // Canon Hack Development Kit
-  // https://web.archive.org/web/20200920094805/https://captain-slow.dk/2014/03/09/3d-printing-timelapses/
+  // https://web.archive.org/web/20200920094805/captain-slow.dk/2014/03/09/3d-printing-timelapses/
  //#define CHDK_PIN        4
  // Optional second move with delay to trigger the camera shutter
@@ -3880,7 +3921,7 @@
 /**
 * Extra options for the M114 "Current Position" report
 */
-//#define M114_DETAIL         // Use 'M114` for details to check planner calculations
+//#define M114_DETAIL         // Use 'M114 D' for details to check planner calculations
 //#define M114_REALTIME       // Real current position based on forward kinematics
 //#define M114_LEGACY         // M114 used to synchronize on every call. Enable if needed.
@@ -3927,7 +3968,6 @@
 * Spend 28 bytes of SRAM to optimize the G-code parser
 */
 #define FASTER_GCODE_PARSER
 #if ENABLED(FASTER_GCODE_PARSER)
  //#define GCODE_QUOTED_STRINGS  // Support for quoted string parameters
 #endif
@@ -4378,58 +4418,81 @@
  //#define E_MUX0_PIN 40  // Always Required
  //#define E_MUX1_PIN 42  // Needed for 3 to 8 inputs
  //#define E_MUX2_PIN 44  // Needed for 5 to 8 inputs
 #elif HAS_PRUSA_MMU2
  // Serial port used for communication with MMU2.
  #define MMU2_SERIAL_PORT 2
-  // Use hardware reset for MMU if a pin is defined for it
+#elif HAS_PRUSA_MMU2 || HAS_PRUSA_MMU3
-  //#define MMU2_RST_PIN 23
+  // Common settings for MMU2/MMU2S/MMU3
  // Serial port used for communication with MMU2/MMU2S/MMU3.
  #define MMU_SERIAL_PORT 2
  #define MMU_BAUD 115200
-  // Enable if the MMU2 has 12V stepper motors (MMU2 Firmware 1.0.2 and up)
+  //#define MMU_RST_PIN 23    // Define this pin to use Hardware Reset for MMU2/MMU2S/MMU3
  //#define MMU2_MODE_12V
-  // G-code to execute when MMU2 F.I.N.D.A. probe detects filament runout
+  //#define MMU_MENUS         // Add an LCD menu for MMU2/MMU2S/MMU3
  #define MMU2_FILAMENT_RUNOUT_SCRIPT "M600"
-  // Add an LCD menu for MMU2
+  //#define MMU_DEBUG         // Write debug info to serial output
  //#define MMU2_MENUS
-  // Settings for filament load / unload from the LCD menu.
+  // Options pertaining to MMU2 and MMU2S
-  // This is for Průša MK3-style extruders. Customize for your hardware.
+  #if HAS_PRUSA_MMU2
-  #define MMU2_FILAMENTCHANGE_EJECT_FEED 80.0
+    // Enable if the MMU2 has 12V stepper motors (MMU2 Firmware 1.0.2 and up)
-  #define MMU2_LOAD_TO_NOZZLE_SEQUENCE \
+    //#define MMU2_MODE_12V
    {  7.2, 1145 }, \
    { 14.4,  871 }, \
    { 36.0, 1393 }, \
    { 14.4,  871 }, \
    { 50.0,  198 }
-  #define MMU2_RAMMING_SEQUENCE \
+    // Settings for filament load / unload from the LCD menu.
-    {   1.0, 1000 }, \
+    // This is for Průša MK3-style extruders. Customize for your hardware.
-    {   1.0, 1500 }, \
+    #define MMU2_FILAMENTCHANGE_EJECT_FEED 80.0
-    {   2.0, 2000 }, \
+
-    {   1.5, 3000 }, \
+    // G-code to execute when MMU2 F.I.N.D.A. probe detects filament runout
-    {   2.5, 4000 }, \
+    #define MMU2_FILAMENT_RUNOUT_SCRIPT "M600"
-    { -15.0, 5000 }, \
+
-    { -14.0, 1200 }, \
+    // MMU2 sequences use mm/min. Not compatible with MMU3, which use mm/sec.
-    {  -6.0,  600 }, \
+    #define MMU2_LOAD_TO_NOZZLE_SEQUENCE \
-    {  10.0,  700 }, \
+      {  4.4,  871 }, \
-    { -10.0,  400 }, \
+      { 10.0, 1393 }, \
-    { -50.0, 2000 }
+      {  4.4,  871 }, \
      { 10.0,  198 }
    #define MMU2_RAMMING_SEQUENCE \
      {   1.0, 1000 }, \
      {   1.0, 1500 }, \
      {   2.0, 2000 }, \
      {   1.5, 3000 }, \
      {   2.5, 4000 }, \
      { -15.0, 5000 }, \
      { -14.0, 1200 }, \
      {  -6.0,  600 }, \
      {  10.0,  700 }, \
      { -10.0,  400 }, \
      { -50.0, 2000 }
  #endif // HAS_PRUSA_MMU2
  /**
-   * Using a sensor like the MMU2S
+   * Options pertaining to MMU2S devices
-   * This mode requires a MK3S extruder with a sensor at the extruder idler, like the MMU2S.
+   * Requires the MK3S extruder with a sensor at the extruder idler, like the MMU2S.
   * See https://help.prusa3d.com/guide/3b-mk3s-mk2-5s-extruder-upgrade_41560#42048, step 11
   */
  #if HAS_PRUSA_MMU2S
    #define MMU2_C0_RETRY   5             // Number of retries (total time = timeout*retries)
    /**
     * This is called after the filament runout sensor is triggered to check if
     * the filament has been loaded properly by moving the filament back and
     * forth to see if the filament runout sensor is going to get triggered
     * again, which should not occur if the filament is properly loaded.
     *
     * Thus, the MMU2_CAN_LOAD_SEQUENCE should contain some forward and
     * backward moves. The forward moves should be greater than the backward
     * moves.
     *
     * This is useless if your filament runout sensor is way behind the gears.
     * In that case use {0, MMU2_CAN_LOAD_FEEDRATE}
     *
     * Adjust MMU2_CAN_LOAD_SEQUENCE according to your setup.
     */
    #define MMU2_CAN_LOAD_FEEDRATE 800    // (mm/min)
    #define MMU2_CAN_LOAD_SEQUENCE \
-      {  0.1, MMU2_CAN_LOAD_FEEDRATE }, \
+      {   5.0, MMU2_CAN_LOAD_FEEDRATE }, \
-      {  60.0, MMU2_CAN_LOAD_FEEDRATE }, \
+      {  15.0, MMU2_CAN_LOAD_FEEDRATE }, \
-      { -52.0, MMU2_CAN_LOAD_FEEDRATE }
+      { -10.0, MMU2_CAN_LOAD_FEEDRATE }
    #define MMU2_CAN_LOAD_RETRACT   6.0   // (mm) Keep under the distance between Load Sequence values
    #define MMU2_CAN_LOAD_DEVIATION 0.8   // (mm) Acceptable deviation
@@ -4440,10 +4503,90 @@
    // Continue unloading if sensor detects filament after the initial unload move
    //#define MMU_IR_UNLOAD_MOVE
-  #else
+
  #elif HAS_PRUSA_MMU3
    // MMU3 settings
    #define MMU3_HAS_CUTTER     // Enable cutter related functionality
    #define MMU3_MAX_RETRIES 3  // Number of retries (total time = timeout*retries)
    // As discussed with our PrusaSlicer profile specialist
    // - ToolChange shall not try to push filament into the very tip of the nozzle
    // to have some space for additional G-code to tune the extruded filament length
    // in the profile
    // Beware - this value is used to initialize the MMU logic layer - it will be sent to the MMU upon line up (written into its 8bit register 0x0b)
    // However - in the G-code we can get a request to set the extra load distance at runtime to something else (M708 A0xb Xsomething).
    // The printer intercepts such a call and sets its extra load distance to match the new value as well.
    #define MMU3_FILAMENT_SENSOR_E_POSITION  0   // (mm)
    #define _MMU3_LOAD_DISTANCE_PAST_GEARS   5   // (mm)
    #define MMU3_TOOL_CHANGE_LOAD_LENGTH (MMU3_FILAMENT_SENSOR_E_POSITION + _MMU3_LOAD_DISTANCE_PAST_GEARS) // (mm)
    #define MMU3_LOAD_TO_NOZZLE_FEED_RATE        20.0 // (mm/s)
    #define MMU3_VERIFY_LOAD_TO_NOZZLE_FEED_RATE 50.0 // (mm/s)
    #define _MMU3_VERIFY_LOAD_TO_NOZZLE_TWEAK    -5.0 // (mm) Amount to adjust the length for verifying load-to-nozzle
    // The first thing the MMU does is initialize its axis.
    // Meanwhile the E-motor will unload 20mm of filament in about 1 second.
    #define MMU3_RETRY_UNLOAD_TO_FINDA_LENGTH    80.0 // (mm)
    #define MMU3_RETRY_UNLOAD_TO_FINDA_FEED_RATE 80.0 // (mm/s)
    // After loading a new filament, the printer will extrude this length of filament
    // then retract to the original position. This is used to check if the filament sensor
    // reading flickers or filament is jammed.
    #define _MMU_EXTRUDER_PTFE_LENGTH            42.3 // (mm)
    #define _MMU_EXTRUDER_HEATBREAK_LENGTH       17.7 // (mm)
    #define MMU3_CHECK_FILAMENT_PRESENCE_EXTRUSION_LENGTH (MMU3_FILAMENT_SENSOR_E_POSITION + _MMU_EXTRUDER_PTFE_LENGTH + _MMU_EXTRUDER_HEATBREAK_LENGTH + _MMU3_VERIFY_LOAD_TO_NOZZLE_TWEAK) // (mm)
    /**
-     * MMU1 Extruder Sensor
+     * SpoolJoin Consumes All Filament -- EXPERIMENTAL
     *
     * SpoolJoin normally triggers when FINDA sensor untriggers while printing.
     * This is the default behaviour and it doesn't consume all the filament
     * before triggering a filament change. This leaves some filament in the
     * current slot and before switching to the next slot it is unloaded.
     *
     * Enabling this option will trigger the filament change when both FINDA
     * and Filament Runout Sensor triggers during the print and it allows the
     * filament in the current slot to be completely consumed before doing the
     * filament change. But this can cause problems as a little bit of filament
     * will be left between the extruder gears (thinking that the filament
     * sensor is triggered through the gears) and the end of the PTFE tube and
     * can cause filament load issues.
     */
    //#define MMU3_SPOOL_JOIN_CONSUMES_ALL_FILAMENT
    // MMU3 sequences use mm/sec. Not compatible with MMU2 which use mm/min.
    #define MMU3_LOAD_TO_NOZZLE_SEQUENCE \
      { _MMU_EXTRUDER_PTFE_LENGTH,      MMM_TO_MMS(810) }, /* (13.5 mm/s) Fast load ahead of heatbreak */ \
      { _MMU_EXTRUDER_HEATBREAK_LENGTH, MMM_TO_MMS(198) }  /* ( 3.3 mm/s) Slow load after heatbreak */
    #define MMU3_RAMMING_SEQUENCE \
      { 0.2816,  MMM_TO_MMS(1339.0) }, \
      { 0.3051,  MMM_TO_MMS(1451.0) }, \
      { 0.3453,  MMM_TO_MMS(1642.0) }, \
      { 0.3990,  MMM_TO_MMS(1897.0) }, \
      { 0.4761,  MMM_TO_MMS(2264.0) }, \
      { 0.5767,  MMM_TO_MMS(2742.0) }, \
      { 0.5691,  MMM_TO_MMS(3220.0) }, \
      { 0.1081,  MMM_TO_MMS(3220.0) }, \
      { 0.7644,  MMM_TO_MMS(3635.0) }, \
      { 0.8248,  MMM_TO_MMS(3921.0) }, \
      { 0.8483,  MMM_TO_MMS(4033.0) }, \
      { -15.0,   MMM_TO_MMS(6000.0) }, \
      { -24.5,   MMM_TO_MMS(1200.0) }, \
      {  -7.0,   MMM_TO_MMS( 600.0) }, \
      {  -3.5,   MMM_TO_MMS( 360.0) }, \
      {  20.0,   MMM_TO_MMS( 454.0) }, \
      { -20.0,   MMM_TO_MMS( 303.0) }, \
      { -35.0,   MMM_TO_MMS(2000.0) }
  #else // MMU2 (not MMU2S)
    /**
     * MMU2 Extruder Sensor
     *
     * Support for a Průša (or other) IR Sensor to detect filament near the extruder
     * and make loading more reliable. Suitable for an extruder equipped with a filament
@@ -4453,16 +4596,14 @@
     * move up to the gears. If no filament is detected, the MMU2 can make some more attempts.
     * If all attempts fail, a filament runout will be triggered.
     */
-    //#define MMU_EXTRUDER_SENSOR
+    //#define MMU2_EXTRUDER_SENSOR
-    #if ENABLED(MMU_EXTRUDER_SENSOR)
+    #if ENABLED(MMU2_EXTRUDER_SENSOR)
-      #define MMU_LOADING_ATTEMPTS_NR 5 // max. number of attempts to load filament if first load fail
+      #define MMU2_LOADING_ATTEMPTS_NR 5  // Number of times to try loading filament before failure
    #endif
  #endif
-  //#define MMU2_DEBUG  // Write debug info to serial output
+#endif // HAS_PRUSA_MMU2 || HAS_PRUSA_MMU3
 #endif // HAS_PRUSA_MMU2
 /**
 * Advanced Print Counter settings
@@ -187,6 +187,17 @@ else ifeq ($(HARDWARE_MOTHERBOARD),1033)
 # RAMPS Plus 3DYMY (Power outputs: Spindle, Controller Fan)
 else ifeq ($(HARDWARE_MOTHERBOARD),1034)
 # RAMPS 1.6+ (Power outputs: Hotend, Fan, Bed)
 else ifeq ($(HARDWARE_MOTHERBOARD),1035)
 # RAMPS 1.6+ (Power outputs: Hotend0, Hotend1, Bed)
 else ifeq ($(HARDWARE_MOTHERBOARD),1036)
 # RAMPS 1.6+ (Power outputs: Hotend, Fan0, Fan1)
 else ifeq ($(HARDWARE_MOTHERBOARD),1037)
 # RAMPS 1.6+ (Power outputs: Hotend0, Hotend1, Fan)
 else ifeq ($(HARDWARE_MOTHERBOARD),1038)
 # RAMPS 1.6+ (Power outputs: Spindle, Controller Fan)
 else ifeq ($(HARDWARE_MOTHERBOARD),1039)
 #
 # RAMPS Derivatives - ATmega1280, ATmega2560
 #
@@ -221,108 +232,113 @@ else ifeq ($(HARDWARE_MOTHERBOARD),1112)
 else ifeq ($(HARDWARE_MOTHERBOARD),1113)
 # BigTreeTech or BIQU KFB2.0
 else ifeq ($(HARDWARE_MOTHERBOARD),1114)
-# zrib V2.0 (Chinese RAMPS replica)
+# Zonestar zrib V2.0 (Chinese RAMPS replica)
 else ifeq ($(HARDWARE_MOTHERBOARD),1115)
-# zrib V5.2 (Chinese RAMPS replica)
+# Zonestar zrib V5.2 (Chinese RAMPS replica)
 else ifeq ($(HARDWARE_MOTHERBOARD),1116)
-# Felix 2.0+ Electronics Board (RAMPS like)
+# Zonestar zrib V5.3 (Chinese RAMPS replica)
 else ifeq ($(HARDWARE_MOTHERBOARD),1117)
-# Invent-A-Part RigidBoard
+# Felix 2.0+ Electronics Board (RAMPS like)
 else ifeq ($(HARDWARE_MOTHERBOARD),1118)
-# Invent-A-Part RigidBoard V2
+# Invent-A-Part RigidBoard
 else ifeq ($(HARDWARE_MOTHERBOARD),1119)
-# Sainsmart 2-in-1 board
+# Invent-A-Part RigidBoard V2
 else ifeq ($(HARDWARE_MOTHERBOARD),1120)
-# Ultimaker
+# Sainsmart 2-in-1 board
 else ifeq ($(HARDWARE_MOTHERBOARD),1121)
-# Ultimaker (Older electronics. Pre 1.5.4. This is rare)
+# Ultimaker
 else ifeq ($(HARDWARE_MOTHERBOARD),1122)
 # Ultimaker (Older electronics. Pre 1.5.4. This is rare)
 else ifeq ($(HARDWARE_MOTHERBOARD),1123)
  MCU              ?= atmega1280
  PROG_MCU         ?= m1280
 # Azteeg X3
 else ifeq ($(HARDWARE_MOTHERBOARD),1123)
 # Azteeg X3 Pro
 else ifeq ($(HARDWARE_MOTHERBOARD),1124)
-# Ultimainboard 2.x (Uses TEMP_SENSOR 20)
+# Azteeg X3 Pro
 else ifeq ($(HARDWARE_MOTHERBOARD),1125)
-# Rumba
+# Ultimainboard 2.x (Uses TEMP_SENSOR 20)
 else ifeq ($(HARDWARE_MOTHERBOARD),1126)
-# Raise3D N series Rumba derivative
+# Rumba
 else ifeq ($(HARDWARE_MOTHERBOARD),1127)
-# Rapide Lite 200 (v1, low-cost RUMBA clone with drv)
+# Raise3D N series Rumba derivative
 else ifeq ($(HARDWARE_MOTHERBOARD),1128)
-# Formbot T-Rex 2 Plus
+# Rapide Lite 200 (v1, low-cost RUMBA clone with drv)
 else ifeq ($(HARDWARE_MOTHERBOARD),1129)
-# Formbot T-Rex 3
+# Formbot T-Rex 2 Plus
 else ifeq ($(HARDWARE_MOTHERBOARD),1130)
-# Formbot Raptor
+# Formbot T-Rex 3
 else ifeq ($(HARDWARE_MOTHERBOARD),1131)
-# Formbot Raptor 2
+# Formbot Raptor
 else ifeq ($(HARDWARE_MOTHERBOARD),1132)
-# bq ZUM Mega 3D
+# Formbot Raptor 2
 else ifeq ($(HARDWARE_MOTHERBOARD),1133)
-# MakeBoard Mini v2.1.2 by MicroMake
+# bq ZUM Mega 3D
 else ifeq ($(HARDWARE_MOTHERBOARD),1134)
-# TriGorilla Anycubic version 1.3-based on RAMPS EFB
+# MakeBoard Mini v2.1.2 by MicroMake
 else ifeq ($(HARDWARE_MOTHERBOARD),1135)
-#   ... Ver 1.4
+# TriGorilla Anycubic version 1.3-based on RAMPS EFB
 else ifeq ($(HARDWARE_MOTHERBOARD),1136)
-#   ... Rev 1.1 (new servo pin order)
+#   ... Ver 1.4
 else ifeq ($(HARDWARE_MOTHERBOARD),1137)
-# Creality: Ender-4, CR-8
+#   ... Rev 1.1 (new servo pin order)
 else ifeq ($(HARDWARE_MOTHERBOARD),1138)
-# Creality: CR10S, CR20, CR-X
+# Creality: Ender-4, CR-8
 else ifeq ($(HARDWARE_MOTHERBOARD),1139)
-# Dagoma F5
+# Creality: CR10S, CR20, CR-X
 else ifeq ($(HARDWARE_MOTHERBOARD),1140)
-# FYSETC F6 1.3
+# Dagoma F5
 else ifeq ($(HARDWARE_MOTHERBOARD),1141)
-# FYSETC F6 1.4
+# Dagoma D6 (as found in the Dagoma DiscoUltimate V2 TMC)
 else ifeq ($(HARDWARE_MOTHERBOARD),1142)
-# Wanhao Duplicator i3 Plus
+# FYSETC F6 1.3
 else ifeq ($(HARDWARE_MOTHERBOARD),1143)
-# VORON Design
+# FYSETC F6 1.4
 else ifeq ($(HARDWARE_MOTHERBOARD),1144)
-# Tronxy TRONXY-V3-1.0
+# Wanhao Duplicator i3 Plus
 else ifeq ($(HARDWARE_MOTHERBOARD),1145)
-# Z-Bolt X Series
+# VORON Design
 else ifeq ($(HARDWARE_MOTHERBOARD),1146)
-# TT OSCAR
+# Tronxy TRONXY-V3-1.0
 else ifeq ($(HARDWARE_MOTHERBOARD),1147)
-# Overlord/Overlord Pro
+# Z-Bolt X Series
 else ifeq ($(HARDWARE_MOTHERBOARD),1148)
-# ADIMLab Gantry v1
+# TT OSCAR
 else ifeq ($(HARDWARE_MOTHERBOARD),1149)
 # ADIMLab Gantry v2
 else ifeq ($(HARDWARE_MOTHERBOARD),1150)
 # BIQU Tango V1
-else ifeq ($(HARDWARE_MOTHERBOARD),1151)
+else ifeq ($(HARDWARE_MOTHERBOARD),1150)
 # MKS GEN L V2
-else ifeq ($(HARDWARE_MOTHERBOARD),1152)
+else ifeq ($(HARDWARE_MOTHERBOARD),1151)
 # MKS GEN L V2.1
-else ifeq ($(HARDWARE_MOTHERBOARD),1153)
+else ifeq ($(HARDWARE_MOTHERBOARD),1152)
 # Copymaster 3D
-else ifeq ($(HARDWARE_MOTHERBOARD),1154)
+else ifeq ($(HARDWARE_MOTHERBOARD),1153)
 # Ortur 4
-else ifeq ($(HARDWARE_MOTHERBOARD),1155)
+else ifeq ($(HARDWARE_MOTHERBOARD),1154)
 # Tenlog D3 Hero IDEX printer
 else ifeq ($(HARDWARE_MOTHERBOARD),1155)
 # Tenlog D3, D5, D6 IDEX Printer
 else ifeq ($(HARDWARE_MOTHERBOARD),1156)
 # Tenlog D3,5,6 Pro IDEX printers
 else ifeq ($(HARDWARE_MOTHERBOARD),1157)
 # Ramps S 1.2 by Sakul.cz (Power outputs: Hotend0, Hotend1, Fan, Bed)
-else ifeq ($(HARDWARE_MOTHERBOARD),1158)
+else ifeq ($(HARDWARE_MOTHERBOARD),1157)
 # Ramps S 1.2 by Sakul.cz (Power outputs: Hotend0, Hotend1, Hotend2, Bed)
-else ifeq ($(HARDWARE_MOTHERBOARD),1159)
+else ifeq ($(HARDWARE_MOTHERBOARD),1158)
 # Ramps S 1.2 by Sakul.cz (Power outputs: Hotend, Fan0, Fan1, Bed)
-else ifeq ($(HARDWARE_MOTHERBOARD),1160)
+else ifeq ($(HARDWARE_MOTHERBOARD),1159)
 # Longer LK1 PRO / Alfawise U20 Pro (PRO version)
-else ifeq ($(HARDWARE_MOTHERBOARD),1161)
+else ifeq ($(HARDWARE_MOTHERBOARD),1160)
 # Longer LKx PRO / Alfawise Uxx Pro (PRO version)
-else ifeq ($(HARDWARE_MOTHERBOARD),1162)
+else ifeq ($(HARDWARE_MOTHERBOARD),1161)
 # Zonestar zrib V5.3 (Chinese RAMPS replica)
 else ifeq ($(HARDWARE_MOTHERBOARD),1163)
 # Pxmalion Core I3
 else ifeq ($(HARDWARE_MOTHERBOARD),1162)
 # Panowin Cutlass (as found in the Panowin F1)
 else ifeq ($(HARDWARE_MOTHERBOARD),1163)
 # Kodama Bardo V1.x (as found in the Kodama Trinus)
 else ifeq ($(HARDWARE_MOTHERBOARD),1164)
 # XTLW MFF V1.0
 else ifeq ($(HARDWARE_MOTHERBOARD),1165)
 # XTLW MFF V2.0
 else ifeq ($(HARDWARE_MOTHERBOARD),1166)
 #
 # RAMBo and derivatives
@@ -340,7 +356,7 @@ else ifeq ($(HARDWARE_MOTHERBOARD),1203)
 else ifeq ($(HARDWARE_MOTHERBOARD),1204)
 # abee Scoovo X9H
 else ifeq ($(HARDWARE_MOTHERBOARD),1205)
-# Rambo ThinkerV2
+# ThinkerV2
 else ifeq ($(HARDWARE_MOTHERBOARD),1206)
 #
@@ -383,30 +399,40 @@ else ifeq ($(HARDWARE_MOTHERBOARD),1315)
 else ifeq ($(HARDWARE_MOTHERBOARD),1316)
 # Geeetech GT2560 Rev B for A10(M/T/D)
 else ifeq ($(HARDWARE_MOTHERBOARD),1317)
 # Geeetech GT2560 Rev B for A10(M/T/D)
 else ifeq ($(HARDWARE_MOTHERBOARD),1318)
 # Geeetech GT2560 Rev B for Mecreator2
 else ifeq ($(HARDWARE_MOTHERBOARD),1318)
 # Geeetech GT2560 Rev B for A20(M/T/D)
 else ifeq ($(HARDWARE_MOTHERBOARD),1319)
-# Geeetech GT2560 Rev B for A20(M/T/D)
+# Geeetech GT2560 Rev B for A10(M/T/D)
 else ifeq ($(HARDWARE_MOTHERBOARD),1320)
 # Einstart retrofit
 else ifeq ($(HARDWARE_MOTHERBOARD),1321)
 # Wanhao 0ne+ i3 Mini
 else ifeq ($(HARDWARE_MOTHERBOARD),1322)
 # Leapfrog Xeed 2015
 else ifeq ($(HARDWARE_MOTHERBOARD),1323)
 # PICA Shield (original version)
 else ifeq ($(HARDWARE_MOTHERBOARD),1324)
 # PICA Shield (rev C or later)
 else ifeq ($(HARDWARE_MOTHERBOARD),1325)
 # Intamsys 4.0 (Funmat HT)
 else ifeq ($(HARDWARE_MOTHERBOARD),1326)
 # Malyan M180 Mainboard Version 2 (no display function, direct G-code only)
 else ifeq ($(HARDWARE_MOTHERBOARD),1327)
 # Geeetech GT2560 Rev B for A20(M/T/D)
 else ifeq ($(HARDWARE_MOTHERBOARD),1321)
 # Einstart retrofit
 else ifeq ($(HARDWARE_MOTHERBOARD),1322)
 # Wanhao 0ne+ i3 Mini
 else ifeq ($(HARDWARE_MOTHERBOARD),1323)
 # Overlord/Overlord Pro
 else ifeq ($(HARDWARE_MOTHERBOARD),1324)
 # ADIMLab Gantry v1
 else ifeq ($(HARDWARE_MOTHERBOARD),1325)
 # ADIMLab Gantry v2
 else ifeq ($(HARDWARE_MOTHERBOARD),1326)
 # Leapfrog Xeed 2015
 else ifeq ($(HARDWARE_MOTHERBOARD),1327)
 # PICA Shield (original version)
 else ifeq ($(HARDWARE_MOTHERBOARD),1328)
-# Mega controller & Protoneer CNC Shield V3.00
+# PICA Shield (rev C or later)
 else ifeq ($(HARDWARE_MOTHERBOARD),1329)
 # Intamsys 4.0 (Funmat HT)
 else ifeq ($(HARDWARE_MOTHERBOARD),1330)
 # Malyan M180 Mainboard Version 2 (no display function, direct G-code only)
 else ifeq ($(HARDWARE_MOTHERBOARD),1331)
 # Mega controller & Protoneer CNC Shield V3.00
 else ifeq ($(HARDWARE_MOTHERBOARD),1332)
 # WEEDO 62A board (TINA2, Monoprice Cadet, etc.)
 else ifeq ($(HARDWARE_MOTHERBOARD),1333)
 # Geeetech GT2560 V4.1B for A10(M/T/D)
 else ifeq ($(HARDWARE_MOTHERBOARD),1334)
 #
 # ATmega1281, ATmega2561
@@ -440,7 +466,7 @@ else ifeq ($(HARDWARE_MOTHERBOARD),1502)
  HARDWARE_VARIANT ?= Sanguino
  MCU              ?= atmega644p
  PROG_MCU         ?= m644p
-# Melzi V2.0
+# Melzi V2
 else ifeq ($(HARDWARE_MOTHERBOARD),1503)
  HARDWARE_VARIANT ?= Sanguino
  MCU              ?= atmega1284p
@@ -450,36 +476,41 @@ else ifeq ($(HARDWARE_MOTHERBOARD),1504)
  HARDWARE_VARIANT ?= Sanguino
  MCU              ?= atmega1284p
  PROG_MCU         ?= m1284p
-# Melzi Creality3D board (for CR-10 etc)
+# Melzi Creality3D (for CR-10 etc)
 else ifeq ($(HARDWARE_MOTHERBOARD),1505)
  HARDWARE_VARIANT ?= Sanguino
  MCU              ?= atmega1284p
  PROG_MCU         ?= m1284p
-# Melzi Malyan M150 board
+# Melzi Creality3D (for Ender-2)
 else ifeq ($(HARDWARE_MOTHERBOARD),1506)
  HARDWARE_VARIANT ?= Sanguino
  MCU              ?= atmega1284p
  PROG_MCU         ?= m1284p
-# Tronxy X5S
+# Melzi Malyan M150
 else ifeq ($(HARDWARE_MOTHERBOARD),1507)
  HARDWARE_VARIANT ?= Sanguino
  MCU              ?= atmega1284p
  PROG_MCU         ?= m1284p
-# STB V1.1
+# Tronxy X5S
 else ifeq ($(HARDWARE_MOTHERBOARD),1508)
  HARDWARE_VARIANT ?= Sanguino
  MCU              ?= atmega1284p
  PROG_MCU         ?= m1284p
-# Azteeg X1
+# STB V1.1
 else ifeq ($(HARDWARE_MOTHERBOARD),1509)
  HARDWARE_VARIANT ?= Sanguino
  MCU              ?= atmega1284p
  PROG_MCU         ?= m1284p
-# Anet 1.0 (Melzi clone)
+# Azteeg X1
 else ifeq ($(HARDWARE_MOTHERBOARD),1510)
  HARDWARE_VARIANT ?= Sanguino
  MCU              ?= atmega1284p
  PROG_MCU         ?= m1284p
 # Anet 1.0 (Melzi clone)
 else ifeq ($(HARDWARE_MOTHERBOARD),1511)
  HARDWARE_VARIANT ?= Sanguino
  MCU              ?= atmega1284p
  PROG_MCU         ?= m1284p
 # ZoneStar ZMIB V2
 else ifeq ($(HARDWARE_MOTHERBOARD),1511)
  HARDWARE_VARIANT ?= Sanguino
@@ -995,7 +1026,7 @@ extcoff: $(TARGET).elf
 	$(NM) -n $< > $@
 # Link: create ELF output file from library.
-
+LDFLAGS+= -Wl,-V
 $(BUILD_DIR)/$(TARGET).elf: $(OBJ) Configuration.h
 	$(Pecho) "  CXX   $@"
 	$P $(CXX) $(LD_PREFIX) $(ALL_CXXFLAGS) -o $@ -L. $(OBJ) $(LDFLAGS) $(LD_SUFFIX)
@@ -41,7 +41,14 @@
 * here we define this default string as the date where the latest release
 * version was tagged.
 */
-//#define STRING_DISTRIBUTION_DATE "2024-05-24"
+//#define STRING_DISTRIBUTION_DATE "2025-03-18"
 /**
 * The protocol for communication to the host. Protocol indicates communication
 * standards such as the use of ASCII, "echo:" and "error:" line prefixes, etc.
 * (Other behaviors are given by the firmware version and capabilities report.)
 */
 //#define PROTOCOL_VERSION "1.0"
 /**
 * Defines a generic printer name to be output to the LCD after booting Marlin.
@@ -68,8 +75,8 @@
 //#define WEBSITE_URL "marlinfw.org"
 /**
- * Set the vendor info the serial USB interface, if changable
+ * Set the vendor info the serial USB interface, if changeable.
- * Currently only supported by DUE platform
+ * Currently only supported by DUE platform.
 */
 //#define USB_DEVICE_VENDOR_ID           0x0000
 //#define USB_DEVICE_PRODUCT_ID          0x0000
@@ -62,6 +62,11 @@ motherboard                              = BOARD_RAMPS_14_EFB
 serial_port                              = 0
 baudrate                                 = 250000
 string_config_h_author                   = "(default from config.ini)"
 capabilities_report                      = on
 extended_capabilities_report             = on
 use_watchdog                             = on
 thermal_protection_hotends               = on
 thermal_protection_hysteresis            = 4
@@ -77,9 +82,7 @@ temp_sensor_0                            = 1
 temp_hysteresis                          = 3
 heater_0_mintemp                         = 5
 heater_0_maxtemp                         = 275
 preheat_1_temp_hotend                    = 180
 bang_max                                 = 255
 pidtemp                                  = on
 pid_k1                                   = 0.95
 pid_max                                  = 255
@@ -89,6 +92,14 @@ default_kp                               = 22.20
 default_ki                               = 1.08
 default_kd                               = 114.00
 temp_sensor_bed                          = 1
 bed_mintemp                              = 5
 bed_maxtemp                              = 150
 thermal_protection_bed                   = on
 thermal_protection_bed_hysteresis        = 2
 thermal_protection_bed_period            = 20
 x_driver_type                            = A4988
 y_driver_type                            = A4988
 z_driver_type                            = A4988
@@ -121,10 +132,10 @@ default_max_acceleration                 = { 3000, 3000, 100, 10000 }
 homing_feedrate_mm_m                     = { (50*60), (50*60), (4*60) }
 homing_bump_divisor                      = { 2, 2, 4 }
-x_enable_on                              = 0
+x_enable_on                              = LOW
-y_enable_on                              = 0
+y_enable_on                              = LOW
-z_enable_on                              = 0
+z_enable_on                              = LOW
-e_enable_on                              = 0
+e_enable_on                              = LOW
 invert_x_dir                             = false
 invert_y_dir                             = true
@@ -136,11 +147,6 @@ step_state_x                             = HIGH
 step_state_y                             = HIGH
 step_state_z                             = HIGH
 disable_x                                = off
 disable_y                                = off
 disable_z                                = off
 disable_e                                = off
 proportional_font_ratio                  = 1.0
 default_nominal_filament_dia             = 1.75
@@ -153,18 +159,13 @@ default_retract_acceleration             = 3000
 default_minimumfeedrate                  = 0.0
 default_mintravelfeedrate                = 0.0
 minimum_planner_speed                    = 0.05
 min_steps_per_segment                    = 6
 default_minsegmenttime                   = 20000
 [config:basic]
 bed_overshoot                            = 10
 busy_while_heating                       = on
 default_ejerk                            = 5.0
 default_keepalive_interval               = 2
 default_leveling_fade_height             = 0.0
 disable_other_extruders                  = on
 display_charset_hd44780                  = JAPANESE
 eeprom_boot_silent                       = on
 eeprom_chitchat                          = on
 endstoppullups                           = on
@@ -173,10 +174,8 @@ extrude_mintemp                          = 170
 host_keepalive_feature                   = on
 hotend_overshoot                         = 15
 jd_handle_small_segments                 = on
 lcd_info_screen_style                    = 0
 lcd_language                             = en
 max_bed_power                            = 255
-mesh_inset                               = 0
+
 min_software_endstops                    = on
 max_software_endstops                    = on
 min_software_endstop_x                   = on
@@ -185,50 +184,48 @@ min_software_endstop_z                   = on
 max_software_endstop_x                   = on
 max_software_endstop_y                   = on
 max_software_endstop_z                   = on
-preheat_1_fan_speed                      = 0
+
 preheat_1_label                          = "PLA"
 preheat_1_temp_hotend                    = 180
 preheat_1_temp_bed                       = 70
 preheat_1_fan_speed                      = 0
 preheat_2_label                          = "ABS"
 preheat_2_temp_hotend                    = 240
 preheat_2_temp_bed                       = 110
 preheat_2_fan_speed                      = 0
 prevent_cold_extrusion                   = on
 prevent_lengthy_extrude                  = on
 printjob_timer_autostart                 = on
-probing_margin                           = 10
+
 show_bootscreen                          = on
 soft_pwm_scale                           = 0
 string_config_h_author                   = "(none, default config)"
 temp_bed_hysteresis                      = 3
 temp_bed_residency_time                  = 10
 temp_bed_window                          = 1
 temp_residency_time                      = 10
 temp_window                              = 1
 validate_homing_endstops                 = on
-xy_probe_feedrate                        = (133*60)
+
-z_clearance_between_probes               = 5
+editable_steps_per_unit                  = on
 z_clearance_deploy_probe                 = 10
 z_clearance_multi_probe                  = 5
 [config:advanced]
 arc_support                              = on
 auto_report_temperatures                 = on
 autotemp                                 = on
 autotemp_min                             = 210
 autotemp_max                             = 250
 autotemp_factor                          = 0.1f
 autotemp_oldweight                       = 0.98
-bed_check_interval                       = 5000
+
 default_stepper_timeout_sec              = 120
 default_volumetric_extruder_limit        = 0.00
 disable_idle_x                           = on
 disable_idle_y                           = on
 disable_idle_z                           = on
 disable_idle_e                           = on
 e0_auto_fan_pin                          = -1
 encoder_100x_steps_per_sec               = 80
 encoder_10x_steps_per_sec                = 30
 encoder_rate_multiplier                  = on
 extended_capabilities_report             = on
 extruder_auto_fan_speed                  = 255
 extruder_auto_fan_temperature            = 50
 fanmux0_pin                              = -1
 fanmux1_pin                              = -1
 fanmux2_pin                              = -1
 faster_gcode_parser                      = on
 debug_flags_gcode                        = on
 homing_bump_mm                           = { 5, 5, 2 }
 max_arc_segment_mm                       = 1.0
 min_arc_segment_mm                       = 0.1
@@ -237,11 +234,11 @@ n_arc_correction                         = 25
 serial_overrun_protection                = on
 slowdown                                 = on
 slowdown_divisor                         = 2
 temp_sensor_bed                          = 0
 thermal_protection_bed_hysteresis        = 2
 thermocouple_max_errors                  = 15
 tx_buffer_size                           = 0
 bed_check_interval                       = 5000
 watch_bed_temp_increase                  = 2
 watch_bed_temp_period                    = 60
 watch_temp_increase                      = 2
-watch_temp_period                        = 20
+watch_temp_period                        = 40
@@ -129,11 +129,11 @@ typedef Servo hal_servo_t;
  #endif
 #endif
-#ifdef MMU2_SERIAL_PORT
+#ifdef MMU_SERIAL_PORT
-  #if !WITHIN(MMU2_SERIAL_PORT, 0, 3)
+  #if !WITHIN(MMU_SERIAL_PORT, 0, 3)
-    #error "MMU2_SERIAL_PORT must be from 0 to 3"
+    #error "MMU_SERIAL_PORT must be from 0 to 3"
  #endif
-  #define MMU2_SERIAL mmuSerial
+  #define MMU_SERIAL mmuSerial
 #endif
 #ifdef LCD_SERIAL_PORT
@@ -141,7 +141,7 @@ typedef Servo hal_servo_t;
    #error "LCD_SERIAL_PORT must be from 0 to 3."
  #endif
  #define LCD_SERIAL lcdSerial
-  #if HAS_DGUS_LCD
+  #if ANY(HAS_DGUS_LCD, EXTENSIBLE_UI)
    #define LCD_SERIAL_TX_BUFFER_FREE() LCD_SERIAL.get_tx_buffer_free()
  #endif
 #endif
@@ -159,7 +159,7 @@ typedef Servo hal_servo_t;
 #define GET_PIN_MAP_INDEX(pin) pin
 #define PARSED_PIN_INDEX(code, dval) parser.intval(code, dval)
-#define HAL_SENSITIVE_PINS 0, 1,
+#define HAL_SENSITIVE_PINS 0, 1
 #ifdef __AVR_AT90USB1286__
  #define JTAG_DISABLE() do{ MCUCR = 0x80; MCUCR = 0x80; }while(0)
@@ -601,20 +601,20 @@ MSerialT1 customizedSerial1(MSerialT1::HasEmergencyParser);
 #endif // SERIAL_PORT_3
-#ifdef MMU2_SERIAL_PORT
+#ifdef MMU_SERIAL_PORT
-  ISR(SERIAL_REGNAME(USART, MMU2_SERIAL_PORT, _RX_vect)) {
+  ISR(SERIAL_REGNAME(USART, MMU_SERIAL_PORT, _RX_vect)) {
-    MarlinSerial<MMU2SerialCfg<MMU2_SERIAL_PORT>>::store_rxd_char();
+    MarlinSerial<MMU2SerialCfg<MMU_SERIAL_PORT>>::store_rxd_char();
  }
-  ISR(SERIAL_REGNAME(USART, MMU2_SERIAL_PORT, _UDRE_vect)) {
+  ISR(SERIAL_REGNAME(USART, MMU_SERIAL_PORT, _UDRE_vect)) {
-    MarlinSerial<MMU2SerialCfg<MMU2_SERIAL_PORT>>::_tx_udr_empty_irq();
+    MarlinSerial<MMU2SerialCfg<MMU_SERIAL_PORT>>::_tx_udr_empty_irq();
  }
-  template class MarlinSerial< MMU2SerialCfg<MMU2_SERIAL_PORT> >;
+  template class MarlinSerial< MMU2SerialCfg<MMU_SERIAL_PORT> >;
  MSerialMMU2 mmuSerial(MSerialMMU2::HasEmergencyParser);
-#endif // MMU2_SERIAL_PORT
+#endif // MMU_SERIAL_PORT
 #ifdef LCD_SERIAL_PORT
@@ -629,7 +629,7 @@ MSerialT1 customizedSerial1(MSerialT1::HasEmergencyParser);
  template class MarlinSerial< LCDSerialCfg<LCD_SERIAL_PORT> >;
  MSerialLCD lcdSerial(MSerialLCD::HasEmergencyParser);
-  #if HAS_DGUS_LCD
+  #if ANY(HAS_DGUS_LCD, EXTENSIBLE_UI)
    template<typename Cfg>
    typename MarlinSerial<Cfg>::ring_buffer_pos_t MarlinSerial<Cfg>::get_tx_buffer_free() {
      const ring_buffer_pos_t t = tx_buffer.tail,  // next byte to send.
@@ -205,7 +205,7 @@
    static ring_buffer_pos_t available();
    static void write(const uint8_t c);
    static void flushTX();
-    #if HAS_DGUS_LCD
+    #if ANY(HAS_DGUS_LCD, EXTENSIBLE_UI)
      static ring_buffer_pos_t get_tx_buffer_free();
    #endif
@@ -246,7 +246,7 @@
 #endif // !USBCON
-#ifdef MMU2_SERIAL_PORT
+#ifdef MMU_SERIAL_PORT
  template <uint8_t serial>
  struct MMU2SerialCfg {
    static constexpr int PORT               = serial;
@@ -260,7 +260,7 @@
    static constexpr bool RX_OVERRUNS       = false;
  };
-  typedef Serial1Class< MarlinSerial< MMU2SerialCfg<MMU2_SERIAL_PORT> > > MSerialMMU2;
+  typedef Serial1Class< MarlinSerial< MMU2SerialCfg<MMU_SERIAL_PORT> > > MSerialMMU2;
  extern MSerialMMU2 mmuSerial;
 #endif
@@ -345,6 +345,14 @@ void setup_endstop_interrupts() {
      pciSetup(Z_MIN_PROBE_PIN);
    #endif
  #endif
  #if USE_CALIBRATION
    #if (digitalPinToInterrupt(CALIBRATION_PIN) != NOT_AN_INTERRUPT)
      _ATTACH(CALIBRATION_PIN);
    #else
      static_assert(digitalPinHasPCICR(CALIBRATION_PIN), "CALIBRATION_PIN is not interrupt-capable. Disable ENDSTOP_INTERRUPTS_FEATURE to continue.");
      pciSetup(CALIBRATION_PIN);
    #endif
  #endif
  // If we arrive here without raising an assertion, each pin has either an EXT-interrupt or a PCI.
 }
@@ -150,7 +150,7 @@ void MarlinHAL::set_pwm_frequency(const pin_t pin, const uint16_t f_desired) {
      else {
        if (p == 32 || p == 128) continue;                    // Skip TIMER2 specific prescalers when not TIMER2
        const uint16_t rft = (F_CPU) / (p * f_desired);
-        DEBUG_ECHOLNPGM("(Not Timer 2) F_CPU=" STRINGIFY(F_CPU), " prescaler=", p, " f_desired=", f_desired);
+        DEBUG_ECHOLNPGM("(Not Timer 2) F_CPU=", STRINGIFY(F_CPU), " prescaler=", p, " f_desired=", f_desired);
        res_fast_temp = rft - 1;
        res_pc_temp = rft / 2;
      }
@@ -28,9 +28,6 @@
 *   Port          : E0 E1 E4 E5 G5 E3 H3 H4 H5 H6 B4 B5 B6 B7 J1 J0 H1 H0 D3 D2 D1 D0 A0 A1 A2 A3 A4 A5 A6 A7 C7 C6 C5 C4 C3 C2 C1 C0 D7 G2 G1 G0 L7 L6 L5 L4 L3 L2 L1 L0 B3 B2 B1 B0 F0 F1 F2 F3 F4 F5 F6 F7 K0 K1 K2 K3 K4 K5 K6 K7 | E2 E6 E7 xx xx H2 H7 G3 G4 xx xx xx xx xx D4 D5 D6 xx xx J2 J3 J4 J5 J6 J7 xx xx xx xx xx
 *   Logical Pin   : 00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 | 78 79 80 xx xx 84 85 71 70 xx xx xx xx xx 81 82 83 xx xx 72 73 75 76 77 74 xx xx xx xx xx
 *   Analog Input  :                                                                                                                                                                    0  1  2  3  4  5  6  7  8  9 10 11 12 13 14 15
 *
 * Arduino Pin Layout video: https://youtu.be/rIqeVCX09FA
 * AVR alternate pin function overview video: https://youtu.be/1yd8wuI5Plg
 */
 #include "../fastio.h"
@@ -26,9 +26,6 @@
 *
 *   Logical Pin: 38 39 40 41 42 43 44 45 16 10 11 12 06 07 08 09 30 31 32 33 34 35 36 37 17 18 19 20 21 22 23 24 00 01 13 05 02 03 14 15 46 47 48 49 50 51 52 53 25 26 27 28 29 04
 *   Port:        A0 A1 A2 A3 A4 A5 A6 A7 B0 B1 B2 B3 B4 B5 B6 B7 C0 C1 C2 C3 C4 C5 C6 C7 D0 D1 D2 D3 D4 D5 D6 D7 E0 E1 E2 E3 E4 E5 E6 E7 F0 F1 F2 F3 F4 F5 F6 F7 G0 G1 G2 G3 G4 G5
 *
 * Arduino Pin Layout video: https://youtu.be/rIqeVCX09FA
 * AVR alternate pin function overview video: https://youtu.be/1yd8wuI5Plg
 */
 #include "../fastio.h"
@@ -26,9 +26,6 @@
 *
 *   Logical Pin: 08 09 10 11 12 13 14 15 16 17 18 19 20 21 00 01 02 03 04 05 06 07
 *   Port:        B0 B1 B2 B3 B4 B5 C0 C1 C2 C3 C4 C5 C6 C7 D0 D1 D2 D3 D4 D5 D6 D7
 *
 * Arduino Pin Layout video: https://youtu.be/rIqeVCX09FA
 * AVR alternate pin function overview video: https://youtu.be/1yd8wuI5Plg
 */
 #include "../fastio.h"
@@ -26,9 +26,6 @@
 *
 *   Logical Pin: 00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
 *   Port:        B0 B1 B2 B3 B4 B5 B6 B7 D0 D1 D2 D3 D4 D5 D6 D7 C0 C1 C2 C3 C4 C5 C6 C7 A7 A6 A5 A4 A3 A2 A1 A0
 *
 * Arduino Pin Layout video: https://youtu.be/rIqeVCX09FA
 * AVR alternate pin function overview video: https://youtu.be/1yd8wuI5Plg
 */
 /**                        ATMega644
@@ -26,10 +26,7 @@
 *
 *   Logical Pin: 28 29 30 31 32 33 34 35 20 21 22 23 24 25 26 27 10 11 12 13 14 15 16 17 00 01 02 03 04 05 06 07 08 09(46*47)36 37 18 19 38 39 40 41 42 43 44 45
 *   Port:        A0 A1 A2 A3 A4 A5 A6 A7 B0 B1 B2 B3 B4 B5 B6 B7 C0 C1 C2 C3 C4 C5 C6 C7 D0 D1 D2 D3 D4 D5 D6 D7 E0 E1 E2 E3 E4 E5 E6 E7 F0 F1 F2 F3 F4 F5 F6 F7
- *            The logical pins 46 and 47 are not supported by Teensyduino, but are supported below as E2 and E3
+ *            Logical pins 46-47 aren't supported by Teensyduino, but are supported below as E2 and E3
 *
 * Arduino Pin Layout video: https://youtu.be/rIqeVCX09FA
 * AVR alternate pin function overview video: https://youtu.be/1yd8wuI5Plg
 */
 #include "../fastio.h"
@@ -22,7 +22,23 @@
 #pragma once
 /**
- * PWM print routines for Atmel 8 bit AVR CPUs
+ * Pins Debugging for Atmel 8 bit AVR CPUs
 *
 *   - NUMBER_PINS_TOTAL
 *   - MULTI_NAME_PAD
 *   - getPinByIndex(index)
 *   - printPinNameByIndex(index)
 *   - getPinIsDigitalByIndex(index)
 *   - digitalPinToAnalogIndex(pin)
 *   - getValidPinMode(pin)
 *   - isValidPin(pin)
 *   - isAnalogPin(pin)
 *   - digitalRead_mod(pin)
 *   - pwm_status(pin)
 *   - printPinPWM(pin)
 *   - printPinPort(pin)
 *   - printPinNumber(pin)
 *   - printPinAnalog(pin)
 */
 #include "../../inc/MarlinConfig.h"
@@ -39,44 +55,44 @@
  #include "pinsDebug_Teensyduino.h"
  // Can't use the "digitalPinToPort" function from the Teensyduino type IDEs
  // portModeRegister takes a different argument
-  #define digitalPinToTimer_DEBUG(p) digitalPinToTimer(p)
+  #define digitalPinToTimer_DEBUG(P) digitalPinToTimer(P)
-  #define digitalPinToBitMask_DEBUG(p) digitalPinToBitMask(p)
+  #define digitalPinToBitMask_DEBUG(P) digitalPinToBitMask(P)
-  #define digitalPinToPort_DEBUG(p) digitalPinToPort(p)
+  #define digitalPinToPort_DEBUG(P) digitalPinToPort(P)
-  #define GET_PINMODE(pin) (*portModeRegister(pin) & digitalPinToBitMask_DEBUG(pin))
+  #define getValidPinMode(P) (*portModeRegister(P) & digitalPinToBitMask_DEBUG(P))
 #elif AVR_ATmega2560_FAMILY_PLUS_70   // So we can access/display all the pins on boards using more than 70
  #include "pinsDebug_plus_70.h"
-  #define digitalPinToTimer_DEBUG(p) digitalPinToTimer_plus_70(p)
+  #define digitalPinToTimer_DEBUG(P) digitalPinToTimer_plus_70(P)
-  #define digitalPinToBitMask_DEBUG(p) digitalPinToBitMask_plus_70(p)
+  #define digitalPinToBitMask_DEBUG(P) digitalPinToBitMask_plus_70(P)
-  #define digitalPinToPort_DEBUG(p) digitalPinToPort_plus_70(p)
+  #define digitalPinToPort_DEBUG(P) digitalPinToPort_plus_70(P)
-  bool GET_PINMODE(int8_t pin) {return *portModeRegister(digitalPinToPort_DEBUG(pin)) & digitalPinToBitMask_DEBUG(pin); }
+  bool getValidPinMode(pin_t pin) {return *portModeRegister(digitalPinToPort_DEBUG(pin)) & digitalPinToBitMask_DEBUG(pin); }
 #else
-  #define digitalPinToTimer_DEBUG(p) digitalPinToTimer(p)
+  #define digitalPinToTimer_DEBUG(P) digitalPinToTimer(P)
-  #define digitalPinToBitMask_DEBUG(p) digitalPinToBitMask(p)
+  #define digitalPinToBitMask_DEBUG(P) digitalPinToBitMask(P)
-  #define digitalPinToPort_DEBUG(p) digitalPinToPort(p)
+  #define digitalPinToPort_DEBUG(P) digitalPinToPort(P)
-  bool GET_PINMODE(int8_t pin) {return *portModeRegister(digitalPinToPort_DEBUG(pin)) & digitalPinToBitMask_DEBUG(pin); }
+  bool getValidPinMode(pin_t pin) {return *portModeRegister(digitalPinToPort_DEBUG(pin)) & digitalPinToBitMask_DEBUG(pin); }
-  #define GET_ARRAY_PIN(p) pgm_read_byte(&pin_array[p].pin)
+  #define getPinByIndex(x) pgm_read_byte(&pin_array[x].pin)
 #endif
-#define VALID_PIN(pin) (pin >= 0 && pin < NUM_DIGITAL_PINS ? 1 : 0)
+#define isValidPin(P) (P >= 0 && P < NUMBER_PINS_TOTAL)
 #if AVR_ATmega1284_FAMILY
-  #define IS_ANALOG(P) WITHIN(P, analogInputToDigitalPin(7), analogInputToDigitalPin(0))
+  #define isAnalogPin(P) WITHIN(P, analogInputToDigitalPin(7), analogInputToDigitalPin(0))
-  #define DIGITAL_PIN_TO_ANALOG_PIN(P) int(IS_ANALOG(P) ? (P) - analogInputToDigitalPin(7) : -1)
+  #define digitalPinToAnalogIndex(P) int(isAnalogPin(P) ? (P) - analogInputToDigitalPin(7) : -1)
 #else
  #define _ANALOG1(P) WITHIN(P, analogInputToDigitalPin(0), analogInputToDigitalPin(7))
  #define _ANALOG2(P) WITHIN(P, analogInputToDigitalPin(8), analogInputToDigitalPin(15))
-  #define IS_ANALOG(P) (_ANALOG1(P) || _ANALOG2(P))
+  #define isAnalogPin(P) (_ANALOG1(P) || _ANALOG2(P))
-  #define DIGITAL_PIN_TO_ANALOG_PIN(P) int(_ANALOG1(P) ? (P) - analogInputToDigitalPin(0) : _ANALOG2(P) ? (P) - analogInputToDigitalPin(8) + 8 : -1)
+  #define digitalPinToAnalogIndex(P) int(_ANALOG1(P) ? (P) - analogInputToDigitalPin(0) : _ANALOG2(P) ? (P) - analogInputToDigitalPin(8) + 8 : -1)
 #endif
-#define GET_ARRAY_PIN(p) pgm_read_byte(&pin_array[p].pin)
+#define getPinByIndex(x) pgm_read_byte(&pin_array[x].pin)
 #define MULTI_NAME_PAD 26 // space needed to be pretty if not first name assigned to a pin
-void PRINT_ARRAY_NAME(uint8_t x) {
+void printPinNameByIndex(const uint8_t index) {
-  PGM_P const name_mem_pointer = (PGM_P)pgm_read_ptr(&pin_array[x].name);
+  PGM_P const name_mem_pointer = (PGM_P)pgm_read_ptr(&pin_array[index].name);
  for (uint8_t y = 0; y < MAX_NAME_LENGTH; ++y) {
    char temp_char = pgm_read_byte(name_mem_pointer + y);
    if (temp_char != 0)
@@ -88,7 +104,7 @@ void PRINT_ARRAY_NAME(uint8_t x) {
  }
 }
-#define GET_ARRAY_IS_DIGITAL(x)   pgm_read_byte(&pin_array[x].is_digital)
+#define getPinIsDigitalByIndex(x)   pgm_read_byte(&pin_array[x].is_digital)
 #if defined(__AVR_ATmega1284P__)  // 1284 IDE extensions set this to the number of
  #undef NUM_DIGITAL_PINS         // digital only pins while all other CPUs have it
@@ -109,7 +125,7 @@ void PRINT_ARRAY_NAME(uint8_t x) {
 * Print a pin's PWM status.
 * Return true if it's currently a PWM pin.
 */
-bool pwm_status(uint8_t pin) {
+bool pwm_status(const uint8_t pin) {
  char buffer[20];   // for the sprintf statements
  switch (digitalPinToTimer_DEBUG(pin)) {
@@ -276,7 +292,7 @@ void timer_prefix(uint8_t T, char L, uint8_t N) {  // T - timer    L - pwm  N -
  if (TEST(*TMSK, TOIE)) err_prob_interrupt();
 }
-void pwm_details(uint8_t pin) {
+void printPinPWM(const uint8_t pin) {
  switch (digitalPinToTimer_DEBUG(pin)) {
    #if ABTEST(0)
@@ -347,7 +363,7 @@ void pwm_details(uint8_t pin) {
  #else
    UNUSED(print_is_also_tied);
  #endif
-} // pwm_details
+} // printPinPWM
 #ifndef digitalRead_mod                   // Use Teensyduino's version of digitalRead - it doesn't disable the PWMs
  int digitalRead_mod(const pin_t pin) {  // same as digitalRead except the PWM stop section has been removed
@@ -356,7 +372,7 @@ void pwm_details(uint8_t pin) {
  }
 #endif
-void print_port(const pin_t pin) {   // print port number
+void printPinPort(const pin_t pin) {   // print port number
  #ifdef digitalPinToPort_DEBUG
    uint8_t x;
    SERIAL_ECHOPGM("  Port: ");
@@ -386,7 +402,7 @@ void print_port(const pin_t pin) {   // print port number
  #endif
 }
-#define PRINT_PIN(p) do{ sprintf_P(buffer, PSTR("%3d "), p); SERIAL_ECHO(buffer); }while(0)
+#define printPinNumber(P) do{ sprintf_P(buffer, PSTR("%3d "), P); SERIAL_ECHO(buffer); }while(0)
-#define PRINT_PIN_ANALOG(p) do{ sprintf_P(buffer, PSTR(" (A%2d)  "), DIGITAL_PIN_TO_ANALOG_PIN(pin)); SERIAL_ECHO(buffer); }while(0)
+#define printPinAnalog(P) do{ sprintf_P(buffer, PSTR(" (A%2d)  "), digitalPinToAnalogIndex(P)); SERIAL_ECHO(buffer); }while(0)
 #undef ABTEST
@@ -102,7 +102,7 @@ const uint8_t PROGMEM digital_pin_to_port_PGM[] = {
 // digitalPinToBitMask(pin) is OK
-#define digitalRead_mod(p)  extDigitalRead(p)   // Teensyduino's version of digitalRead doesn't
+#define digitalRead_mod(P)  extDigitalRead(P)   // Teensyduino's version of digitalRead doesn't
                                                // disable the PWMs so we can use it as is
 // portModeRegister(pin) is OK
@@ -23,43 +23,41 @@
 /**
 * Define SPI Pins: SCK, MISO, MOSI, SS
 * Platform pins have parentheses, e.g., "(53)", so we cannot use them.
 */
 #if defined(__AVR_ATmega168__) || defined(__AVR_ATmega328__) || defined(__AVR_ATmega328P__)
-  #define AVR_SCK_PIN  13
+  #define _PIN_SPI_SCK  13
-  #define AVR_MISO_PIN 12
+  #define _PIN_SPI_MISO 12
-  #define AVR_MOSI_PIN 11
+  #define _PIN_SPI_MOSI 11
-  #define AVR_SS_PIN   10
+  #define _PIN_SPI_SS   10
 #elif defined(__AVR_ATmega644__) || defined(__AVR_ATmega644P__) || defined(__AVR_ATmega644PA__) || defined(__AVR_ATmega1284P__)
-  #define AVR_SCK_PIN  7
+  #define _PIN_SPI_SCK  7
-  #define AVR_MISO_PIN 6
+  #define _PIN_SPI_MISO 6
-  #define AVR_MOSI_PIN 5
+  #define _PIN_SPI_MOSI 5
-  #define AVR_SS_PIN   4
+  #define _PIN_SPI_SS   4
 #elif defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
-  #define AVR_SCK_PIN  52
+  #define _PIN_SPI_SCK  52
-  #define AVR_MISO_PIN 50
+  #define _PIN_SPI_MISO 50
-  #define AVR_MOSI_PIN 51
+  #define _PIN_SPI_MOSI 51
-  #define AVR_SS_PIN   53
+  #define _PIN_SPI_SS   53
 #elif defined(__AVR_AT90USB1287__) || defined(__AVR_AT90USB1286__) || defined(__AVR_AT90USB646__) || defined(__AVR_AT90USB647__)
-  #define AVR_SCK_PIN  21
+  #define _PIN_SPI_SCK  21
-  #define AVR_MISO_PIN 23
+  #define _PIN_SPI_MISO 23
-  #define AVR_MOSI_PIN 22
+  #define _PIN_SPI_MOSI 22
-  #define AVR_SS_PIN   20
+  #define _PIN_SPI_SS   20
 #elif defined(__AVR_ATmega1281__) || defined(__AVR_ATmega2561__)
-  #define AVR_SCK_PIN  10
+  #define _PIN_SPI_SCK  10
-  #define AVR_MISO_PIN 12
+  #define _PIN_SPI_MISO 12
-  #define AVR_MOSI_PIN 11
+  #define _PIN_SPI_MOSI 11
-  #define AVR_SS_PIN   16
+  #define _PIN_SPI_SS   16
 #endif
 #ifndef SD_SCK_PIN
-  #define SD_SCK_PIN  AVR_SCK_PIN
+  #define SD_SCK_PIN  _PIN_SPI_SCK
 #endif
 #ifndef SD_MISO_PIN
-  #define SD_MISO_PIN AVR_MISO_PIN
+  #define SD_MISO_PIN _PIN_SPI_MISO
 #endif
 #ifndef SD_MOSI_PIN
-  #define SD_MOSI_PIN AVR_MOSI_PIN
+  #define SD_MOSI_PIN _PIN_SPI_MOSI
 #endif
 #ifndef SD_SS_PIN
  #define SD_SS_PIN   AVR_SS_PIN
 #endif
@@ -120,7 +120,7 @@ void u8g_spiSend_sw_AVR_mode_3(uint8_t val) {
  U8G_ATOMIC_END();
 }
-#if ENABLED(FYSETC_MINI_12864)
+#if U8G_SPI_USE_MODE_3
  #define SPISEND_SW_AVR u8g_spiSend_sw_AVR_mode_3
 #else
  #define SPISEND_SW_AVR u8g_spiSend_sw_AVR_mode_0
@@ -143,9 +143,9 @@ uint8_t u8g_com_HAL_AVR_sw_sp_fn(u8g_t *u8g, uint8_t msg, uint8_t arg_val, void
      break;
    case U8G_COM_MSG_CHIP_SELECT:
-      #if ENABLED(FYSETC_MINI_12864)           // LCD SPI is running mode 3 while SD card is running mode 0
+      #if U8G_SPI_USE_MODE_3                                  // LCD SPI is running mode 3 while SD card is running mode 0
-        if (arg_val) {                         //   SCK idle state needs to be set to the proper idle state before
+        if (arg_val) {                                        // SCK idle state needs to be set to the proper idle state before
-                                               //   the next chip select goes active
+                                                              //  the next chip select goes active
          u8g_com_arduino_digital_write(u8g, U8G_PI_SCK, 1);  // Set SCK to mode 3 idle state before CS goes active
          u8g_com_arduino_digital_write(u8g, U8G_PI_CS, LOW);
        }
@@ -48,7 +48,7 @@ uint16_t MarlinHAL::adc_result;
 void MarlinHAL::init() {
  #if HAS_MEDIA
-    OUT_WRITE(SDSS, HIGH);  // Try to set SDSS inactive before any other SPI users start up
+    OUT_WRITE(SD_SS_PIN, HIGH);  // Try to set SDSS inactive before any other SPI users start up
  #endif
  usb_task_init();          // Initialize the USB stack
  TERN_(POSTMORTEM_DEBUGGING, install_min_serial()); // Install the min serial handler
@@ -35,67 +35,9 @@
 #include <stdint.h>
-#include "../../core/serial_hook.h"
+//
-
+// Serial Ports
-// ------------------------
+//
 // Serial ports
 // ------------------------
 typedef ForwardSerial1Class< decltype(Serial) > DefaultSerial1;
 typedef ForwardSerial1Class< decltype(Serial1) > DefaultSerial2;
 typedef ForwardSerial1Class< decltype(Serial2) > DefaultSerial3;
 typedef ForwardSerial1Class< decltype(Serial3) > DefaultSerial4;
 extern DefaultSerial1 MSerial0;
 extern DefaultSerial2 MSerial1;
 extern DefaultSerial3 MSerial2;
 extern DefaultSerial4 MSerial3;
 #define _MSERIAL(X) MSerial##X
 #define MSERIAL(X) _MSERIAL(X)
 #if SERIAL_PORT == -1 || ENABLED(EMERGENCY_PARSER)
  #define MYSERIAL1 customizedSerial1
 #elif WITHIN(SERIAL_PORT, 0, 3)
  #define MYSERIAL1 MSERIAL(SERIAL_PORT)
 #else
  #error "The required SERIAL_PORT must be from 0 to 3, or -1 for USB Serial."
 #endif
 #ifdef SERIAL_PORT_2
  #if SERIAL_PORT_2 == -1 || ENABLED(EMERGENCY_PARSER)
    #define MYSERIAL2 customizedSerial2
  #elif WITHIN(SERIAL_PORT_2, 0, 3)
    #define MYSERIAL2 MSERIAL(SERIAL_PORT_2)
  #else
    #error "SERIAL_PORT_2 must be from 0 to 3, or -1 for USB Serial."
  #endif
 #endif
 #ifdef SERIAL_PORT_3
  #if SERIAL_PORT_3 == -1 || ENABLED(EMERGENCY_PARSER)
    #define MYSERIAL3 customizedSerial3
  #elif WITHIN(SERIAL_PORT_3, 0, 3)
    #define MYSERIAL3 MSERIAL(SERIAL_PORT_3)
  #else
    #error "SERIAL_PORT_3 must be from 0 to 3, or -1 for USB Serial."
  #endif
 #endif
 #ifdef MMU2_SERIAL_PORT
  #if WITHIN(MMU2_SERIAL_PORT, 0, 3)
    #define MMU2_SERIAL MSERIAL(MMU2_SERIAL_PORT)
  #else
    #error "MMU2_SERIAL_PORT must be from 0 to 3."
  #endif
 #endif
 #ifdef LCD_SERIAL_PORT
  #if WITHIN(LCD_SERIAL_PORT, 0, 3)
    #define LCD_SERIAL MSERIAL(LCD_SERIAL_PORT)
  #else
    #error "LCD_SERIAL_PORT must be from 0 to 3."
  #endif
 #endif
 #include "MarlinSerial.h"
 #include "MarlinSerialUSB.h"
@@ -127,7 +69,7 @@ typedef Servo hal_servo_t;
 #define HAL_ADC_RESOLUTION  10
 #ifndef analogInputToDigitalPin
-  #define analogInputToDigitalPin(p) ((p < 12U) ? (p) + 54U : -1)
+  #define analogInputToDigitalPin(p) pin_t((p < 12U) ? (p) + 54U : -1)
 #endif
 //
@@ -600,9 +600,8 @@
      OUT_WRITE(SPI_EEPROM1_CS_PIN, HIGH);
      OUT_WRITE(SPI_EEPROM2_CS_PIN, HIGH);
      OUT_WRITE(SPI_FLASH_CS_PIN, HIGH);
-      WRITE(SD_SS_PIN, HIGH);
+      OUT_WRITE(SD_SS_PIN, HIGH);
-
+      WRITE(SD_SS_PIN, LOW);
      OUT_WRITE(SDSS, LOW);
      PIO_Configure(
        g_APinDescription[SPI_PIN].pPort,
@@ -767,7 +766,7 @@
      // Disable PIO on A26 and A27
      REG_PIOA_PDR = 0x0C000000;
-      OUT_WRITE(SDSS, HIGH);
+      OUT_WRITE(SD_SS_PIN, HIGH);
      // Reset SPI0 (from sam lib)
      SPI0->SPI_CR = SPI_CR_SPIDIS;
@@ -33,6 +33,21 @@
 #include "../../core/types.h"
 #include "../../core/serial_hook.h"
 typedef ForwardSerial1Class< decltype(Serial) > DefaultSerial1;
 typedef ForwardSerial1Class< decltype(Serial1) > DefaultSerial2;
 typedef ForwardSerial1Class< decltype(Serial2) > DefaultSerial3;
 typedef ForwardSerial1Class< decltype(Serial3) > DefaultSerial4;
 extern DefaultSerial1 MSerial0;
 extern DefaultSerial2 MSerial1;
 extern DefaultSerial3 MSerial2;
 extern DefaultSerial4 MSerial3;
 #define SERIAL_INDEX_MIN 0
 #define SERIAL_INDEX_MAX 3
 #define EP_SERIAL_PORT(N) customizedSerial##N
 #define USB_SERIAL_PORT(N) customizedSerial##N
 #include "../shared/serial_ports.h"
 // Define constants and variables for buffering incoming serial data.  We're
 // using a ring buffer (I think), in which rx_buffer_head is the index of the
 // location to which to write the next incoming character and rx_buffer_tail
@@ -50,7 +50,7 @@
 static Flags<_Nbr_16timers> DisablePending; // ISR should disable the timer at the next timer reset
 // ------------------------
-/// Interrupt handler for the TC0 channel 1.
+// Interrupt handler for the TC0 channel 1.
 // ------------------------
 void Servo_Handler(const timer16_Sequence_t, Tc*, const uint8_t);
@@ -291,7 +291,7 @@ static bool ee_PageWrite(uint16_t page, const void *data) {
      uint32_t *p1 = (uint32_t*)addrflash;
      uint32_t *p2 = (uint32_t*)data;
      int count = 0;
-      for (i =0; i<PageSize >> 2; i++) {
+      for (i = 0; i < PageSize >> 2; i++) {
        if (p1[i] != p2[i]) {
          uint32_t delta = p1[i] ^ p2[i];
          while (delta) {
@@ -64,6 +64,7 @@ void setup_endstop_interrupts() {
  TERN_(USE_Z4_MAX,      _ATTACH(Z4_MAX_PIN));
  TERN_(USE_Z4_MIN,      _ATTACH(Z4_MIN_PIN));
  TERN_(USE_Z_MIN_PROBE, _ATTACH(Z_MIN_PROBE_PIN));
  TERN_(USE_CALIBRATION, _ATTACH(CALIBRATION_PIN));
  TERN_(USE_I_MAX,       _ATTACH(I_MAX_PIN));
  TERN_(USE_I_MIN,       _ATTACH(I_MIN_PIN));
  TERN_(USE_J_MAX,       _ATTACH(J_MAX_PIN));
@@ -68,16 +68,15 @@
 * Usually the hardware SPI pins are only available to the LCD. This makes the DUE hard SPI used at the same time
 * as the TMC2130 soft SPI the most common setup.
 */
 #define _IS_HW_SPI(P) (defined(TMC_SPI_##P) && (TMC_SPI_##P == SD_MOSI_PIN || TMC_SPI_##P == SD_MISO_PIN || TMC_SPI_##P == SD_SCK_PIN))
 #if HAS_MEDIA && HAS_DRIVER(TMC2130)
-  #if ENABLED(TMC_USE_SW_SPI)
+  #define _IS_HW_SPI(P) (defined(TMC_SPI_##P) && (TMC_SPI_##P == SD_MOSI_PIN || TMC_SPI_##P == SD_MISO_PIN || TMC_SPI_##P == SD_SCK_PIN))
-    #if DISABLED(SOFTWARE_SPI) && (_IS_HW_SPI(MOSI) || _IS_HW_SPI(MISO) || _IS_HW_SPI(SCK))
+  #if DISABLED(SOFTWARE_SPI) && ENABLED(TMC_USE_SW_SPI) && (_IS_HW_SPI(MOSI) || _IS_HW_SPI(MISO) || _IS_HW_SPI(SCK))
-      #error "DUE hardware SPI is required but is incompatible with TMC2130 software SPI. Either disable TMC_USE_SW_SPI or use separate pins for the two SPIs."
+    #error "DUE hardware SPI is required but is incompatible with TMC2130 software SPI. Either disable TMC_USE_SW_SPI or use separate pins for the two SPIs."
-    #endif
+  #endif
-  #elif ENABLED(SOFTWARE_SPI)
+  #if ENABLED(SOFTWARE_SPI) && DISABLED(TMC_USE_SW_SPI)
    #error "DUE software SPI is required but is incompatible with TMC2130 hardware SPI. Enable TMC_USE_SW_SPI to fix."
  #endif
  #undef _IS_HW_SPI
 #endif
 #if ENABLED(FAST_PWM_FAN) || SPINDLE_LASER_FREQUENCY
@@ -19,13 +19,26 @@
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 *
 */
 #pragma once
 /**
- * Support routines for Due
+ * Pins Debugging for DUE
- */
+ *
-
+ *   - NUMBER_PINS_TOTAL
-/**
+ *   - MULTI_NAME_PAD
- * Translation of routines & variables used by pinsDebug.h
+ *   - getPinByIndex(index)
 *   - printPinNameByIndex(index)
 *   - getPinIsDigitalByIndex(index)
 *   - digitalPinToAnalogIndex(pin)
 *   - getValidPinMode(pin)
 *   - isValidPin(pin)
 *   - isAnalogPin(pin)
 *   - digitalRead_mod(pin)
 *   - pwm_status(pin)
 *   - printPinPWM(pin)
 *   - printPinPort(pin)
 *   - printPinNumber(pin)
 *   - printPinAnalog(pin)
 */
 #include "../shared/Marduino.h"
@@ -63,20 +76,20 @@
 #define NUMBER_PINS_TOTAL PINS_COUNT
-#define digitalRead_mod(p) extDigitalRead(p)  // AVR digitalRead disabled PWM before it read the pin
+#define digitalRead_mod(P) extDigitalRead(P)  // AVR digitalRead disabled PWM before it read the pin
-#define PRINT_ARRAY_NAME(x) do{ sprintf_P(buffer, PSTR("%-" STRINGIFY(MAX_NAME_LENGTH) "s"), pin_array[x].name); SERIAL_ECHO(buffer); }while(0)
+#define printPinNameByIndex(x) do{ sprintf_P(buffer, PSTR("%-" STRINGIFY(MAX_NAME_LENGTH) "s"), pin_array[x].name); SERIAL_ECHO(buffer); }while(0)
-#define PRINT_PIN(p) do{ sprintf_P(buffer, PSTR("%02d"), p); SERIAL_ECHO(buffer); }while(0)
+#define printPinNumber(P) do{ sprintf_P(buffer, PSTR("%02d"), P); SERIAL_ECHO(buffer); }while(0)
-#define PRINT_PIN_ANALOG(p) do{ sprintf_P(buffer, PSTR(" (A%2d)  "), DIGITAL_PIN_TO_ANALOG_PIN(pin)); SERIAL_ECHO(buffer); }while(0)
+#define printPinAnalog(P) do{ sprintf_P(buffer, PSTR(" (A%2d)  "), digitalPinToAnalogIndex(P)); SERIAL_ECHO(buffer); }while(0)
-#define GET_ARRAY_PIN(p) pin_array[p].pin
+#define getPinByIndex(x) pin_array[x].pin
-#define GET_ARRAY_IS_DIGITAL(p) pin_array[p].is_digital
+#define getPinIsDigitalByIndex(x) pin_array[x].is_digital
-#define VALID_PIN(pin) (pin >= 0 && pin < int8_t(NUMBER_PINS_TOTAL))
+#define isValidPin(P) (P >= 0 && P < pin_t(NUMBER_PINS_TOTAL))
-#define DIGITAL_PIN_TO_ANALOG_PIN(p) int(p - analogInputToDigitalPin(0))
+#define digitalPinToAnalogIndex(P) int(P - analogInputToDigitalPin(0))
-#define IS_ANALOG(P) WITHIN(P, char(analogInputToDigitalPin(0)), char(analogInputToDigitalPin(NUM_ANALOG_INPUTS - 1)))
+#define isAnalogPin(P) WITHIN(P, pin_t(analogInputToDigitalPin(0)), pin_t(analogInputToDigitalPin(NUM_ANALOG_INPUTS - 1)))
-#define pwm_status(pin) (((g_pinStatus[pin] & 0xF) == PIN_STATUS_PWM) && \
+#define pwm_status(P) (((g_pinStatus[P] & 0xF) == PIN_STATUS_PWM) && \
-                        ((g_APinDescription[pin].ulPinAttribute & PIN_ATTR_PWM) == PIN_ATTR_PWM))
+                        ((g_APinDescription[P].ulPinAttribute & PIN_ATTR_PWM) == PIN_ATTR_PWM))
 #define MULTI_NAME_PAD 14 // space needed to be pretty if not first name assigned to a pin
-bool GET_PINMODE(int8_t pin) {  // 1: output, 0: input
+bool getValidPinMode(const pin_t pin) {  // 1: output, 0: input
  volatile Pio* port = g_APinDescription[pin].pPort;
  uint32_t mask = g_APinDescription[pin].ulPin;
  uint8_t pin_status = g_pinStatus[pin] & 0xF;
@@ -85,14 +98,14 @@ bool GET_PINMODE(int8_t pin) {  // 1: output, 0: input
          || pwm_status(pin));
 }
-void pwm_details(int32_t pin) {
+void printPinPWM(const int32_t pin) {
  if (pwm_status(pin)) {
    uint32_t chan = g_APinDescription[pin].ulPWMChannel;
    SERIAL_ECHOPGM("PWM = ", PWM_INTERFACE->PWM_CH_NUM[chan].PWM_CDTY);
  }
 }
-void print_port(const pin_t) {}
+void printPinPort(const pin_t) {}
 /**
 * DUE Board pin   |  PORT  | Label
@@ -24,41 +24,38 @@
 /**
 * Define SPI Pins: SCK, MISO, MOSI, SS
 *
- * Available chip select pins for HW SPI are 4 10 52 77
+ * Available chip select pins for HW SPI are 4 10 52 77 87
 */
-#if SDSS == 4 || SDSS == 10 || SDSS == 52 || SDSS == 77 || SDSS == 87
+#if SD_SS_PIN == 4 || SD_SS_PIN == 10 || SD_SS_PIN == 52 || SD_SS_PIN == 77 || SD_SS_PIN == 87
-  #if SDSS == 4
+  #define SD_SCK_PIN      76
-    #define SPI_PIN         87
+  #define SD_MISO_PIN     74
-    #define SPI_CHAN         1
+  #define SD_MOSI_PIN     75
  #elif SDSS == 10
    #define SPI_PIN         77
    #define SPI_CHAN         0
  #elif SDSS == 52
    #define SPI_PIN         86
    #define SPI_CHAN         2
  #elif SDSS == 77
    #define SPI_PIN         77
    #define SPI_CHAN         0
  #else
    #define SPI_PIN         87
    #define SPI_CHAN         1
  #endif
  #define SD_SCK_PIN        76
  #define SD_MISO_PIN       74
  #define SD_MOSI_PIN       75
 #else
  // defaults
  #define SOFTWARE_SPI
  #ifndef SD_SCK_PIN
    #define SD_SCK_PIN      52
  #endif
  #ifndef SD_MISO_PIN
    #define SD_MISO_PIN     50
  #endif
  #ifndef SD_MOSI_PIN
    #define SD_MOSI_PIN     51
  #endif
 #endif
-/* A.28, A.29, B.21, C.26, C.29 */
+#if SD_SS_PIN == 4
-#define SD_SS_PIN         SDSS
+  #define SPI_PIN         87
  #define SPI_CHAN         1
 #elif SD_SS_PIN == 10
  #define SPI_PIN         77
  #define SPI_CHAN         0
 #elif SD_SS_PIN == 52
  #define SPI_PIN         86
  #define SPI_CHAN         2
 #elif SD_SS_PIN == 77
  #define SPI_PIN         77
  #define SPI_CHAN         0
 #elif SD_SS_PIN == 87
  #define SPI_PIN         87
  #define SPI_CHAN         1
 #else
  #define SOFTWARE_SPI
  #ifndef SD_SCK_PIN
    #define SD_SCK_PIN    52
  #endif
  #ifndef SD_MISO_PIN
    #define SD_MISO_PIN   50
  #endif
  #ifndef SD_MOSI_PIN
    #define SD_MOSI_PIN   51
  #endif
 #endif
@@ -66,7 +66,7 @@
 #include <U8glib-HAL.h>
-#if ENABLED(FYSETC_MINI_12864)
+#if U8G_SPI_USE_MODE_3
  #define SPISEND_SW_DUE u8g_spiSend_sw_DUE_mode_3
 #else
  #define SPISEND_SW_DUE u8g_spiSend_sw_DUE_mode_0
@@ -96,15 +96,15 @@ uint8_t u8g_com_HAL_DUE_sw_spi_fn(u8g_t *u8g, uint8_t msg, uint8_t arg_val, void
      break;
    case U8G_COM_MSG_CHIP_SELECT:
-      #if ENABLED(FYSETC_MINI_12864)           // LCD SPI is running mode 3 while SD card is running mode 0
+      #if U8G_SPI_USE_MODE_3                        // LCD SPI is running mode 3 while SD card is running mode 0
-        if (arg_val) {                        //   SCK idle state needs to be set to the proper idle state before
+        if (arg_val) {                              // SCK idle state needs to be set to the proper idle state before
-                                               //   the next chip select goes active
+                                                    //  the next chip select goes active
-          u8g_SetPILevel_DUE(u8g, U8G_PI_SCK, 1);  //set SCK to mode 3 idle state before CS goes active
+          u8g_SetPILevel_DUE(u8g, U8G_PI_SCK, 1);   // Set SCK to mode 3 idle state before CS goes active
          u8g_SetPILevel_DUE(u8g, U8G_PI_CS, LOW);
        }
        else {
          u8g_SetPILevel_DUE(u8g, U8G_PI_CS, HIGH);
-          u8g_SetPILevel_DUE(u8g, U8G_PI_SCK, 0); //set SCK to mode 0 idle state after CS goes inactive
+          u8g_SetPILevel_DUE(u8g, U8G_PI_SCK, 0);   // Set SCK to mode 0 idle state after CS goes inactive
        }
      #else
        u8g_SetPILevel_DUE(u8g, U8G_PI_CS, !arg_val);
@@ -11,7 +11,7 @@ if pioutil.is_pio_build():
    if current_OS == 'Windows':
-        Import("env")
+        env = pioutil.env
        # Use bossac.exe on Windows
        env.Replace(
@@ -19,7 +19,7 @@ void sd_mmc_spi_mem_init() {
 }
 inline bool media_ready() {
-  return IS_SD_INSERTED() && !IS_SD_PRINTING() && !IS_SD_FILE_OPEN() && card.isMounted();
+  return IS_SD_MOUNTED() && IS_SD_INSERTED() && !IS_SD_FILE_OPEN() && !IS_SD_PRINTING();
 }
 bool sd_mmc_spi_unload(bool) { return true; }
@@ -32,14 +32,14 @@ Ctrl_status sd_mmc_spi_test_unit_ready() {
  #ifdef DISABLE_DUE_SD_MMC
    return CTRL_NO_PRESENT;
  #endif
-  if (!media_ready()) return CTRL_NO_PRESENT;
+  if (sd_mmc_spi_removal()) return CTRL_NO_PRESENT;
  return CTRL_GOOD;
 }
 // NOTE: This function is defined as returning the address of the last block
 // in the card, which is cardSize() - 1
 Ctrl_status sd_mmc_spi_read_capacity(uint32_t *nb_sector) {
-  if (!media_ready()) return CTRL_NO_PRESENT;
+  if (sd_mmc_spi_removal()) return CTRL_NO_PRESENT;
  *nb_sector = card.diskIODriver()->cardSize() - 1;
  return CTRL_GOOD;
 }
@@ -61,7 +61,7 @@ Ctrl_status sd_mmc_spi_usb_read_10(uint32_t addr, uint16_t nb_sector) {
  #ifdef DISABLE_DUE_SD_MMC
    return CTRL_NO_PRESENT;
  #endif
-  if (!media_ready()) return CTRL_NO_PRESENT;
+  if (sd_mmc_spi_removal()) return CTRL_NO_PRESENT;
  #ifdef DEBUG_MMC
  {
@@ -100,7 +100,7 @@ Ctrl_status sd_mmc_spi_usb_write_10(uint32_t addr, uint16_t nb_sector) {
  #ifdef DISABLE_DUE_SD_MMC
    return CTRL_NO_PRESENT;
  #endif
-  if (!media_ready()) return CTRL_NO_PRESENT;
+  if (sd_mmc_spi_removal()) return CTRL_NO_PRESENT;
  #ifdef DEBUG_MMC
  {
@@ -209,16 +209,17 @@ int MarlinHAL::freeMemory() { return ESP.getFreeHeap(); }
 // ADC
 // ------------------------
-#define ADC1_CHANNEL(pin) ADC1_GPIO ## pin ## _CHANNEL
+// https://docs.espressif.com/projects/esp-idf/en/release-v4.4/esp32/api-reference/peripherals/adc.html
 adc1_channel_t get_channel(int pin) {
  switch (pin) {
-    case 39: return ADC1_CHANNEL(39);
+    case 39: return ADC1_CHANNEL_3;
-    case 36: return ADC1_CHANNEL(36);
+    case 36: return ADC1_CHANNEL_0;
-    case 35: return ADC1_CHANNEL(35);
+    case 35: return ADC1_CHANNEL_7;
-    case 34: return ADC1_CHANNEL(34);
+    case 34: return ADC1_CHANNEL_6;
-    case 33: return ADC1_CHANNEL(33);
+    case 33: return ADC1_CHANNEL_5;
-    case 32: return ADC1_CHANNEL(32);
+    case 32: return ADC1_CHANNEL_4;
    case 37: return ADC1_CHANNEL_1;
    case 38: return ADC1_CHANNEL_2;
  }
  return ADC1_CHANNEL_MAX;
 }
@@ -59,6 +59,7 @@ void setup_endstop_interrupts() {
  TERN_(USE_Z4_MAX,      _ATTACH(Z4_MAX_PIN));
  TERN_(USE_Z4_MIN,      _ATTACH(Z4_MIN_PIN));
  TERN_(USE_Z_MIN_PROBE, _ATTACH(Z_MIN_PROBE_PIN));
  TERN_(USE_CALIBRATION, _ATTACH(CALIBRATION_PIN));
  TERN_(USE_I_MAX,       _ATTACH(I_MAX_PIN));
  TERN_(USE_I_MIN,       _ATTACH(I_MIN_PIN));
  TERN_(USE_J_MAX,       _ATTACH(J_MAX_PIN));
@@ -37,6 +37,10 @@
 // Set pin as output
 #define _SET_OUTPUT(IO)         pinMode(IO, OUTPUT)
 // TODO: Store set modes in an array and use those to get the mode
 #define _IS_OUTPUT(IO)           true
 #define _IS_INPUT(IO)            true
 // Set pin as input with pullup mode
 #define _PULLUP(IO, v)          pinMode(IO, v ? INPUT_PULLUP : INPUT)
@@ -70,6 +74,9 @@
 // Set pin as output and init
 #define OUT_WRITE(IO,V)         do{ _SET_OUTPUT(IO); WRITE(IO,V); }while(0)
 #define IS_OUTPUT(IO)            _IS_OUTPUT(IO)
 #define IS_INPUT(IO)             _IS_INPUT(IO)
 // digitalRead/Write wrappers
 #define extDigitalRead(IO)      digitalRead(IO)
 #define extDigitalWrite(IO,V)   digitalWrite(IO,V)
@@ -152,7 +152,7 @@ void stepperTask(void *parameter) {
    xQueueReceive(dma.queue, &dma.current, portMAX_DELAY);
    dma.rw_pos = 0;
-    const bool using_ftMotion = TERN0(FT_MOTION, ftMotion.cfg.mode);
+    const bool using_ftMotion = TERN0(FT_MOTION, ftMotion.cfg.active);
    while (dma.rw_pos < DMA_SAMPLE_COUNT) {
@@ -22,11 +22,15 @@
 #ifdef ARDUINO_ARCH_ESP32
 #include <WiFi.h>
 #undef ENABLED
 #undef DISABLED
 #include "../../inc/MarlinConfigPre.h"
 #if ALL(WIFISUPPORT, OTASUPPORT)
 #include <WiFi.h>
 #include <ESPmDNS.h>
 #include <WiFiUdp.h>
 #include <ArduinoOTA.h>
@@ -0,0 +1,71 @@
 /**
 * Marlin 3D Printer Firmware
 * Copyright (c) 2024 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
 *
 * Based on Sprinter and grbl.
 * Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 *
 */
 #pragma once
 #error "PINS_DEBUGGING is not yet supported for ESP32!"
 /**
 * Pins Debugging for ESP32
 *
 *   - NUMBER_PINS_TOTAL
 *   - MULTI_NAME_PAD
 *   - getPinByIndex(index)
 *   - printPinNameByIndex(index)
 *   - getPinIsDigitalByIndex(index)
 *   - digitalPinToAnalogIndex(pin)
 *   - getValidPinMode(pin)
 *   - isValidPin(pin)
 *   - isAnalogPin(pin)
 *   - digitalRead_mod(pin)
 *   - pwm_status(pin)
 *   - printPinPWM(pin)
 *   - printPinPort(pin)
 *   - printPinNumber(pin)
 *   - printPinAnalog(pin)
 */
 #define NUMBER_PINS_TOTAL NUM_DIGITAL_PINS
 #define MULTI_NAME_PAD 16 // space needed to be pretty if not first name assigned to a pin
 #define digitalRead_mod(P) extDigitalRead(P)
 #define printPinNameByIndex(x) do{ sprintf_P(buffer, PSTR("%-" STRINGIFY(MAX_NAME_LENGTH) "s"), pin_array[x].name); SERIAL_ECHO(buffer); }while(0)
 #define printPinNumber(P) do{ sprintf_P(buffer, PSTR("%02d"), P); SERIAL_ECHO(buffer); }while(0)
 #define printPinAnalog(P) do{ sprintf_P(buffer, PSTR(" (A%2d)  "), digitalPinToAnalogIndex(P)); SERIAL_ECHO(buffer); }while(0)
 #define getPinByIndex(x) pin_array[x].pin
 #define getPinIsDigitalByIndex(x) pin_array[x].is_digital
 #define isValidPin(P) (P >= 0 && P < pin_t(NUMBER_PINS_TOTAL))
 #define digitalPinToAnalogIndex(P) int(P - analogInputToDigitalPin(0))
 #define isAnalogPin(P) WITHIN(P, pin_t(analogInputToDigitalPin(0)), pin_t(analogInputToDigitalPin(NUM_ANALOG_INPUTS - 1)))
 bool pwm_status(const pin_t) { return false; }
 void printPinPort(const pin_t) {}
 static bool getValidPinMode(const pin_t pin) {
  return isValidPin(pin) && !IS_INPUT(pin);
 }
 void printPinPWM(const int32_t pin) {
  if (pwm_status(pin)) {
    //uint32_t chan = g_APinDescription[pin].ulPWMChannel TODO when fast pwm is operative;
    //SERIAL_ECHOPGM("PWM = ", duty);
  }
 }
@@ -21,7 +21,16 @@
 */
 #pragma once
-#define SD_SS_PIN   SDSS
+#define PIN_SPI_SCK  18
-#define SD_SCK_PIN  18
+#define PIN_SPI_MISO 19
-#define SD_MISO_PIN 19
+#define PIN_SPI_MOSI 23
-#define SD_MOSI_PIN 23
+
 #ifndef SD_SCK_PIN
  #define SD_SCK_PIN  PIN_SPI_SCK
 #endif
 #ifndef SD_MISO_PIN
  #define SD_MISO_PIN PIN_SPI_MISO
 #endif
 #ifndef SD_MOSI_PIN
  #define SD_MOSI_PIN PIN_SPI_MOSI
 #endif
@@ -90,7 +90,7 @@ void HAL_timer_start(const uint8_t timer_num, const uint32_t frequency) {
  config.counter_en  = TIMER_PAUSE;
  config.alarm_en    = TIMER_ALARM_EN;
  config.intr_type   = TIMER_INTR_LEVEL;
-  config.auto_reload = true;
+  config.auto_reload = TIMER_AUTORELOAD_EN;
  // Select and initialize the timer
  timer_init(timer.group, timer.idx, &config);
@@ -53,12 +53,11 @@ typedef uint64_t hal_timer_t;
 #if ENABLED(I2S_STEPPER_STREAM)
  #define STEPPER_TIMER_PRESCALE     1
  #define STEPPER_TIMER_RATE         250000                           // 250khz, 4µs pulses of i2s word clock
  #define STEPPER_TIMER_TICKS_PER_US ((STEPPER_TIMER_RATE) / 1000000) // stepper timer ticks per µs // wrong would be 0.25
 #else
  #define STEPPER_TIMER_PRESCALE     40
  #define STEPPER_TIMER_RATE         ((HAL_TIMER_RATE) / (STEPPER_TIMER_PRESCALE)) // frequency of stepper timer, 2MHz
  #define STEPPER_TIMER_TICKS_PER_US ((STEPPER_TIMER_RATE) / 1000000)              // stepper timer ticks per µs
 #endif
 #define STEPPER_TIMER_TICKS_PER_US   ((STEPPER_TIMER_RATE) / 1000000) // stepper timer ticks per µs
 #define STEP_TIMER_MIN_INTERVAL   8 // minimum time in µs between stepper interrupts
@@ -21,11 +21,12 @@
 */
 #ifdef ARDUINO_ARCH_ESP32
 #include "../../core/serial.h"
 #include "../../inc/MarlinConfigPre.h"
 #if ENABLED(WIFISUPPORT)
 #include "../../core/serial.h"
 #include <WiFi.h>
 #include <ESPmDNS.h>
 #include <ESPAsyncWebServer.h>
@@ -30,69 +30,18 @@
 #include "../../inc/MarlinConfig.h"
 #include "../../core/macros.h"
 #include "../shared/Marduino.h"
 #include "../shared/math_32bit.h"
 #include "../shared/HAL_SPI.h"
 #include "fastio.h"
 #include "timers.h"
 #include "MarlinSerial.h"
 #include <stdint.h>
 //
 // Serial Ports
 //
 #define _MSERIAL(X) MSerial##X
 #define MSERIAL(X) _MSERIAL(X)
 #define NUM_UARTS 4
-#if SERIAL_PORT == -1
+#include "MarlinSerial.h"
  #error "USB Serial is not supported on HC32F460"
 #elif WITHIN(SERIAL_PORT, 1, NUM_UARTS)
  #define MYSERIAL1 MSERIAL(SERIAL_PORT)
 #else
  #define MYSERIAL1 MSERIAL(1) // Dummy port
  static_assert(false, "SERIAL_PORT must be from 1 to " STRINGIFY(NUM_UARTS) ".")
 #endif
 #ifdef SERIAL_PORT_2
  #if SERIAL_PORT_2 == -1
    #error "USB Serial is not supported on HC32F460"
  #elif WITHIN(SERIAL_PORT_2, 1, NUM_UARTS)
    #define MYSERIAL2 MSERIAL(SERIAL_PORT_2)
  #else
    #define MYSERIAL2 MSERIAL(1) // Dummy port
    static_assert(false, "SERIAL_PORT_2 must be from 1 to " STRINGIFY(NUM_UARTS) ".")
  #endif
 #endif
 #ifdef SERIAL_PORT_3
  #if SERIAL_PORT_3 == -1
    #error "USB Serial is not supported on HC32F460"
  #elif WITHIN(SERIAL_PORT_3, 1, NUM_UARTS)
    #define MYSERIAL3 MSERIAL(SERIAL_PORT_3)
  #else
    #define MYSERIAL3 MSERIAL(1) // Dummy port
    static_assert(false, "SERIAL_PORT_3 must be from 1 to " STRINGIFY(NUM_UARTS) ".")
  #endif
 #endif
 #ifdef LCD_SERIAL_PORT
  #if LCD_SERIAL_PORT == -1
    #error "USB Serial is not supported on HC32F460"
  #elif WITHIN(LCD_SERIAL_PORT, 1, NUM_UARTS)
    #define LCD_SERIAL MSERIAL(LCD_SERIAL_PORT)
  #else
    #define LCD_SERIAL MSERIAL(1) // Dummy port
    static_assert(false, "LCD_SERIAL_PORT must be from 1 to " STRINGIFY(NUM_UARTS) ".")
  #endif
  #if HAS_DGUS_LCD
    #define LCD_SERIAL_TX_BUFFER_FREE() LCD_SERIAL.availableForWrite()
  #endif
 #endif
 //
 // Emergency Parser
@@ -114,22 +63,19 @@
 // Misc. Functions
 //
 #ifndef analogInputToDigitalPin
-#define analogInputToDigitalPin(p) (p)
+  #define analogInputToDigitalPin(p) pin_t(p)
 #endif
-#define CRITICAL_SECTION_START        \
+#define CRITICAL_SECTION_START()        \
-  uint32_t primask = __get_PRIMASK(); \
+  const bool irqon = !__get_PRIMASK();  \
-  (void)__iCliRetVal()
+  __disable_irq();                      \
  __DSB();
 #define CRITICAL_SECTION_END()          \
  __DSB();                              \
  if (irqon) __enable_irq();
-#define CRITICAL_SECTION_END \
+#define cli() __disable_irq()
-  if (!primask)              \
+#define sei() __enable_irq()
  (void)__iSeiRetVal()
 // Disable interrupts
 #define cli() noInterrupts()
 // Enable interrupts
 #define sei() interrupts()
 // bss_end alias
 #define __bss_end __bss_end__
@@ -24,6 +24,14 @@
 #include "../../core/serial_hook.h"
 #include <drivers/usart/Usart.h>
 #define SERIAL_INDEX_MIN 1
 #define SERIAL_INDEX_MAX 4
 #include "../shared/serial_ports.h"
 #if defined(LCD_SERIAL_PORT) && ANY(HAS_DGUS_LCD, EXTENSIBLE_UI)
  #define LCD_SERIAL_TX_BUFFER_FREE() LCD_SERIAL.availableForWrite()
 #endif
 // Optionally set uart IRQ priority to reduce overflow errors
 //#define UART_RX_IRQ_PRIO 1
 //#define UART_TX_IRQ_PRIO 1
@@ -11,7 +11,7 @@ The HC32F460 HAL is designed to be generic enough for any HC32F460-based board.
   - Examine the board's main processor. (Refer the naming key in `hc32.ini`.)
   - Extend the `HC32F460C_common` base env for 256K, or `HC32F460E_common` for 512K.
 3. Determine your board's application start address (see [below](#finding-the-application-start-address))
-4. Set `board_build.ld_args.flash_start` to the app start address once you've found it. If your board doesn't use a bootloader, you may be able to use the "ICSP" header or DFU. This document will be updated once we have more information about flashing without a bootloader.
+4. Set `board_upload.offset_address` to the app start address once you've found it. If your board doesn't use a bootloader, you may be able to use the "ICSP" header or DFU. This document will be updated once we have more information about flashing without a bootloader.
 ### Finding the application start address
@@ -8,6 +8,7 @@
 #define _HC32_APP_CONFIG_H_
 #include "../../inc/MarlinConfigPre.h"
 #include "sysclock.h"
 //
 // dev mode
@@ -64,12 +65,8 @@
 // redirect printf to host serial
 #define REDIRECT_PRINTF_TO_SERIAL 1
-// F_CPU must be known at compile time, but on HC32F460 it's not.
+// F_CPU is F_HCLK, as that's the main CPU core's clock.
-// Thus we assume HCLK to be 200MHz, as that's what is configured in
+// see 'sysclock.h' for more information.
-// 'core_hook_sysclock_init' in 'sysclock.cpp'.
+#define F_CPU F_HCLK
 // If you face issues with this assumption, please double-check with the values
 // printed by 'MarlinHAL::HAL_clock_frequencies_dump'.
 // see also: HAL_TIMER_RATE in timers.h
 #define F_CPU 200000000 // 200MHz HCLK
 #endif // _HC32_APP_CONFIG_H_
@@ -101,12 +101,14 @@ void setup_endstop_interrupts() {
  SETUP(Z_MIN_PROBE);
  SETUP(CALIBRATION);
  #undef SETUP
 }
 // Ensure 1 - 10 IRQs are registered
 // Disable some endstops if you encounter this error
-#define ENDSTOPS_INTERRUPTS_COUNT COUNT_ENABLED(USE_X_MAX, USE_X_MIN, USE_X2_MAX, USE_X2_MIN, USE_Y_MAX, USE_Y_MIN, USE_Y2_MAX, USE_Y2_MIN, USE_Z_MAX, USE_Z_MIN, USE_Z2_MAX, USE_Z2_MIN, USE_Z3_MAX, USE_Z3_MIN, USE_Z4_MAX, USE_Z4_MIN, USE_Z_MIN_PROBE)
+#define ENDSTOPS_INTERRUPTS_COUNT COUNT_ENABLED(USE_X_MAX, USE_X_MIN, USE_X2_MAX, USE_X2_MIN, USE_Y_MAX, USE_Y_MIN, USE_Y2_MAX, USE_Y2_MIN, USE_Z_MAX, USE_Z_MIN, USE_Z2_MAX, USE_Z2_MIN, USE_Z3_MAX, USE_Z3_MIN, USE_Z4_MAX, USE_Z4_MIN, USE_Z_MIN_PROBE, USE_CALIBRATION)
 #if ENDSTOPS_INTERRUPTS_COUNT > 10
  #error "Too many endstop interrupts! HC32F460 only supports 10 endstop interrupts."
 #elif ENDSTOPS_INTERRUPTS_COUNT == 0
@@ -94,8 +94,10 @@
    #error "SERIAL_DMA requires USART_RX_DMA_SUPPORT to be enabled in the arduino core."
  #endif
-  // USART_RX_DMA_SUPPORT does not implement core_hook_usart_rx_irq, which is required for the emergency parser
+  // Before arduino core version 1.2.0, USART_RX_DMA_SUPPORT did not implement
-  #if ENABLED(EMERGENCY_PARSER)
+  // core_hook_usart_rx_irq, which is required for the emergency parser.
  // With 1.2.0, this was fixed (see https://github.com/shadow578/framework-arduino-hc32f46x/pull/25).
  #if ENABLED(EMERGENCY_PARSER) && ARDUINO_CORE_VERSION_INT < GET_VERSION_INT(1, 2, 0)
    #error "EMERGENCY_PARSER is not supported with SERIAL_DMA. Please disable either SERIAL_DMA or EMERGENCY_PARSER."
  #endif
@@ -18,41 +18,47 @@
 */
 #pragma once
 /**
 * Pins Debugging for HC32
 *
 *   - NUMBER_PINS_TOTAL
 *   - MULTI_NAME_PAD
 *   - getPinByIndex(index)
 *   - printPinNameByIndex(index)
 *   - getPinIsDigitalByIndex(index)
 *   - digitalPinToAnalogIndex(pin)
 *   - getValidPinMode(pin)
 *   - isValidPin(pin)
 *   - isAnalogPin(pin)
 *   - digitalRead_mod(pin)
 *   - pwm_status(pin)
 *   - printPinPWM(pin)
 *   - printPinPort(pin)
 *   - printPinNumber(pin)
 *   - printPinAnalog(pin)
 */
 #include "../../inc/MarlinConfig.h"
 #include "fastio.h"
 #include <drivers/timera/timera_pwm.h>
 //
 // Translation of routines & variables used by pinsDebug.h
 //
 #ifndef BOARD_NR_GPIO_PINS
  #error "Expected BOARD_NR_GPIO_PINS not found."
 #endif
 #define NUM_DIGITAL_PINS BOARD_NR_GPIO_PINS
 #define NUMBER_PINS_TOTAL BOARD_NR_GPIO_PINS
-#define VALID_PIN(pin) IS_GPIO_PIN(pin)
+#define isValidPin(P) IS_GPIO_PIN(P)
 // Note: pin_array is defined in `Marlin/src/pins/pinsDebug.h`, and since this file is included
 // after it, it is available in this file as well.
-#define GET_ARRAY_PIN(p) pin_t(pin_array[p].pin)
+#define getPinByIndex(x) pin_t(pin_array[x].pin)
-#define digitalRead_mod(p) extDigitalRead(p)
+#define digitalRead_mod(P) extDigitalRead(P)
-#define PRINT_PIN(p)                              \
+
-  do {                                            \
+#define printPinNumber(P) do{ sprintf_P(buffer, PSTR("%3hd "), int16_t(P)); SERIAL_ECHO(buffer); }while(0)
-    sprintf_P(buffer, PSTR("%3hd "), int16_t(p)); \
+#define printPinAnalog(P) do{ sprintf_P(buffer, PSTR(" (A%2d)  "), digitalPinToAnalogIndex(P)); SERIAL_ECHO(buffer); }while(0)
-    SERIAL_ECHO(buffer);                          \
+
-  } while (0)
+#define printPinNameByIndex(x) do{ sprintf_P(buffer, PSTR("%-" STRINGIFY(MAX_NAME_LENGTH) "s"), pin_array[x].name); SERIAL_ECHO(buffer); }while(0)
 #define PRINT_PIN_ANALOG(p)                                               \
  do {                                                                    \
    sprintf_P(buffer, PSTR(" (A%2d)  "), DIGITAL_PIN_TO_ANALOG_PIN(pin)); \
    SERIAL_ECHO(buffer);                                                  \
  } while (0)
 #define PRINT_PORT(p) print_port(p)
 #define PRINT_ARRAY_NAME(x)                                                          \
  do {                                                                               \
    sprintf_P(buffer, PSTR("%-" STRINGIFY(MAX_NAME_LENGTH) "s"), pin_array[x].name); \
    SERIAL_ECHO(buffer);                                                             \
  } while (0)
 #define MULTI_NAME_PAD 21 // Space needed to be pretty if not first name assigned to a pin
@@ -71,14 +77,14 @@
  #define M43_NEVER_TOUCH(Q) (IS_HOST_USART_PIN(Q) || IS_OSC_PIN(Q))
 #endif
-static pin_t DIGITAL_PIN_TO_ANALOG_PIN(pin_t pin) {
+int8_t digitalPinToAnalogIndex(const pin_t pin) {
-  if (!VALID_PIN(pin)) return -1;
+  if (!isValidPin(pin)) return -1;
  const int8_t adc_channel = int8_t(PIN_MAP[pin].adc_info.channel);
  return pin_t(adc_channel);
 }
-static bool IS_ANALOG(pin_t pin) {
+bool isAnalogPin(pin_t pin) {
-  if (!VALID_PIN(pin)) return false;
+  if (!isValidPin(pin)) return false;
  if (PIN_MAP[pin].adc_info.channel != ADC_PIN_INVALID)
    return _GET_MODE(pin) == INPUT_ANALOG && !M43_NEVER_TOUCH(pin);
@@ -86,13 +92,13 @@ static bool IS_ANALOG(pin_t pin) {
  return false;
 }
-static bool GET_PINMODE(const pin_t pin) {
+bool getValidPinMode(const pin_t pin) {
-  return VALID_PIN(pin) && !IS_INPUT(pin);
+  return isValidPin(pin) && !IS_INPUT(pin);
 }
-static bool GET_ARRAY_IS_DIGITAL(const int16_t array_pin) {
+bool getPinIsDigitalByIndex(const int16_t index) {
-  const pin_t pin = GET_ARRAY_PIN(array_pin);
+  const pin_t pin = getPinByIndex(index);
-  return (!IS_ANALOG(pin));
+  return (!isAnalogPin(pin));
 }
 /**
@@ -117,7 +123,7 @@ bool pwm_status(const pin_t pin) {
  return timera_is_unit_initialized(unit) && timera_is_channel_active(unit, channel) && getPinMode(pin) == OUTPUT_PWM;
 }
-void pwm_details(const pin_t pin) {
+void printPinPWM(const pin_t pin) {
  // Get timer assignment for pin
  timera_config_t *unit;
  en_timera_channel_t channel;
@@ -161,7 +167,7 @@ void pwm_details(const pin_t pin) {
  }
 }
-void print_port(pin_t pin) {
+void printPinPort(pin_t pin) {
  const char port = 'A' + char(pin >> 4); // Pin div 16
  const int16_t gbit = PIN_MAP[pin].bit_pos;
  char buffer[8];
@@ -26,64 +26,144 @@
 #ifdef ARDUINO_ARCH_HC32
 // Get BOARD_XTAL_FREQUENCY from configuration / pins
 #include "../../inc/MarlinConfig.h"
 #include "sysclock.h"
 #include <core_hooks.h>
 #include <drivers/sysclock/sysclock_util.h>
 /***
 * @brief Automatically calculate M, N, P values for the MPLL to reach a target frequency.
 * @param input_frequency The input frequency.
 * @param target_frequency The target frequency.
 * @return The MPLL configuration structure. Q and R are not set.
 *
 * @note
 * Simplified MPLL block diagram, with intermediary clocks (1) = VCO_in, (2) = VCO_out:
 *
 *  INPUT -> [/ M] -(1)-> [* N] -(2)-|-> [/ P] -> MPLL-P
 */
 constexpr stc_clk_mpll_cfg_t get_mpll_config(double input_frequency, double target_frequency) {
  // PLL input clock divider: M in [1, 24]
  for (uint32_t M = 1; M <= 24; M++) {
    double f_vco_in = input_frequency / M;
    // 1 <= VCO_in <= 25 MHz
    if (f_vco_in < 1e6 || f_vco_in > 25e6) continue;
    // VCO multiplier: N in [20, 480]
    for (uint32_t N = 20; N <= 480; N++) {
      double f_vco_out = f_vco_in * N;
      // 240 <= VCO_out <= 480 MHz
      if (f_vco_out < 240e6 || f_vco_out > 480e6) continue;
      // Output "P" divider: P in [2, 16]
      for (uint32_t P = 2; P <= 16; P++) {
        double f_calculated_out = f_vco_out / P;
        if (f_calculated_out == target_frequency) {
          // Found a match, return it
          return {
            .PllpDiv = P,
            .PllqDiv = P, // Don't care for Q and R
            .PllrDiv = P, // "
            .plln =    N,
            .pllmDiv = M
          };
        }
      }
    }
  }
  // If no valid M, N, P found, return invalid config
  return { 0, 0, 0, 0, 0 };
 }
 /**
 * @brief Get the division factor required to get the target frequency from the input frequency.
 * @tparam input_freq The input frequency.
 * @tparam target_freq The target frequency.
 * @return The division factor.
 */
 template <uint32_t input_freq, uint32_t target_freq>
 constexpr en_clk_sysclk_div_factor_t get_division_factor() {
  // Calculate the divider to get the target frequency
  constexpr float fdivider = static_cast<float>(input_freq) / static_cast<float>(target_freq);
  constexpr int divider = static_cast<int>(fdivider);
  // divider must be an integer
  static_assert(fdivider == divider, "Target frequency not achievable, divider must be an integer");
  // divider must be between 1 and 64 (enum range), and must be a power of 2
  static_assert(divider >= 1 && divider <= 64, "Invalid divider, out of range");
  static_assert((divider & (divider - 1)) == 0, "Invalid divider, not a power of 2");
  // return the divider
  switch (divider) {
    case 1:  return ClkSysclkDiv1;
    case 2:  return ClkSysclkDiv2;
    case 4:  return ClkSysclkDiv4;
    case 8:  return ClkSysclkDiv8;
    case 16: return ClkSysclkDiv16;
    case 32: return ClkSysclkDiv32;
    case 64: return ClkSysclkDiv64;
  }
 }
 /**
 * @brief Validate the runtime clocks match the expected values.
 */
 void validate_system_clocks() {
  #define CLOCK_ASSERT(expected, actual)                  \
    if (expected != actual) {                             \
      SERIAL_ECHOPGM(                                     \
        "Clock Mismatch for " #expected ": "              \
        "expected ", expected,                            \
        ", got ", actual                                  \
        );                                                \
      CORE_ASSERT_FAIL("Clock Mismatch: " #expected);     \
    }
  update_system_clock_frequencies();
  CLOCK_ASSERT(F_SYSTEM_CLOCK, SYSTEM_CLOCK_FREQUENCIES.system);
  CLOCK_ASSERT(F_HCLK, SYSTEM_CLOCK_FREQUENCIES.hclk);
  CLOCK_ASSERT(F_EXCLK, SYSTEM_CLOCK_FREQUENCIES.exclk);
  CLOCK_ASSERT(F_PCLK0, SYSTEM_CLOCK_FREQUENCIES.pclk0);
  CLOCK_ASSERT(F_PCLK1, SYSTEM_CLOCK_FREQUENCIES.pclk1);
  CLOCK_ASSERT(F_PCLK2, SYSTEM_CLOCK_FREQUENCIES.pclk2);
  CLOCK_ASSERT(F_PCLK3, SYSTEM_CLOCK_FREQUENCIES.pclk3);
  CLOCK_ASSERT(F_PCLK4, SYSTEM_CLOCK_FREQUENCIES.pclk4);
 }
 /**
 * @brief Configure HC32 system clocks.
 *
 * This function is called by the Arduino core early in the startup process, before setup() is called.
 * It is used to configure the system clocks to the desired state.
 *
 * See https://github.com/MarlinFirmware/Marlin/pull/27099 for more information.
 */
 void core_hook_sysclock_init() {
  // Set wait cycles, as we are about to switch to 200 MHz HCLK
  sysclock_configure_flash_wait_cycles();
  sysclock_configure_sram_wait_cycles();
-  // Configure MPLLp to 200 MHz output, with different settings depending on XTAL availability
+  // Select MPLL input frequency based on clock availability
-  #if BOARD_XTAL_FREQUENCY == 8000000 // 8 MHz XTAL
+  #if BOARD_XTAL_FREQUENCY == 8000000 || BOARD_XTAL_FREQUENCY == 16000000 // 8 MHz or 16 MHz XTAL
-    // - M = 1   => 8 MHz / 1 = 8 MHz
+    constexpr uint32_t mpll_input_clock = BOARD_XTAL_FREQUENCY;
    // - N = 50  => 8 MHz * 50 = 400 MHz
    // - P = 2   => 400 MHz / 2 = 200 MHz (sysclk)
    // - Q,R = 4 => 400 MHz / 4 = 100 MHz (dont care)
    stc_clk_mpll_cfg_t pllConf = {
        .PllpDiv = 2u, // P
        .PllqDiv = 4u, // Q
        .PllrDiv = 4u, // R
        .plln = 50u,   // N
        .pllmDiv = 1u, // M
    };
    sysclock_configure_xtal();
    sysclock_configure_mpll(ClkPllSrcXTAL, &pllConf);
  #elif BOARD_XTAL_FREQUENCY == 16000000 // 16 MHz XTAL
    // - M = 1   => 16 MHz / 1 = 16 MHz
    // - N = 50  => 16 MHz * 25 = 400 MHz
    // - P = 2   => 400 MHz / 2 = 200 MHz (sysclk)
    // - Q,R = 4 => 400 MHz / 4 = 100 MHz (dont care)
    stc_clk_mpll_cfg_t pllConf = {
        .PllpDiv = 2u, // P
        .PllqDiv = 4u, // Q
        .PllrDiv = 4u, // R
        .plln = 50u,   // N
        .pllmDiv = 1u, // M
    };
    sysclock_configure_xtal();
    sysclock_configure_mpll(ClkPllSrcXTAL, &pllConf);
-  #warning "HC32F460 with 16 MHz XTAL has not been tested."
+    #if BOARD_XTAL_FREQUENCY == 16000000
      #warning "HC32F460 with 16 MHz XTAL has not been tested."
    #endif
  #else // HRC (16 MHz)
-    // - M = 1   => 16 MHz / 1 = 16 MHz
+
-    // - N = 25  => 16 MHz * 25 = 400 MHz
+    constexpr uint32_t mpll_input_clock = 16000000;
-    // - P = 2   => 400 MHz / 2 = 200 MHz (sysclk)
+
    // - Q,R = 4 => 400 MHz / 4 = 100 MHz (dont care)
    stc_clk_mpll_cfg_t pllConf = {
        .PllpDiv = 2u, // P
        .PllqDiv = 4u, // Q
        .PllrDiv = 4u, // R
        .plln = 25u,   // N
        .pllmDiv = 1u, // M
    };
    sysclock_configure_hrc();
    sysclock_configure_mpll(ClkPllSrcHRC, &pllConf);
    // HRC could have been configured by ICG to 20 MHz
    // TODO: handle gracefully if HRC is not 16 MHz
@@ -91,29 +171,56 @@ void core_hook_sysclock_init() {
      panic("HRC is not 16 MHz");
    }
-    #ifdef BOARD_XTAL_FREQUENCY
+    #if defined(BOARD_XTAL_FREQUENCY)
      #warning "No valid XTAL frequency defined, falling back to HRC."
    #endif
  #endif
-  // sysclk is now configured according to F_CPU (i.e., 200MHz PLL output)
+  // Automagically calculate MPLL configuration
-  constexpr uint32_t sysclock = F_CPU;
+  constexpr stc_clk_mpll_cfg_t pllConf = get_mpll_config(mpll_input_clock, F_SYSTEM_CLOCK);
  static_assert(pllConf.pllmDiv != 0 && pllConf.plln != 0 && pllConf.PllpDiv != 0, "MPLL auto-configuration failed");
  sysclock_configure_mpll(ClkPllSrcXTAL, &pllConf);
-  // Setup clock divisors for sysclk = 200 MHz
+  // Setup clock divisors
  // Note: PCLK1 is used for step+temp timers, and need to be kept at 50 MHz (until there is a better solution)
  constexpr stc_clk_sysclk_cfg_t sysClkConf = {
-      .enHclkDiv = ClkSysclkDiv1,  // HCLK  = 200 MHz (CPU)
+    .enHclkDiv  = get_division_factor<F_SYSTEM_CLOCK, F_HCLK>(),
-      .enExclkDiv = ClkSysclkDiv2, // EXCLK = 100 MHz (SDIO)
+    .enExclkDiv = get_division_factor<F_SYSTEM_CLOCK, F_EXCLK>(),
-      .enPclk0Div = ClkSysclkDiv2, // PCLK0 = 100 MHz (Timer6 (not used))
+    .enPclk0Div = get_division_factor<F_SYSTEM_CLOCK, F_PCLK0>(),
-      .enPclk1Div = ClkSysclkDiv4, // PCLK1 = 50 MHz (USART, SPI, I2S, Timer0 (step+temp), TimerA (Servo))
+    .enPclk1Div = get_division_factor<F_SYSTEM_CLOCK, F_PCLK1>(),
-      .enPclk2Div = ClkSysclkDiv8, // PCLK2 = 25 MHz (ADC)
+    .enPclk2Div = get_division_factor<F_SYSTEM_CLOCK, F_PCLK2>(),
-      .enPclk3Div = ClkSysclkDiv8, // PCLK3 = 25 MHz (I2C, WDT)
+    .enPclk3Div = get_division_factor<F_SYSTEM_CLOCK, F_PCLK3>(),
-      .enPclk4Div = ClkSysclkDiv2, // PCLK4 = 100 MHz (ADC ctl)
+    .enPclk4Div = get_division_factor<F_SYSTEM_CLOCK, F_PCLK4>(),
  };
  sysclock_set_clock_dividers(&sysClkConf);
  // Set power mode, before switch
  power_mode_update_pre(F_SYSTEM_CLOCK);
  // Switch to MPLL-P as system clock source
  CLK_SetSysClkSource(CLKSysSrcMPLL);
  // Set power mode, after switch
  power_mode_update_post(F_SYSTEM_CLOCK);
  // Verify clocks match expected values (at runtime)
  #if ENABLED(MARLIN_DEV_MODE) || ENABLED(ALWAYS_VALIDATE_CLOCKS)
    validate_system_clocks();
  #endif
  // Verify clock configuration (at compile time)
  #if ARDUINO_CORE_VERSION_INT >= GET_VERSION_INT(1, 2, 0)
    assert_mpll_config_valid<
      mpll_input_clock,
      pllConf.pllmDiv,
      pllConf.plln,
      pllConf.PllpDiv,
      pllConf.PllqDiv,
      pllConf.PllrDiv
    >();
    assert_system_clocks_valid<
-      sysclock,
+      F_SYSTEM_CLOCK,
      sysClkConf.enHclkDiv,
      sysClkConf.enPclk0Div,
      sysClkConf.enPclk1Div,
@@ -122,18 +229,14 @@ void core_hook_sysclock_init() {
      sysClkConf.enPclk4Div,
      sysClkConf.enExclkDiv
    >();
    static_assert(get_mpll_output_clock(
      mpll_input_clock,
      pllConf.pllmDiv,
      pllConf.plln,
      pllConf.PllpDiv
    ) == F_SYSTEM_CLOCK, "actual MPLL output clock does not match F_SYSTEM_CLOCK");
  #endif
  sysclock_set_clock_dividers(&sysClkConf);
  // Set power mode
  power_mode_update_pre(sysclock);
  // Switch to MPLL as sysclk source
  CLK_SetSysClkSource(CLKSysSrcMPLL);
  // Set power mode
  power_mode_update_post(sysclock);
 }
 #endif // ARDUINO_ARCH_HC32
@@ -0,0 +1,65 @@
 /**
 * Marlin 3D Printer Firmware
 * Copyright (c) 2024 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
 *
 * Based on Sprinter and grbl.
 * Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 *
 */
 #pragma once
 /**
 * HC32F460 system clock configuration.
 *
 * With the HC32 HAL, the various peripheral clocks (including the CPU clock) are derived
 * from the main PLL (MPLL-P) output (referred to at F_SYSTEM_CLOCK).
 *
 * F_SYSTEM_CLOCK is the target frequency of the main PLL, and the PLL is automatically configured
 * to achieve this frequency.
 *
 * The peripheral clocks are the result of integer division of F_SYSTEM_CLOCK.
 * Their target frequencies are defined here, and the required division factors are calculated automatically.
 * Note that the division factor must be a power of 2 between 1 and 64.
 * If the target frequency is not achievable, a compile-time error will be generated.
 *
 * Additionally, there are interdependencies between the peripheral clocks, which are described in
 * Section 4.4 "Working Clock Specifications" of the HC32F460 Reference Manual.
 * With Arduino core >= 1.2.0, these interdependencies are checked at compile time.
 * On earlier versions, you are on your own.
 *
 * For all clock frequencies, they can be checked at runtime by enabling the 'ALWAYS_VALIDATE_CLOCKS' define.
 * In MARLIN_DEV_MODE, they will also be printed to the serial console by 'MarlinHAL::HAL_clock_frequencies_dump'.
 *
 * See https://github.com/MarlinFirmware/Marlin/pull/27099 for more information.
 */
 // Target peripheral clock frequencies, must be integer divisors of F_SYSTEM_CLOCK.
 // Changing the frequency here will automagically update everything else.
 #define F_HCLK  200000000UL  // 200 MHz; CPU
 #define F_EXCLK (F_HCLK / 2) // 100 MHz; SDIO
 #define F_PCLK0 (F_HCLK / 2) // 100 MHz; Timer6 (unused)
 #define F_PCLK1 (F_HCLK / 4) //  50 MHz; USART, SPI, Timer0 (step + temp), TimerA (Servo)
 #define F_PCLK2 (F_HCLK / 8) //  25 MHz; ADC Sampling
 #define F_PCLK3 (F_HCLK / 8) //  25 MHz; I2C, WDT
 #define F_PCLK4 (F_HCLK / 2) // 100 MHz; ADC Control
 // MPLL-P clock target frequency. This must be >= the highest peripheral clock frequency.
 // PLL config is automatically calculated based on this value.
 #define F_SYSTEM_CLOCK F_HCLK
 // The Peripheral clocks are only checked at runtime if this is enabled OR MARLIN_DEV_MODE is enabled.
 // Compile time checks are always performed with Arduino core version >= 1.2.0.
 #define ALWAYS_VALIDATE_CLOCKS 1
@@ -20,6 +20,7 @@
 #pragma once
 #include <stdint.h>
 #include <Timer0.h>
 #include "sysclock.h"
 //
 // Timer Types
@@ -42,17 +43,15 @@ extern Timer0 step_timer;
 * HAL_TIMER_RATE must be known at compile time since it's used to calculate
 * STEPPER_TIMER_RATE, which is used in 'constexpr' calculations.
 * On the HC32F460 the timer rate depends on PCLK1, which is derived from the
- * system clock configured at runtime. As a workaround, we use the existing
+ * system clock configured at runtime.
- * assumption of a 200MHz clock, defining F_CPU as 200000000, then configure PCLK1
+ * Thus we use the 'F_PCLK1' constant defined in 'sysclock.h'.
 * as F_CPU with a divider of 4 in 'sysclock.cpp::core_hook_sysclock_init'.
 *
- * If you face issues with this assumption, please double-check with the values
+ * See https://github.com/MarlinFirmware/Marlin/pull/27099 for more information.
 * printed by 'MarlinHAL::HAL_clock_frequencies_dump'.
 *
- * TODO: If the 'constexpr' requirement is ever lifted, use TIMER0_BASE_FREQUENCY instead
+ * NOTE: If the 'constexpr' requirement is ever lifted, TIMER0_BASE_FREQUENCY could
 * be used instead. Tho this would probably not make any noticable difference.
 */
-#define HAL_TIMER_RATE (F_CPU / 4) // i.e., 50MHz
+#define HAL_TIMER_RATE F_PCLK1
 //#define HAL_TIMER_RATE TIMER0_BASE_FREQUENCY
 // Temperature timer
 #define TEMP_TIMER_NUM        (&temp_timer)
@@ -82,7 +82,7 @@ static inline uint8_t swSpiTransfer_mode_3(uint8_t b, const uint8_t spi_speed, c
 }
 static void u8g_sw_spi_shift_out(uint8_t val) {
-  #if ANY(FYSETC_MINI_12864, MKS_MINI_12864)
+  #if U8G_SPI_USE_MODE_3
    swSpiTransfer_mode_3(val, SPI_speed);
  #else
    swSpiTransfer_mode_0(val, SPI_speed);
@@ -116,15 +116,15 @@ uint8_t u8g_com_HAL_HC32_sw_spi_fn(u8g_t *u8g, uint8_t msg, uint8_t arg_val, voi
      break;
    case U8G_COM_MSG_CHIP_SELECT:
-      #if ANY(FYSETC_MINI_12864, MKS_MINI_12864) // This LCD SPI is running mode 3 while SD card is running mode 0
+      #if U8G_SPI_USE_MODE_3        // This LCD SPI is running mode 3 while SD card is running mode 0
-        if (arg_val) {                           // SCK idle state needs to be set to the proper idle state before
+        if (arg_val) {              // SCK idle state needs to be set to the proper idle state before
-                                                 // the next chip select goes active
+                                    //  the next chip select goes active
-          WRITE(DOGLCD_SCK, HIGH);               // Set SCK to mode 3 idle state before CS goes active
+          WRITE(DOGLCD_SCK, HIGH);  // Set SCK to mode 3 idle state before CS goes active
          WRITE(DOGLCD_CS, LOW);
        }
        else {
          WRITE(DOGLCD_CS, HIGH);
-          WRITE(DOGLCD_SCK, LOW);  // Set SCK to mode 0 idle state after CS goes inactive
+          WRITE(DOGLCD_SCK, LOW);   // Set SCK to mode 0 idle state after CS goes inactive
        }
      #else
        WRITE(DOGLCD_CS, !arg_val);
@@ -52,7 +52,7 @@ uint8_t MarlinHAL::active_ch = 0;
 uint16_t MarlinHAL::adc_value() {
  const pin_t pin = analogInputToDigitalPin(active_ch);
-  if (!VALID_PIN(pin)) return 0;
+  if (!isValidPin(pin)) return 0;
  return uint16_t((Gpio::get(pin) >> 2) & 0x3FF); // return 10bit value as Marlin expects
 }
@@ -49,28 +49,28 @@ extern "C" void delay(const int msec) {
 // IO functions
 // As defined by Arduino INPUT(0x0), OUTPUT(0x1), INPUT_PULLUP(0x2)
 void pinMode(const pin_t pin, const uint8_t mode) {
-  if (!VALID_PIN(pin)) return;
+  if (!isValidPin(pin)) return;
  Gpio::setMode(pin, mode);
 }
 void digitalWrite(pin_t pin, uint8_t pin_status) {
-  if (!VALID_PIN(pin)) return;
+  if (!isValidPin(pin)) return;
  Gpio::set(pin, pin_status);
 }
 bool digitalRead(pin_t pin) {
-  if (!VALID_PIN(pin)) return false;
+  if (!isValidPin(pin)) return false;
  return Gpio::get(pin);
 }
 void analogWrite(pin_t pin, int pwm_value) {  // 1 - 254: pwm_value, 0: LOW, 255: HIGH
-  if (!VALID_PIN(pin)) return;
+  if (!isValidPin(pin)) return;
  Gpio::set(pin, pwm_value);
 }
 uint16_t analogRead(pin_t adc_pin) {
-  if (!VALID_PIN(DIGITAL_PIN_TO_ANALOG_PIN(adc_pin))) return 0;
+  if (!isValidPin(digitalPinToAnalogIndex(adc_pin))) return 0;
-  return Gpio::get(DIGITAL_PIN_TO_ANALOG_PIN(adc_pin));
+  return Gpio::get(digitalPinToAnalogIndex(adc_pin));
 }
 char *dtostrf(double __val, signed char __width, unsigned char __prec, char *__s) {
@@ -37,29 +37,29 @@ constexpr uint8_t NUM_ANALOG_INPUTS = 16;
 constexpr uint8_t analog_offset = NUM_DIGITAL_PINS - NUM_ANALOG_INPUTS;
 // Get the digital pin for an analog index
-constexpr pin_t analogInputToDigitalPin(const int8_t p) {
+constexpr pin_t analogInputToDigitalPin(const int8_t a) {
-  return (WITHIN(p, 0, NUM_ANALOG_INPUTS) ? analog_offset + p : P_NC);
+  return (WITHIN(a, 0, NUM_ANALOG_INPUTS - 1) ? analog_offset + a : P_NC);
 }
 // Get the analog index for a digital pin
-constexpr int8_t DIGITAL_PIN_TO_ANALOG_PIN(const pin_t p) {
+constexpr int8_t digitalPinToAnalogIndex(const pin_t pin) {
-  return (WITHIN(p, analog_offset, NUM_DIGITAL_PINS) ? p - analog_offset : P_NC);
+  return (WITHIN(pin, analog_offset, NUM_DIGITAL_PINS - 1) ? pin - analog_offset : P_NC);
 }
 // Return the index of a pin number
 constexpr int16_t GET_PIN_MAP_INDEX(const pin_t pin) { return pin; }
 // Test whether the pin is valid
-constexpr bool VALID_PIN(const pin_t p) { return WITHIN(p, 0, NUM_DIGITAL_PINS); }
+constexpr bool isValidPin(const pin_t pin) { return WITHIN(pin, 0, NUM_DIGITAL_PINS - 1); }
 // Test whether the pin is PWM
-constexpr bool PWM_PIN(const pin_t p) { return false; }
+constexpr bool PWM_PIN(const pin_t) { return false; }
 // Test whether the pin is interruptible
-constexpr bool INTERRUPT_PIN(const pin_t p) { return false; }
+constexpr bool INTERRUPT_PIN(const pin_t) { return false; }
 // Get the pin number at the given index
-constexpr pin_t GET_PIN_MAP_PIN(const int16_t ind) { return ind; }
+constexpr pin_t GET_PIN_MAP_PIN(const int16_t index) { return pin_t(index); }
 // Parse a G-code word into a pin index
 int16_t PARSED_PIN_INDEX(const char code, const int16_t dval);
@@ -19,30 +19,50 @@
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 *
 */
 #pragma once
 /**
- * Support routines for X86_64
+ * Pins Debugging for Linux Native
- */
+ *
-
+ *   - NUMBER_PINS_TOTAL
-/**
+ *   - MULTI_NAME_PAD
- * Translation of routines & variables used by pinsDebug.h
+ *   - getPinByIndex(index)
 *   - printPinNameByIndex(index)
 *   - getPinIsDigitalByIndex(index)
 *   - digitalPinToAnalogIndex(pin)
 *   - getValidPinMode(pin)
 *   - isValidPin(pin)
 *   - isAnalogPin(pin)
 *   - digitalRead_mod(pin)
 *   - pwm_status(pin)
 *   - printPinPWM(pin)
 *   - printPinPort(pin)
 *   - printPinNumber(pin)
 *   - printPinAnalog(pin)
 */
 #define NUMBER_PINS_TOTAL   NUM_DIGITAL_PINS
 #define IS_ANALOG(P)        (DIGITAL_PIN_TO_ANALOG_PIN(P) >= 0 ? 1 : 0)
 #define digitalRead_mod(p)  digitalRead(p)
 #define GET_ARRAY_PIN(p)    pin_array[p].pin
 #define PRINT_ARRAY_NAME(x) do{ sprintf_P(buffer, PSTR("%-" STRINGIFY(MAX_NAME_LENGTH) "s"), pin_array[x].name); SERIAL_ECHO(buffer); }while(0)
 #define PRINT_PIN(p)        do{ sprintf_P(buffer, PSTR("%3d "), p); SERIAL_ECHO(buffer); }while(0)
 #define PRINT_PIN_ANALOG(p) do{ sprintf_P(buffer, PSTR(" (A%2d)  "), DIGITAL_PIN_TO_ANALOG_PIN(pin)); SERIAL_ECHO(buffer); }while(0)
 #define MULTI_NAME_PAD      16 // space needed to be pretty if not first name assigned to a pin
 #define getPinByIndex(x) pin_array[x].pin
 #define printPinNameByIndex(x) do{ sprintf_P(buffer, PSTR("%-" STRINGIFY(MAX_NAME_LENGTH) "s"), pin_array[x].name); SERIAL_ECHO(buffer); }while(0)
 // active ADC function/mode/code values for PINSEL registers
-constexpr int8_t ADC_pin_mode(pin_t pin) { return -1; }
+constexpr int8_t ADC_pin_mode(const pin_t) { return -1; }
-int8_t get_pin_mode(const pin_t pin) { return VALID_PIN(pin) ? 0 : -1; }
+// The pin and index are the same on this platform
 bool getPinIsDigitalByIndex(const pin_t pin) {
  return (!isAnalogPin(pin) || get_pin_mode(pin) != ADC_pin_mode(pin));
 }
-bool GET_PINMODE(const pin_t pin) {
+#define isAnalogPin(P) (digitalPinToAnalogIndex(P) >= 0)
 #define digitalRead_mod(P) digitalRead(P)
 int8_t get_pin_mode(const pin_t pin) { return isValidPin(pin) ? 0 : -1; }
 bool getValidPinMode(const pin_t pin) {
  const int8_t pin_mode = get_pin_mode(pin);
  if (pin_mode == -1 || pin_mode == ADC_pin_mode(pin)) // Invalid pin or active analog pin
    return false;
@@ -50,11 +70,11 @@ bool GET_PINMODE(const pin_t pin) {
  return (Gpio::getMode(pin) != 0); // Input/output state
 }
-bool GET_ARRAY_IS_DIGITAL(const pin_t pin) {
+void printPinPWM(const pin_t) {}
  return (!IS_ANALOG(pin) || get_pin_mode(pin) != ADC_pin_mode(pin));
 }
 void pwm_details(const pin_t pin) {}
 bool pwm_status(const pin_t) { return false; }
-void print_port(const pin_t) {}
+void printPinPort(const pin_t) {}
 #define printPinNumber(P) do{ sprintf_P(buffer, PSTR("%3d "), P); SERIAL_ECHO(buffer); }while(0)
 #define printPinAnalog(P) do{ sprintf_P(buffer, PSTR(" (A%2d)  "), digitalPinToAnalogIndex(P)); SERIAL_ECHO(buffer); }while(0)
@@ -28,12 +28,6 @@
                        // spiBeginTransaction.
 #endif
 // Onboard SD
 //#define SD_SCK_PIN     P0_07
 //#define SD_MISO_PIN    P0_08
 //#define SD_MOSI_PIN    P0_09
 //#define SD_SS_PIN      P0_06
 // External SD
 #ifndef SD_SCK_PIN
  #define SD_SCK_PIN        50
@@ -44,9 +38,3 @@
 #ifndef SD_MOSI_PIN
  #define SD_MOSI_PIN       52
 #endif
 #ifndef SD_SS_PIN
  #define SD_SS_PIN         53
 #endif
 #ifndef SDSS
  #define SDSS       SD_SS_PIN
 #endif
@@ -35,8 +35,6 @@
 #include <CDCSerial.h>
 #include <usb/mscuser.h>
 DefaultSerial1 USBSerial(false, UsbSerial);
 uint32_t MarlinHAL::adc_result = 0;
 pin_t MarlinHAL::adc_pin = 0;
@@ -38,72 +38,15 @@ extern "C" volatile uint32_t _millis;
 #include "../shared/math_32bit.h"
 #include "../shared/HAL_SPI.h"
 #include "fastio.h"
 #include "MarlinSerial.h"
 #include <adc.h>
 #include <pinmapping.h>
 #include <CDCSerial.h>
-// ------------------------
+//
-// Serial ports
+// Serial Ports
-// ------------------------
+//
-typedef ForwardSerial1Class< decltype(UsbSerial) > DefaultSerial1;
+#include "MarlinSerial.h"
 extern DefaultSerial1 USBSerial;
 #define _MSERIAL(X) MSerial##X
 #define MSERIAL(X) _MSERIAL(X)
 #if SERIAL_PORT == -1
  #define MYSERIAL1 USBSerial
 #elif WITHIN(SERIAL_PORT, 0, 3)
  #define MYSERIAL1 MSERIAL(SERIAL_PORT)
 #else
  #error "SERIAL_PORT must be from 0 to 3. You can also use -1 if the board supports Native USB."
 #endif
 #ifdef SERIAL_PORT_2
  #if SERIAL_PORT_2 == -1
    #define MYSERIAL2 USBSerial
  #elif WITHIN(SERIAL_PORT_2, 0, 3)
    #define MYSERIAL2 MSERIAL(SERIAL_PORT_2)
  #else
    #error "SERIAL_PORT_2 must be from 0 to 3. You can also use -1 if the board supports Native USB."
  #endif
 #endif
 #ifdef SERIAL_PORT_3
  #if SERIAL_PORT_3 == -1
    #define MYSERIAL3 USBSerial
  #elif WITHIN(SERIAL_PORT_3, 0, 3)
    #define MYSERIAL3 MSERIAL(SERIAL_PORT_3)
  #else
    #error "SERIAL_PORT_3 must be from 0 to 3. You can also use -1 if the board supports Native USB."
  #endif
 #endif
 #ifdef MMU2_SERIAL_PORT
  #if MMU2_SERIAL_PORT == -1
    #define MMU2_SERIAL USBSerial
  #elif WITHIN(MMU2_SERIAL_PORT, 0, 3)
    #define MMU2_SERIAL MSERIAL(MMU2_SERIAL_PORT)
  #else
    #error "MMU2_SERIAL_PORT must be from 0 to 3. You can also use -1 if the board supports Native USB."
  #endif
 #endif
 #ifdef LCD_SERIAL_PORT
  #if LCD_SERIAL_PORT == -1
    #define LCD_SERIAL USBSerial
  #elif WITHIN(LCD_SERIAL_PORT, 0, 3)
    #define LCD_SERIAL MSERIAL(LCD_SERIAL_PORT)
  #else
    #error "LCD_SERIAL_PORT must be from 0 to 3. You can also use -1 if the board supports Native USB."
  #endif
  #if HAS_DGUS_LCD
    #define LCD_SERIAL_TX_BUFFER_FREE() LCD_SERIAL.available()
  #endif
 #endif
 //
 // Interrupts
@@ -137,12 +80,12 @@ extern DefaultSerial1 USBSerial;
 //
 // Test whether the pin is valid
-constexpr bool VALID_PIN(const pin_t pin) {
+constexpr bool isValidPin(const pin_t pin) {
  return LPC176x::pin_is_valid(pin);
 }
 // Get the analog index for a digital pin
-constexpr int8_t DIGITAL_PIN_TO_ANALOG_PIN(const pin_t pin) {
+constexpr int8_t digitalPinToAnalogIndex(const pin_t pin) {
  return (LPC176x::pin_is_valid(pin) && LPC176x::pin_has_adc(pin)) ? pin : -1;
 }
@@ -159,7 +102,7 @@ constexpr pin_t GET_PIN_MAP_PIN(const int16_t index) {
 // Parse a G-code word into a pin index
 int16_t PARSED_PIN_INDEX(const char code, const int16_t dval);
 // P0.6 thru P0.9 are for the onboard SD card
-#define HAL_SENSITIVE_PINS P0_06, P0_07, P0_08, P0_09,
+#define HAL_SENSITIVE_PINS P0_06, P0_07, P0_08, P0_09
 // ------------------------
 // Defines
@@ -25,6 +25,8 @@
 #include "../../inc/MarlinConfig.h"
 DefaultSerial1 USBSerial(false, UsbSerial);
 #if USING_HW_SERIAL0
  MarlinSerial _MSerial0(LPC_UART0);
  MSerialT MSerial0(true, _MSerial0);
@@ -21,6 +21,7 @@
 */
 #pragma once
 #include <CDCSerial.h>
 #include <HardwareSerial.h>
 #include <WString.h>
@@ -30,6 +31,18 @@
 #endif
 #include "../../core/serial_hook.h"
 typedef ForwardSerial1Class< decltype(UsbSerial) > DefaultSerial1;
 extern DefaultSerial1 USBSerial;
 #define SERIAL_INDEX_MIN 0
 #define SERIAL_INDEX_MAX 3
 #define USB_SERIAL_PORT(...) USBSerial
 #include "../shared/serial_ports.h"
 #if defined(LCD_SERIAL_PORT) && ANY(HAS_DGUS_LCD, EXTENSIBLE_UI)
  #define LCD_SERIAL_TX_BUFFER_FREE() LCD_SERIAL.available()
 #endif
 class MarlinSerial : public HardwareSerial<RX_BUFFER_SIZE, TX_BUFFER_SIZE> {
 public:
  MarlinSerial(LPC_UART_TypeDef *UARTx) : HardwareSerial<RX_BUFFER_SIZE, TX_BUFFER_SIZE>(UARTx) { }
@@ -146,6 +146,12 @@ void setup_endstop_interrupts() {
    #endif
    _ATTACH(Z_MIN_PROBE_PIN);
  #endif
  #if USE_CALIBRATION
    #if !LPC1768_PIN_INTERRUPT_M(CALIBRATION_PIN)
      #error "CALIBRATION_PIN is not INTERRUPT-capable. Disable ENDSTOP_INTERRUPTS_FEATURE to continue."
    #endif
    _ATTACH(CALIBRATION_PIN);
  #endif
  #if USE_I_MAX
    #if !LPC1768_PIN_INTERRUPT_M(I_MAX_PIN)
      #error "I_MAX_PIN is not INTERRUPT-capable. Disable ENDSTOP_INTERRUPTS_FEATURE to continue."
@@ -26,8 +26,10 @@
 void MarlinHAL::set_pwm_duty(const pin_t pin, const uint16_t v, const uint16_t v_size/*=255*/, const bool invert/*=false*/) {
  if (!LPC176x::pin_is_valid(pin)) return;
-  if (LPC176x::pwm_attach_pin(pin))
+  if (LPC176x::pwm_attach_pin(pin)) {
-    LPC176x::pwm_write_ratio(pin, invert ? 1.0f - (float)v / v_size : (float)v / v_size);  // map 1-254 onto PWM range
+    const uint32_t duty = map(invert ? v_size - v : v, 0, v_size, 0, LPC176x::pwm_get_period(pin));
    LPC176x::pwm_write(pin, duty);
  }
 }
 void MarlinHAL::set_pwm_frequency(const pin_t pin, const uint16_t f_desired) {
@@ -66,7 +66,7 @@
 #define _WRITE(IO,V)          WRITE_PIN(IO,V)
 /// toggle a pin
-#define _TOGGLE(IO)           _WRITE(IO, !READ(IO))
+#define _TOGGLE(IO)           LPC176x::gpio_toggle(IO)
 /// set pin as input
 #define _SET_INPUT(IO)        SET_DIR_INPUT(IO)
@@ -121,7 +121,7 @@ static_assert(DISABLED(BAUD_RATE_GCODE), "BAUD_RATE_GCODE is not yet supported o
    #if IS_TX1(BTN_EN2) || IS_RX1(BTN_EN1)
      #error "Serial port pins (1) conflict with Encoder Buttons!"
    #elif ANY_TX(1, SD_SCK_PIN, LCD_PINS_D4, DOGLCD_SCK, LCD_RESET_PIN, LCD_PINS_RS, SHIFT_CLK_PIN) \
-       || ANY_RX(1, LCD_SDSS, LCD_PINS_RS, SD_MISO_PIN, DOGLCD_A0, SD_SS_PIN, LCD_SDSS, DOGLCD_CS, LCD_RESET_PIN, LCD_BACKLIGHT_PIN)
+       || ANY_RX(1, LCD_SDSS_PIN, LCD_PINS_RS, SD_MISO_PIN, DOGLCD_A0, SD_SS_PIN, DOGLCD_CS, LCD_RESET_PIN, LCD_BACKLIGHT_PIN)
      #error "Serial port pins (1) conflict with LCD pins!"
    #endif
  #endif
@@ -211,8 +211,8 @@ static_assert(DISABLED(BAUD_RATE_GCODE), "BAUD_RATE_GCODE is not yet supported o
      #error "SCL0 overlaps with Encoder Button!"
    #elif IS_SCL0(SD_SS_PIN)
      #error "SCL0 overlaps with SD_SS_PIN!"
-    #elif IS_SCL0(LCD_SDSS)
+    #elif IS_SCL0(LCD_SDSS_PIN)
-      #error "SCL0 overlaps with LCD_SDSS!"
+      #error "SCL0 overlaps with LCD_SDSS_PIN!"
    #endif
    #undef PIN_IS_SDA0
    #undef IS_SCL0
@@ -19,22 +19,35 @@
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 *
 */
 #pragma once
 /**
- * Support routines for LPC1768
+ * Pins Debugging for LPC1768/9
- */
+ *
-
+ *   - NUMBER_PINS_TOTAL
-/**
+ *   - MULTI_NAME_PAD
- * Translation of routines & variables used by pinsDebug.h
+ *   - getPinByIndex(index)
 *   - printPinNameByIndex(index)
 *   - getPinIsDigitalByIndex(index)
 *   - digitalPinToAnalogIndex(pin)
 *   - getValidPinMode(pin)
 *   - isValidPin(pin)
 *   - isAnalogPin(pin)
 *   - digitalRead_mod(pin)
 *   - pwm_status(pin)
 *   - printPinPWM(pin)
 *   - printPinPort(pin)
 *   - printPinNumber(pin)
 *   - printPinAnalog(pin)
 */
 #define NUMBER_PINS_TOTAL NUM_DIGITAL_PINS
-#define IS_ANALOG(P) (DIGITAL_PIN_TO_ANALOG_PIN(P) >= 0 ? 1 : 0)
+#define isAnalogPin(P) (digitalPinToAnalogIndex(P) >= 0)
-#define digitalRead_mod(p) extDigitalRead(p)
+#define digitalRead_mod(P) extDigitalRead(P)
-#define GET_ARRAY_PIN(p) pin_array[p].pin
+#define getPinByIndex(x) pin_array[x].pin
-#define PRINT_ARRAY_NAME(x) do{ sprintf_P(buffer, PSTR("%-" STRINGIFY(MAX_NAME_LENGTH) "s"), pin_array[x].name); SERIAL_ECHO(buffer); }while(0)
+#define printPinNameByIndex(x) do{ sprintf_P(buffer, PSTR("%-" STRINGIFY(MAX_NAME_LENGTH) "s"), pin_array[x].name); SERIAL_ECHO(buffer); }while(0)
-#define PRINT_PIN(p) do{ sprintf_P(buffer, PSTR("P%d_%02d"), LPC176x::pin_port(p), LPC176x::pin_bit(p)); SERIAL_ECHO(buffer); }while(0)
+#define printPinNumber(P) do{ sprintf_P(buffer, PSTR("P%d_%02d"), LPC176x::pin_port(P), LPC176x::pin_bit(P)); SERIAL_ECHO(buffer); }while(0)
-#define PRINT_PIN_ANALOG(p) do{ sprintf_P(buffer, PSTR("_A%d     "), LPC176x::pin_get_adc_channel(pin)); SERIAL_ECHO(buffer); }while(0)
+#define printPinAnalog(P) do{ sprintf_P(buffer, PSTR("_A%d     "), LPC176x::pin_get_adc_channel(P)); SERIAL_ECHO(buffer); }while(0)
 #define MULTI_NAME_PAD 17 // space needed to be pretty if not first name assigned to a pin
 // pins that will cause hang/reset/disconnect in M43 Toggle and Watch utilities
@@ -42,15 +55,15 @@
  #define M43_NEVER_TOUCH(Q) ((Q) == P0_29 || (Q) == P0_30 || (Q) == P2_09)  // USB pins
 #endif
-bool GET_PINMODE(const pin_t pin) {
+bool getValidPinMode(const pin_t pin) {
  if (!LPC176x::pin_is_valid(pin) || LPC176x::pin_adc_enabled(pin)) // Invalid pin or active analog pin
    return false;
  return LPC176x::gpio_direction(pin);
 }
-#define GET_ARRAY_IS_DIGITAL(x) ((bool) pin_array[x].is_digital)
+#define getPinIsDigitalByIndex(x) ((bool) pin_array[x].is_digital)
-void print_port(const pin_t) {}
+void printPinPort(const pin_t) {}
-void pwm_details(const pin_t) {}
+void printPinPWM(const pin_t) {}
 bool pwm_status(const pin_t) { return false; }
@@ -28,12 +28,12 @@
                        // spiBeginTransaction.
 #endif
-/** onboard SD card */
+// Onboard SD
-//#define SD_SCK_PIN        P0_07
+//#define SD_SCK_PIN     P0_07
-//#define SD_MISO_PIN       P0_08
+//#define SD_MISO_PIN    P0_08
-//#define SD_MOSI_PIN       P0_09
+//#define SD_MOSI_PIN    P0_09
-//#define SD_SS_PIN         P0_06
+
-/** external */
+// External SD
 #ifndef SD_SCK_PIN
  #define SD_SCK_PIN        P0_15
 #endif
@@ -43,10 +43,3 @@
 #ifndef SD_MOSI_PIN
  #define SD_MOSI_PIN       P0_18
 #endif
 #ifndef SD_SS_PIN
  #define SD_SS_PIN         P1_23
 #endif
 #if !defined(SDSS) || SDSS == P_NC // gets defaulted in pins.h
  #undef SDSS
  #define SDSS          SD_SS_PIN
 #endif
@@ -132,7 +132,7 @@ uint8_t swSpiTransfer_mode_3(uint8_t b, const uint8_t spi_speed, const pin_t sck
 static uint8_t SPI_speed = 0;
 static void u8g_sw_spi_shift_out(uint8_t dataPin, uint8_t clockPin, uint8_t val) {
-  #if ANY(FYSETC_MINI_12864, MKS_MINI_12864)
+  #if U8G_SPI_USE_MODE_3
    swSpiTransfer_mode_3(val, SPI_speed, clockPin, -1, dataPin);
  #else
    swSpiTransfer_mode_0(val, SPI_speed, clockPin, -1, dataPin);
@@ -160,15 +160,15 @@ uint8_t u8g_com_HAL_LPC1768_sw_spi_fn(u8g_t *u8g, uint8_t msg, uint8_t arg_val,
      break;
    case U8G_COM_MSG_CHIP_SELECT:
-      #if ANY(FYSETC_MINI_12864, MKS_MINI_12864)  // LCD SPI is running mode 3 while SD card is running mode 0
+      #if U8G_SPI_USE_MODE_3                    // LCD SPI is running mode 3 while SD card is running mode 0
-        if (arg_val) {                            //   SCK idle state needs to be set to the proper idle state before
+        if (arg_val) {                          // SCK idle state needs to be set to the proper idle state before
-                                                  //   the next chip select goes active
+                                                //  the next chip select goes active
-          u8g_SetPILevel(u8g, U8G_PI_SCK, 1);     // Set SCK to mode 3 idle state before CS goes active
+          u8g_SetPILevel(u8g, U8G_PI_SCK, 1);   // Set SCK to mode 3 idle state before CS goes active
          u8g_SetPILevel(u8g, U8G_PI_CS, LOW);
        }
        else {
          u8g_SetPILevel(u8g, U8G_PI_CS, HIGH);
-          u8g_SetPILevel(u8g, U8G_PI_SCK, 0);  // Set SCK to mode 0 idle state after CS goes inactive
+          u8g_SetPILevel(u8g, U8G_PI_SCK, 0);   // Set SCK to mode 0 idle state after CS goes inactive
        }
      #else
        u8g_SetPILevel(u8g, U8G_PI_CS, !arg_val);
@@ -13,9 +13,9 @@ if pioutil.is_pio_build():
    target_drive = "REARM"
    import platform
    current_OS = platform.system()
-    Import("env")
+
    env = pioutil.env
    def print_error(e):
        print('\nUnable to find destination disk (%s)\n' \
@@ -37,7 +37,7 @@ if pioutil.is_pio_build():
                #
                # platformio.ini will accept this for a Windows upload port designation: 'upload_port = L:'
                #   Windows - doesn't care about the disk's name, only cares about the drive letter
-                import subprocess,string
+                import subprocess, string
                from ctypes import windll
                from pathlib import PureWindowsPath
@@ -71,37 +71,10 @@ extern MSerialT serial_stream_2;
 extern MSerialT serial_stream_3;
 #define _MSERIAL(X) serial_stream_##X
 #define MSERIAL(X) _MSERIAL(X)
-#if WITHIN(SERIAL_PORT, 0, 3)
+#define SERIAL_INDEX_MIN 0
-  #define MYSERIAL1 MSERIAL(SERIAL_PORT)
+#define SERIAL_INDEX_MAX 3
-#else
+#include "../shared/serial_ports.h"
  #error "SERIAL_PORT must be from 0 to 3. Please update your configuration."
 #endif
 #ifdef SERIAL_PORT_2
  #if WITHIN(SERIAL_PORT_2, 0, 3)
    #define MYSERIAL2 MSERIAL(SERIAL_PORT_2)
  #else
    #error "SERIAL_PORT_2 must be from 0 to 3. Please update your configuration."
  #endif
 #endif
 #ifdef MMU2_SERIAL_PORT
  #if WITHIN(MMU2_SERIAL_PORT, 0, 3)
    #define MMU2_SERIAL MSERIAL(MMU2_SERIAL_PORT)
  #else
    #error "MMU2_SERIAL_PORT must be from 0 to 3. Please update your configuration."
  #endif
 #endif
 #ifdef LCD_SERIAL_PORT
  #if WITHIN(LCD_SERIAL_PORT, 0, 3)
    #define LCD_SERIAL MSERIAL(LCD_SERIAL_PORT)
  #else
    #error "LCD_SERIAL_PORT must be from 0 to 3. Please update your configuration."
  #endif
 #endif
 // ------------------------
 // Interrupts
@@ -25,11 +25,11 @@
 #include "../../inc/MarlinConfig.h"
 #include "pinsDebug.h"
-int8_t ADC_pin_mode(pin_t pin) { return -1; }
+int8_t ADC_pin_mode(const pin_t) { return -1; }
-int8_t get_pin_mode(const pin_t pin) { return VALID_PIN(pin) ? 0 : -1; }
+int8_t get_pin_mode(const pin_t pin) { return isValidPin(pin) ? 0 : -1; }
-bool GET_PINMODE(const pin_t pin) {
+bool getValidPinMode(const pin_t pin) {
  const int8_t pin_mode = get_pin_mode(pin);
  if (pin_mode == -1 || pin_mode == ADC_pin_mode(pin)) // Invalid pin or active analog pin
    return false;
@@ -37,12 +37,13 @@ bool GET_PINMODE(const pin_t pin) {
  return (Gpio::getMode(pin) != 0); // Input/output state
 }
-bool GET_ARRAY_IS_DIGITAL(const pin_t pin) {
+// The pin and index are the same on this platform
-  return !IS_ANALOG(pin) || get_pin_mode(pin) != ADC_pin_mode(pin);
+bool getPinIsDigitalByIndex(const pin_t pin) {
  return !isAnalogPin(pin) || get_pin_mode(pin) != ADC_pin_mode(pin);
 }
-void print_port(const pin_t) {}
+void printPinPort(const pin_t) {}
-void pwm_details(const pin_t) {}
+void printPinPWM(const pin_t) {}
 bool pwm_status(const pin_t) { return false; }
 #endif
@@ -19,30 +19,43 @@
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 *
 */
 /**
 * Support routines for X86_64
 */
 #pragma once
 /**
- * Translation of routines & variables used by pinsDebug.h
+ * Pins Debugging for x86_64
 *
 *   - NUMBER_PINS_TOTAL
 *   - MULTI_NAME_PAD
 *   - getPinByIndex(index)
 *   - printPinNameByIndex(index)
 *   - getPinIsDigitalByIndex(index)
 *   - digitalPinToAnalogIndex(pin)
 *   - getValidPinMode(pin)
 *   - isValidPin(pin)
 *   - isAnalogPin(pin)
 *   - digitalRead_mod(pin)
 *   - pwm_status(pin)
 *   - printPinPWM(pin)
 *   - printPinPort(pin)
 *   - printPinNumber(pin)
 *   - printPinAnalog(pin)
 */
 #define NUMBER_PINS_TOTAL NUM_DIGITAL_PINS
-#define IS_ANALOG(P) (DIGITAL_PIN_TO_ANALOG_PIN(P) >= 0 ? 1 : 0)
+#define isValidPin(P) (P >= 0 && P < pin_t(NUMBER_PINS_TOTAL))
-#define digitalRead_mod(p)  digitalRead(p)
+#define isAnalogPin(P) (digitalPinToAnalogIndex(P) >= 0)
-#define GET_ARRAY_PIN(p) pin_array[p].pin
+#define digitalRead_mod(P)  digitalRead(P)
-#define PRINT_ARRAY_NAME(x) do{ sprintf_P(buffer, PSTR("%-" STRINGIFY(MAX_NAME_LENGTH) "s"), pin_array[x].name); SERIAL_ECHO(buffer); }while(0)
+#define getPinByIndex(x) pin_array[x].pin
-#define PRINT_PIN(p) do{ sprintf_P(buffer, PSTR("%3d "), p); SERIAL_ECHO(buffer); }while(0)
+#define printPinNameByIndex(x) do{ sprintf_P(buffer, PSTR("%-" STRINGIFY(MAX_NAME_LENGTH) "s"), pin_array[x].name); SERIAL_ECHO(buffer); }while(0)
-#define PRINT_PIN_ANALOG(p) do{ sprintf_P(buffer, PSTR(" (A%2d)  "), DIGITAL_PIN_TO_ANALOG_PIN(pin)); SERIAL_ECHO(buffer); }while(0)
+#define printPinNumber(P) do{ sprintf_P(buffer, PSTR("%3d "), P); SERIAL_ECHO(buffer); }while(0)
 #define printPinAnalog(P) do{ sprintf_P(buffer, PSTR(" (A%2d)  "), digitalPinToAnalogIndex(P)); SERIAL_ECHO(buffer); }while(0)
 #define MULTI_NAME_PAD 16 // space needed to be pretty if not first name assigned to a pin
 // Active ADC function/mode/code values for PINSEL registers
-int8_t ADC_pin_mode(pin_t pin);
+int8_t ADC_pin_mode(const pin_t);
-int8_t get_pin_mode(const pin_t pin);
+int8_t get_pin_mode(const pin_t);
-bool GET_PINMODE(const pin_t pin);
+bool getValidPinMode(const pin_t);
-bool GET_ARRAY_IS_DIGITAL(const pin_t pin);
+bool getPinIsDigitalByIndex(const pin_t);
-void print_port(const pin_t);
+void printPinPort(const pin_t);
-void pwm_details(const pin_t);
+void printPinPWM(const pin_t);
 bool pwm_status(const pin_t);
@@ -32,7 +32,6 @@
 //#define SD_SCK_PIN     P0_07
 //#define SD_MISO_PIN    P0_08
 //#define SD_MOSI_PIN    P0_09
 //#define SD_SS_PIN      P0_06
 // External SD
 #ifndef SD_SCK_PIN
@@ -44,9 +43,3 @@
 #ifndef SD_MOSI_PIN
  #define SD_MOSI_PIN       52
 #endif
 #ifndef SD_SS_PIN
  #define SD_SS_PIN         53
 #endif
 #ifndef SDSS
  #define SDSS       SD_SS_PIN
 #endif
@@ -131,7 +131,7 @@ static uint8_t swSpiInit(const uint8_t spi_speed, const uint8_t clk_pin, const u
 }
 static void u8g_sw_spi_shift_out(uint8_t dataPin, uint8_t clockPin, uint8_t val) {
-  #if ANY(FYSETC_MINI_12864, MKS_MINI_12864)
+  #if U8G_SPI_USE_MODE_3
    swSpiTransfer_mode_3(val, SPI_speed, clockPin, -1, dataPin);
  #else
    swSpiTransfer_mode_0(val, SPI_speed, clockPin, -1, dataPin);
@@ -159,15 +159,15 @@ uint8_t u8g_com_sw_spi_fn(u8g_t *u8g, uint8_t msg, uint8_t arg_val, void *arg_pt
      break;
    case U8G_COM_MSG_CHIP_SELECT:
-      #if ANY(FYSETC_MINI_12864, MKS_MINI_12864)  // LCD SPI is running mode 3 while SD card is running mode 0
+      #if U8G_SPI_USE_MODE_3                    // LCD SPI is running mode 3 while SD card is running mode 0
-        if (arg_val) {                            //   SCK idle state needs to be set to the proper idle state before
+        if (arg_val) {                          // SCK idle state needs to be set to the proper idle state before
-                                                  //   the next chip select goes active
+                                                //  the next chip select goes active
-          u8g_SetPILevel(u8g, U8G_PI_SCK, 1);     // Set SCK to mode 3 idle state before CS goes active
+          u8g_SetPILevel(u8g, U8G_PI_SCK, 1);   // Set SCK to mode 3 idle state before CS goes active
          u8g_SetPILevel(u8g, U8G_PI_CS, LOW);
        }
        else {
          u8g_SetPILevel(u8g, U8G_PI_CS, HIGH);
-          u8g_SetPILevel(u8g, U8G_PI_SCK, 0);  // Set SCK to mode 0 idle state after CS goes inactive
+          u8g_SetPILevel(u8g, U8G_PI_SCK, 0);   // Set SCK to mode 0 idle state after CS goes inactive
        }
      #else
        u8g_SetPILevel(u8g, U8G_PI_CS, !arg_val);
@@ -0,0 +1,185 @@
 /**
 * Marlin 3D Printer Firmware
 * Copyright (c) 2024 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
 *
 * Based on Sprinter and grbl.
 * Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 *
 */
 #include "../platforms.h"
 #ifdef __PLAT_RP2040__
 #include "HAL.h"
 //#include "usb_serial.h"
 #include "../../inc/MarlinConfig.h"
 #include "../shared/Delay.h"
 extern "C" {
  #include "pico/bootrom.h"
  #include "hardware/watchdog.h"
 }
 #if HAS_SD_HOST_DRIVE
  #include "msc_sd.h"
  #include "usbd_cdc_if.h"
 #endif
 // ------------------------
 // Public Variables
 // ------------------------
 volatile uint16_t adc_result;
 // ------------------------
 // Public functions
 // ------------------------
 TERN_(POSTMORTEM_DEBUGGING, extern void install_min_serial());
 // HAL initialization task
 void MarlinHAL::init() {
  // Ensure F_CPU is a constant expression.
  // If the compiler breaks here, it means that delay code that should compute at compile time will not work.
  // So better safe than sorry here.
  constexpr int cpuFreq = F_CPU;
  UNUSED(cpuFreq);
  #if HAS_MEDIA && DISABLED(SDIO_SUPPORT) && PIN_EXISTS(SD_SS)
    OUT_WRITE(SD_SS_PIN, HIGH); // Try to set SD_SS_PIN inactive before any other SPI users start up
  #endif
  #if PIN_EXISTS(LED)
    OUT_WRITE(LED_PIN, LOW);
  #endif
  #if ENABLED(SRAM_EEPROM_EMULATION)
    // __HAL_RCC_PWR_CLK_ENABLE();
    // HAL_PWR_EnableBkUpAccess();           // Enable access to backup SRAM
    // __HAL_RCC_BKPSRAM_CLK_ENABLE();
    // LL_PWR_EnableBkUpRegulator();         // Enable backup regulator
    // while (!LL_PWR_IsActiveFlag_BRR());   // Wait until backup regulator is initialized
  #endif
  HAL_timer_init();
  #if ENABLED(EMERGENCY_PARSER) && USBD_USE_CDC
    USB_Hook_init();
  #endif
  TERN_(POSTMORTEM_DEBUGGING, install_min_serial());    // Install the min serial handler
  TERN_(HAS_SD_HOST_DRIVE, MSC_SD_init());              // Enable USB SD card access
  #if PIN_EXISTS(USB_CONNECT)
    OUT_WRITE(USB_CONNECT_PIN, !USB_CONNECT_INVERTING); // USB clear connection
    delay_ms(1000);                                        // Give OS time to notice
    WRITE(USB_CONNECT_PIN, USB_CONNECT_INVERTING);
  #endif
 }
 uint8_t MarlinHAL::get_reset_source() {
  return watchdog_enable_caused_reboot() ? RST_WATCHDOG : 0;
 }
 void MarlinHAL::reboot() { watchdog_reboot(0, 0, 1); }
 // ------------------------
 // Watchdog Timer
 // ------------------------
 #if ENABLED(USE_WATCHDOG)
  #define WDT_TIMEOUT_US TERN(WATCHDOG_DURATION_8S, 8000000, 4000000) // 4 or 8 second timeout
  extern "C" {
    #include "hardware/watchdog.h"
  }
  void MarlinHAL::watchdog_init() {
    #if DISABLED(DISABLE_WATCHDOG_INIT)
      static_assert(WDT_TIMEOUT_US > 1000, "WDT Timout is too small, aborting");
      watchdog_enable(WDT_TIMEOUT_US/1000, true);
    #endif
  }
  void MarlinHAL::watchdog_refresh() {
    watchdog_update();
    #if DISABLED(PINS_DEBUGGING) && PIN_EXISTS(LED)
      TOGGLE(LED_PIN);  // heartbeat indicator
    #endif
  }
 #endif
 // ------------------------
 // ADC
 // ------------------------
 volatile bool MarlinHAL::adc_has_result = false;
 void MarlinHAL::adc_init() {
  analogReadResolution(HAL_ADC_RESOLUTION);
  ::adc_init();
  adc_fifo_setup(true, false, 1, false, false);
  irq_set_exclusive_handler(ADC_IRQ_FIFO, adc_exclusive_handler);
  irq_set_enabled(ADC_IRQ_FIFO, true);
  adc_irq_set_enabled(true);
 }
 void MarlinHAL::adc_enable(const pin_t pin) {
  if (pin >= A0 && pin <= A3)
    adc_gpio_init(pin);
  else if (pin == HAL_ADC_MCU_TEMP_DUMMY_PIN)
    adc_set_temp_sensor_enabled(true);
 }
 void MarlinHAL::adc_start(const pin_t pin) {
  adc_has_result = false;
  // Select an ADC input. 0...3 are GPIOs 26...29 respectively.
  adc_select_input(pin == HAL_ADC_MCU_TEMP_DUMMY_PIN ? 4 : pin - A0);
  adc_run(true);
 }
 void MarlinHAL::adc_exclusive_handler() {
  adc_run(false); // Disable since we only want one result
  irq_clear(ADC_IRQ_FIFO); // Clear the IRQ
  if (adc_fifo_get_level() >= 1) {
    adc_result = adc_fifo_get(); // Pop the result
    adc_fifo_drain();
    adc_has_result = true; // Signal the end of the conversion
  }
 }
 uint16_t MarlinHAL::adc_value() { return adc_result; }
 // Reset the system to initiate a firmware flash
 void flashFirmware(const int16_t) { hal.reboot(); }
 extern "C" {
  void * _sbrk(int incr);
  extern unsigned int __bss_end__; // end of bss section
 }
 // Return free memory between end of heap (or end bss) and whatever is current
 int freeMemory() {
  int free_memory, heap_end = (int)_sbrk(0);
  return (int)&free_memory - (heap_end ?: (int)&__bss_end__);
 }
 #endif // __PLAT_RP2040__
@@ -0,0 +1,193 @@
 /**
 * Marlin 3D Printer Firmware
 * Copyright (c) 2024 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
 *
 * Based on Sprinter and grbl.
 * Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 *
 */
 #pragma once
 #define CPU_32_BIT
 #ifndef F_CPU
  #define F_CPU (XOSC_MHZ * 1000000UL)
 #endif
 #include "arduino_extras.h"
 #include "../../core/macros.h"
 #include "../shared/Marduino.h"
 #include "../shared/math_32bit.h"
 #include "../shared/HAL_SPI.h"
 #include "fastio.h"
 //#include "Servo.h"
 #include "watchdog.h"
 #include "../../inc/MarlinConfigPre.h"
 #include <stdint.h>
 //
 // Serial Ports
 //
 #include "MarlinSerial.h"
 // ------------------------
 // Defines
 // ------------------------
 /**
 * TODO: review this to return 1 for pins that are not analog input
 */
 #ifndef analogInputToDigitalPin
  #define analogInputToDigitalPin(p) (p)
 #endif
 #define CRITICAL_SECTION_START()  uint32_t primask = __get_PRIMASK(); __disable_irq()
 #define CRITICAL_SECTION_END()    if (!primask) __enable_irq()
 #define cli() __disable_irq()
 #define sei() __enable_irq()
 // ------------------------
 // Types
 // ------------------------
 template <bool, class L, class R> struct IFPIN { typedef R type; };
 template <class L, class R> struct IFPIN<true, L, R> { typedef L type; };
 typedef IFPIN<sizeof(pin_size_t) == 1, int8_t, int16_t>::type pin_t;
 class libServo;
 typedef libServo hal_servo_t;
 #define PAUSE_SERVO_OUTPUT() libServo::pause_all_servos()
 #define RESUME_SERVO_OUTPUT() libServo::resume_all_servos()
 // ------------------------
 // ADC
 // ------------------------
 #define HAL_ADC_VREF         3.3
 #ifdef ADC_RESOLUTION
  #define HAL_ADC_RESOLUTION ADC_RESOLUTION
 #else
  #define HAL_ADC_RESOLUTION 12
 #endif
 // ADC index 4 is the MCU temperature
 #define HAL_ADC_MCU_TEMP_DUMMY_PIN 127
 //
 // Pin Mapping for M42, M43, M226
 //
 #define GET_PIN_MAP_PIN(index) index
 #define GET_PIN_MAP_INDEX(pin) pin
 #define PARSED_PIN_INDEX(code, dval) parser.intval(code, dval)
 #ifndef PLATFORM_M997_SUPPORT
  #define PLATFORM_M997_SUPPORT
 #endif
 void flashFirmware(const int16_t);
 // Maple Compatibility
 typedef void (*systickCallback_t)(void);
 void systick_attach_callback(systickCallback_t cb);
 void HAL_SYSTICK_Callback();
 extern volatile uint32_t systick_uptime_millis;
 #define HAL_CAN_SET_PWM_FREQ   // This HAL supports PWM Frequency adjustment
 #define PWM_FREQUENCY 1000     // Default PWM frequency when set_pwm_duty() is called without set_pwm_frequency()
 // ------------------------
 // Class Utilities
 // ------------------------
 int freeMemory();
 // ------------------------
 // MarlinHAL Class
 // ------------------------
 class MarlinHAL {
 public:
  // Earliest possible init, before setup()
  MarlinHAL() {}
  // Watchdog
  static void watchdog_init()    IF_DISABLED(USE_WATCHDOG, {});
  static void watchdog_refresh() IF_DISABLED(USE_WATCHDOG, {});
  static void init();          // Called early in setup()
  static void init_board() {}  // Called less early in setup()
  static void reboot();        // Restart the firmware from 0x0
  // Interrupts
  static bool isr_state() { return !__get_PRIMASK(); }
  static void isr_on()  { __enable_irq(); }
  static void isr_off() { __disable_irq(); }
  static void delay_ms(const int ms) { ::delay(ms); }
  // Tasks, called from idle()
  static void idletask() {}
  // Reset
  static uint8_t get_reset_source();
  static void clear_reset_source() {}
  // Free SRAM
  static int freeMemory() { return ::freeMemory(); }
  //
  // ADC Methods
  //
  // Called by Temperature::init once at startup
  static void adc_init();
  // Called by Temperature::init for each sensor at startup
  static void adc_enable(const pin_t pin);
  // Begin ADC sampling on the given pin. Called from Temperature::isr!
  static void adc_start(const pin_t pin);
  // This ADC runs a periodic task
  static void adc_exclusive_handler();
  // Is the ADC ready for reading?
  static volatile bool adc_has_result;
  static bool adc_ready() { return adc_has_result; }
  // The current value of the ADC register
  static uint16_t adc_value();
  /**
   * Set the PWM duty cycle for the pin to the given value.
   * Optionally invert the duty cycle [default = false]
   * Optionally change the scale of the provided value to enable finer PWM duty control [default = 255]
   */
  static void set_pwm_duty(const pin_t pin, const uint16_t v, const uint16_t v_size=255, const bool invert=false);
  /**
   * Set the frequency of the timer for the given pin as close as
   * possible to the provided desired frequency. Internally calculate
   * the required waveform generation mode, prescaler, and resolution
   * values and set timer registers accordingly.
   * NOTE that the frequency is applied to all pins on the timer (Ex OC3A, OC3B and OC3B)
   * NOTE that there are limitations, particularly if using TIMER2. (see Configuration_adv.h -> FAST_PWM_FAN Settings)
   */
  static void set_pwm_frequency(const pin_t pin, const uint16_t f_desired);
 };
@@ -0,0 +1,69 @@
 /**
 * Marlin 3D Printer Firmware
 * Copyright (c) 2024 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
 *
 * Based on Sprinter and grbl.
 * Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 *
 */
 #include "../platforms.h"
 #ifdef __PLAT_RP2040__
 #include "../../inc/MarlinConfigPre.h"
 #if ENABLED(POSTMORTEM_DEBUGGING)
 #include "../shared/HAL_MinSerial.h"
 static void TXBegin() {
  #if !WITHIN(SERIAL_PORT, -1, 2)
    #warning "Using POSTMORTEM_DEBUGGING requires a physical U(S)ART hardware in case of severe error."
    #warning "Disabling the severe error reporting feature currently because the used serial port is not a HW port."
  #else
    #if SERIAL_PORT == -1
      USBSerial.begin(BAUDRATE);
    #elif SERIAL_PORT == 0
      USBSerial.begin(BAUDRATE);
    #elif SERIAL_PORT == 1
      Serial1.begin(BAUDRATE);
    #endif
  #endif
 }
 static void TX(char b){
    #if SERIAL_PORT == -1
      USBSerial
    #elif SERIAL_PORT == 0
      USBSerial
    #elif SERIAL_PORT == 1
      Serial1
    #endif
    .write(b);
 }
 // A SW memory barrier, to ensure GCC does not overoptimize loops
 #define sw_barrier() __asm__ volatile("": : :"memory");
 void install_min_serial() {
  HAL_min_serial_init = &TXBegin;
  HAL_min_serial_out = &TX;
 }
 #endif // POSTMORTEM_DEBUGGING
 #endif // __PLAT_RP2040__
@@ -0,0 +1,228 @@
 /**
 * Marlin 3D Printer Firmware
 * Copyright (c) 2024 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
 *
 * Based on Sprinter and grbl.
 * Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 *
 */
 #include "../platforms.h"
 #ifdef __PLAT_RP2040__
 #include "../../inc/MarlinConfig.h"
 #include <SPI.h>
 // ------------------------
 // Public Variables
 // ------------------------
 static SPISettings spiConfig;
 // ------------------------
 // Public functions
 // ------------------------
 #if ENABLED(SOFTWARE_SPI)
  // ------------------------
  // Software SPI
  // ------------------------
  #include "../shared/Delay.h"
  void spiBegin(void) {
    OUT_WRITE(SD_SS_PIN, HIGH);
    OUT_WRITE(SD_SCK_PIN, HIGH);
    SET_INPUT(SD_MISO_PIN);
    OUT_WRITE(SD_MOSI_PIN, HIGH);
  }
  // Use function with compile-time value so we can actually reach the desired frequency
  // Need to adjust this a little bit: on a 72MHz clock, we have 14ns/clock
  // and we'll use ~3 cycles to jump to the method and going back, so it'll take ~40ns from the given clock here
  #define CALLING_COST_NS  (3U * 1000000000U) / (F_CPU)
  void (*delaySPIFunc)();
  void delaySPI_125()  { DELAY_NS(125 - CALLING_COST_NS); }
  void delaySPI_250()  { DELAY_NS(250 - CALLING_COST_NS); }
  void delaySPI_500()  { DELAY_NS(500 - CALLING_COST_NS); }
  void delaySPI_1000() { DELAY_NS(1000 - CALLING_COST_NS); }
  void delaySPI_2000() { DELAY_NS(2000 - CALLING_COST_NS); }
  void delaySPI_4000() { DELAY_NS(4000 - CALLING_COST_NS); }
  void spiInit(uint8_t spiRate) {
    // Use datarates Marlin uses
    switch (spiRate) {
      case SPI_FULL_SPEED:   delaySPIFunc =  &delaySPI_125; break;  // desired: 8,000,000  actual: ~1.1M
      case SPI_HALF_SPEED:   delaySPIFunc =  &delaySPI_125; break;  // desired: 4,000,000  actual: ~1.1M
      case SPI_QUARTER_SPEED:delaySPIFunc =  &delaySPI_250; break;  // desired: 2,000,000  actual: ~890K
      case SPI_EIGHTH_SPEED: delaySPIFunc =  &delaySPI_500; break;  // desired: 1,000,000  actual: ~590K
      case SPI_SPEED_5:      delaySPIFunc = &delaySPI_1000; break;  // desired:   500,000  actual: ~360K
      case SPI_SPEED_6:      delaySPIFunc = &delaySPI_2000; break;  // desired:   250,000  actual: ~210K
      default:               delaySPIFunc = &delaySPI_4000; break;  // desired:   125,000  actual: ~123K
    }
    SPI.begin();
  }
  // Begin SPI transaction, set clock, bit order, data mode
  void spiBeginTransaction(uint32_t spiClock, uint8_t bitOrder, uint8_t dataMode) { /* do nothing */ }
  uint8_t HAL_SPI_RP2040_SpiTransfer_Mode_3(uint8_t b) { // using Mode 3
    for (uint8_t bits = 8; bits--;) {
      WRITE(SD_SCK_PIN, LOW);
      WRITE(SD_MOSI_PIN, b & 0x80);
      delaySPIFunc();
      WRITE(SD_SCK_PIN, HIGH);
      delaySPIFunc();
      b <<= 1;        // little setup time
      b |= (READ(SD_MISO_PIN) != 0);
    }
    DELAY_NS(125);
    return b;
  }
  // Soft SPI receive byte
  uint8_t spiRec() {
    hal.isr_off();  // No interrupts during byte receive
    const uint8_t data = HAL_SPI_RP2040_SpiTransfer_Mode_3(0xFF);
    hal.isr_on();   // Enable interrupts
    return data;
  }
  // Soft SPI read data
  void spiRead(uint8_t *buf, uint16_t nbyte) {
    for (uint16_t i = 0; i < nbyte; i++)
      buf[i] = spiRec();
  }
  // Soft SPI send byte
  void spiSend(uint8_t data) {
    hal.isr_off();                            // No interrupts during byte send
    HAL_SPI_RP2040_SpiTransfer_Mode_3(data);  // Don't care what is received
    hal.isr_on();                             // Enable interrupts
  }
  // Soft SPI send block
  void spiSendBlock(uint8_t token, const uint8_t *buf) {
    spiSend(token);
    for (uint16_t i = 0; i < 512; i++)
      spiSend(buf[i]);
  }
 #else
  // ------------------------
  // Hardware SPI
  // ------------------------
  /**
   * VGPV SPI speed start and PCLK2/2, by default 108/2 = 54Mhz
   */
  /**
   * @brief  Begin SPI port setup
   *
   * @return Nothing
   *
   * @details Only configures SS pin since stm32duino creates and initialize the SPI object
   */
  void spiBegin() {
    #if PIN_EXISTS(SD_SS)
      OUT_WRITE(SD_SS_PIN, HIGH);
    #endif
  }
  // Configure SPI for specified SPI speed
  void spiInit(uint8_t spiRate) {
    // Use datarates Marlin uses
    uint32_t clock;
    switch (spiRate) {
      case SPI_FULL_SPEED:    clock = 20000000; break; // 13.9mhz=20000000  6.75mhz=10000000  3.38mhz=5000000  .833mhz=1000000
      case SPI_HALF_SPEED:    clock =  5000000; break;
      case SPI_QUARTER_SPEED: clock =  2500000; break;
      case SPI_EIGHTH_SPEED:  clock =  1250000; break;
      case SPI_SPEED_5:       clock =   625000; break;
      case SPI_SPEED_6:       clock =   300000; break;
      default:
        clock = 4000000; // Default from the SPI library
    }
    spiConfig = SPISettings(clock, MSBFIRST, SPI_MODE0);
    //SPI.setMISO(SD_MISO_PIN); //todo: implement? bad interface
    //SPI.setMOSI(SD_MOSI_PIN);
    //SPI.setSCLK(SD_SCK_PIN);
    SPI.begin();
  }
  /**
   * @brief  Receives a single byte from the SPI port.
   *
   * @return Byte received
   *
   * @details
   */
  uint8_t spiRec() {
    uint8_t returnByte = SPI.transfer(0xFF);
    return returnByte;
  }
  /**
   * @brief  Receive a number of bytes from the SPI port to a buffer
   *
   * @param  buf   Pointer to starting address of buffer to write to.
   * @param  nbyte Number of bytes to receive.
   * @return Nothing
   *
   * @details Uses DMA
   */
  void spiRead(uint8_t *buf, uint16_t nbyte) {
    if (nbyte == 0) return;
    memset(buf, 0xFF, nbyte);
    SPI.transfer(buf, nbyte);
  }
  /**
   * @brief  Send a single byte on SPI port
   *
   * @param  b Byte to send
   *
   * @details
   */
  void spiSend(uint8_t b) {
    SPI.transfer(b);
  }
  /**
   * @brief  Write token and then write from 512 byte buffer to SPI (for SD card)
   *
   * @param  buf   Pointer with buffer start address
   * @return Nothing
   *
   * @details Use DMA
   */
  void spiSendBlock(uint8_t token, const uint8_t *buf) {
    //uint8_t rxBuf[512];
    //SPI.transfer(token);
    SPI.transfer((uint8_t*)buf, 512); //implement? bad interface
  }
 #endif // SOFTWARE_SPI
 #endif // __PLAT_RP2040__
@@ -0,0 +1,39 @@
 /**
 * Marlin 3D Printer Firmware
 * Copyright (c) 2024 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
 *
 * Based on Sprinter and grbl.
 * Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 *
 */
 #include "../platforms.h"
 #ifdef __PLAT_RP2040__
 #include "../../inc/MarlinConfig.h"
 #include "MarlinSerial.h"
 #if ENABLED(EMERGENCY_PARSER)
  #include "../../feature/e_parser.h"
 #endif
 #define _IMPLEMENT_SERIAL(X) DefaultSerial##X MSerial##X(false, Serial##X)
 #define IMPLEMENT_SERIAL(X)  _IMPLEMENT_SERIAL(X)
 #if WITHIN(SERIAL_PORT, 0, 3)
  IMPLEMENT_SERIAL(SERIAL_PORT);
 #endif
 #endif // __PLAT_RP2040__
@@ -0,0 +1,50 @@
 /**
 * Marlin 3D Printer Firmware
 * Copyright (c) 2024 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
 *
 * Based on Sprinter and grbl.
 * Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 *
 */
 #pragma once
 #include "../../inc/MarlinConfigPre.h"
 #if ENABLED(EMERGENCY_PARSER)
  #include "../../feature/e_parser.h"
 #endif
 #include "../../core/serial_hook.h"
 typedef ForwardSerial1Class< decltype(Serial) > DefaultSerial1;
 extern DefaultSerial1 MSerial0;
 typedef ForwardSerial1Class<decltype(SerialUSB)> USBSerialType;
 extern USBSerialType USBSerial;
 #define Serial0 Serial
 #define _DECLARE_SERIAL(X) \
  typedef ForwardSerial1Class<decltype(Serial##X)> DefaultSerial##X; \
  extern DefaultSerial##X MSerial##X
 #define DECLARE_SERIAL(X) _DECLARE_SERIAL(X)
 #define SERIAL_INDEX_MIN 0
 #define SERIAL_INDEX_MAX 6
 #define USB_SERIAL_PORT(...) MSerial0
 #include "../shared/serial_ports.h"
 #if defined(LCD_SERIAL_PORT) && ANY(HAS_DGUS_LCD, EXTENSIBLE_UI)
  #define SERIAL_GET_TX_BUFFER_FREE() LCD_SERIAL.availableForWrite()
 #endif
@@ -0,0 +1 @@
 # RP2040 Hardware Interface
--- a/Show More
+++ b/Show More