Xiaomi Mijia Smart Multi-Mode Gateway (ZNDMWG03LM) support

I have this gateway and it is integrated with Ha using the Homekit integration. I have several contact sensors and motion sensors (RTCGQ11LM) working fine but the issue is that the illuminace sensor is not being detect by home assistant. Anybody with this issue? any clue?

Yes, I wrote couple of posts higher that the luminance sensors aren’t exposed.

Hi, I read your article, but I couldn’t get it up and running. Can you please do the step by step guide. Ideally even with codes? Maybe in the form of a video tutorial? Thanks

I bought this device through this thread. Yesterday I integrated it into mi home app (android) and homekit (ipad). Then removed it from both apps and update the firmware. After that I re-integrated it to the mi home app (iphone and ipad mi home app works fine) but I can’t make it appear in homekit (ipad) nor integrate it through home assistant (raspberry pi3 + running hass.io). please help :frowning:

1 Like

What steps have you taken so far on home assistant to integrate it?

This gateway has much more potential that you may think. I’ve been working with this device last few weeks and have something to share with community. Ok, first of all here is how to get root access without disassembling. Just send this command via MIIO protocol:

{"id":0,"method":"enable_telnet_service", "params":[]}

then you can telnet on it, use login “admin” or “app”. no password.

How to send message via MIIO: you need device token. There are a lot of methods you can find on internet how to do this, I used this one: download and install modified MiHome
Authorise, click on “Mi Smart Home Hub”, thee dots, Additional Settings, Network info. Here you will find token at the very bottom.
Then use this tool https://github.com/skysilver-lab/php-miio to send miio message to device:

php miio-cli.php  --ip $ip --token $token --sendcmd '{"id":0,"method":"enable_telnet_service", "params":[]}'

now you have telnet enabled.

There is a mosquito broker running and all internal communication is running via mqtt messages. I was able to integrate all my devices with HA with help of NodeRed and simple workflow.


For unknown reasons this instruction will lead to bootloop in most cases!! I could not figure the reason for this. Don’t follow unless you’re familiar with SPI flasing, etc…

Modifying filesystem:

First thing you MUST do once you got root access is to BACKUP EVERYTHING.

  1. Check MTD table:
# cat /proc/mtd
dev:    size   erasesize  name
mtd0: 000a0000 00020000 "bootloader"
mtd1: 00020000 00020000 "boot_info"
mtd2: 00020000 00020000 "factory"
mtd3: 00020000 00020000 "mtd_oops"
mtd4: 00100000 00020000 "bbt"
mtd5: 00300000 00020000 "linux_1"
mtd6: 01900000 00020000 "rootfs_1"
mtd7: 00300000 00020000 "linux_2"
mtd8: 01900000 00020000 "rootfs_2"
mtd9: 00100000 00020000 "homekit"
mtd10: 03820000 00020000 "AppData"
  1. Copy EACH partition somewhere:
    run on your linux device:
nc -l  -p 2222 | dd of=mtd0(1,2,3...)

run on Mi Gateway:

dd if=/dev/mtd0(1,2,3...) | nc linux_device_ip 2222
  1. Check your boot configuration:
# boot_ctrl show
vernum: 0
kernel: 0 0
rootfs: 0 0
kernel_0: 0 c8cf 2157572
kernel_1: 3 e87e 2126852
rootfs_0: 0 62c6 8552452
rootfs_1: 0 a40a 7704580
root_sum_check: off
priv_mode: on

If your “kernel” and “rootfs” has “0 0” it means your active kernel is kernel_0 and active root_fs is rootfs_0. If “kernel” and “rootfs” are “1 1” then your active kernel is kernel_1 and active root_fs is rootfs_1.
Do NOT make any modifications to kernel! Contrary to rootfs, kernel’s checksum is checking at every boot!
4. On your linux machine, unpack your ACTIVE root filesystem (rootfs_0 or rootfs_1):

sudo unsquashfs mtd6.bin

always run unsqashfs with root priveleges, because filesystem comtails “special” files wich cannot be accessed by normal user
5. “cd” to “squashfs-root” and make your changes. I did following:

  1. Delete bin/tty0_disable. This app disables internal console for embedded UART0. You don’t need it
rm bin/tty0_disable
touch bin/tty0_disable
chmod +x bin/tty0_disable
  1. edit etc/init.d/rcS and add “telnetd” line somewhere after network interfaces configuration block.
  2. edit usr/app/bin/startup.sh and remove/comment out following line:
echo disable > /sys/class/tty/tty/enable
  1. add following at the end of usr/app/bin/startup.sh, before “exit 0”:

/data partition is writable, so so will not have to recompile rootfs next time when you want to run something on boot.
5. edit etc/mosquitto/mosquitto.conf and remove/comment out “listen”. Or (as I did), make a symlink of this file to /data partition.
6. When you ready with modifications, compile filesystem:

sudo mksquashfs squashfs-root/ livefs.squashfs -noappend -always-use-fragments -no-xattrs -comp xz

-no-xattrs and -comp xz are most important options. do NOT change them!
7. upload modified partition to gateway using netcat and dd to some temp location, but NOT to mtd device directly! for example to /var/tmp
8. using dd, copy partition to corresponding block device:
-if active rootfs is 0:

dd if=/var/tmp/new_rootfs of=/dev/mtdblock6

-if active rootfs is 1:

dd if=/var/tmp/new_rootfs of=/dev/mtdblock8
  1. Wait few minutes after you finish. Do not reboot yet! You need to check if everything is ok. Dump again active rootfs (/dev/mtd6 or /dev/mtd8) and check if it has a data inside. If dump is empty - repeat steps 7-8-9!
    -use /dev/mtdX to READ data
    -use /dev/mtdbockX to WRITE data

  2. REBOOT! :slight_smile:


Does that mean you can bridge the gateway’s mosquitto to your local mqtt broker, and control using mqtt ?

The gateway’s internal mqtt messaging format is not suitable for HA OOTB: all communications goes via same topic. So it makes no sense to bridge brokers. You need “something” between gateway’s broker and HA. NodeRed is good candidate, but maybe there is more sophisticated approach. I’m not specialist here, just learning

1 Like

Thanks for the information.

User and password for telnet service ?

it is in my original post:

Sorry, my fault.

And the last custion. There is any possibility to do this from inside hub with telnet: network.open_pf = 3

Nope. There is no such command. This gateway don’t have easy/native integration with HomeAssistant (yet), but have big potential to have one.

Then we wait. Thanks for all.

@serrj-sv I have been working on a new homeassistant integration for xiaomi miio gateways (xiaomi miio) it is already in the latest HomeAssistant release and schould probably auto-detect this gateway ZNDMWG03LM.

I just created a PR to include your “enable_telnet_service” command to the python-miio library: https://github.com/rytilahti/python-miio/pull/734/files

Do you know more commands for the ZNDMWG03LM gateway?
Is there an easy way to get the zigbee device list from the telnet interface (some gateway models do not support the "get_device_prop", ["lumi.0", "device_list"] command)?

@serrj-sv do you know if

{"id":0,"method":"disable_telnet_service", "params":[]}

is also a valid command?

1 Like

I highly doubt so. This gateway works completely differently from previous ones. It uses MQTT internally and I honestly see no reason to use extra vendor layer (miio) to communicate with the gateway.

I didn’t inspect thoroughly because all functionality I needed were already provided by mqtt. There is no “psm-set” command for sure and no way to open port 9898 but as I said I see no reason for it. It would be better to make new integration for this particular model using mqtt.

I’m not familiar with miio protocol, so have no idea. Probably there is a way to get this information via mqtt.
You can see cannected devices here:

# cat /data/zigbee/device.info 

why on earth someone would need such a command? :slight_smile:

1 Like

Ok, i have enablet telnet. Now i want to integrate with openhab, but i don’t understand node-red yet. Do I have to write it myself or have someone made the Mija v3 gateway integration in node-red?

> telnet
> Trying
> Connected to
> Escape character is '^]'.
> rlxlinux login: admin
> Lumi Linux version 3.0
>   _               _    _  _
>  | |             |_|  | ||_|
>  | | _  _  _____  _   | | _ ____  _   _  _  _
>  | || || ||     \| |  | || |  _ \| | | |\ \/ /
>  | || || || | | || |  | || | | | | |_| |/    \
>  |_|\____||_|_|_||_|  |_||_|_| |_|\____|\_/\_/
> For further information check:
> https://www.aqara.com
> BusyBox v1.22.1 (2020-03-19 12:38:22 CST) built-in shell (ash)
> Enter 'help' for a list of built-in commands.`

After using the cat /data/miio/device.conf command, information with the same key as in previous versions of the gate pops up. Perhaps there is an option to use older integration.

# cat device.conf

and after cat /data/miio/device.token

# cat device.token

after # /data/cat /config/lumi.conf

# cat lumi.conf

In addition, you can view information about connected devices

# cat /data/hw_setting/zigbee_gw.db