# Frequently Asked Questions

# Installation

# What's the difference between Alpha Prerelease and Latest Release

  • Alpha Prerelease

A testing version automatically compiled by GitHub actions based on the latest source code on the master branch.

Note that Alpha Prerelease Kexts are never tested; we do not guarantee their availability, usability, and stability.

NOT recommended for daily use

  • Latest Stable Release

An official stable version. This version is usually released after new features are implemented and tested.

Recommended for daily use

# Which Kext Should I Use

Read the Installation guide for more information

# Is My Card Supported

Read the Compatibility table for more information

# Usage

# Limitation of AirportItlwm.kext

  • Handoff and Universal Clipboard are the only supported Continuity features (opens new window).
  • Instant Hotspot from iPhone can be recognized but may likely fail to connect.
    • Workaround: use itlwm.kext with HeliPort.
  • Apple Bluetooth peripherals may fail to connect.
    • Workaround: use itlwm.kext with HeliPort or disable iCloud.
  • Unable to connect to Hidden Networks.

# How to connect to my Wi-Fi with itlwm.kext

  • By HeliPort (Recommended)
  • Fill in the essential information in Info.plist, located inside itlwm.kext

# How to disconnect my Wi-Fi with itlwm.kext

Use HeliPort's Options Menu (press the Option key while opening).

# HeliPort shows itlwm not loaded

Visit our Troubleshooting guide for more info

# Nothing appears in System Preferences

Visit our Troubleshooting guide for more info

# How can I change the country code from ZZ to a specific country

Adapters that don't report country codes (iwn, 7000 & 8000 series) can use itlwm_cc=COUNTRY_CODE (opens new window) to specify a desired one.

# Dual-Boot with Windows

Read this explanation (opens new window) from Linux for more info.

# About Platform Noise

Read this explanation (opens new window) from Linux for more info.

# Can I use Bluetooth with Wi-Fi

2.4 GHz Yes, but it is known to cause performance issues.

5 GHz Yes.

Read this explanation (opens new window) from Linux for more info.

# Performance SUCKS

Using the latest stable version (v1.3.0) connected to 5 GHz (40 MHz), the expected maximum speed is 240 Mbps for download and 180 Mbps for upload.

Tested with 9560ac & ax201 using iperf3

Devices with single antennas are expected to have much worse results


It is already ideal for daily usage. Including watching 4K Netflix and YouTube

If you are not satisfied with its performance, consider using Ethernet or Bcrm Cards.

# Why does my adaptor turn back on after a sleep-wake cycle

By default, when the system boots, itlwm starts to initialize the Wi-Fi card and starts connecting to the Internet. This process can all be done before the system boots into user space and launches HeliPort. So, even if HeliPort has stored a property that indicates whether the card should be on/off by default and immediately adjusts itlwm's behavior, your card has been turned on anyway before then.

Currently, there is no way to make itlwm not power on the card by default on boot. If it's designed to be off by default and requires HeliPort to power it on, users may have to wait longer until the card is ready and it's not friendly for users that don't use HeliPort but rely on itlwm's Plist.

# Features

# Is it a replacement of natively supported Broadcom Cards

No

# Is it a replacement of USB Wi-Fi Dongles

Yes, 100%

# Why does my adapter shows up as Ethernet in System Preferences instead of Wi-Fi

itlwm.kext uses Apple's public IOEthernetController instead of the private IO80211Family.

Spoofing into Ethernet does not affect performance.

AirportItlwm enables the native Wi-Fi selection menu with limited continuity features.

# Does it support connecting to Hidden Wi-Fi networks

MVM Gen 2 (iwx) cards do not support connecting to Hidden Wi-Fi networks.

iwm and iwn devices:

  • itlwm.kext: Yes
  • AirportItlwm.kext: No

# Does it support WPA2/3-Enterprise or 802.1X

  • itlwm.kext: No
  • AirportItlwm.kext: Yes

Credit: usr-sse2 (opens new window)

# Does it support Location Services

Supported on AirportItlwm.kext

itlwm.kext reports the Wi-Fi card as an Ethernet NIC to macOS, rather than Wi-Fi. This means that Find My does not work, since it relies on Wi-Fi data (like what networks are around you). This likely means that other location services don't work as well.

-- 1Revenger1 (opens new window)

# Does it support Apple's Continuity Framework (Airdrop, HandOff)

Only Handoff and Universal Clipboard works with AirportItlwm, other features are not supported.

# Can I use it to create a Personal Hotspot

No

# Can I monitor Upload and Download speed

Yes, this feature was added since v1.2.0

# Does it support 40/80/160 MHz

HT40 (40 MHz) support was added since v1.3.0

VHT80 & VHT160 support was implemented since v2.0.0

# Does it support 802.11AC and 802.11AX

Yes, 802.11AC and 802.11AX support was implemented since v2.0.0

# Design

# Why not port code directly from Linux but OpenBSD

The amount of code from Linux is enormous. It will likely take forever to finish such a project with our current manpower.