第三章软硬件规范以及STM32最小系统.PDFVIP

JoyCreateWorkroom 乐创DIY教程 第三章 软硬件规范以及STM32最小系统 本章开始，我们正式进入 “乐创DIY”的 “STM32单片机实战教程” 由于 我们是一个社区类的教程视频，因此我们必须统一我们的软件和硬件规则，以保 证所在这个社群的人都能看懂我们的代码和硬件 所以，我觉得把规范作为我们 设计课程中的正式第一课是十分有必要的 1 软件规范 在这节课正式之前，我们先来比较一下图1中的两份代码片段 图 代码风格比对 1 相信绝大多数朋友喜欢右边这张图片里面的代码编写方式，尽管在变量名称 定义上面还是没有做的很好，但就条理这个层面来说，右边的代码风格条理清晰， 层次分明，让人一看就能知道每个if，for所作用的范围 其实，一种好的代码 风格，不仅让人更易读，以便后人维护，还能在写程序的时候，让自己能够逻辑 清晰，不会有错 但是就这种最简单，只要墨守成规就能做好的事情，竟然没有 一个学校老师，会花时间在课堂上面讲，以至于当今很多所谓的“精通C语言工 程师”，写出了左图中的代码 以下，我们就开始软件规范的讲解，我们下文中的内容，适当参考了华为软 件编程规范和范例 以后的每节课，我们都会严格按照今天提到的风格来写我们 的代码 1.1 排版 1 第三章 软硬件规范以及STM32最小系统 JoyCreateWorkroom 乐创DIY教程 （1）程序块要采用缩进风格编写，缩进的空格数为4个。函数或过程的开 始、结构的定义及循环、判断等语句中的代码都要采用缩进风格, case 语句下 的情况处理语句也要遵从语句缩进要求 说明：由于每个IDE的文本编辑器自动缩进的空格数可能不一样，因此建议 缩进时，手动敲击4个空格按键 （2）相对独立的程序块之间、变量说明之后，必须加空行 示例: 如下例子不符合规范 if (!valid_ni(ni)) { ... // program code } repssn_ind = ssn_data[index].repssn_index; repssn_ni = ssn_data[index].ni; 应如下书写: if (!valid_ni(ni)) { ... // program code } repssn_ind = ssn_data[index].repssn_index; repssn_ni = ssn_data[index].ni; （3）较长的语句（如循环、判断等语句或者函数等）(80字符)要分成多 行书写, 长表达式要在低优先级操作符处划分新行, 操作符放在新行之首, 划 分出的新行要进行适当的缩进, 使排版整齐, 语句可读 示例: perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN + STAT_SIZE_PER_FRAM * sizeof( _UL ); for (i= 0, j = 0; (i BufferKeyword[word_index].word_length) (j NewKeyword.word_length); i++, j++) n7stat_flash_act_duration( stat_item, frame_id *STAT_TASK_CHECK_NUMBER + index, stat_object ); （4）不允许把多个短语句写在一行中, 即一行只写一条语句 示例: 如下例子不符合规范 rect.length