diff --git a/documents/README/Victron_SmartShunt_HowTo.md b/documents/README/Victron_SmartShunt_HowTo.md new file mode 100644 index 0000000..5ff6035 --- /dev/null +++ b/documents/README/Victron_SmartShunt_HowTo.md @@ -0,0 +1,27 @@ +# Victron SmartShunt How To + +[![Badge License: GPLv3](https://img.shields.io/badge/License-GPLv3-brightgreen.svg)](https://www.gnu.org/licenses/gpl-3.0) +[![Badge Version](https://img.shields.io/github/v/release/Sleeper85/esphome-yambms?include_prereleases&color=yellow&logo=DocuSign&logoColor=white)](https://github.com/Sleeper85/esphome-yambms/releases/latest) +![GitHub stars](https://img.shields.io/github/stars/Sleeper85/esphome-yambms) +![GitHub forks](https://img.shields.io/github/forks/Sleeper85/esphome-yambms) +![GitHub watchers](https://img.shields.io/github/watchers/Sleeper85/esphome-yambms) + +## How to retrieve MAC address and encryption key + +To connect to your Victron device with BLE component you must have two information : + +- `mac_address` - Bluetooth mac address of device. +- `encryption_key` - AES encryption key. + +Use [VictronConnect App v5.93](https://www.victronenergy.com/live/victronconnect:beta) (or later) released on 2023-08-25. + +![VictronConnect App Settings page](../../images/Victron_SmartShunt_App_01_Settings.png) +![VictronConnect App Product info page](../../images/Victron_SmartShunt_App_02_ProductInfo.png) +![VictronConnect App Instant readout encryption data](../../images/Victron_SmartShunt_App_03_EncryptionData.png) + +1. Open "Settings" of Device. +2. Open "Product Info" page. +3. Ensure `Instant readout via Bluetooth` is enabled. +4. Bottom of page press `SHOW` for Instant readout details Encryption data. + +When connected to the device via VictronConnect App no Instant readout (Bluetooth advertising) data is generated. diff --git a/images/Victron_SmartShunt_App_01_Settings.png b/images/Victron_SmartShunt_App_01_Settings.png new file mode 100644 index 0000000..5fefa2a Binary files /dev/null and b/images/Victron_SmartShunt_App_01_Settings.png differ diff --git a/images/Victron_SmartShunt_App_02_ProductInfo.png b/images/Victron_SmartShunt_App_02_ProductInfo.png new file mode 100644 index 0000000..c30557b Binary files /dev/null and b/images/Victron_SmartShunt_App_02_ProductInfo.png differ diff --git a/images/Victron_SmartShunt_App_03_EncryptionData.png b/images/Victron_SmartShunt_App_03_EncryptionData.png new file mode 100644 index 0000000..4e83f1f Binary files /dev/null and b/images/Victron_SmartShunt_App_03_EncryptionData.png differ