KeeYees USB Logic Analyzer (Model KYES57) Instruction Manual

1. Introduction

The KeeYees USB Logic Analyzer (Model KYES57) is a versatile and essential tool for electronic system development and debugging. This device offers 8 channels and a 24MHz sampling rate, making it suitable for analyzing various communication protocols such as UART, IIC, and SPI. It is designed to assist in microcontroller, ARM system, and FPGA development by providing precise data analysis capabilities. Its compact design and broad compatibility with personal computers, laptops, smartphones, and tablets make it a valuable asset for both hobbyists and professionals.

2. What's Included

Your KeeYees USB Logic Analyzer package contains the following components:

• 1 x KeeYees USB Logic Analyzer Device (Model KYES57)
• 1 x USB Cable for power and data transfer
• 12 x 6-Color Test Hook Clips
• Jumper Wires (female-to-female)

Figure 2.1: KeeYees USB Logic Analyzer kit components, including the analyzer, USB cable, and multi-color jumper wires.

Figure 2.2: Close-up view of the included 6-color test hook clips.

3. Setup

Follow these steps to set up your KeeYees USB Logic Analyzer:

1. Software Installation: The KeeYees USB Logic Analyzer is compatible with open-source software such as PulseView (part of the Sigrok project). Download and install the latest version of PulseView for your operating system (Windows, Linux, macOS).
2. Driver Installation:
   • Windows: After installing PulseView, you may need to install or update the device drivers. This often involves using a tool like Zadig to replace the default driver with a WinUSB driver. Refer to the Sigrok documentation for detailed instructions. Multiple driver installations might be required for proper device recognition.
   • Linux: For Linux users, installing the Sigrok package (e.g., sudo apt-get install sigrok on Ubuntu) typically provides the necessary components. You may need to configure udev rules to allow non-root users to access the device. Alternatively, running PulseView with elevated privileges (sudo pulseview) can bypass permission issues, though configuring udev rules is recommended for regular use.
3. Connect the Device: Connect the KeeYees USB Logic Analyzer to your computer using the provided USB cable. The device should be recognized by your operating system.
4. Connect Test Clips/Wires: Attach the multi-color jumper wires to the 8-channel input pins (CH1-CH8), PWR, CLK, and GND on the logic analyzer. Then, connect the test hook clips to the other end of the jumper wires. These clips will be used to connect to the test points on your circuit.

Figure 3.1: Pinout labels on the KeeYees USB Logic Analyzer (CH1-CH8, PWR, CLK, GND).

4. Operating the Logic Analyzer

Once the hardware is connected and software is installed, you can begin using your logic analyzer:

1. Launch PulseView: Open the PulseView application on your computer.
2. Select Device: In PulseView, select the KeeYees Logic Analyzer (often listed as 'Saleae Logic' or similar compatible device).
3. Configure Settings:
   • Sampling Rate: Set the sampling rate to 24MHz for optimal performance.
   • Channels: Enable the channels (CH1-CH8) you intend to monitor.
   • Trigger: Configure trigger conditions based on your analysis needs. For protocols like I2C, setting a pre-channel trigger (e.g., 10%) can help capture initial bytes that might otherwise be missed.
4. Connect to Circuit: Carefully connect the test hook clips to the desired test points on your target circuit. Ensure proper ground connections.
5. Start Capture: Click the 'Run' or 'Capture' button in PulseView to begin data acquisition.
6. Protocol Analysis: PulseView supports various protocol decoders (e.g., UART, IIC, SPI, 1-Wire). Select the appropriate decoder for your communication protocol and assign the relevant channels. The software will then display decoded data, making it easier to understand the signal traffic.

5. Maintenance

To ensure the longevity and optimal performance of your KeeYees USB Logic Analyzer, follow these maintenance guidelines:

• Cleaning: Keep the device and its accessories clean. Use a soft, dry cloth to wipe the analyzer. Avoid using harsh chemicals or abrasive materials.
• Storage: Store the logic analyzer and its components in a dry, dust-free environment when not in use. Protect the test clips and wires from tangling or damage.
• Cable Care: Handle the USB cable and jumper wires carefully. Avoid sharp bends or excessive pulling that could damage the internal conductors.

6. Troubleshooting

If you encounter issues with your KeeYees USB Logic Analyzer, refer to the following common problems and solutions:

• Device Not Recognized by Software:
  • Check USB Connection: Ensure the USB cable is securely connected to both the logic analyzer and your computer. Try a different USB port or cable.
  • Driver Issues: Re-verify driver installation. For Windows, ensure the correct WinUSB driver is installed via Zadig. For Linux, check udev rules or try running PulseView with sudo to rule out permission problems. Sometimes, reinstalling drivers multiple times can resolve recognition issues.
  • Faulty USB Cable: Some users have reported issues with the included USB cable. If possible, try using a different, known-good USB cable.
• Test Clips/Wires Not Connecting Properly:
  • The included jumper wires may require modification to securely connect to the test clips. This often involves removing one end of the jumper wire, disassembling the clip, inserting the exposed wire end, and soldering it to the rivet inside the clip before reassembling.
  • Ensure the clips are firmly attached to the test points on your circuit.
• Missing Initial Bytes in Protocol Analysis (e.g., I2C):
  • In PulseView, adjust the 'Pre-channel trigger' setting (e.g., to 10%) to capture data before the main trigger event, which can help include initial communication bytes.
• Software Crashes or Instability:
  • Ensure you are using a stable version of PulseView (e.g., version 0.4.2 as suggested by some users) rather than nightly builds, which may have unresolved issues.
  • Check for available software updates.

7. Specifications

8. Support

For further assistance and resources, please refer to the following:

• Detailed Tutorials: KeeYees provides comprehensive tutorials, including guidance manuals, demo code, burning tools, and necessary class libraries. These resources are available on the official KeeYees GitHub page: github.com/Keeyees/KY-57.
• Contact Support: If you require direct assistance, you can contact KeeYees support through Amazon. They can provide PDF documentation and further guidance.
• Product Page: For additional product information and updates, visit the official KeeYees store on Amazon: KeeYees Store.

9. Warranty Information

KeeYees products are designed for reliability and performance. While specific warranty details are not provided in this manual, standard return and replacement policies typically apply for products purchased through authorized retailers like Amazon. Please refer to your purchase documentation or the retailer's website for the most accurate and up-to-date warranty information. For any manufacturing defects or issues arising from normal use, please contact KeeYees customer support as detailed in the Support section.