Documentation improvements

lib/include/pdb.h

@@ -26,8 +26,15 @@
 #include <pdb_msg.h>
 
 
+/* Version information */
+#define PDB_LIB_VERSION "0.1.0"
+#define PDB_LIB_MAJOR 0
+#define PDB_LIB_MINOR 1
+#define PDB_LIB_PATCH 0
+
+
 /*
- * Structure for PD Buddy firmware library configuration
+ * Structure for one USB port's PD Buddy firmware library configuration
  *
  * Contains working areas for statically allocated threads, and therefore must
  * be statically allocated!
@@ -53,6 +60,8 @@ struct pdb_config {
 
 /*
  * Initialize the PD Buddy firmware library, starting all its threads
+ *
+ * The I2C driver must already be initialized before calling this function.
  */
 void pdb_init(struct pdb_config *);
 

lib/include/pdb_fusb.h

@@ -31,7 +31,7 @@
  * Configuration for the FUSB302B chip
  */
 struct pdb_fusb_config {
-    /* The I2C bus that the chip is connected to */
+    /* The I2C driver for the bus that the chip is connected to */
     I2CDriver *i2cp;
     /* The I2C address of the chip */
     i2caddr_t addr;

src/main.c

@@ -84,8 +84,8 @@ static struct pdb_config pdb_config = {
         pdbs_dpm_transition_min,
         pdbs_dpm_transition_standby,
         pdbs_dpm_transition_requested,
-        pdbs_dpm_transition_requested, /* XXX type-c current */
-        NULL
+        pdbs_dpm_transition_requested, /* transition_typec */
+        NULL /* not_supported_received */
     },
     .dpm_data = &dpm_data
 };