KB: Setting Independent Component Parameters for Repeated Multi-Channel Designs

Altium Designer Altium Designer
In multi-channel designs, there are situations where additional component parameters must have different values for each repeated channel instance. By default, when a custom parameter is added directly to a component in a repeated channel, that parameter value is shared across all repeated instances, which makes it unsuitable for cases where each channel requires a unique value. This article outlines methods for independent parameter values using sheet symbol parameters and variant configurations.

Solution Details

Need for Unique Component Parameters in Repeated Channels

In some multi-channel designs, each repeated channel must carry unique metadata or configuration values via component parameters. Typical examples include per-channel identifiers, calibration values, gain settings, or other channel-specific configuration data. When these parameters are added directly to components that are part of a repeated channel, they cannot be assigned unique values per channel because the same schematic component definition is reused.

This limitation becomes especially visible in designs where many channels are structurally identical, but must be distinguished through parameter values—for instance, when generating documentation, or BOMs.

Shared Parameters in Repeated Channels

In a multi-channel design that uses the Repeat keyword, component parameters are shared across all repeated channel instances. When a custom parameter is added directly to a component in the repeated sheet, the schematic engine treats that parameter as part of the common component definition. As a result, the same parameter name and value are applied to every instance of that component in all repeated channels.

The system does not automatically differentiate parameter values per channel unless that differentiation is introduced at the sheet symbol or variant level. Without using sheet symbol parameters or variant parameters, all channels will reflect the same parameter values, regardless of how many times the sheet is repeated.

Available Options for Independent Parameter Values

To achieve unique parameter values per repeated channel, use one or both of the following approaches:

  • Use sheet symbol copy instead of the Repeat keyword
    • Manually copy sheet symbols instead of using Repeat for multi-channel replication.
    • Drive component parameters from sheet symbol parameters so each sheet instance can have independent values.
  • Use variant parameters for configuration-level control
    • Define the custom parameter in the component library.
    • Use Variant Manager to assign different parameter values per variant, which can then be associated with different channels as required.

These approaches allow each channel instance to receive distinct parameter values while still leveraging schematic reuse concepts.

Implementing Sheet Symbol Parameter-Based Control

Use this method when you want each channel to have its own parameter values without relying on variants.

1. Avoid using the Repeat keyword for channel replication

    1. Open the parent schematic that contains the sheet symbol for the channel.
    2. Instead of configuring the sheet symbol with a Repeat keyword, create the first channel as a standard sheet symbol instance.
    3. Copy and paste the sheet symbol to create additional channel instances.

2. Add a Channel Value special string parameter to the component

    1. Open the repeated-channel schematic sheet that contains the component requiring a unique parameter.
    2. Select the target component.
    3. Add a new parameter to the component (for example, Channel Value), and set its value as a special string, e.g. =Channel Value.
      • This special string will later be mapped from the sheet symbol parameter.

3. Define unique values at the sheet symbol level

    1. Return to the parent schematic that contains all the sheet symbols for each channel.
    2. For each sheet symbol instance:
      • Open its Properties and add a parameter named Channel Value.
      • Assign a unique value for each channel, such as CH1, CH2, CH3, or specific numeric values.

4. Propagate sheet symbol parameters to components

    1. Recompile or update the project so the schematic compiler propagates the sheet symbol parameter values down to the lower-level components.
    2. Check the component on each channel sheet: the Channel Value parameter should now reflect the unique value defined on the corresponding sheet symbol.

By following these steps, each channel’s instance of the same component can hold a different parameter value, even though the schematic sheet is reused.

Using Variant Parameters to Control Component Parameters

For more advanced configuration management—such as supporting multiple build configurations—you can control component parameter values via design variants.

1. Define the custom parameter in the component library

    1. Open the relevant component in the schematic library.
    2. Add the custom parameter (e.g. Channel Config or Gain Setting) directly to the library component.
    3. Save and update the component throughout the project so that the parameter exists as a library-level parameter rather than a purely local parameter.

2. Open the Variant Manager and configure parameter values

    1. In the project, open the Variant Manager.
    2. Select the variant in which you want to override the parameter value.
    3. Locate the component and assign a different value to the custom parameter for that variant.
      • Repeat this for each variant as required.

3. Understand limitations with local parameters

    • Variant parameters can only override parameters defined in the component library.
    • Local parameters (added only on the schematic, not in the library) cannot be changed via variant configurations.
    • Ensure that any parameter you plan to manage via variants is defined in the component’s library definition.

By using variant parameters, each variant can represent a different configuration of parameter values, which can then be associated with different channel uses or manufacturing configurations.

Additional Notes

  • The Repeat keyword remains useful for many scenarios, but when channel-specific parameters are required, manually duplicated sheet symbols with parameter-driven values provide finer control.
  • Carefully plan which parameters should be controlled at the component level, sheet symbol level, or variant level to keep the design easy to maintain.
  • When documenting the design or generating outputs, verify that the expected per-channel parameter values appear correctly in reports, and BOMs.
  • Consider adding naming conventions for parameters like Channel Value or Channel ID to keep them consistent across multiple projects.

Additional References

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.