@shijingshijing #48
别在那自我感动,你看过多少文档?
芯片手册就两页 PDF 的很少见吗?
上千页的软件框架的文档在你看来很不可思议吗?
硬件有复杂的有简单的,软件也有复杂的有简单的。
硬件文档有写的详细的也有写的粗略的,软件文档也有写的详细的写的粗略的。
单一个多媒体编解码工具 ffmpeg,区区几十 MB 的命令行软件,官网上的文档如果下载下来一页一页打印成书,那玩意能砸死人。
然而 ffmpeg 的官方文档众所周知的“还远远不够详细”,众多的命令、变量、格式一笔带过甚至只字未提甚至开发组自己都说不清楚,就这样“粗略”的文档其分量已经让人望而生畏了,嗯?
“管脚定义,时序图,电气性能,温度范围,物理封装等内容”,区区这点内容,就让你感慨大厂的专业性和责任心了?
电子大厂那么多拳头产品,哪个不是除了一份已经“厚厚”的 PDF 之外,还有数不清的应用笔记?
看 datasheet 也就图一乐,真要解决问题还得多多查阅那些 AN 打头的官方应用笔记,里面满满当当的应用场景、设计样例、绕开产品 BUG 的方法、利用产品 BUG 的方法。都看过了?放心,看不完的,一辈子都不够。
那既然没看过在这儿嚷嚷啥呢?来装逼的?果然文人相亲吼,软件硬件不分家,要鄙视大家都在一根链条上吼?
有病!!!
软件文档是描述软件的,硬件文档是描述硬件的。软件暴露在外的是 API,自然要围绕 API 进行描述。硬件暴露给用户的元素难道不是跟 API 类同的东西?
软件的结构、原理、场景、变量、特性、语法、暴露出来的接口、接口接收的变量、接口返回的结果、接口抛出的异常、示例代码、推荐代码、缺陷、BUG 、避免 BUG 的方法、部署方法、运行环境、配置手段……等等等待。
对应到硬件的结构、原理、场景、物理量变化、物理特性、管脚、信号、封装、设计样例、推荐方案、可能存在的 bug 及如何避免、工作环境储存环境的温湿度盐碱度、机械特性、额定电压电流、管脚配置、通信方式、软件配置……等等等等。
来来来,纸和笔给你,我倒要看看你能在相同篇幅下把这些都写明白喽?