2023年01月09日 | 单片机开发中的C语言技巧（下）

4.防御性编程

嵌入式产品的可靠性自然与硬件密不可分，但在硬件确定、并且没有第三方测试的前提下，使用防御性编程思想写出的代码，往往具有更高的稳定性。

防御性编程首先需要认清C语言的种种缺陷和陷阱，C语言对于运行时的检查十分弱小，需要程序员谨慎的考虑代码，在必要的时候增加判断；防御性编程的另一个核心思想是假设代码运行在并不可靠的硬件上，外接干扰有可能会打乱程序执行顺序、更改RAM存储数据等等。

4.1具有形参的函数，需判断传递来的实参是否合法。

程序员可能无意识的传递了错误参数；外界的强干扰可能将传递的参数修改掉，或者使用随机参数意外的调用函数，因此在执行函数主体前，需要先确定实参是否合法。

1. int exam_fun( unsigned char *str )

2. {

3. if( str != NULL ) // 检查“假设指针不为空”这个条件

4. {

5. //正常处理代码

6. }

7. else

8. {

9. //处理错误代码

10. }

11. }

4.2仔细检查函数的返回值

对函数返回的错误码，要进行全面仔细处理，必要时做错误记录。

1. char *DoSomething(…)

2. {

3. char * p;

4. p=malloc(1024);

5. if(p==NULL) /*对函数返回值作出判断*/

6. {

7. UARTprintf(…); /*打印错误信息*/

8. return NULL;

9. }

10. retuen p;

11. }

4.3 防止指针越界

如果动态计算一个地址时，要保证被计算的地址是合理的并指向某个有意义的地方。特别对于指向一个结构或数组的内部的指针，当指针增加或者改变后仍然指向同一个结构或数组。

4.4 防止数组越界

数组越界的问题前文已经讲述的很多了，由于C不会对数组进行有效的检测，因此必须在应用中显式的检测数组越界问题。下面的例子可用于中断接收通讯数据。

1. #define REC_BUF_LEN 100

2. unsigned char RecBuf[REC_BUF_LEN];

3. //其它代码

4. void Uart_IRQHandler(void)

5. {

6. static RecCount=0; //接收数据长度计数器

7. //其它代码

8. if(RecCount< REC_BUF_LEN) //判断数组是否越界

9. {

10. RecBuf[RecCount]=…; //从硬件取数据

11. RecCount++;

12. //其它代码

13. }

14. else

15. {

16. //错误处理代码

17. }

18. //其它代码

19. }

在使用一些库函数时，同样需要对边界进行检查，比如下面的memset(RecBuf,0,len)函数把RecBuf指指向的内存区的前len个字节用0填充，如果不注意len的长度，就会将数组RecBuf之外的内存区清零：

1. #define REC_BUF_LEN 100

2. unsigned char RecBuf[REC_BUF_LEN];

3.

4. if(len< REC_BUF_LEN)

5. {

6. memset(RecBuf,0,len); //将数组RecBuf清零

7. }

8. else

9. {

10. //处理错误

11. }

4.5 数学算数运算

4.5.1除法运算，只检测除数为零就可靠吗？

除法运算前，检查除数是否为零几乎已经成为共识，但是仅检查除数是否为零就够了吗？

考虑两个整数相除，对于一个signed long类型变量，它能表示的数值范围为：-2147483648 ~+2147483647，如果让-2147483648/ -1，那么结果应该是+2147483648，但是这个结果已经超出了signedlong所能表示的范围了。所以，在这种情况下，除了要检测除数是否为零外，还要检测除法是否溢出。

1. #include

2. signed long sl1,sl2,result;

3. /*初始化sl1和sl2*/

4. if((sl2==0)||(sl1==LONG_MIN && sl2==-1))

5. {

6. //处理错误

7. }

8. else

9. {

10. result = sl1 / sl2;

11. }

4.5.2检测运算溢出

整数的加减乘运算都有可能发生溢出，在讨论未定义行为时，给出过一个有符号整形加法溢出判断代码，这里再给出一个无符号整形加法溢出判断代码段：

1. #include

2. unsigned int a,b,result;

3. /*初始化a，b*/

4. if(UINT_MAX-a

5. {

6. //处理溢出

7. }

8. else

9. {

10. result=a+b;

11. }

嵌入式硬件一般没有浮点处理器，浮点数运算在嵌入式也比较少见并且溢出判断严重依赖C库支持，这里不讨论。

4.5.3检测移位

在讨论未定义行为时，提到有符号数右移、移位的数量是负值或者大于操作数的位数都是未定义行为，也提到不对有符号数进行位操作，但要检测移位的数量是否大于操作数的位数。下面给出一个无符号整数左移检测代码段：

1. unsigned int ui1;

2. unsigned int ui2;

3. unsigned int uresult;

4.

5. /*初始化ui1,ui2*/

6. if(ui2>=sizeof(unsigned int)*CHAR_BIT)

7. {

8. //处理错误

9. }

10. else

11. {

12. uresult=ui1<

13. }

4.6如果有硬件看门狗，则使用它

在其它一切措施都失效的情况下，看门狗可能是最后的防线。它的原理特别简单，但却能大大提高设备的可靠性。如果设备有硬件看门狗，一定要为它编写驱动程序。

• 要尽可能早的开启看门狗

这是因为从上电复位结束到开启看门狗的这段时间内，设备有可能被干扰而跳过看门狗初始化程序，导致看门狗失效。尽可能早的开启看门狗，可以降低这种概率；

• 不要在中断中喂狗，除非有其他联动措施

在中断程序喂狗，由于干扰的存在，程序可能一直处于中断之中，这样会导致看门狗失效。如果在主程序中设置标志位，中断程序喂狗时与这个标志位联合判断，也是允许的；

• 喂狗间隔跟产品需求有关，并非特定的时间

产品的特性决定了喂狗间隔。对于不涉及安全性、实时性的设备，喂狗间隔比较宽松，但间隔时间不宜过长，否则被用户感知到，是影响用户体验的。对于设计安全性、有实时控制类的设备，原则是尽可能快的复位，否则会造成事故。

克莱门汀号在进行第二阶段的任务时，原本预订要从月球飞行到太空深处的Geographos小行星进行探勘，然而这艘太空探测器在飞向小行星时却由于一个软件缺陷而使其中断运作20分钟，不但未能到达小行星，也因为控制喷嘴燃烧了11分钟使电力供应降低，无法再透过远端控制探测器，最终结束这项任务，但也导致了资源与资金的浪费。

“克莱门汀太空任务失败这件事让我感到十分震惊，它其实可以透过硬件中一款简单的看门狗计时器避免掉这项意外，但由于当时的开发时间相当紧缩，程序设计人员没时间编写程序来启动它，”Ganssle说。

遗憾的是，1998年发射的近地号太空船(NEAR)也遇到了相同的问题。由于编程人员并未采纳建议，因此，当推进器减速器系统故障时，29公斤的储备燃料也随之报销──这同样是一个本来可经由看门狗定时器编程而避免的问题，同时也证明要从其他程序设计人员的错误中学习并不容易。

4.7关键数据储存多个备份，取数据采用“表决法”

RAM中的数据在受到干扰情况下有可能被改变，对于系统关键数据应该进行保护。关键数据包括全局变量、静态变量以及需要保护的数据区域。备份数据与原数据不应该处于相邻位置，因此不应由编译器默认分配备份数据位置，而应该由程序员指定区域存储。

可以将RAM分为3个区域，第一个区域保存原码，第二个区域保存反码，第三个区域保存异或码，区域之间预留一定量的“空白”RAM作为隔离。可以使用编译器的“分散加载”机制将变量分别存储在这些区域。需要进行读取时，同时读出3份数据并进行表决，取至少有两个相同的那个值。

假如设备的RAM从0x1000_0000开始，我需要在RAM的0x1000_0000~0x10007FFF内存储原码，在0x1000_9000~0x10009FFF内存储反码，在0x1000_B000~0x1000BFFF内存储0xAA的异或码，编译器的分散加载可以设置为：

1. LR_IROM1 0x00000000 0x00080000 { ; load region size_region

2. ER_IROM1 0x00000000 0x00080000 { ; load address = execution address

3. *.o (RESET, +First)

4. *(InRoot$$Sections)

5. .ANY (+RO)

6. }

7. RW_IRAM1 0x10000000 0x00008000 { ;保存原码

8. .ANY (+RW +ZI )

9. }

10.

11. RW_IRAM3 0x10009000 0x00001000{ ;保存反码

12. .ANY (MY_BK1)

13. }

14.

15. RW_IRAM2 0x1000B000 0x00001000 { ;保存异或码

16. .ANY (MY_BK2)

17. }

18. }

如果一个关键变量需要多处备份，可以按照下面方式定义变量，将三个变量分别指定到三个不连续的RAM区中，并在定义时按照原码、反码、0xAA的异或码进行初始化。

1. uint32 plc_pc=0; //原码

2. __attribute__((section("MY_BK1"))) uint32 plc_pc_not=~0x0; //反码

3. __attribute__((section("MY_BK2"))) uint32 plc_pc_xor=0x0^0xAAAAAAAA; //异或码

当需要写这个变量时，这三个位置都要更新；读取变量时，读取三个值做判断，取至少有两个相同的那个值。

为什么选取异或码而不是补码？这是因为MDK的整数是按照补码存储的，正数的补码与原码相同，在这种情况下，原码和补码是一致的，不但起不到冗余作用，反而对可靠性有害。比如存储的一个非零整数区因为干扰，RAM都被清零，由于原码和补码一致，按照3取2的“表决法”，会将干扰值0当做正确的数据。

4.8对非易失性存储器进行备份存储

非易失性存储器包括但不限于Flash、EEPROM、铁电。仅仅将写入非易失性存储器中的数据再读出校验是不够的。强干扰情况下可能导致非易失性存储器内的数据错误，在写非易失性存储器的期间系统掉电将导致数据丢失，因干扰导致程序跑飞到写非易失性存储器函数中，将导致数据存储紊乱。

一种可靠的办法是将非易失性存储器分成多个区，每个数据都将按照不同的形式写入到这些分区中，需要进行读取时，同时读出多份数据并进行表决，取相同数目较多的那个值。

4.9软件锁

对于初始化序列或者有一定先后顺序的函数调用，为了保证调用顺序或者确保每个函数都被调用，我们可以使用环环相扣，实质上这也是一种软件锁。此外对于一些安全关键代码语句（是语句，而不是函数），可以给它们设置软件锁，只有持有特定钥匙的，才可以访问这些关键代码。也可以通俗的理解为，关键安全代码不能按照单一条件执行，要额外的多设置一个标志。

比如，向Flash写一个数据，我们会判断数据是否合法、写入的地址是否合法，计算要写入的扇区。之后调用写Flash子程序，在这个子程序中，判断扇区地址是否合法、数据长度是否合法，之后就要将数据写入Flash。

由于写Flash语句是安全关键代码，所以程序给这些语句上锁：必须具有正确的钥匙才可以写Flash。这样即使是程序跑飞到写Flash子程序，也能大大降低误写的风险。

1. /****************************************************************************

2. * 名称：RamToFlash()

3. * 功能：复制RAM的数据到FLASH，命令代码51。

4. * 入口参数：dst 目标地址，即FLASH起始地址。以512字节为分界

5. * src 源地址，即RAM地址。地址必须字对齐

6. * no 复制字节个数，为512/1024/4096/8192

7. * ProgStart 软件锁标志

8. * 出口参数：IAP返回值(paramout缓冲区) CMD_SUCCESS,SRC_ADDR_ERROR,DST_ADDR_ERROR,

9. SRC_ADDR_NOT_MAPPED,DST_ADDR_NOT_MAPPED,COUNT_ERROR,BUSY,未选择扇区

10. ****************************************************************************/

11. void RamToFlash(uint32 dst, uint32 src, uint32 no,uint8 ProgStart)

12. {

13. PLC_ASSERT("Sector number",(dst>=0x00040000)&&(dst<=0x0007FFFF));

14. PLC_ASSERT("Copy bytes number is 512",(no==512));

15. PLC_ASSERT("ProgStart==0xA5",(ProgStart==0xA5));

16.

17. paramin[0] = IAP_RAMTOFLASH; // 设置命令字

18. paramin[1] = dst; // 设置参数

19. paramin[2] = src;

20. paramin[3] = no;

21. paramin[4] = Fcclk/1000;

22. if(ProgStart==0xA5) //只有软件锁标志正确时,才执行关键代码

23. {

24. iap_entry(paramin, paramout); // 调用IAP服务程序

25. ProgStart=0;

26. }

27. else

28. {

29. paramout[0]=PROG_UNSTART;

30. }

31. }

该程序段是编程lpc1778内部Flash，其中调用IAP程序的函数iap_entry(paramin, paramout)是关键安全代码，所以在执行该代码前，先判断一个特定设置的安全锁标志ProgStart，只有这个标志符合设定值，才会执行编程Flash操作。如果因为意外程序跑飞到该函数，由于ProgStart标志不正确，是不会对Flash进行编程的。

4.10通信

通讯线上的数据误码相对严重，通讯线越长，所处的环境越恶劣，误码会越严重。抛开硬件和环境的作用，我们的软件应能识别错误的通讯数据。对此有一些应用措施：

• 制定协议时，限制每帧的字节数；

每帧字节数越多，发生误码的可能性就越大，无效的数据也会越多。对此以太网规定每帧数据不大于1500字节，高可靠性的CAN收发器规定每帧数据不得多于8字节，对于RS485，基于RS485链路应用最广泛的Modbus协议一帧数据规定不超过256字节。因此，建议制定内部通讯协议时，使用RS485时规定每帧数据不超过256字节；

• 使用多种校验

编写程序时应使能奇偶校验，每帧超过16字节的应用，建议至少编写CRC16校验程序；

• 增加额外判断

1)增加缓冲区溢出判断。这是因为数据接收多是在中断中完成，编译器检测不出缓冲区是否溢出，需要手动检查，在上文介绍数据溢出一节中已经详细说明。

2)增加超时判断。当一帧数据接收到一半，长时间接收不到剩余数据，则认为这帧数据无效，重新开始接收。可选，跟不同的协议有关，但缓冲区溢出判断必须实现。这是因为对于需要帧头判断的协议，上位机可能发送完帧头后突然断电，重启后上位机是从新的帧开始发送的，但是下位机已经接收到了上次未发送完的帧头，所以上位机的这次帧头会被下位机当成正常数据接收。这有可能造成数据长度字段为一个很大的值，填满该长度的缓冲区需要相当多的数据（比如一帧可能1000字节），影响响应时间；另一方面，如果程序没有缓冲区溢出判断，那么缓冲区很可能溢出，后果是灾难性的。

• 重传机制

如果检测到通讯数据发生了错误，则要有重传机制重新发送出错的帧。

4.11开关量输入的检测、确认

开关量容易受到尖脉冲干扰，如果不进行滤除，可能会造成误动作。一般情况下，需要对开关量输入信号进行多次采样，并进行逻辑判断直到确认信号无误为止。

4.12开关量输出

开关信号简单的一次输出是不安全的，干扰信号可能会翻转开关量输出的状态。采取重复刷新输出可以有效防止电平的翻转。

4.13初始化信息的保存和恢复

微处理器的寄存器值也可能会因外界干扰而改变，外设初始化值需要在寄存器中长期保存，最容易被破坏。由于Flash中的数据相对不易被破坏，可以将初始化信息预先写入Flash，待程序空闲时比较与初始化相关的寄存器值是否被更改，如果发现非法更改则使用Flash中的值进行恢复。

公司目前使用的4.3寸LCD显示屏抗干扰能力一般。如果显示屏与控制器之间的排线距离过长或者对使用该显示屏的设备打静电或者脉冲群，显示屏有可能会花屏或者白屏。

对此，我们可以将初始化显示屏的数据保存在Flash中，程序运行后，每隔一段时间从显示屏的寄存器读出当前值和Flash存储的值相比较，如果发现两者不同，则重新初始化显示屏。下面给出校验源码，仅供参考。

定义数据结构：

1. typedef struct {

2. uint8_t lcd_command; //LCD寄存器

3. uint8_t lcd_get_value[8]; //初始化时写入寄存器的值

4. uint8_t lcd_value_num; //初始化时写入寄存器值的数目

5. }lcd_redu_list_struct;

定义const修饰的结构体变量，存储LCD部分寄存器的初始值，这个初始值跟具体的应用初始化有关，不一定是表中的数据，通常情况下，这个结构体变量被存储到Flash中。

1. /*LCD部分寄存器设置值列表*/

2. lcd_redu_list_struct const lcd_redu_list_str[]=

3. {

4. {SSD1963_Get_Address_Mode,{0x20} ,1}, /*1*/

5. {SSD1963_Get_Pll_Mn ,{0x3b,0x02,0x04} ,3}, /*2*/

6. {SSD1963_Get_Pll_Status ,{0x04} ,1}, /*3*/

7. {SSD1963_Get_Lcd_Mode ,{0x24,0x20,0x01,0xdf,0x01,0x0f,0x00} ,7}, /*4*/

8. {SSD1963_Get_Hori_Period ,{0x02,0x0c,0x00,0x2a,0x07,0x00,0x00,0x00},8}, /*5*/

9. {SSD1963_Get_Vert_Period ,{0x01,0x1d,0x00,0x0b,0x09,0x00,0x00} ,7}, /*6*/

10. {SSD1963_Get_Power_Mode ,{0x1c} ,1}, /*7*/

11. {SSD1963_Get_Display_Mode,{0x03} ,1}, /*8*/

12. {SSD1963_Get_Gpio_Conf ,{0x0F,0x01} ,2}, /*9*/

13. {SSD1963_Get_Lshift_Freq ,{0x00,0xb8} ,2}, /*10*/

14. };

实现函数如下所示，函数会遍历结构体变量中的每一个命令，以及每一个命令下的初始值，如果有一个不正确，则跳出循环，执行重新初始化和恢复措施。这个函数中的MY_DEBUGF宏是我自己的调试函数，使用串口打印调试信息，在接下来的第五部分将详细叙述。

通过这个函数，我可以长时间监控显示屏的哪些命令、哪些位容易被干扰。程序里使用了一个被妖魔化的关键字：goto。大多数C语言书籍对goto关键字谈之色变，但你应该有自己的判断。在函数内部跳出多重循环，除了goto关键字，又有哪种方法能如此简洁高效！

1. /**

2. * lcd 显示冗余

3. * 每隔一段时间调用该程序一次

4. */

5. void lcd_redu(void)

6. {

7. uint8_t tmp[8];

8. uint32_t i,j;

9. uint32_t lcd_init_flag;

10.

11. lcd_init_flag =0;

12. for(i=0;i

13. {

14. LCD_SendCommand(lcd_redu_list_str[i].lcd_command);

15. uyDelay(10);

16. for(j=0;j

17. {

18. tmp[j]=LCD_ReadData();

19. if(tmp[j]!=lcd_redu_list_str[i].lcd_get_value[j])

20. {

21. lcd_init_flag=0x55;

22. MY_DEBUGF(MENU_DEBUG,("读lcd寄存器值与预期不符,命令为:0x%x,第%d个参数,

23. 该参数正确值为:0x%x,实际读出值为:0x%xn",lcd_redu_list_str[i].lcd_command,j+1,

24. lcd_redu_list_str[i].lcd_get_value[j],tmp[j]));

25. goto handle_lcd_init;

26. }

27. }

28. }

29.

30. handle_lcd_init:

31. if(lcd_init_flag==0x55)

32. {

33. //重新初始化LCD

34. //一些必要的恢复措施

35. }

36. }

4.14陷阱

对于8051内核单片机，由于没有相应的硬件支持，可以用纯软件设置软件陷阱，用来拦截一些程序跑飞。对于ARM7或者Cortex-M系列单片机，硬件已经内建了多种异常，软件需要根据硬件异常来编写陷阱程序，用来快速定位甚至恢复错误。

4.15阻塞处理

有时候程序员会使用while(!flag);语句阻塞在此等待标志flag改变，比如串口发送时用来等待一字节数据发送完成。这样的代码时存在风险的，如果因为某些原因标志位一直不改变则会造成系统死机。

一个良好冗余的程序是设置一个超时定时器，超过一定时间后，强制程序退出while循环。

2003年8月11日发生的W32.Blaster.Worm蠕虫事件导致全球经济损失高达5亿美元，这个漏洞是利用了Windows分布式组件对象模型的远程过程调用接口中的一个逻辑缺陷：在调用GetMachineName()函数时，循环只设置了一个不充分的结束条件。

原代码简化如下所示：

1. HRESULT GetMachineName ( WCHAR *pwszPath,

2. WCHARwszMachineName[MAX_COMPUTTERNAME_LENGTH_FQDN+1])

3. {

4. WCHAR *pwszServerName = wszMachineName;

5. WCHAR *pwszTemp = pwszPath + 2;

6. while ( *pwszTemp != L’\’ ) /* 这句代码循环结束条件不充分 */

7. *pwszServerName++= *pwszTemp++;

8. /*… */

9. }

微软发布的安全补丁MS03-026解决了这个问题，为GetMachineName()函数设置了充分终止条件。一个解决代码简化如下所示（并非微软补丁代码）：