Using the EZ-PD™ Protocol Analyzer Utility 3.1.0 – KBA232779
- Subscribe to RSS Feed
- Mark as New
- Mark as Read
- Bookmark
- Subscribe
- Printer Friendly Page
- Report Inappropriate Content
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.
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.
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:
- Download JRE binaries in *.tar.gz for Linux from https://www.java.com/en/download/manual.jsp
- Create a directory to install JRE with the command:
sudo mkdir/usr/local/java
- Move the JRE binaries into the directory:
sudo mv jre-8u281-linux-x64.tar.gz /usr/local/java
- Go to the install directory:
cd /usr/local/java
- Unpack the tarball:
sudo tar zxvf jre-8u281-linux-x64.tar.gz
- To save space, delete the tarball by running:
sudo rm jre-8u281-linux-x64.tar.gz
- 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:
- 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.
- Invoke the utility from the Windows Start Menu > Cypress > EZ-PD Protocol Analyzer Utility.
- 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.
Figure 3: Error when the Java version doesn’t match the system
- Uninstall the current version; reinstall the correct version and launch the utility again.
Linux:
- Download the latest version of the EZ-PD Protocol Analyzer Utility. Extract the zip package and open a terminal inside the extracted directory.
- Execute the following one-time commands:
export SWT_GTK3=0
chmod a+x CY4500_EZ_PD_Protocol_Analyzer_Utility
- The EZ-PD Protocol Analyzer Utility 3.1.0 should be invoked in superuser mode.
- 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:
- 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.
- 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.
- Open the extracted .zip package to run EZ-PD Protocol Analyzer Utility 3.1.0.
- 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.
Figure 4: Verification error when trying to open the utility
Figure 5: Change the settings to allow the utility to be opened
- Run EZ-PD Protocol Analyzer Utility 3.1.0 again.
Step 3: Update the firmware for CY4500 EZ-PD Protocol Analyzer Kit (Windows)
- 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.
- 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.
Figure 6: Firmware update required dialog
- 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
Figure 7: Load the file on the firmware download dialog
- 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
- Click Program to initiate the firmware download process and Exit when it is completed successfully.
Figure 8: Firmware download completed successfully
- 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)
- Install Parallels Desktop and add a virtual machine for Windows on the Macbook.
Figure 9: Running Windows virtual machine on Parallels Desktop
- Ensure that more than 4GB RAM is allocated for the Windows virtual machine as shown below.
Figure 10: Modifying the memory allocation under configuration for the virtual machine
- Follow Steps 1 and 2 to install Java and EZ-PD Protocol Analyzer Utility 3.1.0 on the Windows virtual machine.
- 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.
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.
Figure 12: Modifying the CY4500_EZ_PD_Protocol_Analyzer_Utility.ini file
- Update the firmware using the Firmware Update tool as described Step 3.
References: