v1.3.0

[desiFish]

Release Notes

Overview

This update focuses on improving safety stability, sensor reliability, and loop architecture separation on ESP32. It enhances fault handling, fixes ultrasonic sensor instability, and improves pump safety response consistency.

---

Added

• Introduced structured pump safety monitoring via monitorPumpSafety()

  • Centralized safety evaluation logic
  • Returns standardized fault codes for system-wide use

• Improved UART ultrasonic sensor handling

  • Uses 0x55 trigger mode for JSN-SR04T (Mode 2 UART response)
  • Parses structured response format: Gap=xxxmm
  • Prevents system reboot when sensor is disconnected
  • Maintains last valid reading when no response is available

• Non-blocking ultrasonic update logic

  • Sensor reads are interval-based
  • No blocking wait for sensor response

---

Modified

• Refactored readUltrasonic()

  • Robust UART buffer handling
  • Validates and filters distance data
  • Prevents invalid or garbage readings

• Improved loop2() architecture

  • Sensor updates separated by responsibility:
    • Current sensing
    • Float sensing
    • Ultrasonic sensing
  • RTC update limited to 1-second interval
  • Current averaging decoupled from main loop cycle
  • Safety monitoring executed only when pump is running

• Pump safety execution improved

  • Fault shutdown moved entirely to loop2()
  • Safety decisions are independent of UI loop execution

• Alert system improved

  • Alerts are latched in loop2()
  • Consumed and cleared in loop() after display handling

• Improved runPumpAuto()

  • Reduced blocking behavior during countdown
  • Allows early exit via button press

• Optimized blinkOrange()

  • Cleaner loop structure
  • Reduced nested blocking behavior complexity

---

Fixed

• Fixed ESP32 reboot issue when ultrasonic module is disconnected
• Fixed UART garbage parsing causing invalid distance readings
• Fixed inconsistent pump shutdown paths across multiple functions
• Fixed alert overwrite risk in safety monitoring
• Fixed timing inconsistencies in loop2() execution cycle

---

Behavior Changes

• Pump shutdown is now exclusively controlled from loop2() safety layer
• UI (loop()) no longer directly manipulates relay state
• Auto-start trigger uses dedicated alert code (99)
• Sensor failure no longer affects system stability

---

Known Limitations

• UI functions (pumpRunSequence, runPumpAuto) are still blocking
• Pump control is not yet fully centralized into a single API (startPump/stopPump)
• Shared variables between cores are not protected using mutex/locks (only volatile where applicable)

---

Notes

This release significantly improves system stability under real sensor conditions and resolves ultrasonic module disconnection reboot issues. Future work will focus on full pump state centralization and removal of remaining blocking UI logic.

---

This discussion was created from the release v1.3.0.