Initial public release.

2020TPCApp1.cydsn/COMM/BLE/COMM_BLE.h

@@ -0,0 +1,79 @@
+/** \dir "BLE"
+ *
+ *  \brief This directory contains source code for managing Bluetooth Low Energy communications.
+ *
+ */
+
+/** \file
+ *  \brief This file defines the interface to the Bluetooth Low Energy communications used by this software.
+ *
+ */
+
+#ifndef COMM_BLE_H
+#define COMM_BLE_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* Preprocessor and Type Definitions */
+
+// Define this to print out BLE trace statements to the console.
+//#define TRACE_BLE
+//#define VERBOSE_BLE_TRACE
+
+#define COMM_BLE_TASK_STACK_SIZE_in_bytes   4096
+
+typedef enum
+{
+    COMM_BLE_DEFAULT,
+    COMM_BLE_INITIALIZING,
+    COMM_BLE_IDLE,
+    COMM_BLE_SCANNING_FOR_KTAG_PACKETS,
+    COMM_BLE_ADVERTISING_AS_PERIPHERAL,
+    COMM_BLE_ADVERTISING_AS_BROADCASTER,
+    COMM_BLE_SCANNING_AND_ADVERTISING
+} COMM_BLE_StateID_T;
+
+typedef enum
+{
+    COMM_BLE_COMMAND_NO_OP,
+    COMM_BLE_REQUEST_STATE_CHANGE,   
+    COMM_BLE_PROCESS_BLE_EVENTS,
+    COMM_BLE_SCAN_FOR_KTAG_PACKETS,
+    COMM_BLE_ADVERTISE_AS_BROADCASTER,
+    COMM_BLE_ADVERTISE_AS_PERIPHERAL,
+    COMM_BLE_STOP_ADVERTISING,
+    COMM_BLE_SCAN_AND_ADVERTISE,
+    // COMM_BLE_COMMAND_IS_OUT_OF_RANGE is one more than the last valid command.
+    COMM_BLE_COMMAND_IS_OUT_OF_RANGE
+} COMM_BLE_Command_ID_T;
+
+typedef struct
+{
+    COMM_BLE_Command_ID_T ID;
+    void * Data;
+} COMM_BLE_Command_T;
+
+/* Include Files */
+
+/* Public Variables */
+
+extern cy_stc_ble_conn_handle_t appConnHandle[CY_BLE_CONN_COUNT];
+extern volatile uint8_t COMM_BLE_IASAlertLevel;
+
+extern QueueHandle_t COMM_BLE_CommandQueue;
+
+//! Handle of the COMM_BLE_Task() given when the task was created.
+extern TaskHandle_t COMM_BLE_Task_Handle;
+
+/* Public Functions */
+void COMM_BLE_Init(void);
+void COMM_BLE_Task(void * pvParameters);
+void COMM_BLE_RequestState(COMM_BLE_StateID_T state);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // COMM_BLE_H