diff --git a/firmware/hw_layer/pin_repository.h b/firmware/hw_layer/pin_repository.h
index 141ba16f43..d13fbe8999 100644
--- a/firmware/hw_layer/pin_repository.h
+++ b/firmware/hw_layer/pin_repository.h
@@ -59,6 +59,7 @@ int brainPin_to_index(brain_pin_e brainPin);
 unsigned int getBrainPinOnchipNum(void);
 unsigned int getBrainPinTotalNum(void);
 const char *hwPortname(brain_pin_e brainPin);
+// the main usage for human-readable board-specific pin reference is convenience of error messages in case of pin conflict.
 const char * getBoardSpecificPinName(brain_pin_e brainPin);
 
 #ifdef __cplusplus
diff --git a/java_tools/ConfigDefinition.jar b/java_tools/ConfigDefinition.jar
index 381840b0db..382f7dfc55 100644
Binary files a/java_tools/ConfigDefinition.jar and b/java_tools/ConfigDefinition.jar differ
diff --git a/java_tools/configuration_definition/src/main/java/com/rusefi/PinoutLogic.java b/java_tools/configuration_definition/src/main/java/com/rusefi/PinoutLogic.java
index 1c6faae394..42f924fc26 100644
--- a/java_tools/configuration_definition/src/main/java/com/rusefi/PinoutLogic.java
+++ b/java_tools/configuration_definition/src/main/java/com/rusefi/PinoutLogic.java
@@ -182,14 +182,18 @@ public class PinoutLogic {
     }
 
     public void registerBoardSpecificPinNames(VariableRegistry registry, ReaderState state) throws IOException {
+        StringBuilder header = new StringBuilder("//DO NOT EDIT MANUALLY, let automation work hard.\n\n");
         for (File yamlFile : boardYamlFiles) {
+            header.append("// auto-generated by PinoutLogic.java based on  " + yamlFile + "\n");
             readMetaInfo(yamlFile);
         }
         registerPins(globalList, registry, state);
 
         try (FileWriter getTsNameByIdFile = new FileWriter(PinoutLogic.CONFIG_BOARDS + boardName + PinoutLogic.CONNECTORS + File.separator + "generated_ts_name_by_pin.cpp")) {
-            getTsNameByIdFile.append("// auto-generated by PinoutLogic.java. DO NOT EDIT MANUALLY, let automation work hard.\n\n");
+            getTsNameByIdFile.append(header);
+
             getTsNameByIdFile.append("#include \"pch.h\"\n\n");
+            getTsNameByIdFile.append("// see comments at declaration in pin_repository.h\n");
             getTsNameByIdFile.append("const char * getBoardSpecificPinName(brain_pin_e brainPin) {\n");
             getTsNameByIdFile.append("\tswitch(brainPin) {\n");