From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from NAM12-DM6-obe.outbound.protection.outlook.com (NAM12-DM6-obe.outbound.protection.outlook.com [40.107.243.46]) by mx.groups.io with SMTP id smtpd.web10.20375.1683264308369374942 for ; Thu, 04 May 2023 22:25:08 -0700 Authentication-Results: mx.groups.io; dkim=fail reason="body hash did not verify" header.i=@amd.com header.s=selector1 header.b=Es+dWNxp; spf=permerror, err=parse error for token &{10 18 %{i}._ip.%{h}._ehlo.%{d}._spf.vali.email}: invalid domain name (domain: amd.com, ip: 40.107.243.46, mailfrom: abner.chang@amd.com) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=QFRP162ALL+7miU7YDNfAyJorB73xRTT071Acyy0VQinMesg39isgngV5K88Ifb2aamj547e7fjYUhMK4cAipxOOaGhEZ28gYBv6KX04o8V4VG4juRfRBVhJ5XwIAFK3+4aHl6KBuJfiS4tDRAFnGLwD9pbY8trVuve0GTi53wfpTD9ocr2Vji0M1sBfVQ+BnPWPMHmCtdHJ0jov8pZRYLQfzNOuoEKA24DtdEDcSH+uvoOntoMZed2o2Gn55vXs5sP3o4fhe1E2qj2ZY27SUWIdH1hmZwDg0NJq/4+nlzwJZywz+OTtnS4UCF7CmI+HRQ+m/gQKNJ2lVPfOxug0/Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=cwlYsBcWDSFbYBf50Xp0IYbAUEnBHhO6zBc+NoYnInw=; b=AUJ1D0G6mofbQU2yOYOkHXPfVTITPECQxwZAVRL15Gzy3shB6JZgZxN2g++g0fyuiN58voelQPbm6HkpvjB1LAIrGWHMFLICuMh0qF8hVWDSyMx1zqP27FZs2NwnggtgGSGurmX9h5RXyuLMhiahmJfURBHFTGMvrw0J0jtCrF3pg4bS04/Og50pysnZR3lWHo4B6D6QJXEePJUA6ELIWrMyZhlXSGmsblUOgvBmBcKN4tJp/9FGFDsYTPwLsIIRe7rrpgAUQqFF/Nm27E7oLLLEEiSl/mnZs2gk/+p6ytSbdkzwrfviu6VvdItwq08YN5NOu+EjFQMS8UFmL+o8zw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=edk2.groups.io smtp.mailfrom=amd.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=cwlYsBcWDSFbYBf50Xp0IYbAUEnBHhO6zBc+NoYnInw=; b=Es+dWNxpCvLV0kjMWej1HGP+p+XQl035SGO83cmjcMy9MxHUZaq104dysFWW7DwjaqXcqNMq84mO0xRrPUOIEf0SMKaaULCEsUgI6B9OEpjx4/bi4q1E0daRu6nM2jJ6WLvWtrdgS60+qB5JJtRCsl0kuGXKZgVSkZT4ndfqsP0= Received: from BN9P221CA0026.NAMP221.PROD.OUTLOOK.COM (2603:10b6:408:10a::24) by CH2PR12MB4937.namprd12.prod.outlook.com (2603:10b6:610:64::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6363.26; Fri, 5 May 2023 05:25:04 +0000 Received: from BN8NAM11FT072.eop-nam11.prod.protection.outlook.com (2603:10b6:408:10a:cafe::63) by BN9P221CA0026.outlook.office365.com (2603:10b6:408:10a::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6363.27 via Frontend Transport; Fri, 5 May 2023 05:25:04 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 165.204.84.17) smtp.mailfrom=amd.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=amd.com; Received-SPF: Pass (protection.outlook.com: domain of amd.com designates 165.204.84.17 as permitted sender) receiver=protection.outlook.com; client-ip=165.204.84.17; helo=SATLEXMB04.amd.com; pr=C Received: from SATLEXMB04.amd.com (165.204.84.17) by BN8NAM11FT072.mail.protection.outlook.com (10.13.176.165) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6363.27 via Frontend Transport; Fri, 5 May 2023 05:25:04 +0000 Received: from TPE-L1-ABNCHANG.amd.com (10.180.168.240) by SATLEXMB04.amd.com (10.181.40.145) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Fri, 5 May 2023 00:25:01 -0500 From: "Chang, Abner" To: CC: Isaac Oram , Abdul Lateef Attar , Nickle Wang , Tinh Nguyen Subject: [edk2-platforms][PATCH] ManageabilityPkg/IpmiCommandLib:IPMI Command Library Date: Fri, 5 May 2023 13:24:23 +0800 Message-ID: <20230505052424.729-1-abner.chang@amd.com> X-Mailer: git-send-email 2.37.1.windows.1 MIME-Version: 1.0 Return-Path: Abner.Chang@amd.com X-Originating-IP: [10.180.168.240] X-ClientProxiedBy: SATLEXMB04.amd.com (10.181.40.145) To SATLEXMB04.amd.com (10.181.40.145) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: BN8NAM11FT072:EE_|CH2PR12MB4937:EE_ X-MS-Office365-Filtering-Correlation-Id: d4444eaa-1f36-4754-422c-08db4d2914e8 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 4ZpxCZNk/HnQ2j2FlvoB7yuzLf7YcyyG2/etvl0cbpA2zQeXIr6sLkT3ABe/GtPrEckWrtF34zmAuxSfa4D8aS3U5DAGffH6hbUOlpZVV/fy5y0X/YCAnqPI3Dh1Q2IeA5bvchQKSi5CLVLSPn5dnUAzz/Gx7azvSa8GOtzcAEbWnS9yQUggkLWS4ClppGyouIoB2041o63JsNo0m2ryxB6k6rjxUQqSOxhdXMT57UALIycAEn83pDU8x3SJDLb/Pcbv6jyqAYrOPWv7ddLbAfuEY5KdUUIQLMc4I5C+gF4F0zEtrpFCMDWt2w82SYDh3Af95pfReRODlo8GYfuiOU0ersQTp1eZlT6ImnBSnpgqrIcQr/TduDzSS3zQ8fPcqIY/yocUHMuABHxBhSLPZF5QVs57suFf0sya/J1XjE7nY/aCCRtMQESuYinmAPQSNTqc7QlzNvqkJfbvcPU3sX5SK4MmU2Ms54TyLW2YskuZPi18S/nY88lXc6qxW+YihntOqDZgC10SwSgLKzfVd0QdWbpirX0CiITK6Be8EK09KnwKFPYSkgcyU+HscxERhn3p2OEgmzkaK0FHibNL3JeRZ8s/PcLQIfbBdEQs3N7jWR+QdYlM82sLLOatx8cnAJROYYMkl4eT0d6c42UZkED3hOUj7VNkZe1b6deVHOI5iWBavxY0ufnyKHxXov5YR6ETx6gXIOgfgGcJYQsnOpTB6bgrz4rJm30HXYB8twA= X-Forefront-Antispam-Report: CIP:165.204.84.17;CTRY:US;LANG:en;SCL:1;SRV:;IPV:CAL;SFV:NSPM;H:SATLEXMB04.amd.com;PTR:InfoDomainNonexistent;CAT:NONE;SFS:(13230028)(4636009)(136003)(346002)(376002)(396003)(39860400002)(451199021)(46966006)(40470700004)(36840700001)(478600001)(36756003)(86362001)(316002)(54906003)(19627235002)(70206006)(70586007)(6916009)(4326008)(7696005)(6666004)(41300700001)(40480700001)(82310400005)(8936002)(8676002)(5660300002)(2876002)(30864003)(2906002)(16526019)(81166007)(82740400003)(186003)(356005)(2616005)(1076003)(36860700001)(26005)(47076005)(336012)(426003)(83380400001)(40460700003)(36900700001)(559001)(579004);DIR:OUT;SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 May 2023 05:25:04.2508 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: d4444eaa-1f36-4754-422c-08db4d2914e8 X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d;Ip=[165.204.84.17];Helo=[SATLEXMB04.amd.com] X-MS-Exchange-CrossTenant-AuthSource: BN8NAM11FT072.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH2PR12MB4937 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain From: Abner Chang BZ #: 4444 IpmiCommandLib is cloned from edk2-platforms/Features/Intel/OutOfBandManagement/ IpmiFeaturePkg/Library/IpmiCommandLib in order to consolidate edk2 system manageability support in one place. Function header are added to the source files and header files. Uncustify is applied to C files and no functionalities are changed in this patch. We will still keep the one under IpmiFeaturePkg/Library/ IpmiCommandLib until the reference to this instance are removed from platforms. Signed-off-by: Abner Chang Cc: Isaac Oram Cc: Abdul Lateef Attar Cc: Nickle Wang Cc: Tinh Nguyen --- .../Library/IpmiCommandLib/IpmiCommandLib.inf | 33 + .../Include/Library/IpmiCommandLib.h | 620 ++++++++++++++++++ .../IpmiCommandLib/IpmiCommandLibNetFnApp.c | 444 +++++++++++++ .../IpmiCommandLibNetFnChassis.c | 199 ++++++ .../IpmiCommandLibNetFnStorage.c | 384 +++++++++++ .../IpmiCommandLibNetFnTransport.c | 156 +++++ 6 files changed, 1836 insertions(+) create mode 100644 Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCo= mmandLib.inf create mode 100644 Features/ManageabilityPkg/Include/Library/IpmiCommandLi= b.h create mode 100644 Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCo= mmandLibNetFnApp.c create mode 100644 Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCo= mmandLibNetFnChassis.c create mode 100644 Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCo= mmandLibNetFnStorage.c create mode 100644 Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCo= mmandLibNetFnTransport.c diff --git a/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCommandLi= b.inf b/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCommandLib.inf new file mode 100644 index 0000000000..3dc485cf38 --- /dev/null +++ b/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCommandLib.inf @@ -0,0 +1,33 @@ +### @file +# Component description file for IPMI Command Library. +# +# Copyright (c) 2018 - 2021, Intel Corporation. All rights reserved.
+# Copyright (C) 2023 Advanced Micro Devices, Inc. All rights reserved.
+# +# SPDX-License-Identifier: BSD-2-Clause-Patent +# +### + +[Defines] + INF_VERSION =3D 0x00010005 + BASE_NAME =3D IpmiCommandLib + FILE_GUID =3D 96FC1989-CB7F-489B-9D3B-68DCA2C2DADC + MODULE_TYPE =3D UEFI_DRIVER + VERSION_STRING =3D 1.0 + LIBRARY_CLASS =3D IpmiCommandLib + +[sources] + IpmiCommandLibNetFnApp.c + IpmiCommandLibNetFnTransport.c + IpmiCommandLibNetFnChassis.c + IpmiCommandLibNetFnStorage.c + +[Packages] + MdePkg/MdePkg.dec + MdeModulePkg/MdeModulePkg.dec + ManageabilityPkg/ManageabilityPkg.dec + +[LibraryClasses] + BaseMemoryLib + DebugLib + IpmiLib diff --git a/Features/ManageabilityPkg/Include/Library/IpmiCommandLib.h b/F= eatures/ManageabilityPkg/Include/Library/IpmiCommandLib.h new file mode 100644 index 0000000000..685f6e2ea2 --- /dev/null +++ b/Features/ManageabilityPkg/Include/Library/IpmiCommandLib.h @@ -0,0 +1,620 @@ +/** @file + This library abstract how to send/receive IPMI command. + +Copyright (c) 2018-2021, Intel Corporation. All rights reserved.
+Copyright (C) 2023 Advanced Micro Devices, Inc. All rights reserved.
+ +SPDX-License-Identifier: BSD-2-Clause-Patent + +**/ + +#ifndef IPMI_COMMAND_LIB_H_ +#define IPMI_COMMAND_LIB_H_ + +#include +#include + +/// +/// Functions for IPMI NetFnApp commands +/// + +/** + This function is used to retrieve device ID. + + @param [out] DeviceId The pointer to receive IPMI_GET_DEVICE_ID_RESPON= SE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetDeviceId ( + OUT IPMI_GET_DEVICE_ID_RESPONSE *DeviceId + ); + +/** + This function returns device self test results + + @param [out] SelfTestResult The pointer to receive IPMI_SELF_TEST_RESU= LT_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSelfTestResult ( + OUT IPMI_SELF_TEST_RESULT_RESPONSE *SelfTestResult + ); + +/** + This function is used for starting and restarting the Watchdog + Timer from the initial countdown value that was specified in + the Set Watchdog Timer command the watchdog timer. + + @param [out] CompletionCode IPMI completetion code, refer to Ipmi.h. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiResetWatchdogTimer ( + OUT UINT8 *CompletionCode + ); + +/** + This function is used for initializing and configuring + the watchdog timer. + + @param [in] SetWatchdogTimer Pointer to receive IPMI_SET_WATCHDOG_TIM= ER_REQUEST. + @param [out] CompletionCode IPMI completetion code, refer to Ipmi.h. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSetWatchdogTimer ( + IN IPMI_SET_WATCHDOG_TIMER_REQUEST *SetWatchdogTimer, + OUT UINT8 *CompletionCode + ); + +/** + This function retrieves the current settings and present + countdown of the watchdog timer. + + @param [out] GetWatchdogTimer Pointer to receive IPMI_GET_WATCHDOG_TIM= ER_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetWatchdogTimer ( + OUT IPMI_GET_WATCHDOG_TIMER_RESPONSE *GetWatchdogTimer + ); + +/** + This function enables message reception into Message Buffers, + and any interrupt associated with that buffer getting full. + + @param [in] SetBmcGlobalEnables Pointer receive to IPMI_SET_BMC_GLOBA= L_ENABLES_REQUEST. + @param [out] CompletionCode IPMI completetion code, refer to Ipmi= .h. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSetBmcGlobalEnables ( + IN IPMI_SET_BMC_GLOBAL_ENABLES_REQUEST *SetBmcGlobalEnables, + OUT UINT8 *CompletionCode + ); + +/** + This function retrieves the present setting of the Global Enables + + @param [out] GetBmcGlobalEnables Pointer to receive IPMI_GET_BMC_GLOBA= L_ENABLES_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetBmcGlobalEnables ( + OUT IPMI_GET_BMC_GLOBAL_ENABLES_RESPONSE *GetBmcGlobalEnables + ); + +/** + This function is used to flush unread data from the Receive + Message Queue or Event Message Buffer + + @param [in] ClearMessageFlagsRequest IPMI_CLEAR_MESSAGE_FLAGS_REQUEST + @param [out] CompletionCode IPMI completetion code, refer to = Ipmi.h. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiClearMessageFlags ( + IN IPMI_CLEAR_MESSAGE_FLAGS_REQUEST *ClearMessageFlagsRequest, + OUT UINT8 *CompletionCode + ); + +/** + This function is used to retrieve the present message available states. + + @param [out] GetMessageFlagsResponse Pointer to receive IPMI_GET_MESSA= GE_FLAGS_RESPONSE + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetMessageFlags ( + OUT IPMI_GET_MESSAGE_FLAGS_RESPONSE *GetMessageFlagsResponse + ); + +/** + This function is used to get data from the Receive Message Queue. + + @param [out] GetMessageResponse Pointer to receive IPMI_GET_ME= SSAGE_RESPONSE. + @param [in, out] GetMessageResponseSize When in, which is the expected= size of + response. When out, which is t= he actual + size returned. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetMessage ( + OUT IPMI_GET_MESSAGE_RESPONSE *GetMessageResponse, + IN OUT UINT32 *GetMessageResponseSize + ); + +/** + This function is used for bridging IPMI messages between channels, + and between the system management software (SMS) and a given channel + + @param [in] SendMessageRequest Pointer to IPMI_SEND_MESSAGE_REQU= EST. + @param [in] SendMessageRequestSize Size of entire SendMessageRequest= Size. + @param [out] SendMessageResponse Pointer to receive IPMI_SEND_MESS= AGE_RESPONSE. + @param [in] SendMessageResponseSize When in, which is the expected si= ze of + response. When out, which is the = actual + size returned. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSendMessage ( + IN IPMI_SEND_MESSAGE_REQUEST *SendMessageRequest, + IN UINT32 SendMessageRequestSize, + OUT IPMI_SEND_MESSAGE_RESPONSE *SendMessageResponse, + IN OUT UINT32 *SendMessageResponseSize + ); + +/** + This function gets the system UUID. + + @param [out] SystemGuid The pointer to retrieve system UUID. + + @retval EFI_SUCCESS UUID is returned. + @retval EFI_INVALID_PARAMETER SystemGuid is a NULL pointer. + @retval Others See return value of IpmiSubmitCommand = () function. +**/ +EFI_STATUS +EFIAPI +IpmiGetSystemUuid ( + OUT EFI_GUID *SystemGuid + ); + +/** + This function gets the channel information. + + @param [in] GetChannelInfoRequest The get channel information re= quest. + @param [out] GetChannelInfoResponse The get channel information re= sponse. + @param [out] GetChannelInfoResponseSize When input, the expected size = of response. + When output, the exact size of= the returned + response. + + @retval EFI_SUCCESS Get channel information successfully. + @retval EFI_INVALID_PARAMETER One of the given input parameters is inva= lid. + @retval Others See return value of IpmiSubmitCommand () = function. + +**/ +EFI_STATUS +EFIAPI +IpmiGetChannelInfo ( + IN IPMI_GET_CHANNEL_INFO_REQUEST *GetChannelInfoRequest, + OUT IPMI_GET_CHANNEL_INFO_RESPONSE *GetChannelInfoResponse, + OUT UINT32 *GetChannelInfoResponseSize + ); + +/// +/// Functions for IPMI NetFnTransport commands. +/// + +/** + This function sends command to BMC to notify a remote application + that a SOL payload is activating on another channel. + + @param [in] SolActivatingRequest Pointer to IPMI_SOL_ACTIVATING_REQUE= ST. + @param [out] CompletionCode IPMI completetion code, refer to Ipm= i.h. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSolActivating ( + IN IPMI_SOL_ACTIVATING_REQUEST *SolActivatingRequest, + OUT UINT8 *CompletionCode + ); + +/** + This function is used to set parameters such as the network addressing + information required for SOL payload operation. + + @param [in] SetConfigurationParametersRequest Pointer to IPMI_SET_= SOL_CONFIGURATION_PARAMETERS_REQUEST. + @param [in] SetConfigurationParametersRequestSize Size of entire SetCo= nfigurationParametersRequestSize. + @param [out] CompletionCode IPMI completetion co= de, refer to Ipmi.h. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSetSolConfigurationParameters ( + IN IPMI_SET_SOL_CONFIGURATION_PARAMETERS_REQUEST *SetConfigurationPara= metersRequest, + IN UINT32 SetConfigurationParam= etersRequestSize, + OUT UINT8 *CompletionCode + ); + +/** + This function is used to retrieve the configuration parameters from the + Set SOL Configuration Parameters. + + @param [in] GetConfigurationParametersRequest Pointer to IPM= I_SET_SOL_CONFIGURATION_PARAMETERS_REQUEST. + @param [out] GetConfigurationParametersResponse Pointer to rec= eive IPMI_GET_SOL_CONFIGURATION_PARAMETERS_RESPONSE. + @param [in, out] GetConfigurationParametersResponseSize When in, which= is the expected size of + response. When= out, which is the actual + size returned. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSolConfigurationParameters ( + IN IPMI_GET_SOL_CONFIGURATION_PARAMETERS_REQUEST *GetConfigurationPar= ametersRequest, + OUT IPMI_GET_SOL_CONFIGURATION_PARAMETERS_RESPONSE *GetConfigurationPar= ametersResponse, + IN OUT UINT32 *GetConfigurationPar= ametersResponseSize + ); + +/** + This function gets the LAN configuration parameter. + + @param[in] GetLanConfigurationParametersRequest Request data + @param[out] GetLanConfigurationParametersResponse Response data + @param[in,out] GetLanConfigurationParametersSize When input, the e= xpected size of response data. + When out, the exa= ct size of response data. + + @retval EFI_SUCCESS Lan configuration parameter is returned i= n the response. + @retval EFI_INVALID_PARAMETER One of the given input parameters is inva= lid. + @retval Others Other errors. + +**/ +EFI_STATUS +EFIAPI +IpmiGetLanConfigurationParameters ( + IN IPMI_GET_LAN_CONFIGURATION_PARAMETERS_REQUEST *GetLanConfigurat= ionParametersRequest, + OUT IPMI_GET_LAN_CONFIGURATION_PARAMETERS_RESPONSE *GetLanConfigurat= ionParametersResponse, + IN OUT UINT32 *GetLanConfigurat= ionParametersSize + ); + +/// +/// Functions for IPMI NetFnChasis commands +/// + +/** + This function returns information about which main chassis management fu= nctions are + present and what addresses are used to access those functions. + + @param [out] GetChassisCapabilitiesResponse Pointer to IPMI_GET_CHASSI= S_CAPABILITIES_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetChassisCapabilities ( + OUT IPMI_GET_CHASSIS_CAPABILITIES_RESPONSE *GetChassisCapabilitiesRespo= nse + ); + +/** + This function gets information regarding the high-level status of the s= ystem + chassis and main power subsystem. + + @param [out] GetChassisStatusResponse Pointer to IPMI_GET_CHASSIS_STAT= US_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetChassisStatus ( + OUT IPMI_GET_CHASSIS_STATUS_RESPONSE *GetChassisStatusResponse + ); + +/** + This function sends command to control power up, power down, and reset. + + @param [in] ChassisControlRequest Pointer to IPMI_CHASSIS_CONTROL_REQ= UEST. + @param [out] CompletionCode IPMI completetion code, refer to Ip= mi.h. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiChassisControl ( + IN IPMI_CHASSIS_CONTROL_REQUEST *ChassisControlRequest, + OUT UINT8 *CompletionCode + ); + +/** + This function is used to configure the power restore policy. + + @param [in] ChassisControlRequest Pointer to IPMI_SET_POWER_RESTORE_= POLICY_REQUEST. + @param [out] ChassisControlResponse Pointer to IPMI_SET_POWER_RESTORE_= POLICY_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSetPowerRestorePolicy ( + IN IPMI_SET_POWER_RESTORE_POLICY_REQUEST *ChassisControlRequest, + OUT IPMI_SET_POWER_RESTORE_POLICY_RESPONSE *ChassisControlResponse + ); + +/** + This function is used to set parameters that direct the system boot + following a system power up or reset. + + @param [in] BootOptionsRequest Pointer to IPMI_SET_BOOT_OPTIONS_REQU= EST. + @param [out] BootOptionsResponse Pointer to IPMI_SET_BOOT_OPTIONS_RESP= ONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSetSystemBootOptions ( + IN IPMI_SET_BOOT_OPTIONS_REQUEST *BootOptionsRequest, + OUT IPMI_SET_BOOT_OPTIONS_RESPONSE *BootOptionsResponse + ); + +/** + This function is used to retrieve the boot options set by the + Set System Boot Options command. + + @param [in] BootOptionsRequest Pointer to IPMI_GET_BOOT_OPTIONS_REQU= EST. + @param [out] BootOptionsResponse Pointer to IPMI_GET_BOOT_OPTIONS_RESP= ONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSystemBootOptions ( + IN IPMI_GET_BOOT_OPTIONS_REQUEST *BootOptionsRequest, + OUT IPMI_GET_BOOT_OPTIONS_RESPONSE *BootOptionsResponse + ); + +/// +/// Functions for IPMI NetFnStorage commands +/// + +/** + This function is used to retrieve FRU Inventory Area + + @param [in] GetFruInventoryAreaInfoRequest Pointer to IPMI_GET_FRU_I= NVENTORY_AREA_INFO_REQUEST. + @param [out] GetFruInventoryAreaInfoResponse Pointer to IPMI_GET_FRU_I= NVENTORY_AREA_INFO_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetFruInventoryAreaInfo ( + IN IPMI_GET_FRU_INVENTORY_AREA_INFO_REQUEST *GetFruInventoryAreaInfoR= equest, + OUT IPMI_GET_FRU_INVENTORY_AREA_INFO_RESPONSE *GetFruInventoryAreaInfoR= esponse + ); + +/** + This function returns specified data from the FRU Inventory Info area. + + @param [in] ReadFruDataRequest Pointer to IPMI_READ_FRU_DATA= _REQUEST. + @param [out] ReadFruDataResponse Pointer to IPMI_READ_FRU_DATA= _RESPONSE. + @param [in, out] ReadFruDataResponseSize Returns the size of ReadFruDa= taResponse. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiReadFruData ( + IN IPMI_READ_FRU_DATA_REQUEST *ReadFruDataRequest, + OUT IPMI_READ_FRU_DATA_RESPONSE *ReadFruDataResponse, + IN OUT UINT32 *ReadFruDataResponseSize + ); + +/** + This function writes specified data from the FRU Inventory Info area. + + @param [in] WriteFruDataRequest Pointer to IPMI_WRITE_FRU_DATA_RE= QUEST. + @param [in] WriteFruDataRequestSize Size of WriteFruDataRequest. + @param [out] WriteFruDataResponse Pointer to receive IPMI_WRITE_FRU= _DATA_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiWriteFruData ( + IN IPMI_WRITE_FRU_DATA_REQUEST *WriteFruDataRequest, + IN UINT32 WriteFruDataRequestSize, + OUT IPMI_WRITE_FRU_DATA_RESPONSE *WriteFruDataResponse + ); + +/** + This function returns the number of entries in the SEL + + @param [out] GetSelInfoResponse Pointer to receive IPMI_GET_SEL_INFO= _RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSelInfo ( + OUT IPMI_GET_SEL_INFO_RESPONSE *GetSelInfoResponse + ); + +/** + This function retrieves entries from the SEL + + @param [in] GetSelEntryRequest Pointer to IPMI_GET_SEL_ENTRY_REQ= UEST. + @param [out] GetSelEntryResponse Pointer to receive IPMI_GET_SEL_E= NTRY_RESPONSE. + @param [in] GetSelEntryResponseSize Size of entire GetSelEntryRespons= e. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSelEntry ( + IN IPMI_GET_SEL_ENTRY_REQUEST *GetSelEntryRequest, + OUT IPMI_GET_SEL_ENTRY_RESPONSE *GetSelEntryResponse, + IN OUT UINT32 *GetSelEntryResponseSize + ); + +/** + This function adds an entry in the SEL + + @param [in] AddSelEntryRequest Pointer to IPMI_ADD_SEL_ENTRY_REQUEST= . + @param [out] AddSelEntryResponse Pointer to receive IPMI_ADD_SEL_ENTRY= _RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiAddSelEntry ( + IN IPMI_ADD_SEL_ENTRY_REQUEST *AddSelEntryRequest, + OUT IPMI_ADD_SEL_ENTRY_RESPONSE *AddSelEntryResponse + ); + +/** + This function adds SEL Entry command that allows the record to be increm= entally + added to the SEL. + + @param [in] PartialAddSelEntryRequest Pointer to IPMI_PARTIAL_ADD_= SEL_ENTRY_REQUEST. + @param [in] PartialAddSelEntryRequestSize Size of entire PartialAddSel= EntryRequest. + @param [out] PartialAddSelEntryResponse Pointer to receive IPMI_PART= IAL_ADD_SEL_ENTRY_RESPONSE. + + @retval EFI_STASTUS See return value of IpmiSubmitCommand () function. + +**/ +EFI_STATUS +EFIAPI +IpmiPartialAddSelEntry ( + IN IPMI_PARTIAL_ADD_SEL_ENTRY_REQUEST *PartialAddSelEntryRequest, + IN UINT32 PartialAddSelEntryRequestSize, + OUT IPMI_PARTIAL_ADD_SEL_ENTRY_RESPONSE *PartialAddSelEntryResponse + ); + +/** + This function erases all contents of the System Event Log. + + @param [in] ClearSelRequest Pointer to IPMI_CLEAR_SEL_REQUEST. + @param [out] ClearSelResponse Pointer to receive IPMI_CLEAR_SEL_RESPON= SE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiClearSel ( + IN IPMI_CLEAR_SEL_REQUEST *ClearSelRequest, + OUT IPMI_CLEAR_SEL_RESPONSE *ClearSelResponse + ); + +/** + This function returns the time from the SEL Device. + + @param [out] GetSelTimeResponse Pointer to IPMI_GET_SEL_TIME_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSelTime ( + OUT IPMI_GET_SEL_TIME_RESPONSE *GetSelTimeResponse + ); + +/** + This function set the time in the SEL Device. + + @param [in] SetSelTimeRequest Pointer to IPMI_SET_SEL_TIME_REQUEST. + @param [out] CompletionCode IPMI completetion code, refer to Ipmi.h= . + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSetSelTime ( + IN IPMI_SET_SEL_TIME_REQUEST *SetSelTimeRequest, + OUT UINT8 *CompletionCode + ); + +/** + This function returns the SDR command version for the SDR Repository. + + @param [out] ClearSelResponse Pointer to receive IPMI_GET_SDR_REPOSITO= RY_INFO_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSdrRepositoryInfo ( + OUT IPMI_GET_SDR_REPOSITORY_INFO_RESPONSE *GetSdrRepositoryInfoResp + ); + +/** + This function returns the sensor record specified by Record ID. + + @param [in] GetSdrRequest Pointer to IPMI_GET_SDR_REQUEST. + @param [out] GetSdrResponse Pointer to receive IPMI_GET_SDR_RE= SPONSE. + @param [in, out] GetSdrResponseSize Size of entire GetSdrResponse. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSdr ( + IN IPMI_GET_SDR_REQUEST *GetSdrRequest, + OUT IPMI_GET_SDR_RESPONSE *GetSdrResponse, + IN OUT UINT32 *GetSdrResponseSize + ); + +#endif // IPMI_COMMAND_LIB_H_ diff --git a/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCommandLi= bNetFnApp.c b/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCommandL= ibNetFnApp.c new file mode 100644 index 0000000000..30c412e2f4 --- /dev/null +++ b/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCommandLibNetFnA= pp.c @@ -0,0 +1,444 @@ +/** @file + IPMI Command - NetFnApp. + + Copyright (c) 2018 - 2021, Intel Corporation. All rights reserved.
+ Copyright (C) 2023 Advanced Micro Devices, Inc. All rights reserved.
+ + SPDX-License-Identifier: BSD-2-Clause-Patent +**/ + +#include +#include +#include +#include + +#include + +/** + This function is used to retrieve device ID. + + @param [out] DeviceId The pointer to receive IPMI_GET_DEVICE_ID_RESPON= SE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetDeviceId ( + OUT IPMI_GET_DEVICE_ID_RESPONSE *DeviceId + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*DeviceId); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_APP, + IPMI_APP_GET_DEVICE_ID, + NULL, + 0, + (VOID *)DeviceId, + &DataSize + ); + return Status; +} + +/** + This function returns device self test results + + @param [out] SelfTestResult The pointer to receive IPMI_SELF_TEST_RESU= LT_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSelfTestResult ( + OUT IPMI_SELF_TEST_RESULT_RESPONSE *SelfTestResult + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*SelfTestResult); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_APP, + IPMI_APP_GET_SELFTEST_RESULTS, + NULL, + 0, + (VOID *)SelfTestResult, + &DataSize + ); + return Status; +} + +/** + This function is used for starting and restarting the Watchdog + Timer from the initial countdown value that was specified in + the Set Watchdog Timer command the watchdog timer + + @param [out] CompletionCode IPMI completetion code, refer to Ipmi.h. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiResetWatchdogTimer ( + OUT UINT8 *CompletionCode + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*CompletionCode); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_APP, + IPMI_APP_RESET_WATCHDOG_TIMER, + NULL, + 0, + (VOID *)CompletionCode, + &DataSize + ); + return Status; +} + +/** + This function is used for initializing and configuring + the watchdog timer. + + @param [in] SetWatchdogTimer Pointer to receive IPMI_SET_WATCHDOG_TIM= ER_REQUEST. + @param [out] CompletionCode IPMI completetion code, refer to Ipmi.h. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSetWatchdogTimer ( + IN IPMI_SET_WATCHDOG_TIMER_REQUEST *SetWatchdogTimer, + OUT UINT8 *CompletionCode + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*CompletionCode); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_APP, + IPMI_APP_SET_WATCHDOG_TIMER, + (VOID *)SetWatchdogTimer, + sizeof (*SetWatchdogTimer), + (VOID *)CompletionCode, + &DataSize + ); + return Status; +} + +/** + This function retrieves the current settings and present + countdown of the watchdog timer. + + @param [out] GetWatchdogTimer Pointer to receive IPMI_GET_WATCHDOG_TIM= ER_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetWatchdogTimer ( + OUT IPMI_GET_WATCHDOG_TIMER_RESPONSE *GetWatchdogTimer + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*GetWatchdogTimer); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_APP, + IPMI_APP_GET_WATCHDOG_TIMER, + NULL, + 0, + (VOID *)GetWatchdogTimer, + &DataSize + ); + return Status; +} + +/** + This function enables message reception into Message Buffers, + and any interrupt associated with that buffer getting full. + + @param [in] SetBmcGlobalEnables Pointer receive to IPMI_SET_BMC_GLOBA= L_ENABLES_REQUEST. + @param [out] CompletionCode IPMI completetion code refer to Ipmi.h= . + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSetBmcGlobalEnables ( + IN IPMI_SET_BMC_GLOBAL_ENABLES_REQUEST *SetBmcGlobalEnables, + OUT UINT8 *CompletionCode + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*CompletionCode); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_APP, + IPMI_APP_SET_BMC_GLOBAL_ENABLES, + (VOID *)SetBmcGlobalEnables, + sizeof (*SetBmcGlobalEnables), + (VOID *)CompletionCode, + &DataSize + ); + return Status; +} + +/** + This function retrieves the present setting of the Global Enables + + @param [out] GetBmcGlobalEnables Pointer to receive IPMI_GET_BMC_GLOBA= L_ENABLES_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetBmcGlobalEnables ( + OUT IPMI_GET_BMC_GLOBAL_ENABLES_RESPONSE *GetBmcGlobalEnables + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*GetBmcGlobalEnables); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_APP, + IPMI_APP_GET_BMC_GLOBAL_ENABLES, + NULL, + 0, + (VOID *)GetBmcGlobalEnables, + &DataSize + ); + return Status; +} + +/** + This function is used to flush unread data from the Receive + Message Queue or Event Message Buffer + + @param [in] ClearMessageFlagsRequest IPMI_CLEAR_MESSAGE_FLAGS_REQUEST + @param [out] CompletionCode IPMI completetion code, refer to = Ipmi.h. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiClearMessageFlags ( + IN IPMI_CLEAR_MESSAGE_FLAGS_REQUEST *ClearMessageFlagsRequest, + OUT UINT8 *CompletionCode + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*CompletionCode); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_APP, + IPMI_APP_CLEAR_MESSAGE_FLAGS, + (VOID *)ClearMessageFlagsRequest, + sizeof (*ClearMessageFlagsRequest), + (VOID *)CompletionCode, + &DataSize + ); + return Status; +} + +/** + This function is used to retrieve the present message available states. + + @param [out] GetMessageFlagsResponse Pointer to receive IPMI_GET_MESS= AGE_FLAGS_RESPONSE + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetMessageFlags ( + OUT IPMI_GET_MESSAGE_FLAGS_RESPONSE *GetMessageFlagsResponse + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*GetMessageFlagsResponse); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_APP, + IPMI_APP_GET_MESSAGE_FLAGS, + NULL, + 0, + (VOID *)GetMessageFlagsResponse, + &DataSize + ); + return Status; +} + +/** + This function is used to get data from the Receive Message Queue. + + @param [out] GetMessageResponse Pointer to receive IPMI_GET_ME= SSAGE_RESPONSE. + @param [in, out] GetMessageResponseSize When in, which is the expected= size of + response. When out, which is t= he actual + size returned. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetMessage ( + OUT IPMI_GET_MESSAGE_RESPONSE *GetMessageResponse, + IN OUT UINT32 *GetMessageResponseSize + ) +{ + EFI_STATUS Status; + + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_APP, + IPMI_APP_GET_MESSAGE, + NULL, + 0, + (VOID *)GetMessageResponse, + GetMessageResponseSize + ); + return Status; +} + +/** + This function is used for bridging IPMI messages between channels, + and between the system management software (SMS) and a given channel + + @param [in] SendMessageRequest Pointer to IPMI_SEND_MESSAGE_REQU= EST. + @param [in] SendMessageRequestSize Size of entire SendMessageRequest= Size. + @param [out] SendMessageResponse Pointer to receive IPMI_SEND_MESS= AGE_RESPONSE. + @param [in] SendMessageResponseSize When in, which is the expected si= ze of + response. When out, which is the = actual + size returned. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSendMessage ( + IN IPMI_SEND_MESSAGE_REQUEST *SendMessageRequest, + IN UINT32 SendMessageRequestSize, + OUT IPMI_SEND_MESSAGE_RESPONSE *SendMessageResponse, + IN OUT UINT32 *SendMessageResponseSize + ) +{ + EFI_STATUS Status; + + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_APP, + IPMI_APP_SEND_MESSAGE, + (VOID *)SendMessageRequest, + SendMessageRequestSize, + (VOID *)SendMessageResponse, + SendMessageResponseSize + ); + return Status; +} + +/** + This function gets the system UUID. + + @param[out] SystemGuid The pointer to retrieve system UUID. + + @retval EFI_SUCCESS UUID is returned. + @retval EFI_INVALID_PARAMETER SystemGuid is a NULL pointer. + @retval Others See the return values of IpmiSubmitCom= mand () function. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSystemUuid ( + OUT EFI_GUID *SystemGuid + ) +{ + EFI_STATUS Status; + UINT32 RequestSize; + UINT32 ResponseSize; + IPMI_GET_SYSTEM_UUID_RESPONSE GetSystemUuidResponse; + + if (SystemGuid =3D=3D NULL) { + return EFI_INVALID_PARAMETER; + } + + RequestSize =3D 0; + ResponseSize =3D sizeof (IPMI_GET_SYSTEM_UUID_RESPONSE); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_APP, + IPMI_APP_GET_SYSTEM_GUID, + (VOID *)NULL, + RequestSize, + (VOID *)&GetSystemUuidResponse, + &ResponseSize + ); + if (!EFI_ERROR (Status) && (GetSystemUuidResponse.CompletionCode =3D=3D = IPMI_COMP_CODE_NORMAL)) { + CopyMem ( + (VOID *)SystemGuid, + (VOID *)&GetSystemUuidResponse.SystemUuid, + sizeof (EFI_GUID) + ); + } + + return Status; +} + +/** + This function gets the channel information. + + @param[in] GetChannelInfoRequest The get channel information = request. + @param[out] GetChannelInfoResponse The get channel information = response. + @param[out] GetChannelInfoResponseSize When input, the expected siz= e of response. + When output, the exact size = of the returned + response. + + @retval EFI_SUCCESS Get channel information successfully. + @retval EFI_INVALID_PARAMETER One of the given input parameters is inva= lid. + @retval Others See the return values of IpmiSubmitComman= d () function. + +**/ +EFI_STATUS +EFIAPI +IpmiGetChannelInfo ( + IN IPMI_GET_CHANNEL_INFO_REQUEST *GetChannelInfoRequest, + OUT IPMI_GET_CHANNEL_INFO_RESPONSE *GetChannelInfoResponse, + OUT UINT32 *GetChannelInfoResponseSize + ) +{ + EFI_STATUS Status; + + if ((GetChannelInfoRequest =3D=3D NULL) || + (GetChannelInfoResponse =3D=3D NULL) || + (GetChannelInfoResponseSize =3D=3D NULL)) + { + return EFI_INVALID_PARAMETER; + } + + *GetChannelInfoResponseSize =3D sizeof (IPMI_GET_CHANNEL_INFO_RESPONSE); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_APP, + IPMI_APP_GET_CHANNEL_INFO, + (UINT8 *)GetChannelInfoRequest, + sizeof (IPMI_GET_CHANNEL_INFO_REQUEST), + (UINT8 *)GetChannelInfoResponse, + GetChannelInfoResponseSize + ); + return Status; +} diff --git a/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCommandLi= bNetFnChassis.c b/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiComm= andLibNetFnChassis.c new file mode 100644 index 0000000000..12fd997b11 --- /dev/null +++ b/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCommandLibNetFnC= hassis.c @@ -0,0 +1,199 @@ +/** @file + IPMI Command - NetFnChassis. + + Copyright (c) 2018 - 2021, Intel Corporation. All rights reserved.
+ SPDX-License-Identifier: BSD-2-Clause-Patent +**/ + +#include +#include +#include +#include + +#include + +/** + This function returns information about which main chassis management fu= nctions are + present and what addresses are used to access those functions. + + @param [out] GetChassisCapabilitiesResponse Pointer to IPMI_GET_CHASSI= S_CAPABILITIES_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetChassisCapabilities ( + OUT IPMI_GET_CHASSIS_CAPABILITIES_RESPONSE *GetChassisCapabilitiesRespo= nse + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*GetChassisCapabilitiesResponse); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_CHASSIS, + IPMI_CHASSIS_GET_CAPABILITIES, + NULL, + 0, + (VOID *)GetChassisCapabilitiesResponse, + &DataSize + ); + return Status; +} + +/** + This function gets information regarding the high-level status of the s= ystem + chassis and main power subsystem. + + @param [out] GetChassisStatusResponse Pointer to IPMI_GET_CHASSIS_STAT= US_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetChassisStatus ( + OUT IPMI_GET_CHASSIS_STATUS_RESPONSE *GetChassisStatusResponse + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*GetChassisStatusResponse); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_CHASSIS, + IPMI_CHASSIS_GET_STATUS, + NULL, + 0, + (VOID *)GetChassisStatusResponse, + &DataSize + ); + return Status; +} + +/** + This function sends command to control power up, power down, and reset. + + @param [in] ChassisControlRequest Pointer to IPMI_CHASSIS_CONTROL_REQ= UEST. + @param [out] CompletionCode IPMI completetion code, refer to Ip= mi.h. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiChassisControl ( + IN IPMI_CHASSIS_CONTROL_REQUEST *ChassisControlRequest, + OUT UINT8 *CompletionCode + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*CompletionCode); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_CHASSIS, + IPMI_CHASSIS_CONTROL, + (VOID *)ChassisControlRequest, + sizeof (*ChassisControlRequest), + (VOID *)CompletionCode, + &DataSize + ); + return Status; +} + +/** + This function is used to configure the power restore policy. + + @param [in] ChassisControlRequest Pointer to IPMI_SET_POWER_RESTORE_= POLICY_REQUEST. + @param [out] ChassisControlResponse Pointer to IPMI_SET_POWER_RESTORE_= POLICY_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSetPowerRestorePolicy ( + IN IPMI_SET_POWER_RESTORE_POLICY_REQUEST *ChassisControlRequest, + OUT IPMI_SET_POWER_RESTORE_POLICY_RESPONSE *ChassisControlResponse + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*ChassisControlResponse); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_CHASSIS, + IPMI_CHASSIS_SET_POWER_RESTORE_POLICY, + (VOID *)ChassisControlRequest, + sizeof (*ChassisControlRequest), + (VOID *)ChassisControlResponse, + &DataSize + ); + return Status; +} + +/** + This function is used to set parameters that direct the system boot + following a system power up or reset. + + @param [in] BootOptionsRequest Pointer to IPMI_SET_BOOT_OPTIONS_REQU= EST. + @param [out] BootOptionsResponse Pointer to IPMI_SET_BOOT_OPTIONS_RESP= ONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSetSystemBootOptions ( + IN IPMI_SET_BOOT_OPTIONS_REQUEST *BootOptionsRequest, + OUT IPMI_SET_BOOT_OPTIONS_RESPONSE *BootOptionsResponse + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*BootOptionsResponse); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_CHASSIS, + IPMI_CHASSIS_SET_SYSTEM_BOOT_OPTIONS, + (VOID *)BootOptionsRequest, + sizeof (*BootOptionsRequest), + (VOID *)BootOptionsResponse, + &DataSize + ); + return Status; +} + +/** + This function is used to retrieve the boot options set by the + Set System Boot Options command. + + @param [in] BootOptionsRequest Pointer to IPMI_GET_BOOT_OPTIONS_REQU= EST. + @param [out] BootOptionsResponse Pointer to IPMI_GET_BOOT_OPTIONS_RESP= ONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSystemBootOptions ( + IN IPMI_GET_BOOT_OPTIONS_REQUEST *BootOptionsRequest, + OUT IPMI_GET_BOOT_OPTIONS_RESPONSE *BootOptionsResponse + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*BootOptionsResponse); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_CHASSIS, + IPMI_CHASSIS_GET_SYSTEM_BOOT_OPTIONS, + (VOID *)BootOptionsRequest, + sizeof (*BootOptionsRequest), + (VOID *)BootOptionsResponse, + &DataSize + ); + return Status; +} diff --git a/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCommandLi= bNetFnStorage.c b/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiComm= andLibNetFnStorage.c new file mode 100644 index 0000000000..2dbb7ac9ff --- /dev/null +++ b/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCommandLibNetFnS= torage.c @@ -0,0 +1,384 @@ +/** @file + IPMI Command - NetFnStorage. + + Copyright (c) 2018 - 2021, Intel Corporation. All rights reserved.
+ SPDX-License-Identifier: BSD-2-Clause-Patent +**/ + +#include +#include +#include +#include + +#include + +/** + This function is used to retrieve FRU Inventory Area + + @param [in] GetFruInventoryAreaInfoRequest Pointer to IPMI_GET_FRU_IN= VENTORY_AREA_INFO_REQUEST. + @param [out] GetFruInventoryAreaInfoResponse Pointer to IPMI_GET_FRU_IN= VENTORY_AREA_INFO_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetFruInventoryAreaInfo ( + IN IPMI_GET_FRU_INVENTORY_AREA_INFO_REQUEST *GetFruInventoryAreaInfoR= equest, + OUT IPMI_GET_FRU_INVENTORY_AREA_INFO_RESPONSE *GetFruInventoryAreaInfoR= esponse + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*GetFruInventoryAreaInfoResponse); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_STORAGE, + IPMI_STORAGE_GET_FRU_INVENTORY_AREAINFO, + (VOID *)GetFruInventoryAreaInfoRequest, + sizeof (*GetFruInventoryAreaInfoRequest), + (VOID *)GetFruInventoryAreaInfoResponse, + &DataSize + ); + return Status; +} + +/** + This function returns specified data from the FRU Inventory Info area. + + @param [in] ReadFruDataRequest Pointer to IPMI_READ_FRU_DATA_REQU= EST. + @param [in] ReadFruDataResponse Pointer to IPMI_READ_FRU_DATA_RESP= ONSE. + @param [in, out] ReadFruDataResponseSize Returns the size of ReadFruDat= aResponse. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiReadFruData ( + IN IPMI_READ_FRU_DATA_REQUEST *ReadFruDataRequest, + OUT IPMI_READ_FRU_DATA_RESPONSE *ReadFruDataResponse, + IN OUT UINT32 *ReadFruDataResponseSize + ) +{ + EFI_STATUS Status; + + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_STORAGE, + IPMI_STORAGE_READ_FRU_DATA, + (VOID *)ReadFruDataRequest, + sizeof (*ReadFruDataRequest), + (VOID *)ReadFruDataResponse, + ReadFruDataResponseSize + ); + return Status; +} + +/** + This function writes specified data from the FRU Inventory Info area. + + @param [in] WriteFruDataRequest Pointer to IPMI_WRITE_FRU_DATA_REQ= UEST. + @param [in] WriteFruDataRequestSize Size of WriteFruDataRequest. + @param [out] WriteFruDataResponse Pointer to receive IPMI_WRITE_FRU_= DATA_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiWriteFruData ( + IN IPMI_WRITE_FRU_DATA_REQUEST *WriteFruDataRequest, + IN UINT32 WriteFruDataRequestSize, + OUT IPMI_WRITE_FRU_DATA_RESPONSE *WriteFruDataResponse + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*WriteFruDataResponse); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_STORAGE, + IPMI_STORAGE_WRITE_FRU_DATA, + (VOID *)WriteFruDataRequest, + WriteFruDataRequestSize, + (VOID *)WriteFruDataResponse, + &DataSize + ); + return Status; +} + +/** + This function returns the number of entries in the SEL + + @param [out] GetSelInfoResponse Pointer to receive IPMI_GET_SEL_INFO= _RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSelInfo ( + OUT IPMI_GET_SEL_INFO_RESPONSE *GetSelInfoResponse + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*GetSelInfoResponse); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_STORAGE, + IPMI_STORAGE_GET_SEL_INFO, + NULL, + 0, + (VOID *)GetSelInfoResponse, + &DataSize + ); + return Status; +} + +/** + This function retrieves entries from the SEL + + @param [in] GetSelEntryRequest Pointer to IPMI_GET_SEL_ENTRY_REQU= EST. + @param [out] GetSelEntryResponse Pointer to receive IPMI_GET_SEL_EN= TRY_RESPONSE. + @param [in, out] GetSelEntryResponseSize Size of entire GetSelEntryRes= ponse. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSelEntry ( + IN IPMI_GET_SEL_ENTRY_REQUEST *GetSelEntryRequest, + OUT IPMI_GET_SEL_ENTRY_RESPONSE *GetSelEntryResponse, + IN OUT UINT32 *GetSelEntryResponseSize + ) +{ + EFI_STATUS Status; + + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_STORAGE, + IPMI_STORAGE_GET_SEL_ENTRY, + (VOID *)GetSelEntryRequest, + sizeof (*GetSelEntryRequest), + (VOID *)GetSelEntryResponse, + GetSelEntryResponseSize + ); + return Status; +} + +/** + This function adds an entry in the SEL + + @param [in] AddSelEntryRequest Pointer to IPMI_ADD_SEL_ENTRY_REQU= EST. + @param [out] AddSelEntryResponse Pointer to receive IPMI_ADD_SEL_EN= TRY_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiAddSelEntry ( + IN IPMI_ADD_SEL_ENTRY_REQUEST *AddSelEntryRequest, + OUT IPMI_ADD_SEL_ENTRY_RESPONSE *AddSelEntryResponse + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*AddSelEntryResponse); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_STORAGE, + IPMI_STORAGE_ADD_SEL_ENTRY, + (VOID *)AddSelEntryRequest, + sizeof (*AddSelEntryRequest), + (VOID *)AddSelEntryResponse, + &DataSize + ); + return Status; +} + +/** + This function adds SEL Entry command that allows the record to be increm= entally + added to the SEL. + + @param [in] PartialAddSelEntryRequest Pointer to IPMI_PARTIAL_ADD= _SEL_ENTRY_REQUEST. + @param [in] PartialAddSelEntryRequestSize Size of entire PartialAddSe= lEntryRequest. + @param [out] PartialAddSelEntryResponse Pointer to receive IPMI_PAR= TIAL_ADD_SEL_ENTRY_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiPartialAddSelEntry ( + IN IPMI_PARTIAL_ADD_SEL_ENTRY_REQUEST *PartialAddSelEntryRequest, + IN UINT32 PartialAddSelEntryRequestSize, + OUT IPMI_PARTIAL_ADD_SEL_ENTRY_RESPONSE *PartialAddSelEntryResponse + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*PartialAddSelEntryResponse); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_STORAGE, + IPMI_STORAGE_PARTIAL_ADD_SEL_ENTRY, + (VOID *)PartialAddSelEntryRequest, + PartialAddSelEntryRequestSize, + (VOID *)PartialAddSelEntryResponse, + &DataSize + ); + return Status; +} + +/** + This function erases all contents of the System Event Log. + + @param [in] ClearSelRequest Pointer to IPMI_CLEAR_SEL_REQUEST. + @param [out] ClearSelResponse Pointer to receive IPMI_CLEAR_SEL_RES= PONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiClearSel ( + IN IPMI_CLEAR_SEL_REQUEST *ClearSelRequest, + OUT IPMI_CLEAR_SEL_RESPONSE *ClearSelResponse + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*ClearSelResponse); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_STORAGE, + IPMI_STORAGE_CLEAR_SEL, + (VOID *)ClearSelRequest, + sizeof (*ClearSelRequest), + (VOID *)ClearSelResponse, + &DataSize + ); + return Status; +} + +/** + This function returns the time from the SEL Device. + + @param [out] GetSelTimeResponse Pointer to IPMI_GET_SEL_TIME_RESP= ONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSelTime ( + OUT IPMI_GET_SEL_TIME_RESPONSE *GetSelTimeResponse + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*GetSelTimeResponse); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_STORAGE, + IPMI_STORAGE_GET_SEL_TIME, + NULL, + 0, + (VOID *)GetSelTimeResponse, + &DataSize + ); + return Status; +} + +/** + This function set the time in the SEL Device. + + @param [in] SetSelTimeRequest Pointer to IPMI_SET_SEL_TIME_REQUES= T. + @param [out] CompletionCode IPMI completetion code, refer to Ipm= i.h. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSetSelTime ( + IN IPMI_SET_SEL_TIME_REQUEST *SetSelTimeRequest, + OUT UINT8 *CompletionCode + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*CompletionCode); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_STORAGE, + IPMI_STORAGE_SET_SEL_TIME, + (VOID *)SetSelTimeRequest, + sizeof (*SetSelTimeRequest), + (VOID *)CompletionCode, + &DataSize + ); + return Status; +} + +/** + This function returns the SDR command version for the SDR Repository + + @param [out] ClearSelResponse Pointer to receive IPMI_GET_SDR_REPOS= ITORY_INFO_RESPONSE. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSdrRepositoryInfo ( + OUT IPMI_GET_SDR_REPOSITORY_INFO_RESPONSE *GetSdrRepositoryInfoResp + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*GetSdrRepositoryInfoResp); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_STORAGE, + IPMI_STORAGE_GET_SDR_REPOSITORY_INFO, + NULL, + 0, + (VOID *)GetSdrRepositoryInfoResp, + &DataSize + ); + return Status; +} + +/** + This function returns the sensor record specified by Record ID. + + @param [in] GetSdrRequest Pointer to IPMI_GET_SDR_REQUEST. + @param [out] GetSdrResponse Pointer to receive IPMI_GET_SDR_RESPONS= E. + @param [in, out] GetSdrResponseSize Size of entire GetSdrResponse. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSdr ( + IN IPMI_GET_SDR_REQUEST *GetSdrRequest, + OUT IPMI_GET_SDR_RESPONSE *GetSdrResponse, + IN OUT UINT32 *GetSdrResponseSize + ) +{ + EFI_STATUS Status; + + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_STORAGE, + IPMI_STORAGE_GET_SDR, + (VOID *)GetSdrRequest, + sizeof (*GetSdrRequest), + (VOID *)GetSdrResponse, + GetSdrResponseSize + ); + return Status; +} diff --git a/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCommandLi= bNetFnTransport.c b/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCo= mmandLibNetFnTransport.c new file mode 100644 index 0000000000..a93f7406f1 --- /dev/null +++ b/Features/ManageabilityPkg/Library/IpmiCommandLib/IpmiCommandLibNetFnT= ransport.c @@ -0,0 +1,156 @@ +/** @file + IPMI Command - NetFnTransport. + + Copyright (c) 2018 - 2021, Intel Corporation. All rights reserved.
+ Copyright (C) 2023 Advanced Micro Devices, Inc. All rights reserved.
+ + SPDX-License-Identifier: BSD-2-Clause-Patent +**/ + +#include +#include +#include +#include + +#include + +/** + This function sends command to BMC to notify a remote application + that a SOL payload is activating on another channel. + + @param [in] SolActivatingRequest The get channel information request. + @param [out] CompletionCode IPMI completetion code, refer to Ipm= i.h. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSolActivating ( + IN IPMI_SOL_ACTIVATING_REQUEST *SolActivatingRequest, + OUT UINT8 *CompletionCode + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*CompletionCode); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_TRANSPORT, + IPMI_TRANSPORT_SOL_ACTIVATING, + (VOID *)SolActivatingRequest, + sizeof (*SolActivatingRequest), + (VOID *)CompletionCode, + &DataSize + ); + return Status; +} + +/** + This function is used to set parameters such as the network addressing + information required for SOL payload operation. + + @param [in] SetConfigurationParametersRequest Pointer to IPMI_SET= _SOL_CONFIGURATION_PARAMETERS_REQUEST. + @param [in] SetConfigurationParametersRequestSize Size of entire SetC= onfigurationParametersRequestSize. + @param [out] CompletionCode IPMI completetion c= ode, refer to Ipmi.h. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiSetSolConfigurationParameters ( + IN IPMI_SET_SOL_CONFIGURATION_PARAMETERS_REQUEST *SetConfigurationPara= metersRequest, + IN UINT32 SetConfigurationParam= etersRequestSize, + OUT UINT8 *CompletionCode + ) +{ + EFI_STATUS Status; + UINT32 DataSize; + + DataSize =3D sizeof (*CompletionCode); + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_TRANSPORT, + IPMI_TRANSPORT_SET_SOL_CONFIG_PARAM, + (VOID *)SetConfigurationParametersRequest, + SetConfigurationParametersRequestSize, + (VOID *)CompletionCode, + &DataSize + ); + return Status; +} + +/** + This function is used to retrieve the configuration parameters from the + Set SOL Configuration Parameters. + + @param [in] GetConfigurationParametersRequest Pointer to IPM= I_SET_SOL_CONFIGURATION_PARAMETERS_REQUEST. + @param [out] GetConfigurationParametersResponse Pointer to rec= eive IPMI_GET_SOL_CONFIGURATION_PARAMETERS_RESPONSE + @param [in, out] GetConfigurationParametersResponseSize When in, which= is the expected size of + response. When= out, which is the actual + size returned. + + @retval EFI_STASTUS See the return values of IpmiSubmitCommand () func= tion. + +**/ +EFI_STATUS +EFIAPI +IpmiGetSolConfigurationParameters ( + IN IPMI_GET_SOL_CONFIGURATION_PARAMETERS_REQUEST *GetConfigurationPar= ametersRequest, + OUT IPMI_GET_SOL_CONFIGURATION_PARAMETERS_RESPONSE *GetConfigurationPar= ametersResponse, + IN OUT UINT32 *GetConfigurationPar= ametersResponseSize + ) +{ + EFI_STATUS Status; + + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_TRANSPORT, + IPMI_TRANSPORT_GET_SOL_CONFIG_PARAM, + (VOID *)GetConfigurationParametersRequest, + sizeof (*GetConfigurationParametersRequest), + (VOID *)GetConfigurationParametersResponse, + GetConfigurationParametersResponseSize + ); + return Status; +} + +/** + This function gets the LAN configuration parameter. + + @param[in] GetLanConfigurationParametersRequest Request data + @param[out] GetLanConfigurationParametersResponse Response data + @param[in,out] GetLanConfigurationParametersSize When input, the e= xpected size of response data. + When out, the exa= ct size of response data. + + @retval EFI_SUCCESS Lan configuration parameter is returned i= n the response. + @retval EFI_INVALID_PARAMETER One of the given input parameters is inva= lid. + @retval Others Other errors. + +**/ +EFI_STATUS +EFIAPI +IpmiGetLanConfigurationParameters ( + IN IPMI_GET_LAN_CONFIGURATION_PARAMETERS_REQUEST *GetLanConfigurat= ionParametersRequest, + OUT IPMI_GET_LAN_CONFIGURATION_PARAMETERS_RESPONSE *GetLanConfigurat= ionParametersResponse, + IN OUT UINT32 *GetLanConfigurat= ionParametersSize + ) +{ + EFI_STATUS Status; + + if ((GetLanConfigurationParametersRequest =3D=3D NULL) || + (GetLanConfigurationParametersResponse =3D=3D NULL) || + (GetLanConfigurationParametersSize =3D=3D NULL)) + { + return EFI_INVALID_PARAMETER; + } + + Status =3D IpmiSubmitCommand ( + IPMI_NETFN_TRANSPORT, + IPMI_TRANSPORT_GET_LAN_CONFIG_PARAMETERS, + (UINT8 *)GetLanConfigurationParametersRequest, + sizeof (*GetLanConfigurationParametersRequest), + (UINT8 *)GetLanConfigurationParametersResponse, + GetLanConfigurationParametersSize + ); + return Status; +} --=20 2.37.1.windows.1