Skip to content

HomeKit Setup

HomeKid edited this page Mar 20, 2020 · 7 revisions

Donate

Wunderground Setup

You have to register a Weather Underground account before you'll add this sensor to your Wi-Fi network! If you're done, save your weather station's ID and KEY and please keep in mind these are case senstive values because its essential to add these correctly on first setup!


Wi-Fi Setup

You must configure wifi network before adding the accessory to HomeKit. To configure Wi-Fi settings, device generates its own Wi-Fi in AP mode. You must connect to it in order to setup your Wi-Fi network.

Simply take your iOS device, go to Setting -> Wi-Fi, and search for an SSID called HomeKid- followed by the module's MAC address and connect to it. For security reasons the AP is password protected!

Default AP password: 12345678


Wait a few seconds until a web appears showing you all Wi-Fi networks that the device has found and ask for entering the WunderGround ID and KEY!.

Please note that WU ID and WU KEY is case sensitive, enter these params as it shown on Wunderground website!

Select yours, and enter password then click the Join button! The module will try to connect the selected Wi-Fi network, this will take a couple of seconds.

Note: If the given password and/or WU ID / WU KEY is wrong, you can Reset the Wi-fi settings by holding the Reset button for 10sec


HomeKit Setup




Default  HomeKit code is 021-82-017.

Also You can scan this HomeKit QR code:



In your iOS device, open Home App and follow normal steps to add a new accessory.
Pairing setup takes about 30 seconds.

For saving some resources, Sensor reading and uploading to Wunderground ONLY happens after pairing with HomeKit!


Note: If pairing fails, you can unpower your device, repower it, and start HomeKit setup again (Wifi settings keep configured)

Sensor Fault Detection

I've added HomeKit Characteristic for detecting Light Sensor, BME280 and VEML6075 sensor fault. If any of these doesn't work properly, HomeKit will notify you about this problem. When VEML6075 or BH1750 sensor has any fault, data uploaded to WunderGround will be 0 (zero). If the BME280 has any problems uploading to WunderGround will be turned OFF!

Barometric Pressure calibration

The sensor works the same as an original Elgato EVE Degree.

To calibrate - for proper data - the barometric pressure based on your home's altitude, please download Elgato EVE app!

After successful pairing, find the Sensor, and click the Gear icon at the upper right corner and after this, click on Elevation tab. After that, click on Detect and go back to the main accessory page! EVE needs your location for these step! The Sensor will save this setting until you factory reset the module!

Other thing to mention is sadly HomeKit NOT supports barometric pressure at the moment, so you'll need 3rd party HomeKit apps (eg.: EVE) for reading these values!

Reset

Resetting device to factory defaults

The code has a Reset function in case of something goes wrong. Wait about 5 seconds to allow device to boot completely, and then long press the button for at least 10sec!


All configured settings has been removed and device is restarting. This removes HomeKit and Wi-Fi settings and stepper endpoint settings too, then your device will go to Access Point mode next time in order to reconfigure Wi-Fi.

Reconnecting to Wifi network

If wifi network becomes unreachable, device will keep searching Wi-Fi automatically until it can connect again when Wi-Fi becomes available.



If your ESP8266 module doesn't have physical button attached, you can use jumper wires to connect GPIO0 and GND for 10 seconds.

Note: Resetting the accessory may not remove it from the Home app, you need to do it manually after resetting!

paypal