unit_tests

See https://github.com/rusefi/rusefi/wiki/Dev-Quality-Control

TL, DR: just follow tests folder as examples. tests/nitrous_control is a great starting point!

gcc/makefile/gtest

1. Run make to build desktop binary, you can add -j4 | -j8 | -j16 for using multiple cores
2. Execute rusefi_test binary on your PC/Mac, it's expected to say SUCCESS and not fail :) Googletest will also print results summary.
3. To run only one test use command line like build/rusefi_test --gtest_filter=*TEST_NAME* uncomment and modify main.cpp line ::testing::GTEST_FLAG(filter)

In this folder we have rusEFI unit tests using https://github.com/google/googletest

Unit tests are not aware of ChibiOS or ARM or else, they are just plain C/C++ which you build for your desktop, not your MCU.

Note: If you're using VSCode, we have launch tasks available to debug your tests! see .vscode/launch.json "Debug Unit Tests (gdb)"

Code Coverage Report

for make the coverage locally you need to install gcovr

build the test with make COVERAGE=yes, run build/rusefi_test then finally unit_tests/ci_gcov.sh the report will be on unit_tests/gcov_working_area/gcov/index.html

See also https://github.com/rusefi/rusefi/wiki/Build-Server-and-Automation

Triggers Images

Trigger images generation is still a two-step manual process:

Step 1: Invoke unit_tests. One of the unit_tests artifacts is triggers.txt

Step 2: Once we have triggers.txt updated by unit_tests we can invoke firmware/gen_trigger_images.bat in order to generate actual trigger images.

Two-step TDD

We are trying to https://en.wikipedia.org/wiki/Test-driven_development

Ideal change happens as two commits:

• first we add coverage for current behaviour. In case of a defect we add green coverage confirming defect.
• second step would be change in production code alongside of change in coverage.

Testing 101

Basic Test Setup

TEST(ModuleName, TestDescription) {
    EngineTestHelper eth(engine_type_e::TEST_ENGINE);
    
    // Your test logic here
    ASSERT_EQ(expectedValue, actualValue);
}

Mocking Sensor Inputs

TEST(SensorModule, TestWithMockedSensor) {
    EngineTestHelper eth;
    
    // Mock sensor reading
    Sensor::setMockValue(SensorType::Clt, 80.0f);
    
    // Test logic using mocked sensor
    ASSERT_NEAR(80.0f, Sensor::get(SensorType::Clt), 0.1f);
}

Testing Time-Based Functions

TEST(TimeModule, TestWithTimeAdvance) {
    EngineTestHelper eth;
    
    // Advance virtual time
    eth.moveTimeForwardUs(1000); // Advance 1ms
    eth.moveTimeForwardMs(1); // Advance 1ms

    // Test time-dependent behavior
    // ...
}

Testing with Engine Module Mocks

TEST(ModuleInteraction, TestWithMockedModule) {
    EngineTestHelper eth(engine_type_e::TEST_ENGINE);

    MockIgnitionController ignController;

    EXPECT_CALL(ignController, getIgnState).WillRepeatedly(Return(true));

    engine->module<IgnitionController>().set(&ignController);
    EXPECT_TRUE(engine->module<IgnitionController>()->getIgnState());
}