nexmon 是什么？

Nexmon 是我们基于 C 语言的固件补丁框架，适用于 Broadcom/Cypress WiFi 芯片， 它使你能够编写自己的固件补丁，例如启用带 radiotap 头的监控模式和帧注入。

下面，你可以看到 nexmon 能够实现的功能概览。本仓库主要专注于在多种芯片上启用监控模式和帧注入。如果你想要更多功能，以下项目可能会让你感兴趣：

• http://nexmon.org/jammer: 一个真正的 Wi-Fi 干扰器，可以用任意干扰信号覆盖正在进行的帧传输。
  • 它使用 Wi-Fi 芯片作为软件定义无线电来生成干扰信号
  • 它允许使用非标准信道，例如 2.4 GHz 频段中的 80 MHz 带宽
  • 它允许设置任意发射功率
  • 它允许修补 D11 内核的实时 MAC 实现
• http://nexmon.org/csi: 适用于多种 Wi-Fi 芯片的信道状态信息提取器
  • 它允许提取 80 MHz 带宽下最高 4x4 MIMO 传输的 CSI
• http://nexmon.org/debugger: 在无 JTAG 访问权限的情况下调试 ARM 微控制器
  • 它允许低层访问调试寄存器以设置断点和观察点，并允许单步执行
• http://nexmon.org/covert_channel: 将信息隐藏在 Wi-Fi 信号中的隐蔽信道
  • 比干扰器更先进的软件定义无线电功能
  • 信道状态信息提取的示例应用
• http://nexmon.org/sdr: 将你的 Wi-Fi 芯片用作软件定义无线电
  • 目前仅在 2.4 和 5 GHz Wi-Fi 频段中支持传输

警告

我们的软件可能会损坏你的硬件，并可能导致你的硬件保修失效！你使用我们的工具需要自担风险和责任！如果你不喜欢这些条款，请不要使用 nexmon！

支持的设备

目前我们的 nexmon 固件补丁支持以下设备。

WiFi 芯片	固件版本	用于	操作系统	M	RT	I	FP	UC	CT
bcm4330	5_90_100_41_sta	Samsung Galaxy S2	Cyanogenmod 13.0	X	X		X	X	O
bcm4335b0	6.30.171.1_sta	Samsung Galaxy S4	LineageOS 14.1	X	X	X		X	O
bcm4339	6_37_34_43	Nexus 5	Android 6 Stock	X	X	X	X	X	O
bcm43430a11	7_45_41_26	Raspberry Pi 3 and Zero W	Raspbian 8	X	X	X	X	X	O
bcm43430a11	7_45_41_46	Raspberry Pi 3 and Zero W	Raspbian Stretch	X	X	X	X	X	O
bcm43439a07	7_95_49 (2271bb6 CY)	Raspberry Pi Pico W	Pico SDK	X	X		X	X
bcm43451b1	7_63_43_0	iPhone 6	iOS 10.1.1 (14B100)				X	X
bcm43455	7_45_77_0_hw	Huawei P9	Android 7 Stock	X	X	X	X	X
bcm43455	7_120_5_1_sta_C0	Galaxy J7 2017	?				X	X
bcm43455	7_45_77_0_hw(8-2017)	Huawei P9	Android 7 Stock	X	X	X	X	X
bcm434555	7_46_77_11_hw	Huawei P9	Android 8 China Stock	X	X	X	X	X
bcm43455	7_45_59_16	Sony Xperia Z5 Compact	LineageOS 14.1	X	X	X	X	X
bcm43455c0	7_45_154	Raspberry Pi B3+/B4	Raspbian Kernel 4.9/14/19	X	X		X	X
bcm43455c0	7_45_189	Raspberry Pi B3+/B4	Raspbian Kernel 4.14/19, 5.4	X	X		X	X
bcm43455c0	7_45_206	Raspberry Pi B3+/B4	Raspberry Pi OS Kernel 5.4	X	X	X	X	X
bcm43455c0	7_45_234 (4ca95bb CY)	Raspberry Pi B3+/B4/5	Raspberry Pi OS				X	X
bcm43436b03	9_88_4_65	Raspberry Pi Zero 2 W	Raspberry Pi OS Kernel 5.10	X	X	X	X	X
bcm4356	7_35_101_5_sta	Nexus 6	Android 7.1.2	X	X		X	X	O
bcm4358	7_112_200_17_sta	Nexus 6P	Android 7 Stock	X	X		X	X	O
bcm4358	7_112_201_3_sta	Nexus 6P	Android 7.1.2 Stock	X	X		X	X	O
bcm43582	7_112_300_14_sta	Nexus 6P	Android 8.0.0 Stock	X	X	X	X	X	O
bcm43596a03	9_75_155_45_sta_c0	Samsung Galaxy S7	Android 7 Stock	X			O	X
bcm43596a03,2	9_96_4_sta_c0	Samsung Galaxy S7	LineageOS 14.1	X	X	X	O	X
bcm4375b13,5,6	18_38_18_sta	Samsung Galaxy S10	Rooted + disabled SELinux	X	X	X	O	X
bcm4375b13,5,6	18_41_8_9_sta	Samsung Galaxy S20	Rooted + disabled SELinux	X	X	X	O	X
bcm4389c15,8,9	20_82_42_sta (r994653)	Samsung Galaxy S22 Plus	Android 14, Rooted with Magisk				X	X
bcm4389c15,8,9	20_101_36_2 (r994653)	Google Pixel 7 and 7 Pro	Rooted with Magisk				X	X
bcm4389c15,8,9	20_101_57 (r1035009)	Google Pixel 7 and 7 Pro	Rooted with Magisk				X	X
bcm4398d05,8,9	24_671_6_9 (r1031525)	Google Pixel 8	Rooted with Magisk				X	X
bcm6715b05	17_10_188_6401 (r808804)	Asus RT-AX86U Pro	Stock firmware 3.0.0.4_388.23565				/	X
qca95004	4-1-0_55	TP-Link Talon AD7200	Custom LEDE Image

¹ bcm43430a1 过去被错误地标记为 bcm43438。

² 使用 LD_PRELOAD=libnexmon.so 而不是 LD_PRELOAD=libfakeioctl.so 来通过 ioctls 注入帧

³ flash 补丁需要为 8 字节长，并按 8 字节边界对齐

⁴ 来自首款 60 GHz Wi-Fi 路由器 Talon AD7200 的 802.11ad Wi-Fi 芯片。使用 nexmon-arc 修补你的固件，并使用我们的自定义 LEDE 镜像 lede-ad7200 运行它

⁵ 已在区域 1 上禁用执行保护（称为 Execute Never），因为它会干扰 nexmon 代码（Section 上的权限错误）

⁶ 要使用 nexutil，你需要停用 SELinux 或将其设置为 permissive

⁷ 有关使用 Pico SDK 与 nexmon 的示例应用，请参阅 pico-nexmon。

⁸ flash 补丁需要为 16 字节长，并按 16 字节边界对齐。

⁹ 使用 Magisk 模块来安装固件、nexutil 并设置 SELinux 策略。

图例

• M = 监控模式
• RT = 带 RadioTap 头的监控模式
• I = 帧注入
• FP = Flash 补丁
• UC = Ucode 压缩
• CT = c't 文章支持（如需持续支持，请使用我们的 ct-artikel 分支）

创建你自己的固件补丁的步骤

使用运行 Linux 的 x86 计算机（例如 Ubuntu 16.04）为 bcm4330、bcm4339 和 bcm4358 构建补丁

• 安装一些依赖项：sudo apt-get install git gawk qpdf adb flex bison
• 仅 x86_64 系统需要，安装 i386 库： ``` sudo dpkg --add-architecture i386 sudo apt-get update sudo apt-get install libc6:i386 libncurses5:i386 libstdc++6:i386

• 克隆我们的仓库：git clone https://github.com/seemoo-lab/nexmon.git
• 在仓库的根目录中：cd nexmon
  • 设置构建环境：source setup_env.sh
  • 编译一些构建工具并从原始固件文件中提取 ucode 和 flashpatches：make
• 进入目标设备的 patches 文件夹（例如 Nexus 5 的 bcm4339）：cd patches/bcm4339/6_37_34_43/nexmon/
  • 编译修补后的固件：make
  • 生成原始固件文件的备份：make backup-firmware
  • 在智能手机上安装修补后的固件：make install-firmware（请确保你的智能手机事先已连接到你的机器）