kSerial Protocol

封包開頭由 2-byte 起始字元“KS”開始，1-byte‘\r’結尾，封包內容包含封包型態(TP)、封包參數(PX)、封包校驗碼(CK)、資料(DN)以及資料長度(LN)，封包的總長度不定，隨資料長度變化。

封包型態(TP)
由 4-bit 組成，分別為無號數、有號數、浮點數和保留指令四種，用來敘述封包的資料型態或是封包的功能、作用。
資料長度(LN)
由 12-bit 組成，敘述封包夾帶的資料長度，資料長度(LN)為零表示封包沒有夾帶資料，資料長度(LN)最大為 4095，這意味著封包的最大最小長度分別為 8-byte 以及 4103-byte。
封包參數(P1, P2)
由 2-byte 組成，保留給使用的的資料功能，用以增加封包應用的靈活性。
封包校驗碼(CK)
1-byte的校驗碼是用來確認封包資訊的正確性，CK=(TP*16+LN+P1+P2)%256
資料(DN)
封包的夾帶資料，長度與型態分別由 LN 和 TP 決定，其資料(DN)可以不隨封包傳送。

kSerial Packet Example

最小長度的封包格式

傳送 1 個 2 bytes 有號數 -22808(A6E8h) 的資料

傳送 3 個 2 bytes 有號數 -208, 73, -22808 (FF30h, 0049h, A6E8h)的資料

kSerial Packet R0 Command

R0 Command 是針對裝置(Target) 所提供的指令，主要用來設定裝置的系統參數

KSCMD_R0_DEVICE_BAUDRATE

設定裝置的傳輸鮑率指令，type=R0(8h), P1=KSCMD_R0_DEVICE_BAUDRATE(D1h), P2=04h, DN=BaudRate(32-bit)，指令可以用來設定裝置的 UART 通訊鮑率，單位為 bps，裝置收到指令後會關掉 UART，並重新設定鮑率再啟動，設定完成後不會回傳訊息做應答

KSCMD_R0_DEVICE_RATE

設定裝置的更新頻率指令，type=R0(8h), P1=KSCMD_R0_DEVICE_RATE(D2h), P2=04h, DN=UpdateRate(32-bit)，指令可以用來設定裝置的更新頻率，單位為 Hz，設定完成後不會回傳訊息做應答

KSCMD_R0_DEVICE_MDOE

設定裝置的運行模式指令，type=R0(8h), P1=KSCMD_R0_DEVICE_MDOE(D3h), P2=mode，指令可以用來設定裝置運行模式，MODE 0 預設為不執行任何程序，模式可依需求自行定義新增，設定完成後不會回傳訊息做應答

KSCMD_R0_DEVICE_ID

獲取裝置的 16-Bit ID 指令，type=R0(8h), P1=KSCMD_R0_DEVICE_ID(D0h), P2=00h，指令可以用來確認裝置是否有在線上，若裝置有收到指令則會回傳 16-bit ID

Host 發送指令 … Device Check

Target 回傳 … Device ID

KSCMD_R0_DEVICE_GET

獲取裝置的資訊指令，type=R0(8h), P1=KSCMD_R0_DEVICE_GET(E3h), P2=KSCMD_R0_XXX 所定義的項目，指令可以用來獲取裝置上的設定，像是目前實現的鮑率、更新頻率、模式以及 ID，獲取的資訊都以 32-bit 來儲存，獲取 ID 則會回傳 32-bit ID

Host 發送指令 … Get Device Info