summaryrefslogtreecommitdiffstats
path: root/bsp-howto/target-hash.rst
blob: bcb651b3435b27f920bd97f785fc9e51a30b8f85 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
.. SPDX-License-Identifier: CC-BY-SA-4.0

.. Copyright (C) 2021 embedded brains GmbH <rtems@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.