Quartus® Prime Pro Edition User Guide: Platform Designer

ID 683609
Date 9/30/2024
Public
Document Table of Contents

1.21.5. Modifying the Packaged Subsystem Script

The packaged subsystem infrastructure uses a Tcl script file to specify the packaged subsystem properties. You can modify the packaged subsystem script on the Packaged Subsystem Script tab to control the following in the packaged subsystem:
  • Add parameters to enable or disable individual IP components in the packaged subsystem.
  • Lock or unlock packaged subsystem editing for packaged subsystem users.
  • Add packaged subsystem-level parameters that set parameter values of internal components.
  • Modify the internal .qsys system file.

For example, when you enable or disable components on the Components tab, Platform Designer modifies the default script lines correspondingly in the packaged subsystem script when you right-click in the Packaged Subsystem Script tab and click Reset with Default Script. The packaged subsystem author can optionally modify the packaged subsystem script directly on the Packaged Subsystem Script tab.

For example, the following code creates two checkbox controls that are visible in the parameter editor GUI of the packaged subsystem for packaged subsystem users. These controls are linked to the RX and TX packaged subsystem level parameters. The RX and TX parameters are of type boolean and are asserted false by default.

add_parameter TX BOOLEAN false "Enable transmitter"
add_parameter RX BOOLEAN false "Enable receiver"
Note: For details on these commands, refer to Parameters.
To modify the packaged subsystem script, follow these steps:
  1. In the Components tab of the New Packaged Subsystem dialog box, define the basic properties of a the packaged subsystem, as Creating a New Platform Designer Packaged Subsystem describes.
  2. Click the Packaged Subsystem Script tab.
  3. Modify any of the script in the Packaged Subsystem Script tab to match your deployment preferences. For example, the following modification allows the packaged subsystem user to unlock the packaged subsystem for full control.
    Figure 110. Packaged Subsystem Script Change (Subsystem Can Be Unlocked)


  4. When the packaged subsystem is complete, click Save in the New Package dialog box. The .qcp file saves to the location that you specify, and the packaged subsystem appears under Project in IP Catalog.