Itlwm: Basic tutorial for itlwm

[M69W]

远景链接

_仅以 2020-06-18编译的驱动和客户端来说使用教程，后期可能会有所不同，请关注更新！_

驱动 和 客户端

驱动 kext

自行编译 itlwm源码

上面远景链接下 itlwmx_ax200_0618.kext.zip ( 例如 itlwmx 带x的才适用 Intel AX200)

客户端 HeliPort

自行编译 HeliPort源码

下面提供编译好的驱动和客户端(来源: 黑苹果Intel WiFi交流群)

HeliPort.zip（编译日期0618，非最新编译）
itlwmx.kext.zip（编译日期0618，非最新编译）

使用

如果不使用 HeliPort 客户端，
记得要预先在驱动 itlwmx.kext里面的 Info.plist 中改为你的路由器(热点)的 SSID和 password，
操作：【itlwmx.kext->右键->显示包内容】:Contents/Info.plist

_这里顺便提一下，可能会有人执行命令后再修改info.plist会提示权限问题，下面有说到_

根据作者@zxystd在上面的远景链接帖子提供的使用方法，这里暂时使用命令输入启动驱动，如下

如果在使用过程中需要添加 `Wi-Fi`但是又不想重启,可以用以下命令卸载,然后编译好之后再次加载
卸载: sudo kextunload -b com.zxystd.itlwm
加载:
sudo chown -R root:wheel itlwm.kext
sudo kextutil -v 6 itlwm.kext

这里有必要说下驱动的操作和加载的路径，
以 AX200 用 itlwmx.kext 为例
例如驱动 itlwmx.kext ->放桌面，
找到并打开终端输入 sudo chown -R root:wheel
再把 itlwmx.kext在拖入终端，对，拖入终端里面
最后显示就是 sudo chown -R root:wheel /Users/abc/Desktop/itlwmx.kext
而不是 sudo chown -R root:wheel itlwm.kext

一般来说，
如果不放入OC 或 Clover 开机加载驱动，
而是使用命令加载驱动，
只需要执行两行命令

sudo chown -R root:wheel itlwmx.kext
sudo kextutil -v 6 itlwmx.kext

执行上面👆命令后，
打开 【 启动台->系统偏好设置->网络->左下角->【+ 】-> 选【以太网】->应用

然后打开客户端 HeliPort，
第一次没有显示Wi-Fi列表，可尝试多次点击Wi-Fi图标
目前(当前时间为0618-2020)客户端HeliPort 支持Wi-Fi 支持输入Wi-Fi密码，其他功能没测试！
后期客户端功能有所不同，请继续关注。

注意

1. 怎么看是否已连接Wi-Fi？
   打开 HeliPort,【打开网络偏好设置->网络->显示已连接(绿色标志)】

2. 如果没有【以太网】选项:
   以小新pro13 EFI OC 为例
   注释或删除两项：(猜测跟 ASPM 有关，详情看这里 PCI设备ASPM，需要验证）

DeviceProperties\Add\PciRoot(0x0)/Pci(0x1C,0x0)
DeviceProperties\Add\PciRoot(0x0)/PciRoot(0x0)/Pci(0x1C,0x0)/Pci(0x0,0x0)

08-24-2020更： 在Big Sur中不禁用ASPM 注入也能正常使用AX200/AX201

1. 关闭 HeliPort客户端 ：
   感谢@williambj1 提供的方法：

HeliPort 按住 ALT 有退出选项
终端执行 sudo killall HeliPort 也行

或 使用最繁琐的方法(估计没有谁会这样操作)
打开 【 启动台->其他->活动监视器->找到【 HeliPort】双击 【退出】

4.睡眠后Wi-Fi 连接：
睡眠后理论上它自己会自动连接，
但如果断网的话：
使用HeliPort客户端 ：1.先关闭Wi-Fi；2.再打开Wi-Fi；如果预先写好Wi-Fi和password，会自动连接。

优化使用

把 itlwmx.kext放入 OC 或 Clover 下，开机加载驱动，不需要命令启动；
如果在 Info.plist 编辑好使用的Wi-Fi 的SSID和 password，不需要客户端 HeliPort也能使用 Wi-Fi。

不要问：接力，隔空传送 这些问题

以上：仅以 2020-06-18编译的驱动和客户端来说使用教程，后期可能会有所不同，请关注更新！

最后感谢 对 Intel 网卡 能够在 macOS 使用作出贡献的所有大佬们，再次特别感谢 @zxystd

[zncs520]

AX201 现在还不行吗?

[williambj1]

HeliPort 按住 ALT 有退出选项
终端执行 sudo killall HeliPort 也行

[M69W]

HeliPort 按住 ALT 有退出选项
终端执行 sudo killall HeliPort 也行

多谢提醒

[lacostey86]

thanks its working fine with ax200 10.15.5 os , but there is one tiny issue if you are already connected to a ssid there is no way to find which ssid i'm using

[williambj1]

thanks its working fine with ax200 10.15.5 os , but there is one tiny issue if you are already connected to a ssid there is no way to find which ssid i'm using

This is not an issue, but a feature that hasn't been implemented

[evertjr]

Can you upload the itlwm.kext too?

[lawman21c]

有个问题，在mac使用了ax200之后，windows10里用不了wifi了。

[lacostey86]

thanks its working fine with ax200 10.15.5 os , but there is one tiny issue if you are already connected to a ssid there is no way to find which ssid i'm using

This is not an issue, but a feature that hasn't been implemented

ok thanks for the clarification , good job , hope this is the first step for handoff and airdrop

[naveenkrdy]

great work !
AX200 works fine on macos 10.15.5
@lawman21c works fine for me on windows even with this kext.

[allanwhledu]

请问一下，在macOS 10.14上AC9560可以用了吗？我试了下还是不行呢，在网络中一直没有以太网的选项可以添加，是否不支持10.14系统了？

启动日志也只有：
2020-06-24 05:14:56.361506+0800 0x484 Default 0x0 0 0 kernel: (kernel) itlwm: free
2020-06-24 05:14:56.362479+0800 0x482 Default 0x0 0 0 kernel: (kernel) itlwm: free
2020-06-24 05:14:56.366004+0800 0x47e Default 0x0 0 0 kernel: (kernel) itlwm: free

[zxystd]

支持10.14，你先尝试彻底断电，然后再开启电脑

[allanwhledu]

支持10.14，你先尝试彻底断电，然后再开启电脑

嗯嗯，可以了。其实是因为AC9560有2代的有1代的是吧，我以为都是2代的呢……从itlwmx换回itlwm就没问题了，感谢大佬！！

[andiest13]

谢谢，可以使用ax200上网了，但是那个网速好像限制了30Mbps左右（转win是可以跑满wifi6的）。

[M69W]

谢谢，可以使用ax200上网了，但是那个网速好像限制了30Mbps左右（转win是可以跑满wifi6的）。

先解决能不能用的问题，
再解决好不好用的问题。

继续关注吧

[jxp98]

同AX200，失败了...一直不显示wifi 直接在kext里该wifi密码也找不到wifi 连不上。大佬，还有得救吗

[lawman21c]

有个问题，在mac使用了ax200之后，windows10里用不了wifi了。

这个问题应该是windows10的，而不是这个驱动的问题。尝试重装系统看看。

[leoli-dev]

大佬们，AX201 有希望吗？我板载那块是 AX201NGW，这个方法不行吧？

[M69W]

大佬们，AX201 有希望吗？我板载那块是 AX201NGW，这个方法不行吧？

ax201不能加载 #129

[8x13b]

Roses are red,
Violets are blue,
The title is in english,
So why is the issue in chinese?

[williambj1]

I’m working on docs right now, but unfortunately this guide with google translate is currently the best you can get.

[scutxd]

支持10.14，你先尝试彻底断电，然后再开启电脑

嗯嗯，可以了。其实是因为AC9560有2代的有1代的是吧，我以为都是2代的呢……从itlwmx换回itlwm就没问题了，感谢大佬！！

你好，9560还分1代和2代吗？如何区分呢？

[mbirth]

Short form:

1. Get Xcode
2. Clone itlwm (from inside Xcode or manually, then open in Xcode)
3. cd into cloned dir and run: PROJECT_DIR=. ./fw_gen.sh
4. Back in Xcode, modify the itlwm/Info.plist to match your SSID(s) and password
5. Build/Compile
6. Find the itlwm.kext in ~/Library/Developer/Xcode/DerivedData/itlwm-...../Build/Products/Debug/
7. Use the Terminal to cd to that dir and try to load the extension to see if it works: sudo kextload itlwm.kext
   
   
   
   • probably need to disable SIP if you haven't already
   
   

8. If it loads fine and your system doesn't crash, you could move it to /System/Library/Extensions/ to have it autoloaded on boot

   • Catalina+ users will have to remount the system partition for writing first: sudo mount -uw /
   • Or move it onto your EFI partition and have OC load it

   Installing this kext in L/E or S/L/E is never recommended

(If you have Intel cc (WL 22500) or Qu (AX201, AC9462rev2) or QuZ (AC9462rev1, AX1650S) card, use itlwmx instead. For AX22000 support, you also need the firmware file iwlwifi-QuQnj-b0-hr-b0-48.ucode.)

For HeliPort:

1. Clone repo
2. Have CocoaPods installed (sudo gem install cocoapods followed by pod setup)
3. cd into cloned dir and install additional cocoa stuff: pod install
4. Build/Compile the Release version
5. Find HeliPort in ~/Library/Developer/Xcode/DerivedData/HeliPort-...../Build/Products/Release/
6. Move it to Applications (Very important)
7. Press the Option key on your keyboard while opening HeliPort's menu
8. Set it as a Login Item

For new versions: Do a git pull (or from Xcode menu), then clean build dir(!) before attempting a new build. You may also want to run pod install once in a while so updated pods can be pulled in.

Also, there's https://github.com/1hbb/OpenIntelWireless-Factory/releases now. (Unofficial CI Builds are not supported.)

But: PLEASE DON'T MAKE NEW ISSUES HERE IF YOU DON'T KNOW HOW TO DEBUG PROPERLY! This is still in development and not yet ready for the general public. If something doesn't work out for you, see if there already is an issue about that (also search the closed issues) and maybe add a comment there, or ask on Reddit. Or wait for the next build and see if that fixes your problem.

[williambj1]

@mbirth Huge thanks for your guide, I would like to slightly modify your comment and correct some errors, is that ok?

[mbirth]

@williambj1 Sure, go ahead.

[williambj1]

Here's a more detailed guide for How to build HeliPort

https://openintelwireless.gitbook.io/openintelwireless/heliport/advanced

[yoqu]

Roses are red,
Violets are blue,
The title is in english,
So why is the issue in chinese?

Haha...

[LeoLittleZhun]

HeliPort好像有点问题啊。对于不需要密码的wifi也要强制你输入密码。所以没有密码的WiFi就连不上

[williambj1]

@LeoLittleZhun 请按照 issue 模板打开一个新的 issue

[M69W]

08-24-2020更 ：
小新pro13 在Big Sur中使用AX201不禁用 ASPM 注入也能正常使用了。
当然为了省电，AX201也可以改为以下CNVW路径，并设置对应的ASPM工作模式

DeviceProperties\Add\PciRoot(0x0)/Pci(0x14,0x3)
DeviceProperties\Add\PciRoot(0x0)/PciRoot(0x0)/Pci(0x14,0x3)/Pci(0x0,0x0)

[LingyeHan]

这试了wif可以正常使用，就是bluetooth不显示，不知道怎么解决？