Add comments.

git-svn-id: https://src.develer.com/svnoss/bertos/branches/i2c@4071 38d2e660-2303-0410-9eaa-f027e97ec537

diff --git a/bertos/drv/i2c.h b/bertos/drv/i2c.h
index 75fb54a51ed1b2e7e1cec744c3afdc10cb9b8dbe..268e2451e89c9b1d0c2110d38821ae6b80f9f445 100644 (file)
--- a/bertos/drv/i2c.h
+++ b/bertos/drv/i2c.h
@@ -136,20 +136,24 @@ bool i2c_recv(void *_buf, size_t count);
 
 /*
  * I2c new api
- *
  */
-#define I2C_OK               0
-#define I2C_ERR           BV(3)
-#define I2C_ARB_LOST      BV(2)
-#define I2C_START_TIMEOUT BV(0)
-#define I2C_NO_ACK        BV(1)
-
 
+ /*
+  * I2C error flags
+  */
+#define I2C_OK               0     ///< I2C no errors flag
+#define I2C_ERR           BV(3)    ///< I2C generic error
+#define I2C_ARB_LOST      BV(2)    ///< I2C arbitration lost error
+#define I2C_START_TIMEOUT BV(0)    ///< I2C timeout error on start
+#define I2C_NO_ACK        BV(1)    ///< I2C no ack for sla start
 
-#define I2C_NOSTOP           0
-#define I2C_STOP          BV(0)
-#define I2C_START_R       BV(1)
-#define I2C_START_W          0
+/*
+ * I2C command flags
+ */
+#define I2C_NOSTOP           0    ///< Do not program the stop for current transition
+#define I2C_STOP          BV(0)   ///< Program the stop for current transition
+#define I2C_START_R       BV(1)   ///< Start read command
+#define I2C_START_W          0    ///< Start write command
 
 
 #define I2C_TEST_START(flag)  ((flag) & I2C_START_R)