- Created modular Python files (main, utils, discovery, configuration, console_settings, unknown_devices, reporting, unifi_client) - Moved documentation files to docs/ - Moved data files to data/ - Removed old monolithic TasmotaManager.py and TasmotaManager_fixed.py - Updated .gitignore and pyproject.toml - All functionality preserved, command-line interface unchanged Version: 2.0.0
3.6 KiB
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
- Insufficient delay after restart (Current: 2-3 seconds, May need: 5-10 seconds)
- Network congestion - May improve with parallel processing
- Template comparison issue
- Module verification too early
Recommended Fix
- Increase initial verification delay to 5-10 seconds after restart
- Increase retry delays to 5 seconds between attempts
- Add more detailed logging
- 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
- Empty entries in console_set configuration
- Parsing issue in add_from_console_set() function
- Legacy console dict has empty key
Recommended Fix
- Add validation in parsing loop to skip empty entries
- Add validation before sending command
- 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
- Issue #2 - Parallel Processing
- Issue #5 - Blank Console Parameter (easier fix)
- 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