为什么要有这个规范
这个板块只写具体的操作笔记,不写行业趋势,也不写公司动态。判断标准只有一条:读者能不能照着做出来。
标题怎么写
标题就是具体的技术任务,用户怎么搜,我们就怎么写。
- 推荐:
CH592 上 BLE 连接参数配置的注意事项 - 推荐:
RK3568 的 PCIe 转 SATA 实际速率测试 - 不写:
浅谈物联网发展趋势 - 不写:
公司顺利完成某项目交付
正文结构
1. 结论先行
开头 100 字内说清楚三件事:什么芯片或平台、要解决什么问题、最终结论是什么。读者看完这段就该知道自己要不要继续读。
2. 现象与排查过程
把排查路径按顺序写出来,包括走错的路。别人踩过的坑,往往比正确答案更有价值。
3. 关键配置或代码
只贴真正起作用的那几行,附上必要的注释说明参数含义。
/* CH592 BLE 连接参数:在功耗与响应速度之间取平衡 */
GAP_SetParamValue(TGAP_CONN_INTERVAL, 48); /* 连接间隔 60ms */
GAP_SetParamValue(TGAP_CONN_SLAVE_LATENCY, 4); /* 从机延迟,允许跳过 4 个连接事件 */
GAP_SetParamValue(TGAP_CONN_TIMEOUT, 600); /* 监督超时 6s */
4. 实测数据
用表格把优化前后的数据摆出来,比任何形容词都直观。
| 指标 | 优化前 | 优化后 | 测试条件 |
|---|---|---|---|
| 待机电流 | 待测 | 待测 | 室温,3.0V 供电 |
| 唤醒响应 | 待测 | 待测 | 连续 100 次取平均 |
数据必须来自实际测量。没有实测数据时,宁可先不写,也不要估算。
5. 结论与适用边界
说明这个方案在什么条件下成立、什么情况下不适用。避免读者直接照搬踩坑。
写完自查清单
- 标题是否描述了一个具体的技术任务
- 开头 100 字内是否给出明确结论
- 关键配置是否有注释说明参数含义
- 是否包含真实实测数据(而非估算)
- 是否说明了方案的适用边界
- 文中是否说明涉及的芯片型号与版本
发布频率
不需要追求数量。每人每两个月产出一篇有实测数据的内容,半年就有多篇可被检索到的技术资产。