Skip to content

mateuszchrobok/ampio-hacc

 
 

Repository files navigation

Home Assistant Ampio Custom Integration

CI GH-release GH-last-commit hacs_badge

Ampio

Custom integration for Ampio Smart Home System with Home Assistant.

Connects via MQTT directly to the broker running on Ampio Server.

Supported Modules

Module Description
MSERV-3s Server flags
MCON Satel integration
MSENS Environmental sensors (both types)
MROL-4s Roller shutters
MPR-8s Relay outputs
MOC-4 Output controller
MRT-16s Temperature sensors
MLED-1 LED controller
MDIM-8s Dimmers
MRGBu-1 RGBW controller
MDOT-2/4/9/15LCD Touch panels

Required: Ampio MQTT Bridge version 3.41.2+

Installation

HACS (Recommended)

  1. Open HACS in Home Assistant
  2. Go to Integrations
  3. Click the three dots menu → Custom repositories
  4. Add https://github.com/mateuszchrobok/ampio-hacc as Integration
  5. Search for "Ampio" and install
  6. Restart Home Assistant

Manual

Copy the custom_components/ampio folder to your Home Assistant's custom_components directory.

Configuration

  1. Go to Settings → Devices & Services
  2. Click + Add Integration
  3. Search for Ampio
  4. Enter the Ampio Server IP address (default port: 1883)
  5. Use admin credentials from Ampio Smart Home Application
  6. Click Submit

Note: This custom integration uses the same domain as Home Assistant's built-in Ampio integration. The custom component provides enhanced functionality and will take precedence when installed.

Development

# Install dependencies
pip install -e ".[dev]"

# Run linting
ruff check custom_components/ampio

# Run tests
pytest tests/ -v

Credits & Attribution

This project is a fork of the original Ampio Home Assistant integration.

Original Authors

Contributors

Current Maintainer

Thanks

Special thanks to Olek from Ampio for help building the stable MQTT Broker.

License

MIT License - see LICENSE for details. Original copyright © 2020 Klaudiusz Staniek.

About

Ampio HomeAssistant Custom Component

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Python 100.0%