docs: add initial migration of test cases for m2k and swiot

Signed-off-by: AlexandraTrifan <[email protected]>

docs/tests/plugins/index.rst

@@ -10,7 +10,13 @@ Contents
    :includehidden:
    :maxdepth: 3
 
+   swiot1l/swiot1l_tests
+   m2k/digital_io_tests
+   m2k/logic_analyzer_tests
+   m2k/power_supply_tests
+
 ..
  add the path to each plugin test case here
  example dac/dac_tests
 
+

docs/tests/plugins/m2k/digital_io_tests.rst

@@ -0,0 +1,122 @@
+.. _digital_io_tests:
+
+Digital IO - Test Suite
+========================
+
+.. note::
+
+   User guide: :ref:`Digital IO user guide<digitalio>`
+
+The Digital IO tests are a set of tests that are run to verify the 
+Digital IO instrument of the ADALM2000 plugin in Scopy.
+
+The following apply for all the test cases in this suite.
+If the test case has special requirements, they will be listed in the test case section.
+
+Setup environment:
+------------------
+
+.. _adalm2000_device_digital_setup:
+
+**Adalm2000.Device:**
+    - Open Scopy.
+    - Connect the ADALM2000 device to the system.
+    - Connect the ADALM2000 device in Scopy using the USB/network backend.
+    - Connect loopback cables between DIO 0-7 and DIO 8-15 using the pinout diagram.
+
+Depends on:
+    - Test TST.EMU.CONNECT
+    - Test TST.PREFS.RESET
+
+Prerequisites:
+    - Scopy v2.0.0 or later with ADALM2000 plugin installed on the system.
+    - Tests listed as dependencies are successfully completed.
+    - Reset .ini files to default using the Preferences "Reset" button.
+
+Test 1 - Check individual digital pin state
+----------------------------------------------------
+
+.. _TST.DIO.INDIVIDUAL:
+
+UID:
+    TST.DIO.INDIVIDUAL
+
+Description:
+    This test verifies that the individual digital pins are working correctly.
+
+Preconditions:
+    - :ref:`Adalm2000.Device<adalm2000_device_digital_setup>`
+    - OS: ANY
+
+Steps:
+    1. Open the DigitalIO instrument.
+    2. Set DIO 0-7 and DIO 8-15 as individual pins using the combo box.
+    3. Set DIO Channel 0 as **output**.
+    4. Set DIO Channel 7 as **input**.
+    5. Change the logic state of DIO 0 (0/1) multiple times and monitor DIO 7 state.
+        - **Expected Result**:
+            - When DIO 0 is set to logic 1, DIO 7 will be automatically set to logic 1
+              (the corresponding led will be turned on).
+            - When DIO 0 is set to logic 0, DIO 7 will be automatically set to logic 0
+              (the corresponding led will be turned off).
+    6. Connect DIO 0 to a the analog pin **1+** and DIO 7 to the positive power 
+       supply **V+** using the pinout diagram attached in resources.
+    7. Set DIO 0 to logic 0 and open the :ref:`Voltmeter<voltmeter>` instrument.
+       Start the instrument and monitor the voltage value on Channel 1.
+
+        - **Expected Result**:
+            - The voltage displayed on the voltmeter is between -0.050V and 0.4V.
+    8. Set DIO 0 to logic 1 and monitor the voltage value on Channel 1. Start the instrument.
+        - **Expected Result**:
+            - The voltage displayed on the voltmeter is between 2.9V and 3.4V.
+    9. Open the `Power Supply instrument<power_supply>` and set the positive 
+       power supply to a voltage level between 0V and 0.8V.
+       Monitor the DIO 7 logic state.
+
+        - **Expected Result**:
+            - DIO 7 indicates logic 0 level.
+    10. Open the `Power Supply instrument<power_supply>` and set the positive
+        power supply to a voltage level between 2V and 3.3V.
+        Monitor the DIO 7 logic state.
+
+         - **Expected Result**:
+             - DIO 7 indicates logic 1 level.
+    11. Repeat steps 6 to 11 using DIO 8 as **output** (for step 3) and
+        DIO 1 as **input** for (step 4).
+
+         - **Expected Result**:
+             - All the expected results in step 6 to 11 are met.
+
+Test 2 - Checking grouped digital pin states
+----------------------------------------------------
+
+.. _TST.DIO.GROUP:
+
+UID:
+    TST.DIO.GROUP
+
+Description:
+    This test verifies that the grouped digital pins DIO 0-7 and DIO 8-15
+    are working correctly.
+
+Preconditions:
+    - :ref:`Adalm2000.Device<adalm2000_device_digital_setup>`
+    - OS: ANY
+
+Steps:
+    1. Open the DigitalIO instrument.
+    2. Set DIO 0-7 and DIO 8-15 as Group pins using the combo box.
+    3. Set DIO 0-7 as **output** and DIO 8-15 as **input**.
+    4. Set DIO 0-7 to value 0.
+        - **Expected Result**:
+            - DIO 8-15 value indicates the same value as DIO 0-7 group.
+    5. Set DIO 0-7 to value 128.
+        - **Expected Result**:
+            - DIO 8-15 value indicates the same value as DIO 0-7 group.
+    6. Set DIO 0-7 as **input** and DIO 8-15 as **output**.
+    7. Set DIO 8-15 to value 0.
+        - **Expected Result**:
+            - DIO 0-7 value indicates the same value as DIO 8-15 group.
+    8. Set DIO 8-15 to value 128.
+        - **Expected Result**:
+            - DIO 0-7 value indicates the same value as DIO 8-15 group.