การตั้งค่าระบบอัตโนมัติของการรับรอง

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

ต้องมีการตั้งค่าเพิ่มเติมเพื่อให้การทดสอบการรับรองเป็นอัตโนมัติ

ขั้นตอนการติดตั้งและการกําหนดค่าด้านล่างทั้งหมดจะเกิดขึ้นบนเครื่อง Windows ที่ใช้ซอฟต์แวร์ GRSA Test Harness ดาวน์โหลดและติดตั้ง Gelse Thread Test Harness ล่าสุดก่อนดําเนินการต่อ

เมื่อติดตั้งแล้ว มีวิธีการอัตโนมัติ 2 วิธีสําหรับอุปกรณ์ที่อยู่ระหว่างการทดสอบ (DUT) ดังนี้

  1. เครื่องมือการทํางานอัตโนมัติใน OpenThread Harness
  2. โหมดทดลองใช้ DUT อัตโนมัติอัตโนมัติ

เครื่องมือการทํางานอัตโนมัติใน OpenThread Harness

ติดตั้ง

  1. ติดตั้งซอฟต์แวร์ต่อไปนี้
    • Python 2.7
    • Git for Windows (เราขอแนะนําให้ใช้การรองรับ Bash)
  2. โคลนที่เก็บ OpenThread เพื่อรับสคริปต์อัตโนมัติ:
    git clone https://github.com/openthread/openthread
    
  3. ข้อกําหนดการติดตั้ง Python
    cd tools/harness-automation
    pip install -r requirements.txt
    
  4. ติดตั้งทั้ง Google Chrome และ ChromeDriver

กำหนดค่า

  1. สร้างไฟล์การกําหนดค่าสําหรับเครื่องมืออัตโนมัติ
    cp autothreadharness/settings_sample.py autothreadharness/settings.py
    
  2. โปรดอัปเดตไฟล์การกําหนดค่าใหม่ตามวิธีการในไฟล์การกําหนดค่า
  3. เพิ่มพารามิเตอร์ต่อไปนี้ลงในไฟล์การกําหนดค่า Test Harness ซึ่งอยู่ใน C:\GRL\Thread1.1\Config\Configuration.ini:
    BrowserAutoNavigate = False

การรองรับการทดสอบแบบผสมผสาน

นอกจากนี้ เครื่องมืออัตโนมัติ Harness Automation ยังรองรับเตียงทดสอบแบบผสม โดยอุปกรณ์ที่ใช้อ้างอิงในแต่ละกรอบการทดสอบเป็นชุดอุปกรณ์แบบผสม ไม่ใช่อุปกรณ์เดียวกันทั้งหมด ตัวอย่างเช่น แทนที่จะใช้บอร์ด 32 TI CC2538 ที่เรียกใช้ OpenThread สําหรับกรอบการทดสอบทั้งหมด คุณสามารถผสมและจับคู่อุปกรณ์อ้างอิงชุดข้อความทั้ง 4 เครื่องสําหรับแต่ละกรอบทดสอบได้ตามต้องการ

หากต้องการใช้การกําหนดค่าการทดสอบแบบผสม จะต้องมีการกําหนดค่าเพิ่มเติมดังนี้

  1. เพิ่มพารามิเตอร์ต่อไปนี้ในไฟล์การกําหนดค่า Test Harness ซึ่งอยู่ที่ C:\GRL\Thread1.1\Config\Configuration.ini
    EnableDeviceSelection = True
  2. ดาวน์โหลดไฟล์การกําหนดค่าโทโพโลยีจากกลุ่มชุดข้อความ เพิ่มไฟล์นี้เป็น TopologyConfig.txt ใน C:\GRL\Thread1.1\Thread_Harness\TestScripts ไฟล์นี้แสดงรายละเอียดอุปกรณ์ที่ใช้อ้างอิงสําหรับแต่ละบทบาทในแต่ละกรอบการทดสอบ

คุณแก้ไขไฟล์การกําหนดค่าโทโพโลยีโดยกลุ่มชุดข้อความได้สําหรับการกําหนดค่าเตียงแบบผสมอื่นๆ แต่สําหรับการรับรองอย่างเป็นทางการ คุณต้องใช้การกําหนดค่าดั้งเดิม

ค่าที่ใช้ได้สําหรับอุปกรณ์อ้างอิงในไฟล์การกําหนดค่าโทโพโลยีคือ

ค่าในไฟล์การกําหนดค่าโทโพโลยี อุปกรณ์อ้างอิงของ Harness
ARM ARM: NXP FRDM-K64F พร้อมโล่ Firefire 6LoWPAN
NXP NXP(รูปแบบอิสระ): ดองเกิล USB-KW24D512
OpenThread เทรดเทรด: TI CC2538DK
SiLabs Silabs: EM358x USB Stick

กรอบการทดสอบแต่ละรายการในไฟล์การกําหนดค่าโทโพโลยีจะต้องอยู่ในแต่ละบรรทัดและจัดรูปแบบเป็นคู่ role:device ดังนี้

5.3.10-Leader:NXP,Router_1:OpenThread,BorderRouter:OpenThread,MED_1:ARM

ใช้โหมด DUT อัตโนมัติกับโปรแกรมทดสอบอัตโนมัติ

ซอฟต์แวร์ GRSA Test Harness มีฟีเจอร์การค้นหาอัตโนมัติขั้นสูง (Auto DUT) ซึ่งช่วยเร่งกระบวนการตรวจสอบสําหรับผู้ให้บริการสแต็กการอ้างอิงของชุดข้อความ

OpenThread จะแสดงตัวอย่าง Thread Host Controller Interface (THCI) ที่ช่วยให้ Test Harness ควบคุมคอมโพเนนต์หรือผลิตภัณฑ์ของคุณเสมือนกับว่าเป็นหนึ่งในแพลตฟอร์มอ้างอิงได้ ตามลักษณะเฉพาะของพอร์ตอนุกรมของแพลตฟอร์มที่คุณใช้ DUT อาจทําอย่างใดอย่างหนึ่งต่อไปนี้

ทําหน้าที่เป็นแพลตฟอร์มข้อมูลอ้างอิง OpenThread ที่มีอยู่

หากพอร์ตอนุกรมของ DUT ทํางานในการตั้งค่า 115200 8-N-1 และอุปกรณ์ตอบสนองอย่างถูกต้องหลังจากอุปกรณ์จริงรีเซ็ตทุกครั้ง (เช่น เพื่อยืนยันการเชื่อมต่อกับอุปกรณ์ Windows ที่ถูกต้อง) แพลตฟอร์มจะใช้เครื่องมือ OpenThread THCI ได้ เครื่องมือนี้จะช่วยให้อุปกรณ์ทําหน้าที่เป็นแพลตฟอร์มอ้างอิง OpenThread ระหว่างการทดสอบได้

  1. ปิด GRSA Test Harness หากเปิดไว้
  2. เชื่อมต่ออุปกรณ์กับเครื่อง Windows
  3. ค้นหาตัวระบุฮาร์ดแวร์พอร์ตอนุกรมของอุปกรณ์โดยใช้โมดูล Python pySerial ดังนี้
    1. ติดตั้ง pySerial ในเครื่อง Windows
    2. ใช้ Python ในบรรทัดคําสั่ง Windows เพื่อแจกแจงตัวระบุฮาร์ดแวร์ทั้งหมด (VID และ PID) สําหรับอุปกรณ์ที่เชื่อมต่อกับเครื่อง ในเอาต์พุตนี้ อุปกรณ์ 1 เครื่องจะเชื่อมต่อกับตัวระบุ VID=1366 และ PID=1015
      python -m serial.tools.list_ports -v
      COM10
          desc: USB Serial Port (COM10)
          hwid: USB\VID_1366+PID_1015+MI_00
    3. หากทราบพอร์ต COM อยู่แล้ว คุณจะใช้คําสั่งอื่นได้ เช่น หากพอร์ต COM คือ COM10
      python -c "import serial.tools.list_ports;print [ports[2] for ports in serial.tools.list_ports.comports() if ports[0] == 'COM10']"
      ['USB\VID_1366+PID_1015+MI_00']
  4. อัปเดตรายการอุปกรณ์ทอง:
    1. เปิด C:\GRL\Thread1.1\Config\Configuration.ini
    2. อัปเดตกลุ่ม OpenThread ในอาร์เรย์ GoldenDeviceHardwareIds ด้วย VID และ PID ของอุปกรณ์ ดังนี้
      GoldenDeviceHardwareIds = {
      'NXP': ['VID:PID=1FC9:0300','VID:PID=15A2:0300','VID:PID=1366:1015'],
      'SiLabs': 'VID:PID=10C4:8A5E',
      'ARM': 'VID:PID=0D28:0204',
      'OpenThread':['VID:PID=10C4:EA60','VID:PID=1366:1015']}
  5. เปิดใช้โหมด DUT อัตโนมัติ

ทําหน้าที่เป็นแพลตฟอร์มอ้างอิงใหม่

หากพอร์ตอนุกรมของ DUT ไม่ทํางานในการตั้งค่าพอร์ตอนุกรมที่เหมาะสม หรืออุปกรณ์ไม่ตอบสนองอย่างถูกต้องหลังจากอุปกรณ์จริงถูกรีเซ็ต (เอาต์พุตไม่สามารถอ่านรหัสได้ภายใน 3-6 วินาทีของการรีเซ็ต) คุณสามารถปรับแต่ง OpenThread THCI ให้ถือว่าอุปกรณ์เป็นแพลตฟอร์มใหม่ในส่วนทดสอบ

ตัวอย่างเช่น หากต้องการปรับแต่ง THCI โดยใช้แพลตฟอร์ม Nordic Semiconductor nRF52840 ให้ใช้รูปแบบดังนี้

  1. ปิด GRSA Test Harness หากเปิดไว้
  2. แก้ไข /tools/harness-thci/OpenThread.py ตามลักษณะ UART ของอุปกรณ์เป้าหมาย การแก้ไขอาจแตกต่างกันไปตามอุปกรณ์เป้าหมาย ในกรณีที่เป็นแพลตฟอร์ม Nordic nRF52840

    1. เปลี่ยนชื่อไฟล์ OpenThread.py เป็น nRF52840.py
    2. เปลี่ยนรายการ 3 รายการแรกของ "OpenThread" เป็น "nRF52840"

      >> Device : nRF52840 THCI
      >> Class : nRF52840
      
      class nRF52840(IThci):
      
    3. เปลี่ยนพารามิเตอร์พอร์ตอนุกรม ดังนี้

      def _connect(self):
          print 'My port is %s' % self.port
          if self.port.startswith('COM'):
              self.handle = serial.Serial(self.port, 115200, timeout=0)
              time.sleep(1)
              self.handle.write('\r\n')
              time.sleep(0.1)
              self._is_net = False
          elif ':' in self.port:
              host, port = self.port.split(':')
              self.handle = socket.create_connection((host, port))
              self.handle.setblocking(0)
              self._is_net = True
          else:
              raise Exception('Unknown port schema')
          self.UIStatusMsg = self.getVersionNumber()
      
    4. เปลี่ยนเวลานอนเพื่อลดผลกระทบจากเอาต์พุตโค้ดที่อ่านไม่ได้หลังจากรีเซ็ตอุปกรณ์:

      def powerDown(self):
          """power down the Thread device"""
          print '%s call powerDown' % self.port
          self._sendline('reset')
          self.isPowerDown = True
          time.sleep(8)  # New addition
      
      def reboot(self):
          """reset and rejoin to Thread Network without any timeout
      
          Returns:
              True: successful to reset and rejoin the Thread Network
              False: fail to reset and rejoin the Thread Network
          """
          print '%s call reboot' % self.port
          try:
              self._sendline('reset')
              self.isPowerDown = True
              time.sleep(8)  # Updated from 3 to 8
      
      def reset(self):
          """factory reset"""
          print '%s call reset' % self.port
          try:
              self._sendline('factoryreset')
              time.sleep(8)  # Updated from 3 to 8
              self._read()
      
      def resetAndRejoin(self, timeout):
          """reset and join back Thread Network with a given timeout delay
      
          Args:
              timeout: a timeout interval before rejoin Thread Network
      
          Returns:
              True: successful to reset and rejoin Thread Network
              False: fail to reset and rejoin the Thread Network
          """
          print '%s call resetAndRejoin' % self.port
          print timeout
          try:
              self._sendline('reset')
              self.isPowerDown = True
              time.sleep(timeout)
              if timeout < 8:      # Sleep a bit longer if the timeout is short
                  time.sleep(8 - timeout)
      
  3. คัดลอกไฟล์ nRF52840.py ที่แก้ไขแล้วไปยัง C:\GRL\Thread1.1\Thread_Harness\THCI

  4. เพิ่มข้อมูลแพลตฟอร์มใหม่ลงในเครื่องมือทดสอบเนื้อหา ดังนี้

    1. สร้างไอคอน (ในรูปแบบ png หรือ jpg) เพื่อให้แยกความแตกต่างของแพลตฟอร์มและคัดลอกไปยัง C:\GRL\Thread1.1\Web\images ได้ง่ายขึ้น
    2. อัปเดต C:\GRL\Thread1.1\Web\data\deviceInputFields.xml ด้วยส่วน DEVICE ใหม่ โดยที่พารามิเตอร์ thumbnail คือไฟล์ไอคอน

      <DEVICE name="nRF52840" thumbnail="nRF52840.jpg" description ="nRF52840: Nordic" THCI="nRF52840">
          <ITEM label="Serial Line"
                type="text"
                forParam="SerialPort"
                validation="COM"
                hint="eg: COM1">COM
          </ITEM>
          <ITEM label="Speed"
                type="text"
                forParam="SerialBaudRate"
                validation="baud-rate"
                hint="eg: 115200">115200
          </ITEM>
      </DEVICE>
      
  5. เชื่อมต่ออุปกรณ์กับเครื่อง Windows

  6. ค้นหาตัวระบุฮาร์ดแวร์พอร์ตอนุกรมของอุปกรณ์โดยใช้โมดูล Python pySerial ดังนี้

    1. ติดตั้ง pySerial ในเครื่อง Windows
    2. ใช้ Python ในบรรทัดคําสั่ง Windows เพื่อแจกแจงตัวระบุฮาร์ดแวร์ทั้งหมด (VID และ PID) สําหรับอุปกรณ์ที่เชื่อมต่อกับเครื่อง ในเอาต์พุตนี้ อุปกรณ์ 1 เครื่องจะเชื่อมต่อกับตัวระบุ VID=1366 และ PID=1015
      python -m serial.tools.list_ports -v
      COM10
          desc: USB Serial Port (COM10)
          hwid: USB\VID_1366+PID_1015+MI_00
    3. หากทราบพอร์ต COM อยู่แล้ว คุณจะใช้คําสั่งอื่นได้ เช่น หากพอร์ต COM คือ COM10
      python -c "import serial.tools.list_ports;print [ports[2] for ports in serial.tools.list_ports.comports() if ports[0] == 'COM10']"
      ['USB\VID_1366+PID_1015+MI_00']
  7. อัปเดตรายการอุปกรณ์สีทอง:

    1. เปิด C:\GRL\Thread1.1\Config\Configuration.ini
    2. เพิ่มกลุ่มแพลตฟอร์มใหม่ในอาร์เรย์ GoldenDeviceHardwareIds ด้วย VID และ PID ของอุปกรณ์
      GoldenDeviceHardwareIds = {
      'NXP': ['VID:PID=1FC9:0300','VID:PID=15A2:0300','VID:PID=1366:1015'],
      'SiLabs': 'VID:PID=10C4:8A5E',
      'ARM': 'VID:PID=0D28:0204',
      'OpenThread':'VID:PID=10C4:EA60',
      'nRF52840': 'VID:PID=1366:1015'}
  8. เปิดใช้โหมด DUT อัตโนมัติ

เปิดใช้โหมด DUT อัตโนมัติ

หลังจากตัวเลือกการกําหนดค่า 1 ใน 2 รายการข้างต้นเสร็จสมบูรณ์แล้ว

  1. เปิด GAR Test Harness แล้วอุปกรณ์/พอร์ตนี้จะปรากฏเป็นอุปกรณ์อ้างอิงใหม่
  2. เลือกช่องทําเครื่องหมายเปิดใช้การเลือกอุปกรณ์ DUT อัตโนมัติใต้รายการฮาร์ดแวร์ที่รองรับ
  3. เลือกปุ่มตัวเลือกตั้งเป็น DUT ใต้อุปกรณ์/พอร์ตเป้าหมายเพื่อตั้งค่าอุปกรณ์เป็น DUT
DUT การรับรอง OT โดยอัตโนมัติ