Hitachi Yutaki Integration for Home Assistant

This custom integration allows you to control and monitor your Hitachi Yutaki heat pump through Home Assistant using a Modbus ATW-MBS-02 gateway.

⚠️ Beta Version - Under Development
This integration is currently in active development and should be considered experimental. While it is functional, you may encounter bugs or incomplete features. Use at your own risk and please report any issues you find.

Currently tested only with Yutaki S80 model. Testing with other models is in progress.

Compatibility

• Compatible Models: 2016 and newer Hitachi Yutaki heat pumps
• Tested With: Yutaki S80
• Required Hardware: ATW-MBS-02 Modbus gateway

Important: Models manufactured before 2016 use different Modbus registers and are not compatible.

Features

The integration automatically detects your heat pump model and available features. It creates several devices based on your system configuration:

ATW-MBS-02 Gateway Device

Heat Pump Control Unit Device

Controls

Temperatures

System Status

Performance Metrics

R134a Circuit (S80 Model Only)

Climate Device (up to 2 circuits)

Controls

Configuration

Each circuit operates independently and supports:

• Heating mode (if configured)
• Cooling mode (if configured)
• Auto mode (if both heating and cooling are configured)

The operation status (hvac_action) indicates:

• OFF: Circuit is powered off
• IDLE: Circuit is on but not actively heating/cooling
• HEATING: Circuit is actively heating
• COOLING: Circuit is actively cooling
• DEFROST: Unit is in defrost mode

The preset modes affect the target temperature:

• COMFORT: Normal operation
• ECO: Energy-saving operation with temperature offset

Domestic Hot Water Device (if configured)

Swimming Pool Device (if configured)

Primary Compressor Device

Secondary Compressor Device (S80 Model Only)

Installation

HACS Installation

1. Add this repository to HACS:

   • Open HACS in Home Assistant
   • Click on "Integrations"
   • Click the three dots in the top right corner
   • Select "Custom repositories"
   • Add the repository URL: https://github.com/alepee/hass-hitachi_yutaki
   • Select category: "Integration"
   • Click "Add"

2. Install the integration through HACS:

   • Click on "Integrations"
   • Search for "Hitachi Yutaki"
   • Click "Download"
   • Restart Home Assistant

Manual Installation

1. Copy the custom_components/hitachi_yutaki directory to your Home Assistant custom_components directory
2. Restart Home Assistant

Configuration

1. Go to Settings -> Devices & Services
2. Click "Add Integration"
3. Search for "Hitachi Yutaki"
4. Fill in the required information:
   • Modbus gateway IP address or serial port
   • Modbus slave ID (default: 1)
   • Port (default: 502 for TCP)
   • Scan interval (seconds)

Development

Project Structure

hitachi_yutaki/
├── .github/
│   └── workflows/           # CI/CD workflows
├── custom_components/       # The actual integration
│   └── hitachi_yutaki/
├── scripts/                # Development scripts
│   ├── setup_dev.sh       # Linux/Mac setup
│   └── setup_dev.bat      # Windows setup
└── tests/                  # Test files

Setting Up Development Environment

Option 1: Using Dev Container (Recommended)

This repository includes a dev container configuration, which provides a fully configured development environment. To use it:

1. Install Visual Studio Code and the Dev Containers extension
2. Clone this repository
3. Open the repository in VS Code
4. When prompted to "Reopen in Container", click "Yes"
   • Or click F1, type "Dev Containers: Rebuild and Reopen in Container"

The container includes:

• All required development dependencies
• Pre-configured development tools
• Pre-commit hooks
• A ready-to-use Home Assistant development instance

Option 2: Manual Setup

1. Clone the repository:

   git clone https://github.com/alepee/hass-hitachi_yutaki.git
   cd hitachi_yutaki

2. Set up the development environment:

   
   # Linux/MacOS
   chmod +x scripts/setup_dev.sh
   ./scripts/setup_dev.sh

Windows

scripts\setup_dev.bat

3. Run tests:
```bash
pytest

4. Run Home Assistant with your development version:

   hass -c config

Pre-commit Hooks

The project uses pre-commit hooks to ensure code quality. They are automatically installed when you set up the development environment, but you can also install them manually:

pre-commit install

Contributing

1. Fork the repository
2. Create a new branch for your feature
3. Write tests for your changes
4. Ensure all tests pass and pre-commit hooks are satisfied
5. Submit a pull request

License

This project is under the MIT License. See the LICENSE file for details.

Credits

This integration was developed by Antoine Lépée and is not affiliated with Hitachi Ltd.

Support

For bugs and feature requests, please use the GitHub issues page.