Eric-AirportItlwm
ru

Открытый код · GPL-2.0 · x86_64

Нативный Wi-Fi macOS для карт Intel, от 802.11n до Wi-Fi 7

macOS Tahoe 26 и Sequoia 15 · WPA3 · 6 ГГц · 802.11be · BE200 / BE201 и все карты, которые поддерживает itlwm

AirportItlwm, доведённый от Wi-Fi 6 до Wi-Fi 7 (BE200, BE201); AirDrop и Instant Hotspot в разработке. Все ранее поддерживаемые карты продолжают работать на штатном Wi-Fi macOS, без HeliPort и без Wi-Fi-патчей OpenCore Legacy Patcher.

Скачать в ReleasesОткрыть на GitHubIssues

Основано на itlwm и laobamac/itlwm. См. происхождение и благодарности.

Если драйвер вам помог, поставьте ⭐ на GitHub: так его найдут другие владельцы карт Intel.

Eric-AirportItlwm
скорость соединения
2882 Mbit/s
передача
2.55 Gbit/s
приём
1.84 Gbit/s
на реальном железе
320 ГГц

Измерено на BE200: macOS 26, 6 ГГц, 320 МГц, два потока. Указаны скорость соединения и скорость на интерфейсе. 5 ГГц HE, 160 МГц. Сон: после сна любой длительности соединение восстанавливается сразу (отчёты тестеров).

  • macOS 26 Tahoe
  • macOS 15.2+ Sequoia
  • x86_64
  • GPL-2.0

Происхождение и благодарности

Этот проект существует только благодаря чужому исходному коду. Он сохраняет всё из itlwm и AirportItlwm и дополняет это, а не заменяет. Спасибо всем, кто назван ниже.

  1. itlwmzxystd / OpenIntelWireless
  2. laobamac/itlwmНативный беспроводной интерфейс Apple для Tahoe/Sequoia
  3. Eric-AirportItlwmЭтот репозиторий

itlwm от zxystd / OpenIntelWireless → laobamac/itlwm (нативный беспроводной интерфейс Apple для Tahoe/Sequoia) → этот репозиторий: сохраняет всё перечисленное и добавляет транспорт Wi-Fi 7 и путь прошивки MLD, WPA3 SAE/H2E и OWE, 6 ГГц, 320 МГц и multi-link, реализуя команду за командой по Linux iwlwifi (mld, mvm) и mac80211.

Благодарности

  • zxystd и OpenIntelWireless: itlwm и AirportItlwm
  • laobamac: нативный интерфейс IO80211 / Skywalk / WCL для Tahoe и Sequoia, а также рецензирование и наставничество
  • OpenBSD, Stefan Sperling и участники: net80211, iwn, iwm, iwx и реализация SAE
  • BearSSL, Thomas Pornin: арифметика P-256 для SAE
  • Linux iwlwifi и mac80211: эталонное поведение для каждой команды прошивки
  • hostap / wpa_supplicant: эталон для SAE, RSNXE и поведения рукопожатия
  • retropineaple/ForbiddenItlwm: AWDL на картах Intel; AX-слушатель и проверка таблицы AWDL следуют этому проекту
  • crazyhulk: предварительная работа над интерфейсом AWDL и BLE-патчи для BlueToolFixup
  • seemoo-lab/owl: открытая реализация AWDL, использованная как справочник по протоколу
  • Acidanthera: MacKernelSDK, Lilu, BrcmPatchRAM / BlueToolFixup
  • Mieze — за советы по пути приёма в macOS
  • Проекты, которые упоминает itlwm: Black80211-Catalina, black80211, Voodoo80211, usr-sse2 и другие
  • Intel — за прошивку, распространяемую по лицензии на прошивки Intel
  • Все, кто предоставил роутеры, оборудование и журналы

Возможности

ФункцияКартыСостояние
Поиск сетей, подключение, роуминг, частный адрес Wi-Fiвсе Работает
WPA2 Personal, WPA2 Enterprise (PEAP), переходные сети WPA2/WPA3все Работает
WPA3 Personal (SAE, H2E), Enhanced Open (OWE)все Работает на BE200
802.11ac (VHT), 160 МГцAC и новее Работает
802.11ax (HE)AX и BE Работает
6 ГГцAX210/AX211/AX411, BE Работает на BE200
802.11be (EHT), 320 МГц, multi-link (eMLSR)BE Работает 320 МГц на реальном железе; роутер с multi-link подключается; объединение линков пока экспериментальное
Сон и пробуждение, восстановление после ошибок прошивкивсе Работает
AirDrop / AWDLiwn (PAN), iwm, AX, BE В разработке см. Continuity
Instant Hotspot (iPhone в меню Wi-Fi)все В разработке

Поддерживаемые карты

ПоколениеКартыPCI-идентификаторы (8086:xxxx)HAL / прошивка
Wi-Fi 7BE200, BE202, Killer BE1750 x/w272Biwx, MLD API 92 (86)
Wi-Fi 7BE201, Killer BE1750 i/sA840 7740 4D40iwx, MLD API 92
Wi-Fi 6EAX210, AX211, AX4112725 2726 7A70 7AF0 51F0 51F1 54F0 7F70 2729 7E40iwx, API 68
Wi-Fi 6AX200, AX201, AX16502723 2720 02F0 06F0 34F0 3DF0 4DF0 43F0 A0F0iwx, API 68
Wi-Fi 59260, 9461, 9462, 9560, 8265, 8260, 7265, 7260, 3168, 3165, 3160см. Info.plistiwm
Wi-Fi 46xxx, 5xxx, 4965, 2200, 2230, 1000, 1030, 100, 105, 130, 135см. Info.plistiwn

Прошивка каждой карты встроена в кекст. Для семейства BE прошивку выбирает ревизия оборудования, и сначала пробуется самая высокая из адаптированных версий API. Пока не поддерживается: поколение «SC» Wi-Fi 7 (BE211/BE213, 6E70 D240 D340 E340 E440 9327), которому нужна прошивка, не входящая в этот проект.

Установка

  1. Скачайте в Releases пакет для вашей macOS: macOS26-Tahoe для macOS 26, macOS15-Sequoia для macOS 15.2 и новее. Release — для повседневной работы; Debug сохраняет диагностические журналы, нужные для отчёта.
  2. Положите кекст в EFI/OC/Kexts/ и добавьте его в Kernel → Add. Оставьте только один кекст Wi-Fi от Intel. Если одна конфигурация загружает обе системы, ограничьте кекст для Tahoe версиями Darwin 25.0.0–25.99.99, а для Sequoia — 24.2.0–24.99.99.
  3. Не сочетайте его с root-патчами «Modern Wireless» из OpenCore Legacy Patcher и любой заменой IO80211 / Skywalk: этот драйвер использует собственный стек Wi-Fi системы.
  4. Сохраните загрузочную копию своего EFI и сначала проверьте всё с USB-накопителя.

Страна и разрешённые в ней каналы определяются по окружающим сетям с помощью собственной логики регулирования карты, как в Linux. Ничего настраивать не нужно.

Аргументы загрузки

АргументДействие
-itlawdlЭкспериментальный AirDrop, см. ниже. Не добавляйте без необходимости тестирования
itlwm_he=0Отключить HE/EHT (802.11ax/be). По умолчанию включено

Continuity

В разработке

Instant Hotspot

Пробуждение точки доступа iPhone по Bluetooth, направленное сканирование и ассоциация WPA3 работают; сейчас iPhone разрывает связь сразу после четырёхстороннего рукопожатия. Это открытая ошибка, и исправление будет действовать для всех карт.

AirDrop (AWDL)

awdl0 создаётся, и им управляет собственный стек AWDL macOS. Для AirDrop карта должна слушать канал AWDL, оставаясь в вашей сети. У всех карт Intel, кроме AX411, один радиомодуль (eMLSR в Wi-Fi 7 — тоже один радиомодуль), поэтому прошивка делит время между ними:

  • Карты AX (прошивка без MLD): постоянный слушатель с собственным контекстом канала — та же конструкция, которую ForbiddenItlwm запускает на AX211, с AirDrop в обе стороны.
  • Карты BE (прошивка MLD): та же идея на наборе команд MLD — линк P2P-клиента рядом с линком станции (сочетание, которое Linux допускает на двух каналах). Правила активации прошивки выясняются по её собственному коду; пока не работает.
  • Карты iwm (серии 7000, 8000 и 9000): постоянный приём запускается после подключения к Wi-Fi. Новые модели ещё предстоит проверить на реальном оборудовании.
  • Карты iwn с PAN и P2P (сначала 6205 и 6235): подключитесь к Wi-Fi на канале 6 и загрузитесь с -itlawdl. Работу AirDrop на этом канале ещё предстоит проверить на реальном оборудовании.

Для обнаружения AirDrop нужны реклама и сканирование Bluetooth LE. Патчи Intel BLE загружаются отдельно из Eric-BlueToolFixup Releases. Тестовые пакеты содержат оба kext. С -itlawdl драйвер сначала проверяет, что таблица интерфейса AWDL от Apple имеет ту раскладку, под которую он собран (AWDLBuildCheck в I/O Registry), и иначе работает как обычный Wi-Fi, так что обновление macOS не приведёт к kernel panic. Канал прослушивания — 149, затем 44, затем 6, причём только тот, на котором страна разрешает передачу (44 там, где нет 149; пассивный канал — после того как рядом услышан роутер, передающий на нём маяки). Быстрее всего 149: роутеры на 149 и iPhone на 149 или без Wi-Fi дают лучшую скорость AirDrop.

Сообщить о проблеме

Перед воспроизведением запустите Collect-EricWirelessDiagnostics.command из пакета Debug. Выберите Wi-Fi, AirDrop / Instant Hotspot или обнаружение Bluetooth. Укажите адаптер, второе устройство и результат в issue на GitHub. ZIP с сетевыми данными отправьте приватно.

Создать issue

Сборка

git clone https://github.com/acidanthera/MacKernelSDK.git MacKernelSDK
git -C MacKernelSDK checkout 3f750085caa17ec3a7880f11c11bf4f48cd6a164
python3 scripts/prepare_tahoe_sdk.py
xcodebuild -project itlwm.xcodeproj -scheme AirportItlwm-Tahoe   -configuration Release ARCHS=x86_64 CODE_SIGNING_ALLOWED=NO build
xcodebuild -project itlwm.xcodeproj -scheme AirportItlwm-Sequoia -configuration Release ARCHS=x86_64 CODE_SIGNING_ALLOWED=NO build

Заметки о реализации Wi-Fi 7, состояние оборудования по этапам и ссылки на Linux — в BE200.md (на английском).

Лицензия

GPL-2.0, унаследована от itlwm. Прошивка Intel распространяется по собственной лицензии: см. лицензию на прошивки Intel. Полный текст: LICENSE.