使用 OpenThread 模擬 Thread 網路

1. 簡介

26b7f4f6b3ea0700.png

Google 發布的 OpenThreadThread 網路通訊協定的開放原始碼實作項目。Google Nest 已推出 OpenThread,讓開發人員能夠更廣泛地運用 Nest 產品所用的技術,加速為智慧聯網家庭開發產品。

Thread 規格定義了用於家用應用程式的 IPv6 穩定、安全和低功率無線裝置對通訊通訊協定。OpenThread 實作所有 Thread 網路層,包括 IPv6、6LoWPAN、IEEE 802.15.4 以及 MAC 安全性、網格連結建立和網格轉送。

本程式碼研究室將引導您在模擬裝置上模擬 Thread 網路。

課程內容

  • 如何設定 OpenThread 建構工具鍊
  • 如何模擬 Thread 網路
  • 如何驗證 Thread 節點
  • 如何使用 OpenThread Daemon 管理 Thread 網路

軟硬體需求

  • Git
  • Linux 網路轉送的基本知識

2. 設定建構系統

Git

必須使用 Git 才能完成這個程式碼研究室。請先下載並安裝應用程式,再繼續操作。

安裝完成後,請按照特定作業系統的操作說明下載及建構 OpenThread。

適用於 Mac OS X 的 XCode

需要安裝 XCode,才能在 Mac OS X 上安裝及建構 OpenThread。

安裝 XCode 後,請安裝 XCode 指令列工具:

$ xcode-select --install

在 Linux / Mac OS X 上進行建構

這些安裝操作說明已通過 Ubuntu Server 14.04 LTS 和 Mac OS X Sierra 10.12.6 的測試。

安裝 OpenThread。使用 bootstrap 指令可確保工具鍊已安裝完成且環境設定正確:

$ mkdir -p ~/src
$ cd ~/src
$ git clone --recursive https://github.com/openthread/openthread.git
$ cd openthread
$ ./script/bootstrap

使用 Windows

如果您偏好使用 Windows,建議您嘗試使用這個程式碼研究室的 Docker 版本。

3. 建構 OpenThread 應用程式

安裝完成後,建構範例 OpenThread 應用程式。在本程式碼研究室中,我們使用模擬範例。

$ cd ~/src/openthread
$ ./script/cmake-build simulation

現在建構 OpenThread Daemon:

$ ./script/cmake-build posix -DOT_DAEMON=ON

4. 模擬 Thread 網路

您要用於這個程式碼研究室的應用程式範例將能示範基本的 OpenThread 應用程式,該應用程式可透過基本指令列介面 (CLI) 開啟 OpenThread 設定和管理介面。

這項練習能引導你從一部模擬的 Thread 裝置進行連線偵測 (ping) 裝置,只需完成幾個簡單步驟即可。

下圖說明基本的 Thread 網路拓撲。在本練習中,我們會模擬綠色圓圈中的兩個節點:Thread Manager 和 Thread 路由器,其中每個節點之間只能有一個連線。

6e3aa07675f902dc.png

對節點進行連線偵測 (ping)

1. 啟動節點 1

前往 openthread 目錄,並使用 ot-cli-ftd 二進位檔產生模擬執行緒的 CLI 程序。

$ cd ~/src/openthread
$ ./build/simulation/examples/apps/cli/ot-cli-ftd 1

注意:執行這個指令之後,如果系統未顯示 > 提示,請按下 enter

這個二進位檔會實作以 POSIX 為基礎的 OpenThread 裝置。IEEE 802.15.4 無線電驅動程式以 UDP 為基礎建構 (IEEE 802.15.4 影格是在 UDP 酬載中傳送)。

1 的引數是檔案描述元,代表模擬裝置 IEEE EUI-64 的最小位元位元。當 IEEE 802.15.4 無線電模擬 (通訊埠 = 9000 + 檔案描述元) 繫結至 UDP 通訊埠時,也會使用這個值。這個程式碼研究室的每個模擬執行緒裝置都會使用不同的檔案描述元。

注意:產生模擬裝置程序時,請僅使用本程式碼研究室所述的 1 以上的檔案描述元。檔案 0 已保留供其他用途使用。

建立新的作業資料集,然後將其提交為使用中的資料集。作業資料集為您建立的 Thread 網路設定。

> dataset init new
Done
> dataset
Active Timestamp: 1
Channel: 20
Channel Mask: 07fff800
Ext PAN ID: d6263b6d857647da
Mesh Local Prefix: fd61:2344:9a52:ede0/64
Network Key: e4344ca17d1dca2a33f064992f31f786
Network Name: OpenThread-c169
PAN ID: 0xc169
PSKc: ebb4f2f8a68026fc55bcf3d7be3e6fe4
Security Policy: 0, onrcb
Done

將這個資料集提交為使用中的資料集:

> dataset commit active
Done

開啟 IPv6 介面:

> ifconfig up
Done

啟動 Thread 通訊協定作業:

> thread start
Done

等待幾秒鐘,並確認裝置已成為「執行緒領導者」。領導人負責管理路由器 ID 指派作業。

> state
leader
Done

查看指派給節點 1 Thread 介面的 IPv6 位址 (輸出內容會有所不同):

> ipaddr
fd61:2344:9a52:ede0:0:ff:fe00:fc00
fd61:2344:9a52:ede0:0:ff:fe00:5000
fd61:2344:9a52:ede0:d041:c5ba:a7bc:5ce6
fe80:0:0:0:94da:92ea:1353:4f3b
Done

請注意特定的 IPv6 位址類型:

  • 開頭為 fd = las-local
  • 開頭為 fe80 = link-local

網格的本機地址類型會進一步分類:

  • 包含 ff:fe00 = 路由器定位器 (RLOC)
  • 不包含 ff:fe00 = 端點 ID (EID)

請找出主控台輸出內容中的 EID,以便日後使用。在上方的範例中,EID 如下:

fd61:2344:9a52:ede0:d041:c5ba:a7bc:5ce6

2. 啟動節點 2

開啟新的終端機,然後前往 openthread 目錄,然後產生 CLI 程序。這是第二個模擬 Thread 裝置:

$ cd ~/src/openthread
$ ./build/simulation/examples/apps/cli/ot-cli-ftd 2

注意:執行這個指令之後,如果系統未顯示 > 提示,請按下 enter

使用與節點 1 的作業資料集相同的值來設定執行緒網路金鑰和永久帳號 ID:

> dataset networkkey e4344ca17d1dca2a33f064992f31f786
Done
> dataset panid 0xc169
Done

將這個資料集提交為使用中的資料集:

> dataset commit active
Done

開啟 IPv6 介面:

> ifconfig up
Done

啟動 Thread 通訊協定作業:

> thread start
Done

裝置會初始化為子項。Thread Child Child to the End Device (Thread 子項) 屬於 Thread 裝置,這類裝置只能透過父項裝置傳輸及接收單聲道流量。

> state
child
Done

2 分鐘內,您應該會看到狀態從 child 切換為 router。Thread 路由器能夠在 Thread 裝置之間轉送流量。也稱為「父項」。

> state
router
Done

驗證網路

如要檢查網格網路,最簡單的方法是查看路由器表格。

1. 檢查連線狀態

在節點 2 上取得 RLOC16。RLOC16 是裝置的 RLOC IPv6 位址末 16 位元。

> rloc16
5800
Done

在節點 1 上,查看路由器 2 的 RLOC16 路由器。確認節點 2 已切換至路由器狀態。

> router table
| ID | RLOC16 | Next Hop | Path Cost | LQI In | LQI Out | Age | Extended MAC  |
+----+--------+----------+----------+-------+---------+-----+------------------+
| 20 | 0x5000 |       63 |         0 |     0 |      0 |   0 | 96da92ea13534f3b |
| 22 | 0x5800 |       63 |         0 |     3 |      3 |  23 | 5a4eb647eb6bc66c |

資料表中有 0xa800 的節點 1 的 RLOC,確認已連線至網格。

2. 從節點 2 連線偵測 (ping) 1 節點

驗證兩個模擬 Thread 裝置之間的連線情形。在節點 2 中,ping 已指派給節點 1 的 EID:

> ping fd61:2344:9a52:ede0:d041:c5ba:a7bc:5ce6
> 16 bytes from fd61:2344:9a52:ede0:d041:c5ba:a7bc:5ce6: icmp_seq=1
hlim=64 time=12ms

按下 enter 即可返回 > CLI 提示。

測試網路

現在您可以成功在兩個模擬的 Thread 裝置之間進行連線偵測 (ping),只要將一個節點離線,即可測試網格網路。

返回節點 1 並停止執行緒:

> thread stop
Done

切換至節點 2 並查看狀態。節點會在兩個分鐘內偵測到節點 1 (節點 1) 處於離線狀態,因此節點 2 的轉換作業應該會是網路的 leader

> state
router
Done
...
> state
leader
Done

確認後,停止執行緒並恢復原廠設定節點 2,然後再離開。恢復原廠設定是為了確保這個練習中使用的 Thread 網路憑證不會轉移至下一個練習。

> thread stop
Done
> factoryreset
>
> exit

一併恢復原廠設定並結束節點 1:

> factoryreset
>
> exit

請參閱 OpenThread CLI 參考資料,探索所有可用的 CLI 指令。

5. 使用委託功能驗證節點

在先前的練習中,您將設定 Thread 網路,其中包含兩部模擬裝置並驗證連線。不過,這樣也不需要在裝置之間傳遞未經驗證的 IPv6 連結本機流量。如要在節點之間傳輸全域 IPv6 流量 (和透過 Thread 邊界路由器的網際網路),您必須驗證節點。

如要進行驗證,其中一部裝置必須擔任佣金。開發運作人員是目前針對 Thread 裝置選擇的驗證伺服器,以及提供裝置加入網路所需的網路憑證的授權者。

在本練習中,我們會使用與先前相同的兩個節點拓撲。如要進行驗證,Thread 領導者須擔任協調者 (Thread 路由器),

d6a67e8a0d0b5dcb.png

1. 建立網路

如果接續上一個練習,應該應該會開啟兩個終端機視窗。如果沒有,請確保兩個已開啟且可供使用。一個將會是節點 1,另一個則用節點 2。

在節點 1 中,產生 CLI 程序:

$ cd ~/src/openthread
$ ./build/simulation/examples/apps/cli/ot-cli-ftd 1

注意:執行這個指令之後,如果系統未顯示 > 提示,請按下 enter

建立新的作業資料集,並將其做為使用中的資料集,然後啟動 Thread:

> dataset init new
Done
> dataset
Active Timestamp: 1
Channel: 12
Channel Mask: 07fff800
Ext PAN ID: e68d05794bf13052
Mesh Local Prefix: fd7d:ddf7:877b:8756/64
Network Key: a77fe1d03b0e8028a4e13213de38080e
Network Name: OpenThread-8f37
PAN ID: 0x8f37
PSKc: f9debbc1532487984b17f92cd55b21fc
Security Policy: 0, onrcb
Done

將這個資料集提交為使用中的資料集:

> dataset commit active
Done

開啟 IPv6 介面:

> ifconfig up
Done

啟動 Thread 通訊協定作業:

> thread start
Done

等待數秒,並確認裝置已成為執行緒領導者:

> state
leader
Done

2. 開始執行委員會角色

在節點 1 上,啟動佣金委員會角色:

> commissioner start
Done

允許任何彙整者 (使用 * 萬用字元) 與 J01NME 彙整憑證建立關係至網路。加入人員是指由管理員管理員新增至佣金 (Thread 網路) 的裝置。

> commissioner joiner add * J01NME
Done

3. 啟動「彙整者」角色

在第二個終端機視窗中,產生新的 CLI 程序。這是節點 2。

$ cd ~/src/openthread
$ ./build/simulation/examples/apps/cli/ot-cli-ftd 2

在節點 2 中,使用 J01NME 彙整憑證啟用 Shared 角色。

> ifconfig up
Done
> joiner start J01NME
Done

... 請稍候幾秒鐘,以確認一下 ...

Join success

做為彙整器,裝置 (Node 2) 已通過歐盟委員會 (Node 1) 驗證,並收到 Thread 網路憑證。

現在,節點 2 已通過驗證,請啟動 Thread:

> thread start
Done

4. 驗證網路驗證

檢查節點 2 上的 state,確認其現已加入網路。節點會在兩個分鐘內從 child 轉換至 router

> state
child
Done
...
> state
router
Done

5. 重新設定

如要準備下一個運動,請重設設定。在每個節點上停止執行緒,恢復原廠設定,然後結束模擬的 Thread 裝置:

> thread stop
Done
> factoryreset
>
> exit

您可能需要多次按下 enter 鍵,才能在 factoryreset 指令後方顯示 > 提示。

6. 使用 OpenThread Daemon 管理網路

在本練習中,我們會模擬一個 CLI 執行個體 (單一嵌入式 SoC Thread 裝置) 和一個無線電 Co-Processor (RCP) 執行個體。

ot-daemon 是 OpenThread Posix 應用程式的模式,使用 UNIX 通訊端做為輸入和輸出,讓 OpenThread 核心能以服務的形式執行。用戶端可以透過 OpenThread CLI 做為通訊協定連線至通訊端,以與這項服務通訊。

ot-ctlot-daemon 提供的 CLI,用於管理及設定 RCP。藉此將 RCP 連線至 Thread 裝置所建立的網路。

使用 ot-daemon

本練習會使用三個終端機視窗,如下:

  1. 模擬 Thread 裝置的 CLI 執行個體 (節點 1)
  2. ot-daemon 處理節點
  3. ot-ctl CLI 執行個體

如果接續上一個練習,您應該應該會開啟兩個終端機視窗。打開第三個通道,確保此運動有三個終端機視窗。

1. 啟動節點 1

在第一個終端機視窗中,產生模擬執行緒的 CLI 程序:

$ cd ~/src/openthread
$ ./build/simulation/examples/apps/cli/ot-cli-ftd 1

注意:執行這個指令之後,如果系統未顯示 > 提示,請按下 enter

建立新的作業資料集,並將其做為使用中的資料集,然後啟動 Thread:

> dataset init new
Done
> dataset
Active Timestamp: 1
Channel: 13
Channel Mask: 07fff800
Ext PAN ID: 97d584bcd493b824
Mesh Local Prefix: fd55:cf34:dea5:7994/64
Network Key: ba6e886c7af50598df1115fa07658a83
Network Name: OpenThread-34e4
PAN ID: 0x34e4
PSKc: 38d6fd32c866927a4dfcc06d79ae1192
Security Policy: 0, onrcb
Done

將這個資料集提交為使用中的資料集:

> dataset commit active
Done

開啟 IPv6 介面:

> ifconfig up
Done

啟動 Thread 通訊協定作業:

> thread start
Done

查看指派給節點 1 執行緒介面的 IPv6 位址:

> ipaddr
fd55:cf34:dea5:7994:0:ff:fe00:fc00
fd55:cf34:dea5:7994:0:ff:fe00:d000
fd55:cf34:dea5:7994:460:872c:e807:c4ab
fe80:0:0:0:9cd8:aab6:482f:4cdc
Done
>

模擬 Thread 網路 步中所述,一個地址為連結本機 (fe80),而三個位址為網格本機位址 (fd)。EID 是不含網格ff:fe00的網格本機位址。在這個輸出範例中,EID 為 fd55:cf34:dea5:7994:460:872c:e807:c4ab

ipaddr 輸出中找出特定 EID,用於與節點通訊。

2. 啟動 ot-Daemon

在第二個終端機視窗中,前往 openthread 目錄,為 RCP 節點啟動 ot-daemon (稱為「節點 2」)。使用 -v 詳細旗標,以便查看記錄輸出並確認執行中,並使用 sudo

$ cd ~/src/openthread
$ sudo ./build/posix/src/posix/ot-daemon -v \
    'spinel+hdlc+forkpty://build/simulation/examples/apps/ncp/ot-rcp?forkpty-arg=2'

成功時,詳細模式中的 ot-daemon 會產生類似以下的輸出內容:

ot-daemon[12463]: Running OPENTHREAD/thread-reference-20200818-1938-g0f10480ed; POSIX; Aug 30 2022 10:55:05
ot-daemon[12463]: Thread version: 4
ot-daemon[12463]: Thread interface: wpan0
ot-daemon[12463]: RCP version: OPENTHREAD/thread-reference-20200818-1938-g0f10480ed; SIMULATION; Aug 30 2022 10:54:10

請將這個終端機保持開啟,並在背景執行。您不會再輸入任何其他指令。

3. 使用 ot-ctl 加入網路

我們尚未將節點 2 (ot-daemon RCP) 轉換至任何 Thread 網路。這時 ot-ctl 就能派上用場。ot-ctl 使用與 OpenThread CLI 應用程式相同的 CLI。因此,您可以使用與其他模擬 Thread 裝置相同的方式控管 ot-daemon 節點。

在第三個終端機視窗中,啟動 ot-ctl

$ sudo ./build/posix/src/posix/ot-ctl
>

注意:執行這個指令之後,如果系統未顯示 > 提示,請按下 enter

您將在這個第三個終端機視窗中使用 ot-ctl 管理透過 ot-daemon 的第二個終端機視窗啟動的節點 2 (RCP 節點)。檢查節點 2 的 state

> state
disabled
Done

取得節點 2 的 eui64,限制與特定彙整器的彙整:

> eui64
18b4300000000001
Done

在節點 1 (第一個終端機視窗) 上啟動委員會,並限制只與 eui64 連線:

> commissioner start
Done
> commissioner joiner add 18b4300000000001 J01NME
Done

在節點 2 (終端機視窗) 中,開啟網路介面並加入網路:

> ifconfig up
Done
> joiner start J01NME
Done

... 請稍候幾秒鐘,以確認一下 ...

Join success

作為彙整工具的 RCP (節點 2) 已透過佣金 (Node 1) 成功驗證自身身分,並接收 Thread 網路憑證。

現在,將 Node 2 加入 Thread 網路:

> thread start
Done

4. 驗證網路驗證

檢查節點 2 上的 state,確認其現已加入網路。節點會在兩個分鐘內從 child 轉換至 router

> state
child
Done
...
> state
router
Done

5. 驗證連線

如要結束 ot-ctl,請透過 Ctrl + D 鍵或 exit 指令,並在主機的指令列中使用連線偵測 (ping) 1,搭配 ping6 指令使用 EID。如果 ot-daemon RCP 執行個體成功加入並與 Thread 網路通訊,連線偵測 (ping) 會成功:

$ ping6 -c 4 fd55:cf34:dea5:7994:460:872c:e807:c4ab
PING fd55:cf34:dea5:7994:460:872c:e807:c4ab (fd55:cf34:dea5:7994:460:872c:e807:c4ab): 56 data bytes
64 bytes from fd55:cf34:dea5:7994:460:872c:e807:c4ab: icmp_seq=0 ttl=64 time=4.568 ms
64 bytes from fd55:cf34:dea5:7994:460:872c:e807:c4ab: icmp_seq=1 ttl=64 time=6.396 ms
64 bytes from fd55:cf34:dea5:7994:460:872c:e807:c4ab: icmp_seq=2 ttl=64 time=7.594 ms
64 bytes from fd55:cf34:dea5:7994:460:872c:e807:c4ab: icmp_seq=3 ttl=64 time=5.461 ms
--- fd55:cf34:dea5:7994:460:872c:e807:c4ab ping statistics ---
4 packets transmitted, 4 packets received, 0% packet loss
round-trip min/avg/max/stddev = 4.568/6.005/7.594/1.122 ms

7. 恭喜!

您已成功使用 OpenThread 模擬第一個 Thread 網路。太棒了!

在本程式碼研究室中,您瞭解如何:

  • 設定 OpenThread 建構工具鍊
  • 模擬 Thread 網路
  • 驗證 Thread 節點
  • 使用 OpenThread Daemon 管理 Thread 網路

詳情請參閱以下參考資料: