Skip to content

v1.0.0 - ACIT Home Assistant Integration

Choose a tag to compare

View all tags
@jdu-acit jdu-acit released this 17 Feb 10:12
v1.0.0
06d2693

🚀 ACIT Home Assistant Integration v1.0.0

Home Assistant custom integration for ACIT electronic boards with support for multiple product models.

✨ Features

  • 🌡️ Multi-product support - ThermACEC, AccuBloc (coming soon)
  • 🚀 HTTP RPC API - JSON-RPC 2.0 protocol for commands
  • 📡 WebSocket notifications - Real-time push updates
  • 🔍 mDNS auto-discovery - Automatic device detection via Zeroconf
  • 🔄 OTA update support - Update entity for firmware management
  • 🌡️ Climate entity - Temperature control with setpoint
  • 📊 Temperature sensor - Real-time ambient temperature
  • 🌐 Multi-language - Complete translations (EN/FR)
  • 📦 HACS compatible - Easy installation and updates

🏗️ Architecture

HTTP RPC API

  • Endpoint: http://<device-ip>/rpc
  • Protocol: JSON-RPC 2.0
  • Methods:
    • Thermostat.GetStatus - Get current temperature, setpoint, heater level, fan speed
    • Thermostat.GetConfig - Get device configuration (model, version, MAC, limits)
    • Thermostat.SetTargetTemp - Set temperature setpoint

WebSocket Notifications

  • Endpoint: ws://<device-ip>/ws
  • Real-time push notifications when state changes
  • Method: NotifyStatus

mDNS Discovery

  • Service Type: _acit._tcp.local.
  • Hostname Pattern: acit-thermacec-<MAC>.local
  • Automatic discovery in Home Assistant

📦 Installation

Via HACS (Recommended)

  1. Open HACS in Home Assistant
  2. Click on "Integrations"
  3. Click on the ⋮ menu → "Custom repositories"
  4. Add URL: https://github.com/jdu-acit/ACIT_HA_Integration
  5. Select category "Integration"
  6. Search for "ACIT" and install
  7. Restart Home Assistant

Manual Installation

  1. Download acit.zip from this release
  2. Extract to your config/custom_components/ directory
  3. Restart Home Assistant

⚙️ Configuration

Option 1: Auto-Discovery (Recommended)

  1. Power on your ACIT device
  2. Go to Settings → Devices & Services
  3. Device appears automatically in Discovered
  4. Click Configure and confirm

Option 2: Manual Configuration

  1. Go to Settings → Devices & Services → Add Integration
  2. Search for "ACIT"
  3. Enter device IP address and port
  4. Click Submit

📊 Created Entities

  • Climate Entity - Temperature control (HEAT mode)

    • Target temperature (5°C - 35°C)
    • Current temperature
    • Extra attributes: heater_level, fan_speed

  • Temperature Sensor - Ambient temperature (°C)

    • Real-time updates via WebSocket

  • Update Entity - OTA firmware updates

    • Check for updates
    • Install updates
    • Version tracking

🔧 Requirements

  • Home Assistant 2024.1.0 or higher
  • ACIT device with firmware v2.0+
  • Local network connectivity

📝 License

MIT License - See LICENSE file for details

Enjoy! 🎉

Assets 3
Loading