From 3edb8c0df10e9702e64d90f3de507e01934ca644 Mon Sep 17 00:00:00 2001 From: Vattipalli Praveen Date: Wed, 15 Mar 2023 11:50:24 +0530 Subject: [PATCH] Readme: Update arguments supported by TCL script Signed-off-by: Vattipalli Praveen --- Readme.md | 62 +++++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 58 insertions(+), 4 deletions(-) diff --git a/Readme.md b/Readme.md index d3de077..a204c33 100644 --- a/Readme.md +++ b/Readme.md @@ -1,5 +1,25 @@ -# PolarFire® SoC Video Kit Reference Design Generation Tcl Scripts - Libero® SoC v2022.3 - +# PolarFire® SoC Video Kit Reference Design Generation Tcl Scripts - Libero® SoC v2022.3+ + +## Table of Contents + +- [PolarFire® SoC Video Kit Reference Design Generation Tcl Scripts - Libero® SoC v2022.3+](#polarfire-soc-video-kit-reference-design-generation-tcl-scripts---libero-soc-v20222) + - [Table of Contents](#table-of-contents) + - [Description](#description) + - [Using the reference design generation Tcl script](#using-the-reference-design-generation-tcl-script) + - [Licensing](#licensing) + - [Standard design generation](#standard-design-generation) + - [Arguments supported](#arguments-supported) + - [Programming the FPGA](#programming-the-fpga) + - [Board configuration](#board-configuration) + - [MSS Configuration](#mss-configuration) + - [XML](#xml) + - [Setting the boot mode and programming the eNVM](#setting-the-boot-mode-and-programming-the-envm) + - [Boot mode 0](#boot-mode-0) + - [Boot mode 1](#boot-mode-1) + - [Boot mode 1: SoftConsole](#boot-mode-1-softconsole) + - [Boot mode 1: Libero SoC](#boot-mode-1-libero-soc) + + ## Description This repository can be used to generate a reference design for the PolarFire SoC Video Kit. This reference design will have the same or extended functionality compared to the pre-programmed FPGA design on the Video Kit. @@ -8,9 +28,16 @@ A Libero SoC Tcl script is provided to generate the reference design using Liber This repository supports Libero SoC v2022.3, which is available for download [here](https://www.microsemi.com/product-directory/design-resources/1750-libero-soc#downloads). + +### Licensing + +The Video Kit Reference Design can be generated using any of the free or paid Libero licenses. Licensing information is available on the Microchip website [here](https://www.microchip.com/en-us/products/fpgas-and-plds/fpga-and-soc-design-tools/fpga/licensing). + + ## Using the reference design generation Tcl script -#### Standard design generation + +### Standard design generation To generate the standard reference design which is capable of running the majority of bare metal example applications and run Linux® the following flow can be used: @@ -21,15 +48,36 @@ To generate the standard reference design which is capable of running the majori 5. Configure the design if required 6. Run the Libero SoC design flow to program a device +**Note:** The H.264 I-Frame Encoder Encrypted IP is Licensed. If the license is not available, the TCL generates the design with an Evaluation license which expires after an hour’s use on the hardware. So, the streaming stops after an hour + + +### Arguments supported + +Below arguments are supported to modify or configure aspects of the design flow that will be run. Supported arguments are: + +| Argument | Description | +| :------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| HSS_UPDATE | Downloads the HSS release hex file associated with this release of the reference design.
The hex file is added as an eNVM client in Libero.
This argument requires wget to be installed.
This is installed by default on most Linux systems, on Windows® wget (version 1.14 or above) should be installed and added to the system path, steps are shown in the following [guide](https://www.addictivetips.com/windows-tips/install-and-use-wget-in-windows-10/) | +| SYNTHESIZE | Runs the synthesis step after design generation has completed | +| PLACEROUTE | Runs the synthesis and place and route steps after design generation has completed | +| VERIFY_TIMING | Runs the synthesis, place and route and timing verification steps after design generation has completed | +| GENERATE_PROGRAMMING_DATA | Generates the files required to generate a bitstream for programming a device | +| PROGRAM | Runs the full design flow after generating a design and programs a connected device.
Note: the device must be connected when the "Run PROGRAM Action" stage of the design flow is reached and only one device should be connected | +| EXPORT_FPE | Runs the full design flow after generating a design and exports a FlashPro Express file to the local directory | +| EXPORT_FPE:PATH | Runs the full design flow after generating a design and exports a FlashPro Express file to a specified path e.g EXPORT_FPE:/home/user/jobs/ | + + ## Programming the FPGA Once the script has completed the design can be configured further if needed and the Libero SoC design flow can be run by double clicking on a stage in the design flow on the left hand side of Libero. Selecting an option requiring previous steps to be completed will run the full flow, i.e double clicking "Run Program Action" will run any required steps, such as, "Synthesize", "Place and Route", etc and then program the device. + ## Board configuration Setting up the jumpers on the PolarFire SoC Video Kit, refer to the [Video Kit user's guide](https://mi-v-ecosystem.github.io/redirects/boards-mpfs-sev-kit-sev-kit-user-guide). -The latest Linux images for the PolarFire SoC Video Kit are available from the releases section of the [Meta PolarFire SoC Yocto BSP](https://mi-v-ecosystem.github.io/redirects/releases-meta-polarfire-soc-yocto-bsp) repository. +The latest Linux images for the PolarFire SoC Video Kit are available from the releases section of the [Meta PolarFire SoC Yocto BSP](https://mi-v-ecosystem.github.io/redirects/releases-meta-polarfire-soc-yocto-bsp) repository. + ## MSS Configuration The Microprocessor Subsystem (MSS) is configured using the PolarFire SoC MSS Configurator. @@ -39,14 +87,17 @@ The MSS component file can be imported into a Libero SoC design and used in the A saved configuration for the PolarFire SoC MSS Configurator is available in the "script_support" folder and can be opened by the PolarFire SoC MSS Configurator. These configurations will match the MSS configuration used in the design and can be used to regenerate XML and a Libero component. For argument based designs, MSS configuration files will be generated in the script_support/MSS_VIDEO_KIT/[configuration name] directory when a design is generated. + ## XML The Microcontroller Subsystem (MSS) configuration is captured in an XML file that is then used by the PolarFire SoC Configuration Generator to generate configuration header files. These header files are compiled as part of the MPFS HAL startup code to configure the system at power on. XML generated for all available configurations is provided in the "XML" folder. + ## Setting the boot mode and programming the eNVM + ### Boot mode 0 Boot mode 0 will put all of the MSS cores into WFI (Wait For Interrupt) mode on power on, the cores will not boot until debugged. SoftConsole v6.5 or later can be used to set the PolarFire SoC boot mode to 0: @@ -54,12 +105,14 @@ Boot mode 0 will put all of the MSS cores into WFI (Wait For Interrupt) mode on 2. In SoftConsole select the "External Tool" drop down menu 3. Select the "PolarFire SoC idle boot mode 0" configuration and run + ### Boot mode 1 Boot mode 1 configures all of the MSS cores to boot from the eNVM, when setting the boot mode to 1 an eNVM client must also be provided An eNVM client can be a zero stage boot loader, such as the HSS, or a bare metal application. SoftConsole v6.4 and above or Libero SoC v12.6 and above can be used to set the boot mode and program the eNVM. Build the bare metal application using the reference XML provided to configure the MPFS HAL (XML will also be generated in the script_support/components/[target] folder when an MSS component is generated as part of the flow). + #### Boot mode 1: SoftConsole To set the PolarFire SoC boot mode to 1 and program an eNVM client in SoftConsole: @@ -68,6 +121,7 @@ To set the PolarFire SoC boot mode to 1 and program an eNVM client in SoftConsol 3. In SoftConsole select the "External Tool" drop down menu 4. Select the "PolarFire SoC non-secure boot mode 1" configuration and run + #### Boot mode 1: Libero SoC To set the PolarFire SoC boot mode to 1 and program and eNVM client in Libero: