Intel AMT Features > Alarm Clock > Use Cases > Create an Alarm Clock that Activates Once
CollapseAll image

Create an Alarm Clock that Activates Once

The following procedure describes how to create a one-time alarm (applies to Release 8.0 and later releases). The wake–up mechanism performs the equivalent of a remote control power up command.

1.  Create a local instance (see an example of the required format) of IPS_AlarmClockOccurrence with the following parameters:

Field

Format

Description

StartTime

datetime

The value of the StartTime Datetime format requires a “T” between the date and the time and must end with “Z”. Seconds must be set to zero. For example: "yyyy-mm-ddThh:mm:00Z". The time must be later than the current time or the Set operation will be rejected.

Interval

datetime

Set to zero.

ElementName

string

A user-provided identifier. This must be unique among the defined alarms. The maximum length of the string is 32 characters. It cannot be left empty.

DeleteOnCompletion

boolean

If true, Intel AMT will delete the instance of IPS_AlarmClockOccurrence once the alarm has occurred.

 

2.  Retrieve the instance of AMT_AlarmClockService, where the “Name” key equals “Intel(r) AMT Alarm Clock Service”.

3.  Invoke the  AMT_AlarmClockService.AddAlarm: method with the instance of IPS_AlarmClockOccurrence created in step 1 embedded as an input parameter. The method will succeed as long as there are currently fewer than five instances of  IPS_AlarmClockOccurrence.

Instance Diagram

Classes Used in This Flow

SDK Sample

Not applicable

 

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