How to use Aqara Hub devices in Home Assistant?

Regional Restrictions
These are the Aqara devices China server only compatible

It’s possible to have the Aqara hub associated with the HomeKit Controller Integration in Home Assistant

You still be able to Control Aqara Hub with Home Assistant or Aqara home app( or Mi Home app)…

Note
The Zigbee chip can work only with a single system. You have to choose which program you’d like to use.
1.HomeKit可以和米家同时绑定,也可以和AqaraHome同时绑定。
2.米家和AqaraHome不能同时绑定

Aqara hub Compairation

  1. 2018-11-09 发布 Aqara Hub (now referred to as the M1)
    This is the gen0 version m1s hub.,old Aqara Hub 0st version(out of stock)
Product Name:  Aqara Hub (not M1S) 
 Model Number:  ZHWG11LM    Chinese version
 Product Model Variant:  ZHWG11LM gen0 (cn)
 Internal model:lumi.gateway.aqhm01, lumi.gateway.aqhm02
 Brand:  Lumi United Technology Co., Ltd
 Category:  Smart Home
 Last Certified Date:  

Aqara Hub M1S 1st gen

  1. 2020-09-23 发布 Product Name:Aqara Hub M1S gen1 (cn) 2020版

This is the gen1 version m1s hub.

Model Number:  ZHWG15LM
 Product Model Variant:  ZHWG15LM  Chinese version
Internal model:lumi.gateway.acn01
Brand:  Lumi United Technology Co., Ltd
Category:  Smart Home
 Last Certified Date:  2020-09-23

3.2021-09-08 发布Aqara Hub M1S 2nd gen

Product Name:Aqara Hub M1S 2022 gen2 (cn)

This is the gen2 version m1s hub.

 Model Number:  ZHWG20LM
 Product Model Variant:  ZHWG20LM   Chinese version
 Internal model:lumi.gateway.acn04
 Brand:  Lumi United Technology Co., Ltd
 Category:  Smart Home
 Last Certified Date:  2021-08-09
These version above with a Chinese plug. you will also need an adapter.

Other

M1S EU version
lumi.gateway.aeu01 ( global region)
Last release Date:2022-06-23

source:https://www.aqara.com/us/news/article/1565262227049345024

https://cdn.aqara.com/cdn/opencloud-product/mainland/product-firmware/prd/lumi.gateway.aeu01/20220329120721_lumi.gateway.aeu01_AIOT_V3.4.0_0004.0616_20220328_3be1ed.bin

authorized Aqara retailers

Aqara Hub gateway gen 0

Aqara Hub (ZHWG11LM) Chinese version (Early 2016)

There are many names for the old and new versions on the Internet:
Aqara hub M1
old Aqara Hub 0st version(out of stock)

Product Name:  Aqara Hub (not M1S) 
 Model Number:  ZHWG11LM
 Product Model Variant:  ZHWG11LM gen0 (cn)
 Internal model:lumi.gateway.aqhm01, lumi.gateway.aqhm02
 Zigbee 1.2
Zigbee chip:i.MX6
 Brand:  Lumi United Technology Co., Ltd
 Category:  Smart Home
 Last Certified Date:  

Aqara Hub and aqara home app

[Aqara Hub 101 [updated Dec 18 2019] – Homekit News and Reviews)]

Full support original Xiaomi firmware

Aqara Hub gen 0 Region releases*

Product model:ZHWG11LM(Chinese version)
internal model:
A version of the gateway from Aqara ZHWG11LM, with a Chinese plug.

Product model:.(Taiwan)
internal model:
Product model:(Hong Kong).
internal model:

Product model:ZHWG11LM(Europe version)
internal model:
A version of the gateway from Aqara ZHWG11LM, with a European plug.

Aqara released in 2016, has a Apple Homekit support. The device is not a successor of any of the other Mijia hubs, but is launched as a product under a different brand by a separate company with their own team for development and support. It has their own Aqara app.

Aqara Hub gateway gen 1

Aqara Hub M1S (ZHWG15LM)

 Product name:Aqara Gateway M1S 
 Product model: ZHWG15LM
 Internal model:lumi.gateway.acn001

The M1S gateway supports Aqara brand‘s ZigBee 3.0 and earlier ZigBee 1.2 devices.

Mi Home app yes
Aqara Home app yes

|Apple Home app|yes|

Way 1: Mi Home mode (paired with mi home app)

Product model:ZHWG15LM.  (China model)
internal model :lumi.gateway.acn001
Firmware version:4.0.2_0006,4.0.3_0012

Integration: homekit controller.
or

https://github.com/al-one/hass-xiaomi-miot use this integration

or

GitHub - niceboygithub/AqaraGateway: Aqara Gateway/Hub integration for Home Assistant use this integration

DEVICES = [{
    'lumi.gateway.acn01': ["Aqara", "Gateway M1S", "ZHWG15LM"],  # tested

source:https://github.com/niceboygithub/AqaraGateway/blob/ed60497eaa61e549c35d68be7768ac1326cf59b6/custom_components/aqara_gateway/core/utils.py#L32

After the 2021 M1S gateway has been upgraded to the latest version 4.0.2_0006 firmware in the Mijia APP, as long as the Aqara gateway plugin is loading and connected to the M1S gateway, the M1S gateway will be abnormally offline immediately, and it can only be restored after power off and restart.
[2020版M1S网关在米家APP升级了最新版4.0.2_0006固件后,Aqara gateway只要一连接网关就会造成网关立即异常离线,只能断电重启才恢复。 · Issue #120 · niceboygithub/AqaraGateway · GitHub]

Way 2:aqara home mode (paired with aqara home app)

Aqara Hub M1S Gen 1

Firmware: 3.5.2,  4.0.1_0022.0642(20230512 updated)

app: Aqara Home app
region: china in Aqara app.
Integration: homekit controller.

Other

Product model:HM1S-G01.  (US model)
internal model :
Firmware version:4.0.2_0012.0644 2023-05-22  4.0.2_0024.0644(2023-06-07)

2023-05-22,Firmware 4.0.2 (Beta) adds support for Matter
source:https://www.aqara.com/us/version/hub-m1s

1.You need to select the China region in the Mi home APP settings to use;
2.This Aqara gateway can work with Mi Home App, Apple Homekit and Aqara Home App.

3.Switching the platform will restore the gateway to factory settings. The network, automation and sub-devices need to be reconnected and set up;

4.Mijia and Aqara Home APP cannot be connected at the same time, only Mijia APP+HomeKit or Aqara Home can be used at the same time APP+HomeKit

Aqara Hub gateway gen 2

Aqara Hub M1S (ZHWG20LM)

 Product name:Aqara Gateway M1S gen2
 Product model: ZHWG20LM
 Internal model:lumi.gateway.acn004

The M1S gateway supports Aqara brand‘s ZigBee 3.0 and earlier ZigBee 1.2 devices.

Mi Home app yes
Aqara Home app yes
Apple Home app yes

Way 1: Mi Home mode

https://github.com/niceboygithub/AqaraCameraHubfw

Way 2:aqara home mode

Aqara Hub M1S Gen 2

app: Aqara Home app
region: china in Aqara app.
Integration: homekit controller.

It was pretty easy to integrate,ha with Home kit controller

  1. Open Aqara Home app
  2. Plugged new hub in the socket to wait for bootup
  3. Add to Aqara app
  4. Readd all devices with names and rooms…
  5. Restart home Assistant - wait till done
    (So far not recognized by HA, after 45 min in the network)
  6. Unplug hub wait 10 seconds and replug to power
  7. HA shows the hub as Home kit controller
  8. Add to HA with the provided code (on hub or box)

Note
M1S 2022不支持Aqara Gateway,M1S 2022没法通过aqara gateway接入home assistant
M1S 2022 不支持Matter

Full support original Xiaomi firmware

Aqara Gateway M1S 2022

lumi.gateway.acn004

https://www.msly.cn/boards/topic/14422/third-party-integrationsopenmiio_agent#18943

you can see post and replay on HA:

factory settings or network settings

1.network settings- clear network data
Long press the reset button for 10 seconds.
Holding Aqara Hub for more than 10 seconds causes the device to restart. If I accidentally hang you, this is the best way to restart it.

2.factory settings - clear all settings

Click 10 times to restore the factory settings, which shall clear all settings and network data.

A quick click of the button for more than 10 seconds brings you back to the factory settings.
This means that Aqara Hub will forget all the devices associated with it and you will have to start everything again. This is called last resort when Hub is completely unresponsive.

mi home mode or aqara home mode

3.aqara home mode
10 times pressing followed by 2 times pressing this means moving from Mi Home app to Aqara app mode.

4.mi home mode
10 times pressing followed by 2 times pressing than another 2 times pressing this means moving from Aqara app to Mi Home app mode.

  1. 添加网关 M1S前,请确保手机已经连接到2.4GHz频段的Wi-Fi网络,并将手机尽量靠近本产品。
  2. 如果添加失败或开机超过15分钟未连网,请长按设备按键10s以上,直到指示灯黄色闪烁后重新连接。
  3. 当你听到语音“等待连接中,请打开Aqara Home APP”时,即可以使用Aqara Home进行添加设备。如果在出厂状态下,听到语音“等待连接中,请打开米家APP”,则需要在听到语音之后10秒内,连按按键两下,听到“噔”提示音则表示设备已成功切换APP平台,待指示灯黄色闪烁,就可以使用Aqara Home进行添加了。
  4. 如果仍然无法添加,请先断电再通电,然后重试添加。也可连按网关按键十下,恢复出厂设置再重试,请注意恢复出厂设置将会清空所有使用数据,包括已添加的子设备等信息。

I was looking into <openmiio_agent> which it is said is integrated into (Xiaomi gateway3) integration.

I tried to instal that particular integration but it appears that model (ZHWG15LM) is not supported…

I am able to use Aqara Gateway integration but its use is limited and it for example does not feature calling the “ring alarm” service…