mirrors/u-boot
1
0
Fork 0
mirror of https://source.denx.de/u-boot/u-boot.git synced 2025-12-20 17:01:50 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity

doc: make writing DM test subsection of writing C test

Browse Source 
A driver model test is just a special case of a C test.

Reviewed-by: Ilias Apalodimas <ilias.apalodimas@linaro.org>
Reviewed-by: Simon Glass <sjg@chromium.org>
Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
This commit is contained in:
Heinrich Schuchardt 2025-11-18 21:17:30 +01:00
parent a1f1a41b13
commit eb2d933a99
1 changed files with 29 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
doc/develop/tests_writing.rst
View File

@ -206,8 +206,36 @@ some common test tasks.
(there are also UEFI C tests in lib/efi_selftest/ not considered here.)
Add a C test to an existing suite
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Use this when you are adding to or modifying an existing feature outside driver
model. An example is bloblist.
Add a new function in the same file as the rest of the suite and register it
with the suite. For example, to add a new mem_search test::
/* Test 'ms' command with 32-bit values */
static int mem_test_ms_new_thing(struct unit_test_state *uts)
{
/* test code here */
return 0;
}
MEM_TEST(mem_test_ms_new_thing, UTF_CONSOLE);
Note that the MEM_TEST() macros is defined at the top of the file.
Example commit: 9fe064646d2 ("bloblist: Support relocating to a larger space") [1]
[1] https://gitlab.denx.de/u-boot/u-boot/-/commit/9fe064646d2
Add a new driver model test
~~~~~~~~~~~~~~~~~~~~~~~~~~~
'''''''''''''''''''''''''''
``dm`` is the test suite that contains C tests for U-boot
:doc:`Driver Model <driver-model/index>`.
Use this when adding a test for a new or existing uclass, adding new operations
or features to a uclass, adding new ofnode or dev_read_() functions, or anything
@ -249,31 +277,6 @@ Example commit: c48cb7ebfb4 ("sandbox: add ADC unit tests") [1]
[1] https://gitlab.denx.de/u-boot/u-boot/-/commit/c48cb7ebfb4
Add a C test to an existing suite
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Use this when you are adding to or modifying an existing feature outside driver
model. An example is bloblist.
Add a new function in the same file as the rest of the suite and register it
with the suite. For example, to add a new mem_search test::
/* Test 'ms' command with 32-bit values */
static int mem_test_ms_new_thing(struct unit_test_state *uts)
{
/* test code here */
return 0;
}
MEM_TEST(mem_test_ms_new_thing, UTF_CONSOLE);
Note that the MEM_TEST() macros is defined at the top of the file.
Example commit: 9fe064646d2 ("bloblist: Support relocating to a larger space") [1]
[1] https://gitlab.denx.de/u-boot/u-boot/-/commit/9fe064646d2
Add a new test suite
~~~~~~~~~~~~~~~~~~~~