https://github.com/matthias-bs/atc_mithermometer

Arduino BLE Client library for receiving ATC_MiThermometer Data (as Advertising Data)
https://github.com/matthias-bs/atc_mithermometer

arduino arduino-library ble esp32 esp32-arduino sensors

Last synced: 3 months ago
JSON representation

Arduino BLE Client library for receiving ATC_MiThermometer Data (as Advertising Data)

• Host: GitHub
• URL: https://github.com/matthias-bs/atc_mithermometer
• Owner: matthias-bs
• License: mit
• Created: 2022-11-23T19:00:31.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-04-26T07:09:08.000Z (9 months ago)
• Last Synced: 2024-04-26T21:25:13.600Z (9 months ago)
• Topics: arduino, arduino-library, ble, esp32, esp32-arduino, sensors
• Language: C++
• Homepage:
• Size: 237 KB
• Stars: 7
• Watchers: 3
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# ATC_MiThermometer

[![CI](https://github.com/matthias-bs/ATC_MiThermometer/actions/workflows/CI.yml/badge.svg)](https://github.com/matthias-bs/ATC_MiThermometer/actions/workflows/CI.yml)

[![GitHub release](https://img.shields.io/github/release/matthias-bs/ATC_MiThermometer?maxAge=3600)](https://github.com/matthias-bs/ATC_MiThermometer/releases)

[![License: MIT](https://img.shields.io/badge/license-MIT-green)](https://github.com/matthias-bs/ATC_MiThermometer/blob/main/LICENSE)

Arduino BLE Client Library based on [NimBLE-Arduino](https://github.com/h2zero/NimBLE-Arduino) for receiving ATC_MiThermometer Data (as Advertising Data) - both the "custom" format and the original "atc1441" format are supported.

This project allows to receive data from a battery-powered bluetooth low energy thermometer/hygrometer like the Xiaomi Mijia (LYWSD03MMC) running the custom firmware [ATC_MiThermometer](https://github.com/pvvx/ATC_MiThermometer). The software runs in the Arduino environment on all devices dupported by [NimBLE-Arduino](https://github.com/h2zero/NimBLE-Arduino).

The [ATC_MiThermometer](https://github.com/pvvx/ATC_MiThermometer) firmware sends the sensor and status data as BLE advertisements, i.e. multiple clients can receive and use the sensor data.

This project is the successor of [ESP32_ATC_MiThermometer_Library](https://github.com/matthias-bs/ESP32_ATC_MiThermometer_Library) - with all its benefits inherited from [NimBLE-Arduino](https://github.com/h2zero/NimBLE-Arduino).

## Example

```

#include "ATC_MiThermometer.h"

const int scanTime = 5; // BLE scan time in seconds

// List of known sensors' BLE addresses

std::vector knownBLEAddresses = {"a4:c1:38:b8:1f:7f", "a4:c1:38:bf:e1:bc"};

ATC_MiThermometer miThermometer(knownBLEAddresses);

void setup() {

    Serial.begin(115200);

    

    // Initialization

    miThermometer.begin();

}

void loop() {

    // Set sensor data invalid

    miThermometer.resetData();

    

    // Get sensor data - run BLE scan for 

    unsigned found = miThermometer.getData(scanTime);

    for (int i=0; i < miThermometer.data.size(); i++) {  

        if (miThermometer.data[i].valid) {

            Serial.println();

            Serial.printf("Sensor %d: %s\n", i, knownBLEAddresses[i].c_str());

            Serial.printf("Name: %s\n", miThermometer.data[i].name.c_str());

            Serial.printf("%.2f°C\n", miThermometer.data[i].temperature/100.0);

            Serial.printf("%.2f%%\n", miThermometer.data[i].humidity/100.0);

            Serial.printf("%.3fV\n",  miThermometer.data[i].batt_voltage/1000.0);

            Serial.printf("%d%%\n",   miThermometer.data[i].batt_level);

            Serial.printf("%ddBm\n",  miThermometer.data[i].rssi);

            Serial.println();

         }

    }

    Serial.print("Devices found: ");

    Serial.println(found);

    Serial.println();

    // Delete results from BLEScan buffer to release memory

    miThermometer.clearScanResults();

    delay(5000);

}

```

## Source Code Documentation

https://matthias-bs.github.io/ATC_MiThermometer/

## Alternative

You might want to have a look at [Theengs Decoder](https://decoder.theengs.io/). It is also built on NimBLE-Arduino, runs on ESP32, seems to decode both variants of the alternative LYWSD03MMC firmware and many devices more.