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
141
142
143
|
/** @file
Header file for SMM Control Driver.
Copyright (c) 1999 - 2015, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at
http://opensource.org/licenses/bsd-license.php.
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
**/
#ifndef _SMM_CONTROL_DRIVER_H_
#define _SMM_CONTROL_DRIVER_H_
//
// External include files do NOT need to be explicitly specified in real EDKII
// environment
//
#include <PiDxe.h>
#include <Library/IoLib.h>
#include <Library/DebugLib.h>
#include <Library/UefiDriverEntryPoint.h>
#include <Library/UefiBootServicesTableLib.h>
#include <Library/UefiRuntimeServicesTableLib.h>
#include <Guid/EventGroup.h>
#include <Protocol/SmmControl2.h>
#include <IndustryStandard/Pci30.h>
#include <PchAccess.h>
#include <Library/PchPlatformLib.h>
#define EFI_INTERNAL_POINTER 0x00000004
#define SMM_CONTROL_PRIVATE_DATA_SIGNATURE SIGNATURE_32 ('i', '4', 's', 'c')
typedef struct {
UINTN Signature;
EFI_HANDLE Handle;
EFI_SMM_CONTROL2_PROTOCOL SmmControl;
} SMM_CONTROL_PRIVATE_DATA;
#define SMM_CONTROL_PRIVATE_DATA_FROM_THIS(a) CR (a, SMM_CONTROL_PRIVATE_DATA, SmmControl, SMM_CONTROL_DEV_SIGNATURE)
//
// Prototypes
//
/**
This is the constructor for the SMM Control protocol.
@param[in] ImageHandle Handle for the image of this driver
@param[in] SystemTable Pointer to the EFI System Table
@retval EFI_STATUS Results of the installation of the SMM Control Protocol
**/
EFI_STATUS
EFIAPI
SmmControlDriverEntryInit (
IN EFI_HANDLE ImageHandle,
IN EFI_SYSTEM_TABLE *SystemTable
);
/**
Trigger the software SMI.
@param[in] Data The value to be set on the software SMI data port
@retval EFI_SUCCESS Function completes successfully
**/
EFI_STATUS
EFIAPI
SmmTrigger (
UINT8 Data
);
/**
Clear the SMI status.
@retval EFI_SUCCESS The function completes successfully
@retval EFI_DEVICE_ERROR Something error occurred
**/
EFI_STATUS
EFIAPI
SmmClear (
VOID
);
/**
This routine generates an SMI.
@param[in] This The EFI SMM Control protocol instance
@param[in, out] CommandPort The buffer contains data to the command port
@param[in, out] DataPort The buffer contains data to the data port
@param[in] Periodic Periodic or not
@param[in] ActivationInterval Interval of periodic SMI
@retval EFI Status Describing the result of the operation
@retval EFI_INVALID_PARAMETER Some parameter value passed is not supported
**/
EFI_STATUS
EFIAPI
Activate (
IN CONST EFI_SMM_CONTROL2_PROTOCOL *This,
IN OUT UINT8 *CommandPort OPTIONAL,
IN OUT UINT8 *DataPort OPTIONAL,
IN BOOLEAN Periodic OPTIONAL,
IN UINTN ActivationInterval OPTIONAL
);
/**
This routine clears an SMI.
@param[in] This The EFI SMM Control protocol instance
@param[in] Periodic Periodic or not
@retval EFI Status Describing the result of the operation
@retval EFI_INVALID_PARAMETER Some parameter value passed is not supported
**/
EFI_STATUS
EFIAPI
Deactivate (
IN CONST EFI_SMM_CONTROL2_PROTOCOL *This,
IN BOOLEAN Periodic OPTIONAL
);
/**
Disable all pending SMIs
**/
VOID
EFIAPI
DisablePendingSmis (
VOID
);
#endif
|