HomeHome.App

HTTP Server

HTTP Server is for settings, firmware update and 3th party apps (check server commands below). You can control all your devices in smart.homehome.app

HTTP Server Security

We are asking your Email in a new browser to verify that you are the user. You can use DNS provider like duckdns.org to reach your device outside of your home. If you will use a DNS we recommend you to have a long word in your DNS account like:
myPrivateDnsIsHardToFind.duckdns.org so other unwanted users-BOTS will not try to see your device. Some BOT Request Examples /1/index.php, /download/index.php, /phpMyAdmin_111/index.php,

Stopping HTTP Server

If you don't like to run HTTP server you can stop it: You can enable it in 2 minutes after the device restarts, just enter your IP adress to a browser or server will automatically stop. You can control all your devices in smart.homehome.app without local HTTP Server

HomeKit Pairing

You can pair your device in 90 seconds when your device restarts. You can also skip HomeKit pair setup standby time in settings page, if you will not use HomeKit. Pair code : 111-88-111

Remote Control without iPad / Apple Tv / HomePod as a Hub

You can control your HomeKit device in smart.homehome.app

HomeKit Without Internet

You can use HomeKit without internet if you are in the same local network. If you want to control HomeKit from outside of your home you must have internet connection and a iPad or an *Apple TV (*some versions doesn't support because of language or old versions) iPad will act like a hub in your home so you communicate from iPhone to iPad.
You can control your HomeKit device in smart.homehome.app without iPad or Apple Tv

Known Issue: HTTP Server Browser Stuck

Browsers can stuck if you have 5 clients. For example; you opened this server interface from mobile and others from chrome, safari, internet explorer... If you surf from home page to settings page from all browsers randomly it will stuck untill you make a new action like changing theme. You will see stucked browser will load the page. This problem is not related with ESP, browsers don't close the connection even ESP sends close connection header. We recommend you to close the tab after you finish. More than 1 browser login at the same time can make your browser stuck. You can control all your devices in smart.homehome.app HTTP Server Redirect If you are using HTTP server with more than 1 browser, you can redirect the page after inactivity (1-10 minutes) so browser will not stuck.

Google Home & HTTP Server Internet Connection

Google Home needs internet connection. We are listening Google Home for any action continuously. If Google servers are unreacheable for any reason, HomeHome.App will try to re-connect 10 times in 2 minutes. If there is still problem with connection HomeHome.App will restart automatically and make a connection to Google server. HTTP server also needs internet connection for javascript and css files.

3th Party Apps - HTTP Server Commands

You can control HomeHome.App with 3th party apps. Your email adress must be gmail so don't add @gmail.com Turn on 1. relay: 'https://ip.address/1/on?myEmail' Turn off 1. relay: 'https://ip.address/1/off?myEmail' All state replies are in array for example: [0,1,2,2]
0 --> off , 1 --> on , 2 --> none Get all relay states: 'https://ip.address/all?myEmail' 1-2-4 relay devices are using the same firmware so we push all together. You can easly understand this is a 2 relay device. First relay is off, second relay is on in this example.

Manage IP

You can have a lot of devices. If you are using HomeKit you can find its IP easliy: hold your finger on a accesorry and touch details. You can setup your device IP when you are in WiFi & Device setup. Connect to HomeHome-XXXXXX Be sure you enter correct ip addresses for subnet mask and gateway ip or your device will not get an ip address from your router which means you can not use the device. See troubleshoot to solve. Alternative: When you want a static IP for every device, you can assign it with your router. Last 6 characters of mac address in your DHCP list is the same with your HomeHome.App device ID

Reset Device

You can reset your device by pressing 10 seconds to the button of your device. If your device don't have a special button like Sonoff 4ch or only have a single button like Sonoff basic, first button will reset the device to factory settings. Be careful: if you don't have a special reset button use 'Momentry' type switch! You can also reset device by
HTTP Server-> Setting page-> Reset

Using with only Google Home

If you will not use HomeKit: Finish the first setup if you did not make before (Connect to HomeHome-XXXXXX) Power on the device.
Wait a few minutes untill you see LED flashes. Enter your ip address of the device. Turn on "Skip HomeKit Pair Standby Time" in the settings page Restart device. You will see LED flashes after 30 seconds which means device is ready.

Device Sharing With Others

Device sharing is possible. HomeKit and Google Home manages itself. You do not have to do any setup with HomeHome.

Flash bin file

Be warned we are not responsible of any damage use at your own risk. Never connect power cables when flashing. You can download binary file from here. 1.WAY TERMINAL COMMANDS:If you don't know how to flash please check these repo's wiki1 or wiki2 We suggest you to backup your original firmware because everything will be lost on the device. After you installed esptool (check wikis), terminal flash command: esptool.py -p /dev/cu.SLAB_USBtoUART --baud 115200 write_flash -fs 1MB -fm dout -ff 40m 0x0 /downloads/homehome.bin ( /dev/cu.SLAB_USBtoUART change this with your com port) 2.WAY WINDOWS: If you don't want to use terminal commands you can download windows flash tool First ERASE the chip unplug and plug USB cable. START flash. Unplug and plug USB cable after flash finished. Connect to HomeHome-xxxxxx WiFi network. COMMON SETTINGS: Select HomeHome.bin from your download folder and write to 0x0 CrystalFreq:26M SPI Speed 40MHz Flash Size 8Mbit (same for 1MB/4MB boards) Only SPI MODE is different for boards. DEVICE WITH 1-MB FLASH SETTINGS: SPI MODE: "DOUT" DEVICE WITH 4-MB FLASH [ NODEMCU] SETTINGS: SPI MODE: "DIO" This is only 1 time setup, you will get firmware updates by (OTA) clicking a button on the local HTTP server.

Google Home Setup

If you will use stand alone HomeKit: 1-Please download "Google Home" app from Apple Store and complete this setup. 2-If you do not finish the setup, you must send us your gmail address and device id everytime you reset the device. Are you ready to say "OK Google"? Add "+HomeHome" Open Google Home app from your Android device. Click "+">Setup Device>Works with Google> Search for "+HomeHome" Log in and you will see your HomeHome flashed devices. If you see an error page ,clear cookies and site settings from your mobile web browser or wait 3 minutes. If you don't see your HomeHome flashed device, restart your HomeHome flashed device and be sure it connects to your WiFi network.

Apple HomeKit Setup

Restart by power off-on or Restart by settings page in HTTP local server (write the ip address to a web browser to enter local user interface) You have 90 Seconds to add HomeKit. If it fails to add restart the device again. Apple HomeKit Pair code: 111-88-111 If you remove device (unpair) from HomeKit you must RESET the device and Re-setup everything by connecting HomeHome-XXXXXX Reset process:Press ans hold the reset button for10 seconds untill you see led flashes or Click reset button in settings page of HTTP local server If you will use stand alone HomeKit: See Google Home Setup FAQ

Try The Demo

Flash your device and try the demo first. Using a Nodemcu device will be easy to see how it works. Click here for tutorial.
You can download binary file from here.

First Setup

When you flash the device it will broadcast WiFi network : "HomeHome-xxxxxx" Password is "homehome" When you join the network you, a captive portal will come. If you don't see unplug-plug the device or open http://192.168.4.1 from your web browser. Select your device type: Select switch type and required gmail account. You can set static ip (optional) for the device but you must know your gateway ip & subnet mask. Enter your router name and password if it doesn't in the WiFi list "refresh network" or enter manually. Save. You can change other device settings by entering ip address of your device. Find more on FAQ>General tab

Custom Device Setup

If you have a custom device like nodemcu v2/v3 you can set relay/button/reset/led pins. You can find a lot of info about usable pins of ESP8266 with Google. Check this. Be careful! You may see that your relay board have reversed pins. Do not connect any cable until you are sure with pin directions.There will be a 'Reverse pin' setup in the settings page of your device. Use at your own risk!
Set fields as you need. Enter GPIO# or leave blank. Relay required. You can leave blank the 'Reset, Led and Button'. Set 1-2-4 relay(s), 3 relays not supported.

Example 4 Relays On-Off nodemcu setting:

Relay1=5(d1)
Relay2=4(d2)
Relay3=14(d5)
Relay4=12(d6)

Button1=13(d7)
Button2=3(RX)
Button3=1(TX)
*Button4=10(SDD3) or 2(d4)
*10(SDD3) / 2(d4) for nodemcu V2 or 2(d4) for nodemcu V3

Reset button=16(d0)
Led=2(d4) if you use GPIO2 for button don't set a pin for LED

Example Roller Shutter / Blinds nodemcu setting:

Relay1=5(d1) - Relay2=4(d2)
Button1=12(d6) - Button2=13(d7)
Reset button=16(d0) - Led=2(d4)

I can not add device to HomeKit?

You have 90 seconds for pairing after restart.

1-Possible Reason: You set a wrong static ip. Device will connect to your router but it will not get an ip address. Reset button will not work. 1A-Solution: Please keep your eyes on the device and wait a few minutes untill you see LED blinks. Press and hold the reset button 10 seconds untill you see led flashes. Re-Setup everything with HomeHome-XXXXXX setup. Save new settings and power off the device. 1B-Solution: Turn off your router, wait a few minutes untill you see HomeHome-XXXXXX WiFi network. Re-Setup everything with correct static ip & subnet mask & gateway ip Save new settings and power off the device. 2-Possible Reason: You set a wrong password for your router. 2A-Solution: Wait a few minutes, device will broadcast it's WiFi network : HomeHome-XXXXXX Connect HomeHome-XXXXXX. Re-Setup everything with correct router name and password. Save new settings and power off the device. Note:HomeHome-XXXXXX pass is homehome Always restart the device by power off-on after HomeHome-XXXXXX setup

Sonoff Dual Button?

Do not connect any button wires when you are making the setup. Read Sonoff Dual Guide for "Toggle" button type exception when there is a power cut.

Device is in DEMO mode?

You must activate your device in smart.homehome.app -If you do not have credits to activate please send us an email. Restart the device after activation. Note: Device will not physical work after sometime if you stay in DEMO mode.

Device is not working?

1-Posibble Reason and solution: You must activate your device in smart.homehome.app -If you do not have credits to activate please send us an email. Restart the device after activation. Note: Device will not physical work after sometime if you stay in DEMO mode. 2-Posibble Reason and solution: You did not finish the Setup. Connect to HomeHome-XXXXXX network 3-Posibble Reason and solution: You set a wrong router password. Wait a few minutes and connect to HomeHome-XXXXXX network 4-Posibble Reason: You set a wrong static ip address. 4A-Solution: Please keep your eyes on the device and wait a few minutes untill you see LED blinks. Press and hold the reset button 10 seconds untill you see led flashes. Re-Setup everything with HomeHome-XXXXXX setup. Save new settings and power off the device. 4B-Solution: Turn off your router, wait a few minutes untill you see HomeHome-XXXXXX WiFi network. Re-Setup everything with correct static ip & subnet mask & gateway ip Save new settings and power off the device. Always restart the device by power off-on after HomeHome-XXXXXX setup

Newly added device missing in Google Home

You already have HomeHome devices and using them. Now you added a new device and you can not see in Google Home. Refreshing by pulling down the Google Home page will not work. Remove acoount linking of Google Home and setup it again. See Google Home Setup in FAQ

Wi-Fi Network Connection Drops

-> Use only 2.4GHz router. If you have 2.4GHz and 5GHz networks, do not use the same SSID, change the name of 5GHz so device will not try to connect it.

-> Some new routers have a lot of features. Your router may close the connection because of low data! Please check your settings in your router - access point.