[1] Google Test - Testowanie tablic

Ten krótki post chciałbym poświęcić na opisanie sposobu testowania tablic w projekcie Embedded.

Sposób przeprowadzenia testu:

Podczas przygotowywania ramek z danymi, które będą przesyłane np. za pomocą UART'a zachodzi konieczność sprawdzenia czy wszystkie dane są w odpowiednich miejscach i w odpowiedniej postaci.

Poniżej przedstawię tylko prostą testową procedurę, bez funkcji testowej.

1. #define _START_FRAME        0x01
2. #define _COMMAND_CODE       0x56
3. #define EXAMPLE_ARRAY_LENGTH 0x07
6. uint8_t testFuntrion(uint8_t *ptrToArray, uint8_t arraySize, uint8_t param1, uint8_t param2)
7. {
8.     /*
9.     *   Prepare array
10.     */
11.     return 0; //If parameters OK
12. }
14. TEST(ExampleArrayTest, prepResponseArray_ProperArray)
15. {
16.     uint8_t testArray[EXAMPLE_ARRAY_LENGTH] = { 0x00 };
17.     uint8_t functionTestReturnValue = 1;    //By Default set to error
19.     const uint8_t param1 = 5;
20.     const uint8_t param2 = 10;
21.     const uint8_t param1_ModifyRefValue = (param1 * 3) - 28;
22.     const uint8_t param2_ModifyRefValue = ((param2 * 5) - 3)/23;
23.     const uint8_t functionReturnValueExpexted = 0;
24.     const uint8_t referenceArray_HardCoded[EXAMPLE_ARRAY_LENGTH] = { _START_FRAME,
25.                                                                 EXAMPLE_ARRAY_LENGTH,
26.                                                                 _COMMAND_CODE,
27.                                                                 param1,
28.                                                                 param2,
29.                                                                 param1_ModifyRefValue,
30.                                                                 param2_ModifyRefValue };
31.     const uint8_t numberOfElementsToCheck = ((sizeof(referenceArray_HardCoded) / sizeof(referenceArray_HardCoded[0])));
34.     functionTestReturnValue = testFuntrion(&testArray[0],
35.                                             (sizeof(testArray)/sizeof(testArray[0])),
36.                                             param1,
37.                                             param2);
39.     ASSERT_EQ(functionReturnValueExpexted, functionTestReturnValue);
40.     ASSERT_THAT(std::vector<uint8_t>(referenceArray_HardCoded
41.                         ,referenceArray_HardCoded + numberOfElementsToCheck)
42.                         ,::testing::ElementsAreArray(testArray));
43. }

Dodatkowym atutem przy takim sprawdzaniu danych jest wyświetlenie informacji na których miejscach następuje rozbieżność w zadanych parametrach. Informacja z błędem będzie dotyczyła pierwszego parametru, który nie zgadza się z zadanym.

W przypadku pozytywnego rezultatu dostaniemy informację o powodzeniu testu:

Drugi sposób pozwalający na uzyskanie wiadomości z informacją błędnego elementu może wyglądać następująco:

1. for (uint8_t i = 0; i < numberOfElementsToCheck; i++)
2. {
3.     ASSERT_EQ(referenceBuffer[i], bufferToCheck[i])
4.             << "***********************\n"
5.             << "Error in element number: " << unsigned(i)
6.             << "\nActual Value is: " << unsigned(bufferToCheck[i])
7.             << "\nExpected Value is: " << unsigned(referenceBuffer[i]);
8. }

Tutaj wykonałem zwykłą pętlę for przechodzącą przez wszystkie elementy. W przypadku wystąpienia błędu pojawi się dokładna informacja który element jest zły oraz jego aktualne wartości.

Funkcję można wykorzystać do samego przygotowywania ramek, tak aby upewnić się, że przygotowaliśmy poprawne dane do przesłania, sprawdzanie zdekodowanych danych, przygotowywanie ramki z odpowiedzią, gdzie dodatkowo wykonuje się operację na podanych parametrach itp.