.. _fsd124:

FSD124: GUI and Compiler function requirements, module tests and integration tests
###################################################################################

.. header
.. list-table::
   :header-rows: 0

   * - Products
     - Safety Simplifier
   * - Requirements
     - FSD114, FSD120
   * - Purpose
     - GUI and Compiler function requirements, module tests and integration tests.
   * - Input
     - FSD123, FSD121, FSD114, FSD120
   * - Output
     -
   * - 61508 Refs
     - 61508-2 clause 7.2 - 7.7

Table of contents
**********************

.. contents::
   :depth: 3


Document Description
**********************

This document contains the requirement specifications, integration tests, and module tests
for `GUI function blocks`_ and `Compiler function blocks`_, according to :ref:`fsd123`.

To read the test results refer to the test results of FSD124 in pdf format: :download:`FSD124v10 results <../resources/FSD124v10-testresults.pdf>`


Test setup and equipment
============================

The different test setups are described in the appendix. Each test specifies the test setup, equipment, and software that is being used.

**Software**

Relevant software used is specified for each test. Firmware version is specified for both processors.

**Equipment**

* Power supply: Kiprim DC605S
* Oscilloscope: RIGOL DS1054Z
* Logic analyzer: Saleae Logic Pro (8/16)
* PC: Windows 11 64-bit
* Multimeter: UNI-T UT132E
* Multimeter: UNI-T UT33A
* Multimeter: Victor 70C
* Micro-USB cable
* USB type C cable
* 802.15.4 USB radio dongle

GUI function blocks
*******************

.. include:: /fsd124/gui/01-single_input.rst
.. include:: /fsd124/gui/02-single_output.rst
.. .. include:: /fsd124/gui/03-status_input.rst
.. .. include:: /fsd124/gui/04-status_output.rst
.. include:: /fsd124/gui/05-advanced_input.rst
.. include:: /fsd124/gui/06-advanced_output.rst
.. include:: /fsd124/gui/10-gate_gui.rst
.. include:: /fsd124/gui/11-not.rst
.. include:: /fsd124/gui/12-latch_sr_gui.rst
.. include:: /fsd124/gui/13-latch_tog_gui.rst
.. include:: /fsd124/gui/14-latch_d_gui.rst
.. include:: /fsd124/gui/15-sync_inputs_gui.rst
.. include:: /fsd124/gui/16-sqrwave_gui.rst
.. include:: /fsd124/gui/17-reset_gui.rst
.. .. include:: /fsd124/gui/50-fatal_error_gui.rst
.. include:: /fsd124/gui/33-constant.rst
.. include:: /fsd124/gui/18-filter.rst
.. .. include:: /fsd124/gui/19-pushbutton.rst
.. include:: /fsd124/gui/20-switch_on_filter.rst
.. include:: /fsd124/gui/21-switch_off_filter.rst
.. .. include:: /fsd124/gui/22-light_curtain.rst
.. .. include:: /fsd124/gui/23-safety_switch.rst


Compiler function blocks
************************

.. include:: /fsd124/cfb/01-dig_input.rst
.. .. include:: /fsd124/cfb/02-dig_output.rst
.. include:: /fsd124/cfb/03-ossd.rst
.. include:: /fsd124/cfb/05-combo.rst
   
.. .. include:: /fsd124/cfb/10-gate.rst
.. .. include:: /fsd124/cfb/11-negate.rst
.. include:: /fsd124/cfb/12-latch_sr.rst
.. .. include:: /fsd124/cfb/13-latch_tog.rst
.. .. include:: /fsd124/cfb/14-latch_d.rst
.. include:: /fsd124/cfb/15-sync_inputs.rst
.. .. include:: /fsd124/cfb/16-sqrwave.rst
.. .. include:: /fsd124/cfb/17-reset.rst
.. .. include:: /fsd124/cfb/50-fatal_error.rst
.. .. include:: /fsd124/cfb/18-delay.rst
.. .. include:: /fsd124/cfb/05-combo.rst

Test results
************

To read these results refer to the test results of FSD124: :download:`FSD124v10 results <../resources/FSD124v10-testresults.pdf>`


.. needtable::
   :types: result
   :columns: id, tags, status
   :tags: block
   :sort: tags

.. include:: /fsd124/results/results.rst


Motivations
***********

.. motivation:: SWSREQ_008A
   :id: MOTIVATION_124_001
   :tags: fsd124
   :status: PASS

   The GUI software allows the user to create logic by using a block diagram language.
   See FSD124 test results.


.. motivation:: SWSREQ_009A
   :id: MOTIVATION_124_002
   :tags: fsd124
   :status: PASS

   This is achieved by changing the communication maximum timeouts,
   as well as by changing filtering parameters on inputs.


.. motivation:: SWSREQ_004A
   :id: MOTIVATION_124_003
   :tags: fsd124
   :status: PASS

   The GUI software allows the user to change the minimum and maximum power supply voltage in the node parameters.


Appendix
**********

Sl3 template for module tests
=============================

Below is the template for module tests. Any test that does not specify all the logic uses this template::

   nodes:
    - typ: standard
      node_idx: 0
      node_gui_nr: 1

      # io, memories, logic, copies go here.

      node_parameters:
         mem_groups_offset: 0
         mem_groups_num: 1
         display_connector_mode: DISPLAY

   parameters:
      slottime_ms: 1
      silent_slottime_ms: 20
      radio_packet_type: small
      glb_mem_tmo:
         safe_area: 500
         unsafe_area: 500

Revision History
****************

.. list-table::
   :header-rows: 1

   * - Date
     - By
     - Version
     - Description

   * - 2017-11-02
     - William Forsdal
     - V1
     - Initial version

   * - 2018-04-16
     - William Forsdal
     - V2
     - Add more blocks and tests

   * - 2018-06-08
     - William Forsdal
     - V5
     - updated blocks and tests (sync_inputs)

   * - 2018-10-10
     - William Forsdal
     - V6
     -

      * Added more info to test results
      * Added new tests to cover DREQs
      * Added description of test equipment

   * - 2023-11-09
     - Orpheus Johansson
     - V7
     - Copied over old document to new structure.

   * - 2025-08-04
     - WF
     - V8
     - Updated tests to point to test.