硬件产品需求文档编写指南：从结构拆解到变更管理

简介这份文档资料聚焦硬件产品需求文档的编写思路与方向面向产品经理、设计、研发及测试等岗位人员帮助团队在项目初期建立统一认知避免因需求表述不清导致协作偏差。内容围绕项目简介、使用场景、产品原则、硬件组成及关系、功能性需求、性能需求、接口需求、存储需求、安全需求、机械电子设计需求、环境要求、设计约束条件等十余个维度展开并延伸至可生产性、可测试性、外购元器件、内外部技术合作与嵌入式固件要求配有功能框架图与硬件框架图辅助理解。资源包内含1个docx文档压缩包约440KB结构清晰便于按模块查阅。目前已有173人学习下载适合需要系统梳理硬件需求文档框架、对照查漏补缺的产品与研发人员参考。1. 硬件产品需求文档不是作文从一份被退回三次的 PRD 说起硬件产品需求文档的编写思路与方向落到一线往往不是“写得好不好”的问题而是“写完之后硬件、嵌入式固件、PCB、测试四条线能不能同时开工”的问题。我见过一份智能网关的 PRD产品经理写了四十页结构完整、措辞漂亮结果硬件工程师看完问了一句“所以这版到底用几层板电源是 12V 还是 24V”——文档里没写。嵌入式固件那边更直接“通信协议是 Modbus 还是自定义采样周期多少”——也没写。最后这份文档被退回三次项目延期两周。这不是个例。硬件产品需求文档和软件 PRD 最大的区别在于软件需求写错了改一行代码重新部署就行硬件需求写错了PCB 要重新投板、模具要重新开、认证要重新做一次返工的成本可能是几万到几十万。所以硬件 PRD 的核心不是“描述清楚产品是什么”而是“把下游各条线的输入约束锁死”。这篇文章面向的是正在写或准备写硬件产品需求文档的工程师、产品经理和技术负责人。我会从需求文档的结构拆解讲起落到嵌入式固件接口定义、PCB 设计约束、关键参数表怎么写再到评审和变更管理的具体做法。读完你应该能拿到一份可以直接套用的框架知道哪些字段必须写、哪些坑必须提前堵。2. 硬件 PRD 的结构拆解哪些字段不写下游就得返工2.1 一份可执行的硬件 PRD 应该包含哪七块市面上流传的“项目需求说明文档模板”大多是软件视角的放到硬件项目里会缺一大块。我一般把硬件 PRD 分成七块每块都有明确的读者和用途模块核心内容主要读者不写的后果产品定义功能列表、使用场景、竞品对标全员方向跑偏硬件规格尺寸、重量、接口、供电、功耗结构/硬件选型错误电气参数电压范围、电流上限、信号电平硬件/PCB烧板子嵌入式接口通信协议、引脚定义、时序要求固件无法联调PCB 约束层数、板框、关键走线、EMC 要求Layout反复投板环境与认证工作温度、防护等级、认证清单测试/认证上市受阻验收标准测试项、判定阈值、抽样方案测试/质量扯皮这七块里产品定义和硬件规格大多数团队都会写但电气参数、嵌入式接口、PCB 约束这三块经常被忽略或者写得含糊。而恰恰是这三块决定了项目能不能一次跑通。提示如果你的 PRD 里没有独立的“电气参数”和“PCB 约束”章节基本可以判断这份文档还没到能开工的程度。2.2 产品定义与硬件规格把“做什么”翻译成“用什么约束做”产品定义解决的是“这个产品给谁用、解决什么问题”硬件规格解决的是“用什么物理形态实现”。很多 PRD 的问题出在从产品定义到硬件规格的翻译过程——产品说“要小巧便携”硬件看到的是“尺寸不超过 80×60×25mm重量不超过 150g”。产品说“续航要长”硬件看到的是“电池容量 ≥ 2000mAh整机平均功耗 ≤ 1.5W”。我一般会要求产品经理在写产品定义时每一条功能描述后面都跟一个可量化的约束。比如功能描述支持有线网络接入量化约束RJ45 接口 ×110/100Mbps 自适应接口高度 ≤ 13.5mm对应沉板式连接器功能描述支持外接传感器量化约束4-pin 端子 ×2支持 3.3V/5V 可切换供电单路最大电流 500mA这样做的好处是硬件工程师拿到文档就能直接开始选型和画原理图不需要反复找产品确认。嵌入式固件那边也能从接口定义直接推导出 GPIO 分配和驱动需求。2.3 嵌入式固件接口定义PRD 里最容易被跳过的一页嵌入式固件工程师最怕拿到的 PRD 是“功能描述很详细接口定义全靠猜”。我见过一个项目PRD 里写了“支持温湿度采集”但没写传感器型号、通信接口、采样频率、数据上报格式。固件工程师按 I2C 写了驱动结果硬件选的是单总线 DS18B20整个驱动层重写。在 PRD 里定义嵌入式接口至少要覆盖以下内容【通信接口定义】 - 主控 MCU 型号STM32F103C8T6或同等级需确认 - 传感器接口I2C ×1400kHz地址 0x48 - 上位机通信UART ×1115200-8-N-1协议见附录 A - 调试接口SWD ×1预留 4-pin 排针 【引脚分配表】 | 引脚 | 功能 | 方向 | 备注 | |------|------|------|------| | PA0 | ADC_IN0 | 输入 | 电池电压检测分压比 1:2 | | PA9 | USART1_TX | 输出 | 上位机通信 | | PA10 | USART1_RX | 输入 | 上位机通信 | | PB6 | I2C1_SCL | 输出 | 传感器时钟 | | PB7 | I2C1_SDA | 双向 | 传感器数据 | 【时序要求】 - 上电后 100ms 内完成 GPIO 初始化 - 传感器采样周期1s ± 10% - 数据上报周期5s可配置最小 1s这张表看起来简单但它能省掉固件工程师至少两天的沟通成本。引脚分配表尤其重要——如果 PRD 阶段不锁定硬件画完 PCB 再改引脚那就是飞线或者重新投板。2.4 PCB 设计约束从层数到走线规则的提前锁定PCB 约束是硬件 PRD 里最“硬”的部分。很多产品经理觉得这是硬件工程师的事不该写进 PRD。但实际情况是PCB 的层数、板框尺寸、关键器件的摆放位置直接影响结构设计、散热方案和成本。这些约束如果在 PRD 阶段不锁定到了 Layout 阶段再改结构件可能要重新开模。我一般会在 PRD 里写清楚以下 PCB 约束板框尺寸最大 75×55mm四角 R3 圆角定位孔 4×M2层数四层板信号-地-电源-信号阻抗控制 50Ω±10%关键走线USB 差分对走线长度匹配 ±5mil晶振走线包地处理覆铜要求顶层和底层大面积覆铜与焊盘间距 0.3mmEMC 预留电源入口预留共模电感位置外壳金属化处理这些约束不需要写到走线级别的细节但必须把边界条件定死。比如“四层板”这个决定如果 PRD 里不写硬件工程师按两层板设计到了 EMC 测试不过再改四层那就是重新投板加重新调试。注意PCB 层数、板框尺寸、关键接口位置这三项一旦结构件开模就无法更改。PRD 评审时必须让结构和硬件同时确认。3. 从需求到原理图电气参数表怎么写成硬件能直接用的格式3.1 电源树与功耗预算一张表决定电池和适配器选型电源设计是硬件项目最容易翻车的地方。我见过太多项目在调试阶段发现“5V 轨电流不够”或者“3.3V LDO 发热严重”根源都是 PRD 阶段没有做功耗预算。功耗预算表的写法不复杂但要求覆盖所有用电模块并且留足余量。以一个有 Wi-Fi、传感器、显示屏的便携设备为例电源轨用电模块工作电流峰值电流供电方式余量5VUSB 接口100mA500mA适配器—3.3VMCU 传感器80mA120mALDO50%3.3VWi-Fi 模块200mA350mADCDC30%3.3V显示屏背光60mA80mADCDC50%1.8V核心电压50mA70mALDO40%这张表的关键在于“峰值电流”和“余量”两列。很多团队只算工作电流忽略峰值电流结果 Wi-Fi 发射瞬间把 3.3V 轨拉垮MCU 复位。余量一般建议不低于 30%LDO 供电的轨要额外考虑热耗散。根据这张表硬件工程师可以直接选型3.3V 轨总峰值电流约 550mA选一颗 1A 的 DCDC 就够了1.8V 轨用 LDO 从 3.3V 降压压差 1.5V、电流 70mA功耗 105mWSOT-23 封装勉强够用但最好用 SOT-89。3.2 信号电平与接口保护别让 3.3V 和 5V 打架硬件项目里另一个高频翻车点是电平不匹配。PRD 里如果只写“支持外部传感器接入”不写电平标准硬件工程师可能按 5V 设计固件按 3.3V 写联调时要么读不到数据要么烧引脚。我一般会在 PRD 里明确以下内容【数字接口电平】 - MCU IO 电平3.3V LVTTL - 外部传感器接口3.3V/5V 可切换通过 0Ω 电阻选择上拉电压 - 电平转换5V 侧预留 TXS0108E 位置默认不贴 【模拟接口】 - ADC 参考电压3.3V内部参考 - 输入范围0-3.3V超过需外部分压 - 保护每路模拟输入串联 100Ω 电阻并联 3.3V TVS 管 【通信接口保护】 - UART串联 22Ω 电阻预留 TVS 位置 - I2C上拉 4.7kΩ 至 3.3V串联 100Ω 电阻 - USB差分对串联 90Ω 共模电感预留 ESD 保护这些内容看起来琐碎但每一条都对应一个实际踩过的坑。比如 I2C 上拉电阻4.7kΩ 在 100kHz 下没问题但如果传感器线缆较长、总线电容超过 400pF就得降到 2.2kΩ。PRD 里写清楚默认值和调整方向硬件工程师就能在 Layout 时预留位置。3.3 关键器件选型约束为什么 PRD 要指定“不能用什么”PRD 一般不指定具体型号但可以指定约束条件。比如“电源芯片优先选择国产化替代”“连接器高度不超过 5mm”“晶振精度 ±20ppm”。这些约束比指定型号更灵活同时能避免硬件工程师选到不合适的器件。我遇到过最典型的案例是PRD 没写“连接器必须支持至少 30 次插拔”硬件选了一款低成本排针结果测试阶段插拔十几次就接触不良。后来在 PRD 里补了一条“外部接口连接器插拔寿命 ≥ 5000 次”硬件直接换成带卡扣的 Wafer 连接器问题解决。另一个常见约束是温度范围。消费级器件 0-70°C工业级 -40-85°C汽车级 -40-125°C。如果 PRD 不写工作温度硬件按消费级选型到了北方冬天户外直接不启动。我一般会在 PRD 里写“工作温度 -20-60°C存储温度 -40-85°C所有器件至少满足工业级温度范围。”4. 需求评审与变更管理硬件项目最贵的不是写文档而是改文档4.1 评审清单硬件、固件、PCB、测试四方必须确认的 12 项硬件 PRD 的评审不能只走形式。我一般会组织一次两小时的评审会硬件、固件、PCB、测试四方各派一个人逐项过以下清单产品功能列表是否完整有没有遗漏的“隐藏需求”硬件规格中的尺寸、重量、接口是否与结构确认电气参数表中的电压、电流、功耗是否留足余量嵌入式接口定义中的引脚分配是否与硬件原理图一致通信协议是否明确定义了帧格式、校验方式、超时重传PCB 约束中的层数、板框、关键走线是否与 Layout 确认关键器件选型约束是否与采购确认供货周期环境与认证要求是否与测试确认测试周期和费用验收标准中的测试项是否可量化、可复现变更流程是否明确——谁有权改、改了怎么通知版本号规则是否确定——硬件版本、固件版本、文档版本风险清单是否列出——供货风险、技术风险、认证风险这 12 项里第 4、5、6 项是最容易出问题的。引脚分配不一致硬件画完 PCB 固件才发现对不上通信协议没定义校验联调时数据出错不知道是硬件噪声还是软件 bugPCB 约束没确认Layout 按自己的习惯走线EMC 测试不过。提示评审会结束后把确认结果写成会议纪要附在 PRD 后面。下次改版时这份纪要就是变更依据。4.2 变更影响评估改一个电阻为什么要通知五个人硬件项目的变更成本远高于软件。改一个电阻值听起来简单但影响链条可能是硬件改原理图 → PCB 改布局 → 固件改驱动参数 → 测试改测试用例 → 采购改 BOM。如果这个电阻还涉及认证那还要通知认证工程师。我一般要求变更发起人填写一张影响评估表变更内容影响模块需要通知的人是否需要重新投板是否需要重新认证上拉电阻 4.7kΩ → 2.2kΩI2C 总线硬件、固件、PCB否可飞线验证否MCU 型号更换全部全员是是EMC连接器高度 5mm → 8mm结构、PCB结构、硬件、PCB是否增加 ESD 保护器件接口硬件、PCB、测试是是ESD 测试这张表的核心是“是否需要重新投板”和“是否需要重新认证”两列。如果答案是“是”那这个变更就必须走正式评审不能口头通知。4.3 版本号与文档追溯别让“最终版”变成“最终最终版”硬件项目的文档版本管理比软件更复杂因为硬件有物理版本。我一般建议采用三段式版本号文档版本.硬件版本.固件版本。比如 V1.2.3 表示文档第 1 版、硬件第 2 版、固件第 3 版。每次变更至少更新文档版本号并在文档头部记录变更日志【变更日志】 | 版本 | 日期 | 变更内容 | 变更人 | 影响范围 | |------|------|---------|--------|---------| | V1.0 | 2024-01-10 | 初版发布 | 张三 | — | | V1.1 | 2024-01-15 | 修改 I2C 上拉电阻为 2.2kΩ | 李四 | 硬件、固件 | | V1.2 | 2024-01-20 | 增加 ESD 保护要求 | 王五 | 硬件、PCB、测试 |变更日志看起来是小事但到了项目后期当硬件、固件、测试三方对某个参数有争议时翻变更日志就能找到依据。我见过一个项目硬件工程师说“PRD 里写的是 4.7kΩ”固件工程师说“我记得后来改成 2.2kΩ 了”翻日志发现确实改了但只通知了硬件没通知固件。这就是变更流程没闭环的后果。5. 避坑与排查硬件 PRD 写完之后最容易翻车的五个地方5.1 现象硬件按 PRD 画完 PCB固件说引脚不够用原因PRD 里的引脚分配表只列了主要功能没算上调试接口、指示灯、按键这些“小需求”。硬件画 PCB 时把引脚用满了固件想加个状态指示灯都没引脚。解决PRD 阶段预留至少 20% 的 GPIO 余量并在引脚分配表里明确标注“预留”引脚。我一般会要求硬件在原理图设计完成后把实际引脚分配表回写到 PRD 里固件确认后再投板。5.2 现象PCB 投板回来发现板框尺寸和结构件对不上原因PRD 里写了“尺寸不超过 80×60mm”但没写定位孔位置、接口开孔位置、板边与外壳的间隙。结构工程师按自己的理解画了外壳PCB 按自己的理解画了板框两者不匹配。解决PRD 里必须附带结构约束图标注定位孔坐标、接口中心位置、板边到外壳内壁的最小距离一般 ≥ 0.5mm。结构工程师和 PCB 工程师在投板前必须做一次 3D 干涉检查。5.3 现象EMC 测试不过整改发现是 PRD 没写清楚原因PRD 里只写了“满足 CE 认证”没写具体的 EMC 测试项目和限值。硬件工程师按经验做了滤波和屏蔽但测试时发现辐射发射超标整改需要改 PCB。解决PRD 里明确 EMC 要求至少包括辐射发射RE、传导发射CE、静电放电ESD、浪涌Surge四项并注明适用标准如 EN 55032 Class B。硬件设计时预留共模电感、磁珠、TVS 的位置即使默认不贴。5.4 现象固件联调时发现通信协议对不上原因PRD 里写了“支持 UART 通信”但没写波特率、数据位、停止位、校验方式更没写应用层协议。硬件按 9600 设计固件按 115200 写联调时全是乱码。解决PRD 里必须包含完整的通信协议定义至少包括物理层参数波特率、电平、链路层参数帧头、长度、校验、应用层命令功能码、数据格式、超时重传。协议有变更时必须同步更新 PRD 和固件代码。5.5 现象小批量试产时发现某个器件买不到原因PRD 里指定了某款芯片但没写“国产化替代”或“第二供应商”要求。采购按型号下单发现交期 12 周项目卡住。解决PRD 里对关键器件写清楚“优先选择有第二供应商的型号”或“允许国产化替代”。硬件设计时对电源芯片、MCU、连接器这三类器件至少准备一个 Pin-to-Pin 兼容的替代型号。6. 把 PRD 变成活文档三个让下游主动配合的技巧6.1 用“接口冻结”节点倒逼各方提前确认硬件项目最怕的是“边设计边改需求”。我一般会在 PRD 里设定三个冻结节点原理图冻结、PCB 冻结、固件接口冻结。每个节点前相关方必须完成确认并签字邮件确认也算。原理图冻结前硬件必须确认所有器件选型和引脚分配PCB 冻结前结构必须确认板框和接口位置固件接口冻结前固件必须确认通信协议和寄存器定义。这三个节点一旦过了再改就要走变更流程成本由发起方承担。这个做法看起来强硬但实际执行下来各方都会在冻结前认真检查反而减少了后期返工。我做过一个项目原理图冻结前硬件发现 MCU 的 ADC 通道不够用及时换了一款引脚更多的型号避免了投板后飞线。6.2 把测试用例写进 PRD 的验收标准里很多 PRD 的验收标准写得很虚“功能正常”“性能达标”。测试工程师拿到这种标准只能自己发挥结果测出来的问题硬件不认。我一般要求 PRD 里的验收标准必须包含具体的测试用例测试项测试方法判定标准抽样数量供电电压范围可调电源从 4.5V 调到 5.5V设备正常工作无复位5 台工作电流万用表串联测量平均电流 ≤ 150mA5 台通信距离标准线缆连接逐步加长100m 内误码率 ≤ 0.1%3 台高低温启动-20°C 和 60°C 各放置 2h能正常启动并通信3 台ESD 接触放电接触放电 ±4kV空气放电 ±8kV无死机、无复位3 台这张表直接来自 PRD测试工程师照着测就行硬件工程师也知道该往哪个方向设计余量。比如 ESD ±4kV 的要求硬件就会在接口处加 TVS 管而不是省掉。6.3 用“需求追溯矩阵”管住每一次变更需求追溯矩阵RTM听起来像大公司的流程工具但其实用一张 Excel 就能做。每一行是一条需求列包括需求编号、需求描述、来源、对应设计文档、对应测试用例、当前状态。需求编号需求描述来源设计文档测试用例状态REQ-001支持 5V 供电产品定义原理图 P3TC-001已确认REQ-002工作电流 ≤ 150mA硬件规格功耗预算表TC-002已确认REQ-003支持 I2C 传感器嵌入式接口引脚分配表TC-003待确认REQ-004四层板设计PCB 约束PCB 叠层图—已确认这张表的好处是当有人问“这个需求做了没有”直接看状态列当需求变更时看影响哪些设计文档和测试用例。我一般会在每次评审会后更新这张表确保没有需求被遗漏。6.4 我自己的习惯PRD 写完先给固件工程师看一遍最后说一个我自己的习惯。每次 PRD 初稿写完我不会先给硬件看而是先给固件工程师看一遍。原因很简单固件工程师是下游里最“挑剔”的读者他们需要从 PRD 里提取引脚定义、通信协议、时序要求、状态机逻辑。如果固件工程师看完说“这个接口定义不清楚”那硬件工程师大概率也看不懂。固件工程师的反馈通常集中在三个地方引脚分配是否完整、通信协议是否可解析、异常处理是否定义。这三个地方补全了PRD 的可执行性就上了一个台阶。我试过几次固件工程师提前介入的 PRD联调阶段的问题至少少一半。硬件产品需求文档的编写思路与方向说到底就是一句话把下游要用的信息提前写清楚把下游会踩的坑提前堵上。文档不是写给领导看的是写给硬件、固件、PCB、测试四条线看的。他们能照着文档直接开工这份 PRD 就合格了。希望帮到你。本文还有配套的精品资源点击获取