Home > Support > FAQ

Hub FAQ


1. What is HomeKit?

HomeKit is a smart home platform released by Apple. HomeKit allows users to use iOS devices to control all their home accessories labeled "Works with Apple HomeKit". These accessories include,switches, lights, locks, thermostats, smart plugs, door and window sensors, temperature and humidity sensors and other accessories. Apple has a "Home" app built into the iOS 10 or later version. Through “Home” app, users can manage all the HomeKit-enabled devices in one platform. Users can create Room in “Home” app, create scenes, such as, “I’m home”, “Away”, set automation, share home ect. Users can use “Home” app to easily and safely control all the HomeKit-enabled accessories. Users can also control the accessories using Siri after naming the accessories. For example, "Turn on the light" or "Turn off the light". "Set the brightness of the light to 50%". "Set the temperature to 20 degrees”. "I’m leaving". A notable feature of HomeKit is security. The data of HomeKit-enabled accessories adopts end-to-end encryption for the transmission, to ensure users’ HomeKit-enabled accessories are not exposed to the cloud or easily hacked by hackers. Besides, Apple will not collect any data of users’ HomeKit-enabled accessories, thus protecting user privacy. Since the data of HomeKit-enabled accessories adopts end-to-end encryption, a "home hub" is required to support the remote control, and you can use the “Home”app to set HomePod, Apple TV 4K, Apple TV (4th generation) or iPad as the home hub to enable remote control of your HomeKit-enabled accessories, give trusted people access, and automate your home with the accessories.

2. What is the Aqara Hub?

Aqara Hub is a HomeKit-enabled smart bridge. With the Aqara Hub, your iOS devices can control wall switches and RGB night lights, monitor temperature, humidity and atmospheric pressure, sense human movement, and detect water leaks. Wireless Mini Switch, Wireless Remote Switch (Single Rocker), Wireless Remote Switch (Single Rocker), Wall Switch (No Neutral, Single Rocker), Wall Switch (No Neutral, Double Rocker), Wall Switch (With Neutral, Single Rocker), Wall Switch (With Neutral, Double Rocker), Door and Window Sensor, Motion Sensor, Temperature and Humidity Sensor, Vibration Sensor, Water Leak Sensor. More Aqara accessories will be connected to Apple HomeKit platform. See www.aqara.com for more details.

3. What is the home hub?

A home hub is the brain of the HomeKit-enabled accessories, through which users can automate and remotely access HomeKit-enabled accessories. With the Apple Home app, you can set up a home hub, remotely control your HomeKit-enabled accessories, give trusted people access, and automate the accessories to do what you need as required. Learn more.

4. What is Automation?

Automation can help do a lot of things. For example, turns off the light at 10pm every day; automatically turns off the air conditioner when you leave home; automatically turns on the corridor light; automatically turns on light when motion is detected. You will have to install a home hub first to set up the automation.

5. What is Scene?

In smart home, scene control is a very useful feature, you can create a scene through the app and add multiple accessories to the scene. For example, you can create a "Good Night" scene, add "Bedroom Lights", “Living Room Lights”, “Corridor Lights” to the scene, and set the switches to off state. When the setting is done, “Good Night” scene will turn off the "Bedroom Lights", “Living Room Lights”, and “Corridor Lights”.

6. Siri Voice Control

1. Control accessories. Name the accessories in Apple Home or Aqara Home app, distribute them to a specific room and tell Siri , “Turn on the light” “Turn on living room lights” “Turn on bedroom lights” “Turn off the switch” “Turn on the plug” “Turn off living room lights” “Turn off lights in my Chicago house” “Set night light to 50%” “Set night light to red” 2. Set scenes. Set scenes in Apple Home or Aqara Home app and name them. Ask Siri to set the following scenes, “Hey Siri. Set the party scene" “I’m home” “I am leaving” “Good night” “Good morning” 3. Check accessory status. Name the accessories in Apple Home or Aqara Home app, distribute them to a specific room and ask Siri, “Is the living room open?” “Living room temperature” “What’s the living room humidity?” “What’s the Water Leak Sensor status”? Siri voice control of HomeKit-enabled accessories is available on iPhone, Apple Watch, iPad, iPod, Apple TV, HomePod. Learn More.

7. What is Zigbee?

Zigbee technology is a short-range, low power wireless communication technology. 1. Low power consumption 2. Short delay time 3. Customizable network capable of including a large number of sub-devices. 4. Excellent reliability 5. High security

8. What accessories does the Aqara Hub support currently?

Wireless Mini Switch, Wireless Remote Switch (Single Rocker), Wireless Remote Switch (Single Rocker), Wall Switch (No Neutral, Single Rocker), Wall Switch (No Neutral, Double Rocker), Wall Switch (With Neutral, Single Rocker), Wall Switch (With Neutral, Double Rocker), Door and Window Sensor, Motion Sensor, Temperature and Humidity Sensor, Vibration Sensor, Water Leak Sensor. More accessories will works with Apple HomeKit. See www.aqara.com for more details.

9. What is HomeKit code?

The HomeKit code is a string of 8 digits and it is pasted on the product or its packaging as a QR code. Each product has one unique HomeKit code for identification and pairing while adding the accessory. Please keep the HomeKit code and avoid sharing the information to others.

10. What accessories does HomeKit support currently?

Learn more

11. Wi-Fi Network Setup

1. Make sure that the home hub and the Aqara Hub are on the same Wi-Fi LAN.
2. If you are not connected to the home hub, iOS devices can only connect to accessories within the LAN.
3. The Hub only supports 2.4GHz router Wi-Fi networks. If you are using a dual band router, please disable the 5GHz Wi-Fi network before adding the Hub.
4. If a router signal cannot provide coverage to all areas of the house, it is recommended that you install a Wi-Fi signal amplifier or set up a router bridge mode to access the main router when setting up the LAN network environment. Please refer to the Wi-Fi signal amplifier and router bridge mode manual for operational details.

12. Hub installation location and precautions

1. It is recommended the Hub to be installed at the center area of the accessories to ensure that the Hub and all accessories can communicate steadily. If the distance between the accessories and the Hub is too far apart, the accessories may appear to be offline. In this case, please add another Hub and connect the accessories to the newly installed Hub.
2. The Hub should not be too far away from the router whenever possible. In order to ensure stable Wi-Fi communication, a straight line distance of 2 to 6 meters is the most optimal.
3. To ensure that the Hub's signal can reach longer distances, it is recommended that the Hub to be installed no less than 1 meter from the ground.

13. Accessories installation location and precautions

1. Installation location and precautions for the Wireless Mini Switch
Due to complex indoor environments, adjusting the relative position of the Hub and sensors can result in a better communication environment. After an accessory is added successfully, you can press the reset button on the Wireless Mini Switch, when the Hub prompts [Normal Link Confirmed] you can be sure that the installed accessory can operate normally from this location. The Wireless Mini Switch can be attached to the wall or placed on a desk or table. Since metal has a damping effect on the radio signal, we do not recommend mounting the Wireless Mini Switch on a metal door. (For details, please refer to the manual for installation and operations)
2. Installation position and precautions for Door and Window Sensor
a. As shown in the instructions, align the mounting mark on the accessory with the magnet, and mount one of them on the fixed surface of a door or window, and the other on the surface of the opening (it is recommended to install the accessory on the fixed surface).
b. The distance between the accessory and the magnet should be less than 22mm.
c. They can be swapped around, but must ensure that the accessory and the magnet alignment mark are aligned.
d. Due to complex indoor environments, adjusting the relative position of the Hub and Door and Window Sensor can result in better communication environments. Since metal has a dampening effect on wireless signals, the Door and Window Sensor should not be mounted on the metal of doors and windows.
e. After the device is added successfully, click the reset button before installation. At this time, the gateway prompts [Connection OK], indicating that it can work normally in this installation position.
3. Installation position and precautions for Motion Sensor
a. For indoor use only, please install in areas where people need to be detected, such as living rooms and bedrooms.
b. Since the Motion Sensor utilizes passive infrared detection, exposure to direct sunlight and direct illumination from incandescent lamp should be avoided. Nor should it be exposed to heat sources ( such as radiators, heaters ) or air conditioning, in order to avoid large changes in ambient temperature that causes false alarms; The sensor must be securely installed to avoid false alarms due to movements caused by the wind; The surface of the sensor should not be touched by hand; The outer surface of the optical lens should be regularly wiped with a soft cloth or cotton to prevent the dust from affecting the sensitivity; Recommend installing over a high of 1m.
c. A large pet walking around may lead to false alarms. Please avoid installing in the areas where pets often walk around.
d. The detection range of the Motion Sensor is [a straight line distance of 7m in front and an 170° angle range left and right].
e. Do not place it on a metal surface (because the metal will affect the communication between the sensor and the Hub) or place a non-metal material between the metal and the sensor.
f. Please poke the reset hole before installation. If the Hub prompts [Connection OK] after the sensor is reset, this indicates that it can work normally at this installation position.

14. How to use HomeKit-enabled Aqara products in the "Home" app for iOS devices?

Learn more

15. How to designate an iPad, Apple TV or HomePod as the home hub?

You can set HomePod, Apple TV 4K, Apple TV (4th generation), or iPad as a home hub to automate and remotely control HomeKit accessories on iOS devices. A device set as a home hub must be left at home, connected to a home Wi-Fi network, and powered on.

16. Set HomePod as a home hub

HomePod automatically sets itself up as a home hub so you can control your HomeKit accessories remotely with the Home app and use automations. Just make sure that the iOS device you use to set up HomePod is signed in to iCloud with the Apple ID that you used to set up your HomeKit accessories in the Home app.

17. Set Apple TV as a home hub

1. On your iOS device or Mac, set up two-factor authentication for your Apple ID. Then go to iCloud and make sure that you have iCloud Keychain turned on.
2. On your Apple TV, go to Settings > Accounts and make sure that you're signed in to iCloud with the same Apple ID as your iOS device.
3. After you sign in to iCloud, your Apple TV automatically sets itself up as a home hub. To check the status of your home hub, go to Settings > Accounts > iCloud and look under HomeKit to see if your home hub is connected. Learn what to do if you don’t see HomeKit.

18. Set iPad as a home hub

1. If you’re using iOS 10.3 or later, go to Settings > [your name] > iCloud. If you're using iOS 10.2 or earlier, go to Settings > iCloud.
2. Sign in with your Apple ID.
3. Check that iCloud Keychain and Home are both turned on.
4. Go to Settings > Home and turn on Use this iPad as a Home Hub. Need help?
5. Want to check the status of your home hub in the Home app on your iOS device? Open the Home app and tap the ”navigation” icon in the upper-left corner. Then look under Home Hubs to see if your home hub is connected. If you have multiple home hubs set up, the primary home hub will show as connected. The other home hubs will show Standby as their status and will take over remote access if the main home hub is disconnected.
Learn more

19. How to control Hub and accessories using Siri

1. Control accessories. Name the accessories in Apple Home or Aqara Home app, distribute them to a specific room and ask Siri to, “Turn on the light”
“Turn on living room lights”
“Turn on living room”
“Turn off the switch”
“Turn on the smart plug”
“Turn off living room lights”
“Turn off lights in my Chicago house”
“Set night light to 50%”
“Set night light to red”
2. Set scenes. Set scenes in Apple Home or Aqara Home app and name them. Ask Siri to set the following scenes,
“Hey Siri. Set the party scene"
“Enable I’m home scene”
“I’m home”
“I am leaving”
“Good night”
“Good morning”
3. Check accessory status. Name the accessories in Apple Home or Aqara Home app, distribute them to a specific room and ask Siri,
“Is the living room open?”
“Living room temperature”
“What’s the living room humidity?”
“What’s the Water Leak Sensor status”?
Siri voice control of HomeKit accessories is available on iPhone, Apple Watch, iPad, iPod, Apple TV, HomePod. Learn more

20. How to verify if the accessories and the Hub are within normal communication range?

Please refer to the “Effective Range Test” in the accessory Quick Start Guide. If the indicator light in the accessory blinks and the Hub makes voice prompts, “Normal Link Confirmed”, it indicates the Hub communicates effectively with the accessories. If the communication does not work properly, please move the accessory closer to the Hub or move the Hub closer to the accessory and try again.

21. How many accessories does the Hub support?

It connects up to 32 accessories, depending on the actual environment.

22. What’s the function of the button on the Hub?

Single press: turn on/off night light
Triple press: add accessories
Long press: long press for 10s to reset the Hub. This will not delete data, such as, timer, energy consumption and device list.
Short press 10 times: reset to factory settings and delete all data.

22. How can I share my device with my family?

To invite others to control your accessories, you and the people you invite need to be signed into iCloud and have iOS 11.2.5 or later. You also need to be at your home or have a home hub set up in your home. To invite others:
1. Tap the Home tab, then tap the” navigation” icon in the upper-left corner.
2. Tap Invite.
3. Enter the person's Apple ID that they use with iCloud.
4. Tap Send Invite.
Your recipient will get a notification in the Home app on their iOS device.
To accept an invite:
1. Open Home and tap the” navigation” icon.
2. Tap Home Settings.
3. Tap Accept, then tap Done.
After you accept the invitation, tap the” navigation” icon, then tap the name of the Home to control it.

23. If you lose power or the Wi-Fi is disconnected, do you need to reconnect manually?

No need to reconnect manually.

24. Is the saved information lost after a power failure?

No, the saved information will still be available after a power failure.

25. How does the Hub perform firmware upgrades?

Ensure that your phone and the Aqara Hub are connected to the same Wi-Fi network . Open the Aqara Home app. Under the Accessories page, select the Hub to be upgraded, enter the Hub details page, and click Firmware to upgrade.

26. How to restore Hub to factory settings?

1. Press and hold the Hub button for 10 seconds until the yellow light flashes, indicating that the factory settings have been restored. This operation will not delete the set times, battery, and the list of the accessories.
2. Press the Hub button 10 times in rapid succession. After the yellow light flashes, it indicates that the factory settings have been restored. This operation will delete all the data such as the timing, battery level, and sub-device list of the accessories.

27. If the internet is disconnected, can the Hub still operate normally?

The remote access function cannot be used after the Internet is disconnected, but the accessories can still be accessed through the local area network, the Hub can still be used normally and automation can still operate normally.

28. If the router fails, can the Hub still operate normally?

If the router fails, the Hub and home hub cannot connect to the router, then the mobile phone cannot access the Hub, and the mobile phone cannot control the Hub and itself. Because automation requires home hub to operate, it means that the automation function will also fail.

29. How to view the accessories connected to the current Hub?

Open the "Aqara Home" app. On the "Accessories" page, click "[the Hub you want to view]" to enter the Hub details page. Click "Bridge Accessory" to view the accessories connected to the current Hub.

30. How to turn on remote control?

Since HomeKit requires a very high level of security, in addition to requiring that every HomeKit accessories be embedded with Apple's certified encryption chip, HomeKit places the key for access permissions on the home hub rather than on the cloud, meaning that hackers cannot break into the cloud to gain access to the HomeKit part in owner's home. Therefore, remote access to HomeKit accessories require the help of the home hub. If you want to remotely control home accessories, you need to pre-configure a home hub at home.

31. How to turn on notification push (after the door is opened, the mobile phone receives a door open notification)?

In iOS 11 and later, you can use HomeKit accessories such as door locks and sensors. (There are currently several products that support push notifications in Aqara products. They are: Door and Window Sensor, Motion Sensor, Vibration Sensor, and Water Leak Sensor.) Set up notifications to alert you when an accessory detects an anomaly or at a specific time of the day. For example, if you have a Door and Window Sensor installed in your home, you will be notified if the door opens when you are at home. This can be configured as follows: 1. Open the Apple “Home” app.
2. Tap and hold an accessory, then tap Details.
3. Tap Status & Notifications.
4. Turn on "Allow Notifications" and choose one of the following options:
1) Time: Set the time when you want the accessory to send a reminder.
2) Users: Receive reminders from accessories when you or others arrive at or leave your home. If you select this option, you need to configure the home hub, and make sure you can control every accessory in your home that has activated "Share My Location" and "Settings"> "[your name]"> "iCloud"> "Share My Location" and select the device.
5. To complete the operation, tap “Back” in the upper left corner and tap “Finish”.
Want to receive notification from HomeKit accessories while you are away from home? Please set up a home hub to remotely access your HomeKit accessories.

32. Indicator Light Description

33. Hub failed to add successfully

1. Before adding the Hub, make sure that the Hub is in the slow yellow light state.
2. If the pop-up dialog box prompts "Router incompatibility", check whether the router is a dual-band router (that is, support both 2.4 GHz Wi-Fi and 5 GHz Wi-Fi). Normally, a dual-frequency router will generate 2 hotspots, such as "WiFi_XXXX_2.4G", WiFi_XXXX_5G, please connect to the hot spot of WiFi_XXXX_2.4G" and try again. If there is only one hotspot, such as "WiFi_XXXX", please enter the router settings page and set the WiFi hotspot to 2.4GHz and try again.
3. Long press the Hub button for 10 seconds, wait for the yellow light to flash. From the phone enter "Settings" > "WLAN". Select "Aqara Hub-XXXX" in the "SET UP NEW DEVICE" field. After clicking “NEXT”, the Hub will automatically join the router. After successfully adding, you will be notified: "Setting up this accessory to join [your router Wi-Fi hotspot]". Open the "Home" or "Aqara Home" app, tap "+", rescan the HomeKit code or add accessories by manually entering the HomeKit code. If you fail to join the router, it will prompt "An unexpected error occurred. Try again." Please restore the Hub and restart the phone Wi-Fi, wait for 1 minute and try again.

34. Hub failed to add successfully, prompt "Accessories added"

1. Please delete the previously added Hub in the "Home" or "Aqara Home" app, then restart the phone Wi-Fi, and then press and hold for 10 seconds to reset the Hub until the yellow light flashes, then add the Hub again.

35. Accessory device cannot be added successfully

1. Please try moving the accessory device closer to the Hub.

36. Accessory device cannot be deleted

1. To delete the accessory device, ensure that the Hub is online. Use the Aqara Home app to delete the accessory device.

37. The Hub keeps flashing blue light. What should I do?

1. The Hub and router have been disconnected. Please check if the router works normally. Please try to restart the Hub and router then try again.

38. Can't remotely control

1. Make sure you have a home hub configured.How to configure iPad , Apple TV, or HomePod as home center?
2. Open the "Home" app "Home" page on your iOS device, tap in the top left corner. Click "Home Settings", select your home in the "Home" list, and then under "home hub", see if the home hub shows "Connected." 3. If you use an iPad, Apple TV, HomePod as a home hub, check if the iPad, Apple TV, HomePod is connected to the router
and in the same LAN with the gateway. Do not enable flight mode in iPad.

39. Adding Automation Through "Home" Apps Does Not Work

1. If you use an iPad, Apple TV, HomePod as a home hub, check if the iPad, Apple TV, HomePod is connected to the router. Do not enable flight mode in iPad.
2. Open the "Home" app and check if the automation is set to disabled.
3. Please check whether the corresponding accessories for automation are offline. Please try again after restoring it online. If the Hub is offline, try restarting the Hub and try again.
4. Open the "Home" app "Home" page on your iOS device, tap the” navigation” icon in the top right corner, click "Home Settings", select your home in the "Home" list, and then under "home hub", see if the home hub shows "Connected."
5. If you use the iPad as a home hub, try reactivating the iPad's WiFi switch and try again.

40. Home automation create from Home app has a large delay

1. Since the automation function requires the participation of the home hub, make sure that the home hub and the Hub are in the same LAN and that the router Wi-Fi network is stable and reliable. The number of clients connected to the router is preferred to be no more than 20 (depending on router performance). We recommend you to purchase Apple, Mi, TP-LINK, NETGEER branded routers.
2. Using the iPad as a home hub in battery mode, if the iPad's screen is dim, the communication heartbeat interval with the router becomes longer. Therefore, if you do not use the iPad, please keep the iPad in a charging state to ensure when the iPad's screen is dim, it can maintain constant communication with the router.
3. Ensure that the communication between the accessory device and the Hub is reliable. If the communication between the accessory device and the gateway is unstable, the execution will be significantly delayed.

41. On the app, the Hub (night light) displays offline or not responding.

1. Check if the blue light on the Hub is flashing. If the blue light is flashing, it means the Hub and router have been disconnected. Please check if the router works normally. Please try to restart the Hub and router then try again.
2. If the blue light on the Hub is not flashing:
2.1 Please try restarting the Hub and try again.
2.2 Try to re-enable the WiFi switch on the iPad and iPhone.

42. On the app, the accessories display offline or not responding.

1. Check whether the Hub (night light) connected to the accessory is offline. If the Hub night light is also displayed as offline, it indicates that the Hub is causing the accessory device to be offline. Try restarting the Hub and try again.
2. If the Hub night light is online and the accessory device is offline, check whether the communication between the accessory device and the Hub is operating normally. For details, refer to the “Effective Range Test (Valid Distance Verification)” operation in the accessory manual. The accessory device indicator will flash and the Hub will flash. A tone sounding "Normal Link Confirmed (connection OK)" indicates that the device and the Hub can communicate effectively. If the communication is abnormal, try to move the accessory device closer to the Hub or move the Hub closer to the accessory device and try again. After the app is opened again, check whether the accessory device is online.
3. Check whether the accessory device's power supply is operating normally. Press the button on the accessory to check whether the accessory indicator is on.

43. The "Home" app keeps displaying "Loading scenes and accessories..."

This is because your mobile phone has not backed up or backed up iCloud data for a long time, and the mobile phone does not synchronize the data with iCloud at all times. Therefore, you need to manually synchronize the iCloud data before you can use HomeKit.
Solution: In the phone go to the “Settings” – "Your Apple ID Account" - iCloud - iCloud Backup - Click "Manual Backup" and it will be ready after the synchronization is completed.

44. The Aqara Home app always displays "Cloud data is synchronizing..."

This is because your mobile phone has not backed up or backed up iCloud data for a long time, and the mobile phone does not synchronize the data with iCloud at all times. Therefore, you need to manually synchronize the iCloud data before you can use HomeKit.
Solution: In the phone go to the settings - "Own Apple ID Account" - iCloud - iCloud Backup - Click "Manual Backup" and it will be ready after the synchronization is completed.

45. Unable to receive push notifications

In iOS 11 and later, you can use HomeKit accessories such as door locks and sensors. (There are currently several products that support push notifications in Aqara products. They are: Door and Window Sensor, Motion Sensor, Vibration Sensor, and Water Leak Sensor.) Set up notifications to alert you when an accessory detects an anomaly or at a specific time of the day. For example, if you have a Door and Window Sensor installed in your home, you will be notified if the door opens when you are at home. This can be configured as follows:
1. Open the “Home” app.
2. Tap and hold an accessory, then tap Details.
3. Tap Status & Notifications.
4. Turn on "Allow Notifications" and choose one of the following options:
1) Time: Set the time when you want the accessory to send a reminder.
2) Users: Receive reminders from accessories when you or others arrive at or leave your home. If you select this option, you need to configure the home hub, and make sure you can control every accessory in your home that has activated "Share My Location" and "Settings"> "[your name]"> "iCloud"> "Share My Location" and select the device.
5. To complete the operation, tap “Back” in the upper left corner and tap “Finish”.
Want to receive notification from HomeKit accessories while you are away from home? Please set up a home hub to remotely access your HomeKit accessories.