Bump firmware version to 2.4 and update PHY docs

Rename SOFTWARE_VERSION to kSoftwareVersion and bump the template firmware version to "2.4"; update all affected firmware mains to construct FirmwareVersion with the new identifier. Remove an unnecessary GCC optimize pragma (-fprefetch-loop-arrays) from crc32.cpp. Add a detailed documentation comment to the RTL8201F phy CustomizedTiming function describing RMSR timing fields, platform-specific RMII timing adjustments (notably for GD32F4xx), selected RX/TX offset values, and the rationale for a masked read-modify-write update. Changes are primarily refactors, documentation, and a small compiler-pragma cleanup.

Author: vanvught

firmware-template-gd32/include/software_version.h

@@ -26,6 +26,6 @@
 #ifndef SOFTWARE_VERSION_H_
 #define SOFTWARE_VERSION_H_
 
-constexpr char SOFTWARE_VERSION[] = "2.3";
+constexpr char kSoftwareVersion[] = "2.4";
 
 #endif // SOFTWARE_VERSION_H_

gd32_emac_artnet_dmx/firmware/main.cpp

@@ -55,7 +55,7 @@ int main() // NOLINT
     DisplayUdf display;
     ConfigStore config_store;
     network::Init();
-    FirmwareVersion fw(SOFTWARE_VERSION, __DATE__, __TIME__);
+    FirmwareVersion fw(kSoftwareVersion, __DATE__, __TIME__);
 
     fw.Print("Art-Net 4 DMX/RDM controller {" STR(DMXNODE_PORTS) " Universes}");
 

gd32_emac_artnet_pixel/firmware/main.cpp

@@ -66,7 +66,7 @@ int main() // NOLINT
     DisplayUdf display;
     ConfigStore config_store;
     network::Init();
-    FirmwareVersion fw(SOFTWARE_VERSION, __DATE__, __TIME__);
+    FirmwareVersion fw(kSoftwareVersion, __DATE__, __TIME__);
 
     fw.Print("Art-Net 4 Pixel controller {1x 4 Universes}");
 

gd32_emac_artnet_rdm_pca9685/firmware/main.cpp

@@ -58,7 +58,7 @@ int main() // NOLINT
     DisplayUdf display;
     ConfigStore config_store;
     network::Init();
-    FirmwareVersion fw(SOFTWARE_VERSION, __DATE__, __TIME__);
+    FirmwareVersion fw(kSoftwareVersion, __DATE__, __TIME__);
 
     fw.Print("Art-Net 4 PCA9685");
 

gd32_emac_e131_dmx/firmware/main.cpp

@@ -62,7 +62,7 @@ int main() // NOLINT
     DisplayUdf display;
     ConfigStore config_store;
     network::Init();
-    FirmwareVersion fw(SOFTWARE_VERSION, __DATE__, __TIME__);
+    FirmwareVersion fw(kSoftwareVersion, __DATE__, __TIME__);
 
     fw.Print("sACN E1.31 DMX {1 Universe}");
 

gd32_emac_e131_pixel/firmware/main.cpp

@@ -69,7 +69,7 @@ int main() // NOLINT
     DisplayUdf display;
     ConfigStore config_store;
     network::Init();
-    FirmwareVersion fw(SOFTWARE_VERSION, __DATE__, __TIME__);
+    FirmwareVersion fw(kSoftwareVersion, __DATE__, __TIME__);
 
     fw.Print("sACN Pixel controller {1x 4 Universes}");
 

gd32_emac_llrp/firmware/main.cpp

@@ -57,7 +57,7 @@ int main() // NOLINT
     DisplayUdf display;
     ConfigStore config_store;
     network::Init();
-    FirmwareVersion fw(SOFTWARE_VERSION, __DATE__, __TIME__);
+    FirmwareVersion fw(kSoftwareVersion, __DATE__, __TIME__);
 
     fw.Print("RDMNet LLRP device only");
 

gd32_emac_osc_dmx/firmware/main.cpp

@@ -54,7 +54,7 @@ int main() // NOLINT
     Display display;
     ConfigStore config_store;
     network::Init();
-    FirmwareVersion fw(SOFTWARE_VERSION, __DATE__, __TIME__);
+    FirmwareVersion fw(kSoftwareVersion, __DATE__, __TIME__);
 
     fw.Print("OSC Server DMX controller {1x Universe}");
 

gd32_emac_osc_pixel/firmware/main.cpp

@@ -57,7 +57,7 @@ int main() // NOLINT
     Display display;
     ConfigStore config_store;
     network::Init();
-    FirmwareVersion fw(SOFTWARE_VERSION, __DATE__, __TIME__);
+    FirmwareVersion fw(kSoftwareVersion, __DATE__, __TIME__);
 
     fw.Print("OSC Server Pixel controller {1x Universe}");
 

gd32_rdm_responder/firmware/main.cpp

@@ -63,7 +63,7 @@ int main() // NOLINT
 #if !defined(NO_EMAC)    
     network::Init();
 #endif    
-    FirmwareVersion fw(SOFTWARE_VERSION, __DATE__, __TIME__);
+    FirmwareVersion fw(kSoftwareVersion, __DATE__, __TIME__);
 
     const auto kIsConfigMode = IsConfigMode();