Embedded Unit

最新推荐文章于 2023-11-27 08:20:52 发布
最新推荐文章于 2023-11-27 08:20:52 发布
阅读量1.7k 收藏 3
点赞数
分类专栏： Linux

一、Embedded Unit 简介

　　Embedded Unit（简称embUnit）是一个针对嵌入式C系统的单元测试框架。它不依赖于标准的C函数库，所有的对象都被静态编译链接。因此，可以比较方便地将其移植到嵌入式平台。

　　下载地址：http://sourceforge.net/projects/embunit/files/

【备注】：Embedded Unit测试原理是通过将预期值与实际值进行比较来测试函数的逻辑，只能实现函数级别的单元测试而已，呵呵。

二、目标平台简介

　　硬件平台：PowerPC

　　操作系统：基于uclinux内核，但是所有系统调用都自己实现的一个精简操作系统；

三、移植思路

  1. 由于embUnit不依赖于标准的C函数库，因此，将我们的编译选项添加到embUnit中的Makefile中，将其代码编译成一个静态库，然后链接到我们原有的程序中；
  2. 额外创建一个源文件，用于编写测试代码，该文件也通过编译、链接，将其与原有的程序链接在一起；
  3. 在原有程序的main中（即程序入口处），调用embUnit这个框架提供的API函数，执行对函数的单元测试；

四、实战步骤

1.　下载的embUnit的源代码解压后，在解压形成的目录里面有一个embunit目录，这个目录就是embUnit的源代码所在的目录，首先我们分析这个目录下的makefile文件，文件内容如下：

View makefile
复制代码 
CC = gcc
CFLAGS = -O
AR = ar
ARFLAGS = ru
RANLIB = ranlib
RM = rm
OUTPUT = ../lib/
TARGET = libembUnit.a
OBJS = AssertImpl.o RepeatedTest.o stdImpl.o TestCaller.o TestCase.o TestResult.o TestRunner.o TestSuite.o

all: $(TARGET)

$(TARGET): $(OBJS)
    $(AR) $(ARFLAGS) $(OUTPUT)$@ $(OBJS)
    $(RANLIB) $(OUTPUT)$@

.c.o:
    $(CC) $(CFLAGS) $(INCLUDES) -c $<

AssertImpl.o: AssertImpl.h stdImpl.h
RepeatedTest.o: RepeatedTest.h Test.h
stdImpl.o: stdImpl.h
TestCaller.o: TestCaller.h TestResult.h TestListener.h TestCase.h Test.h
TestCase.o: TestCase.h TestResult.h TestListener.h Test.h
TestResult.o: TestResult.h TestListener.h Test.h
TestRunner.o: TestRunner.h TestResult.h TestListener.h Test.h stdImpl.h config.h
TestSuite.o: TestSuite.h TestResult.h TestListener.h Test.h

clean:
    -$(RM) $(OBJS) $(TARGET)

.PHONY: clean all
复制代码

分析可知，这个makefile会将当前目录下的源文件编译和链接成一个名为libembUnit.a的静态库文件。然后，我们只要修改相应的编译选项，去掉不用的选项，下面是修改的Makefile：

View Makefile
复制代码 
include ../build/common.mk

.c.o:
    $(CC) $(CFLAGS) -c -o $*.o $<


embu_OBJS = AssertImpl.o RepeatedTest.o stdImpl.o TestCaller.o TestCase.o TestResult.o TestRunner.o TestSuite.o
embu_DIR = ../object/common/
TARGET = libembUnit.a

all: $(TARGET)

$(TARGET): $(embu_OBJS)
    $(AR) $(ARFLAGS) $(TARGET) $(embu_OBJS)
    cp -f $(TARGET) $(embu_DIR)

.c.o:
    $(CC) $(CFLAGS) $(INCLUDES) -c $<

AssertImpl.o: AssertImpl.h stdImpl.h
RepeatedTest.o: RepeatedTest.h Test.h
stdImpl.o: stdImpl.h
TestCaller.o: TestCaller.h TestResult.h TestListener.h TestCase.h Test.h
TestCase.o: TestCase.h TestResult.h TestListener.h Test.h
TestResult.o: TestResult.h TestListener.h Test.h
TestRunner.o: TestRunner.h TestResult.h TestListener.h Test.h stdImpl.h config.h
TestSuite.o: TestSuite.h TestResult.h TestListener.h Test.h

clean:
    -rm -f *.o *.a 

.PHONY: clean all
复制代码

仔细分析，修改的内容就是将编译选项修改了，然后将生成的libembUnit.a文件复制到一个公共目录下；

【备注】其中../build/common.mk文件是我们源程序中公共选项脚本文件，里面定义了编译和链接的一些选项而已，呵呵

2.　修改完Makefile后，如果编译，会提示stdio.h这个头文件找不到。原因是embUnit的源代码中的config.h这个文件include了<stdio.h>这个C库文件，而由于我们的操作系统完全自己实现，并且没有提供stdio.h这个头文件，因此，将其注释掉即可；然后再执行make，就可以编译通过了，虽然会有一些警告，不过可以忽略；

3.　书写测试代码

View Code
复制代码 
/* include local files */

/* include embUnit include */
#include "../embUnit/embUnit.h"
#include "../embUnit/AssertImpl.h"
#include "../embUnit/config.h"
#include "../embUnit/HelperMacro.h"
#include "../embUnit/RepeatedTest.h"
#include "../embUnit/stdImpl.h"
#include "../embUnit/Test.h"
#include "../embUnit/TestCaller.h"
#include "../embUnit/TestCase.h"
#include "../embUnit/TestListener.h"
#include "../embUnit/TestResult.h"
#include "../embUnit/TestRunner.h"
#include "../embUnit/TestSuite.h"

#include "../rts_include/test.h"

int iFile = -1;

static void setUp(void)
{
    /* initialize */
    iFile = open("testFile.txt", O_WRONLY|O_CREAT|O_APPEND|O_NAND);
}

static void tearDown(void)
{
    /* terminate */
    close(iFile);
}

static void testFile(void)
{
    char buff[4] = "abcd";
    TEST_ASSERT_EQUAL_INT(6, write(iFile, buff, 4));
}

/*embunit:impl=+ */
/*embunit:impl=- */
TestRef testFile_tests(void)
{
    EMB_UNIT_TESTFIXTURES(fixtures) {
        /*embunit:fixtures=+ */
        /*embunit:fixtures=- */
        new_TestFixture("testFile", testFile),
    };
    EMB_UNIT_TESTCALLER(test,"test",setUp,tearDown,fixtures);
    return (TestRef)&test;
};
复制代码

首先注意测试代码一方面要引用embUnit的头文件，另一方面也要引用原有程序相应的头文件，这样才能既使用embUnit提供的API函数，又能使用原有程序提供的接口函数；

上述代码的解释如下：

  • 上述代码的目标是对write函数进行测试，方法就是先open一个文件，然后写入固定的字节，判断写入的字节数是否正确，最后关闭文件。
  • setUp函数的作用是：提供待测试函数的前端输入。譬如，上述代码要测试write函数，必须要先用open打开一个文件，那么就可以在setUp这个函数中调用open函数去创建要write的文件；
  • tearDown函数的作用是：提供待测试函数的后端处理。譬如，上述代码，写入文件后，要关闭文件，那么就可以在tearDown这个函数调用close函数关闭文件；
  • testFile函数（函数名其实可以自己定义）的作用是：提供测试逻辑。譬如，上述代码，调用embUnit提供的断言宏，进行判断write函数是否执行成功。
  • testFile_tests函数的作用是：将上述几个函数整合到一个测试suite中，以供后续程序调用；

对测试代码编译（仍然采用目标平台的编译选项进行编译），使其生成的.a（如test.a）文件，并将.a文件复制到公共的库文件目录下；

4.　在原有函数的入口出执行测试程序

代码如下：

View Code
复制代码 
#include "../embUnit/embUnit.h"
#include "../embUnit/AssertImpl.h"
#include "../embUnit/config.h"
#include "../embUnit/HelperMacro.h"
#include "../embUnit/RepeatedTest.h"
#include "../embUnit/stdImpl.h"
#include "../embUnit/Test.h"
#include "../embUnit/TestCaller.h"
#include "../embUnit/TestCase.h"
#include "../embUnit/TestListener.h"
#include "../embUnit/TestResult.h"
#include "../embUnit/TestRunner.h"
#include "../embUnit/TestSuite.h"

void main(void)
{
    printf("***********************************************************\n");
    printf("**************      Unit Test Start         ***************\n");
    printf("***********************************************************\n");

    /* 将测试结果按照编译格式输出 */
    TestRunner_start();
    TestRunner_runTest(testFile_tests());
    TestRunner_end();

    printf("***********************************************************\n");
    printf("**************       Unit Test End          ***************\n");
    printf("***********************************************************\n");
}
复制代码

在上述代码中，可以看到语句TestRunner_runTest(testFile_tests());调用的就是在测试代码中声明的testFile_tests函数；
需要的注意的是，在该程序中也要引用embUnit提供的头文件，否则无法编译通过。

5.　将上述代码也编译成.a文件，并且与刚才编译生成的libembUnit.a和test.a文件，以及原有程序的其他.a文件链接一个可执行文件，并将其烧录到目标机器中，然后即可看到运行结果。下图是本人的运行结果：

由于写入的是4个字节，但是测试代码的预期值是6个字节，因此，测试没有通过。

到此，整个移植过程结束。不过，上述测试结果显示，不是那么友好，很幸运的是embUnit提供的源码中还有一个格式化测试结果的工具的源代码，我们就照葫芦画瓢将这个工具也移植过来；

五、移植embUnit的格式化测试结果工具

在刚才下载的压缩包解压后的根目录下有个textui的目录，这个目录提供的就是格式化测试结果的工具的源代码，移植的方法与上面类似，现简介如下：

1.　修改makefile

textui原有的makefile如下所示：

View makefile
复制代码 
CC = gcc
CFLAGS = -O
INCLUDES = ..
LIBS = ../lib
AR = ar
ARFLAGS = ru
RANLIB = ranlib
RM = rm
OUTPUT = ../lib/
TARGET = libtextui.a
OBJS = TextUIRunner.o XMLOutputter.o TextOutputter.o CompilerOutputter.o

all: $(TARGET)

$(TARGET): $(OBJS)
    $(AR) $(ARFLAGS) $(OUTPUT)$@ $(OBJS)
    $(RANLIB) $(OUTPUT)$@

.c.o:
    $(CC) $(CFLAGS) -I$(INCLUDES) -c $<

TextUIRunner.o: TextUIRunner.h XMLOutputter.h TextOutputter.h CompilerOutputter.h Outputter.h
XMLOutputter.o: XMLOutputter.h Outputter.h
TextOutputter.o: TextOutputter.h Outputter.h
CompilerOutputter.o: CompilerOutputter.h Outputter.h

clean:
    -$(RM) $(TARGET) $(OBJS)

.PHONY: clean all
复制代码

很明显，原有的makefile是将所有的源文件编译生成一个libtextui.a的文件，现将这个makefile修改如下：

View Makefile

与前述一样，只是修改的编译选项，并且将生成的libtextui.a文件复制到一个公共的目录下；

2.　编译textui

　　修改完Makefile文件后，此时编译会提示：stdout未定义；

　　原因是：textui中使用了fprintf将信息输出的stdout（即标准输出，一般指屏幕），但是我们的目标机不支持显示器等标准输出，也没有对stdout进行定义。

　　解决办法是：在Outputter.h文件中，重新定义printf，即，忽略stdout，使用printf代替fprintf，具体如下所示：

#define fprintf(stdout, formats, args...)    printf(formats, ##args)

　　解决上述问题后，编译时，仍然会提示错误，主要是头文件找不到的错误；

　　原因是：在textui的源文件中，需要引用embUnit的头文件，但是其采用的是#include <>方式，当然找不到对应的头文件了；

　　解决办法：我们将这些头文件的引用方式改为#include " "方式，并且指明对应头文件的相对路径；

3.　修改在程序入口处的调用测试程序的代码，具体如下所示：

View Code
复制代码 
void main(void)
{

    printf("***********************************************************\n");
    printf("**************      Unit Test Start         ***************\n");
    printf("***********************************************************\n");

    /* 将测试结果按照编译格式输出 */
    TestRunner_start();
    TestRunner_runTest(testFile_tests());
    TestRunner_end();

    /* 将测试结果按文本格式输出 */
    TextUIRunner_setOutputter(TextOutputter_outputter());
    TextUIRunner_start();
    TextUIRunner_runTest(testFile_tests());
    TextUIRunner_end();

    /* 将测试结果按照XML格式输出 */
    TextUIRunner_setOutputter(XMLOutputter_outputter());
    TextUIRunner_start();
    TextUIRunner_runTest(testFile_tests());
    TextUIRunner_end();

    printf("***********************************************************\n");
    printf("**************       Unit Test End          ***************\n");
    printf("***********************************************************\n");

}
复制代码

　　从上述代码可知，注册了两种测试结果输出方式：TextUIRunner_setOutputter(TextOutputter_outputter()); TextUIRunner_setOutputter(XMLOutputter_outputter());

4.　全编译所有代码，并链接成可执行程序，烧到目标机器上，即可看到测试结果，下图就是测试结果：

 到此，整个移植过程结束。

六、经验总结

  1. 不同平台间的代码移植原理其实很简单，就是将待移植的代码使用目标平台的编译环境进行编译，然后将其链接到原有的程序中；
  2. 待移植的代码一般会使用#include<>方式引用头文件，因此，移植的时候需要修改待移植程序的源文件的关于头文件引用方式；
  3. 待移植的代码还可能会使用一些目标平台不支持的API函数或这系统调用，因此，移植的时候应该重新封装这些接口；
  4. 尽量将待移植的代码独立成一个单独的模块，以静态库的方式链接到原有程序中，以便在不需要这些东东的时候，只要不链接其静态库即可；


参考资料：

[1].http://embunit.sourceforge.net/


转载：http://www.cnblogs.com/cnpirate/archive/2012/09/27/2704548.html


panfengsoftware
关注
专栏目录
C语言单元测试框架--EmbedUnit
weixin_30349597的博客
06-24 341
1、简介 Embedded Unit是个纯标准c构建的单元测试框架，主要用在嵌入式c的单体测试上，其主要特点是不依赖于任何C的标准库，所有的对象都是静态分配。 最早这个项目托管在SourceForge上（https://sourceforge.net/projects/embunit），目前在GitHub也有多个拷贝。 2、框架剖析 2.1 断言 #define TEST_ASSE...
Embedded Unit-开源
07-01
Embedded Unit 是嵌入式 C 系统的单元测试框架。 它的设计是从 JUnit 和 CUnit 等复制而来的，然后针对嵌入式 C 系统进行了一些调整。 嵌入式单元不需要标准 C 库。 所有对象都分配到常量区。
移植Embedded Unit到PowperPC平台
weixin_30399797的博客
09-27 126
一、Embedded Unit 简介 　　Embedded Unit（简称embUnit）是一个针对嵌入式C系统的单元测试框架。它不依赖于标准的C函数库，所有的对象都被静态编译链接。因此，可以比较方便地将其移植到嵌入式平台。 　　下载地址：http://sourceforge.net/projects/embunit/files/ 【备注】：Embedded Unit测试原理是通过将预期值与...
C语言单元测试embUnit入门学习
roger_lu_的博客
06-26 883
以前一直从事底层驱动和应用开发，这几年中一直从事应用开发，采用C++去实现，最近由于工作原因，需要用C语言进行产品开发，想找一个c语言的单元测试框架，网上找了一个embUnit，这个库不依赖于标准库，方便进行移植，可以在嵌入式和PC上运行。在看代码的过程中，发现这个库的C语言编写，采用了类似C++面向对象的编程，面向对象C++上还算比较熟悉，但C实现还需要补补。由此便有了两个目标。1）学习该开源库的c语言面向对象编程以及其编程习惯2）学习embUnit，做为后面工作c语言单元测试框架下面只是自己对简单的c语
你写的程序很健壮？不妨测一下？
最新发布
嵌入式Linux
11-27 86
这是一篇测试相关的笔记。我们软件开发最终都离不开测试的，可以通过测试来发现很多问题。在这之前先扯谈一波：在这给还没找工作的朋友提个醒，能找开发的职位就别找测试的职位，除非你真的很喜欢测试。亲身经历，做测试很不好受。测试其实有两类，一种是自己去测自己测的东西，另一种是去测别人做的东西。如果是第一种，我也很愿意做，因为我们本质上还是开发工程师，大概80%的工作时间在做开发，20%的工作时间在测自己开发...
Embedded Coder Support Package for AUTOSAR Standard
06-27
2. **代码生成**：Embedded Coder能够根据配置自动生成符合AUTOSAR的C源码和头文件，这些代码可以直接用于ECU（Electronic Control Unit）的编程。 3. **RTE集成**：支持包会生成RTE配置信息，帮助建立应用软件与...
postgresql-embedded,嵌入式PostgreSQL服务器.zip
10-14
在【unittests】中使用嵌入式PostgreSQL服务器，可以方便地进行数据库相关的测试，因为无需安装或配置额外的服务器实例，同时也避免了测试环境与生产环境间的差异问题。 PostgreSQL是一个功能强大的【开源关系型...
September 2018_ Testing Embedded Systems - Embedded Artistry.pdf
03-15
流行测试framework比较 September 2018: Testing Embedded Systems ...1. Unit testing 2. Debugger-based testing using metal.test 3. Phil Koopman’s lectures on embedded software quality and testing
How+to+Use+Ceedling+for+Embedded+Test-Driven+Development.pdf
03-08
This guide contains step-by-step examples to get you started test driving in C, especially for embedded software applications. We'll look at how to use the unit test framework called Ceedling to help...
STM32 | 分享几个开源的测试框架
嵌入式大杂烩
01-19 8932
这是一篇测试相关的笔记。我们软件开发最终都离不开测试的，可以通过测试来发现很多问题。在这之前先扯谈一波： 在这给还没找工作的朋友提个醒，能找开发的职位就别找测试的职位，除非你真的很喜欢测试。亲身经历，做测试很不好受。测试其实有两类，一种是自己去测自己测的东西，另一种是去测别人做的东西。如果是第一种，我倒是很愿意做，因为我们本质上还是开发工程师，大概80%的工作时间在做开发，20%的工作时间在测自己...
OMPL138及U-Boot的启动过程分析（三）
j00362的博客
11-27 1707
本篇正式从U-Boot开始，其中对很多硬件还不是很理解，许多部分不一定分析的准确，希望在以后的工作中能够解决。 U-Boot版本： VERSION = 2012 PATCHLEVEL = 04 SUBLEVEL = 01 EXTRAVERSION = 编译U-Boot所执行的命令是make ompl138_config
在unit test代码中控制embedded glassfish的启动
koen
06-10 139
以前做的一个例子，记录在这里作为备忘。   先看代码：   /* * To change this template, choose Tools | Templates * and open the template in the editor. */ package net.test.standby; import java.io.BufferedReader; i...
C语言单元测试框架详解：第二篇
魏波
03-24 5121
目录 前言 Check框架 1、Check框架特点 2、Check框架使用 前言 常见C语言单元测试框架有： 1、Check 2、Gtest（Google Test） 3、CuTest 4、Cunit 5、CppUTest（Microsoft Cppunittest） 6、C++Test 7、Cmocka 8、Criterion Check框架 今天给大家介绍C语言单元测试框架：Check check官网：Check | Unit testing framework for C .
Cunit在嵌入式平台上的移植（STM32）
weixin_38177846的博客
10-27 2834
前言 最近在公司为新开发的bluetooth chip写driver，根据流程在做integrate test之前要先为自己的模块做unit test。之前也从没写过unit test，查了很多资料，发现现有比较通用的unit test 框架都是为C++，java，python等写的，基本没看到有用于C语言的。最后找到一个比较合适的cunit 测试框架，但它是用于windows平台的C测试框架，所...
C语言单元测试框架详解：第一篇
魏波
03-24 6432
目录 一、单元测试定义 二、C语言单元测试框架汇总 一、单元测试定义 单元测试是指对软件中的最小可测试单元进行检查和验证，如C语言中单元指一个函数，Java里单元指一个类。单元测试像一个古董，时间越久价值越大。 二、C语言单元测试框架汇总 不同编程语言的测试框架不同，C语言常见单元测试框架有： 1、Check 2、Gtest（Google Test） 3、CuTest 4、Cunit 5、CppUTest（Microsoft Cppunittest） 6、C++Test
随想录（单元测试）
java开发指南博客 【转载】
04-15 122
【 声明：版权所有，欢迎转载，请勿用于商业用途。 联系信箱：feixiaoxing @163.com】 很长时间以来，自己就想写一篇关于单元测试的文章。但是由于自己在某些方面思考得不是很成熟，再加上前一段时间稍微有点忙，所以这个事情就一直这样耽搁下来了。其实，朋友们在开发的时候都知道单元测试是个好东西，但是真正用于实践，并且在开发中一直保持下去的却是少数。虽然单元测试的框架很多，什么CU...
最新IAR Embedded Workbench for ARM 8.32.1安装指南
单片机（Microcontroller Unit，简称MCU）是一种集成电路芯片，它将计算机的中央处理单元（CPU）、随机存取存储器（RAM）、只读存储器（ROM）以及其他各种输入输出接口集成在单个芯片上。单片机能够执行特定的程序...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值