fix: AP mode touch detection and mandatory first-boot calibration

Bug fix — AP mode via touch:
Add DisplayManager::beginTouch() which initializes the XPT2046 touch
controller on Core 0 during boot, without needing Core 1 running.
isScreenTouched() now polls hardware directly when _ts is available.
This keeps the safe boot order: storage init (Core 1 off) → touch init
→ AP detection with working touch.

Feature — mandatory calibration on first boot:
When magic != 0xCA (factory reset or first boot), the full calibration
flow runs before entering the dashboard: sensitivity threshold →
4-point position calibration × 2 cycles. Core 0 blocks until complete.
The Cancel button during boot applies safe defaults and proceeds to
dashboard instead of going to Settings.

Calibration defaults tightened: xMin=300, xMax=3800, yMin=200, yMax=3700.

Tests: 49/49 pass. All 3 sensor configs build.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: angeloINTJ

src/AppManager_Boot.cpp

@@ -157,13 +157,8 @@ void AppManager::setup( ) {
 
  delay(BOOT_STEP_DELAY_MS);
 
- _displayMgr->startCore1( );
- {
- unsigned long _wait_start = millis( );
- while (!_displayMgr->isCore1Ready( ) && millis( ) - _wait_start < 1500) {
- tight_loop_contents( );
- }
- }
+ _displayMgr->beginTouch( );
+
  bool forceAP = false;
  _displayMgr->setBootStatusKey(TR_BOOT_HOLD_AP);
 
@@ -453,31 +448,28 @@ void AppManager::setup( ) {
  _displayMgr->loadTouchCalibration(cal);
 
  if (!_displayMgr->isTouchCalibrated( )) {
- 
- /* Factory boot without saved calibration: apply safe default to
-	 * unblock boot. Without this, the calibration screen loop would
-	 * wait for 4 valid taps — and on XPT2046 with stuck-true touch
-	 * (this hardware) the loop is infinite or produces degenerate
-	 * calibration with identical coordinates. The user can recalibrate
-	 * later via Settings -> Touch Cal or via CLI.
-	 * Default range 200..3900 covers most XPT2046 panels. */
- Serial.printf("[BOOT] no touch cal saved (touch_settled=%d) — applying default\n",
- touch_settled ? 1 : 0);
- TouchCalData* calOut = reinterpret_cast<TouchCalData*>(cfg.reserved);
- calOut->magic = 0xCA;
- calOut->flags = 0;
- calOut->xMin = 300;
- calOut->xMax = 3800;
- calOut->yMin = 200;
- calOut->yMax = 3700;
- calOut->zThreshold = 400;
- _displayMgr->loadTouchCalibration(calOut);
- 
- _storageMgr->saveConfiguration( );
- 
  LOG_CODE(LOG_WARN, "APP", APP_TOUCH_CAL_REQUIRED, 0,
- TRL("Touch cal missing; default applied (recalibrate via Settings)"));
- 
+ TRL("First boot — touch calibration required"));
+
+ _displayMgr->setBootStatusKey(TR_BOOT_TOUCH_CAL_REQ);
+ _displayMgr->showTouchCalibration( );
+
+ /* Block Core 0 until user completes calibration on Core 1.
+  * The calibration flow (sensitivity → 4-point position × 2 cycles)
+  * runs entirely on Core 1. isTouchCalibrated() becomes true when
+  * the position calibration is accepted (or the user cancels). */
+ while (!_displayMgr->isTouchCalibrated( )) {
+ delay(20);
+ }
+
+ /* Persist the calibration result to flash. */
+ TouchCalData calOut;
+ _displayMgr->fillCalData(&calOut);
+ memcpy(cfg.reserved, &calOut, sizeof(TouchCalData));
+ _storageMgr->saveConfiguration( );
+
+ LOG_CODE(LOG_INFO, "APP", APP_TOUCH_CAL_REQUIRED, 0,
+ TRL("Touch calibration completed"));
  }
  }
 

src/DisplayManager.cpp

@@ -449,7 +449,16 @@ bool DisplayManager::isSkipPressed( ) {
 	return false;
 }
 
-bool DisplayManager::isScreenTouched( ) { return _rawTouchState; }
+bool DisplayManager::isScreenTouched( ) {
+ if (_ts) return _ts->touched( );
+ return _rawTouchState;
+}
+
+void DisplayManager::beginTouch( ) {
+ if (!_ts) _ts = new XPT2046_Touchscreen(TOUCH_CS, TOUCH_IRQ);
+ _ts->begin( );
+ _ts->setRotation(3);
+}
 
 /* Inject simulated touch for automation (screenshot capture).
  * Set flag + coords; Core 1 sees it on the next handleTouch iteration.

src/DisplayManager.h

@@ -172,6 +172,7 @@ class DisplayManager {
 	bool isHeavyRendering( );
 	bool isSkipPressed( );
 	bool isScreenTouched( );
+	 void beginTouch( ); /**< Init touch controller on Core 0 for AP detection during boot. */
 
 
 	void setWebBusy(bool busy, const char* username = nullptr);

src/DisplayManager_Touch.cpp

@@ -148,7 +148,21 @@ void DisplayManager::handleTouch( ) {
  int16_t sx, sy;
  mapTouchPoint(p, sx, sy);
  if (sy > 195 && sx < 125) {
- if (acceptTouch(0)) { showSettingsMain( ); return; }
+ if (acceptTouch(0)) {
+ if (_sharedState.isBooting) {
+ _calXMin = 300; _calXMax = 3800;
+ _calYMin = 200; _calYMax = 3700;
+ _sensZThreshold = 400;
+ _calValid = true;
+ _calSwapXY = false;
+ _uiMode = MODE_DASHBOARD;
+ _forceSettingsRedraw = true;
+ _repaintSettings = true;
+ } else {
+ showSettingsMain( );
+ }
+ return;
+ }
  }
  }