summaryrefslogtreecommitdiff
path: root/doc/develop
diff options
context:
space:
mode:
authorTom Rini <[email protected]>2025-11-22 08:44:38 -0600
committerTom Rini <[email protected]>2025-11-22 08:44:38 -0600
commit74c68b54977447e97b98b12c3ca7fe2a7f4a3803 (patch)
tree949504975745ed37bc3d60535b9ce17fb984c2d8 /doc/develop
parent2bc0715b558fa1ac5c88b11e250740b16a905837 (diff)
parentfff78d3bb25dc0c4b20b4ab9908cb355f5808178 (diff)
Merge tag 'efi-2026-01-rc3-2' of https://source.denx.de/u-boot/custodians/u-boot-efi
Pull request efi-2026-01-rc3-2 CIL https://source.denx.de/u-boot/custodians/u-boot-efi/-/pipelines/28454 Documentation: * board: ti: am6254atl_sk: correct value of PRELOADED_BL33_BASE * pytest: fix u-boot-test-flash typo * samsung: Fix PXE description for the E850-96 board * board: ti: k3: Update TI firmware repository URL to GitHub * add missing macro descriptions to include/test/ut.h and add it to the API documenation * rearrange the description of DM tests and describe return values Testing: * Enable CI testing ACPI on qemu-riscv64_smode_acpi_defconfig * Add qemu-riscv64_smode_defconfig to the CI tests * Generalize tests such that they can run on RISC-V QEMU - fdt_test_apply requires CONFIG_OF_LIBFDT_OVERLAY - cmd/fdt: do not assume RNG device exists - cmd/bdinfo: make no flash assumption - cmd/bdinfo: consider arch_print_bdinfo() output - common/print: do not use fixed buffer addresses - cmd/fdt: do not use fixed buffer addresses - raise CONFIG_CONSOLE_RECORD_OUT_SIZE default to 0x6000 * enable CONFIG_CONSOLE_RECORD=y on qemu-riscv64_smode_acpi # -----BEGIN PGP SIGNATURE----- # # iQIzBAABCAAdFiEEbcT5xx8ppvoGt20zxIHbvCwFGsQFAmkg1IsACgkQxIHbvCwF # GsQVLA//dmiApob+J9FUhD8joD+DaKSNfLYmv8zwfIFL2xRxx7D+CQT+r+I9FJYI # KojiLyn4PE/5VOm+wrsvAoYoMLJwAHvg5nmYJLLzvm6V//DLd1AEopP/+Uh8gEVW # xYGLcvDyGgZpraAhcmqRnAS89py3SigwGzhcUMbT6ZC6pgMVEsBpg8XeMpY7N05c # rwyqFAAPD8RcF7veQCpry87NiK5o+9YuM1zKl5sDFOpEWKq5ToNwhQ00bnux9lUd # HWz9X6ge58iFiMXRqUCnOaPeXeChn9ejyEiKtfQ0JtykOf9NT2WMdD2VKe9PCYsd # f7OynJTGG2OXTKBhon/xj75itiTm7EELc/FHwHEdtZIIHgpi/C33yQgKxLf9mtUo # Z7DKYpPoaTCbJhs9LCK942KPtshbtAJLKTVqyBPo7Jn0mneeCQUsbaQRU7JruJTK # hKluUjsAry3Do3wv/w6B8R6MMgfpBktPkqjg9e/maSdhYdkNAYpjajtORgpqmJRV # HTGJXfL3qFC50jlenlMYOm4Qake33MIMzubaxoM3j5ENDUJ7KAbWADEoWDpve8Tu # b/fX8uuW+g2T18Y/M9Bsk/jaUjDTx0xtZUSYNIIQJFDaJMzUxGYWlmtXhLZwFU8g # 7S5pBmgxoSAtQSMAeoJPJp9FSgXYqiGLUeSwcOH2NaPn0lLFvK0= # =D0Yy # -----END PGP SIGNATURE----- # gpg: Signature made Fri 21 Nov 2025 03:07:23 PM CST # gpg: using RSA key 6DC4F9C71F29A6FA06B76D33C481DBBC2C051AC4 # gpg: Good signature from "Heinrich Schuchardt <[email protected]>" [unknown] # gpg: aka "[jpeg image of size 1389]" [unknown] # gpg: WARNING: This key is not certified with a trusted signature! # gpg: There is no indication that the signature belongs to the owner. # Primary key fingerprint: 6DC4 F9C7 1F29 A6FA 06B7 6D33 C481 DBBC 2C05 1AC4
Diffstat (limited to 'doc/develop')
-rw-r--r--doc/develop/pytest/usage.rst2
-rw-r--r--doc/develop/tests_writing.rst63
2 files changed, 38 insertions, 27 deletions
diff --git a/doc/develop/pytest/usage.rst b/doc/develop/pytest/usage.rst
index 800a0323d0a..7335a39b963 100644
--- a/doc/develop/pytest/usage.rst
+++ b/doc/develop/pytest/usage.rst
@@ -392,7 +392,7 @@ to flash, pulsing the board's reset signal is likely all this script needs to
do. However, in some scenarios, this script may perform other actions. For
example, it may call out to some SoC- or board-specific vendor utility in order
to download the U-Boot binary directly into RAM and execute it. This would
-avoid the need for ``u-boot-test-flash1`` to actually write U-Boot to flash,
+avoid the need for ``u-boot-test-flash`` to actually write U-Boot to flash,
thus saving wear on the flash chip(s).
u-boot-test-release
diff --git a/doc/develop/tests_writing.rst b/doc/develop/tests_writing.rst
index 062194659b5..1a020caa411 100644
--- a/doc/develop/tests_writing.rst
+++ b/doc/develop/tests_writing.rst
@@ -206,8 +206,44 @@ 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]
+
+* A successful test returns 0.
+* A skipped test returns -EAGAIN.
+* Any other value signals a failure.
+
+Include ``test/ut.h`` defines a number of macros to check values and to return
+from the test function if the assertion fails. See :doc:`../api/test`
+for details.
+
+[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 +285,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
~~~~~~~~~~~~~~~~~~~~