Skip to content

Commit

Permalink
Documentation: adding macOS requirements for Bluetooth using (#1361)
Browse files Browse the repository at this point in the history
* Update TROUBLESHOOTING.md

add macOS bluetooth profile installation

* Update nodejs-ble README.md

add requirement for macOS
  • Loading branch information
leonardocavagnis authored Nov 5, 2024
1 parent 3dada46 commit 6fb0453
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 0 deletions.
14 changes: 14 additions & 0 deletions docs/TROUBLESHOOTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -122,3 +122,17 @@ Matter.js based projects show up as "uncertified test devices" in the ecosystems

Some ecosystems might not allow uncertified devices to be added. In this case you need to check the settings of the ecosystem to allow uncertified devices or contact the support of the ecosystem.

### Bluetooth and macOS

When pairing a Matter accessory over Bluetooth on macOS, you may encounter connectivity issues, such as an inability to connect to the device, problems with BLE scanning, or failure to receive responses from the peripheral. These issues may be caused by the absence of a required profile.

To resolve this, it is necessary to install the [Bluetooth Central Matter Client Developer mode profile](https://developer.apple.com/services-account/download?path=/iOS/iOS_Logs/EnableBluetoothCentralMatterClientDeveloperMode.mobileconfig) on macOS:

- Download the Bluetooth Central Matter Client Developer Mode profile and
install it.

- Profile can be installed via Settings->Privacy &
Security->Profiles

- Restart your system

1 change: 1 addition & 0 deletions packages/nodejs-ble/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@ The used packages have some limitations and prerequisites. Please check the Read
* [noble](https://github.com/abandonware/noble#readme)
* Consider Noble prerequisites for your platform: https://github.com/stoprocent/noble#prerequisites
* For Linux: https://github.com/stoprocent/noble#running-without-rootsudo-linux-specific
* For macOS: Install [Bluetooth Central Matter Client Developer mode profile](../../docs/TROUBLESHOOTING.md#bluetooth-and-macos)
* When using Device and Controller in parallel: https://github.com/stoprocent/noble#bleno-compatibility-linux-specific (NOBLE_MULTI_ROLE might be needed to set)
* Please also see common issues and solutions: https://github.com/stoprocent/noble#common-problems

Expand Down

0 comments on commit 6fb0453

Please sign in to comment.