[pentest] Update pentest framework documentation

This commit updates the pentest framework doc to include:
- The general setup and interactions with ot-sca
- The automatic testing framework

Signed-off-by: Pascal Nasahl <[email protected]>

Author: nasahlpa

sw/device/tests/penetrationtests/README.md renamed to sw/device/tests/penetrationtests/doc/README.md

@@ -1,12 +1,21 @@
 # Penetration Testing Framework
 
-The penetration testing framework is based on the [Cryptotest](../crypto/cryptotest/README.md) framework.
 The purpose of this framework is to perform side-channel analysis (SCA) and fault injection (FI) attacks on the FPGA as well as on the chip.
 
+![Full hardware setup](pentest_setup.png)
+
+As shown in the block diagram, the pentest framework runs on the target and receives configuration commands by the SCA and FI [ot-sca](https://github.com/lowRISC/ot-sca) framework.
+
+## Usage
+
+To run the penetration tests either on the FPGA or the chip, please follow the instructions in the [ot-sca](https://github.com/lowRISC/ot-sca) repository.
+
+### Building Images
+
 To build the penetration testing framework for the ChipWhisperer CW310 FPGA board, run:
 ```console
 cd $REPO_TOP
-./bazelisk.sh build //sw/device/tests/penetrationtests/firmware:firmware_fpga_cw310_test_rom
+./bazelisk.sh build //sw/device/tests/penetrationtests/firmware:firmware_fi
 ```
 
 Due to code size memory limitations, the firmware for the chip is split into a SCA, general FI, and OTBN FI binary. To build these binaries, run:
@@ -27,4 +36,14 @@ cd $REPO_TOP
 
 The binaries are located in `bazel-bin/sw/device/tests/penetrationtests/firmware/`.
 
-To run the penetration tests either on the FPGA or the chip, please follow the instructions in the [ot-sca](https://github.com/lowRISC/ot-sca) repository.
+## Automated Testing
+
+To automatically test whether the pentest framework works, an automatic testing framework is provided.
+This framework compares the responses of the pentest frameworks with reference testvectors.
+
+Use the following command to automatically test the Ibex FI tests on the CW310 FPGA board:
+
+```console
+cd $REPO_TOP
+./bazelisk.sh run //sw/device/tests/penetrationtests:fi_ibex_fpga_cw310_sival_rom_ext
+```