tmalex/ariston2mqtt_ihost repository overview

ARISTON2MQTT BRIDGE FOR SONOFF IHOST & HOME AUTOMATION

An all-in-one Ariston NET Cloud to MQTT Bridge and Live Web Dashboard, specially engineered for Sonoff iHost (eWeLink CUBE), Home Assistant, Node-RED, and standard Docker environments.

Seamlessly integrates your Ariston boiler into your local smart home setup with real-time telemetry, bi-directional control, automated cost calculation, and intelligent rate-limiting protection.

KEY FEATURES:

1. Native Sonoff iHost Integration: Automatically creates and syncs an active virtual boiler device on the eWeLink CUBE dashboard.

2. Modern Web Dashboard: Responsive dark-mode user interface on port 8080 with live telemetry, status badges, interactive control modal, and language switcher.

3. Complete MQTT Telemetry: Real-time sensor publishing for water pressure, room temperature, target setpoint, outdoor probe, domestic hot water (DHW), heating flow and return temperatures, thermal delta T, flame status, localized error codes, and gas/electricity consumption in kWh and m3.

4. Bi-Directional MQTT Boiler Control:

   • Boiler Plant Mode: summer, winter, off (standby).
   • Room Operating Mode (Zone 1): manual (permanent setpoint) or time_program (scheduled profile).
   • Room Target Temperature: adjust target room temperature in 0.5 C steps.
   • Domestic Hot Water (DHW) Temperature: adjust water heater setpoint.
   • DHW Comfort Preheating Function: disabled (economy), time_based (30 min after draw), always_active (permanently preheated heat exchanger).

5. Smart Cloud Protection Engine (20s Debounce + 200s Cooldown): Prevents Ariston Cloud rate limits and HTTP 500/429 errors by buffering multiple adjustments into a single batch and enforcing a 200-second safety cooldown between write cycles.

6. SD-Card & Flash Friendly: Diagnostic logs live exclusively in an in-memory RAM circular ring buffer (120 lines max) with zero continuous disk writes, preserving SD card lifespan on embedded hardware like iHost.

7. Automated Energy & Cost Tracking: Computes real-time energy bills in your chosen currency (EUR, USD, GBP, RON, etc.) based on your tariff rates.

8. Multi-Language Support: English, Romanian, Italian, German, Spanish, plus custom JSON locale export/import.

   =======================================================
   Ariston2MQTT Bridge for Sonoff iHost & Smart Home

An all-in-one Ariston NET Cloud to MQTT Bridge and Live Web Dashboard for Sonoff iHost (eWeLink CUBE), Home Assistant, and Node-RED.

Provides real-time boiler telemetry (pressure, temperatures, flame, error codes, energy costs) and bi-directional MQTT control (boiler mode, room target temperature, manual vs schedule mode, DHW comfort). Features smart 20s command debouncing and 200s cloud
cooldown protection to avoid API rate limits, with 100% RAM logging to protect SD-card storage.

IMPORTANT IHOST SETUP INSTRUCTIONS:

1. Network Mode:
   Select "Host" network mode (NOT "Bridge") when creating the container in iHost. This allows automatic discovery and smooth local MQTT / mDNS communication.
2. Data Persistence:
   Map the container volume path /data to a persistent folder on your iHost SD card storage (e.g. /data). This ensures your credentials and settings are preserved across container updates and restarts.
3. Web Dashboard:
   Access the web configuration interface at:
   http://ihost.local:8080⁠

Quick Docker Run Command:
docker run -d --name ariston2mqtt --restart unless-stopped --network host -v /opt/ariston2mqtt/data:/data tmalex/ariston2mqtt_ihost:latest

QUICK START:

Docker Run (CLI): docker run -d
--name ariston2mqtt
--restart unless-stopped
--network host
-v /opt/ariston2mqtt/data:/data
-e ARISTON_USER="[email protected]⁠"
-e ARISTON_PASS="your-ariston-password"
-e MQTT_HOST="192.168.0.xxx"
-e MQTT_PORT="1883"
-e MQTT_USER="(optional)"
-e MQTT_PASS="your-mqtt-password"
tmalex/ariston2mqtt_ihost:latest

Sonoff iHost (eWeLink CUBE) Setup:

1. In iHost web UI, go to Docker -> Image -> Search "tmalex/ariston2mqtt_ihost:latest" and click Download.
2. In Containers -> Run Container:
   • Port Binding: 8080 -> 8080
   • Volume: host path on SD card -> /data
   • Enter your credentials in Environment Variables or via WebUI on first run.
3. Access dashboard at: http://ihost.local:8080⁠

MAIN MQTT TOPICS:

Telemetry (Boiler State):

• ariston/boiler/water_pressure (bar)
• ariston/boiler/room_temperature (C)
• ariston/boiler/zone_target_temperature (C)
• ariston/boiler/zone_mode_text (manual / time_program)
• ariston/boiler/outdoor_temperature (C)
• ariston/boiler/dhw_temperature (C)
• ariston/boiler/dhw_target_temperature (C)
• ariston/boiler/dhw_mode_text (disabled / time_based / always_active)
• ariston/boiler/ch_flow_temperature (C)
• ariston/boiler/ch_return_temperature (C)
• ariston/boiler/thermal_delta (C)
• ariston/boiler/flame_status (true / false)
• ariston/boiler/gas_total_current_month (kWh)
• ariston/boiler/gas_total_m3_current_month (m3)
• ariston/boiler/total_cost_current_month (estimated bill)
• ariston/boiler/state (full JSON state)

Commands (Remote Control via Node-RED / Home Assistant):

• ariston/boiler/cmd/set_mode -> summer / winter / off
• ariston/boiler/cmd/set_zone_mode -> manual / time_program
• ariston/boiler/cmd/set_ch_temp -> numeric value (e.g. 21.5)
• ariston/boiler/cmd/set_dhw_temp -> numeric value (e.g. 48.0)
• ariston/boiler/cmd/set_dhw_mode -> disabled / time_based / always_active

#############################

1. Interactive Telemetry History & Live Charts • Added real-time tracking for: Room Temp, Target Setpoint, Outdoor Temp, Flow & Return Temperatures, DHW (Hot Water), Water Pressure, and Flame burner status. • You can toggle any line directly from the legend (and the dashboard remembers your preferences). • Configurable retention from 24 hours up to 90 days.

2. Smart Boiler Health & Leak Diagnostics Instead of waiting for an error to pop up on the boiler screen, the bridge now analyzes telemetry trends:

• Slow Leak Detection: Watches cold/resting pressure over 7–14 days and warns you if there’s a slow pressure drop before error 108 (Low Water Pressure) shuts down heating. • Expansion Vessel Fault Warning: Detects abnormal pressure spikes when the boiler heats up (identifying a deflated air cushion or ruptured membrane). • Winter Condensation Efficiency Score: Measures how much time your return temperature stays below 53°C for optimal condensing efficiency.

1. Native Model Context Protocol (MCP) Server for AI If you use AI agents or local assistants like Hermes, OpenClaw, Claude Desktop, or LibreChat, the bridge now includes a built-in MCP server:

• Endpoint ex: http://ihost.local:8080/mcp/sse⁠ (or /mcp) • Exposed Tools: • get_boiler_telemetry() — live readings & status • get_boiler_history(hours) — historical curves • get_health_diagnostics() — instant leak & expansion vessel report • set_room_temperature(), set_boiler_mode(), set_dhw_temperature()

1. Multi-language • Multi-language WebUI support (English, Romanian, Italian, German, Spanish, French).

Quick Run on iHost: • Image: tmalex/ariston2mqtt_ihost:latest (or :v2.4.0 / :armv7) • Network: Host mode • Mount: /data (Host path on iHost SD card) • WebUI: http://ihost.local:8080⁠ (or your iHost IP)