/ZTE-MC-Home-assistant-repo

ZTE MC801A, MC888, MC889 Home assistant Custom integration

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

GitHub GitHub Repo stars GitHub release hacs_badge

CodeQL GitHub Workflow Status Main Build Validate with hassfest Validate with Hass Action

GitHub contributors Maintenance GitHub commit activity GitHub commits since tagged version GitHub last commit Codecov branch installation_badge

ZTE Router Integration for Home Assistant

Component to integrate some ZTE routers as a device trackers in home assistant.

Installation

Manual Installation

  1. Download the zte-router
  2. Place the files of the .zip in your root directory of homeassistant (That should only effectivly place files into /custom_components/zte/router)
  3. Restart Homeassistant
  4. Search in "integration" for the ZTE Router integration and add it to Homeassistant
  5. Enter the Router IP, password and select the model you have and wait for the integration to install all the device sensors.

Installation with HACS

Method 1: Open your Home Assistant instance and open a repository inside the Home Assistant Community Store. - in prep not working (waiting for HACS PR to be completed)

  1. Or HACS > Integrations > ⋮ > Custom Repositories
  2. Repository: paste the url of this repo
  3. Category: Integration
  4. Click Add
  5. Close Custom Repositories modal
  6. Click + EXPLORE & DOWNLOAD REPOSITORIES
  7. Search for ZTE router
  8. Click Download
  9. Restart Home Assistant
  10. Search in "integration" for the ZTE Router integration and add it to Homeassistant or click this link : Open your Home Assistant instance and start setting up a new integration.
  11. Enter the Router IP, password and select the model you have and wait for the integration to install all the device sensors.

Configuration

Supported models :

MC801A
MC889
MC888

enter image description here

This repository contains the ZTE Router custom integration and an add-on to deploy it in Home Assistant.

Custom Integration

The custom integration is located in the custom_components/zte_router directory.

Bugs:

  1. Username currently not supported
  2. Errors in Home assistant log - They are for now present until i polish the addon
  3. Various errors in sensors etc. - This integration is classified as beta right now but can be tested by anyone.
  4. Any suggestion you have please open the issues tab
  5. I will push new builds as soon i will have more time. Make sure you "star" this integration.
  6. If u wanna donate for beer let me know :P

Contributors

If u have any sugestion or you are doing pull requests and adding new features, increment version number by 1 in manifest.json, so that github automation automaticly create a new release.