{"id":19808404,"url":"https://github.com/limitium/wand","last_synced_at":"2026-05-09T23:32:20.797Z","repository":{"id":142079065,"uuid":"298687770","full_name":"limitium/wand","owner":"limitium","description":"Xiaomi sensors bluetooth advertisement listener for esp32","archived":false,"fork":false,"pushed_at":"2021-02-08T23:14:30.000Z","size":23,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-11T06:33:24.257Z","etag":null,"topics":["advertisement","bluetooth","esp32","sensors","xiaomi"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/limitium.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-09-25T22:00:17.000Z","updated_at":"2021-06-20T14:37:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"c75c97d6-e58e-43d0-8466-40734a899a72","html_url":"https://github.com/limitium/wand","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/limitium%2Fwand","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/limitium%2Fwand/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/limitium%2Fwand/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/limitium%2Fwand/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/limitium","download_url":"https://codeload.github.com/limitium/wand/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241151742,"owners_count":19918538,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["advertisement","bluetooth","esp32","sensors","xiaomi"],"created_at":"2024-11-12T09:13:47.780Z","updated_at":"2026-05-09T23:32:15.761Z","avatar_url":"https://github.com/limitium.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wand - Xiaomi sensors bluetooth advertisement listener for esp32\n\n[![Build Status](https://travis-ci.org/limitium/wand.svg?branch=master)](https://travis-ci.org/limitium/wand)\n[![License](https://img.shields.io/badge/license-MIT%20License-blue.svg)](http://doge.mit-license.org)\n\nInspired by https://github.com/custom-components/sensor.mitemp_bt\n\n## Features\n- Simplest usage and api ever\n- Supports a lot of Xiaomi sensors\n\n## Quick start\n\n```c++\nvoid setup()\n{\n    Serial.begin(9600);\n\n    WAND::Wand wand = WAND::Wand([](const char *sensorName, BLEAddress mac, const char *paramName, float value) {\n        Serial.printf(\"Sensor: %s, param: %s, val: %.2f\\n\", sensorName, paramName, value);\n    });\n\n    wand.init();\n}\n```\n\n## Supported sensors\n- [WRDSNR01](https://github.com/limitium/feeler)\n   \n  (custom co2 sensor, build on top of esp32)\n  \n  [![WRDSNR01](https://github.com/limitium/feeler/blob/master/docs/mhz19.PNG \"Feeler\")](https://github.com/limitium/feeler)\n  \n- LYWSDCGQ\n\n  (round body, segment LCD, broadcasts temperature, humidity and battery level, about 20 readings per minute)\n  \n  ![LYWSDCGQ](https://github.com/custom-components/sensor.mitemp_bt/raw/master/pictures/LYWSDCGQ.jpg)\n  \n- CGG1\n\n  (round body, E-Ink, broadcasts temperature, humidity and battery level, about 20 readings per minute)\n\n  ![CGG1](https://github.com/custom-components/sensor.mitemp_bt/raw/master/pictures/CGG1.png)\n\n- LYWSD02\n\n  (rectangular body, E-Ink, broadcasts temperature and humidity, about 20 readings per minute, no battery info)\n\n  ![LYWSD02](https://github.com/custom-components/sensor.mitemp_bt/raw/master/pictures/LYWSD02.jpeg)\n  \n- LYWSD03MMC\n\n  (small square body, segment LCD, broadcasts temperature and humidity once in about 10 minutes and battery level once in an hour, advertisements are encrypted, therefore you need to upload custom [firmware](https://github.com/atc1441/ATC_MiThermometer)\n  \n  ![LYWSD03MMC](https://github.com/custom-components/sensor.mitemp_bt/raw/master/pictures/LYWSD03MMC.jpg)\n\n- MHO-C303\n\n  (Alarm clock, rectangular body, E-Ink, broadcasts temperature, humidity and battery level, about 20 readings per minute)\n  \n  ![MHO-C303](https://github.com/custom-components/sensor.mitemp_bt/raw/master/pictures/MHO-C303.png)\n\n- JQJCY01YM\n\n  (Xiaomi Honeywell Formaldehyde Sensor, OLED display, broadcasts temperature, humidity, formaldehyde (mg/m³) and battery level, about 50 messages per minute)\n  \n  ![supported sensors](https://github.com/custom-components/sensor.mitemp_bt/raw/master/pictures/JQJCY01YM.jpg)\n\n- HHCCJCY01\n\n  (MiFlora, broadcasts temperature, moisture, illuminance, conductivity, 1 reading per minute, no battery info with firmware v3.2.1)\n  \n  ![HHCCJCY01](https://github.com/custom-components/sensor.mitemp_bt/raw/master/pictures/HHCCJCY01.jpg)\n\n- GCLS002\n\n  (VegTrug Grow Care Garden, similar to MiFlora HHCCJCY01)\n\n  ![GCLS002](https://github.com/custom-components/sensor.mitemp_bt/raw/master/pictures/GCLS002.jpg)\n\n- HHCCPOT002\n\n  (FlowerPot, RoPot, broadcasts moisture and conductivity, 2 readings per minute, no battery info with firmware v1.2.6)\n  \n  ![HHCCPOT002](https://github.com/custom-components/sensor.mitemp_bt/raw/master/pictures/HHCCPOT002.jpg)\n\n- WX08ZM\n\n  (Xiaomi Mija Mosquito Repellent, Smart version, broadcasts switch state, tablet resource, battery level, about 50 messages per minute)\n \n  ![supported sensors](https://github.com/custom-components/sensor.mitemp_bt/raw/master/pictures/WX08ZM.jpg)\n\n\n## Exmaple\n- [Basic](https://github.com/limitium/wand/tree/master/examples/basic) - basic=full usage example\n\n## Dependencies\n* [ESP32_BLE_Arduino](https://github.com/nkolban/ESP32_BLE_Arduino)\n\n## License\nWand is open-source software licensed under the [MIT license](http://opensource.org/licenses/MIT)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flimitium%2Fwand","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flimitium%2Fwand","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flimitium%2Fwand/lists"}