JEDEC 바이트 주소 지정 가능 에너지 지원 함수 클래스에 대한 _DSM 인터페이스(함수 인터페이스 1)
이 섹션에서는 BIOS 복잡성을 최소화하기 위해 JEDEC 바이트 주소 지정 가능 에너지 지원 인터페이스 표준에 매핑하도록 설계된 디바이스별 메서드(_DSM) 인터페이스에 대해 설명합니다. OS 소프트웨어가 동일한 메커니즘을 통해 다양한 구현과 상호 작용할 수 있도록 디바이스 함수 & 기능을 보고하는 일반적인 기초를 제공합니다. 또한 I2C 레지스터에 대한 액세스를 통해 공급업체별 기능을 지원할 수 있습니다.
바이트 주소 지정 가능 에너지 지원 함수 클래스(함수 인터페이스 1)에 대한 _DSM 인터페이스를 준수하는 플랫폼은 JEDEC 바이트 주소 지정 가능 에너지 지원 인터페이스 사양(함수 클래스 0x01 및 함수 인터페이스 0x01)을 구현하는 NVDIMM-N을 지원할 수 있습니다. 자세한 내용은 JEDEC 바이트 주소 지정 가능 에너지 지원 인터페이스 사양(문서 JESD245)을 참조하세요.
GUID 정의
JEDEC 바이트 주소 지정 가능 에너지 지원 함수 클래스 _DSM 인터페이스의 GUID는 입니다 1EE68B36-D4BD-4a1a-9A16-4F8E53D46E05.
필수 함수 및 필드
이 섹션에 정의된 _DSM 함수는 NVDIMM ACPI 네임스페이스 디바이스 개체에서 구현되어야 합니다. 필수라는 용어는 함수가 유효한 데이터를 반환해야 하는지 여부를 나타냅니다.
다음 표에서는 필수 함수 및 필드를 지정합니다. 여기서 "ESP"는 "에너지원 정책"을 의미합니다.
_DSM 메서드 입력
모든 함수에 대한 Arg3은 패키지 값입니다. 함수가 입력 인수를 사용하지 않으면 Package 값에 데이터가 포함되지 않습니다. 함수가 입력 인수를 사용하는 경우 Package 값에는 버퍼가 포함됩니다.
함수가 입력 인수를 받지 않고 Arg3 이 빈 Package가 아닌 경우 함수는 잘못된 입력 매개 변수의 일반 상태 코드를 반환해야 합니다.
_DSM 메서드 출력
모든 메서드는 길이가 4바이트보다 크거나 같은 버퍼를 반환합니다. 반환 버퍼의 처음 4바이트는 다음과 같이 구조화됩니다.
| 필드 | 바이트 길이 | 바이트 오프셋 | Description |
|---|---|---|---|
| 일반 상태 코드 | 2 | 0 | 일반 상태 코드입니다. 다음은 사용 가능한 값입니다. |
| Function-Specific 오류 코드 | 1 | 2 | 호출된 함수와 관련된 오류 코드입니다. 이 필드는 일반 상태 코드가 함수별 오류 코드와 동일한 경우에만 유효한 정보를 포함합니다. |
| 공급업체별 오류 코드 | 1 | 3 | 공급업체별 상태 코드. 이 필드에는 일반 상태 코드 가 공급업체별 오류 코드와 동일한 경우에만 유효한 정보가 포함됩니다. |
다음은 일반 상태 코드에 사용할 수 있는 값입니다.
| 값 | 의미 |
|---|---|
| 0 | Success |
| 1 | 지원되지 않음 |
| 2 | 잘못된 입력 매개 변수 |
| 3 | I2C 통신 오류 |
| 4 | Function-Specific 오류 코드 |
| 5 | 공급업체별 오류 코드 |
| 6 | 0xFFFF – 예약됨 |
0이 아닌 일반 상태 코드 는 함수가 실패했음을 나타냅니다. 이 사양 버전에 정의된 함수는 지원되지 않음의 일반 상태 코드를 반환하지 않습니다. 모든 필수 함수는 유효한 데이터 또는 런타임 오류를 나타내는 오류 코드를 반환해야 합니다. 필수가 아닌 함수는 Function-Specific 오류 코드를 반환하여 반환할 유효한 데이터가 없음을 알릴 수 있습니다.
예약된 모든 비트와 바이트의 값은 0입니다. 달리 명시되지 않는 한 모든 멀티 바이트 필드는 little-endian 방식으로 표현되어야 합니다.
참고
바이트 주소 지정 가능 Energy-Backed 인터페이스 레지스터에 대한 참조는 이 인터페이스에 지정된 함수에 대한 많은 반환 필드를 설명합니다. 이러한 필드는 Byte-Addressable Energy-Backed 인터페이스 사양의 "바이트 주소 지정 가능 에너지 지원 인터페이스, 버전 1.0, JEDEC 표준 번호 2233-22" 수정에 정의된 레지스터와 동일해야 합니다. 사양 버전은 Get NVDIMM-N Identification(함수 인덱스 1) 함수에서 반환된 사양 수정 필드에 보고됩니다.
일부 반환 필드는 ES(에너지원)에 대한 정보를 참조합니다. ES 정책이 디바이스 관리인 경우 플랫폼은 필드 설명에 지정된 하드웨어 레지스터를 읽고 모든 ES 관련 정보를 검색해야 합니다. ES 정책이 호스트 관리되는 경우 플랫폼은 플랫폼별 메커니즘을 통해 ES 관련 정보를 가져와야 합니다. 이 경우 모든 ES 관련 정보는 필드 설명에 지정된 하드웨어 레지스터와 동일한 이진 레이아웃으로 표시됩니다.