summaryrefslogtreecommitdiff
path: root/ReferenceCode/ME/Protocol/ActiveManagement/ActiveManagement.h
blob: 17a504504062c2af6e470b0f2bf24c2959c358ea (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
/** @file
  Active Management Technology Protocol to return the state of ASF Boot Options
  related to Active Management Technology.

@copyright
  Copyright (c) 2005 - 2012 Intel Corporation. All rights reserved
  This software and associated documentation (if any) is furnished
  under a license and may only be used or copied in accordance
  with the terms of the license. Except as permitted by such
  license, no part of this software or documentation may be
  reproduced, stored in a retrieval system, or transmitted in any
  form or by any means without the express written consent of
  Intel Corporation.

  This file contains a 'Sample Driver' and is licensed as such
  under the terms of your license agreement with Intel or your
  vendor.  This file may be modified by the user, subject to
  the additional terms of the license agreement
**/
#ifndef _EFI_ACTIVE_MANAGEMENT_PROTOCOL_H_
#define _EFI_ACTIVE_MANAGEMENT_PROTOCOL_H_

#include EFI_PROTOCOL_DEFINITION (AlertStandardFormat)

///
/// Intel Active Management Technology Protocol
/// This protocol provides interface to get ASF boot options status
///
#define EFI_ACTIVE_MANAGEMENT_PROTOCOL_GUID \
  { \
    0x8555fd40, 0x140b, 0x4f3c, 0x90, 0x5e, 0x3b, 0xf3, 0x78, 0xa0, 0x99, 0xfa \
  }

//
// Extern the GUID for protocol users.
//
extern EFI_GUID gEfiActiveManagementProtocolGuid;

//
// Forward reference for ANSI C compatibility
//
EFI_FORWARD_DECLARATION (EFI_ACTIVE_MANAGEMENT_PROTOCOL);

//
// Protocol definitions
//

/**
  Return current state of Boot Options
  @param[in] This                 Pointer to the EFI_ACTIVE_MANAGEMENT_PROTOCOL instance.
  @param[in] CurrentState         TRUE when the boot options is enabled

  @retval EFI_SUCCESS             Command succeed.
**/
typedef
EFI_STATUS
(EFIAPI *EFI_ACTIVE_MANAGEMENT_BOOT_OPTIONS_STATE) (
  IN     EFI_ACTIVE_MANAGEMENT_PROTOCOL   *This,
  IN OUT BOOLEAN                          *CurrentState
  )
;

/**
  This will return IDE Redirection boot device to boot

  @param[in] IdeBootDevice        Return the boot device number to boot
                                  Bits 0-1: If IDER boot is selected in Perimeter 1 then
                                  Bits 1,2 define the drive on the IDER controller to be used as the
                                  boot driver.
                                  Bit 1  Bit0
                                   0    0    Primary Master Drive
                                   0    1    Primary Slave Drive
                                   1    0    Secondary Master Drive
                                   1    1    Secondary Slave Drive
                                  Bits 2-7: Reserved set to 0

  @retval EFI_SUCCESS             The function completed successfully.
**/
typedef
EFI_STATUS
(EFIAPI *EFI_ACTIVE_MANAGEMENT_IDER_BOOT_DEVICE_SELECTED) (
  IN     EFI_ACTIVE_MANAGEMENT_PROTOCOL   *This,
  IN OUT UINT8                            *IdeBootDevice
  )
;

/**
  Return current ASF Boot Options

  @param[in] This                 Pointer to the EFI_ACTIVE_MANAGEMENT_PROTOCOL instance.
  @param[in] AsfBootOptions       ASF Boot Options

  @retval EFI_SUCCESS             Command succeed.
**/
typedef
EFI_STATUS
(EFIAPI *EFI_ACTIVE_MANAGEMENT_ASF_BOOT_OPTIONS_GET) (
  IN     EFI_ACTIVE_MANAGEMENT_PROTOCOL   *This,
  IN OUT EFI_ASF_BOOT_OPTIONS             **AsfBootOptions
  )
;

/**
  This will return verbosity request option

  @param[in] CurrentState         Return the state of verbosity option

  @retval EFI_SUCCESS             The function completed successfully.
  @retval CurrentState            00 - No BootOption available
                                  01 - Non-Verbosity request
                                  02 - Verbosity request
**/
typedef
EFI_STATUS
(EFIAPI *EFI_ACTIVE_MANAGEMENT_VERBOSITY_REQUESTED) (
  IN     EFI_ACTIVE_MANAGEMENT_PROTOCOL   *This,
  IN OUT UINT8                            *CurrentState
  )
;

///
/// Intel Active Management Technology Protocol
/// It provides abstract level function of ASF boot options defined in ASF 2.0 specification for
/// other modules to get ASF boot options status.
///
struct _EFI_ACTIVE_MANAGEMENT_PROTOCOL {
  EFI_ACTIVE_MANAGEMENT_BOOT_OPTIONS_STATE        GetIderState;
  EFI_ACTIVE_MANAGEMENT_BOOT_OPTIONS_STATE        GetEnforceSecureBootState;
  EFI_ACTIVE_MANAGEMENT_BOOT_OPTIONS_STATE        GetSolState;
  EFI_ACTIVE_MANAGEMENT_BOOT_OPTIONS_STATE        GetRemoteFlashState;
  EFI_ACTIVE_MANAGEMENT_BOOT_OPTIONS_STATE        GetBiosSetupState;
  EFI_ACTIVE_MANAGEMENT_BOOT_OPTIONS_STATE        GetBiosPauseState;
  EFI_ACTIVE_MANAGEMENT_BOOT_OPTIONS_STATE        GetConsoleLockState;
  EFI_ACTIVE_MANAGEMENT_BOOT_OPTIONS_STATE        GetKvmState;
  EFI_ACTIVE_MANAGEMENT_IDER_BOOT_DEVICE_SELECTED GetIderBootDeviceSelectd;
  EFI_ACTIVE_MANAGEMENT_ASF_BOOT_OPTIONS_GET      GetAsfBootOptions;
  EFI_ACTIVE_MANAGEMENT_BOOT_OPTIONS_STATE        GetProgressMsgRequest;
};

#endif