cancel
Showing results for 
Search instead for 
Did you mean: 

Knowledge Base Articles

Using the EZ-PD™ Protocol Analyzer Utility 3.1.0 – KBA232779

ArunKumarChoul
Employee

Using the EZ-PD™ Protocol Analyzer Utility 3.1.0 – KBA232779

Version: **

Question:
What are the steps to use the EZ-PD Protocol Analyzer Utility 3.1.0 with the CY4500 EZ-PD Protocol Analyzer Kit?

Answer:
The CY4500 EZ-PD Protocol Analyzer Kit is a device that can capture real-time traffic on the CC lines passively, allowing users to analyze and debug USB PD data. It can be used with the latest EZ-PD Protocol Analyzer Utility 3.1.0, which is a Java-based cross platform GUI that can decode PD 2.0, PD 3.0, USB4, and extended messages. It also allows monitoring of the CC lines, VBUS voltage, and current values, and displays them in a graphical form.

ArunKumarChoul_0-1624336247945.png

Figure 1. CY4500 EZ-PD Protocol Analyzer Kit connected to CY4531 EZ-PD CCG3 EVK

Step 1: Install Java 8 (prerequisite for the utility)

Windows:

The EZ-PD Protocol Analyzer installer will show a prompt to install Java 8 with a link to the Java downloads page.

ArunKumarChoul_1-1624336340013.png

Figure 2: Prompt to install Java on Windows

Note that 32-bit Java 8 should be installed on Windows 32-bit systems and 64-bit Java 8 should be installed on Windows 64-bit systems.

 Linux:

  1. Download JRE binaries in *.tar.gz for Linux from https://www.java.com/en/download/manual.jsp
  2. Create a directory to install JRE with the command:

sudo mkdir/usr/local/java

  1. Move the JRE binaries into the directory:

sudo mv jre-8u281-linux-x64.tar.gz /usr/local/java

  1. Go to the install directory:

cd /usr/local/java

  1. Unpack the tarball:

sudo tar zxvf jre-8u281-linux-x64.tar.gz

  1. To save space, delete the tarball by running:

sudo rm jre-8u281-linux-x64.tar.gz

  1. Let the system know where JRE is installed:

sudo update-alternatives --install "/usr/bin/java" "java" "/usr/local/java/jre1.8.0_281/bin/java" 1.

MacOS:

Download JDK 8 *.dmg installer from https://www.oracle.com/in/java/technologies/javase/javase-jdk8-downloads.html

To check the Java version installed, enter the “java -version” command on the command line interface.
After the Java installation is complete, install and run the EZ-PD Protocol Analyzer Utility 3.1.0.

Step 2: Install the EZ-PD Protocol Analyzer Utility
Visit the CY4500 EZ-PD Protocol Analyzer web page to find the various installation options for the utility.

Windows:

  1. Download and install the latest version of the EZ-PD Protocol Analyzer Utility. By default, the utility is installed under the
    <Install Directory>\EZ-PD Protocol Analyzer Utility\
    directory.

Note: The default <Install Directory> is C:\Users\{%USERPROFILE%}\Cypress.

  1. Invoke the utility from the Windows Start Menu > Cypress > EZ-PD Protocol Analyzer Utility.
  2. If the Java version is not correct and a 32-bit Java 8 is installed on a 64-bit system or vice versa, the following error will occur.
ArunKumarChoul_3-1624336867147.png


Figure 3: Error when the Java version doesn’t match the system

  1. Uninstall the current version; reinstall the correct version and launch the utility again.

Linux:

  1. Download the latest version of the EZ-PD Protocol Analyzer Utility. Extract the zip package and open a terminal inside the extracted directory.
  2. Execute the following one-time commands:

export SWT_GTK3=0
chmod a+x CY4500_EZ_PD_Protocol_Analyzer_Utility

  1. The EZ-PD Protocol Analyzer Utility 3.1.0 should be invoked in superuser mode.
  2. Command: sudo ./CY4500_EZ_PD_Protocol_Analyzer_Utility

MacOS:
Download the latest version of the EZ-PD Protocol Analyzer Utility. Open the extracted zip package to run EZ-PD Protocol Analyzer Utility 3.1.0.

MacOS Catalina:

  1. Open Safari and go to Safari > Preference and uncheck “Open “safe” files after downloading” option. Download the latest version of the EZ-PD Protocol Analyzer Utility.
  2. Extract the .zip package using an application such as Unarchiver. This is because the default Archive Utility may not be able to extract it properly due to security restrictions. Ensure that it is extracted to a folder that is not write-protected on your system.
  3. Open the extracted .zip package to run EZ-PD Protocol Analyzer Utility 3.1.0.
  4. If an error appears that the utility cannot be opened because the developer cannot be verified (see Figure 4), go to System Preferences > Security and Privacy and click Open Anyway.
ArunKumarChoul_4-1624337808454.png

 Figure 4: Verification error when trying to open the utility

 

ArunKumarChoul_5-1624337834843.png

Figure 5: Change the settings to allow the utility to be opened

  1. Run EZ-PD Protocol Analyzer Utility 3.1.0 again.

Step 3: Update the firmware for CY4500 EZ-PD Protocol Analyzer Kit (Windows)

  1. Along with the EZ-PD Protocol Analyzer Utility, the CY4500 EZ-PD Protocol Analyzer Kit contents should be installed from the CY4500 EZ-PD Protocol Analyzer web page using the respective installers to get the necessary driver files.
  2. Open the EZ-PD Protocol Analyzer utility on a Windows host PC with the CY4500 EZ-PD Protocol Analyzer Kit connected. Start the capture by clicking Action > Start. If the following dialog appears, the kit is programmed with an older firmware and should be updated.
ArunKumarChoul_6-1624338041415.png

Figure 6: Firmware update required dialog

  1. Launch the Firmware Update tool (EZPD_Firmware_Update_Tool.exe) from the following location: <install directory>\EZ-PD Protocol Analyzer Utility\Firmware_Update_Tool\EZPD_Firmware_Update_Tool.exe
ArunKumarChoul_7-1624338085516.png

Figure 7: Load the file on the firmware download dialog

  1. Click Load File… and select the firmware binary from the following location: <install Directory>\EZ-PD Protocol Analyzer Utility\Firmware_Update_Tool\CY4500_EZ-PD_ProtocolAnalyzer_FW_2_0_7_0.cyacd
  1. Click Program to initiate the firmware download process and Exit when it is completed successfully.
ArunKumarChoul_8-1624338148357.png

Figure 8: Firmware download completed successfully

  1. The CY4500 EZ-PD Protocol Analyzer Kit will restart with the new firmware and can be used with the EZ-PD Protocol Analyzer Utility 3.1.0.

Step 4: Update the firmware for CY4500 EZ-PD Protocol Analyzer Kit (MacOS)

  1. Install Parallels Desktop and add a virtual machine for Windows on the Macbook.
ArunKumarChoul_9-1624338246328.png

Figure 9: Running Windows virtual machine on Parallels Desktop

  1. Ensure that more than 4GB RAM is allocated for the Windows virtual machine as shown below.
ArunKumarChoul_10-1624338308318.png

Figure 10: Modifying the memory allocation under configuration for the virtual machine

  1. Follow Steps 1 and 2 to install Java and EZ-PD Protocol Analyzer Utility 3.1.0 on the Windows virtual machine.
  2. If the error shown in Figure 11 appears while running the utility, the CY4500_EZ_PD_Protocol_Analyzer_Utility.ini file in the installation directory needs to be modified.
ArunKumarChoul_11-1624338346489.png

Figure 11: Error while trying to run the utility

Replace the line “plugins/org.eclipse.equinox.launcher.win32.win32.x86_1.1.551.v20171108-1834” with “plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.1.551.v20171108-1834” as shown below.

ArunKumarChoul_12-1624338529202.png

Figure 12: Modifying the CY4500_EZ_PD_Protocol_Analyzer_Utility.ini file

  1. Update the firmware using the Firmware Update tool as described Step 3.

References:

 

0 Likes
Version history
Revision #:
1 of 1
Last update:
‎Jun 21, 2021 10:13 PM
Updated by:
 
Contributors