Skip to content

Commit

Permalink
Merge pull request #32 from hlgirard/hlg_update_readme_for_macos
Browse files Browse the repository at this point in the history
Update readme for macos
  • Loading branch information
keshavdv committed Jun 21, 2023
2 parents 68308d0 + 1efbf24 commit 71c6849
Showing 1 changed file with 16 additions and 0 deletions.
16 changes: 16 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,10 @@ To be able to decrypt the contents of the advertisement, you'll need to first fe

**OSX**

[MacOS's bleak backend](https://bleak.readthedocs.io/en/latest/backends/macos.html) uses a bluetooth UUID address instead of the more traditional MAC address to identify bluetooth devices. This UUID address is often unique to the device scanned *and* the device being scanned such that it cannot be used to connect to the same device from another computer.

If you are going to use `victron-ble` on the same Mac computer as you have the Victron app on, follow the instructions below to retrieve the address UUID and advertisement key:

1. Install the Victron app from the Mac App Store
2. Pair with your device at least once to transfer keys
3. Run the following from Terminal to dump the known keys (install `sqlite3` via Homebrew)
Expand All @@ -53,6 +57,18 @@ To be able to decrypt the contents of the advertisement, you'll need to first fe
```

If you are going to use `victron-ble` on a different non-MacOS computer than the one with the Victron app (e.g. on a Raspberry Pi), follow these instructions to obtain the bluetooth MAC address and advertisement key instead:

1. Install the Victron app from the Mac App Store
2. Pair with your device at least once to transfer keys
3. Run the following from Terminal to dump the known keys (install `sqlite3` via Homebrew)
```bash
❯ sqlite3 ~/Library/Containers/com.victronenergy.victronconnect.mac/Data/Library/Application\ Support/Victron\ Energy/Victron\ Connect/d25b6546b47ebb21a04ff86a2c4fbb76.sqlite 'select macAddress,advertisementKey from advertisementKeys'
a0f478020fe1|0df4d0395b7d1a876c0c33ecb9e70dcd
```

**Linux**

1. Download the Victron AppImage app from the Victron website.
Expand Down

0 comments on commit 71c6849

Please sign in to comment.