meshcore-dev · omeg · Apr 25, 2026
diff --git a/docs/faq.md b/docs/faq.md
@@ -822,7 +822,7 @@ where `&type` is:
 ### 7.6. Q: How do I connect to the companion via WIFI, e.g. using a heltec v3?
  **A:**
 WiFi firmware requires you to compile it yourself, as you need to set the wifi ssid and password.
-Edit WIFI_SSID and WIFI_PWD in `./variants/heltec_v3/platformio.ini` and then flash it to your device.
+Edit WIFI_SSID and WIFI_PASSWORD in `platformio.ini` and then flash it to your device.
 
 ### 7.7. Q: I have a Station G2, or a Heltec V4, or an Ikoka Stick, or a radio with a EByte E22-900M30S or a E22-900M33S module, what should their transmit power be set to?
  **A:**

diff --git a/examples/companion_radio/main.cpp b/examples/companion_radio/main.cpp
@@ -174,7 +174,7 @@ void setup() {
   );
 
   //#ifdef WIFI_SSID
-  //  WiFi.begin(WIFI_SSID, WIFI_PWD);
+  //  WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
   //  serial_interface.begin(TCP_PORT);
   // #elif defined(BLE_PIN_CODE)
   //   char dev_name[32+16];
@@ -213,7 +213,7 @@ void setup() {
       }
   });
 
-  WiFi.begin(WIFI_SSID, WIFI_PWD);
+  WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
   serial_interface.begin(TCP_PORT);
 #elif defined(BLE_PIN_CODE)
   serial_interface.begin(BLE_NAME_PREFIX, the_mesh.getNodePrefs()->node_name, the_mesh.getBLEPin());

diff --git a/platformio.ini b/platformio.ini
@@ -13,6 +13,17 @@ extra_configs =
   variants/*/platformio.ini
   platformio.local.ini
 
+[local_config]
+; Central place for customization shared by variant envs
+; Override these values in platformio.local.ini
+admin_password = -D ADMIN_PASSWORD='"password"'
+room_password = -D ROOM_PASSWORD='"hello"'
+wifi_ssid = -D WIFI_SSID='"myssid"'
+wifi_password = -D WIFI_PASSWORD='"mypwd"'
+espnow_bridge_secret = -D WITH_ESPNOW_BRIDGE_SECRET='"shared-secret"'
+tcp_port = -D TCP_PORT=5000
+ble_pin_code = -D BLE_PIN_CODE=123456
+
 [arduino_base]
 framework = arduino
 monitor_speed = 115200

diff --git a/variants/ebyte_eora_s3/platformio.ini b/variants/ebyte_eora_s3/platformio.ini
@@ -50,7 +50,7 @@ build_flags =
   -D ADVERT_NAME='"EORA_S3-1262 Repeater"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
 ;  -D MESH_PACKET_LOGGING=1
 ;  -D MESH_DEBUG=1
@@ -83,8 +83,8 @@ build_flags =
   -D ADVERT_NAME='"EORA_S3-1262 Room"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
-  -D ROOM_PASSWORD='"hello"'
+  ${local_config.admin_password}
+  ${local_config.room_password}
 ;  -D MESH_PACKET_LOGGING=1
 ;  -D MESH_DEBUG=1
 build_src_filter = ${Ebyte_EoRa-S3.build_src_filter}
@@ -121,7 +121,7 @@ build_flags =
   -D DISPLAY_CLASS=SSD1306Display
   -D MAX_CONTACTS=350
   -D MAX_GROUP_CHANNELS=40
-  -D BLE_PIN_CODE=123456
+  ${local_config.ble_pin_code}
   -D BLE_DEBUG_LOGGING=1
   -D OFFLINE_QUEUE_SIZE=256
 ;  -D MESH_PACKET_LOGGING=1

diff --git a/variants/gat562_30s_mesh_kit/platformio.ini b/variants/gat562_30s_mesh_kit/platformio.ini
@@ -39,7 +39,7 @@ build_flags =
   -D ADVERT_NAME='"GAT562 Repeater"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
 ;  -D MESH_PACKET_LOGGING=1
 ;  -D MESH_DEBUG=1
@@ -56,8 +56,8 @@ build_flags =
   -D ADVERT_NAME='"GAT562 Room"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
-  -D ROOM_PASSWORD='"hello"'
+  ${local_config.admin_password}
+  ${local_config.room_password}
 ;  -D MESH_PACKET_LOGGING=1
 ;  -D MESH_DEBUG=1
 build_src_filter = ${GAT562_30S_Mesh_Kit.build_src_filter}
@@ -97,7 +97,7 @@ build_flags =
   -D DISPLAY_CLASS=SSD1306Display
   -D MAX_CONTACTS=350
   -D MAX_GROUP_CHANNELS=40
-  -D BLE_PIN_CODE=123456
+  ${local_config.ble_pin_code}
   -D BLE_DEBUG_LOGGING=1
   -D OFFLINE_QUEUE_SIZE=256
   ; -D MESH_PACKET_LOGGING=1

diff --git a/variants/gat562_mesh_evb_pro/platformio.ini b/variants/gat562_mesh_evb_pro/platformio.ini
@@ -29,7 +29,7 @@ build_flags =
   -D ADVERT_NAME='"GAT562 EVB Pro Repeater"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
 ;  -D MESH_PACKET_LOGGING=1
 ;  -D MESH_DEBUG=1
@@ -44,8 +44,8 @@ build_flags =
   -D ADVERT_NAME='"GAT562 EVB Pro Room Server"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
-  -D ROOM_PASSWORD='"hello"'
+  ${local_config.admin_password}
+  ${local_config.room_password}
 ;  -D MESH_PACKET_LOGGING=1
 ;  -D MESH_DEBUG=1
 build_src_filter = ${GAT562_Mesh_EVB_Pro.build_src_filter}

diff --git a/variants/gat562_mesh_tracker_pro/platformio.ini b/variants/gat562_mesh_tracker_pro/platformio.ini
@@ -35,7 +35,7 @@ build_flags =
   -D ADVERT_NAME='"GAT562 Repeater"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
 ;  -D MESH_PACKET_LOGGING=1
 ;  -D MESH_DEBUG=1
@@ -52,8 +52,8 @@ build_flags =
   -D ADVERT_NAME='"GAT562 Room"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
-  -D ROOM_PASSWORD='"hello"'
+  ${local_config.admin_password}
+  ${local_config.room_password}
 ;  -D MESH_PACKET_LOGGING=1
 ;  -D MESH_DEBUG=1
 build_src_filter = ${GAT562_Mesh_Tracker_Pro.build_src_filter}
@@ -92,7 +92,7 @@ build_flags =
   -D DISPLAY_CLASS=SSD1306Display
   -D MAX_CONTACTS=350
   -D MAX_GROUP_CHANNELS=40
-  -D BLE_PIN_CODE=123456
+  ${local_config.ble_pin_code}
   -D BLE_DEBUG_LOGGING=1
   -D OFFLINE_QUEUE_SIZE=256
   ; -D MESH_PACKET_LOGGING=1

diff --git a/variants/gat562_mesh_watch13/platformio.ini b/variants/gat562_mesh_watch13/platformio.ini
@@ -37,7 +37,7 @@ lib_deps =
 ;  -D ADVERT_NAME='"GAT562 Repeater"'
 ;  -D ADVERT_LAT=0.0
 ;  -D ADVERT_LON=0.0
-;  -D ADMIN_PASSWORD='"password"'
+;  ${local_config.admin_password}
 ;  -D MAX_NEIGHBOURS=50
 ;;  -D MESH_PACKET_LOGGING=1
 ;;  -D MESH_DEBUG=1
@@ -53,8 +53,8 @@ lib_deps =
 ;  -D ADVERT_NAME='"GAT562 Room"'
 ;  -D ADVERT_LAT=0.0
 ;  -D ADVERT_LON=0.0
-;  -D ADMIN_PASSWORD='"password"'
-;  -D ROOM_PASSWORD='"hello"'
+;  ${local_config.admin_password}
+;  ${local_config.room_password}
 ;;  -D MESH_PACKET_LOGGING=1
 ;;  -D MESH_DEBUG=1
 ;build_src_filter = ${GAT562_Mesh_Watch13.build_src_filter}
@@ -71,7 +71,7 @@ build_flags =
   -D DISPLAY_CLASS=SSD1306Display
   -D MAX_CONTACTS=350
   -D MAX_GROUP_CHANNELS=40
-  -D BLE_PIN_CODE=123456
+  ${local_config.ble_pin_code}
   -D BLE_DEBUG_LOGGING=1
   -D OFFLINE_QUEUE_SIZE=256
 ;  -D PIN_VIBRATION=36

diff --git a/variants/generic-e22/platformio.ini b/variants/generic-e22/platformio.ini
@@ -39,7 +39,7 @@ build_flags =
   -D ADVERT_NAME='"E22 Repeater"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
 ;  -D MESH_PACKET_LOGGING=1
 ;  -D MESH_DEBUG=1
@@ -60,7 +60,7 @@ lib_deps =
 ;   -D ADVERT_NAME='"RS232 Bridge"'
 ;   -D ADVERT_LAT=0.0
 ;   -D ADVERT_LON=0.0
-;   -D ADMIN_PASSWORD='"password"'
+;   ${local_config.admin_password}
 ;   -D MAX_NEIGHBOURS=50
 ;   -D WITH_RS232_BRIDGE=Serial2
 ;   -D WITH_RS232_BRIDGE_RX=5
@@ -85,7 +85,7 @@ build_flags =
   -D ADVERT_NAME='"ESPNow Bridge"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
   -D WITH_ESPNOW_BRIDGE=1
 ;  -D BRIDGE_DEBUG=1
@@ -112,7 +112,7 @@ build_flags =
   -D ADVERT_NAME='"E22 Repeater"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
 ;  -D MESH_PACKET_LOGGING=1
 ;  -D MESH_DEBUG=1
@@ -133,7 +133,7 @@ lib_deps =
 ;   -D ADVERT_NAME='"RS232 Bridge"'
 ;   -D ADVERT_LAT=0.0
 ;   -D ADVERT_LON=0.0
-;   -D ADMIN_PASSWORD='"password"'
+;   ${local_config.admin_password}
 ;   -D MAX_NEIGHBOURS=50
 ;   -D WITH_RS232_BRIDGE=Serial2
 ;   -D WITH_RS232_BRIDGE_RX=5
@@ -158,7 +158,7 @@ build_flags =
   -D ADVERT_NAME='"ESPNow Bridge"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
   -D WITH_ESPNOW_BRIDGE=1
 ;  -D BRIDGE_DEBUG=1

diff --git a/variants/generic_espnow/platformio.ini b/variants/generic_espnow/platformio.ini
@@ -41,7 +41,7 @@ build_flags =
   -D ADVERT_NAME='"ESPNOW Repeater"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
 build_src_filter = ${Generic_ESPNOW.build_src_filter}
   +<../examples/simple_repeater/*.cpp>
@@ -72,8 +72,8 @@ build_flags =
   -D ADVERT_NAME='"Generic ESPNow Room"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
-  -D ROOM_PASSWORD='"hello"'
+  ${local_config.admin_password}
+  ${local_config.room_password}
 build_src_filter = ${Generic_ESPNOW.build_src_filter}
   +<../examples/simple_room_server/*.cpp>
 lib_deps =

diff --git a/variants/heltec_ct62/platformio.ini b/variants/heltec_ct62/platformio.ini
@@ -40,7 +40,7 @@ build_flags =
   -D ADVERT_NAME='"HT-CT62 Repeater"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
 ;  -D MESH_PACKET_LOGGING=1
 ;  -D MESH_DEBUG=1
@@ -57,7 +57,7 @@ lib_deps =
 ;   -D ADVERT_NAME='"RS232 Bridge"'
 ;   -D ADVERT_LAT=0.0
 ;   -D ADVERT_LON=0.0
-;   -D ADMIN_PASSWORD='"password"'
+;   ${local_config.admin_password}
 ;   -D MAX_NEIGHBOURS=50
 ;   -D WITH_RS232_BRIDGE=Serial2
 ;   -D WITH_RS232_BRIDGE_RX=5
@@ -79,7 +79,7 @@ build_flags =
   -D ADVERT_NAME='"ESPNow Bridge"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
   -D WITH_ESPNOW_BRIDGE=1
 ;  -D BRIDGE_DEBUG=1
@@ -119,7 +119,7 @@ build_flags =
   -D MAX_CONTACTS=350
   -D MAX_GROUP_CHANNELS=40
   -D OFFLINE_QUEUE_SIZE=256
-  -D BLE_PIN_CODE=123456
+  ${local_config.ble_pin_code}
 ;  -D MESH_PACKET_LOGGING=1
 ;  -D MESH_DEBUG=1
 build_src_filter = ${Heltec_ct62.build_src_filter}
@@ -137,7 +137,7 @@ build_flags =
   -D ADVERT_NAME='"HT-CT62 Sensor"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D PIN_BOARD_SDA=-1
   -D PIN_BOARD_SCL=-1
   -D PIN_BOARD_RELAY_CH1=0

diff --git a/variants/heltec_e213/platformio.ini b/variants/heltec_e213/platformio.ini
@@ -50,7 +50,7 @@ build_flags =
   -D MAX_GROUP_CHANNELS=40
   -D DISPLAY_CLASS=E213Display
   -D AUTO_OFF_MILLIS=0
-  -D BLE_PIN_CODE=123456   ; dynamic, random PIN
+  ${local_config.ble_pin_code}
   -D BLE_DEBUG_LOGGING=1
   -D OFFLINE_QUEUE_SIZE=256
 build_src_filter = ${Heltec_E213_base.build_src_filter}
@@ -91,7 +91,7 @@ build_flags =
   -D ADVERT_NAME='"Heltec E213 Repeater"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
 build_src_filter = ${Heltec_E213_base.build_src_filter}
   +<helpers/ui/E213Display.cpp>
@@ -109,7 +109,7 @@ lib_deps =
 ;   -D ADVERT_NAME='"RS232 Bridge"'
 ;   -D ADVERT_LAT=0.0
 ;   -D ADVERT_LON=0.0
-;   -D ADMIN_PASSWORD='"password"'
+;   ${local_config.admin_password}
 ;   -D MAX_NEIGHBOURS=50
 ;   -D WITH_RS232_BRIDGE=Serial2
 ;   -D WITH_RS232_BRIDGE_RX=5
@@ -134,7 +134,7 @@ build_flags =
   -D ADVERT_NAME='"ESPNow Bridge"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
   -D WITH_ESPNOW_BRIDGE=1
 ;  -D BRIDGE_DEBUG=1
@@ -157,8 +157,8 @@ build_flags =
   -D ADVERT_NAME='"Heltec E213 Room"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
-  -D ROOM_PASSWORD='"hello"'
+  ${local_config.admin_password}
+  ${local_config.room_password}
 build_src_filter = ${Heltec_E213_base.build_src_filter}
   +<helpers/ui/E213Display.cpp>
   +<../examples/simple_room_server>

diff --git a/variants/heltec_e290/platformio.ini b/variants/heltec_e290/platformio.ini
@@ -44,7 +44,7 @@ build_flags =
   -D MAX_GROUP_CHANNELS=40
   -D DISPLAY_CLASS=E290Display
   -D AUTO_OFF_MILLIS=0
-  -D BLE_PIN_CODE=123456   ; dynamic, random PIN
+  ${local_config.ble_pin_code}
   -D BLE_DEBUG_LOGGING=1
   -D OFFLINE_QUEUE_SIZE=256
 build_src_filter = ${Heltec_E290_base.build_src_filter}
@@ -86,7 +86,7 @@ build_flags =
   -D ADVERT_NAME='"Heltec E290 Repeater"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
 build_src_filter = ${Heltec_E290_base.build_src_filter}
   +<helpers/ui/E290Display.cpp>
@@ -104,7 +104,7 @@ lib_deps =
 ;   -D ADVERT_NAME='"RS232 Bridge"'
 ;   -D ADVERT_LAT=0.0
 ;   -D ADVERT_LON=0.0
-;   -D ADMIN_PASSWORD='"password"'
+;   ${local_config.admin_password}
 ;   -D MAX_NEIGHBOURS=50
 ;   -D WITH_RS232_BRIDGE=Serial2
 ;   -D WITH_RS232_BRIDGE_RX=5
@@ -129,7 +129,7 @@ build_flags =
   -D ADVERT_NAME='"ESPNow Bridge"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
+  ${local_config.admin_password}
   -D MAX_NEIGHBOURS=50
   -D WITH_ESPNOW_BRIDGE=1
 ;  -D BRIDGE_DEBUG=1
@@ -152,8 +152,8 @@ build_flags =
   -D ADVERT_NAME='"Heltec E290 Room"'
   -D ADVERT_LAT=0.0
   -D ADVERT_LON=0.0
-  -D ADMIN_PASSWORD='"password"'
-  -D ROOM_PASSWORD='"hello"'
+  ${local_config.admin_password}
+  ${local_config.room_password}
 build_src_filter = ${Heltec_E290_base.build_src_filter}
   +<helpers/ui/E290Display.cpp>
   +<../examples/simple_room_server>