..
   # *******************************************************************************
   # Copyright (c) 2026 Contributors to the Eclipse Foundation
   #
   # See the NOTICE file(s) distributed with this work for additional
   # information regarding copyright ownership.
   #
   # This program and the accompanying materials are made available under the
   # terms of the Apache License Version 2.0 which is available at
   # https://www.apache.org/licenses/LICENSE-2.0
   #
   # SPDX-License-Identifier: Apache-2.0
   # *******************************************************************************

sample_fmea
===========

Overview
--------

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

   * - Failure Mode
     - Guideword
     - ASIL
     - Interface
   * - :ref:`SampleFailureMode <fmea-samplelibrary-samplefailuremode>`
     - 
     - B
     - safety_software_seooc_example.SampleLibraryAPI.GetNumber
   * - :ref:`SampleFailureMode2 <fmea-samplelibrary-samplefailuremode2>`
     - 
     - D
     - safety_software_seooc_example.SampleLibraryAPI.GetNumber


Failure Modes
-------------

.. dropdown:: SampleLibrary.SampleFailureMode
   :name: fmea-samplelibrary-samplefailuremode

   .. grid:: 2
      :gutter: 3

      .. grid-item::
         :class: sd-text-center

         :bdg-warning:`ASIL B`

      .. grid-item-card:: Interface

         safety_software_seooc_example.SampleLibraryAPI.GetNumber

      .. grid-item-card:: Failure Effect

         The world as we know it will end

   .. grid:: 1

      .. grid-item-card:: Description

         SampleFailureMode takes over the world

   .. rubric:: Root Cause Analysis

   .. uml:: sample_fta.puml

   .. rubric:: Control Measures

   .. grid:: 1

      .. grid-item-card::

         **JustBadLuck** :bdg-warning:`ASIL B`

         Sometimes, the dark side wins. We shall be prepared for that.

      .. grid-item-card::

         **NoMoreCookies** :bdg-warning:`ASIL B`

         We shall only order family size cookie jars

      .. grid-item-card::

         **NoMoreCoffee** :bdg-warning:`ASIL B`

         We shall keep a coffee reserve for emergencies

.. dropdown:: SampleLibrary.SampleFailureMode2
   :name: fmea-samplelibrary-samplefailuremode2

   .. grid:: 2
      :gutter: 3

      .. grid-item::
         :class: sd-text-center

         :bdg-danger:`ASIL D`

      .. grid-item-card:: Interface

         safety_software_seooc_example.SampleLibraryAPI.GetNumber

      .. grid-item-card:: Failure Effect

         Downstream consumers time out

   .. grid:: 1

      .. grid-item-card:: Description

         SampleFailureMode2 responds too late

   .. rubric:: Root Cause Analysis

   .. uml:: sample_fta2.puml

   .. rubric:: Control Measures

   .. grid:: 1

      .. grid-item-card::

         **WatchdogTimer** :bdg-danger:`ASIL D`

         A watchdog shall detect overruns and force a safe state

      .. grid-item-card::

         **DeadlineMonitor** :bdg-danger:`ASIL D`

         Per-request deadline monitoring shall flag late responses

Control Measures
----------------

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

   * - Control Measure
     - ASIL
     - Description
   * - JustBadLuck
     - B
     - Sometimes, the dark side wins. We shall be prepared for that.
   * - NoMoreCookies
     - B
     - We shall only order family size cookie jars
   * - NoMoreCoffee
     - B
     - We shall keep a coffee reserve for emergencies
   * - WatchdogTimer
     - D
     - A watchdog shall detect overruns and force a safe state
   * - DeadlineMonitor
     - D
     - Per-request deadline monitoring shall flag late responses