PortaRF：从硬件到固件的开源一体化 SDR 解决方案

将 HackRF 的射频模块与 PortaPack 的控制电路集成在同一块 PCB 上，搭配 3.2 英寸 TFT 彩色显示屏，实现了更低的信号损耗和更紧凑的便携设计

PortaRF：从硬件到固件的开源一体化 SDR 解决方案封面
oshw_hqzl2026-06-10 18:24:03GPL-3.0
191
Star

PCBA

设计文件

KiCad图标hackrf-one.zip2.08MB（5次下载）

其他附件

EDA查看器

复制嵌入代码

详细介绍

一、项目概述

PortaRF 是由 OpenSourceSDRLab 主导的开源一体化软件定义无线电（SDR）硬件与固件项目，核心目标是解决传统 HackRF+PortaPack 分体方案的连接损耗、便携性差、功能局限等痛点，为无线电爱好者、工程师与研究人员提供一套集成度高、性能优化、功能丰富的便携无线电实验平台。

项目包含两大核心部分：

  • 定制硬件 PortaRF：将 HackRF 射频前端与 PortaPack 控制单元集成于单块 PCB，搭配专用显示屏与外设，实现一体化设计；

  • 适配固件（基于 PortaPack Mayhem）：在社区主流的 Mayhem 固件基础上，针对 PortaRF 硬件特性进行深度优化与功能适配，最大化发挥硬件性能。

二、项目背景与开发动机

1. 传统方案的痛点

  • 分体式设计缺陷：HackRF 与 PortaPack 通过排线连接，易产生信号损耗、接触不良，且整体体积大、便携性差；

  • 固件适配问题：通用 Mayhem 固件对不同硬件型号的兼容性参差不齐，部分老旧设备或第三方克隆设备无法获得完整功能支持；

  • 用户门槛较高：新手用户面临硬件选型、固件刷写、兼容性调试等多重障碍，缺乏一站式解决方案。

2. PortaRF 的开发目标

  • 打造一体化硬件，消除连接损耗，提升信号稳定性与便携性；

  • 提供与硬件深度适配的专用固件，简化用户操作流程；

  • 开放硬件与固件代码，鼓励社区参与迭代，推动开源无线电生态发展。

三、核心硬件 PortaRF 详解

1. 硬件设计与配置

项目

参数说明

核心架构

集成 HackRF 射频前端 + PortaPack 控制单元，单 PCB 一体化设计

显示屏

3.2 英寸 TFT 彩色屏幕，分辨率 240×320

射频性能

保留 HackRF One 核心指标，频率覆盖 1MHz~6GHz，支持接收 / 发射模式

外设接口

集成按键、旋钮、SD 卡插槽、天线接口，无需额外接线即可独立工作

供电方式

内置电池供电，支持 USB 充电，满足户外便携使用需求

2. 硬件优势

  • 低信号损耗：一体化设计消除了分体方案的排线连接损耗，提升信号接收灵敏度与发射稳定性；

  • 极致便携：整机尺寸紧凑，可直接手持或放入口袋，适合户外场测、移动实验；

  • 专用优化：针对 Mayhem 固件的功能需求优化硬件电路，确保所有固件功能可稳定运行。

四、核心固件：适配 PortaRF 的 PortaPack Mayhem

1. 固件基础与迭代背景

PortaPack Mayhem 是目前 HackRF/PortaPack 生态中最主流的第三方固件之一，它基于 Havoc 固件二次开发，而 Havoc 固件本身又是 PortaPack 官方固件的衍生版本，在长期迭代中积累了大量社区贡献的功能与修复。PortaRF 项目在此基础上，针对自身硬件进行了专属适配与优化。

2. 核心功能与特性

（1）基础无线电功能

  • 频谱分析：实时频谱瀑布图显示，支持频率范围自定义、信号强度标注、峰值锁定；

  • 信号接收：支持 AM/FM/SSB 等多种调制方式解调，覆盖对讲机、广播、遥控设备等常见信号；

  • 信号发射：支持自定义信号生成、音频发射、简易信标发射，满足实验与调试需求（需遵守当地无线电法规）；

  • 协议解码：支持常见数字协议解码，如 OOK/FSK 遥控信号、气象数据、ADS-B 航空信号等。

（2）进阶扩展功能

  • GPS 模拟：可模拟 GPS 信号，用于导航设备调试与测试；

  • 多模式扫描：预设常用频段扫描列表，支持自定义扫描规则，快速定位信号源；

  • 低功耗优化：针对 PortaRF 硬件优化电源管理，延长电池续航；

  • 硬件专属适配：优化屏幕显示逻辑、按键映射，确保 3.2 英寸屏幕下的操作体验流畅。

（3）迭代与维护

  • 持续修复社区反馈的 bug，提升固件稳定性；

  • 定期新增功能模块，根据用户需求优化现有功能；

  • 提供稳定版与开发版（Nightly）双版本，满足不同用户需求：稳定版适合日常使用，开发版包含最新功能但稳定性需用户自行验证。

五、项目价值与应用场景

1. 目标用户群体

  • 无线电爱好者：用于信号探索、频谱分析、协议解码等业余无线电活动；

  • 工程师与学生：用于通信原理实验、射频设备调试、协议逆向工程；

  • 安全研究人员：用于无线信号安全测试、设备漏洞分析等场景。

2. 应用场景

  • 业余无线电活动：接收广播、对讲机信号，探索未知频段；

  • 教学与实验：高校通信、电子工程专业的无线电实验教学工具；

  • 设备调试：射频模块、无线设备的信号测试与调试；

  • 户外场测：便携性优势支持户外信号扫描、环境电磁监测。

六、注意事项与合规提示

  1. 固件的信号发射功能需严格遵守当地无线电管理法规，未经许可不得发射信号，避免干扰正常通信或违反法律法规；

  2. 非官方渠道购买的设备可能存在硬件质量或兼容性问题，建议优先选择官方合作渠道的产品；

  3. 固件刷写前需确认设备型号与固件版本匹配，按照官方教程操作，避免操作不当导致设备变砖；

  4. 项目为开源项目，开发者不承担因用户不当使用设备或固件导致的法律责任或设备损坏风险。

七、项目未来规划

  • 持续优化固件性能，提升信号处理效率与设备稳定性；

  • 新增更多协议解码模块，扩展支持的信号类型；

  • 完善硬件开源文件，鼓励用户进行二次开发与定制；

  • 优化低功耗设计，进一步延长设备续航；

  • 丰富官方文档与新手教程，降低用户入门门槛。

八、License

GPL-3.0, GPL-2.0 licenses

九、项目地址

https://github.com/OpenSourceSDRLab/PortaRF