Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/simbaja/ha_gehome

GE Home Appliances (SmartHQ) for Home Assistant
https://github.com/simbaja/ha_gehome

home-assistant home-assistant-component homeassistant homeassistant-custom-component python smarthq

Last synced: 3 months ago
JSON representation

GE Home Appliances (SmartHQ) for Home Assistant

Awesome Lists containing this project

README 

        
# GE Home Appliances (SmartHQ)



[![GitHub Release][releases-shield]][releases]

[![GitHub Activity][commits-shield]][commits]

[![License][license-shield]](LICENSE)

[![hacs][hacsbadge]][hacs]



Integration for GE WiFi-enabled appliances into Home Assistant.  This integration currently supports the following devices:



- Fridge

- Oven

- Dishwasher / F&P Dual Dishwasher 

- Laundry (Washer/Dryer)

- Whole Home Water Filter

- Whole Home Water Softener

- Whole Home Water Heater

- A/C (Portable, Split, Window, Built-In)

- Range Hood

- Advantium

- Microwave

- Opal Ice Maker

- Coffee Maker / Espresso Maker

- Beverage Center



**Forked from Andrew Mark's [repository](https://github.com/ajmarks/ha_components).**

## Updates



Unfortunately, I'm pretty much at the end of what I can do without assistance from others with these devices that can help provide logs.  I'll do what I can to make updates if there's something broken, but I am not really able to add new functionality if I can't get a little help to do so.



## Home Assistant UI Examples 

Entities card:



![Entities](https://raw.githubusercontent.com/simbaja/ha_components/master/img/appliance_entities.png)



Fridge Controls:



![Fridge controls](https://raw.githubusercontent.com/simbaja/ha_components/master/img/fridge_control.png)



Oven Controls:



![Fridge controls](https://raw.githubusercontent.com/simbaja/ha_components/master/img/oven_controls.png)



A/C Controls:



![A/C controls](https://raw.githubusercontent.com/simbaja/ha_components/master/img/ac_controls.png)



## Installation (Manual)



1. Using the tool of choice open the directory (folder) for your HA configuration (where you find `configuration.yaml`).

2. If you do not have a `custom_components` directory (folder) there, you need to create it.

3. In the `custom_components` directory (folder) create a new folder called `ge_home`.

4. Download _all_ the files from the `custom_components/ge_home/` directory (folder) in this repository.

5. Place the files you downloaded in the new directory (folder) you created.

6. Restart Home Assistant

7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "GE Home"



## Installation (HACS)



Please follow directions [here](https://hacs.xyz/docs/faq/custom_repositories/), and use https://github.com/simbaja/ha_gehome as the repository URL.



## Configuration



Configuration is done via the HA user interface. You need to have your device registered with the [SmartHQ](https://www.geappliances.com/connect) website.



Once the HACS Integration of GE Home is completed:



1. Navigate to Settings --> Devices & Services

2. Click **Add Integration** blue button on the bottom-right of the page

3. Locate the **GE Home (SmartHQ)** "Brand" (Integration)

4. Click on the integration, and you will be prompted to enter a Username, Password and Location (US or EU)

5. Enter the email address you used to register/connect your device as the Username

6. Same with the password

7. Select the region you registered your device in (US or EU).

8. Once you submit, the integration will log in and get all your connected devices.

9. You can define in which area you device is, then click **Finish**

10. Your sensors should appear as **sensor._**

    ie: sensor.fs12345678_dishwasher_cycle_name



## Change Log



Please click [here](CHANGELOG.md) for change information.



[commits-shield]: https://img.shields.io/github/commit-activity/y/simbaja/ha_gehome.svg?style=for-the-badge

[commits]: https://github.com/simbaja/ha_gehome/commits/master

[hacs]: https://github.com/custom-components/hacs

[hacsbadge]: https://img.shields.io/badge/HACS-Custom-orange.svg?style=for-the-badge

[license-shield]: https://img.shields.io/github/license/simbaja/ha_gehome.svg?style=for-the-badge

[maintenance-shield]: https://img.shields.io/badge/maintainer-Jack%20Simbach%20%40simbaja-blue.svg?style=for-the-badge

[releases-shield]: https://img.shields.io/github/release/simbaja/ha_gehome.svg?style=for-the-badge

[releases]: https://github.com/simbaja/ha_gehome/releases