LASS - 如何加入新感測器

LASS 歡迎大家加入各式各樣的感測器。

首先只要您做好基本的驗證，支援新的感測器是不需要申請的。

當Sensor 被支援後，有需要使用的 Application, 就方便直接來引用

確認

在開始前請先確認這個感測器在系統還沒有被支援

• 在 LASS.ino 檔案表頭有一個 sensor 的列表，確認並沒有被支援過，當新的感測器支援，記得更新這個表。

• 以及 感測器驗證列表

驗證

以下是加入感測器建議的步驟

步驟一：提供驗證感測器的範例程式碼

• 用之前總是要先驗證硬體工作是否正常，另外當有問題的時候，我們也可以使用這份簡單的範例程式來確認是否硬體工作正常。
• 請依照例子，上傳每個感測器的驗證碼

步驟二：上傳 github

• 由於不確認大家寫的 code 是否足夠品質，初期請使用 pull request 的方式，上傳提供給 developer team 檢查，確認後就會 commit. 當確認會有長期貢獻者，會開立 github account

建立新的 APP_ID

如果這個感測器本身就有一個獨立使用情境，使用者會想要只用這個感測器就去感測，可以執行以下步驟，本步驟可省略

步驟一：為這個單一感測器驗證取一個公開的 APP ID

• 在 configuration.h 中，取一個 APPTYPE_PUBLIC+x 的新 APPID
• 我們希望每一個感測器有單一的 APP ID, 方便獨立測試與驗證

步驟二：按照以下的規範寫 code 驗證

• 在 LASS.ino 中，尋找所有 SENSOR CUSTOMIZATION 的部分，做對應的更改
• 舉例：
  • define 更新：
    • APP_NAME: 
    • Include 所需要的 header
    • 宣告需要的變數
  • sensor_setup()
    • 針對所需要的 PIN, 或是 serial 初始化
  • get_sensor_data_xxx
    • 給新的 sensor 取值的 function
  • init_sensor_data()
    • 設定新的 sensor 輸出的資料代號
  • get_sensor_data
    • 在抓 sensor data 的主 function 中加入這個 sensor
  • BLYNK_READ
    • 設定手機介面需要的虛擬 sensor

步驟三：上傳 github

• 由於不確認大家寫的 code 是否足夠品質，初期請使用 pull request 的方式，上傳提供給 developer team 檢查，確認後就會 commit. 當確認會有長期貢獻者，會開立 github account
•