This file declares the Smbus PPI, which provides the basic I/O interfaces that a PEIM \r
uses to access its SMBus controller and the slave devices attached to it.\r
\r
- Copyright (c) 2007 - 2009, Intel Corporation\r
- All rights reserved. This program and the accompanying materials\r
- are licensed and made available under the terms and conditions of the BSD License\r
- which accompanies this distribution. The full text of the license may be found at\r
- http://opensource.org/licenses/bsd-license.php\r
-\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+Copyright (c) 2007 - 2010, Intel Corporation. All rights reserved<BR>\r
+This program and the accompanying materials are licensed and made available under \r
+the terms and conditions of the BSD License that accompanies this distribution. \r
+The full text of the license may be found at\r
+http://opensource.org/licenses/bsd-license.php. \r
+ \r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
@par Revision Reference:\r
This PPI is defined in Framework of EFI SmBus PPI spec.\r
- Version 0.9\r
+ Version 0.9.\r
\r
**/\r
\r
@param[in] SlaveAddress The SMBUS hardware address to which the SMBUS\r
device is preassigned or allocated.\r
@param[in] Command This command is transmitted by the SMBus host\r
- controller to the SMBus slave device and the interpretation is\r
- SMBus slave device specific.\r
+ controller to the SMBus slave device, and the \r
+ interpretation is SMBus slave device specific.\r
@param[in] Operation Signifies which particular SMBus hardware protocol\r
instance to use to execute the SMBus transactions.\r
- @param[in] PecCheck Defines if Packet Error Code (PEC) checking is required\r
- for this operation.\r
- @param[in, out] Length The number of bytes for this operation\r
- @param[in, out] Buffer Contains the value of data to execute to the SMBus slave device.\r
+ @param[in] PecCheck Defines if Packet Error Code (PEC) checking is \r
+ required for this operation.\r
+ @param[in, out] Length The number of bytes for this operation.\r
+ @param[in, out] Buffer Contains the value of data to execute to the SMBus \r
+ slave device.\r
\r
@retval EFI_SUCCESS The last data that was returned from the access\r
matched the poll exit criteria.\r
Timeout is determined by the SMBus host controller device.\r
@retval EFI_OUT_OF_RESOURCES The request could not be completed\r
due to a lack of resources.\r
- @retval EFI_DEVICE_ERROR The request was not completed because\r
- a failure was recorded in the Host Status Register bit.\r
- @retval EFI_INVALID_PARAMETER Operation is not defined in EFI_SMBUS_OPERATION.\r
- @retval EFI_INVALID_PARAMETER Length/Buffer is NULL for operations except for EfiSmbusQuickRead and\r
- EfiSmbusQuickWrite. Length is outside the range of valid values.\r
+ @retval EFI_DEVICE_ERROR The request was not completed because a failure\r
+ was recorded in the Host Status Register bit.\r
+ @retval EFI_INVALID_PARAMETER The operation is not defined in EFI_SMBUS_OPERATION.\r
+ @retval EFI_INVALID_PARAMETER Length/Buffer is NULL for operations except for \r
+ EfiSmbusQuickRead and EfiSmbusQuickWrite. Length \r
+ is outside the range of valid values.\r
@retval EFI_UNSUPPORTED The SMBus operation or PEC is not supported.\r
@retval EFI_BUFFER_TOO_SMALL Buffer is not sufficient for this operation.\r
\r
\r
@param[in] PeiServices A pointer to the system PEI Services Table.\r
@param[in] This A pointer to the EFI_PEI_SMBUS_PPI instance.\r
- @param[in] ArpAll A Boolean expression that indicates if the host drivers need\r
- to enumerate all the devices or enumerate only the device that is identified\r
- by SmbusUdid. If ArpAll is TRUE, SmbusUdid and SlaveAddress are optional and ignored if entered.\r
- If ArpAll is FALSE, ArpDevice will enumerate SmbusUdid and the address\r
- will be at SlaveAddress.\r
+ @param[in] ArpAll A Boolean expression that indicates if the host \r
+ drivers need to enumerate all the devices or to \r
+ enumerate only the device that is identified\r
+ by SmbusUdid. If ArpAll is TRUE, SmbusUdid and \r
+ SlaveAddress are optional and ignored if entered.\r
+ If ArpAll is FALSE, ArpDevice will enumerate \r
+ SmbusUdid, and the address will be at SlaveAddress.\r
@param[in] SmbusUdid The targeted SMBus Unique Device Identifier (UDID).\r
- The UDID may not exist for SMBus devices with fixed addresses.\r
+ The UDID may not exist for SMBus devices with fixed \r
+ addresses.\r
@param[in, out] SlaveAddress The new SMBus address for the slave device for\r
which the operation is targeted.\r
This address may be NULL.\r
@retval EFI_TIMEOUT The SMBus slave device did not respond.\r
@retval EFI_DEVICE_ERROR The request was not completed because the transaction failed.\r
@retval EFI_UNSUPPORTED ArpDevice() is not implemented by this PEIM. \r
- This return value is not defined in Framwork Specification.\r
+ This return value is not defined in the Framework Specification.\r
This return value was introduced in the PI Specification.\r
\r
**/\r
\r
@param[in] PeiServices A pointer to the system PEI Services Table.\r
@param[in] This A pointer to the EFI_PEI_SMBUS_PPI instance.\r
- @param[in, out] Length Size of the buffer that contains the SMBus device map.\r
+ @param[in, out] Length The size of the buffer that contains the SMBus device map.\r
@param[in, out] SmbusDeviceMap The pointer to the device map as enumerated\r
by the SMBus controller driver.\r
\r
@retval EFI_SUCCESS The device map was returned correctly in the buffer.\r
@retval EFI_UNSUPPORTED GetArpMap() are not implemented by this PEIM. \r
- This return value was not defined in Framwork Specification.\r
+ This return value was not defined in the Framework Specification.\r
This return value was introduced in the PI Specification.\r
\r
**/\r
propagate to other PEIMs that are registered for a callback.\r
\r
The Notify() function registers all the callback functions to allow the\r
- bus driver to call these functions when the SlaveAddress/Data pair happens.\r
+ bus driver to call these functions when the SlaveAddress/Data pair occur.\r
All functions to be registered with EFI_PEI_SMBUS_PPI_NOTIFY must be of type\r
EFI_PEI_SMBUS_NOTIFY_FUNCTION.\r
\r
@param[in] PeiServices A pointer to the system PEI Services Table.\r
@param[in] This A pointer to the EFI_PEI_SMBUS_PPI instance.\r
- @param[in] SlaveAddress Address that the host controller detects as\r
+ @param[in] SlaveAddress The address that the host controller detects as\r
sending a message and triggers all the registered functions.\r
@param[in] Data Data that the host controller detects as sending a message\r
and triggers all the registered functions.\r
\r
@retval EFI_SUCCESS NotifyFunction has been registered.\r
@retval EFI_UNSUPPORTED Notify() are not implemented by this PEIM. \r
- This return value is not defined in Framwork Specification.\r
+ This return value is not defined in the Framework Specification.\r
This return value was introduced in the PI Specification.\r
\r
**/\r