MOOX Track v2.0.2

MOOX Track v2.0.2

New logic for automatic reconnection, 12-hour grace period for server issues, and user-friendly logging. Built for 24/7 operation without user intervention.

---

✨ Key Highlights

🔄 Automatic Reconnection

• Continuous Background Retries — When the server is unavailable or there are connection issues, the integration continuously retries in the background for up to 12 hours
• Smart Grace Period — No action needed during temporary outages; you'll only be notified if intervention is required
• Instant Recovery — Automatically reconnects when connectivity is restored, no restart needed

🛡️ Production-Ready Reliability

• Cached Data Display — Last known device positions remain visible while reconnecting
• State Persistence — Grace period state survives Home Assistant restarts
• Session Recovery — Automatic re-authentication when session expires, with smart retry logic

📝 User-Friendly Logging

• Clear Status Messages — No alarming errors during temporary issues
• Recovery Confirmation — "Connection restored. Everything is working normally."
• Actionable Alerts — Only warns when user action is actually needed

---

🆕 What's New in 2.0.2

Feature	Description
12-Hour Grace Period	Continuously retries connection for 12 hours before prompting re-authentication
1-Hour Grace Period	Shorter window for new credentials (faster feedback for wrong passwords)
Connection Logging	Clear logs: "Connected to MOOX Track. Real-time device tracking is now active."
Recovery Logging	Confirmation when issues resolve: "Connection restored. Everything is working normally."
Concurrent Request Handling	Improved handling of multiple API requests during session expiration
Timezone Fix	Correct timezone handling for persisted timestamps

📊 Full Feature Set

🔐 Zero External Dependencies

• Native Python and Home Assistant APIs only
• Faster installation, reduced attack surface

🎛️ Config Flow Integration

• Full UI-based setup, no YAML required
• Configurable polling interval (minimum 30 seconds)

📡 40+ Sensors Per Device

• GPS coordinates, speed, altitude, accuracy
• Battery level, power voltage, satellites, RSSI
• OBD-II diagnostics (RPM, fuel, DTC codes)
• Smart alarms and warnings

🚨 Smart Alarm Detection

• Overspeed, accidents, towing, jamming
• Harsh acceleration, braking, cornering
• Geofence enter/exit events

---

⚠️ Breaking Changes from 1.x

Migration Required: Config entries auto-migrate, but 1.x YAML configs must be removed.

1. Remove any moox_track: YAML entries
2. Reconfigure via Settings → Devices & Services → Add Integration
3. External dependencies (pytraccar, stringcase) no longer needed

---

📦 Installation

HACS (Recommended)

1. HACS → Integrations → ⋮ → Custom repositories
2. Add: https://github.com/moox-it/hass-moox-track
3. Install MOOX Track and restart Home Assistant

Manual

Download latest release

wget https://github.com/moox-it/hass-moox-track/releases/latest/download/moox_track.zip

Extract to custom_components

unzip moox_track.zip -d config/custom_components/

Restart Home Assistant---

🔐 Security

Feature	Status
Credential Storage	✅ Encrypted via HA config entries
Communication	✅ HTTPS only (TLS 1.2+)
Dependencies	✅ Zero external packages
Data Privacy	✅ Direct to MOOX servers only

---

📚 Resources

• Documentation: README.md • Italiano
• Issues: GitHub Issues
• Changelog: CHANGELOG.md

MOOX Track Integration 2.0.1

MOOX Track Integration 2.0.1

Production-ready release with silent error handling, automatic recovery, and comprehensive edge case protection. Built for 24/7 operation without user intervention.

✨ Key Highlights

🛡️ Production-Ready Reliability

• Silent Session Recovery — Automatic re-authentication on ERROR_004 without errors or user intervention
• Graceful Degradation — Returns cached data during network issues, maintaining entity availability
• Exponential Backoff — Smart retry logic with rate limiting (max 10 attempts) for login failures
• Edge Case Protection — Robust handling of malformed JSON, missing fields, and invalid data types

🔐 Zero External Dependencies

• Native Python and Home Assistant APIs only
• Faster installation, reduced attack surface

🎛️ Config Flow Integration

• Full UI-based setup, no YAML required
• Configurable polling interval (minimum 30 seconds)

📊 40+ Sensors Per Device

• GPS coordinates, speed, altitude, accuracy
• Battery level, power voltage, satellites, RSSI
• OBD-II diagnostics (RPM, fuel, DTC codes)
• Smart alarms and warnings

🚨 Smart Alarm Detection

• Overspeed, accidents, towing, jamming
• Harsh acceleration, braking, cornering
• Geofence enter/exit events

🆕 What's New in 2.0.1

• API Compliance: Login now uses 'email' field with 'remember_me: true' for 180-day sessions
• Session Handling: Proper distinction between invalid credentials and expired sessions
• Error Recovery: Connection errors return cached data silently (no log spam)
• Auth Flow: Authentication failures trigger Home Assistant reauth UI
• Code Quality: Removed ~300 lines of dead code while improving functionality
• Compatibility: Python 3.11+ with typing_extensions fallback for TypeAlias### Technical Changes
  | Component | Change |
  |-----------|--------|
  | moox_client.py | Aligned with official API docs, removed HTTP 401 handling |
  | coordinator.py | Renamed MooxTokenExpiredException → MooxSessionExpiredException |
  | Config Entry | Auto-migration from version 0/1 → 2 (username → email) |
  | Retries | Increased from 2 to 3 for transient errors |

⚠️ Breaking Changes from 1.x

Migration Required: Config entries auto-migrate, but 1.x YAML configs must be removed.

• Remove any moox_track: YAML entries
• Reconfigure via Settings → Devices & Services → Add Integration
• External dependencies (pytraccar, stringcase) no longer needed

📦 Installation

HACS (Recommended)
Repository: https://github.com/moox-it/hass-ttps://github.com/moox-it/hass-moox-track/releases/latest/download/moox_track.zip

Extract to custom_components

unzip moox_track.zip -d config/custom_components/

Restart Home Assistant## 🔐 Security

Feature	Status
Credential Storage	✅ Encrypted via HA config entries
Communication	✅ HTTPS only (TLS 1.2+)
Dependencies	✅ Zero external packages
Data Privacy	✅ Direct to MOOX servers only

📚 Resources

• Documentation: README.md • Italiano
• Issues: GitHub Issues
• Changelog: Commits since 2.0

---

Requires Home Assistant 2025.11+

Made with ❤️ by MOOX SRLS

🎉 Major Release - Complete Rewrite

MOOX Track Integration 2.0

MOOX Track Integration 2.0 introduces a faster, more secure and robust experience with zero external dependencies, a modern UI-based setup, and full-featured GPS tracking tightly integrated with Home Assistant.

---

✨ What’s New

• 🔐 Zero External Dependencies
  Uses only native Python and Home Assistant APIs → faster installs, reduced attack surface, easier maintenance.

• 🎛️ Full Config Flow Integration
  No YAML needed. Configure everything directly from Settings → Devices & Services using Home Assistant’s UI.

• 📊 40+ Sensors per Device
  Rich telemetry for each tracker: GPS coordinates, speed, battery, OBD-II data, and multiple smart alarms.

• 🚨 Smart Alarm Detection
  Detect and act on overspeed, accidents, towing, jamming, harsh driving, and more — all exposed as entities.

• 🔧 OBD-II Diagnostics
  For compatible devices: monitor RPM, fuel level and diagnostic trouble codes (DTCs) directly from Home Assistant.

• 🌍 Built for Home Assistant 2025.11+
  Aligned with the latest HA standards, best practices and UI workflows.

---

⚠️ Breaking Changes

• Config Flow Required
  Remove any moox_track YAML configuration.
  Re-create the integration via Settings → Devices & Services.

• No External Dependencies
  Third-party packages pytraccar and stringcase have been removed.

• Reconfiguration Needed
  Even existing setups must be reconfigured once through the UI.

---

📦 Installation

Via HACS

1. Add custom repository:
   https://github.com/moox-it/hass-moox-track
2. Install MOOX Track Integration from HACS.
3. Go to Settings → Devices & Services and configure.

Manual

1. Download the latest package from
   Releases
2. Extract into:
   <config>/custom_components/moox_track/
3. Restart Home Assistant.
4. Configure via Settings → Devices & Services.

---

🔐 Security & Privacy

• ✅ Credentials are encrypted and stored securely
• ✅ HTTPS-only communication
• ✅ Direct connection only to MOOX Track servers
• ✅ No external Python dependencies
• ✅ No data sent to third parties

---

📚 Documentation

• Main: README.md
• Italiano: README_it.md

🐛 Issues & Feedback
Use GitHub Issues for bug reports, feature requests, and support.

---

Made with ❤️ by MOOX SRLS

1.8

FIX a bug that prevent plugin execution starting from HASS 2025.1.1

1.6

Fix empty attributes for devices with geofences activated.
Fix on "ignition", "power" and "odometer" attributes that are now shown correctly.

1.5

Fix warnings with HASS > 2024.1.1 and add "ignition", "power" and "odometer" attributes.

1.4

Forced extensions version check to avoid issues during upgrades.

1.3

This fix a bug that prevent plugin startup with HASS version 2022.8

1.2

FIX plugin not starting on HASS 2021.12.1

1.1

Update manifest.json