Coder Social home page Coder Social logo

z03mmc's Introduction

Zigbee 3.0 Firmware for original LYWSD03MMC Sensor

This repository contains the Zigbee firmware for Xiaomi LYWSD03MMC Bluetooth temperature and humidity sensor.

Overview

The LYWSD03MMC is a Bluetooth temperature and humidity sensor that can be integrated into a Zigbee network using this firmware. This repository hosts the code and related resources to flash the device and make it compatible with Zigbee networks.

Features

Getting Started

Prerequisites

  • Zigbee compatible hardware (e.g., Zigbee coordinator or gateway).
  • Necessary tools for flashing firmware to the sensor.

Building firmware

  1. Clone TC32 toolchain according to your host OS:

    git clone https://github.com/devbis/tc32.git -b linux
    git clone https://github.com/devbis/tc32.git -b macos
    git clone https://github.com/devbis/tc32.git -b windows
  2. Clone this repository and SDK:

    git clone https://github.com/devbis/z03mmc.git
    git clone https://github.com/devbis/tl_zigbee_sdk.git -b 3.6.8.5 --depth 1
    
    cd z03mmc
  3. Configure and build:

    cmake -DSDK_PREFIX=$(pwd)/../tl_zigbee_sdk -DTOOLCHAIN_PREFIX=$(pwd)/../tc32 -B build .
    cmake --build build --target z03mmc.zigbee

    Firmware binary is located at build/src/z03mmc.bin The binary with OTA header is at the same folder, ending with z03mmc.zigbee

Flashing from a custom bluetooth firmware (easy way for new devices)

  1. Open an awesome tool from ATC_MiThermometer https://pvvx.github.io/ATC_MiThermometer/TelinkMiFlasher.html
  2. Click "Connect" button and find device LYWSD03MMC, wait connection (Connected in logs)
  3. On new device with stock firmware click "Do Activation" and wait some time
  4. Next "Select Firmware", choose file with custom bluetooth firmware ATC_ota_400000, click "Start Flashing"
  5. You will see in logs "Update done after NN seconds"
  6. Reboot device removing battery, refresh web-page with flashing tool and connect device again (with name ATC_802190 or similar, based on mac-address). Do not change any control on page
  7. Flash latest z03mmc.bin firmware over transitional firmware to convert it to zigbee. Use https://devbis.github.io/telink-zigbee/ page if previous flasher stops because of the firmware size.

Flashing firmware with USB to UART

Prerequisites:

  1. TTL-USB adaptor
  2. 1k-1.8k Ohm resistor
  3. python3 with pyserial module installed

To flash a new firmware via an standard USB to UART adapter, simply connect the Thermometer as seen in the picture Mi_SWS_Connection.jpg to the USB to UART converter and run the TLSR825xComFlasher.py tool.

Example: python3 TLSR825xComFlasher.py -p COM3 wf 0 z03mmc.bin

Example: python3 TLSR825xComFlasher.py -p /dev/ttyUSB0 wf 0 z03mmc.bin

In case if the SWS pin is used by the firmware, try this sequence:

  1. Power off the sensor
  2. python3 TLSR825xComFlasher.py -p <YOUR_COM_PORT> -t5000 wf 0 z03mmc.bin
  3. Now you have 5 seconds to power on the sensor
  4. In case the chip has not started being flashed, run python3 TLSR825xComFlasher.py -p <YOUR_COM_PORT> wf 0 z03mmc.bin without the timeout again.

If the flashing fails try to increase timeouts in the script.

The UART flasher software uses the tool from https://github.com/pvvx/ATC_MiThermometer. Thanks to pvvx for the awesome work on this!

Related Work

z03mmc is based on the original work of @pvvx, and @atc1441, who developed the initial firmware versions for bluetooth-capable device.

Usage

  1. Flash the firmware
  2. Enable pairing mode on Zigbee coordinator
  3. In case it is not joining, close the RESET and GND contacts on the board for 3 seconds to reset Zigbee settings. Replug the battery may require
  4. For zigbee2mqtt you need to add custom converter if you use version 1.33.1 or earlier

License

This project is licensed under the GNU General Public License 3.0 or later - see the LICENSE.txt file for details.

z03mmc's People

Contributors

devbis avatar egmen avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.