How to use Aqara Hub M1S 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不能同时绑定

There are differentAqara Hub M1/M1S gateways available in the market, these is compatible with the hom assistant
Aqara Hub M1/M1S gateway gen 1
December 17th 2019

that hunger was finally sated as the M2 officially launched in China
Product model:ZHWG11LM Chinese version

Aqara Hub M1/M1S gateway gen 2

2020-09-23 M1S gen1
Product model:ZHWG15LM Chinese version
lumi.gateway.acn01

Aqara Hub M1/M1S gateway gen 3

2021-09-08
Aqara has announced a updated M1S 2022 hub for the Chinese market
Product model: ZHWG20LM (Chinese version)
lumi.gateway.acn04

Aqara Hub M1/M1S gateway gen 4

20230714 M1S gen2
Product model:ZHWG15LM Chinese version
lumi.gateway.acn08

Note
the Aqara M1/M1S is not a Xiaomi product but it should work with Xiaomi HA integration
The M1/M1S is a full Aqara product.

you can add it using the HomeKit Controller integration and it has been very stable, no issues at all.

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 (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

4.2023-07-14 发布Aqara Hub M1S 2nd gen

Product Name:Aqara Hub M1S (cn)

This is the gen2 version m1s hub.

 Model Number:  ZHWG15LM
 Product Model Variant:  ZHWG15LM   Chinese version
 Internal model:lumi.gateway.acn08
 Brand:  Lumi United Technology Co., Ltd
 Category:  Smart Home
 Release Date:  2023-07-14
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)

The first version of the Aqara hub (M1 Not M1S)

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

[https://homekitnews.com/2019/12/17/aqara-hub-101/)]

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.

Useful links
https://community.home-assistant.io/t/not-able-to-get-xiaomi-gateway-key/61795/196

service: xiaomi_aqara.play_ringtone

https://community.home-assistant.io/t/not-able-to-get-xiaomi-gateway-key/61795/218?u=msly

I have chineses versions for the 5 chinese version of ZHWG11LM i owned. Mainland China in the MiHome App config.

Everything is auto discovered in HA with the new integration Xiaomi Homekit.
https://community.home-assistant.io/t/not-able-to-get-xiaomi-gateway-key/61795/227?u=msly

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
Date of Certification: August 9, 2021
Certification ID: WFA113660


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…