Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revision | |||
programmable-logic:zybo-z7:demos:pmod-tof [2022/09/12 13:49] – changed forum.digilentinc.com to forum.digilent.com Jeffrey | programmable-logic:zybo-z7:demos:pmod-tof [2023/08/25 00:36] (current) – Move to direct file links for downloads Arthur Brown | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Zybo Z7-20 Pmod ToF Demo ====== | ||
+ | {{: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Description ========= | ||
+ | |||
+ | This demo was created to show the functionalities of the [[pmod: | ||
+ | |||
+ | Please consult the [[pmod: | ||
+ | |||
+ | Besides these functionalities, | ||
+ | * The UART Module provides the communication between the UART interface of the system board (USB - UART interface) and the host computer. | ||
+ | * The PmodToFCMD Module is used for interpreting UART commands. | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Inventory ===== | ||
+ | |||
+ | * Zybo Z7-20 with a MicroUSB Programming Cable | ||
+ | * Vivado and Vitis installations compatible with the latest release of this demo | ||
+ | * //See [[programmable-logic: | ||
+ | * Serial Terminal application to communicate with the board | ||
+ | * //See [[programmable-logic: | ||
+ | * Pmod ToF | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Download and Usage Instructions ===== | ||
+ | |||
+ | First and foremost, releases - consisting of a set of files for download - are only compatible with a specific version of the Xilinx tools, as specified in the name of the release (referred to as a //release tag//). In addition, releases are only compatible with the specified variant of the board. For example, a release tagged " | ||
+ | |||
+ | The latest release version for this demo is highlighted in green. | ||
+ | |||
+ | **Note:** //Releases for FPGA demos from before 2020.1 used a different git structure, and used a different release tag naming scheme.// | ||
+ | |||
+ | ^ Board Variant | ||
+ | | Zybo Z7-20 | @#C0EEBD: 20/ | ||
+ | | Zybo Z7-20 | 20/ | ||
+ | | Zybo Z7-20 | 20/ | ||
+ | | Zybo Z7-20 | 20/ | ||
+ | |||
+ | **Note for Advanced Users:** //GitHub sources for this demo can be found in the [[https:// | ||
+ | ---- | ||
+ | Instructions on the use of the latest release can be found in this dropdown: | ||
+ | |||
+ | --> Using the Latest Release #^ | ||
+ | <WRAP group> | ||
+ | |||
+ | {{page> | ||
+ | |||
+ | {{page> | ||
+ | |||
+ | --> Build a Vitis Application # | ||
+ | <WRAP group> | ||
+ | {{page> | ||
+ | </ | ||
+ | <-- | ||
+ | |||
+ | --> Set up the Zybo Z7 # | ||
+ | <WRAP group> | ||
+ | <WRAP group> | ||
+ | Plug the Zybo Z7-20 into the computer via the microUSB programming cable and power on the board. Make sure the JP5 jumper is set to JTAG. | ||
+ | |||
+ | Plug the ToF Pmod into JB Pmod port of the Zybo. | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | <-- | ||
+ | |||
+ | {{page> | ||
+ | |||
+ | At this point, the demo is now running on your board. Refer to the [[# | ||
+ | ---- | ||
+ | Additional steps beyond here present how you can use the other archive provided in the release, containing the hardware project, to rebuild the Vivado project, and use a newly exported XSA file to update the platform in Vitis. | ||
+ | ---- | ||
+ | {{page> | ||
+ | </ | ||
+ | <-- | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Functionality ====== | ||
+ | |||
+ | After the board is programmed and a terminal window (such as Tera Term) is opened, the user is shown all the possible options and is prompted to type the code related to the desired command. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Note**:// | ||
+ | |||
+ | ---- | ||
+ | |||
+ | === 1. ToFMeasure | ||
+ | > This command initiates a measurement and displays the distance measured by the device over UART. Before running this command, it is important that a manual calibration was performed or that a calibration was stored in then imported from the EEPROM user area or that factory calibration was restored from EEPROM. | ||
+ | |||
+ | > If the measurement is performed correctly, the response of the command should be: // | ||
+ | |||
+ | * //In case the program crashes during this command, try to power off the board. Then power it back on and program it once again// | ||
+ | |||
+ | ---- | ||
+ | |||
+ | === 2. ToFStartCalib | ||
+ | |||
+ | > This command performs a manual calibration. It calls all 3 calibration routines (magnitude, crosstalk, and distance). | ||
+ | |||
+ | * Response: | ||
+ | | ||
+ | ^ Answer | ||
+ | | " | ||
+ | | " | ||
+ | | " | ||
+ | |||
+ | |||
+ | For details about how to perform a manual calibration, | ||
+ | |||
+ | ---- | ||
+ | |||
+ | === 3. ToFSaveCalib | ||
+ | |||
+ | > This command is used to write calibration data into the user calibration area of EEPROM. | ||
+ | > This command should be issued after changes were made in calibration data(after a manual calibration), | ||
+ | |||
+ | * Response: | ||
+ | | ||
+ | ^ Response | ||
+ | | “OK, Calibration stored to EEPROM user space." | ||
+ | | " | ||
+ | | " | ||
+ | |||
+ | ---- | ||
+ | |||
+ | === 4. ToFRestoreFactCalib | ||
+ | > This command it is used to restore the factory calibration data from EEPROM. When this command is run, the factory calibration data from EEPROM is read and then written into the user calibration area of EEPROM and into ISL29501 registers. | ||
+ | |||
+ | * Response: | ||
+ | |||
+ | ^ Response | ||
+ | | “OK, | ||
+ | | " | ||
+ | | " | ||
+ | | " | ||
+ | | " | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | === 5. ReadSerialNo | ||
+ | |||
+ | > This command retrieves the 12 digit serial number information from EEPROM and displays the Pmod's serial number over UART. | ||
+ | |||
+ | ---- | ||
+ | |||
+ | === 6. Quit < q > === | ||
+ | |||
+ | > This command determines the program to exit the command loop, being unable to receive any other commands. | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Additional Resources ===== | ||
+ | |||
+ | All materials related to the use of the Zybo Z7 can be found on its [[..: | ||
+ | |||
+ | All materials related to the use of the list other products here can be found on their resource centers, linked below: | ||
+ | |||
+ | * Pmod ToF [[pmod: | ||
+ | |||
+ | For a walkthrough of the process of creating a simple baremetal software project in Vivado and Vitis, see [[programmable-logic: | ||
+ | |||
+ | For technical support, please visit the [[https:// | ||
+ | |||
+ | ---- |