Demo App (SDK 的安裝與 compile)

Jethro E. Lee edited this page Aug 16, 2018 · 14 revisions

Demo App

此 SDK 內附一支 Demo App,用來展示各項 API 使用方法。含 source code :grin: 方便您上手。:+1:

安裝

  1. 本 project 的 release 區 下載對應版本的 libGoFIT_SDK.a,置入子目錄 GoFIT_SDK_Demo/GoFIT_SDK 下 (i.e., 與 GoFIT_SDK.h 位於同一層目錄內),並請記得將之新增到 Xcode 專案中。

  2. 請將您收到的授權檔案 (.crt) 改名為 client_cert.crt,置入子目錄 GoFIT_SDK_Demo/GoFIT_SDK/EmbededFiles

    • 同時,如果您有收到 firmware 的 OTA 更新 image (*.hex 檔案,與伴隨的 binary_list.json 檔案),則也請連同一起放置於該目錄下),並請記得將之新增到 Xcode 專案中。
  3. 確認 Linked Frameworks and Libraries 有加入 libGoFIT_SDK.alibz.tbdlibxml2.tbd

    • 確認 Linked Frameworks and Libraries 有加入 libGoFIT_SDK.a、libz.tbd、libxml2.tbd
  4. 然後就可以 build Demo App 囉!!! Good Luck!!! :+1:

Demo App

  • 此 SDK 內附一支 Demo App,用來展示上述所列各項 API 使用方法,App 頁面方為三大區塊:
    • 此 SDK 內附一支 Demo App,用來展示上述所列各項 API 使用方法。
    • SDK
      • 用來 initialize SDK,開啟 app 後須先執行此功能
    • BLE FUNCTION
      • 分為以下功能

        1. Scan Device
          • 會有 spinner 出現,約 10 秒後回傳掃描結果
        2. New Pairing
          • 新配對 Scan Device 中 RSSI 最強的裝置,不帶有配對碼的連線方式
        3. Connect Device
          • 適合已配對完成之裝置,若有可連線裝置,欄位旁邊會顯示四位數配對碼
        4. Device Setting
          • 請依欲設定項目號碼操作
          • 每一項目皆有提示設定格式輸入方式
          • 完成輸入格式後,輸入 999 開始設定裝置
        5. Get Fitness Data
          • 會有 progress value 顯示,為一累計值
          • SDK 會過濾無效資料,累計值不一定相等於最後回傳個數
        6. Clear Data
          • 執行 Get Fitness Data 後,再執行此 function 可清除已同步資料
        7. Device Data Initialization
          • 清除裝置螢幕上之步數資料
        8. Device Firmware Update
          • 執行韌體升級,會有 progress value,以百分比表示
        9. Device Disconnect
          • 將當前連線裝置斷線,以便下一個裝置連線
      • 因本 SDK 非 reentrant,非 multi-threaded 使用,所以建議的 API 操作流程為 :

        • 資料同步
          • 新配對裝置 : (1) -> (2) -> (5) -> (6) -> (9)
          • 已配對過裝置 : (3) -> (5) -> (6) -> (9)
        • 裝置設定
          • 新配對裝置 : (1) -> (2) -> (4) -> (9)
          • 已配對過裝置 : (3) -> (4) -> (9)
        • 韌體升級
          • 新配對裝置 : (1) -> (2) -> (8)
          • 已配對過裝置 : (3) -> (8)
        • 在已連線狀態下,(4)、(5)、(6)、(7)、(8) 皆是可重複執行之 API
      • DEVICE STATUS

        • 用來顯示當前連線裝置之訊息
          1. UUID
            • 顯示目前掃描到 RSSI 最強之裝置
            • 也是 Connect Device 的目標
          2. Connect Status
            • 顯示已連線或未連線
          3. Battery
            • 顯示電量
          4. MAC Address
            • 顯示 MAC Address
          5. SN
            • 顯示裝置序號
          6. FW Version
            • 顯示韌體版本
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.