]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Include/Ppi/I2cMaster.h
MdePkg: Clean up source files
[mirror_edk2.git] / MdePkg / Include / Ppi / I2cMaster.h
index a46b055675b299f89549e6e07a5e5208d65217c2..274f3e79b7e88445df09c6a25441721887509225 100644 (file)
@@ -1,15 +1,15 @@
 /** @file\r
-  This PPI manipulates the I2C host controller to perform transactions as a master \r
+  This PPI manipulates the I2C host controller to perform transactions as a master\r
   on the I2C bus using the current state of any switches or multiplexers in the I2C bus.\r
 \r
-  Copyright (c) 2013, Intel Corporation. All rights reserved.<BR>\r
-  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
+  Copyright (c) 2013 - 2018, Intel Corporation. All rights reserved.<BR>\r
+  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
+  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 introduced in PI Version 1.3.\r
@@ -28,16 +28,16 @@ typedef struct _EFI_PEI_I2C_MASTER_PPI EFI_PEI_I2C_MASTER_PPI;
 \r
 /**\r
   Set the frequency for the I2C clock line.\r
-  \r
+\r
   @param This                   Pointer to an EFI_PEI_I2C_MASTER_PPI structure.\r
   @param BusClockHertz          Pointer to the requested I2C bus clock frequency in Hertz.\r
-                                Upon return this value contains the actual frequency \r
+                                Upon return this value contains the actual frequency\r
                                 in use by the I2C controller.\r
 \r
   @retval EFI_SUCCESS           The bus frequency was set successfully.\r
   @retval EFI_INVALID_PARAMETER BusClockHertz is NULL\r
   @retval EFI_UNSUPPORTED       The controller does not support this frequency.\r
-   \r
+\r
 **/\r
 typedef\r
 EFI_STATUS\r
@@ -48,12 +48,12 @@ EFI_STATUS
 \r
 /**\r
   Reset the I2C controller and configure it for use.\r
-  \r
+\r
   @param  This                  Pointer to an EFI_PEI_I2C_MASTER_PPI structure.\r
 \r
   @retval EFI_SUCCESS           The reset completed successfully.\r
   @retval EFI_DEVICE_ERROR      The reset operation failed.\r
-   \r
+\r
 **/\r
 typedef\r
 EFI_STATUS\r
@@ -63,25 +63,25 @@ EFI_STATUS
 \r
 /**\r
   Start an I2C transaction on the host controller.\r
-  \r
+\r
   @param  This                   Pointer to an EFI_PEI_I2C_MASTER_PPI structure.\r
   @param  SlaveAddress           Address of the device on the I2C bus.\r
-                                 Set the I2C_ADDRESSING_10_BIT when using 10-bit addresses, \r
+                                 Set the I2C_ADDRESSING_10_BIT when using 10-bit addresses,\r
                                  clear this bit for 7-bit addressing.\r
-                                 Bits 0-6 are used for 7-bit I2C slave addresses and \r
+                                 Bits 0-6 are used for 7-bit I2C slave addresses and\r
                                  bits 0-9 are used for 10-bit I2C slave addresses.\r
   @param  RequestPacket          Pointer to an EFI_I2C_REQUEST_PACKET structure describing the I2C transaction.\r
 \r
-  @retval EFI_SUCCESS             The transaction completed successfully.\r
-  @retval EFI_BAD_BUFFER_SIZE     The RequestPacket->LengthInBytes value is too large.\r
-  @retval EFI_DEVICE_ERROR          There was an I2C error (NACK) during the transaction.\r
-  @retval EFI_INVALID_PARAMETER         RequestPacket is NULL\r
-  @retval EFI_NO_RESPONSE             The I2C device is not responding to the slave address.\r
+  @retval EFI_SUCCESS             The transaction completed successfully.\r
+  @retval EFI_BAD_BUFFER_SIZE     The RequestPacket->LengthInBytes value is too large.\r
+  @retval EFI_DEVICE_ERROR       There was an I2C error (NACK) during the transaction.\r
+  @retval EFI_INVALID_PARAMETER   RequestPacket is NULL\r
+  @retval EFI_NO_RESPONSE         The I2C device is not responding to the slave address.\r
                                  EFI_DEVICE_ERROR will be returned if the controller cannot distinguish when the NACK occurred.\r
-  @retval EFI_NOT_FOUND                 Reserved bit set in the SlaveAddress parameter\r
-  @retval EFI_OUT_OF_RESOURCES  Insufficient memory for I2C transaction\r
-  @retval EFI_UNSUPPORTED             The controller does not support the requested transaction.\r
-   \r
+  @retval EFI_NOT_FOUND           Reserved bit set in the SlaveAddress parameter\r
+  @retval EFI_OUT_OF_RESOURCES   Insufficient memory for I2C transaction\r
+  @retval EFI_UNSUPPORTED         The controller does not support the requested transaction.\r
+\r
 **/\r
 typedef\r
 EFI_STATUS\r