SPV_ALTERA_fpga_cluster

Name Strings

SPV_ALTERA_fpga_cluster_attributes

Contact

To report problems with this extension, please open a new issue at:

https://github.com/KhronosGroup/SPIRV-Registry

Contributors

Jessica Davies, Intel

Notice

Status

Final draft

Version

Last Modified Date

2023-04-11

Revision

2

Dependencies

This extension is written against the SPIR-V Specification, Version 1.6 Revision 2.

This extension requires SPIR-V 1.0.

Overview

This extension adds decorations to request that statically-scheduled clusters use a stall-enable signal, or an exit FIFO, on an FPGA target.

Extension Name

To use this extension within a SPIR-V module, the following OpExtension must be present in the module:

OpExtension "SPV_ALTERA_fpga_cluster_attributes"

New capabilities

This extension introduces two new capabilities:

FPGAClusterAttributesALTERA
FPGAClusterAttributesV2ALTERA

New Decorations

This extension adds the following decoration under the FPGAClusterAttributesALTERA capability:

StallEnableALTERA

This extension adds the following decoration under the FPGAClusterAttributesV2ALTERA capability:

StallFreeALTERA

Token Number Assignments

FPGAClusterAttributesALTERA	5904
StallEnableALTERA	5905
FPGAClusterAttributesV2ALTERA	6150
StallFreeALTERA	6151

Modifications to the SPIR-V Specification, Version 1.6

Decoration

Modify Section 3.20, Decoration, adding these rows to the Decoration table:

Decoration	Extra Operands	Enabling Capabilities
5905	StallEnableALTERA Only valid on OpFunction. Request, to the extent possible, that statically-scheduled clusters should handle stalls using a stall-enable signal to freeze computation within the cluster.		FPGAClusterAttributesALTERA
6151	StallFreeALTERA Only valid on OpFunction. Request, to the extent possible, that statically-scheduled clusters should handle stalls by using an exit FIFO to hold any output data until the cluster is no longer stalled.		FPGAClusterAttributesV2ALTERA

Decoration

Extra Operands

Enabling Capabilities

5905

StallEnableALTERA
Only valid on OpFunction. Request, to the extent possible, that statically-scheduled clusters should handle stalls using a stall-enable signal to freeze computation within the cluster.

FPGAClusterAttributesALTERA

6151

StallFreeALTERA
Only valid on OpFunction. Request, to the extent possible, that statically-scheduled clusters should handle stalls by using an exit FIFO to hold any output data until the cluster is no longer stalled.

FPGAClusterAttributesV2ALTERA

Capability

Modify Section 3.31, Capability, adding the following rows to the Capability table:

Capability		Implicitly Declares
5904	FPGAClusterAttributesALTERA
6150	FPGAClusterAttributesV2ALTERA	FPGAClusterAttributesALTERA

Validation Rules

At most one of the StallEnableALTERA and StallFreeALTERA decorations can appear on an OpFunction.

Issues

None.

Revision History

Rev	Date	Author	Changes
1	2020-10-13	Jessica Davies	Initial public release
2	2023-04-11	Jessica Davies	Add stall-free cluster decoration