[PATCH] bsp-howto: Add target hash chapter

Sebastian Huber sebastian.huber at embedded-brains.de
Wed Feb 24 13:12:27 UTC 2021

Update #4267.
 bsp-howto/index.rst       |  1 +
 bsp-howto/target-hash.rst | 17 +++++++++++++++++
 2 files changed, 18 insertions(+)
 create mode 100644 bsp-howto/target-hash.rst

diff --git a/bsp-howto/index.rst b/bsp-howto/index.rst
index e95c1b8..d095fc7 100644
--- a/bsp-howto/index.rst
+++ b/bsp-howto/index.rst
@@ -28,6 +28,7 @@ RTEMS BSP and Driver Guide (|version|).
+	target-hash
diff --git a/bsp-howto/target-hash.rst b/bsp-howto/target-hash.rst
new file mode 100644
index 0000000..bcb651b
--- /dev/null
+++ b/bsp-howto/target-hash.rst
@@ -0,0 +1,17 @@
+.. SPDX-License-Identifier: CC-BY-SA-4.0
+.. Copyright (C) 2021 embedded brains GmbH <rtems at embedded-brains.de>
+Target Hash
+Each BSP must provide an implementation of the :c:func:`rtems_get_target_hash`
+directive.  The
+`default implementation <https://git.rtems.org/rtems/tree/bsps/shared/start/gettargethash-default.c>`_
+is based on the CPU counter frequency.  A BSP-specific implementation may be
+provided which covers also for example the device tree, settings of the memory
+controller, processor and bus frequencies, a serial number of a chip, etc.  For
+a BSP-specific implementation start with the default implementation and add
+more values to the target hash using the functions :c:func:`_Hash_Add_data` and
+:c:func:`_Hash_Add_string`.  The target hash can be used to distinguish test
+suite results obtained from different target systems.

More information about the devel mailing list