Added more library headers

These new headers define structs for configuring the library.  They're
currently unused, and some function prototypes no longer match.

lib/include/pdb.h

@@ -19,11 +19,39 @@
 #ifndef PDB_H
 #define PDB_H
 
+#include <pdb_fusb.h>
+#include <pdb_dpm.h>
+#include <pdb_pe.h>
+#include <pdb_prl.h>
+#include <pdb_int_n.h>
+
+
+/*
+ * Structure for PD Buddy firmware library configuration
+ *
+ * Contains working areas for statically allocated threads, and therefore must
+ * be statically allocated!
+ */
+struct pdb_config {
+    /* Configuration information for the FUSB302B* chip */
+    struct pdb_fusb_config fusb_config;
+    /* DPM callbacks */
+    struct pdb_dpm_callbacks dpm;
+    /* Pointer to port-specific DPM data */
+    void *dpm_data;
+    /* Policy Engine thread and related variables */
+    struct pdb_pe pe;
+    /* Protocol layer threads and related variables */
+    struct pdb_prl prl;
+    /* INT_N pin thread and related variables */
+    struct pdb_int_n int_n;
+};
+
 
 /*
  * Initialize the PD Buddy firmware library, starting all its threads
  */
-void pdb_init(void);
+void pdb_init(struct pdb_config *);
 
 
 #endif /* PDB_H */

lib/include/pdb_dpm.h

@@ -0,0 +1,84 @@
+/*
+ * PD Buddy - USB Power Delivery for everyone
+ * Copyright (C) 2017 Clayton G. Hobbs <clay@lakeserv.net>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef PDB_DPM_H
+#define PDB_DPM_H
+
+#include <stdbool.h>
+
+/* TODO: improve these includes */
+#include "fusb302b.h"
+#include "messages.h"
+
+
+/* Forward declaration of struct pdb_config */
+struct pdb_config;
+
+/* DPM callback typedefs */
+typedef void (*pdb_dpm_func)(struct pdb_config *);
+typedef bool (*pdb_dpm_eval_cap_func)(struct pdb_config *,
+        const union pd_msg *, union pd_msg *);
+typedef void (*pdb_dpm_get_sink_cap_func)(struct pdb_config *, union pd_msg *);
+typedef void (*pdb_dpm_tcc_func)(struct pdb_config *, enum fusb_typec_current);
+
+/*
+ * PD Buddy firmware library device policy manager callback structure
+ *
+ * Optional functions may be set to NULL if the associated functionality is not
+ * required.
+ */
+struct pdb_dpm_callbacks {
+    pdb_dpm_eval_cap_func evaluate_capability;
+    pdb_dpm_get_sink_cap_func get_sink_capability;
+    pdb_dpm_func giveback_enabled;
+    pdb_dpm_tcc_func evaluate_typec_current; /* Optional */
+    pdb_dpm_func pd_start; /* Optional */
+    /* dpm_sink_standby is called in PE_SNK_Select_Capability to ensure power
+     * consumption is less than 2.5 W.
+     *   - dpm_transition_standby()
+     */
+    /* dpm_output_set is called in five places:
+     *   - PS_RDY received → transition sink power supply to our request
+     *     - This could mean what we wanted, or what we had to settle for, so
+     *       we have to remember.
+     *     - dpm_transition_requested()
+     *   - Protocol error in PE_SNK_Transition_Sink
+     *     - Unnecessary?  If we really want to be defensive here, just go to
+     *       default output, right?  That's what we'll do shortly afterwards
+     *       anyway.
+     *     - dpm_transition_default()
+     *   - GotoMin received and giveback → transition sink to min power
+     *     - dpm_transition_min()
+     *   - Transition sink power supply to match Type-C Current advertisement
+     *     - dpm_transition_typec() (if I don't like it I can change it)
+     *   - Part of dpm_output_default
+     *     - Obsolete (see below)
+     */
+    /* dpm_output_default is only called in PE_SNK_Transition_to_Default.
+     * Should probably be part of new improved replacement for dpm_output_set.
+     *   - dpm_transition_default()
+     */
+    pdb_dpm_func transition_default;
+    pdb_dpm_func transition_min; /* Optional if no GiveBack */
+    pdb_dpm_func transition_standby;
+    pdb_dpm_func transition_requested;
+    pdb_dpm_func transition_typec; /* Optional */
+};
+
+
+#endif /* PDB_DPM_H */

lib/include/pdb_fusb.h

@@ -0,0 +1,36 @@
+/*
+ * PD Buddy - USB Power Delivery for everyone
+ * Copyright (C) 2017 Clayton G. Hobbs <clay@lakeserv.net>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef PDB_FUSB_H
+#define PDB_FUSB_H
+
+#include <hal.h>
+
+
+/*
+ * Configuration for the FUSB302B chip
+ */
+struct pdb_fusb_config {
+    /* The I2C bus that the chip is connected to */
+    I2CDriver *i2cp;
+    /* The I2C address of the chip */
+    i2caddr_t addr;
+};
+
+
+#endif /* PDB_FUSB_H */

lib/include/pdb_int_n.h

@@ -0,0 +1,31 @@
+/*
+ * PD Buddy - USB Power Delivery for everyone
+ * Copyright (C) 2017 Clayton G. Hobbs <clay@lakeserv.net>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef PDB_INT_N_H
+#define PDB_INT_N_H
+
+#include <ch.h>
+
+
+struct pdb_int_n {
+    THD_WORKING_AREA(_wa, 128);
+    thread_t *thread;
+};
+
+
+#endif /* PDB_INT_N_H */

lib/include/pdb_pe.h

@@ -0,0 +1,44 @@
+/*
+ * PD Buddy - USB Power Delivery for everyone
+ * Copyright (C) 2017 Clayton G. Hobbs <clay@lakeserv.net>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef PDB_PE_H
+#define PDB_PE_H
+
+#include <stdbool.h>
+#include <stdint.h>
+
+#include <ch.h>
+
+
+struct pdb_pe {
+    THD_WORKING_AREA(_wa, 128);
+    thread_t *thread;
+
+    mailbox_t mailbox;
+
+    union pd_msg *_policy_engine_message;
+    union pd_msg *_last_dpm_request;
+    bool _capability_match;
+    bool _explicit_contract;
+    bool _min_power;
+    int8_t _hard_reset_counter;
+    msg_t _mailbox_queue[PDB_MSG_POOL_SIZE];
+};
+
+
+#endif /* PDB_PE_H */

lib/include/pdb_prl.h

@@ -0,0 +1,45 @@
+/*
+ * PD Buddy - USB Power Delivery for everyone
+ * Copyright (C) 2017 Clayton G. Hobbs <clay@lakeserv.net>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef PDB_PRL_H
+#define PDB_PRL_H
+
+#include <stdint.h>
+
+#include <ch.h>
+
+
+struct pdb_prl {
+    THD_WORKING_AREA(_rx_wa, 128);
+    thread_t *rx_thread;
+    THD_WORKING_AREA(_tx_wa, 128);
+    thread_t *tx_thread;
+    THD_WORKING_AREA(_hardrst_wa, 128);
+    thread_t *hardrst_thread;
+
+    mailbox_t tx_mailbox;
+
+    int8_t _rx_messageid;
+    union pd_msg *_rx_message;
+
+    int8_t _tx_messageidcounter;
+    msg_t _tx_mailbox_queue[PDB_MSG_POOL_SIZE];
+};
+
+
+#endif /* PDB_PRL_H */

lib/src/pdb.c

@@ -25,19 +25,19 @@
 #include "fusb302b.h"
 
 
-void pdb_init(void)
+void pdb_init(struct pdb_config *cfg)
 {
     /* Initialize the FUSB302B */
-    fusb_setup();
+    fusb_setup(cfg);
 
     /* Create the policy engine thread. */
-    pdb_pe_run();
+    pdb_pe_run(cfg);
 
     /* Create the protocol layer threads. */
-    pdb_prlrx_run();
-    pdb_prltx_run();
-    pdb_hardrst_run();
+    pdb_prlrx_run(cfg);
+    pdb_prltx_run(cfg);
+    pdb_hardrst_run(cfg);
 
     /* Create the INT_N thread. */
-    pdb_int_n_run();
+    pdb_int_n_run(cfg);
 }