Frequently asked questions
General
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.
Flashing
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
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)
TroubleShoot
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