CFG_SetZeroTouchEnabled

CFG_SetZeroTouchEnabled enables or disables remote configuration of Intel AMT. If Zero Touch support is disabled while Intel AMT is provisioned, Intel AMT will be partially unprovisioned. This command is available to BIOS / MEBX. Starting Intel ME 12.0, this command is available also to host operating system software with the following restrictions:  only disable is allowed, Intel AMT is not yet provisioned (its state is PRE) and the secured FQDN suffix was not already configured in MEBX.

CFG_SetZeroTouchEnabled Request

typedef struct _CFG_SET_ZERO_TOUCH_ENABLED_REQUEST

{

    PTHI_MESSAGE_HEADER     Header;

    AMT_BOOLEAN             Mode;

} CFG_SET_ZERO_TOUCH_ENABLED_REQUEST;

 

Field

Description

Header.Version

Major and minor interface version.

Header.Reserved

0000h

Header.Command

0400003Ah

Header.Length

Message Length, excluding the message header.

Mode

False: Disables Zero Touch.

True: Enables Zero Touch.

CFG_SetZeroTouchEnabled Response

typedef struct _CFG_SET_ZERO_TOUCH_ENABLED_RESPONSE

{

    PTHI_MESSAGE_HEADER     Header;

    AMT_STATUS              Status;

} CFG_SET_ZERO_TOUCH_ENABLED_RESPONSE;

 

Field

Description

Header.Version

Major and minor interface version.

Header.Reserved

0000h

Header.Command

0480003Ah

Header.Length

Message Length, excluding the message header.

Status

A status code returned in a response message that indicates whether the operation specified in the corresponding request message succeeded or failed. If the operation failed, this code indicates the specific reason for failure.

CFG_StartConfiguration Status Codes

Status

Description

AMT_STATUS_SUCCESS

Request succeeded.

AMT_STATUS_INTERNAL_ERROR

An internal error in the Intel AMT device has occurred.

AMT_STATUS_INVALID_MESSAGE_LENGTH

Length field of header is invalid.

AMT_STATUS_NOT_READY

Management controller has not progressed far enough in its initialization to process the command.

AMT_STATUS_INVALID_AMT_MODE

AMT is not in the "pre" provisioning state

AMT_STATUS_NOT_PERMITTED

Command isn't allowed (ZTC cannot be enabled from host, or FQDN suffix is already configured)

 

 

Copyright © 2006-2022, Intel Corporation. All rights reserved.