FSL_TICS_MAHUI 发表于 2013-11-6 11:14:06

我为飞思卡尔文档来找茬

众所周知碰到问题看文档,文档出错可就是天大的事情了。
希望大家能够踊跃为飞思卡尔文档找错误,请在描述文档错误时注明文档名称和版本号,以方便我们查看。
感谢大家。
友情提示:文档会更新,请下载并使用最新版本的文档。
          文档信息一般在文档首页。

举例:
文档名: KL15P80M48SF0RM
版本号:Rev. 3, September 2012
错误1>第115页,图5-2, 此处略去50字。
错误2>第169页,表11-2,此处略去50字。
错误3>第183页,12.1章,此处略去50字。

huangqi412 发表于 2013-11-6 12:57:42

飞思卡尔的文档,有个很蛋疼的问题,经常寄存器位编号顺序反了,很容易不经意间就被坑了。从8位到32位用过很多款都有,一般是整个章节都反了。是不是不同人编的不同章节。
举例:KL25的PIT章节,   MPC5634等很多型号里也这种问题。

FSL_TICS_MAHUI 发表于 2013-11-6 13:37:39

huangqi412 发表于 2013-11-6 12:57 static/image/common/back.gif
飞思卡尔的文档,有个很蛋疼的问题,经常寄存器位编号顺序反了,很容易不经意间就被坑了。从8位到32位用过 ...

感谢反馈,这个问题我们已经有客户反映过,文档部门正在跟进。

huangqi412 发表于 2013-11-6 13:57:53

FSL_TICS_MAHUI 发表于 2013-11-6 13:37 static/image/common/back.gif
感谢反馈,这个问题我们已经有客户反映过,文档部门正在跟进。

KL25文档通读过程中貌似发现好几处错误,但都没做标记,一时是找不回这些错误了。翻以前其他芯片文档估计能翻出不少错误注释。
搜索了一下PDF注释,搜到一个疑问,ADC章节ADCX_SC1N的通道描述貌似有误, 0-3When DIFF=0, DADP0 is selected as input; when DIFF=1, DAD0 is selected as input.
对DIFF位描述:
0 Single-ended conversions and input channels are selected.
1 Differential conversions and input channels are selected.

我的应用没用到差分也没用到这几个通道,就没去确认了。

FSL_TICS_MAHUI 发表于 2013-11-6 15:01:11

huangqi412 发表于 2013-11-6 13:57 static/image/common/back.gif
KL25文档通读过程中貌似发现好几处错误,但都没做标记,一时是找不回这些错误了。翻以前其他芯片文档估 ...

我看了KL25 ADCx_SC1n描述确实比较晦涩,具体ADC通道图可以参看第三章。这里在DIFF = 0的情况下,使用ADC0_SE0就比较直观了。
谢谢,这块的描述确实需要改进。

cmheia 发表于 2013-11-6 15:10:36

K60的RM万年Preliminary?

isakura 发表于 2013-11-6 15:19:26

这么久还有这个问题?原来用的飞思卡尔没看出来啊

huangqi412 发表于 2013-11-6 16:47:04

FSL_TICS_MAHUI 发表于 2013-11-6 15:01 static/image/common/back.gif
我看了KL25 ADCx_SC1n描述确实比较晦涩,具体ADC通道图可以参看第三章。这里在DIFF = 0的情况下,使用ADC ...

以前大家集体吐槽ST的文档超烂,比ATMEL差了半个地球。我觉得飞思卡尔的文档风格在大多数时候,比ST的更难看懂。随便吐槽其中几例。还以你们现在推的KL25举例,
AD和DA参考源,说这玩意有几个参考源分别叫ref1ref2,就不能一句话直接说内参考外参考什么的么,也不说几个参考源在哪里定义的。打断阅读者让跳出正在读的章节,玩躲猫猫从芯片配置章节里去翻模拟参考源说明。触发源啦,SOPT啦等都是如此,不能去掉一些没用的话余出来用来多说一句提示下阅读者,非让阅读者打断当前阅读去满世界找那些东西。就是给个链接这些玩意定义在哪页也好啊。
STM32的USB章节,就那么长一点点,我刚确认了一下,386-366=20页,将USB从机模块包括双缓冲讲的清清楚楚了。 KL25的,650-611= 40页开篇就慷慨花3大页讲什么是USB,整个章节扣除寄存器描述,剩下一点信息大部分晦涩或废话,对编程帮助极小,可能对高手这点点信息就够把,反正我属于笨的。主机编程就不用幻想了,双缓冲怎么用没说,就是普通从机编程要点,也没提,比如你们这个片子要自己计算包的DATA0/1,初学者之前更多接触的应该是不用自己算DATA0/1的片子,几个字一语点破多好,这个开始就坑晕我了。反正我痛苦的摸索了好一阵摆平了USB从机设备,各种高级功能不想去折腾了,反正4种传输都正常,BULK单向速度700K+也可以用了。21上说了下这事,那边版主告诉我有神奇的官方例程包,除了ATMEL的我一般不下别的厂家程序。还是下了个看看,个人结论是整个例程就包教会枚举成功。一大堆功能,文档宁愿花篇幅讲废话也不点拨,例程是入门级,想用的顺利估计只能肯定必须求助万能的FAE了,小客户往往无门。

0flame0 发表于 2013-11-6 17:05:18

mcf5441x文档的Nandflash控制器部分例子中的命令有很多错误

laoshuhunya 发表于 2013-11-7 09:07:51

huangqi412 发表于 2013-11-6 16:47 static/image/common/back.gif
以前大家集体吐槽ST的文档超烂,比ATMEL差了半个地球。我觉得飞思卡尔的文档风格在大多数时候,比ST的更 ...

同感。
问题描述比较晦涩,没有抓住要点。
FSL感觉有些“官_僚”,其作风在文档中都得到了体现,好在英明的版主已经意识到了这些问题{:smile:}

huangqi412 发表于 2013-11-7 11:42:58

laoshuhunya 发表于 2013-11-7 09:07 static/image/common/back.gif
同感。
问题描述比较晦涩,没有抓住要点。
FSL感觉有些“官_僚”,其作风在文档中都得到了体现,好在英明 ...

自有核产品这些不是致命的问题,选择你片子的人硬着头皮用。
都是ARM核,外设功能也半斤八两时候,不积极竞争,恐怕就没那么好的日子过了。

yansw 发表于 2013-11-7 13:41:57

我觉得都还能忍受,就是希望能够多翻译点中文文档,英文的文档是挺多的,但是中文的太少了

liuqian 发表于 2013-11-7 13:52:26

freescale的文档确实是难看,有时用一个功能要来来回回看几遍,俺感觉自己的英语不太差

FSL_TICS_MAHUI 发表于 2013-11-7 16:53:01

cmheia 发表于 2013-11-6 15:10 static/image/common/back.gif
K60的RM万年Preliminary?

确实如此,这种情况文档部门已经知晓,这种信息确实会带来误解。

FSL_TICS_MAHUI 发表于 2013-11-7 16:58:11

yansw 发表于 2013-11-7 13:41 static/image/common/back.gif
我觉得都还能忍受,就是希望能够多翻译点中文文档,英文的文档是挺多的,但是中文的太少了 ...

飞思卡尔正在计划推出热门芯片的中文参考手册(RM)和数据手册(Datasheet),目前大部分文档都处在校正阶段,明年会陆续推出。

FSL_TICS_MAHUI 发表于 2013-11-7 17:14:41

huangqi412 发表于 2013-11-7 11:42 static/image/common/back.gif
自有核产品这些不是致命的问题,选择你片子的人硬着头皮用。
都是ARM核,外设功能也半斤八两时候,不积极 ...

是啊,MCU竞争岂止激烈,毫不夸张应该属于惨烈。所以竞争不止在于性能价格上,还有很多软实力的东西,技术支持和文档都是很重要的因素。所以,在文档方面,飞思卡尔还是任重而道远啊。

huangqi412 发表于 2013-11-7 18:01:04

FSL_TICS_MAHUI 发表于 2013-11-7 17:14 static/image/common/back.gif
是啊,MCU竞争岂止激烈,毫不夸张应该属于惨烈。所以竞争不止在于性能价格上,还有很多软实力的东西,技 ...

麻烦楼主看下8楼问题

yansw 发表于 2013-11-8 10:30:57

FSL_TICS_MAHUI 发表于 2013-11-7 16:58 static/image/common/back.gif
飞思卡尔正在计划推出热门芯片的中文参考手册(RM)和数据手册(Datasheet),目前大部分文档都处在校正阶 ...

USB协议栈和MQX等多出点中文的吧

NEWT 发表于 2013-11-8 17:38:23

确实,文档坑爹用起来那叫各种不爽

wanstrive 发表于 2014-9-4 16:18:03

官方给的资料都有错,这真是大坑了。
页: [1]
查看完整版本: 我为飞思卡尔文档来找茬