描述

描述

OSCUP是一種開源 UART 協議，專為與 ESP32 ARM 處理器配合使用而設計。詳細記錄的代碼有助于弄清楚如何在 UART 端口上實現自定義協議。使用此協議，您可以傳輸和接收由固定前導碼跟蹤的數據。它為每個發送的數據包實現 ACK 和 NACK，以管理錯誤或丟失的數據包。

怎么運行的

它依賴于 Espressiff 提供的原始庫，例如 /device/uart.h 用于連接低級硬件和功能。該協議提供兩個功能write，read用于發送和接收數據。當您創建一個新的 Oscup 對象時，您需要向它傳遞一個 ID，該 ID 用于跟蹤發送數據包的設備。可選地，Oscup 對象可以被實例化，指定 UART 端口和相關的 UART TX 引腳和 UART RX 引腳。默認情況下，通信發生在 UART 0，或者更確切地說是 USB 端口。

事實上，可以使用 OSCUP 進行計算機和 ESP32 之間或兩個 ESP32 之間的通信。

命令

每次協議在 UART 上寫入數據時，它都會在數據包中插入一條命令。該命令是強制性的，否則您可能會問自己為什么要使用協議（只需使用 arduino Serial）。顯然，在接收方，您必須區分接收到的命令。有可用的 4 個主要命令：

• SHARE：此命令表示發送方只想與接收方共享此數據（出于次要原因）。如果您只想在其他設備上打印數據，則可以使用它。
• CONFIRM：此命令表示將發送的數據是操作的結果（例如，我們按下設備 1 上的按鈕，我們將數據發送到設備 2，我們希望設備 2 不僅打印此數據，而且存儲它們).
• ACK: 用于告訴發送方，接收方已經收到數據包
• NACK: 用于告訴發送方，接收方還沒有收到數據包；發件人將嘗試再次發送 顯然，您可以配置您喜歡執行每個命令的操作。我們建議不要使用 ACK 和 NACK，至于其他兩個，前面的指示只是我們為使用這兩個命令定義的指南。另外，你可以在arduino上配置新命令（command = uint8_t），直接在write函數中發送

公共職能

• begin: 初始化 UART 參數并將其轉發給控制硬件。必須在 void setup() 中調用它。它以波特率作為唯一的輸入參數，它將決定通信波特率。
• write：寫函數接受一個命令“用戶定義”，有效負載的長度和有效負載，其長度固定為 40 字節。此函數將此數據寫入 UART 并返回錯誤代碼。
• read：它讀取傳入的數據并將它們插入 packet_t 結構中，該結構在 .h 文件中定義。如果一切正常，它返回讀取緩沖區的長度，否則返回負錯誤。
• get_timer: 返回定時器的計數器
• get_APB_clk: 返回 APB 的頻率。通常 APB 用于設置嵌入式處理器上的外設頻率。

貢獻

我們是 Daniel 和 Riccardo，都是大學的 AI 學生。我們開發了這個協議來從 ESP32 獲取數據來做 AI 的事情（在我們的 Git Repo 上查看 FiremanSam）。

?

?