diff options
author | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2021-02-24 14:11:21 +0100 |
---|---|---|
committer | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2021-04-22 07:44:58 +0200 |
commit | 29ce2900b0b1781489b7b60378a417862c96639c (patch) | |
tree | 689c272d711149e761557c43ba5717a21cc1e4ad | |
parent | c-user: Generate dual-ported memory manager docs (diff) | |
download | rtems-docs-29ce2900b0b1781489b7b60378a417862c96639c.tar.bz2 |
bsp-howto: Add target hash chapter
Update #4267.
-rw-r--r-- | bsp-howto/index.rst | 1 | ||||
-rw-r--r-- | bsp-howto/target-hash.rst | 17 |
2 files changed, 18 insertions, 0 deletions
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|). initilization_code console clock + target-hash getentropy i2c spi 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@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. |