Skip to content

Commit

Permalink
update
Browse files Browse the repository at this point in the history
  • Loading branch information
wonderfullook committed Jul 26, 2023
1 parent 92c6558 commit 241b238
Show file tree
Hide file tree
Showing 9 changed files with 415 additions and 787 deletions.
16 changes: 8 additions & 8 deletions docs/hardware/en/logic_analyzer/combo8/basic_operation.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,12 @@
---
title: Basic Operations
keywords: LogicAnalyzer, debugger, link, RISCV, tool
update:
- date: 2023-07-26
version: v0.1
author: ctx
content:
- Release docs
---

The SLogic combo8 has four functions (SLogic, CKLink Debugger, DAP-Link Debugger, USB2UART). This document is intended to guide you on how to select the functions.
Expand All @@ -9,9 +15,7 @@ The SLogic combo8 has four functions (SLogic, CKLink Debugger, DAP-Link Debugger

After power on, **press the button** to switch functions, and you can see the **indicator light change** when the switching is successful.



![](../../../zh/logic_analyzer/assets/slogic_btn.png)
![slogic_btn](./../../../zh/logic_analyzer/combo8/assets/basic_operation/slogic_btn.png)

(Up:The red box indicates the position of the function switch button)

Expand All @@ -37,14 +41,10 @@ You can check the current function and corresponding wire sequence through the p

- The right side shows the wire sequence for **SLogic (Blue)**.




![](../../../zh/logic_analyzer/assets/slogic_panel.png)
![slogic_panel](./../../../zh/logic_analyzer/combo8/assets/basic_operation/slogic_panel.png)

(Above:Color/Function/Wire Sequence Correspondence Diagram)


Here's an example:

1. If you want to use the SLogic function, press the button to switch the indicator light to blue. This will enable the SLogic function, and you can find the pin wire sequence for SLogic under the blue font on the panel.
Expand Down
9 changes: 4 additions & 5 deletions docs/hardware/en/logic_analyzer/combo8/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,19 +2,18 @@
title: SLogic Combo8
keywords: LogicAnalyzer, debugger, link, RISCV, tool
update:
- date: 2023-03-09
- date: 2023-07-26
version: v0.1
author: wonder
author: ctx
content:
- New file
- Release docs
---

## Introduction

SLogic combo8 is a logic analyzer based on Sipeed M0s Dock for secondary development, and also has CKLink Debugger, DAP-Link Debugger, USB2UART functions, which can be switched arbitrarily by buttons.


![](../../../zh/logic_analyzer/assets/slogic_combo8_main.png)
![slogic_combo8_main](./../../../zh/logic_analyzer/combo8/assets/readme/slogic_combo8_main.png)

## Function Parameters

Expand Down
10 changes: 8 additions & 2 deletions docs/hardware/en/logic_analyzer/combo8/use_cklink_function.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,12 @@
---
title: Using as CKLink
keywords: LogicAnalyzer, debugger, link, RISCV, tool
update:
- date: 2023-07-26
version: v0.1
author: ctx
content:
- Release docs
---

SLogic Combo8 features high-speed CK-Link functionality, with a speed that surpasses CK-Link Lite and comes close to CK-Link Pro, making it a great tool for debugging RISC-V chips. In this mode, it also has a high-speed serial port (20Mbps).
Expand All @@ -13,10 +19,10 @@ Let's get started with using CK-LINK!

Press the toggle button to switch the indicator light to yellow.

![](../../../zh/logic_analyzer/assets/slogic_led_yellow.png)
![slogic_led_yellow](./../../../zh/logic_analyzer/combo8/assets/use_cklink_function/slogic_led_yellow.png)

> To verify if SLogic functionality is enabled:
>
> On Linux, use the lsusb command / On Windows, check in Device Manager to find the CKLink HS device.
## Getting Started
Expand Down
14 changes: 10 additions & 4 deletions docs/hardware/en/logic_analyzer/combo8/use_daplink_function.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,12 @@
---
title: Using as DAPLink
keywords: LogicAnalyzer, debugger, link, RISCV, tool
update:
- date: 2023-07-26
version: v0.1
author: ctx
content:
- Release docs
---

SLogic Combo8 features high-speed DAP-Link functionality, suitable for various common chips, especially for debugging STM32 chips using IDE on Windows.
Expand All @@ -9,7 +15,7 @@ SLogic Combo8 features high-speed DAP-Link functionality, suitable for various c

Press the toggle button to switch the indicator light to green.

![](../../../zh/logic_analyzer/assets/slogic_led_green.png)
![slogic_led_green](./../../../zh/logic_analyzer/combo8/assets/use_daplink_function/slogic_led_green.png)

> To verify if DAPLink functionality is enabled:
>
Expand All @@ -23,12 +29,12 @@ Here's a step-by-step guide on using the STM32F103C8T6 chip with Windows MDK IDE

2. Connect to DAPLink using MDK:

![](../../../zh/logic_analyzer/assets/cfg_dap_debugger_of_mdk.png)
![cfg_dap_debugger_of_mdk](./../../../zh/logic_analyzer/combo8/assets/use_daplink_function/cfg_dap_debugger_of_mdk.png)

3. Download the firmware using MDK:

![](../../../zh/logic_analyzer/assets/download_fw_in_mdk.png)
![download_fw_in_mdk](./../../../zh/logic_analyzer/combo8/assets/use_daplink_function/download_fw_in_mdk.png)

4. Debug the firmware using MDK:

![](../../../zh/logic_analyzer/assets/start_debugger_in_mdk.png)
![start_debugger_in_mdk](./../../../zh/logic_analyzer/combo8/assets/use_daplink_function/start_debugger_in_mdk.png)
20 changes: 12 additions & 8 deletions docs/hardware/en/logic_analyzer/combo8/use_fouruart_function.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,12 @@
---
title: Using as Serial Module
keywords: LogicAnalyzer, debugger, link, RISCV, tool
update:
- date: 2023-07-26
version: v0.1
author: ctx
content:
- Release docs
---

SLogic Combo8 has 4 independent high-speed serial port functionalities. The first two ports based on UART can achieve a super-high speed baud rate of up to 20Mbps simultaneously, while the latter two ports can reach up to 1Mbps through IO simulation. It is highly suitable for scenarios such as batch programming and production testing.
Expand All @@ -9,13 +15,13 @@ SLogic Combo8 has 4 independent high-speed serial port functionalities. The firs

Press the toggle button to switch the indicator light to red.

![](../../../zh/logic_analyzer/assets/slogic_led_red.png)
![slogic_led_red](./../../../zh/logic_analyzer/combo8/assets/use_fouruart_function/slogic_led_red.png)

> To verify if Serial Module functionality is enabled:
>
> Linux: Use the lsusb command to check if the UARTx4 HS USB device appears.
![](../../../zh/logic_analyzer/assets/slogic_linux_equipment_uart.png)
![slogic_linux_equipment_uart](./../../../zh/logic_analyzer/combo8/assets/use_fouruart_function/slogic_linux_equipment_uart.png)

## Getting Started

Expand Down Expand Up @@ -46,7 +52,7 @@ sudo apt install minicom

For example, to use **minicom** with UART0 to communicate with the test device, open the Linux terminal using **CTRL+ALT+T**, enter the installation commands, and enter the administrator user password when prompted. Wait for the package installation to complete.

![](../../../zh/logic_analyzer/assets/minicom_install_uart.png)
![minicom_install_uart](./../../../zh/logic_analyzer/combo8/assets/use_fouruart_function/minicom_install_uart.png)

After installation, communicate with the test device using UART0. In the terminal, enter the command:

Expand All @@ -58,16 +64,14 @@ The **-b** parameter specifies the desired baud rate, which should be the same a

The **-D** parameter specifies the port to listen to.

![](../../../zh/logic_analyzer/assets/minicom_uart.png)
![minicom_uart](./../../../zh/logic_analyzer/combo8/assets/use_fouruart_function/minicom_uart.png)

After entering the command, you can communicate with the test device, receive and print messages in the terminal, and send data to the test device.



#### Serial Loopback Test:

![](../../../zh/logic_analyzer/assets/uart_line_uart.jpg)
![uart_line_uart](./../../../zh/logic_analyzer/combo8/assets/use_fouruart_function/uart_line_uart.jpg)
(Above: Serial module wiring diagram)

Loopback test result:
![](../../../zh/logic_analyzer/assets/minicom_test_uart.png)
![minicom_test_uart](./../../../zh/logic_analyzer/combo8/assets/use_fouruart_function/minicom_test_uart.png)
45 changes: 25 additions & 20 deletions docs/hardware/en/logic_analyzer/combo8/use_logic_function.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,39 @@
# Using as a Logic Analyzer
---
title: Using as a Logic Analyzer
keywords: LogicAnalyzer, debugger, link, RISCV, tool
update:
- date: 2023-07-26
version: v0.1
author: ctx
content:
- Release docs
---

## Enabling the Logic Analyzer Function

Press the button to switch the indicator light to blue. As shown below:

![](../../../zh/logic_analyzer/assets/slogic_led_blue.png)
![slogic_led_blue](./../../../zh/logic_analyzer/combo8/assets/use_logic_function/slogic_led_blue.png)

## Verifying that the Logic Analyzer Function is Enabled

Linux:

Use the lsusb command to see the USB TO LA USB device appear

![](../../../zh/logic_analyzer/assets/slogic_linux_equipment_pulseview.png)
![slogic_linux_equipment_pulseview](./../../../zh/logic_analyzer/combo8/assets/use_logic_function/slogic_linux_equipment_pulseview.png)

## Using USB TO LA

>Currently, the logic analyzer only supports Linux systems
> Currently, the logic analyzer only supports Linux systems
### Quick Use

#### Connect SLogic and Target Device

Connect the signal points to be tested on the target device to any free CH port of SLogic, and make sure that the GND of the device to be tested is connected to the GND of SLogic

![](../../../zh/logic_analyzer/assets/slogic_panel.png)
![slogic_panel](./../../../zh/logic_analyzer/combo8/assets/use_logic_function/slogic_panel.png)

#### Connect SLogic and Computer

Expand All @@ -41,12 +50,10 @@ sudo ./PulseView-x86_64-032323-1101.AppImage
4. Scan for devices that meet the requirements
5. Select the device that has been found

![](../../../zh/logic_analyzer/assets/set_connect_cfg_of_pulseview.png)
![set_connect_cfg_of_pulseview](./../../../zh/logic_analyzer/combo8/assets/use_logic_function/set_connect_cfg_of_pulseview.png)

> If no device is found in the third step, you can try to switch the module function, switch back to the logic analyzer mode, and repeat the third step


### Start Sampling

1. Configure the number of channels, number of samples, and sampling rate of PulseView
Expand All @@ -55,17 +62,17 @@ Note!!! The sampling bandwidth must not be equal to or exceed 320MHz, that is, t

The figure below sets the number of channels to **8**, the number of samples to **1M samples**, and the sampling rate to **10Mhz**

![](../../../zh/logic_analyzer/assets/equ_selec_complete_of_pulseview.png)
![equ_selec_complete_of_pulseview](./../../../zh/logic_analyzer/combo8/assets/use_logic_function/equ_selec_complete_of_pulseview.png)

2. Set the trigger mode of channel D0 to **rising and falling edge trigger**

Click on the label icon of channel D0 to set the trigger mode

![](../../../zh/logic_analyzer/assets/set_channel_of_pulseview.png)
![set_channel_of_pulseview](./../../../zh/logic_analyzer/combo8/assets/use_logic_function/set_channel_of_pulseview.png)

3. Start acquisition and get sampling results

![](../../../zh/logic_analyzer/assets/waveform_fast_of_pulseview.png)
![waveform_fast_of_pulseview](./../../../zh/logic_analyzer/combo8/assets/use_logic_function/waveform_fast_of_pulseview.png)

### Detailed Configuration

Expand All @@ -74,7 +81,7 @@ Click on the label icon of channel D0 to set the trigger mode
Open the **"red probe"** icon in the top toolbar, select the channels you want to enable, and the number of sampling channels for the logic analyzer. The optional options are 1ch, 2ch, 4ch and 8ch. There are also shortcut keys for quick switching of channels that meet the corresponding conditions


![](../../../zh/logic_analyzer/assets/set_Logic_cfg_of_pulseview.png)
![set_Logic_cfg_of_pulseview](./../../../zh/logic_analyzer/combo8/assets/use_logic_function/set_Logic_cfg_of_pulseview.png)

#### Sampling Parameters

Expand All @@ -84,7 +91,7 @@ Sampling parameters include sample quantity, sampling frequency and sampling tim
2. Sampling frequency: select according to the frequency of the signal to be measured, **recommended to choose more than 10 times the frequency of the signal to be measured**
3. Sampling time: sampling time is calculated based on the **sample quantity** and **sampling frequency**, the calculation formula is:</br>**Time (seconds) = Number of samples / Sampling rate**</br>For example, when 1M samples and 1Mhz, the sampling time is 1s

![](../../../zh/logic_analyzer/assets/set_total_sampling_time_of_pulseview.png)
![set_total_sampling_time_of_pulseview](./../../../zh/logic_analyzer/combo8/assets/use_logic_function/set_total_sampling_time_of_pulseview.png)

> After setting the sample quantity and sampling frequency, place the mouse over the sample quantity selection box, and it will display the sampling time for the current parameters
Expand All @@ -97,9 +104,7 @@ Click on the channel label to set the channel parameters, which include label na
3. Channel waveform display window width: set according to the signal amplitude, unit is pixels, when the signal amplitude changes greatly, you can increase this parameter to observe the signal amplitude change
4. **Signal trigger mode**: has **direct sampling**, **high level trigger**, **low level trigger**, **falling edge trigger**, **rising edge trigger** and **edge trigger**



![](../../../zh/logic_analyzer/assets/set_channel_cfg_of_pulseview.png)
![set_channel_cfg_of_pulseview](./../../../zh/logic_analyzer/combo8/assets/use_logic_function/set_channel_cfg_of_pulseview.png)

### Debugging Waveforms

Expand All @@ -112,21 +117,21 @@ Click on the channel label to set the channel parameters, which include label na
> - **Time measurement**: You can mark a position by right-clicking on the desired position and clicking "Create Marker Here". When you repeat marking another position, the software will automatically calculate and display the time length between the two markers on the time axis
> - **Adjust channel order**: mouse drag channel label can drag channel to specified position
![](../../../zh/logic_analyzer/assets/tag_of_pulseview.png)
![tag_of_pulseview](./../../../zh/logic_analyzer/combo8/assets/use_logic_function/tag_of_pulseview.png)

#### Protocol Decoding

> Clicking on the **yellow-blue waveform icon** from the top toolbar will list the currently supported protocol list, you can directly search for the protocol you want to decode on the list to add a new protocol, new protocol can be viewed in the waveform display area
![](../../../zh/logic_analyzer/assets/decoder_selector_of_pulseview.png)
![decoder_selector_of_pulseview](./../../../zh/logic_analyzer/combo8/assets/use_logic_function/decoder_selector_of_pulseview.png)

> On the waveform chart, a new protocol will occupy a row of channel waveform display window, click on the **protocol label**, you can set the basic parameters of the protocol. Taking UART protocol as an example, set UART protocol frequency to 115200, data bits to 8 bits, use ascii format decoding. After setting, the system will decode the waveform of the selected channel, so that you can more intuitively observe and analyze the communication data.
![](../../../zh/logic_analyzer/assets/set_decoder_cfg_of_pulseview.png)
![set_decoder_cfg_of_pulseview](./../../../zh/logic_analyzer/combo8/assets/use_logic_function/set_decoder_cfg_of_pulseview.png)

> After setting, the waveform display area will show the corresponding protocol decoding results of the waveform
![](../../../zh/logic_analyzer/assets/value_of_pulseview.png)
![value_of_pulseview](./../../../zh/logic_analyzer/combo8/assets/use_logic_function/value_of_pulseview.png)

### Precautions

Expand Down
Loading

0 comments on commit 241b238

Please sign in to comment.