From 30e1e680b76b5ebb24ea29187adc4f9b13660f98 Mon Sep 17 00:00:00 2001
From: ttu <tomi.tuhkanen@iki.fi>
Date: Mon, 20 Jan 2025 19:22:34 +0200
Subject: [PATCH] Update documentation

---
 CHANGELOG.md |  2 +-
 README.md    | 10 ++++++++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 67d936a..03bac1c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,7 +1,7 @@
 ## Changelog
 
 ### [Unreleased]
-
+* ADD: RUUVI_MACOS_USE_MAC_ADDR environment variable to enable MAC address usage on macOS
 
 ## [3.0.0] - 2025-01-13
 * ADD: Install Bleak automatically on all platforms
diff --git a/README.md b/README.md
index a78a178..8800bcb 100644
--- a/README.md
+++ b/README.md
@@ -479,6 +479,16 @@ if __name__ == "__main__":
 
 Check [get_async_bleak](https://github.com/ttu/ruuvitag-sensor/blob/master/examples/get_async_bleak.py) and other async examples from [examples](https://github.com/ttu/ruuvitag-sensor/tree/master/examples) directory.
 
+#### Use MAC Address Instead of Device-Specific ID on macOS
+
+Bleak has a workaround for macOS to use MAC address instead of device-specific ID. This is experimental feature from Bleak and may break with macOS updates. 
+
+Set the `RUUVI_MACOS_USE_MAC_ADDR` environment variable to `true` to enable it. 
+
+```sh
+$ export RUUVI_MACOS_USE_MAC_ADDR=true
+```
+
 #### Bleak dummy BLE data
 
 Bleak-adapter has a development-time generator for dummy data, which can be useful during development if no sensors are available. Set the `RUUVI_BLE_ADAPTER` environment variable to `bleak_dev`.