🚨 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
- Power on your HomeHome.App Bridge device
- Connect to the Bridge's WiFi network named "HomeHome.App"
- Wait for the setup page to appear, or navigate to http://192.168.4.1
- Enter your WiFi credentials and Google account email
- The bridge will restart and connect to your network
Connecting Devices
If your Bridge is already paired with HomeKit, simply restart the Bridge, and any newly added devices will appear in the Home app within 1–2 minutes.
To quickly set up your Bridge, first pair the bridge with the Home app. Then, select the eWeLink devices you want to add and restart the Bridge to complete the process.
Full Steps
-
Visit https://bridge.homehome.app
- Sign in with your Google account
- Click Connect eWeLink Account and log in with your eWeLink credentials
- Your eWeLink devices will appear in the list
- Click + Add to HomeKit for each device you want to control
- Open the Apple Home app
- Click "+" > "Add Accessory"
- Scan the QR code or enter code: 1118-8111
- Restart the Bridge after pairing to ensure your devices appear in the Home app
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
- Restart the bridge and wait 2 minutes
- Completely quit the Home app and restart it
- Ensure you have sufficient credits
- Try removing and re-adding the device in bridge.homehome.app
- Check if the device is online in the eWeLink app
- Click "Reset HomeKit" if problems persist
Bridge Offline
- Verify your WiFi connection
- Check if the Bridge's LED is lit
- Try power cycling the Bridge
- 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
- Ensure bridge firmware is up to date
- Check your internet connection
- Verify eWeLink account is properly linked
- 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?
-
Download the Bridge firmware
https://homehome.app/firmware/
-
Go to https://bridge.homehome.app
to see the IP address of the Bridge from its last startup.
- Click update button. Upload the firmware file.
- 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: info@homehome.app
WhatsApp: Click here
Quick Reset Procedures
- WiFi Reset (Clear WiFi settings)
- Press reset button 3 times quickly
- Bridge will enter setup mode
- Factory Reset (Clear all settings)
- Press reset button 6 times quickly
- All settings will be erased
- Bridge will restart in setup mode
- 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
- Keep the bridge in a well-ventilated area
- Avoid exposure to water or extreme temperatures
- Use good quality usb cable and power adapter with 1-2 Amp
- Keep away from high-power electrical equipment
Maintenance Tips
- Regularly check for firmware updates
- Monitor credit balance
- Periodically verify device connections
- Clean the bridge with a dry cloth only
- 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
Never use Beta version of iOS
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
Got to bridge ip address with a browser
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
- Network Reset
- Press reset 3 times
- Reconfigure WiFi
- Test connection
- Factory Reset
- Press reset 6 times
- Complete setup again
- Re-add all devices
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:
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:
- Add to eWeLink app
- Connect to bridge
- Add to HomeKit
- 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: