OpenIntelWireless

https://openintelwireless.github.io/
Admin
OpenIntelWireless provides open-source Intel wireless networking drivers and related tools for...
Tokens:3,810
Snippets:77
Trust Score:9.7
Update:4 months ago
Show doc for...
Tokens:
Raw
### Install Xcode Command Line Tools

Source: https://openintelwireless.github.io/HeliPort/Advanced.html

Installs the necessary command line tools for Xcode. Ensure you have macOS 10.12 or later.

```bash
xcode-select --install
sudo xcode-select --switch /Library/Developer/CommandLineTools
```

--------------------------------

### Build IntelBluetoothFirmware from Source

Source: https://openintelwireless.github.io/IntelBluetoothFirmware/Advanced.html

Clone the IntelBluetoothFirmware repository and its dependency MacKernelSDK, then build the project using xcodebuild. Ensure you have Xcode installed.

```shell
git clone --depth=1 https://github.com/OpenIntelWireless/IntelBluetoothFirmware.git

cd IntelBluetoothFirmware

git clone --depth=1 https://github.com/acidanthera/MacKernelSDK.git

xcodebuild -alltargets -derivedDataPath build

open ./build/Build/Products/Release
```

--------------------------------

### Collect Intel Firmware Logs

Source: https://openintelwireless.github.io/IntelBluetoothFirmware/Troubleshooting.html

Run this command in Terminal after installing DebugEnhancer.kext to collect logs related to Intel Firmware. Ensure a cold boot has been performed for accurate results.

```shell
sudo dmesg | grep IntelFirmware
```

--------------------------------

### Build HeliPort Application

Source: https://openintelwireless.github.io/HeliPort/Advanced.html

Clones the HeliPort repository, installs dependencies, and builds the application using xcodebuild. Requires Git, CocoaPods, and Xcode.

```sh
git clone --depth=1 https://github.com/OpenIntelWireless/HeliPort.git
cd HeliPort
pod install
xcodebuild -workspace HeliPort.xcworkspace -scheme HeliPort -derivedDataPath build
open ./build/Build/Products/Release
```

--------------------------------

### Open System Configuration Directory

Source: https://openintelwireless.github.io/itlwm/Troubleshooting.html

Opens the System Configuration directory in Finder, allowing manual deletion of network preference files.

```bash
open /Library/Preferences/SystemConfiguration
```

--------------------------------

### Check itlwm Kernel Extension Status

Source: https://openintelwireless.github.io/itlwm/Troubleshooting.html

Use this command to verify if the itlwm kernel extension is loaded. If no output is shown, check your bootloader configuration.

```bash
kextstat | grep -i "itlwm"
```

```bash
$kextstat | grep -i "itlwm"
    70    0 0xffffff7f84126000 0xf86000   0xf86000   com.zxystd.itlwm (1) 10EA7641-BDCB-3820-9AF7-4C773FD9953E <33 13 6 5 3 1>
```

--------------------------------

### Enable Airportd Logs

Source: https://openintelwireless.github.io/itlwm/Troubleshooting.html

Enables detailed logging for airportd, which is necessary for collecting comprehensive logs related to Wi-Fi functionality. Run this before attempting to reproduce an issue.

```bash
# Enable airportd logs
sudo /System/Library/PrivateFrameworks/Apple80211.framework/Versions/A/Resources/airport debug +AllUserland +AllDriver +AllVendor
```

--------------------------------

### Enable 802.1X Verbose Logging

Source: https://openintelwireless.github.io/itlwm/Troubleshooting.html

Enables verbose logging for Wi-Fi and EAPOL, which is useful for debugging 802.1X authentication issues. Remember to reproduce the problem after enabling logging.

```bash
sudo wdutil log +wifi +eapol
```

--------------------------------

### Gather Runtime Logs

Source: https://openintelwireless.github.io/itlwm/Troubleshooting.html

Collects kernel message logs and filters them for itlwm, Airport, IO80211, and EAPOL related entries, saving them to a timestamped file on the Desktop.

```bash
sudo dmesg | grep -E "itlwm|Airport|IO80211|EAPOL" > ~/Desktop/Log_"$(date '+%Y-%m-%d_%H-%M-%S')".log
```

--------------------------------

### Gather Wireless Diagnostics

Source: https://openintelwireless.github.io/itlwm/Troubleshooting.html

Collects a comprehensive wireless diagnostic report, which can be several minutes to complete. The report is saved to /private/var/tmp/.

```bash
sudo wdutil diagnose
```

--------------------------------

### Disable Wi-Fi and EAPOL Logging

Source: https://openintelwireless.github.io/itlwm/Troubleshooting.html

Disables both Wi-Fi and EAPOL logging that may have been enabled for debugging purposes.

```bash
sudo wdutil log -wifi -eapol
```
Tokens:
Raw