kb01/zmk
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

add os tabs, fix numbering

Browse source
This commit is contained in:
tominabox1 2020-12-29 08:04:44 -06:00
parent 60589fb1cb
commit f24a0b2713
1 changed files with 43 additions and 31 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

74
docs/docs/troubleshooting.md
View file

@ -84,26 +84,37 @@ The workaround for this limitation is as follows:
1. In macOS, clear the profile on your keyboard and pair with your computer. 1. In macOS, clear the profile on your keyboard and pair with your computer.
1. Once paired, hold Option + Control + Shift and click on the bluetooth icon in your menubar. Take note of the "Address" of your computer's bluetooth device (`65-FD-3B-1A-DB-48` here), as well as the address of the connected device (`E6-24-54-08-BC-A3` here). 1. Once paired, hold Option + Control + Shift and click on the bluetooth icon in your menubar. Take note of the "Address" of your computer's bluetooth device (`65-FD-3B-1A-DB-48` here), as well as the address of the connected device (`E6-24-54-08-BC-A3` here).
| ![BT Contextual Menu](../docs/assets/troubleshooting/dualboot/bt_addresses.png) | | ![BT Contextual Menu](../docs/assets/troubleshooting/dualboot/bt_addresses.png) |
| :-----------------------------------------------------------------------------: | | :-----------------------------------------------------------------------------: |
| Bluetooth Context Menu | | Bluetooth Context Menu |
1. Now open the terminal app (Applications/Utilities/Terminal.app) and paste the following command and enter your root password. 1. Now open the terminal app (Applications/Utilities/Terminal.app) and paste the following command and enter your root password.
**macOS High Sierra (10.13) and newer** <Tabs
``` defaultValue="HS"
sudo defaults read /private/var/root/Library/Preferences/com.apple.bluetoothd.plist values={[
``` {label: 'macOS High Sierra (10.13) and newer', value: 'high_sierra'},
**macOS Sierra (10.12) and older** {label: 'macOS Sierra (10.12) and older', value: 'sierra'},
``` ]}>
sudo defaults read /private/var/root/Library/Preferences/blued.plist <TabItem value="high_sierra">
```
This will print the contents of the bluetooth plist file containing the pairing keys for your bluetooth devices. ```
sudo defaults read /private/var/root/Library/Preferences/com.apple.bluetoothd.plist
```
</TabItem>
<TabItem value="sierra">
| ![BT Plist](../docs/assets/troubleshooting/dualboot/plist.png) | ```
| :------------------------------------------------------------: | sudo defaults read /private/var/root/Library/Preferences/blued.plist
| Bluetooth .plist | ```
</TabItem>
</Tabs>;
This will print the contents of the bluetooth plist file containing the pairing keys for your bluetooth devices.
| ![BT Plist](../docs/assets/troubleshooting/dualboot/plist.png) |
| :------------------------------------------------------------: |
| Bluetooth .plist |
1. Look for the section that starts with `SMPDistributionKeys =`. Below this, find your host's bluetooth address (`65-FD-3B-1A-DB-48` in this example) and then look for the address of your keyboard (`6E-24-54-08-BC-A3` in this example). 1. Look for the section that starts with `SMPDistributionKeys =`. Below this, find your host's bluetooth address (`65-FD-3B-1A-DB-48` in this example) and then look for the address of your keyboard (`6E-24-54-08-BC-A3` in this example).
1. Under your keyboard address, find the value labeled LocalLTK (in the screenshot above it is `0x8968239e350b2cb7df16d8f47c774e2c`). Copy this value into a text file that you can access from Windows, this is the value we will need to enter into the registry later on. 1. Under your keyboard address, find the value labeled LocalLTK (in the screenshot above it is `0x8968239e350b2cb7df16d8f47c774e2c`). Copy this value into a text file that you can access from Windows, this is the value we will need to enter into the registry later on.
@ -113,30 +124,31 @@ sudo defaults read /private/var/root/Library/Preferences/blued.plist
1. Open the Start Menu, type `cmd` and hit control + shift + enter to launch an elevated command prompt. 1. Open the Start Menu, type `cmd` and hit control + shift + enter to launch an elevated command prompt.
1. Enter the following, one at a time: 1. Enter the following, one at a time:
``` ```
cd c:\Users\<username>\Desktop cd c:\Users\<username>\Desktop
psexec -s -i regedit psexec -s -i regedit
``` ```
Regedit will launch. Be careful in here as certain registry edits can cause your system to become unstable or unbootable! Edit only the entry shown in this guide. Regedit will launch. Be careful in here as certain registry edits can cause your system to become unstable or unbootable! Edit only the entry shown in this guide.
1. Navigate in the registry to this key
1. Navigate in the registry to this key
```
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BTHPORT\Parameters\Keys\ ```
``` HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BTHPORT\Parameters\Keys\
```
1. Inside "Keys", select the address of your host bluetooth device. It should be the same as it was in macOS (`65-FD-3B-1A-DB-48` in this example). 1. Inside "Keys", select the address of your host bluetooth device. It should be the same as it was in macOS (`65-FD-3B-1A-DB-48` in this example).
1. Below that, find the address that matches your keyboard's from macOS (`6-24-54-08-BC-A3` in this example). 1. Below that, find the address that matches your keyboard's from macOS (`6-24-54-08-BC-A3` in this example).
| ![Registry Key](../docs/assets/troubleshooting/dualboot/Registry1.png) | | ![Registry Key](../docs/assets/troubleshooting/dualboot/Registry1.png) |
| :--------------------------------------------------------------------: | | :--------------------------------------------------------------------: |
| Registry Key | | Registry Key |
1. Under that, there should be a registry entry called "LTK". Double click on this entry to modify it. Regedit will pop up a hex editing window. Delete the contents to start with a blank value. Refer to the LocalLTK value you saved from macOS and enter it into this dialog box, omitting the "0x" at the beginning. Regedit will automatically advance you through the hex pairs. When you're done the window should look something like this: 1. Under that, there should be a registry entry called "LTK". Double click on this entry to modify it. Regedit will pop up a hex editing window. Delete the contents to start with a blank value. Refer to the LocalLTK value you saved from macOS and enter it into this dialog box, omitting the "0x" at the beginning. Regedit will automatically advance you through the hex pairs. When you're done the window should look something like this:
| ![Registry Key Edit](../docs/assets/troubleshooting/dualboot/Registry2.png) | | ![Registry Key Edit](../docs/assets/troubleshooting/dualboot/Registry2.png) |
| :-------------------------------------------------------------------------: | | :-------------------------------------------------------------------------: |
| Registry Key Editor | | Registry Key Editor |
1. Select OK, exit Regedit, and reboot into Windows. 1. Select OK, exit Regedit, and reboot into Windows.
1. Once rebooted, turn bluetooth back on, and make sure your keyboard is on the same profile you had selected in macOS. Your keyboard should connect and start working! 1. Once rebooted, turn bluetooth back on, and make sure your keyboard is on the same profile you had selected in macOS. Your keyboard should connect and start working!