Operator EnumParamReference

Operator Library: Parameters

이 오퍼레이터는 디자인 내 아무 곳에나 위치한 모듈 파라미터로부터 1:1 맵 파라미터(파라미터 Value)를 생성합니다. 참조할 파라미터의 경로와 이름을 파라미터 Reference에 지정합니다.

참조된 파라미터는 VA_ENUM 유형입니다. 매핑 파라미터는 참조된 파라미터의 모든 Property를 미러링하며 이 역시 VA_ENUM 유형입니다.

참조된 파라미터가 표시되고 액세스될 수 있는 디자인 계층 내의 타겟을 정의할 수 있습니다. 타겟은 DisplayHierarchy와 DisplayName이라는 두 개의 파라미터로 정의됩니다. DisplayHierarchy에서는 참조 오퍼레이터 자체가 위치한 것과 동일한 프로세스 내의 계층적 박스를 지정합니다. 파라미터 DisplayName에서는 타겟 파라미터의 이름을 설정합니다. DisplayHierarchy와 DisplayName이 모두 설정된 경우, DisplayName으로 정의된 파라미터는 DisplayHierarchy로 지정된 계층적 박스에서 사용할 수 있게 됩니다. DisplayName이 비어 있으면 파라미터가 생성되지 않습니다. DisplayName은 설정되어 있지만 DisplayHierarchy가 비어 있는 경우, DisplayName으로 정의된 파라미터가 상위 계층(즉, 참조 오퍼레이터 자체가 위치한 계층적 박스)에 추가됩니다.

이를 통해 디자인의 파라미터를 원하는 모든 계층 수준에서 사용할 수 있도록 만들 수 있습니다. 예를 들어, 보호된 계층적 박스 내에 있는 모듈의 파라미터를 보호된 계층적 박스 자체의 Property 바로 아래에서 파라미터화할 수 있도록 만들 수 있습니다.

매핑된 파라미터 자체를 참조할 수도 있습니다. 따라서 참조 오퍼레이터 내에서 파라미터 Value의 내용을 참조하거나, 파라미터 DisplayName 및 DisplayHierarchy에서 정의한 파라미터를 참조할 수 있습니다. 이는 특히 보호된 계층적 박스가 다른 보호된 계층적 박스로 구성될 때 매우 중요합니다.

[참고] 연결된 모든 파라미터가 한 번에 업데이트됩니다.

연결된 파라미터 중 하나가 변경되면(참조된 파라미터, 맵 파라미터 Value, 또는 타겟 파라미터), 다른 모든 연결된 파라미터의 값도 함께 변경됩니다.

이 오퍼레이터는 디자인의 데이터 흐름 구조에 간섭하지 않으므로 입력과 출력이 없습니다.

library Parameter에 대한 일반적인 소개는 Library Parameters에서 확인할 수 있습니다.

예:

이제 Process0/Level0/Level1에서 "SignalParamRef" 매핑 파라미터를 사용할 수 있습니다:

I/O Properties

Property Value
Operator Type 없음(입출력이 없으므로)

Supported Link Format

없음

Parameters

Status
Type 정적 읽기(GUI에는 쓰기로 표시되지만) 파라미터
Default 없음
Range OK 또는 오류 메시지

에러 상태를 표시합니다. 파라미터 Activate가 Yes로 설정된 경우, 다른 모듈 파라미터를 확인합니다. 이 파라미터는 이 확인 결과, 즉 OK 또는 에러 메시지를 표시합니다.

이 파라미터는 최종 애플릿의 일부가 아닙니다.

DisplayName
Type static write parameter
Default 없음
Range 임의의 문자열

디자인의 다른 지점에서(참조 오퍼레이터 인스턴스 외에) 참조된 파라미터(파라미터 Reference에 정의됨)로의 및 그로부터의 액세스 권한을 부여하려면 새로운 파라미터를 정의해야 합니다. 여기에서 이 새 파라미터의 이름을 지정하십시오.

이 필드가 비어 있으면 새 파라미터가 생성되지 않습니다.

DisplayHierarchy
Type static write parameter
Default 없음
Range 임의의 문자열

파라미터 DisplayName에서 정의한 새 map parameter를 연결하려는 계층 구조 상자를 여기에 지정하십시오.

이 파라미터에는 자동 완성 기능과 구문 강조(syntax highlighting)를 사용할 수 있습니다. 자동 완성을 사용하려면 Module Properties 대화 상자에서 이 파라미터의 Parameter Values 필드를 클릭하고 키보드의 TAB 키를 누르십시오. 자동 완성 기능에 대한 자세한 지침은 'Autocompletion and Syntax Highlighting for Translator and Reference Operators'에서 확인할 수 있습니다.

새 파라미터 DisplayName을 정의했지만 파라미터 DisplayHierarchy를 비워 둔 경우: 새 파라미터가 reference operator 인스턴스를 포함하는 계층 구조 상자에 추가됩니다. (reference operator 인스턴스가 가장 높은(프로세스) 수준에 있는 경우에는 이 작업이 불가능하다는 점에 유의하십시오.)

[참고] 디스플레이 타겟 경로 설정을 위한 구문

새로운 파라미터를 디자인의 다른 위치에 표시하려면, DisplayHierarchy 파라미터에서 새로운 파라미터를 포함할 계층형 박스(hierarchical box)의 경로를 지정해야 합니다.

구문은 다음과 같습니다.

<Path> is the relative path from process level to the hierarchical level of the design where the <Hierarchical Box> is located that is to receive the new parameter. Thus, parameter DisplayHierarchy can only address hierarchical boxes within the same process. Use a slash as separator between different hierarchical levels.

<HierarchicalBox> is the name of the hierarchical box that is to receive the new map parameter.

예: Level0/Level1

Value
Type static, dynamic, write, read parameter
Default 0
Range Signed integer(64비트), unsigned integer(64비트)

참조된 파라미터와의 상호 액세스를 위한 맵 파라미터입니다. 이 파라미터는 참조된 파라미터의 모든 Property를 미러링합니다.

설명
Type static write parameter
Default -
Range any text

여기에 파라미터 Value의 설명을 입력합니다.

Reference
Type static write parameter
Default 없음
Range 참조된 파라미터를 정의하는 임의의 문자열: 모듈에 대한 상대 경로, 모듈 이름, 파라미터 이름

여기서는 디자인 내 참조된 파라미터의 위치를 정의합니다.

이 파라미터에는 자동 완성 기능과 구문 강조(syntax highlighting)를 사용할 수 있습니다. 자동 완성을 사용하려면 Module Properties 대화 상자에서 이 파라미터의 Parameter Values 필드를 클릭하고 키보드의 TAB 키를 누르십시오. 자동 완성 기능에 대한 자세한 지침은 'Autocompletion and Syntax Highlighting for Translator and Reference Operators'에서 확인할 수 있습니다.

[참고] 참조 구문

구문은 다음과 같습니다.

<Path> is the relative path to the hierarchical level where the referenced module "Module" is located. Use a slash as separator between different hierarchical levels. Define the path as relative path from the hierarchical level the reference operator instance is located in.

<Module> is the name of the module (operator instance or hierarchical box) that contains the referenced parameter.

<ParamName> is the actual name of the referenced parameter.

If <Path> starts with a slash, the path is interpreted as absolute path starting from design level (e.g., /Process0/UUT/Signal.Mode).

다음도 사용할 수 있습니다. ../ 상위 레벨로 이동하려면 사용하십시오. 단, 자유롭게 복제 또는 재배치할 수 있는 모듈을 디자인할 때는 이 옵션을 사용하지 않도록 주의하십시오.

Activate
Type dynamic write parameter
Default No
Range {No,Yes}

Yes = 참조된 파라미터와의 접근(Value 맵 파라미터를 통해)이 활성화됩니다.

No = 참조된 파라미터와의 접근이 비활성화되고 Status 파라미터가 비활성화됩니다. 파라미터 DisplayName 및 DisplayHierarchy는 영향을 미치지 않습니다.

사용 예제

EnumParamReference 오퍼레이터의 사용법은 다음 예시와 같습니다: