Wiki

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
university:tools:m2k:scopy:logicanalyzer [11 Aug 2017 15:47]
amiclaus add scopy main page link
university:tools:m2k:scopy:logicanalyzer [16 May 2018 15:35] (current)
Alexandra Update docs to match the new UI and include new features
Line 2: Line 2:
 ===== General ===== ===== General =====
 To switch to this instrument click on the Logic Analyzer button from the left menu. To switch to this instrument click on the Logic Analyzer button from the left menu.
- 
-{{:​university:​tools:​m2k:​scopy_logic_analyzer.png?​|Scopy Logic Analyzer}} 
  
 This instrument can run continuously,​ repeatedly triggering, by pressing the Run button or triggering once, by pressing the Single button. This instrument can run continuously,​ repeatedly triggering, by pressing the Run button or triggering once, by pressing the Single button.
  
-The logic analyzer instrument consists of a channel manager, a central signal plot and a control panel for different settings. ​ +The logic analyzer instrument consists of a channel manager, a central signal plot and a control panel for different settings.
  
-The channel manager allows the user to enable or disable channels, set triggers, create groups of signals or set protocol decoders to groups. The groups can be created by selecting channels and pressing the button ​{{:​university:​tools:​m2k:​groups.png?direct&​200|Scopy ​Group Channels}} or by dragging one channel/​group over another channel/​group. The drag and drop mechanism also allows the user to reorder the channels.+{{:​university:​tools:​m2k:​scopy:​la-initial.png?​|Scopy ​Logic Analyzer}} 
  
-The channel manager can be collapsed by pressing the button {{:​university:​tools:​m2k:​collapse.png?​direct&​40|Scopy Collapse Manager}} located above the plot.+\\
  
-{{:​university:​tools:​m2k:​scopy_initial_pin.png?|Logic Analyzer Pin}}+==== Channel manager configuration ==== 
 + 
 +The channel manager allows the user to enable or disable channels, set triggers, create groups of signals or set protocol decoders to groups. The groups can be created by selecting channels and pressing the button ​{{:​university:​tools:​m2k:​scopy:​la-group-btn.png|Scopy Group Channels}} or by dragging one channel/​group over another channel/​group. The drag and drop mechanism also allows the user to reorder the channels. 
 + 
 +The channel manager can be collapsed by pressing the button {{:​university:​tools:​m2k:​collapse.png|Scopy Collapse Manager}} located above the plot.
  
 Channel manager configuration for a pin: Channel manager configuration for a pin:
 +
 +{{:​university:​tools:​m2k:​scopy:​scopy_initial_pin.png?​|Logic Analyzer Pin}}
  
   * Switch for enabling/​disabling a channel.   * Switch for enabling/​disabling a channel.
Line 22: Line 26:
   * Dropdown for trigger selection.   * Dropdown for trigger selection.
   * Check box for selecting a channel.   * Check box for selecting a channel.
- 
-{{:​university:​tools:​m2k:​scopy_group_pin.png?​|Logic Analyzer Pin in Group}} 
  
 Channel manager configuration for a pin belonging to a group: Channel manager configuration for a pin belonging to a group:
 +
 +{{:​university:​tools:​m2k:​scopy:​scopy_group_pin.png?​|Logic Analyzer Pin in Group}}
  
   * Channel name.   * Channel name.
Line 32: Line 36:
   * Dropdown for trigger selection.   * Dropdown for trigger selection.
   * Orange delete mark for removing channel from group.   * Orange delete mark for removing channel from group.
- 
-{{:​university:​tools:​m2k:​scopy_group.png?​|Logic Analyzer Group}} 
  
 Channel manager configuration for a group: Channel manager configuration for a group:
 +
 +{{:​university:​tools:​m2k:​scopy:​scopy_group.png?​|Logic Analyzer Group}}
  
   * Switch for enabling/​disabling a group.   * Switch for enabling/​disabling a group.
Line 46: Line 50:
 The plot displays the signal data captured on the enabled channels and the decoded data for active groups. The plot displays the signal data captured on the enabled channels and the decoded data for active groups.
  
-The control panel can be opened by pressing the button ​{{:​university:​tools:​m2k:​scopy_right_panel_settings.png?​direct&​40|Scopy Right Panel Settings}} of any element from the right side of the bottom menu barby using the General Settings button ​{{:​university:​tools:​m2k:​scopy_wheel.png?​direct&​40|Scopy Right Panel Settings}} ​or the Channel Settings button {{:​university:​tools:​m2k:​scopy_settings_btn.png?​direct&​40|Scopy Right Panel Settings}}+The control panel can be opened by pressing the Trigger settings ​button, the General Settings button or the Channel Settings button. All the mentioned buttons are shown in the previous illustration. 
-The available elements in the bottom menu bar are Trigger Settings and Cursor Settings.+ 
 +\\ 
 +==== General settings ==== 
 + 
 +{{ :​university:​tools:​m2k:​scopy:​la-general-settings.png|Logic Analyzer General ​Settings }}
  
-{{ :​university:​tools:​m2k:​scopy_general_settings.png?​direct&​200|Logic Analyzer General Settings}} 
-General Settings: 
   * **Time Base**: – It can be changed either by pressing the +/- buttons or writing a value in the edit box. Pressing the center of the range circle toggles between fine/coarse modes.   * **Time Base**: – It can be changed either by pressing the +/- buttons or writing a value in the edit box. Pressing the center of the range circle toggles between fine/coarse modes.
   * **Time Trigger Position**: – It can be changed either by pressing the +/- buttons or writing a value in the edit box. Pressing the center of the range circle toggles between fine/coarse modes.   * **Time Trigger Position**: – It can be changed either by pressing the +/- buttons or writing a value in the edit box. Pressing the center of the range circle toggles between fine/coarse modes.
 +  * **Repeated Mode**: – Using the instrument in this mode consists of repeatedly waiting, acquiring and displaying one buffer at a time. However, when the time base is greater than 1 s/div, in order to avoid waiting too much for a buffer, the time trigger is moved on the leftmost position on the screen and the signals are plotted immediately,​ starting from the left side when an entire screen was plotted. In this situation, the user can also control the Frequency. If the time trigger position is modified, the instrument returns to the waiting mode, regardless of the time base value.
 +  * **Stream Mode**: – When the Stream mode is enabled, the time trigger is moved automatically to the leftmost position on the screen, the Frequency control is enabled, allowing the user to stream at any chosen frequency. In this mode, the signals are continuously drawn in the right side, not limited by one screen. If the time trigger position is modified, the instrument returns to the waiting mode, regardless of the time base value.
 +  * **Frequency**:​ – It can be changed either by pressing the +/- buttons or writing a value in the edit box. Pressing the center of the range circle toggles between fine/coarse modes. The maximum frequency is 3.03 MHz. 
 +  * **Export**: – The Logic Analyzer can export current data in .csv (Comma-separated values) and .vcd (Value change dump) format. Using the “Export All” switch you can select and export data from all the available channels or you can create a custom selection using the dropdown. After deciding which channels should be exported, click “Export” and choose a file. The exported .csv files are compatible with instruments throughout the application,​ so you could load the file in the Pattern Generator.
  
 \\ \\
 \\ \\
 \\ \\
-The default values for this instrument can be set by pressing the button {{:​university:​tools:​m2k:​scopy_reset_default.png?​direct&​170|Scopy Reset Instrument}}. 
  
-Channel ​Settings:+==== Channel ​settings ====
  
 If a channel is highlighted in the channel manager, the settings for that particular channel are displayed in this panel. If a channel is highlighted in the channel manager, the settings for that particular channel are displayed in this panel.
 All the channels/​groups allow the user to change the **name** by writing a value in the edit box. All the channels/​groups allow the user to change the **name** by writing a value in the edit box.
  
-The buttons ​{{:​university:​tools:​m2k:​scopy_navigation.png?​direct&​80|Scopy Channel Navigation}} ​from the top right side of the panel allow navigation through the list of active channels.+The buttons from the top right side of the panel allow navigation through the list of active channels, as shown in the following illustration. For groups, if a decoder is set, the required and optional roles for that decoder are displayed in this panel.
  
-{{ :university:​tools:​m2k:​scopy_group_panel.png?​direct&​200}}  +{{ university:​tools:​m2k:​scopy:la-chn-settings.png }}
-For groups, if a decoder is set, the required and optional roles for that decoder are displayed in this panel. +
- +
-{{:​university:​tools:​m2k:scopy_selected_group.png?​direct&​400}}+
 \\ \\
 \\  \\ 
Line 81: Line 87:
 \\ \\
 ==== Enable & run multiple channels ==== ==== Enable & run multiple channels ====
-<​hidden>​ + 
-  - Disable 8 channels using the channel manager located in the left side of the plot. To disable a channel use {{:​university:​tools:​m2k:​scopy_switch.png?}}.+  - Disable 8 channels using the channel manager located in the left side of the plot. To disable a channel use {{:​university:​tools:​m2k:​scopy:​la-onoff.png}}.
   - Use {{:​university:​tools:​m2k:​scopy_hide_inactive.png?​|Hide inactive channels}} to hide the disabled channels. The plot will contain only the enabled channels.   - Use {{:​university:​tools:​m2k:​scopy_hide_inactive.png?​|Hide inactive channels}} to hide the disabled channels. The plot will contain only the enabled channels.
-  - To acquire 1 s of data, change the time base to 100 ms, using the time base selector in the right menu. Open the right menu using {{:​university:​tools:​m2k:​scopy_wheel.png?​direct&​40|Scopy Right Panel Settings}}+  - To acquire 1 s of data, change the time base to 100 ms, using the time base selector in the right menu. Open the right menu using the General ​Settings ​button
-  - Start the acquisition using {{:​university:​tools:​m2k:​scopy_run.png?​|Start ​the Logic Analyzer}}. After 1 s you should see 8 signals on the plot. +  - Start the acquisition using the "​Run"​ button. After 1 s you should see 8 signals on the plot. 
-</​hidden>​ +
-\\  +
-==== Reset instrument ==== +
-==Reset instrument to default settings== +
-<​hidden>​ +
-  - Open the right menu using {{:​university:​tools:​m2k:​scopy_wheel.png?​direct&​40|Scopy Right Panel Settings}}. +
-  - Click {{:​university:​tools:​m2k:​scopy_reset_default.png?​direct&​170|Scopy Reset Instrument}}.\\ The expected result is the following:​\\ All the 16 channels should be enabled and visible, the time base should have the value 1 ms. The time trigger position should be 0. +
-</​hidden>​+
 \\  \\ 
 ==== Create channel groups, decode & change UI elements ==== ==== Create channel groups, decode & change UI elements ====
-==Create channel groups, run and decode the signals, setup protocol decoders and change visual parameters for signals (color, thickness).== + 
-<​hidden>​ +   - Create ​ a channel group with 3 channels.\\ Use {{:​university:​tools:​m2k:​scopy_select_channel.png?​|Select channel}} to select the channels.\\ After selecting 3 channels, use the Group button ​to create ​group \\ {{:​university:​tools:​m2k:​scopy:​create-group.gif?​|Create channel group}} 
-   - Create ​ a channel group with 3 channels.\\ Use {{:​university:​tools:​m2k:​scopy_select_channel.png?​|Select channel}} to select the channels.\\ After selecting 3 channels, use {{:​university:​tools:​m2k:​groups.png?​direct&​200|Scopy ​Group Channels}}  ​to create ​the group \\ {{:​university:​tools:​m2k:​tc3-s1.gif?​|Create channel group}} +  -  Setup a **Parallel** decoder for this group. Use the dropdown located in the right side of the group name to set a decoder.\\ The roles for these 3 channels ​are automatically assigned for this decoder
-  -  Move the channel group at the top of the channel list. Use drag and drop to move the channel group. +  -  Start the acquisition using the "​Run"​ button. On the plot, above the 3 channels, the decoded information should appear ​as shown in the following illustration
-  -  Setup a **Parallel** decoder for this group. Use the dropdown located in the right side of the group name to set a decoder.\\ ​{{:​university:​tools:​m2k:​scopy_decoder.png?​}}\\ For each channel in this group, set its role for the decoder using the dropdown located in the right side of the pin’s number. ​The roles for these 3 channels ​should go from D0(Data0) to D2(Data2)The order is not relevant.\\ {{:​university:​tools:​m2k:​scopy_roles.png?​}}\\ ​ +  -  Change the name of the existing group.\\ Select the group. Open the right menu using the Channel ​Settings ​button.\\ Use the mouse wheel to scroll until the //Name// text box is visible. Change the name of the group to “GROUP 1”. 
-  -  Start the acquisition using {{:​university:​tools:​m2k:​scopy_run.png?​|Start ​the Logic Analyzer}}. On the plot, above the 3 channels, the decoded information should appear.\\ {{:​university:​tools:​m2k:​scopy_decoded.png?​}}\\ Stop the acquisition+  -  Create another channel group with channels. (See step 1). Merge the two channel groups.\\ To merge two channels group, use drag and drop. Select one channel group, and drag it inside the other channel group.\\ You should have 5 channels in the first channel group (“GROUP1”) and the second channel group should stay the same.\\ {{:​university:​tools:​m2k:​scopy:merge-groups.gif?}} 
-  -  Change the name of the existing group.\\ Select the group. Open the right menu using {{:​university:​tools:​m2k:​scopy_settings_btn.png?​direct&​40|Scopy Right Panel Settings}}.\\ Use the mouse wheel to scroll until the //Name// text box is visible. Change the name of the group to “GROUP 1”. +  -  ​The roles for the remaining channels in GROUP1 ​should be automatically assigned. Observe the decoded value changing. 
-  -  Create another channel group with channels. (See step 1). Merge the two channel groups.\\ To merge two channels group, use drag and drop. Select one channel group, and drag it inside the other channel group.\\ You should have 5 channels in the first channel group (“GROUP1”) and the second channel group should stay the same.\\ {{:​university:​tools:​m2k:​tc3-s6.gif?}} +  -  Change signal color and thickness.\\ Select GROUP1. Open the right menu using the Channel ​Settings ​button. Use the mouse wheel to scroll until the //​Thickness//​ dropdown. Set the thickness to 3. This should change the thickness of every channel in the group.\\ {{:​university:​tools:​m2k:scopy:​scopy_thickness.png?​}} 
-  -  ​Complete the roles for the remaining channels in GROUP1. Observe the decoded value changing. +
-  -  Change signal color and thickness.\\ Select GROUP1. Open the right menu using  ​{{:​university:​tools:​m2k:​scopy_settings_btn.png?​direct&​40|Scopy Right Panel Settings}}. Use the mouse wheel to scroll until the //​Thickness//​ dropdown. Set the thickness to 5. This should change the thickness of every channel in the group.\\ {{:​university:​tools:​m2k:​scopy_thickness.png?​}} +
-  ​- ​ Select the first channel from the group. Use  {{:​university:​tools:​m2k:​scopy_settings_btn.png?​direct&​40|Scopy Right Panel Settings}} to open the right menu. Change the //High color// to yellow. +
-</​hidden>​+
 \\  \\ 
 ==== Trigger Settings ==== ==== Trigger Settings ====
-<​hidden>​ 
    - From the left menu, choose the Pattern Generator tool.\\ Select channel 0 and create a group. \\ Select the group and set the //Clock// pattern using the right menu. \\ Do not start the Pattern Generator.    - From the left menu, choose the Pattern Generator tool.\\ Select channel 0 and create a group. \\ Select the group and set the //Clock// pattern using the right menu. \\ Do not start the Pattern Generator.
-  - From the left menu, choose the Logic Analyzer tool.\\ Open the right menu using {{:​university:​tools:​m2k:​scopy_wheel.png?​direct&​40|Scopy Right Panel Settings}}.\\ Use the time base selector to set the time base at 1 ms.\\ Use the time position selector to set the time position at 0 ms.\\ Close the right menu using {{:​university:​tools:​m2k:​scopy_wheel.png?​direct&​40|Scopy Right Panel Settings}}+  - From the left menu, choose the Logic Analyzer tool.\\ Open the right menu using the General ​Settings ​button.\\ Use the time base selector to set the time base at 1 ms.\\ Use the time position selector to set the time position at 0 ms. 
-  - Set “rising edge” ​trigger on channel 0, using the channel manager in the left side of the plot\\ {{:​university:​tools:​m2k:​scopy_rising_edge.png?}} +  - Setup a trigger ​condition ​on channel 0, using the channel manager in the left side of the plot\\ {{:​university:​tools:​m2k:​scopy:​scopy_initial_pin.png?}} 
-  - Press {{:​university:​tools:​m2k:​scopy_single.png?​}} ​to acquire one buffer of data.\\ The plot should remain the same, without any signals.+  - Press the "​Single"​ button ​to acquire one buffer of data.\\ The plot should remain the same, without any signals.
   - Now Start the Pattern Generator using the left menu. \\ The Pattern Generator generates a clock on the first channel, so the Logic Analyzer should trigger, and the signals should now be visible on the plot.   - Now Start the Pattern Generator using the left menu. \\ The Pattern Generator generates a clock on the first channel, so the Logic Analyzer should trigger, and the signals should now be visible on the plot.
-</​hidden>​ 
  
 \\  \\ 
 ==== Interaction with Scopy Pattern Generator ==== ==== Interaction with Scopy Pattern Generator ====
-<​hidden>​ 
    - From the left menu, choose the Pattern Generator tool.\\ Select channel 0 and create a group. \\ Select the group and set the UART pattern using the right menu. Set the following parameters:    - From the left menu, choose the Pattern Generator tool.\\ Select channel 0 and create a group. \\ Select the group and set the UART pattern using the right menu. Set the following parameters:
      - baud: 115200      - baud: 115200
      - data to send = “hello”.      - data to send = “hello”.
    - Start the Pattern Generator using the top right button.    - Start the Pattern Generator using the top right button.
-   - From the left menu, choose the Logic Analyzer.\\ Create a group that contains channel 0. The group will be created at the bottom of the channel manager. Select the group and open the right menu using {{:​university:​tools:​m2k:​scopy_settings_btn.png?}}+   - From the left menu, choose the Logic Analyzer.\\ Create a group that contains channel 0. The group will be created at the bottom of the channel manager. Select the group and open the right menu using the Channel Settings button.
   -  Set the UART decoder to the group.   -  Set the UART decoder to the group.
   -  Set the RX role to channel 0.   -  Set the RX role to channel 0.
-  -  Press {{:​university:​tools:​m2k:​scopy_single.png?​}} ​to acquire just one buffer of data. \\ Depending on the time base, the displayed data may change. At a time base of 1ms, the result is the following.\\ {{:​university:​tools:​m2k:​scopy_uart.png?​}}\\ The decoded data is not visible, but using the “zoom” feature, you can check out specific areas of the plot.\\ To zoom in, place the mouse over the plot and use the mouse wheel\\ {{:​university:​tools:​m2k:​scopy_zoom.png?​}} +  -  Press the "​Single"​ button ​to acquire just one buffer of data. \\ Depending on the time base, the displayed data may change. At a time base of 500 μs/div, the result is the following.\\ {{:​university:​tools:​m2k:scopy:​scopy_uart.png?​}}\\ The decoded data is not visible, but using the “zoom” feature, you can check out specific areas of the plot.\\ To zoom in, place the mouse over the plot and use the mouse wheel.\\ {{:​university:​tools:​m2k:scopy:​scopy_zoom.png?​}} 
-  -  Enable the cursors using {{:​university:​tools:​m2k:​scopy_cursors.png?}}.\\ Use the handles from the plot to move the cursors. Check their position and the measured signal using the cursor status below the plot.\\ {{:​university:​tools:​m2k:​scopy_cursors2.png?​}} +  -  Enable the cursors using the box on the left of the "​Cursors"​ labelWhen the cursors are enabled, you can also enable/​disable locking using the lock icon on the right of the "​Cursors"​ label, as shown in the following illustration.\\ Use the handles from the plot to move the cursors. Check their position and the measured signal using the cursor status below the channel manager.\\ {{:​university:​tools:​m2k:scopy:​scopy_cursors2.png?​}} 
-</​hidden>​+ 
 +\\
  
 **Return to [[university:​tools:​m2k:​scopy|Scopy Main Page]]** **Return to [[university:​tools:​m2k:​scopy|Scopy Main Page]]**
university/tools/m2k/scopy/logicanalyzer.txt · Last modified: 16 May 2018 15:35 by Alexandra