dpuSetTaskAffinity() - 1.4 English

Vitis AI User Guide (UG1414)

Document ID

UG1414

Release Date

2021-07-22

Version

1.4 English

Synopsis

int
      dpuSetTaskAffinity
(
DPUTask *task,
uint32_t coreMask
    );

Arguments

task: The pointer to DPU Task.
coreMask: DPU core mask to be specified. Each bit represents one DPU core: the lowest bit is for core 0, second lowest bit is for core 1, and so on. Multiple mask bits can be specified one time but can’t exceed the maximum available cores. For example, mask value 0x3 indicates that task can be assigned to DPU core 0 and 1, and it gets scheduled right away if anyone of core 0 or 1 is available.

Description

Dynamically set a DPU task's affinity to DPU cores at run-time. This provides flexibility for the users to intervene in DPU cores' assignment and scheduling to meet specific requirements. If not specified, DPU task can be assigned to any available DPU cores during run-time.

Returns

0 on success, or negative value in case of any failure.

Include File

n2cube.h

Availability