Unofficial integration for Aux Cloud connected appliances like air conditioners and heat pumps. Aux Cloud is a service based on the Broadlink platform that allows you to control your appliances from anywhere. This is a cloud alternative to replacing wifi module in your AC. This integration will also allow you to control AUX heat pumps. The implementation of API requests is based on public resources from Broadlink documentation and reverse engineering.

• Control AUX air conditioners and heat pumps from Home Assistant
• View device status and sensor readings
• Support for both personal and shared devices
• Secure credential storage (when configured through UI)

1. Make sure you have HACS installed
2. Go to HACS > Integrations
3. Search for "AUX Cloud"
4. Install the integration
5. Restart Home Assistant

1. Download this repository
2. Copy the custom_components/aux_cloud folder to your Home Assistant custom_components directory
3. Restart Home Assistant

The recommended way to set up this integration is through the Home Assistant UI:

1. Go to Settings > Devices & Services
2. Click the + Add Integration button
3. Search for "AUX Cloud" and select it
4. Enter your AUX Cloud email and password
5. Select your region (e.g., Europe, USA or China - based on your AUX Cloud account)
6. Select which devices you want to add to Home Assistant

Your credentials will be stored securely in Home Assistant's .storage/core.config_entries storage.

After setting up the integration, your AUX devices will be available as climate entities in Home Assistant. You can control them through:

• The Home Assistant UI
• Automations
• Scripts
• Voice assistants integrated with Home Assistant

If you encounter issues:

1. Check the Home Assistant logs for error messages
2. Verify your AUX Cloud credentials and selected region is correct
3. Ensure your devices are online and accessible through the AUX Cloud app
4. If you've recently changed your password, you'll need to reconfigure the integration

• Logging in the App: The login process in the app will log out any existing sessions (at least on Android). If you log in the app, reload the integration.

• Shared devices: If your account has shared devices, you might encounter an issue that Platform aux_cloud does not generate unique ids, check your HA logs and transfer ownership of the device to your account.

This integration is still in development. Current status:

• Reverse engineer the AUX Cloud API
• [API] Implement login
• [API] Implement getting devices' information
• [Home Assistant] Config flow with device selection
• [API] Implement updating device state
• [Home Assistant] Cloud data fetcher
• [Home Assistant] Data coordinator
• [Home Assistant] climate entity
• [Home Assistant] sensor entity
• [Home Assistant] water heater entity
• [Home Assistant] basic sensor entities
• [Home Assistant] switch entity
• [Home Assistant] Fix reconfigure - adding new devices requires reload of integration
• [Home Assistant] Parallelize data fetching for devices - don't wait for one device to finish before starting another
• [Home Assistant] Add an icon to https://github.com/home-assistant/brands
• [API] Implement session check and re-login
• [Home Assistant] services
• [Home Assistant] Manual tests
• [Home Assistant] Unit tests
• [API] WebSocket connection for instant updates
• Documentation
• Add to HACS
• Translations

This integration communicates with the AUX Cloud servers but stores your credentials locally in Home Assistant's internal storage (when configured through the UI). No data is shared with third parties beyond what's necessary to communicate with AUX Cloud services.

Contributions are welcome! Please feel free to submit a Pull Request.

This document describes how to run tests and perform code quality checks for the AUX Cloud Integration.

Integration support and was tested on devices:

• AC:
  1. AUX Freedom model AUX-12F2H/I
• Heat pump:
  1. AUX ACHP-HO8/4R3HA-I

Before running tests, ensure you have all the required dependencies installed:

pip install -r requirements.test.txt

Run all tests:

pytest

Run tests and show coverage information:

pytest --cov=custom_components

Run pylint on the entire component:

pylint custom_components/aux_cloud

The project uses Black for code formatting. To format the code, run:

black custom_components/aux_cloud