嵌入式软件编程规范
- 格式:doc
- 大小:390.00 KB
- 文档页数:47
codesys 编程使用指南Codesys是一种常用的编程工具,用于开发和编写嵌入式系统的控制程序。
本文将为读者提供一份Codesys编程使用指南,帮助初学者快速入门并掌握基本的编程技巧。
一、Codesys简介Codesys是一种基于IEC 61131-3标准的集成开发环境(IDE),支持多种编程语言,包括结构化文本(ST)、图表(IL)、功能块图(FBD)、连续功能图(CFC)和顺序功能图(SFC)。
它可以在不同的硬件平台上运行,并与多种通信协议兼容。
二、Codesys安装和配置1. 下载Codesys软件并按照安装向导进行安装。
2. 打开Codesys软件,选择合适的硬件平台和通信协议。
3. 配置硬件设备的参数,如IP地址、端口号等。
4. 创建一个新项目,选择编程语言和存储位置。
三、Codesys编程基础1. 了解IEC 61131-3编程规范,熟悉不同的编程语言和它们的特点。
2. 学习如何声明和定义变量,包括数据类型、范围和初始值。
3. 掌握条件语句(如if-else)和循环语句(如for和while),用于控制程序的流程。
4. 学习如何定义和调用函数块,实现代码的模块化和重用。
5. 掌握如何使用定时器和计数器,实现定时任务和计数功能。
6. 学习如何处理错误和异常情况,编写健壮的程序代码。
7. 熟悉调试工具和技巧,能够有效地定位和修复程序中的错误。
四、Codesys高级编程技巧1. 学习如何使用结构体和数组,组织和管理复杂的数据结构。
2. 掌握面向对象编程(OOP)的基本概念和技巧,提高代码的可维护性和重用性。
3. 学习如何与外部设备进行通信,包括传感器、执行器和其他控制系统。
4. 了解代码优化和性能调优的技术,提高程序的执行效率和响应速度。
5. 学习如何进行版本控制和团队协作,保证多人开发的代码质量和一致性。
五、Codesys实例应用1. 开发一个简单的闹钟程序,实现定时提醒功能。
2. 设计一个温度控制系统,根据温度传感器的数值调整加热器的功率。
嵌入式软件需求规范篇一:嵌入式编程规范嵌入式编程规范1 基本要求1) 程序结构清晰,简单易懂,单个函数的程序行数不得超过100行,每行代码不得超过100列。
2) 打算干什么,要简单,直接了当,代码精简,避免垃圾程序。
3) 尽量使用标准库函数和公共函数。
4) 不要随意定义全局变量,尽量使用局部变量。
5) 使用括号以避免二义性。
2 可读性要求1) 可读性第一,效率第二。
2) 保持注释与代码完全一致。
3) 每个源程序文件,都有文件头说明,说明规格见规范。
4) 每个函数,都有函数头说明,说明规格见规范。
5) 主要变量(结构、联合、类或对象)定义或引用时,注释能反映其含义。
6) 常量定义(DEFINE)有相应说明。
7) 处理过程的每个阶段都有相关注释说明。
8) 在典型算法前都有注释。
9) 用缩进来显示程序的逻辑结构,缩进量一致并以Tab键为单位,定义Tab为 4个字节。
10) 循环、分支层次不要超过五层。
11) 注释可以与语句在同一行,也可以在上行。
12) 空行和空白字符也是一种特殊注释。
13) 一目了然的语句不加注释。
14) 注释的作用范围可以为:定义、引用、条件分支以及一段代码。
15) 注释行数(不包括程序头和函数头说明部份)应占总行数的 1/5 到 1/3 。
3 结构化要求1) 禁止出现两条等价的支路。
2) 禁止GOTO语句。
3) 用 IF 语句来强调只执行两组语句中的一组。
禁止 ELSE GOTO 和 ELSERETURN。
4) 用 CASE 实现多路分支。
5) 避免从循环引出多个出口。
6) 函数只有一个出口。
7) 不使用条件赋值语句。
8) 避免不必要的分支。
9) 不要轻易用条件分支去替换逻辑表达式。
4 正确性与容错性要求1) 程序首先是正确,其次是优美。
2) 无法证明你的程序没有错误,因此在编写完一段程序后,应先回头检查。
3) 改一个错误时可能产生新的错误,因此在修改前首先考虑对其它程序的影响。
MISRA--作为工业标准的C编程规范(嵌入式c开发者必读)MISRA--作为工业标准的C编程规范MISRA (The Motor Industry Software Reliability Association 汽车工业软件可靠性联会) 是位于英国的一个跨国汽车工业协会,其成员包括了大部分欧美汽车生产商。
其核心使命是为汽车工业提供服务和协助,帮助厂方开发安全的、高可靠性的嵌入式软件。
这个组织最出名的成果是所谓的MISRA C Coding Standard,这一标准中包括了127条C语言编码标准,通常认为,如果能够完全遵守这些标准,则你的C代码是易读、可靠、可移植和易于维护的。
最近很多嵌入式开发者都以MISRA C来衡量自己的编码风格,比如著名的uC/OS-II就得意地宣称自己99%遵守MISRA标准。
而《嵌入式开发杂志》也专门载文号召大家学习。
编码规范通常是一个公司自定的“土政策”,居然有人去做标准,而且还得到广泛的认可,这不禁引起我强烈的兴趣。
可惜这份标准的文本需要花钱去买,而且短短几十页,要价非常昂贵。
MISRA 在网上公布了一些文档,其中有关于MISRA C Coding Standard的Clarification报告,从中间你可以大致猜到MISRA标准本身是什么。
我仔细阅读了这些文档,并且通过阅读其他一些介绍性文档,大致了解了MISRA标准的主要内容。
这些条款确有过人之处,对于C/C++语言工程项目的代码质量管理能够起到良好的指导性作用,对于大部分软件开发企业来说,在MISRA的基础上适当修改就可以形成自己的规范。
当然其中也有一些过于严苛的东西,这就需要各个开发部门灵活处理了。
我个人的体会,编码规范虽然很简单,但是要完全执行,不折不扣,需要开发部门有很高的组织性和纪律性,并且有很好的代码评审机制。
因此,如果能够严格地遵守编码规范,本身就是一个开发部门实力的证明。
这里不可能将所有规则一一列出(事实上正式文本我一条也没看到),只列出一些比较有意思的条款,让大家有机会了解MISRA的风格。
嵌入式系统标准
嵌入式系统标准是指导嵌入式系统开发和应用的一系列规范、标准和协议。
这些标准涵盖了硬件、软件、通信和接口等方面,旨在确保嵌入式系统的可靠性、安全性和互操作性。
以下是一些常见的嵌入式系统标准:
1. 硬件标准:包括处理器架构、内存和存储、电源管理、接口和连接等方面的规范。
例如,ARM架构是一种广泛应用于嵌入式系统的处理器架构,而PCI Express(PCIe)则是一种高速串行计算机扩展总线标准。
2. 软件标准:包括操作系统、编程语言、中间件和应用程序接口(API)等方面的规范。
例如,实时操作系统(RTOS)是一种专门为嵌入式系统设计的操作系统,而C语言和C++语言则是嵌入式系统开发中常用的编程语言。
3. 通信标准:包括有线和无线通信协议、网络协议和数据传输协议等方面的规范。
例如,TCP/IP协议是一种常用的网络通信协议,而蓝牙和Wi-Fi则是常见的无线通信协议。
4. 接口标准:包括物理接口、电气接口和数据接口等方面的规范。
例如,USB接口是一种通用的串行总线接口标准,而I2C和SPI则是常用的串行通信接口标准。
5. 安全标准:包括加密、身份验证和访问控制等方面的规范。
例如,SSL/TLS协议是一种常用的网络安全协议,而AES算法则是一种广泛应用的加密算法。
这些标准通常由国际标准化组织(ISO)、国际电工委员会(IEC)、IEEE(电气电子工程师协会)和其他行业组织制定和推广。
遵守这些标准可以帮助开发者提高嵌入式系统的质量和效率,降低成本和风险,并促进不同系统之间的互操作性和兼容性。
pclint misra c 标准的要求-回复PCLint是一款静态代码分析工具,常用于C语言和C++代码的检查。
而MISRA C是一套C语言编程规范,它旨在提高软件质量、可靠性与可维护性。
本文将探讨PCLint在MISRA C标准中的要求,并详细介绍如何使用PCLint进行MISRA C规范的静态代码检查。
1. MISRA C标准简介MISRA C是由Motor Industry Software Reliability Association (MISRA)制定的一套面向嵌入式系统的C语言编程规范。
它旨在改善编码质量、提高软件的可靠性和可维护性,规范了C语言的语法和编码风格。
2. PCLint介绍PCLint是由Gimpel Software开发的C/C++静态代码分析工具。
它能够检查代码中的潜在问题和编程错误,并生成详细的报告,指导开发人员进行代码质量的改进。
3. PCLint与MISRA C规范的结合PCLint提供了针对MISRA C规范的专门配置文件,并能够对代码进行准确的静态分析。
通过使用PCLint的MISRA C配置文件,可以更容易地检查代码是否符合MISRA C标准中的要求。
4. PCLint对MISRA C规范的主要要求- 命名规则:变量、函数和宏的命名必须符合特定规范,如使用小写字母和下划线。
- 语法要求:代码必须符合MISRA C提出的语法规则,如禁止使用某些语言特性和语法结构。
- 数据类型:确保使用符合要求的数据类型,并禁止使用不安全的类型转换。
- 注释和文档:代码必须进行适当的注释,以提高代码的可读性和可维护性。
- 错误处理:对于可能发生错误的操作,必须进行适当的错误处理,如检查返回值和处理异常。
- 代码复杂性:代码的复杂性必须控制在合理的范围内,以确保代码的清晰性和可理解性。
- 嵌入式编程相关:对于嵌入式系统开发,还有一些特定的规范要求,如中断处理、内存管理等。
5. 使用PCLint进行MISRA C规范检查的步骤- 配置PCLint环境:下载和安装PCLint,并获取最新的MISRA C配置文件。
嵌入式软件设计嵌入式软件设计是指为嵌入式系统设计开发软件程序的过程。
嵌入式系统是一种特殊的计算机系统,它旨在执行特定任务,并通常涉及与物理世界的交互。
常见的嵌入式系统包括现代汽车、数字相机、智能手机、路由器、交通信号灯和医疗设备等。
这些设备需要高度优化、可靠且高效的软件,以便能够正确地执行其功能。
在开始嵌入式软件设计之前,首先要确定系统的架构和需求。
架构涉及处理器选择、内存容量、存储器、输入/输出接口和各种系统总线等。
需求涉及系统功能、性能、安全、可靠性和易用性等方面。
这些因素都将影响软件设计和开发的过程。
嵌入式软件通常是使用低级编程语言(如C或汇编语言)编写的。
低级语言允许程序员直接控制硬件的配置和操作。
这样可以最大程度地优化程序的性能和资源使用效率。
然而,低级编程语言也非常容易出错,因此需要进行精心的测试和调试工作。
在嵌入式软件设计的过程中,还需要考虑到多线程、中断处理、存储器管理和通信协议等方面。
多线程可以提高系统的并发性和响应能力,但也容易引入bug和死锁等问题。
中断处理可以确保在紧急情况下及时响应事件,但也可能会影响系统的稳定性。
存储器管理可以确保软件的内存使用高效,并确保不会发生内存泄漏和缓冲区溢出等问题。
通信协议可以确保与其他设备和系统之间的通信正确进行。
除了开发软件之外,还需要对软件进行测试和调试。
测试可以检测软件中的缺陷和错误,并帮助程序员调整代码以更好地满足预期的功能和性能要求。
调试可以帮助程序员快速定位问题并进行纠正。
最后,为了确保飞行安全和质量控制等方面的要求,嵌入式软件应符合国际标准和规范,例如RTCA-DO-178C(飞机软件开发的安全认证标准)和ISO 26262(汽车软件开发的安全认证标准)。
总之,嵌入式软件设计需要开发人员经过深思熟虑和严谨的方法来开发高效、高可靠性的软件程序。
这需要程序员具备一定的专业知识和技能,同时也需要完善的软件开发流程和测试方法。
只有这样,才能保证嵌入式系统的安全性和正常运行,同时也满足客户的需求和期望。
学习MISRAC邵贝贝等编者按:C语言是开发嵌入式应用的主要工具,然而C语言并非是专门为嵌入式系统设计,相当多的嵌入式系统较一般计算机系统对软件安全性有更苛刻的要求。
1998 年,MISRA指出,一些在C看来可以接受,却存在安全隐患的地方有127处之多。
2004年,MISRA对C的限制增加到141条。
嵌入式系统应用工程师借用计算机专家创建的C语言,使嵌入式系统应用得以飞速发展,而MISRAC是嵌入式系统应用工程师对C语言嵌入式应用做出的贡献。
如今MISRA C已经被越来越多的企业接受,成为用于嵌入式系统的C语言标准,特别是对安全性要求极高的嵌入式系统,软件应符合MISRA标准。
本文将分6讲,与读者共同学习MISRAC。
第一讲:“…安全第一‟的C语言编程规范”,简述MISRAC的概况。
第二讲:“跨越数据类型的重重陷阱”,介绍规范的数据定义和操作方式,重点在隐式数据类型转换中的问题。
第三讲:“指针、结构体、联合体的安全规范”,解析如何安全而高效地应用指针、结构体和联合体。
第四讲:“防范表达式的失控”,剖析MISRAC中关于表达式、函数声明和定义等的不良使用习惯,最大限度地减小各类潜在错误。
第五讲:“准确的程序流控制”,表述C语言中控制表达式和程序流控制的规范做法。
第六讲:“构建安全的编译环境”,讲解与编译器相关的规范编写方式,避免来自编译器的隐患。
学习MISRAC之一:“安全第一”的C语言编程规范C/C++语言无疑是当今嵌入式开发中最为常见的语言。
早期的嵌入式程序大都是用汇编语言开发的,但人们很快就意识到汇编语言所带来的问题——难移植、难复用、难维护和可读性极差。
很多程序会因为当初开发人员的离开而必须重新编写,许多程序员甚至连他们自己几个月前写成的代码都看不懂。
C/C+ +语言恰恰可以解决这些问题。
作为一种相对“低级”的高级语言,C/C++语言能够让嵌入式程序员更自由地控制底层硬件,同时享受高级语言带来的便利。
TRZN TRZN 嵌入式软件编程规范1文档概述 (4)1.1关于本文档 (4)1.2参考文献 (4)2排版 (5)3注释 (10)4标识符命名 (19)5可读性 (25)6变量、结构 (26)7宏 (31)8函数、过程 (33)9可测性 (41)10代码版本管理 (44)10.1代码质量定义 (44)10.2G IT分支定义 (44)10.3G IT代码引入规定 (44)10.4G IT代码C OMMIT顺序 (45)10.5C OMMIT文件过程中的其他注意事项 (45)11附录A –推荐编辑器的默认配置修改 (46)11.1K EIL U V ISION5默认配置修改 (46)1 文档概述1.1 关于本文档本文档规范了芜湖天人智能有限公司嵌入式软件部软件代码的书写规范和原则。
本文档仅供公司内部员工使用。
公司机密,严禁外传。
本文档中各规则的格式如下:【规则编号】 [规则内容] [[标记]]其中[标记]的含义如下:(必须):表示该条规则是必须遵守的。
(建议):表示该条规则是建议遵守的。
(可选)或没有标记:表示该条规则是可选择遵守的。
本文档的示例中,如有使用“//”,并非代码注释,而是文档的注释(有可能是文档中对代码注释的解释)。
1.2 参考文献[1]高质量C++编程[2]Effective C++[3]More Effective C++[4]C++ Primer[5]Thinking in C++2 排版● 【规则 2-1】程序块要采用缩进风格编写,缩进的空格数为4个,对齐使用空格键,不得使用TAB 键。
[必须]嵌入式软件开发的代码编辑器,推荐使用Keil uVision5,编辑器参数设置见附录A 。
●【规则 2-2】相对独立的程序块之间、变量说明之后必须加空行。
[必须]示例:● 【规则 2-3】较长的语句(>80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读。
[必须]示例:● 【规则 2-4】循环、判断等语句中若有较长的表达式或语句,则要进行适当的分行,长表达式要在低优先级操作符处划分新行,操作符放在行尾。
[必须]示例:●【规则 2-5】若函数的参数较长,则要进行适当的分行。
[必须]示例:●【规则 2-6】不允许把多个短语句写在一行中,即一行只写一条语句。
[必须]示例:● 【规则 2-7】if 、for 、do 、while、case 、switch 、default 等语句自占一行,且if 、for 、do 、while 等语句的执行语句部分无论多少都要加括号{}。
[必须]示例:● 【规则 2-8】在比较表达式中,如果有常量,尽量把常量放在前面。
[建议]这样,万一不小心把“==”误敲成“=”,就会通不过翻译,不致引起难查的问题。
● 【规则 2-9】程序块的分界符(如C/C++语言的大括号‘{’和‘}’)应各独占一行并且位于同一列,同时与引用它们的语句左对齐。
在函数体的开始、类的定义、结构的定义、枚举的定义以及if 、for 、do 、while 、switch 、case 语句中的程序都要采用如上的缩进方式。
[建议]示例:本规则的特例见2-7的说明部分。
【规则 2-10】在两个以上的关键字、变量、常量进行对等操作时,它们之间的操作符之前、之后或者前后要加空格;进行非对等操作时,如果是关系密切的立即操作符(如->),后不应加空格。
[必须]说明:采用这种松散方式编写代码的目的是使代码更加清晰。
由于留空格所产生的清晰性是相对的,所以,在已经非常清晰的语句中没有必要再留空格,如果语句已足够清晰则括号内侧(即左括号后面和右括号前面)不需要加空格,多重括号间不必加空格,因为在C/C++语言中括号已经是最清晰的标志了。
在长语句中,如果需要加的空格非常多,那么应该保持整体清晰,而在局部不加空格。
给操作符留空格时不要连续留两个以上空格。
示例:【规则 2-10-1】逗号、分号只在后面加空格。
int a, b, c;【规则 2-10-2】比较操作符, 赋值操作符"="、 "+=",算术操作符"+"、"%",逻辑操作符"&&"、"&",位域操作符"<<"、"^"等双目操作符的前后加空格。
if (currentTime >= MAX_TIME_VALUE)a =b + c;a *= 2;a =b ^ 2;【规则 2-10-3】"!"、"~"、"++"、"--"、"&"(地址运算符)等单目操作符前后不加空格。
*p = 'a'; // 内容操作"*"与内容之间flag = !isEmpty; // 非操作"!"与内容之间p = &mem; // 地址操作"&" 与内容之间i++; // "++","--"与内容之间【规则 2-10-4】"->"、"."前后不加空格。
p->id = pid; // "->"指针前后不加空格【规则 2-10-5】if、for、while、switch等与后面的括号间应加空格,使if等关键字更为突出、明显。
if ((a >= b) && (c > d))3 注释●【规则 3-1】一般情况下,源程序有效注释量必须在20%以上(建议20-30%)。
[必须]说明:注释的原则是有助于对程序的阅读理解,在该加的地方都加了,注释不宜太多也不能太少,注释语言必须准确、易懂、简洁。
●【规则 3-2】C代码不得使用C++的注释语法“//”,必须使用/*….*/。
[建议]注:本文档的示例中,如有使用“//”,并非代码注释,而是文档的注释(有可能是文档中对代码注释的解释)。
●【规则 3-3】说明性文件(如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等)头部应进行注释,注释必须列出:版权说明、模块名、文件名、作者、内容介绍、修改日志等,头文件的注释中还应有函数功能简要说明。
[必须]头文件模板示例:【规则 3-3-1】注:使用git在commit代码时填写充分、准确的message。
[必须]【规则 3-3-2】为了防止头文件被重复引用,应当用#ifndef/#define/#endif结构产生预处理块。
[必须] 【规则 3-3-3】用 #include <filename.h> 格式来引用标准库的头文件(编译器将从标准库目录开始搜索)。
[必须]【规则 3-3-4】用 #include “filename.h”格式来引用非标准库的头文件(编译器将从用户的工作目录开始搜索)。
[必须]【规则 3-3-5】头文件中只存放“声明”而不存放“定义”。
(建议将成员函数的定义与声明分开,不论该函数体有多么小。
)[必须]【规则 3-4】源文件头部应进行注释,列出:版权说明、版本号、作者、模块目的/功能、主要函数及其功能、修改日志等。
[必须]源文件模板示例:【规则 3-4-1】注:使用git在commit代码时填写充分、准确的message。
[必须]【规则 3-5】函数头部应进行注释,列出:函数的目的/功能、输入参数、输出参数、返回值、调用关系(函数、表)等。
[必须]函数注释模板示例:【规则 3-5-1】外部函数必须有函数头注释。
[必须]【规则 3-5-2】内部函数强烈建议使用函数头注释。
[建议]●【规则 3-6】边写代码边注释,修改代码同时修改相应的注释,以保证注释与代码的一致性。
不再有用的注释要删除。
注释的格式尽量统一。
[必须]●【规则 3-7】注释的内容要清楚、明了,含义准确,防止注释二义性。
[建议]说明:错误的注释不但无益反而有害。
●【规则 3-8】避免在注释中使用缩写,特别是非常用缩写。
[建议]说明:在使用缩写时或之前,应对缩写进行必要的说明。
●【规则 3-9】注释应与其描述的代码相近,对代码的注释应放在其上方或右方(对单条语句的注释)相邻位置,不可放在下面;如放于上方则需与其上面的代码用空行隔开。
[必须]示例:如下例子不符合规范。
●【规则 3-10】对于所有有物理含义的变量、常量,如果其命名不是充分自注释的,在声明时都必须加以注释,说明其物理含义。
变量、常量、宏的注释应放在其上方相邻位置或右方。
[必须]示例:●【规则 3-11】数据结构声明(包括数组、结构、类、枚举等),如果其命名不是充分自注释的,必须加以注释。
对数据结构的注释应放在其上方相邻位置,不可放在下面;对结构中的每个域的注释放在此域的右方。
[必须]示例:可按如下形式说明枚举/数据/联合结构。
●【规则 3-12】全局变量要有较详细的注释,包括对其功能、取值范围、哪些函数或过程存取它以及存取时注意事项等的说明。
[必须]示例:●【规则 3-13】代码中的特殊处理,或者软件改变方案,必须加注释,注明为何要这样做。
[必须]说明:只有加了注释,以后的维护者才有可能明白前因后果。
●【规则 3-14】注释与所描述内容进行同样的缩排。
[必须]说明:可使程序排版整齐,并方便注释的阅读与理解。
● 【规则 3-15】将注释与其上面的代码用空行隔开。
[必须]示例:● 【规则 3-16】对变量的定义和分支语句(条件分支、循环语句等)必须编写注释。
[建议]说明:这些语句往往是程序实现某一特定功能的关键,对于维护人员来说,良好的注释帮助更好的理解程序。
● 【规则 3-17】对于switch 语句下的case 语句,如果因为特殊情况需要处理完一个case 后进入下一个case 处理,必须在该case 语句处理完、下一个case语句前加上明确的注释。
[必须]说明:这样比较清楚程序编写者的意图,有效防止无故遗漏break 语句。
示例(注意斜体加粗部分):● 【规则 3-18】避免在一行代码或表达式的中间插入注释。
[必须]说明:除非必要(如PC-LINT 的行禁止检查标记),不应在代码或表达中间插入注释,否则容易使代码可理解性变差。
●【规则 3-19】通过对函数或过程、变量、结构等正确的命名以及合理地组织代码的结构,使代码成为自注释的。
[建议]说明:清晰准确的函数、变量等的命名,可增加代码可读性,并减少不必要的注释。