โปรแกรมจัดการอุปกรณ์ Weave

ดูแหล่งที่มาบน GitHub

เครื่องมือ weave-device-mgr (Weave Device Manager) ทำหน้าที่เป็นอุปกรณ์ช่วยในระบบนิเวศ Weave เพื่อจัดการการจับคู่อุปกรณ์ รวมถึงการจัดสรรเครือข่ายและ Fabric ฟังก์ชันการทำงานที่ให้บริการนั้นคล้ายกับบทบาทที่แอป Nest มีในการเตรียมอุปกรณ์ การจับคู่ และการลงทะเบียนอุปกรณ์ Nest กับบริการ

Weave Device Manager จะรวมอยู่ใน weave-tools build ในบิลด์แอปพลิเคชันแบบสแตนด์อโลน ไฟล์จะอยู่ที่ /src/device-manager/python

เรียกใช้

เมนูความช่วยเหลือจะพร้อมใช้งานระหว่างที่เครื่องมือทำงาน วิธีเริ่ม Weave Device Manager และดูเมนูความช่วยเหลือ

./weave-device-mgr
help

เชื่อมต่อกับอุปกรณ์จำลอง

เนื่องจากตัวจัดการอุปกรณ์ Weave ทำหน้าที่เป็นฟังก์ชันความช่วยเหลือ คุณจึงต้องเชื่อมต่อกับอุปกรณ์ก่อน หากต้องการทดสอบฟังก์ชันการทำงานนี้ ให้ใช้โทโปโลยีจำลองที่ใช้งานได้ โดยโหนดหนึ่งจะเรียกใช้อุปกรณ์จำลอง Weave และอีกโหนดหนึ่งจะเรียกใช้ Device Manager

1. สร้างโทโพโลยี Happy

ในโทโปโลยีนี้ node01 จะเรียกใช้อุปกรณ์จำลอง ขณะที่ node02 จะเรียกใช้เครื่องมือจัดการอุปกรณ์ ก่อนเริ่มต้น ให้ติดตั้ง Happy และกำหนดค่าให้รองรับ Weave

เมื่อติดตั้งแล้ว ให้สร้างโทโปโลจี Happy แบบง่ายดังนี้

weave-state-load <path-to-openweave-core>/src/test-apps/happy/topologies/standalone/three_nodes_on_thread_weave.json

ตรวจสอบสถานะ "ทำงานได้" และ "สาน" เพื่อยืนยันโทโปโลยี

happy-state
State Name:  happy

NETWORKS   Name         Type   State                                     Prefixes
           Home       thread      UP                       2001:0db8:0001:0002/64


NODES      Name    Interface    Type                                          IPs
         node01        wpan0  thread   fd00:0000:fab1:0006:1ab4:3000:0000:0004/64
                                       2001:0db8:0001:0002:0200:00ff:fe00:0001/64

         node02        wpan0  thread   fd00:0000:fab1:0006:1ab4:3000:0000:0005/64
                                       2001:0db8:0001:0002:0200:00ff:fe00:0002/64

         node03        wpan0  thread   2001:0db8:0001:0002:0200:00ff:fe00:0003/64
                                       fd00:0000:fab1:0006:1ab4:3000:0000:000a/64
weave-state
State Name: weave

NODES                Name       Weave Node Id    Pairing Code
                   node01    18B4300000000004          AAA123
                   node02    18B4300000000005          AAA123
                   node03    18B430000000000A          AAA123

FABRIC          Fabric Id           Global Prefix
                     fab1     fd00:0000:fab1::/48

2. เริ่มอุปกรณ์จำลอง

ลงชื่อเข้าใช้ node01:

happy-shell node01

ใน node01 ให้เปิดอุปกรณ์จำลองโดยใช้ที่อยู่ Weave IPv6 ของโหนดนั้นและรหัสการจับคู่ Weave ที่ถูกต้อง คุณต้องใช้รหัสการจับคู่เพื่อสร้างเซสชัน PASE ที่ปลอดภัยระหว่างอุปกรณ์จำลองกับ Device Manager โดยทำดังนี้

./mock-device --node-addr fd00:0:fab1:6:1ab4:3000:0:4 --pairing-code AB713H
WEAVE:ML: Binding IPv6 TCP listen endpoint to [fd00:0:fab1:6:1ab4:3000:0:4]:11095
WEAVE:ML: Listening on IPv6 TCP endpoint
WEAVE:ML: Binding general purpose IPv4 UDP endpoint to [::]:11095
WEAVE:IN: IPV6_PKTINFO: 92
WEAVE:ML: Binding general purpose IPv6 UDP endpoint to [fd00:0:fab1:6:1ab4:3000:0:4]:11095 (wpan0)
WEAVE:ML: Listening on general purpose IPv6 UDP endpoint
WEAVE:ML: Binding IPv6 multicast receive endpoint to [ff02::1]:11095 (wpan0)
WEAVE:ML: Listening on IPv6 multicast receive endpoint
WEAVE:EM: Cannot listen for BLE connections, null BleLayer
Weave Node Configuration:
  Fabric Id: FAB1
  Subnet Number: 6
  Node Id: 18B4300000000004
WEAVE:SD: init()
Weave Node Configuration:
  Fabric Id: FAB1
  Subnet Number: 6
  Node Id: 18B4300000000004
  Listening Addresses:
      fd00:0:fab1:6:1ab4:3000:0:4 (ipv6)
  Pairing Server: fd00:0:fab1:6:1ab4:3000:0:4
Mock Time Sync is disabled and not initialized
Mock System Time Offset initialized to: -4.802583 sec
Listening for requests...
Weave Node ready to service events; PID: 41116; PPID: 40703

3. เริ่มโปรแกรมจัดการอุปกรณ์

เปิดหน้าต่างเทอร์มินัลใหม่และเข้าสู่ระบบ node02

happy-shell node02

ใน node02 ให้เปิดโปรแกรมจัดการอุปกรณ์ โดยทำดังนี้

./weave-device-mgr
WEAVE:ML: Binding general purpose IPv4 UDP endpoint to [::]:11095
WEAVE:IN: IPV6_PKTINFO: 92
WEAVE:ML: Listening on general purpose IPv4 UDP endpoint
WEAVE:ML: Binding general purpose IPv6 UDP endpoint to [::]:11095 ()
WEAVE:ML: Listening on general purpose IPv6 UDP endpoint
WEAVE:ML: Adding wpan0 to interface table
WEAVE:ML: Binding IPv6 UDP interface endpoint to [fd00:0:fab1:6:1ab4:3000:0:5]:11095 (wpan0)
WEAVE:ML: Listening on IPv6 UDP interface endpoint
Weave Device Manager Shell

weave-device-mgr >

4. เชื่อมต่อกับอุปกรณ์จำลอง

ใน Device Manager (node02) ให้สร้างเซสชัน PASE ที่ปลอดภัยกับอุปกรณ์จำลอง ใช้ที่อยู่ Weave IPv6 และรหัสโหนดของอุปกรณ์จำลองจากเอาต์พุตของคำสั่ง happy-state และ weave-state พร้อมกับรหัสการจับคู่

connect fd00:0:fab1:6:1ab4:3000:0:4 18B4300000000004 --pairing-code AB713H
WEAVE:DM: Initiating connection to device
WEAVE:ML: Binding general purpose IPv4 UDP endpoint to [::]:11095
WEAVE:IN: IPV6_PKTINFO: 92
WEAVE:ML: Listening on general purpose IPv4 UDP endpoint
WEAVE:ML: Binding general purpose IPv6 UDP endpoint to [::]:11095 ()
WEAVE:ML: Listening on general purpose IPv6 UDP endpoint
WEAVE:ML: Adding wpan0 to interface table
WEAVE:ML: Binding IPv6 UDP interface endpoint to [fd00:0:fab1:6:1ab4:3000:0:5]:11095 (wpan0)
WEAVE:ML: Listening on IPv6 UDP interface endpoint
WEAVE:EM: ec id: 1, AppState: 0x8d3777e0
WEAVE:DM: Sending IdentifyRequest to locate device
WEAVE:EM: Msg sent 0000000E:1 16 18B4300000000004 0000 986B 0 MsgId:23C64568
WEAVE:EM: Msg rcvd 0000000E:2 104 18B4300000000004 0000 986B 0 MsgId:8F1FC90B
WEAVE:DM: Received identify response from device 18B4300000000004 ([fd00:0:fab1:6:1ab4:3000:0:4]:11095%wpan0)
WEAVE:DM: Initiating weave connection to device 18B4300000000004 (fd00:0:fab1:6:1ab4:3000:0:4)
WEAVE:ML: Con start AFC0 18B4300000000004 0001
WEAVE:ML: TCP con start AFC0 fd00:0:fab1:6:1ab4:3000:0:4 11095
WEAVE:ML: TCP con complete AFC0 0
WEAVE:ML: Con complete AFC0
WEAVE:DM: Connected to device
WEAVE:DM: Initiating PASE session
WEAVE:EM: ec id: 1, AppState: 0x21da95c0
WEAVE:EM: Msg sent 00000004:1 296 18B4300000000004 AFC0 986C 0 MsgId:00000002
WEAVE:SM: StartSessionTimer
WEAVE:EM: Msg rcvd 00000004:2 284 18B4300000000004 AFC0 986C 0 MsgId:00000000
WEAVE:EM: Msg rcvd 00000004:3 144 18B4300000000004 AFC0 986C 0 MsgId:00000001
WEAVE:EM: Msg sent 00000004:4 176 18B4300000000004 AFC0 986C 0 MsgId:00000003
WEAVE:EM: Msg rcvd 00000004:5 32 18B4300000000004 AFC0 986C 0 MsgId:00000002
WEAVE:SM: CancelSessionTimer
WEAVE:DM: Secure session established
Connected to device.
weave-device-mgr (18B4300000000004 @ fd00:0:fab1:6:1ab4:3000:0:4) >

เอาต์พุตในอุปกรณ์จำลอง (node01) ยืนยันว่าเชื่อมต่อสำเร็จ

WEAVE:EM: Msg rcvd 0000000E:1 16 0000000000000001 0000 986B 0 MsgId:23C64568
WEAVE:EM: ec id: 1, AppState: 0x3aadf480
IdentifyRequest received from node 1 (fd00:0:fab1:6:1ab4:3000:0:5)
  Target Fabric Id: FFFFFFFFFFFFFFFF
  Target Modes: 00000000
  Target Vendor Id: FFFF
  Target Product Id: FFFF
Sending IdentifyResponse
WEAVE:EM: Msg sent 0000000E:2 104 0000000000000001 0000 986B 0 MsgId:8F1FC90B
WEAVE:ML: Con rcvd 3960 fd00:0:fab1:6:1ab4:3000:0:5 38798
Connection received from node 18B4300000000005 (fd00:0:fab1:6:1ab4:3000:0:5)
WEAVE:EM: Msg rcvd 00000004:1 296 0000000000000001 3960 986C 0 MsgId:00000002
WEAVE:EM: ec id: 1, AppState: 0x3aaf1f60
WEAVE:SM: StartSessionTimer
WEAVE:EM: Msg sent 00000004:2 284 0000000000000001 3960 986C 0 MsgId:00000000
WEAVE:EM: Msg sent 00000004:3 144 0000000000000001 3960 986C 0 MsgId:00000001
WEAVE:EM: Msg rcvd 00000004:4 176 0000000000000001 3960 986C 0 MsgId:00000003
WEAVE:EM: Msg sent 00000004:5 32 0000000000000001 3960 986C 0 MsgId:00000002
WEAVE:ML: Message Encryption Key: Id=2C51 Type=SessionKey Peer=0000000000000001 EncType=01 Key=BB00C9BE96F188D7672255A2DC6AC14F,B0615B2BD5F97FC1B7AEC8C6FD59207D3B7CBFE6
WEAVE:SM: CancelSessionTimer
Secure session established with node 1 (fd00:0:fab1:6:1ab4:3000:0:5)
WEAVE:SM: Release session key: Id=2C51 Peer=0000000000000001 Reserve=0

5. ทดสอบการเชื่อมต่อ

ส่งคำขอ Weave Echo จาก Device Manager (node02) ไปยังอุปกรณ์จำลองเพื่อทดสอบการเชื่อมต่อ

ping
WEAVE:DM: DataLength: 0, payload: 0, next: (nil)
WEAVE:EM: ec id: 1, AppState: 0x8d3777e0
WEAVE:EM: Msg sent 00000001:1 0 18B4300000000004 AFC0 986F 0 MsgId:00000000
WEAVE:EM: Msg rcvd 00000001:2 0 18B4300000000004 AFC0 986F 0 MsgId:00000000
Ping complete

เอาต์พุตในอุปกรณ์จำลอง (node01) ยืนยันการสะท้อนกลับที่สำเร็จ:

WEAVE:EM: Msg rcvd 00000001:1 0 0000000000000001 3960 986F 0 MsgId:00000000
WEAVE:EM: ec id: 1, AppState: 0x3aadfbb0
WEAVE:SM: Reserve session key: Id=2CFF Peer=0000000000000001 Reserve=1
Echo Request from node 1 (fd00:0:fab1:6:1ab4:3000:0:5): len=0 ... sending response.
WEAVE:EM: Msg sent 00000001:2 0 0000000000000001 3960 986F 0 MsgId:00000000
WEAVE:SM: Release session key: Id=2CFF Peer=0000000000000001 Reserve=0

6. ยกเลิกการเชื่อมต่อจากอุปกรณ์จำลอง

ใช้เครื่องมือจัดการอุปกรณ์เพื่อยกเลิกการเชื่อมต่อจากอุปกรณ์จำลอง โดยทำดังนี้

close
WEAVE:DM: Closing connection to device
WEAVE:ML: Con closed 8FC0 4002
WEAVE:ML: Removing session key: Id=2873 Peer=18B4300000000004
WEAVE:ML: Closing endpoints
weave-device-mgr >