TasmotaManager/KNOWN_ISSUES.md

120 lines
3.6 KiB
Markdown

# Known Issues - TasmotaManager
This document tracks known issues discovered during testing that are deferred for future fixes.
---
## Issue #4: Template Verification Timeout/Failure
**Status:** Deferred
**Discovered:** 2025-10-28 (Testing after v1.02)
**Severity:** Medium
**Affects:** Template update and verification process
### Description
Template verification consistently fails even after 3 retry attempts. The device restarts successfully and the template appears to be applied, but the verification step times out or reports mismatches.
### Example Log Output
2025-10-28 09:18:18 - WARNING - MasterFan-0110: Template mismatch on verification (attempt 3)
2025-10-28 09:18:18 - WARNING - MasterFan-0110: Template verification failed (attempt 3/3)
2025-10-28 09:18:50 - WARNING - BathFan-4919: Template mismatch on verification (attempt 2)
### Observed Pattern
- Occurs on multiple devices
- All 3 verification attempts fail
- Happens after successful restart command
- May be timing-related
### Possible Causes
1. Insufficient delay after restart (Current: 2-3 seconds, May need: 5-10 seconds)
2. Network congestion - May improve with parallel processing
3. Template comparison issue
4. Module verification too early
### Recommended Fix
1. Increase initial verification delay to 5-10 seconds after restart
2. Increase retry delays to 5 seconds between attempts
3. Add more detailed logging
4. Consider checking if device is responsive before verification
### Related Code
- File: TasmotaManager.py
- Method: check_and_update_template()
- Lines: ~950-1100
---
## Issue #5: Blank Console Parameter Name
**Status:** ✅ FIXED (v1.04-console-empty-param-fixed)
**Discovered:** 2025-10-28 (Testing after v1.03)
**Severity:** Medium
**Affects:** Console settings application
### Description
The console settings code is attempting to set a parameter with a blank/empty name, causing verification failures and errors.
### Example Log Output
2025-10-28 09:18:29 - WARNING - BathFan-4919: Verification failed for blank parameter
2025-10-28 09:18:31 - ERROR - BathFan-4919: Failed to set console parameter after 3 attempts
### Observed Pattern
- Affects multiple devices
- Empty parameter name
- Occurs before rule1 and Rule1 commands
### Possible Causes
1. Empty entries in console_set configuration
2. Parsing issue in add_from_console_set() function
3. Legacy console dict has empty key
### Recommended Fix
1. Add validation in parsing loop to skip empty entries
2. Add validation before sending command
3. Check configuration files for empty entries
### Related Code
- File: TasmotaManager.py
- Method: apply_console_settings()
- Lines: ~1600-1800
---
## Testing Notes
**Test Environment:**
- Date: 2025-10-28
- Version: v1.03-mqtt-delay-fixed
- Devices Tested: ~20+ devices
**Devices Affected:**
- MasterFan-0110
- BathFan-4919
- BedLamp-1516
- Multiple other devices
---
## Priority for Future Work
1. Issue #2 - Parallel Processing
2. Issue #5 - Blank Console Parameter (easier fix)
3. Issue #4 - Template Verification (more complex)
---
## Completed Issues
**Issue #1** - Template Activation Fix (v1.02-template-activation-fixed)
**Issue #3** - MQTT Delay Fix (v1.03-mqtt-delay-fixed)
**Issue #5** - Blank Console Parameter Fix (v1.04-console-empty-param-fixed)
- Root cause: Empty string in Traditional console_set array in configuration
- Fixed by removing the blank entry from network_configuration.json
---
## Notes
- Issues #4 and #5 discovered during production testing on 2025-10-28
- Both issues are non-critical - devices appear to function despite errors
- Recommend addressing after Issue #2 is complete