Unity测试入门(基于ESP-IDF)

主要参考资料:
ESP32 中的单元测试: https://docs.espressif.com/projects/esp-idf/zh_CN/stable/esp32/api-guides/unit-tests.html#id5
Throw The Switch团队的unity介绍: https://www.throwtheswitch.org/unity
一个简单好用的C语言单元测试框架-Unity: https://blog.csdn.net/qq_53221728/article/details/135676381

简介

ESP-IDF 提供以下方法测试软件。

  • 一种是基于目标的测试,该测试使用运行在 esp32 上的中央单元测试应用程序。这些测试使用的是基于 Unity的单元测试框架。通过把测试用例放在组件的 test 子目录,可以将其集成到 ESP-IDF 组件中。本文档主要介绍这种基于目标的测试方法。
  • 另一种是基于 Linux 主机的单元测试,其中所有硬件行为都通过 Mock 组件进行模拟。此测试方法目前仍在开发中,暂且只有一小部分ESP-IDF 组件支持 Mock,具体请参考 基于 Linux 主机的单元测试。

Unity是一个用于C语言的轻量级单元测试框架。它由Throw The Switch团队开发,旨在简化嵌入式系统的单元测试。单元测试中单元的含义,单元就是人为规定的最小的被测功能模块,如C语言中单元指一个函数,Java里单元指一个类,图形化的软件中可以指一个窗口或一个菜单等。在实际项目中,单元测试往往由开发人员完成。

ESP-IDF单元测试学习

编译单元测试程序

切换到 tools/unit-test-app 目录下进行配置和编译,unit-test-app 是一个IDF示例工程项目。

  • idf.py menuconfig - 配置单元测试程序。
  • idf.py -T all build - 编译单元测试程序,测试每个组件 test 子目录下的用例。
  • idf.py -T “xxx yyy” build - 编译单元测试程序,对以空格分隔的特定组件进行测试(如 idf.py -T heap build - 仅对 heap 组件目录下的单元测试程序进行编译)。
  • idf.py -T all -E “xxx yyy” build - 编译单元测试程序,测试除指定组件之外的所有组件(例如 idf.py
    -T all -E “ulp mbedtls” build - 编译所有的单元测试,不包括 ulp 和 mbedtls 组件。)。
  • idf.py flash - 烧写所有编译输出的文件。

由于 Windows 命令提示符固有限制,需使用以下语法来编译多个组件的单元测试程序:idf.py -T xxx -T yyy build 或者在 PowerShell 中使用 idf.py -T `“xxx yyy`” build,在 Windows 命令提示符中使用 idf.py -T ^“ssd1306 hts221^” build。

运行单元测试

Here is the test menu, pick your combo:
(1)     "esp_ota_begin() verifies arguments" [ota]
(2)     "esp_ota_get_next_update_partition logic" [ota]
(3)     "Verify bootloader image in flash" [bootloader_support]
(4)     "Verify unit test app image" [bootloader_support]
(5)     "can use new and delete" [cxx]
(6)     "can call virtual functions" [cxx]
(7)     "can use static initializers for non-POD types" [cxx]
(8)     "can use std::vector" [cxx]
(9)     "static initialization guards work as expected" [cxx]
(10)    "global initializers run in the correct order" [cxx]
(11)    "before scheduler has started, static initializers work correctly" [cxx]
(12)    "adc2 work with wifi" [adc]
(13)    "gpio master/slave test example" [ignore][misc][test_env=UT_T2_1][multi_device]
        (1)     "gpio_master_test"
        (2)     "gpio_slave_test"
(14)    "SPI Master clockdiv calculation routines" [spi]
(15)    "SPI Master test" [spi][ignore]
(16)    "SPI Master test, interaction of multiple devs" [spi][ignore]
(17)    "SPI Master no response when switch from host1 (SPI2) to host2 (SPI3)" [spi]
(18)    "SPI Master DMA test, TX and RX in different regions" [spi]
(19)    "SPI Master DMA test: length, start, not aligned" [spi]
(20)    "reset reason check for deepsleep" [esp32][test_env=UT_T2_1][multi_stage]
        (1)     "trigger_deepsleep"
        (2)     "check_deepsleep_reset_reason"

常规测试用例会打印用例名字和描述,主从测试用例还会打印子菜单(已注册的测试函数的名字)。
可以输入以下任意一项来运行测试用例:

  • 引号中写入测试用例的名字,运行单个测试用例。
  • 测试用例的序号,运行单个测试用例。
  • 方括号中的模块名字,运行指定模块所有的测试用例。
  • 星号,运行所有测试用例。

[multi_device] 和 [multi_stage]标签告诉测试运行者该用例是多设备测试还是多阶段测试。这些标签由 TEST_CASE_MULTIPLE_STAGES 和 TEST_CASE_MULTIPLE_DEVICES 宏自动生成。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值