AN 999: Drive-on-Chip with Functional Safety Design Example: Agilex™ 7 Devices

Download PDF
ID 823627
Date 7/04/2024
Public

Visible to Intel only — GUID: xll1716286282125

Ixiasoft

View Details

Document Table of Contents
Document Table of Contents x
1. About the Drive-on-Chip with Functional Safety Design Example for Agilex™ 7 Devices 2. Getting Started 3. Rebuilding the Drive-on-Chip Design 4. Functional Description of the Drive-On-Chip with Functional Safety Design Example for Agilex 7 Devices 5. HPS Channel Safety Software 6. Drive-on-Chip Design Recommendations and Disclaimers 7. Document Revision History for AN 999: Drive-on-Chip with Functional Safety Design Example for Agilex 7 Devices
1. About the Drive-on-Chip with Functional Safety Design Example for Agilex™ 7 Devices x
1.1. Features of the Drive-on-Chip with Functional Safety Design Example for Agilex 7 Devices 1.2. About the Safety Concept 1.3. Other Drive-on-Chip Design Documents
1.2. About the Safety Concept x
1.2.1. High-Level Block Diagram of the Drive-On-Chip with Functional Safety Design Example
2. Getting Started x
2.1. Software Requirements for the Drive-On-Chip with Functional Safety Design Example for Agilex 7 Devices 2.2. Hardware Requirements for the Safe Drive-On-Chip with Functional Safety Design Example for Agilex 7 Devices 2.3. Downloading and Installing the Design 2.4. Installing Python 2.5. Creating an SD Card Image 2.6. Setting Up your Development Board for the Drive-On-Chip with Functional Safety Design Example for Agilex 7 Devices 2.7. Debugging and Monitoring the Drive-On-Chip with Functional Safety Design Example for Agilex 7 Devices with Python GUI 2.8. Looking into the Drive-On-Chip Output
2.3. Downloading and Installing the Design x
2.3.1. Design Directory Structure
2.7. Debugging and Monitoring the Drive-On-Chip with Functional Safety Design Example for Agilex 7 Devices with Python GUI x
2.7.1. GUI Safety Function Tab for the Drive-On-Chip with Functional Safety Design Example for Agilex 7 Devices
3. Rebuilding the Drive-on-Chip Design x
3.1. Generating the Platform Designer System 3.2. Generating and Building the NiosV/g BSP for the Drive-On-Chip Design Example 3.3. Compiling the Hardware in the Intel Quartus Prime Software 3.4. Modifying the Motor Control Software Application 3.5. Generating .jic and .rbf files After Hardware Modifications 3.6. Recreate an SD Card Image 3.7. Modifying the HPS Safety Function Application
4. Functional Description of the Drive-On-Chip with Functional Safety Design Example for Agilex 7 Devices x
4.1. Drive-on-Chip Related Subsystems 4.2. HPS Safety Subsystem 4.3. Safety Subsystem 4.4. Shared Memory Subsystem 4.5. External Safety Logic 4.6. Hardware Subsystem 4.7. Voltage Thresholds 4.8. IP Input and Output Signals 4.9. Registers
4.3. Safety Subsystem x
4.3.1. Safety Block 4.3.2. Quadrature Encoder Pulse 4.3.3. Interval Timer
4.3.1. Safety Block x
4.3.1.1. Safety Function Block 4.3.1.2. Cross-Comparison Block
5. HPS Channel Safety Software x
5.1. Meta Layer and Yocto Build 5.2. HPS Channel Speed Monitoring Safety Application
5.1. Meta Layer and Yocto Build x
5.1.1. Layer Configuration Files 5.1.2. Board Support Package Recipes (recipes-bsp)
5.2. HPS Channel Speed Monitoring Safety Application x
5.2.1. Main (hps_safe_channel.c) 5.2.2. Speed Estimation Thread (speed_estmation.c/.h) 5.2.3. Printing Thread (print_safety.c/.h) 5.2.4. Safety Function Application (srt.c/.h) 5.2.5. Access to Devices 5.2.6. Core Isolation and Core Affinity
1. About the Drive-on-Chip with Functional Safety Design Example for Agilex™ 7 Devices
2. Getting Started
3. Rebuilding the Drive-on-Chip Design
4. Functional Description of the Drive-On-Chip with Functional Safety Design Example for Agilex 7 Devices
5. HPS Channel Safety Software
6. Drive-on-Chip Design Recommendations and Disclaimers
7. Document Revision History for AN 999: Drive-on-Chip with Functional Safety Design Example for Agilex 7 Devices

2.5. Creating an SD Card Image

The Drive-on-Chip with Functional Safety Design Example requires an SD card image (gsrd-console-image-agilex7.wic) and a .jic file (included in the images directory) to program and use on the Agilex7 SoC F-series Transceiver SoC Development Kit. To create an SD card image or, if you modify the design or rebuild the software layers, you should build a Yocto with the provided meta layer. The output of the Yocto build is an SD card image (.wic) to be use in the development kit. To build Yocto and create the SD card, refer to the RocketBoards GSRD web page.

Altera recommends you build the design using a specific version of the GSRD and Quartus Prime Pro. Altera provides no support for the design in later or earlier versions of the GSRD or Quartus Prime. You must solve any potential differences if you use any other version of the tools.

  1. In the GSRD:
    1. Follow the steps in Setting up the Environment.
    2. Ignore the steps Building the Hardware Design and Building Core RBF. You provide or generate the agilex7_dk_si_agf014ea.core.rbf from the Quartus Prime project..
    3. Follow the steps in Setting Up Yocto Build System.Use nandbield branch of the altera-opensource repository.
    4. Ignore the section Customize Yocto Build.
  2. Before building Yocto, copy the provided meta layer in hps_software directory to $TOP_FOLDER/gsrd_socfpga and add the layer to the project: 
    >> cp -r <PROJ_LOCATION>/hps_software/meta-safedriveonchip 
$TOP_PROJECT/gsrd_socfpga 
>> cd $TOP_FOLDER/gsrd_socfpga 
>> bitbake-layers add-layer meta-safedriveonchip 
>> bitbake-layers show-layers
    Figure 5. GSRD meta layers including meta-safedriveonchip.
  3. Check your desired .rbf is in $TOP_FOLDER/gsrd_socfpga/meta-safedriveonchip/recipes-bsp/hw-ref-design/files/ with the name agilex7_dk_si_agf014ea.core.rbf.
  4. Write the correct sha256sum value of the .rbf to the $TOP_FOLDER/gsrd_socfpga/meta-safedriveonchip/recipes-bsp/hw-ref-design/hw-ref-design.bb recipe.
    Figure 6. hw-ref-design.bb recipe for .rbf inclusion
  5. Build Yocto: 
    >> cd $TOP_FOLDER/gsrd_socfpga
>> bitbake_image
>> package
    The gsrd-console-image-agilex7.wic file for SD card is in $TOP_FOLDER/gsrd_socfpga/agilex7_dk_si_agf014ea-gsrd-images.
  6. Burn the SD card using the image with a tool like SD imager or follow the steps in the GSRD Creating SD card.
Related Information
Level Two Title