Unknownx007/RFjackX
GitHub: Unknownx007/RFjackX
RFjackX 是一款基于 Linux 终端的开源音频 SDR 收发套件，通过笔记本声卡和自制 AUX 电路实现 433MHz 静态无线信号的捕获与重放。
Stars: 0 | Forks: 0
# 🎛️ RFjackX
`RFjackX` 是一款 100% 免费、开源、基于终端的 sub-GHz 无线电收发器和音频 SDR 套件，专为 **Linux 操作系统** 严格打造。通过利用标准的笔记本电脑声卡基础设施，它能通过麦克风输入插孔自动被动捕获环境无线电频率，并执行音频调制上变频，利用低成本的通用硬件组件通过耳机插座将信号重新传输出去。
由 **Unknownx007** 开发。
## ⚙️ 工作原理
1. **声学 sub-SDR 捕获：** 读取来自定制 AUX 天线电路的模拟电压，剥离噪声阈值，并将数据写入结构化的 16 位 PCM `.wav` 音轨文件中。
2. **终端可视化核心：** 从传入的数据块中动态计算均方根 (RMS) 振幅参数，在控制台界面内渲染动画音频可视化波形。
3. **音频调制上变频：** 生成与存储的二进制脉冲串相匹配的高频方波音调，从耳机输出插座传输电压尖峰。
4. **硬件倍增：** 传入的音频电压触发附加发射器模块的数据引脚，将信号转换为物理的 sub-GHz 无线电波。
## ⚠️ 工作区操作警告
该工具利用音频调制上变频协议。它原生适用于 **静态 RF 系统**（旧式车库门、无线门铃、吊扇和传统遥控触发器）。
它**不会**绕过现代滚动代码矩阵（**KeeLoq**），例如现代车辆所使用的系统，这些系统每次点击都会自动使代码过期。这一局限性使其成为学习静态和动态无线安全配置之间差异的绝佳教育资源。
## 🛠️ DIY 硬件蓝图：构建 AUX 天线电路
为了弥合您的笔记本电脑声卡与 sub-GHz 频率之间的差距，您可以使用一副旧耳机或辅助 (AUX) 音频线，完全免费地构建两个独立的接收器和发射器电路。
### 📋 所需组件
* **1x 笔记本电脑**，配备 3.5mm 耳机插孔和 3.5mm 麦克风插孔（或组合式 TRRS 音频分线适配器）。
* **2x 旧/损坏的 AUX 音频线**（或标准的有线耳机线）。
* **1x FS1000A 433MHz 发射器模块**（带有 **3 个引脚** 的方形板）。
* **1x 433MHz 接收器模块**（带有 **4 个引脚** 的长矩形板）。
### 📡 电路 1：嗅探器 / 接收器设置（麦克风端口）
该电路捕获环境的 433MHz 电泄漏，并将其直接输入到笔记本电脑声卡的录音通道中。
```
[ Old AUX Cable ] [ 433MHz Receiver Board (Long Board) ]
+-------------------+ +--------------------------------------+
| Copper Wire 1 | -----------> | DATA Pin (Either of the two centers) |
| (Microphone Core) | | |
| Copper Wire 2 | -----------> | GND Pin |
| (Ground Shield) | +--------------------------------------+
+-------------------+
```
#### 逐步构建说明：
1. 将您的第一根 AUX 音频线切成两半，露出内部的芯线。
2. 剥去塑料绝缘层，露出 **麦克风信号线** 和 **地屏蔽线** 的裸铜绞线。
3. 将 **麦克风信号铜线** 直接缠绕或扭接到您的 4 针接收器模块中间的两个 **`DATA` 引脚** 中的任意一个上。
4. 将 **地屏蔽铜线** 直接缠绕或扭接到您的接收器模块的 **`GND` 引脚** 上。
5. 将 3.5mm 插孔连接器直接插入您笔记本电脑的 **麦克风输入端口**。
### 💥 电路 2：重放 / 发射器设置（耳机端口）
该电路从您的笔记本电脑扬声器线路捕获高频音频电压尖峰，并触发无线电发射芯片。
```
[ Old AUX Cable ] [ FS1000A Transmitter Board (Square) ]
+-------------------+ +--------------------------------------+
| Copper Wire 1 | -----------> | DATA Pin |
| (Left/Right Core) | | |
| Copper Wire 2 | -----------> | VCC Pin |
| (Ground Shield) | | |
| | ------+----> | GND Pin |
| | | +--------------------------------------+
| [External 5V]* | ------+ *(Optional External Power Supply)
+-------------------+
```
#### 逐步构建说明：
1. 将您的第二根 AUX 音频线切成两半，并剥开芯线以露出裸铜线。
2. 分离出 **音频信号线（左或右扬声器芯线）** 和 **地屏蔽线**。
3. 将 **音频信号铜线** 直接缠绕或扭接到您的 3 针 FS1000A 发射器模块的 **`DATA` 引脚** 上。
4. 将 **地屏蔽铜线** 直接缠绕或扭接到您的发射器模块的 **`GND` 引脚** 上。
5. *注意：要为发射器的 `VCC` 引脚供电，您可以将其直接跳线连接到插入笔记本电脑的旧 USB 电缆的 5V 引脚上，或者连接一个 3V-5V 的小型电池。*
6. 将 3.5mm 插孔连接器直接插入您笔记本电脑的 **耳机输出端口**。
## 📸 电路图
以下是该电路的外观示意图：
## 📦 工作区安装指南
```
# 1. Clone 这个 competitive suite repository
git clone https://github.com/Unknownx007/RFjackX
cd RFjackX
# 2. 配置并隔离 python virtual environment
python3 -m venv .venv
source .venv/bin/activate
# 3. 安全地 Pull 所需的 microservice modules
pip install -r requirements.txt
# 4. 初始化 command-line control panel
python3 rfjackx.py
```
## 🚀 使用指南
1. 运行该工具。主选择菜单将立即显示。
2. 选择 **选项 1（嗅探器模式）**。如果您尚未构建好电路，请选择 **选项 2（内部模拟器模式）** 来测试代码。
3. 观察屏幕上实时动画显示的彩色 ASCII 声波。按下 **`Ctrl + C`** 停止并保存 `.wav` 文件。
4. 返回主菜单并选择 **选项 2（发射模式）**。按下 `Enter` 键加载已保存的音轨，从您的耳机插孔将原始的电压音频脉冲流传输出去，并逐行重新绘制可视化波形！
## 📜 许可证
在 MIT 许可证下分发。有关更多详细信息，请参阅 `LICENSE`。
## 📦 工作区安装指南
```
# 1. Clone 这个 competitive suite repository
git clone https://github.com/Unknownx007/RFjackX
cd RFjackX
# 2. 配置并隔离 python virtual environment
python3 -m venv .venv
source .venv/bin/activate
# 3. 安全地 Pull 所需的 microservice modules
pip install -r requirements.txt
# 4. 初始化 command-line control panel
python3 rfjackx.py
```
## 🚀 使用指南
1. 运行该工具。主选择菜单将立即显示。
2. 选择 **选项 1（嗅探器模式）**。如果您尚未构建好电路，请选择 **选项 2（内部模拟器模式）** 来测试代码。
3. 观察屏幕上实时动画显示的彩色 ASCII 声波。按下 **`Ctrl + C`** 停止并保存 `.wav` 文件。
4. 返回主菜单并选择 **选项 2（发射模式）**。按下 `Enter` 键加载已保存的音轨，从您的耳机插孔将原始的电压音频脉冲流传输出去，并逐行重新绘制可视化波形！
## 📜 许可证
在 MIT 许可证下分发。有关更多详细信息，请参阅 `LICENSE`。标签：Python, 无后门, 无线电收发, 物理安全研究, 硬件控制, 终端可视化, 软件无线电, 逆向工具, 音频处理