Initial commit: CCU621_M firmware project with BLE debug link support.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-08 17:28:36 +08:00
commit 9ceb218f80
1597 changed files with 724159 additions and 0 deletions
@@ -0,0 +1,95 @@
+/**
+ * @file debug_link.h
+ * @brief 调试链路层：TCP Socket 后端 + comm_link 适配 + 会话上下文（阶段1合并）
+ *
+ * 合并自：comm_link.h、comm_link_ctx.h、tcp/tcp_link_priv.h、tcp_server_socket 对外 API
+ */
+
+#ifndef DEBUG_LINK_H
+#define DEBUG_LINK_H
+
+#include <stdint.h>
+#include "publicdata/public_define.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* ---------- comm_link 类型与 API ---------- */
+
+typedef enum {
+    COMM_LINK_TCP = 0,
+#if BLE_DEBUG_EN
+    COMM_LINK_BLE = 1,
+#endif
+} comm_link_type_t;
+
+#if BLE_DEBUG_EN
+#define COMM_LINK_IS_BLE(t)  ((t) == COMM_LINK_BLE)
+#else
+#define COMM_LINK_IS_BLE(t)  (0)
+#endif
+
+void comm_link_set_type(comm_link_type_t type);
+comm_link_type_t comm_link_get_type(void);
+comm_link_type_t comm_link_type_from_dip(void);
+
+int comm_link_start(void);
+void comm_link_stop(void);
+void comm_link_process(void);
+
+int comm_link_accept_client(void);
+int comm_link_is_client_connected(void);
+void comm_link_close_client(void);
+
+int comm_link_receive_data(uint8_t *buffer, uint32_t buffer_size);
+int comm_link_send_data(const uint8_t *data, uint32_t len);
+int comm_link_get_peer_info(char *buf, uint32_t buf_size);
+
+/* ---------- comm_link_ctx（TCP/BLE backend union） ---------- */
+
+#define COMM_LINK_PEER_INFO_SIZE  48U
+
+typedef struct {
+    comm_link_type_t type;
+    uint8_t client_connected;
+    char peer_info[COMM_LINK_PEER_INFO_SIZE];
+} comm_link_session_t;
+
+#if BLE_DEBUG_EN
+#include "ble_link/fc41d_ble_priv.h"
+#endif
+
+#include "lwip/sockets.h"
+#include "FreeRTOS.h"
+#include "semphr.h"
+
+typedef struct {
+    int server_socket;
+    int client_socket;
+    struct sockaddr_in client_addr;
+    SemaphoreHandle_t mutex;
+} tcp_link_ctx_t;
+
+typedef union {
+#if BLE_DEBUG_EN
+    fc41d_ble_ctx_t ble;
+#endif
+    tcp_link_ctx_t tcp;
+} comm_link_backend_u;
+
+typedef struct {
+    comm_link_session_t session;
+    comm_link_backend_u backend;
+} comm_link_ctx_t;
+
+comm_link_ctx_t *comm_link_ctx_get(void);
+comm_link_session_t *comm_link_session(void);
+void comm_link_ctx_reset_session(void);
+void comm_link_ctx_reset_all(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* DEBUG_LINK_H */