🚨 Important Note: Please Read First

Begin by pairing the Bridge with HomeKit. Once paired, any devices you add to HomeKit will automatically appear in the Home app within 1–3 minutes after the Bridge restarts—no re-pairing required. Feel free to assign the new HomeKit devices to any room you prefer.

HomeHome.App Bridge - User Guide

Overview

The HomeHome.App Bridge allows you to control your eWeLink devices through Apple HomeKit. This bridge acts as a translator between eWeLink's protocol and HomeKit, enabling native iOS control of your devices.

Initial Setup

1. Power on your HomeHome.App Bridge device
2. Connect to the Bridge's WiFi network named "HomeHome.App"
   • Password: homehome
3. Wait for the setup page to appear, or navigate to http://192.168.4.1
4. Enter your WiFi credentials and Google account email
5. The bridge will restart and connect to your network

Connecting Devices

Credit System

• Each device type requires different credit amounts:
  • 1-Channel Switch: 1 credit
  • 2-Channel Switch: 2 credits
  • 3-Channel Switch: 3 credits
  • 4-Channel Switch: 4 credits
  • Dimmer: 2 credits
  • Motor Controls: 4 credits
  • Thermostat: 4 credits
  • NSPanel: 6 credits
• New users get a 24-hour free trial
• Purchase credits at https://homehome.app/shop

Troubleshooting (Quick)

Device Not Appearing in HomeKit

1. Restart the bridge and wait 2 minutes
2. Completely quit the Home app and restart it
3. Ensure you have sufficient credits
4. Try removing and re-adding the device in bridge.homehome.app
5. Check if the device is online in the eWeLink app
6. Click "Reset HomeKit" if problems persist

Bridge Offline

1. Verify your WiFi connection
2. Check if the Bridge's LED is lit
3. Try power cycling the Bridge
4. If LED is blinking, WiFi credentials may be incorrect
   • Press the reset button 3 times rapidly to enter setup mode
   • Reconnect to "HomeHome.App" [pass:homehome] WiFi and reconfigure

Connection Issues

1. Ensure bridge firmware is up to date
2. Check your internet connection
3. Verify eWeLink account is properly linked
4. Try logging out and back in to both Google and eWeLink

FAQ

Q: How many devices can I add?

A: Technically, it is possible to add up to 144 devices; however, each system will have its own limitations depending on the device types and quantities. You can add as many devices as you like as long as the Bridge's memory does not drop below 50KB.

An alternative solution is to connect the same eWeLink account to two different Google accounts, allowing you to use a second Bridge. For the second Bridge, simply sign in with a different Google account.

Q: Will my devices work without internet?
A: No, the bridge requires internet connection to communicate with eWeLink servers.

Q: Do I need to keep the eWeLink app?
A: No, once devices are added to HomeKit, you can control them directly through the Home app. However, we recommend keeping the eWeLink app to access additional features such as inch mode, energy consumption monitoring, detailed device information, and sharing devices with other users.

Q: What happens if my credits expire?
A: Devices will remain in HomeKit but won't respond to commands until credits are renewed.

Q: How do I update the bridge firmware?

1. Download the Bridge firmware https://homehome.app/firmware/
2. Go to https://bridge.homehome.app to see the IP address of the Bridge from its last startup.
3. Click update button. Upload the firmware file.
4. Wait for the update to complete. The bridge will restart automatically

Error Codes

• E1: WiFi connection failed
• E2: eWeLink authentication error
• E3: Insufficient credits
• E4: Device communication error
• E5: HomeKit pairing error

Support

For help and feedback:
Email: [email protected]
WhatsApp: Click here

Quick Reset Procedures

1. WiFi Reset (Clear WiFi settings)
   • Press reset button 3 times quickly
   • Bridge will enter setup mode
2. Factory Reset (Clear all settings)
   • Press reset button 6 times quickly
   • All settings will be erased
   • Bridge will restart in setup mode
3. HomeKit Reset (Clear HomeKit data)
   • Visit bridge web interface - local ip address in your network
   • Click "Reset HomeKit"
   • Re-add bridge in Home app 1118-8111

Safety Notes

1. Keep the bridge in a well-ventilated area
2. Avoid exposure to water or extreme temperatures
3. Use good quality usb cable and power adapter with 1-2 Amp
4. Keep away from high-power electrical equipment

Maintenance Tips

1. Regularly check for firmware updates
2. Monitor credit balance
3. Periodically verify device connections
4. Clean the bridge with a dry cloth only
5. Maintain good WiFi signal strength

Device Type Specific Notes

With real-time communication, devices respond faster than you can even notice.

Switches

• Best for basic on/off control
• Lowest credit requirement
• Instant state updates

Dimmers

• Supports brightness control
• Remembers last brightness level

Motors

• Perfect for curtains/blinds
• Supports position control
• Calibrate in eWeLink app

Thermostats

• Full temperature control
• Supports auto, heat, and cool modes
• Displays current temperature and humidity
• You can perform temperature and humidity calibration in the eWeLink app.
• Note: The main thermostat controller is the Home app. Only basic on/off commands are sent to eWeLink.

NS Panel

• Advanced display control
• Temperature sensing
• Dual switch capability
• Control widgets directly from the screen (widgets are configured in the eWeLink app and not displayed in the Home app)
• Added to HomeKit as two switches and a temperature sensor

HomeHome.App Bridge - Troubleshooting Guide

Common Issues and Solutions

Network Connectivity

Bridge Won't Connect to WiFi

Symptoms

• LED blinking rapidly
• Can't access bridge interface
• "Offline" status in HomeKit

Solutions

• Verify WiFi password
• Check WiFi band (2.4GHz required)
• Reduce distance to router
• Reset WiFi settings (3 button presses)

Intermittent Connection

Symptoms

• Devices respond slowly
• Random disconnections
• "No Response" in HomeKit

Solutions

• Check WiFi signal strength
• Move bridge closer to router
• Reduce network interference
• Update bridge firmware

eWeLink Integration

Authentication Failed

Symptoms

• "Connect eWeLink" button error
• Devices not appearing
• Error E2 displayed

Solutions

• Re-login to eWeLink
• Check account region
• Clear browser cache
• Try different browser

Devices Not Updating

Symptoms

• State changes not reflecting
• Delayed responses
• Inconsistent status

Solutions

• Check device online status
• Verify sufficient credits
• Remove and re-add device
• Reset device in eWeLink app

HomeKit Issues

Pairing Failed

Symptoms

• Can't add to Home app
• "Accessory not found"
• Error during setup

Solutions

• Reset HomeKit configuration
• Verify bridge is online
• Check iOS device is on same network
• Never use Beta version of iOS
• Try manual code entry: 1118-8111

Devices Unresponsive

Symptoms

• "No Response" in Home app
• Can't control devices
• Updates not syncing

Solutions

• Check bridge connection
• Verify credit balance
• Remove and re-add to HomeKit
• Reset bridge if persistent

Credit System

Credit Deduction Issues

Symptoms

• Unexpected credit use
• Credits not showing
• Can't add devices

Solutions

• Check credit balance
• Verify device type credits
• Contact support if error
• Logout and login, restart bridge

Trial Period Problems

Symptoms

• Trial not starting
• Early expiration
• Features restricted

Solutions

• Verify account email
• Check trial eligibility
• Contact support
• Purchase credits if needed

Performance Issues

Slow Response Times

Symptoms

• Delayed state changes
• Slow updates
• Laggy interface

Solutions

• Check internet speed
• Reduce active devices
• Update firmware
• Reset bridge

High Memory Usage

Symptoms

• Bridge unresponsive
• Random restarts
• Error messages

Solutions

• Change usb cable and power supply
• Remove unused devices
• Update firmware
• Factory reset if needed

System Updates

Update Failures

Symptoms

• Update error
• Incomplete installation
• Bridge not restarting

Solutions

• Check internet connection
• Factory reset if failed
• Contact support

Post-Update Issues

Symptoms

• Devices missing
• New errors
• Features not working

Solutions

• Got to bridge ip address and check eWeLink connection status
• Wait for system stabilization
• Re-add devices if needed
• Check compatibility
• Rollback if necessary

Advanced Troubleshooting

System Logs

• Access logs via web interface
• Check for error patterns
• Monitor memory usage
• Track connection status

Network Analysis

• Verify port accessibility
• Check firewall settings
• Monitor data usage
• Test network stability

Recovery Procedures

1. Network Reset
   • Press reset 3 times
   • Reconfigure WiFi
   • Test connection
2. Factory Reset
   • Press reset 6 times
   • Complete setup again
   • Re-add all devices

When to Contact Support

Contact Support If:

• Persistent errors after reset
• Credit system issues
• Hardware problems
• Recovery fails
• Security concerns

Information to Provide:

1. Bridge MAC address
2. Firmware version
3. Error messages
4. Steps attempted
5. Go to the bridge IP address and attach the screenshot to your message

HomeHome.App Bridge - Frequently Asked Questions

General Questions

System Requirements

Q: What do I need to use the bridge?
A: You need:

• HomeHome.App Bridge device
• 2.4GHz WiFi network
• eWeLink account
• iOS device with HomeKit
• Google account for authentication

Q: Which devices are supported?
A: Supported devices include:

• Single/multi-channel switches
• Dimmer Sonoff D1
• Motor controls
• Thermostats
• NS Panel

Q: Can I use it without internet?
A: No, internet connection is required for:

• Device communication
• Status updates
• Credit verification
• Security authentication

Account Management

Q: Why do I need a Google account?
A: Google account is used for:

• Secure authentication
• Credit management
• Device preferences
• Settings sync

Q: Can I share devices with family?
A: Yes, through:

• HomeKit home sharing
• eWelink home sharing

Credit System (FAQ)

Credit Usage

Q: How do credits work?
A: Credits are used to:

• Add devices to HomeKit
• Maintain device control
• Support ongoing service

Q: What's the credit cost per device?
A: Credit costs vary:

• 1CH Switch: 1 credit
• 2CH Switch: 2 credits
• Dimmer: 2 credits
• Motor: 4 credits
• Thermostat: 4 credits
• NSPanel: 6 credits

Trial Period

Q: How does the trial work?
A: Trial includes:

• 24 hours free usage
• All features enabled
• No credit requirement
• Automatic expiration

Q: What happens after trial?
A: After trial:

• Need to purchase credits
• Devices remain paired
• Control requires credits
• Settings preserved

Technical Details

Connection

Q: How stable is the connection?
A: Connection stability depends on:

• Internet quality
• WiFi signal strength
• Server response time
• Device location

Q: What's the response time?
A: Typical response times:

• Real-time

Security

Q: Is my data secure?
A: Yes, security includes:

• End-to-end encryption
• Secure authentication
• Regular updates
• Data protection

Q: Who can access my devices?
A: Access is limited to:

• Your Google account
• HomeKit shared users
• Your eWeLink account
• No third-party access

Device Management

Adding Devices

Q: How do I add new devices?
A: Follow these steps:

1. Add to eWeLink app
2. Connect to bridge
3. Add to HomeKit
4. Verify credits

Q: Can I remove devices?
A: Yes, you can:

• Remove from HomeKit
• Disconnect from bridge
• Credits will be returned to your available balance
• Re-add later if needed

Device Control

Q: Can I use Siri?
A: Yes, supports:

• Voice commands
• Shortcuts
• Scenes
• Automations

Q: Do automations work?
A: Yes, supporting:

• HomeKit automations
• Time-based control
• Condition triggers
• Scene activation

Maintenance

Updates

Q: How often are updates?
A: Updates include:

• Regular firmware updates
• Security patches
• Feature additions
• Bug fixes

Q: Is updating mandatory?
A: Recommended for:

• Security
• Stability
• New features
• Bug fixes

Feedback

Q: Can I request features?
A: Yes, through:

• Email or WhatsApp (see above)
• Community forums
• Direct feedback channel

Q: How to report issues?
A: Send details via:

• Email: [email protected]
• WhatsApp: Click here