LinkIt ONE tutorial #2- Communication and cloud service

1. LinkIt ONE 物聯網研習營
相關文章請點我

2. Wifi 範例：取得網站字元
• ExamplesLWifiWifiWebClient

3. 重點說明：網路設定
• #define WIFI_AP “無線網路名稱” (名稱不要有空格)
• #define WIFI_PASSWORD “無線網路密碼"
• #define WIFI_AUTH LWIFI_WPA
// 請依照實際狀況修改為 LWIFI_OPEN, LWIFI_WPA, or LWIFI_WEP
• #define SITE_URL www.appinventor.tw
• //要讀取的網站內容

4. 重點說明：宣告與連線
• LWiFiClient c;
• while (0 == LWiFi.connect(WIFI_AP,
LWiFiLoginInfo(WIFI_AUTH, WIFI_PASSWORD)))
• {
• delay(1000);
• }

5. 重點說明：爬字元
• while (c)
• {
• int v = c.read();
• if (v != -1)
• {
• Serial.print((char)v); //一個個字元印出來
• }
• else
• { …

6. 執行結果

7. 來取得Facebook 粉絲頁按讚數
• 請上網下載：WifiWebClient_FBGraph.ino
• c.println("GET /caveeducation HTTP/1.1");
– 粉絲專頁名稱

8. Facebook 的 JSON 格式
• https://graph.facebook.com/CAVEEducation

9. 執行結果
• 再取出喜歡的欄位即可

10. GPRS範例：
• ExamplesLWifiWifiWebClient
• 架構相同，但引用的函式不同：LGPRS
• 當然不需要 Wifi 帳密

11. GPRS範例：簡訊控制LED
• 請上網下載：SMS_LED.ino

12. MediaTek Cloud Sandbox (MCS)

13. MCS主要功能
• 雲端平台，執行程式
• 例：Google App Engine、Amazon Web
Services、Microsoft Azure
• 提供網頁介面，讓你「點按滑鼠」就能建
立雲端程式
• 提供API程式存取介面
• 提供網頁介面，觀看與控制各種資料

14. MCS其他功能
• 通知（Notification），當某資料符合特定條
件時，寄送電子郵件
• 使用者權限（User Privilege），設定開發成
員的存取修改權限
• FOTA（Firmware Over The Air），版本控管，
韌體經由無線傳輸自動更新

15. 目標
• 到MCS註冊帳號
• 建立網頁應用程式（web application）
• 透過MCS REST API進行溝通
• LinkIt ONE板子、手機、瀏覽器

16. 範例
• 從雲端控制板子內建的LED
• LED：想像成家裡的燈
• 為什麼從雲端？不能直接連線嗎？

18. MCS重要觀念
• 原型(Prototype)，產品的原型
• 資料頻道(Data Channel)，帶有時間資訊的
資料串，具有Data Channel Id、Datapoint
• Test Device，產品的不同版本，具有
DeviceId、DeviceKey讓程式得以指定
• 例：LED控制器、溫濕度感測站

20. MCS Android app

21. MCS Dashboard（儀表板）

22. 重要索引
• Development：
建立Prototype、新增修改Data channel、查詢Data channel
Id
• My Devices：
查詢DeviceId、DeviceKey
• Resources：
教學文件、參考資料
• <帳號>：
代表已登入

23. 範例：控制LED並檢視狀態
程式：mcsled.js / mcsled.py

24. 流程
1. 建立Prototype
2. 依照所需功能，新增Data channel，記下
Data channel Id
3. 建立Test device，記下DeviceId與DeviceKey

25. 建立Prototype
• Prototype name：LED Manager
可自己挑個名字
• Prototype version：1.0
• Hardware platform：LinkIt ONE (MT2502)
• Industry：Personal Services
• Application：Other (Personal Services)

27. Data channel
• 顯示器Controller：可從MCS控制開發板
• 顯示器Display：讓開發板能回傳資料到MCS

28. 新增Data channel (1/2)
• 請新增一個Controller
• Data channel name：LED CONTROL
• Data channel Id：LED_Control
重要！將用於程式碼內
• Data type：ON/OFF

30. 建立Test device
• Device name：LED Manager
可自己挑個名字

31. 到My Devices
• 找出DeviceId與
DeviceKey

32. 您應該得到
• DeviceId
例：「D0pxIEKU」
• DeviceKey
例：「Pw0Cl0i0f6oN1Zk1」
• 兩個Data channel Id
例：「LED_CONTROL」與「LED」
• 然後修改程式碼裡的設定

33. MCS 新增channel 完成
設定 nodejs 環境

34. 程式 mcsled.js修改處
var myApp = mcs.register({
deviceId: 'ABC123',
deviceKey: 'XYZ123',
});
以上紅字換成您 test device的資訊

35. 程式 mcsled.py修改處
DEVICE_INFO = {
'device_id' : 'YOUR_DEVICE_ID',
'device_key' : 'YOUR_DEVICE_KEY'
}
以上紅字換成您 test device的資訊

36. 抓取Datapoint的HTTP請求
• 動作：GET
• 網址：
/mcs/v2/devices/:deviceId/datachannels/:dat
achannelId/datapoints
• 標頭：
Content-Type:application/json
deviceKey:DeviceKey

37. 抓取Datapoint的HTTP回應內容
{
"apiVersion":"0.0.1",
"code":200,
"message":"Request has succeeded",
"deviceId":"D0pxIEKU",
"dataChannels":[{
"dataChnId":"LED_CONTROL",
"isOverflow":false,
"dataPoints" :[{
"recordedAt":1430903644863,
"values":{"value":0}
}]
}]
}

38. 上傳Datapoint的HTTP請求
• 動作：POST
• 網址：/mcs/v2/devices/:deviceId/datapoints
• 標頭：
Content-Type:application/json
deviceKey:DeviceKey

39. 上傳Datapoint的HTTP請求內容
{
"datapoints":[{
"dataChnId":"LED",
"values":{
"value":0
}
}]
}

40. 上傳Datapoint的HTTP回應內容
{
"apiVersion":"0.0.1",
"code":200,
"message":"Request has succeeded",
"results":"Success."
}

41. 範例程式：lo_pwm_analog.ino
• 自行建立新Prototype
• 兩個Data channel：一個Controller型的PWM、一
個Display型的Integer
• 電路圖跟「以可變電阻控制LED亮度」相同

42. 程式lo_pwm_analog.ino
• b：開啟WiFi模組，e：關閉WiFi模組
• c：與WiFi AP連線，d：切斷
• m：建立與MCS之間的永久連線
• 從MCS送出PWM的值，控制LED的亮度
• 若有永久連線，板子就會讀取可變電阻的
值，上傳到MCS
• 注意：記得修改程式碼裡相關設定值

43. MediaTek Cloud Sandbox
請用先前下載 SDK 的帳號登入

44. DeviceID/ Key DeviceID/ Key

45. 流程
1. 建立 prototype
2. 根據所需要的來新增對應的 Data channel
(Controller / Display)
3. 建立 test device (DeviceId / DeviceKey)

46. GPS
(Global Positioning System)
全球定位系統

47. GPS天線

48. GPGGA全球定位系統資料
• $GPGGA,170834.254,4124.8963,N,08151.683
8,W,1,05,1.5,280.2,M,-34.0,M,0.0,0000*74
• 170834.254：時間，17:08:34.254
• 4124.8963：41度24.8963分
• N：北緯
• 08151.6838：81度51.6838分
• W：西經

49. GPGGA全球定位系統資料
• 1：定位有效程度，0是無效、1是GPS fix
• 05：衛星數量
• 1.5：水平精確度
• 280.2,M：離海平面的高度，單位公尺
• -34.0,M：大地水準面離WGS84的高度，單位公尺
• 0.0：距離上次DGPS更新的時間，單位秒
• 0000：DGPS站台識別號碼
• *74，校驗碼

50. 顯示GPS於MCS

51. 建立新Data Channel：
GPS x1, float x 2