找回密码
 立即注册
查看: 678|回复: 2

关于对手册上应该增加的一些内容的,否则会让开发人员云里雾里

[复制链接]
  • 打卡等级:以坛为家II
  • 打卡总天数:463
  • 最近打卡:2025-06-17 17:53:48

33

主题

2448

回帖

5174

积分

论坛元老

积分
5174
发表于 2023-12-14 10:30:30 | 显示全部楼层 |阅读模式
对于手册的一些观点。



开发人员在拿到一个新的片子的时候,首先就会去翻看这个片子的  技术参 考手册 (PS:吐槽一下STC8H系列单片机技术参考手册的封面,,不知道编写人员处于什么考虑,技术参考手册中间要加上一个空格,然后就变成   技术参 考手册    哈哈哈),那么如果手册上对于一些寄存器描述不到位,包括但不限于没有写上如何使用,如何清除等操作。就会极大的浪费开发人员的精力。而对于论坛与提供的参考例程的理解,我不认为要让参考例程或者在论坛上发帖提问作为手册的补充,而是将参考例程作为手册的解释;将论坛上的提问作为芯片往后进步的方向。


故以上观点,这里发出一贴,作为在测试STC8H8K64U这个片子的过程中的发现需要在手册上增加内容的总贴。希望官方可以在慎重考虑之后对手册进行补充修改,能重视手册的编写。



参考例程并不是对技术参 考手册的补充,而是对技术参 考手册的解释。
技术参 考手册不应该需要参考例程作为补充,而是解释成了参考例程的样子
回复

使用道具 举报 送花

  • 打卡等级:以坛为家II
  • 打卡总天数:463
  • 最近打卡:2025-06-17 17:53:48

33

主题

2448

回帖

5174

积分

论坛元老

积分
5174
发表于 2023-12-14 10:33:30 | 显示全部楼层
第一个,捞一下昨天发送的贴子,有关Keil中断扩展插件的
https://www.stcaimcu.com/forum.p ... &extra=page%3D1

截图202312141032483183.jpg


具体内容这里就不再复制一遍了,可以去那个贴子查看。。
参考例程并不是对技术参 考手册的补充,而是对技术参 考手册的解释。
技术参 考手册不应该需要参考例程作为补充,而是解释成了参考例程的样子
回复 支持 反对

使用道具 举报 送花

  • 打卡等级:以坛为家II
  • 打卡总天数:463
  • 最近打卡:2025-06-17 17:53:48

33

主题

2448

回帖

5174

积分

论坛元老

积分
5174
发表于 2023-12-14 10:41:26 | 显示全部楼层
第二、有关URnR_DMA传输完成字节寄存器(DMA_URnR_DONE)里数值的清除方式。

这里我是查到了这篇贴子之后才知道了如何清除。
https://www.stcaimcu.com/forum.php?mod=viewthread&tid=4675
所以是不是应该在手册上加入有关描述呢



参考例程并不是对技术参 考手册的补充,而是对技术参 考手册的解释。
技术参 考手册不应该需要参考例程作为补充,而是解释成了参考例程的样子
回复 支持 反对

使用道具 举报 送花

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

QQ|手机版|小黑屋|深圳国芯人工智能有限公司 ( 粤ICP备2022108929号-2 )

GMT+8, 2025-6-17 20:16 , Processed in 1.342710 second(s), 56 queries .

Powered by Discuz! X3.5

© 2001-2025 Discuz! Team.

快速回复 返回顶部 返回列表