Atomberg
Integration for Atomberg smart fans
Tested on
Installation
Method 1: Using HACS
- Open your Home Assistant UI.
- Go to "HACS" (Home Assistant Community Store).
- Click on "Integrations" from the top menu.
- Click the three dots in the upper right corner and select "Custom Repositories".
- Under "Add custom repository", enter:
- URL:
https://github.com/dasshubham762/atomberg-integration
- Category: Integration
- Click "Add".
- Go back to the "Integrations" tab in HACS.
- Search for "Atomberg" in the search bar.
- You should see the Atomberg integration listed.
- Click "Install" and follow any prompts to complete the installation.
Method 2: Manual Installation
- Using the tool of choice open the directory (folder) for your HA configuration (where you find
configuration.yaml
).
- If you do not have a
custom_components
directory (folder) there, you need to create it.
- In the
custom_components
directory (folder) create a new folder called atomberg
.
- Download all the files from the
custom_components/atomberg/
directory (folder) in this repository.
- Place the files you downloaded in the new directory (folder) you created.
- Restart Home Assistant.
Configuration
Step 1: Generate API Key and Refresh Token
- Go to Atomberg Developer Portal.
- Follow the instructions to generate your
api_key
and refresh_token
.
Step 2: Add Atomberg Integration to Home Assistant
- Open your Home Assistant UI.
- Navigate to "Configuration" -> "Integrations".
- Click the "+" icon to add a new integration.
- Search for "Atomberg" in the integration search bar and select it.
Step 3: Enter API Key and Refresh Token
- Enter your
api_key
and refresh_token
in the appropriate fields.
- Submit the form.
Compatibility and Requirements
- Please note that this integration is designed for the latest series of Atomberg fans and may not work with older models.
- The integration relies on cloud APIs for communication with your Atomberg fans.
- This integration uses UDP port
5625
for updating the fan state locally, make sure that port is not in use by any other application and that it is not blocked by any firewall.
Contributions are welcome!
If you want to contribute to this please read the Contribution guidelines
Credits