chore: snapshot before shared RS485 bus integration

cfg/esp32devkitc/board.cfg

@@ -1,32 +1,115 @@
+# ChargeFlow board.cfg
+# ------------------------------------------------------------
+# Este ficheiro suporta duas variantes de hardware:
+#
+# 1) Board antiga  -> Pilot no ADC interno do ESP32
+# 2) Board recente -> Pilot no ADC externo ADC121S021
+#
+# Para mudar de board, alterar apenas a secção "SELEÇÃO DE PERFIL".
+# As restantes opções são comuns às duas boards.
+#
+# IMPORTANTE:
+# - Não deixar duas linhas iguais ativas ao mesmo tempo.
+# - Linhas começadas por # são comentários.
+# - Na board com ADC externo, PILOT_ADC_SOURCE pode ser omitido,
+#   porque o firmware usa ADC121S021 por defeito.
+# ------------------------------------------------------------
+
+
+# ============================================================
+# SELEÇÃO DE PERFIL
+# ============================================================
+
+# ------------------------------------------------------------
+# PERFIL ATIVO: Board antiga com ADC interno ESP32
+# ------------------------------------------------------------
+#led_red_GPIO=13
+#BUZZER_GPIO=21
+#PILOT_ADC_SOURCE=internal
+
+# ------------------------------------------------------------
+# PERFIL ALTERNATIVO: Board recente com ADC externo ADC121S021
+# Para usar esta board:
+#   1. Comentar as 3 linhas do perfil ativo acima
+#   2. Descomentar as 3 linhas abaixo
+# ------------------------------------------------------------
+led_red_GPIO=26
+BUZZER_GPIO=27
+PILOT_ADC_SOURCE=adc121
+
+
+# ============================================================
+# CONFIGURAÇÃO COMUM
+# ============================================================
+
 DEVICE_NAME=ChargeFlow
 
-#LEDs
+
+# ------------------------------------------------------------
+# LEDs
+# ------------------------------------------------------------
 led_blue=y
 led_blue_GPIO=14
+
 led_red=y
-led_red_GPIO=26
+# led_red_GPIO é definido na SELEÇÃO DE PERFIL
+
 led_green=y
 led_green_GPIO=12
 
-#BUZZER
-BUZZER=y
-BUZZER_GPIO=27
 
-#Button
+# ------------------------------------------------------------
+# BUZZER
+# ------------------------------------------------------------
+BUZZER=y
+# BUZZER_GPIO é definido na SELEÇÃO DE PERFIL
+
+
+# ------------------------------------------------------------
+# Botão Wi-Fi
+# ------------------------------------------------------------
 BUTTON_WIFI_GPIO=32
 
-#Pilot  
+
+# ------------------------------------------------------------
+# Pilot / Control Pilot
+# ------------------------------------------------------------
+# PILOT_ADC_SOURCE é definido na SELEÇÃO DE PERFIL.
+#
+# Valores possíveis:
+#   internal -> usa ADC interno do ESP32
+#   adc121   -> usa ADC externo ADC121S021
+#
+# Board antiga:
+#   PILOT_ADC_SOURCE=internal
+#
+# Board recente:
+#   PILOT_ADC_SOURCE=adc121
+#   ou omitir a linha, porque o default do firmware é ADC121S021.
+#
+# Nota:
+#   PILOT_ADC_CHANNEL é canal ADC, não GPIO.
+#   Em ESP32 clássico, ADC1_CH6 normalmente corresponde ao GPIO34.
+# ------------------------------------------------------------
 PILOT_PWM_GPIO=33
 PILOT_ADC_CHANNEL=6
+
+# Thresholds em mV no pino ADC/saída do circuito de medição
 PILOT_DOWN_THRESHOLD_12=3000
 PILOT_DOWN_THRESHOLD_9=2600
 PILOT_DOWN_THRESHOLD_6=2200
 PILOT_DOWN_THRESHOLD_3=1950
 PILOT_DOWN_THRESHOLD_N12=500
 
-#Proximity
+
+# ------------------------------------------------------------
+# Proximity
+# ------------------------------------------------------------
 PROXIMITY=y
+
+# Em ESP32 clássico, ADC1_CH3 normalmente corresponde ao GPIO39.
 PROXIMITY_ADC_CHANNEL=3
+
 PROXIMITY_DOWN_THRESHOLD_8=2450
 PROXIMITY_DOWN_THRESHOLD_10=2050
 PROXIMITY_DOWN_THRESHOLD_13=1650
@@ -34,11 +117,20 @@ PROXIMITY_DOWN_THRESHOLD_20=820
 PROXIMITY_DOWN_THRESHOLD_25=610
 PROXIMITY_DOWN_THRESHOLD_32=430
 
-#AC relay
+
+# ------------------------------------------------------------
+# Relé AC
+# ------------------------------------------------------------
 AC_RELAY_GPIO=25
 
-#Cable lock
+
+# ------------------------------------------------------------
+# Cable lock
+# ------------------------------------------------------------
 SOCKET_LOCK=n
+
+# Como SOCKET_LOCK=n, estes GPIOs podem ficar vazios.
+# Se SOCKET_LOCK=y, preencher sempre valores válidos.
 SOCKET_LOCK_A_GPIO=
 SOCKET_LOCK_B_GPIO=
-SOCKET_LOCK_DETECTION_GPIO=
+SOCKET_LOCK_DETECTION_GPIO=