diff --git a/docs/plugins/dac/dac.rst b/docs/plugins/dac/dac.rst index 41d6a5f225..6c416e621d 100644 --- a/docs/plugins/dac/dac.rst +++ b/docs/plugins/dac/dac.rst @@ -12,10 +12,16 @@ implements an output IIO buffer or at least one DDS (ALTVOLTAGE) output channel. Both generation modes feature a few common items in their layout. -1. Tutorial button +1. Info button - The top left side information button will start a quick tutorial for basic - usage of the instrument. + The top left side information button will open a pop-up window containing + two buttons: **Tutorial** and **Documentation**. + + The Documentation button will open this page in a browser and close the + pop-up window. + + The Tutorial button will start a tutorial that will guide the user through + the main features of the plugin. 2. Right side menu @@ -61,7 +67,16 @@ Find all the sections of the instrument described below. List of detected IIO channels that are buffer capable. These can be enabled or disabled using their left side check. -3. Cyclic +3. Repeat data + + Choose whether to repeat the data columns loaded from file or not. + If enabled, the data columns will be repeated on all enabled channels, + without requiring the user to duplicate the data sets in the file to + match the number of enabled channels. + + By default it is set to true. + +4. Cyclic Choose whether to push a cyclic IIO buffer or stream non-cyclic buffers. If disabled, a new section containing "Buffer size" and "Kernel buffers" @@ -69,12 +84,12 @@ Find all the sections of the instrument described below. By default it is set to true. -4. File Size +5. File Size The size of the loaded file. It is populated once loading is successful and can be changed to a lower value, truncating the data loaded from file. -5. Run Button +6. Run Button Start output generation on the currently enabled channels. If anything is invalid in the setup it will appear in the bottom "Console Log" once @@ -86,15 +101,15 @@ Find all the sections of the instrument described below. - errors appeared while trying to configure the IIO Buffer - the combined enabled channels are not compatible (for I/Q channels) -6. Data Configuration +7. Data Configuration This section allows the user to scale the data before output. -7. Console Log +8. Console Log All errors or status messages are displayed here. -8. File Configuration +9. File Configuration This section is visible only when the buffer is non-cyclic. It contains a control for buffer size and one for kernel buffers. Both are automatically @@ -138,10 +153,3 @@ for available TX channels with I/Q corresponding channels. .. note:: For scale, "-Inf dB" is equivalent with scale=0 or a disabled channel. - - -Tutorial --------------------------------------------------------------------------------- - -A tutorial will automatically start first time the tool is open. It can -be restarted from tool Preferences. diff --git a/docs/tests/plugins/dac/dac_tests.rst b/docs/tests/plugins/dac/dac_tests.rst index 0d2b1156d3..e2393c1e73 100644 --- a/docs/tests/plugins/dac/dac_tests.rst +++ b/docs/tests/plugins/dac/dac_tests.rst @@ -691,3 +691,74 @@ Test 10 - Channel attributes The result of the test goes here (PASS/FAIL). +Test 11 - Repeat data option +-------------------------------------------- + +.. _TST.DAC.REPEAT_DATA: + +**UID:** TST.DAC.REPEAT_DATA + +**Description:** This test verifies the DAC plugin repeat data option. +The data sets loaded from the file should be repeated to fill in all the enabled +channels. + +**Preconditions:** + - :ref:`AdalmPluto.Device` + - Enable 2 TX channels on your Pluto device. + - OS: ANY + +**Resources:** + - ``__ + +**Steps:** + 1. Open the DAC plugin. + 2. Switch the "Mode" to "Buffer". + 3. Browse and select the *sinewave_0.9_2ch.csv* file. + 4. Press the "Load" button. + - **Expected result:** The first 2 channels are enabled. + - **Actual result:** + +.. + Actual test result goes here. +.. + + 5. Enable the remaining 2 channels from the channel list. + 6. Set the **Repeat data** option to true and press **Run**. + - **Expected result:** The console log displays the following message: *Pushed 8444 samples, 67552 bytes (1/1 buffers).* + - **Actual result:** + +.. + Actual test result goes here. +.. + + 7. Set the **Repeat data** option to false and press **Run**. + - **Expected result:** The console log displays the following message: *Not enough data columns for all enabled channels.* + - **Actual result:** + +.. + Actual test result goes here. +.. + + 8. Leave the **Repeat data** as is, disable the last 2 channels and press **Run**: + - **Expected result:** The console log displays the following message: *Pushed 8444 samples, 33776 bytes (1/1 buffers).* + - **Actual result:** + +.. + Actual test result goes here. +.. + +**Tested OS:** + +.. + Details about the tested OS goes here. + +**Comments:** + +.. + Any comments about the test goes here. + +**Result:** PASS/FAIL + +.. + The result of the test goes here (PASS/FAIL). +