4 files changed, 131 insertions, 0 deletions
diff --git a/shared/pb/bus.h b/shared/pb/bus.h
new file mode 100644
index 0000000..6f464c3
--- /dev/null
+++ b/shared/pb/bus.h
@@ -0,0 +1,18 @@
+#pragma once
+
+// Adafruit NeoTrellis modules
+#define BUSADDR_ADA_NEO_1 0x2E
+#define BUSADDR_ADA_NEO_2 0x2F
+#define BUSADDR_ADA_NEO_3 0x30
+#define BUSADDR_ADA_NEO_4 0x32
+
+// TODO: ???
+#define BUSADDR_MOD_NEOTRELLIS 0
+#define BUSADDR_MOD_SOFTWARE 0
+#define BUSADDR_MOD_HARDWARE 0
+#define BUSADDR_MOD_VAULT 0
+// #define BUSADDR_MOD_AUTOMATION 0
+
+// main controller
+#define BUSADDR_MAIN 0x00
+
diff --git a/shared/pb/driver.c b/shared/pb/driver.c
new file mode 100644
index 0000000..6b675ca
--- /dev/null
+++ b/shared/pb/driver.c
@@ -0,0 +1,31 @@
+#include "types.h"
+#include "driver.h"
+
+__weak bool pbdrv_hook_cmd() {
+	return false;
+}
+
+__weak void pbdrv_i2c_recv(uint16_t addr, const char * buf, size_t sz) {
+	if (sz == 0) return;
+	pb_cmd_t cmd = (enum pb_cmd) buf[0];
+
+	// shift buffer pointer to only contain the puzzle bus message buf
+	buf++;
+	sz--;
+
+	// allow user to override command handler while still using this weak
+	// function
+	if (pbdrv_hook_cmd(cmd, buf, sz)) return;
+
+	switch (cmd) {
+		case PB_CMD_READ: return pbdrv_handle_read(buf, sz);
+		// case PB_CMD_WRITE: return pbdrv_handle_write(buf, sz);
+		// case PB_CMD_MAGIC: return pbdrv_handle_magic(buf, sz);
+		default: return;
+	}
+}
+
+__weak void pbdrv_i2c_send(uint16_t addr, const char * buf, size_t sz) {
+	return;
+}
+
diff --git a/shared/pb/driver.h b/shared/pb/driver.h
new file mode 100644
index 0000000..b5b2784
--- /dev/null
+++ b/shared/pb/driver.h
@@ -0,0 +1,24 @@
+#pragma once
+
+#include <stdint.h>
+#include <stddef.h>
+#include <stdbool.h>
+
+#include "types.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+void pbdrv_i2c_recv(uint16_t addr, const char * buf, size_t sz);
+void pbdrv_i2c_send(uint16_t addr, const char * buf, size_t sz);
+
+void pbdrv_hook_state(pb_state_t * state, bool rw);
+bool pbdrv_hook_cmd(pb_cmd_t cmd, const char * buf, size_t sz);
+
+void pbdrv_handle_read(const char * buf, size_t sz);
+
+#ifdef __cplusplus
+}
+#endif
+
diff --git a/shared/pb/types.h b/shared/pb/types.h
new file mode 100644
index 0000000..93e2f0c
--- /dev/null
+++ b/shared/pb/types.h
@@ -0,0 +1,58 @@
+#pragma once
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#ifdef __GNUC__
+#define __packed __attribute__((packed))
+#define __weak __attribute__((weak))
+#endif
+#ifndef __packed
+#error Could not determine packed attribute for current compiler
+#define __packed
+#endif
+#ifndef __weak
+#error Could not determine weak attribute for current compiler
+#define __weak
+#endif
+
+/**
+ * \brief puzzle bus command types
+ *
+ * The first byte of a puzzle bus message's data indicates the command type.
+ */
+enum __packed pb_cmd {
+	PB_CMD_READ, //!< read a puzzle module property
+	PB_CMD_WRITE, //!< write to a puzzle module property
+	// PB_CMD_UPDATE, //!< request an update
+	PB_CMD_MAGIC = 0x69, //!< magic message
+};
+typedef enum pb_cmd pb_cmd_t;
+
+static const char pb_magic_msg[] = { 0x70, 0x75, 0x7a, 0x62, 0x75, 0x73 };
+static const char pb_magic_res[] = { 0x67, 0x61, 0x6d, 0x69, 0x6e, 0x67 };
+
+/** \brief Puzzle bus global states */
+enum __packed pb_state {
+	PB_GS_NOINIT,  //!< uninitialized (only used by puzzle modules)
+	PB_GS_IDLE,    //!< puzzle not started yet
+	PB_GS_PLAYING, //!< puzzle actively being solved
+	PB_GS_SOLVED,  //!< puzzle completed
+};
+typedef enum pb_state pb_state_t;
+
+typedef struct __packed {
+	uint8_t address;
+} pb_cmd_read_t;
+
+typedef struct __packed {
+	uint8_t address;
+	uint8_t data[];
+} pb_cmd_write_t;
+
+#ifdef __cplusplus
+}
+#endif
+