Configuração da automação de certificação

Para automatizar os testes de certificação, é necessária uma configuração adicional.

Todas as etapas de instalação e configuração abaixo ocorrem na máquina Windows que executa o software GRL Test Harness. Faça o download e instale a versão mais recente do GRL Thread Test Harness antes de continuar.

Após a instalação, há dois métodos de automação para o dispositivo em teste (DUT, na sigla em inglês):

1. Ferramenta de automação de arremesso de OpenThread
2. Testar o modo DUT do Harness Auto

Ferramenta de automação de arremesso de OpenThread

Instalar

1. Instale o seguinte software:
   • Python 2.7
   • Git para Windows (o suporte ao Bash é altamente recomendado)
2. Clone o repositório do OpenThread para receber os scripts de automação:

   git clone https://github.com/openthread/openthread
   

3. Instale os requisitos do Python:

   cd tools/harness-automation
   pip install -r requirements.txt
   

4. Instale o Google Chrome e o ChromeDriver.

Configurar

1. Crie um arquivo de configuração para a ferramenta de automação:

   cp autothreadharness/settings_sample.py autothreadharness/settings.py
   

2. Atualize esse novo arquivo de configuração de acordo com as instruções contidas nele.
3. Adicione o seguinte parâmetro ao arquivo de configuração do arcabouço de testes, encontrado em C:\GRL\Thread1.1\Config\Configuration.ini:

   BrowserAutoNavigate = False

Suporte misto com testbed

A ferramenta de automação Harness também é compatível com canteiros de teste mistos, em que os dispositivos de referência usados em cada caso de teste são um conjunto misto de dispositivos, e não todos o mesmo dispositivo. Por exemplo, em vez de usar 32 placas TI CC2538 executando o OpenThread para todos os casos de teste, você pode combinar todos os quatro dispositivos de referência Thread para cada caso de teste.

Para usar camas de teste mistas, é necessária uma configuração adicional:

1. Adicione o seguinte parâmetro ao arquivo de configuração de arcabouço de testes, encontrado em C:\GRL\Thread1.1\Config\Configuration.ini:

   EnableDeviceSelection = True

2. Faça o download do arquivo de configuração de topologia do grupo Thread. Adicione esse arquivo como TopologyConfig.txt a C:\GRL\Thread1.1\Thread_Harness\TestScripts. Esse arquivo detalha qual dispositivo de referência usar para cada papel em cada caso de teste.

O arquivo de configuração de topologia fornecido pelo grupo de linhas de execução pode ser modificado para outras configurações de mix misto, mas para certificação oficial, a configuração original precisa ser usada.

Os valores válidos a serem usados para dispositivos de referência no arquivo de configuração de topologia são:

Cada entrada de caso de teste no arquivo de configuração de topologia precisa estar em uma linha separada e formatada em pares role:device da seguinte maneira:

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

Testar o modo DUT do Harness Auto

O software GRL Test Harness fornece um recurso de descoberta automática (Auto DUT) que acelera o processo de validação para fornecedores de pilha de referência de linhas de execução.

O OpenThread fornece um exemplo de interface de controlador de host de linha de execução (THCI, na sigla em inglês) que permite que o arcabouço de testes controle seu componente ou produto como se ele fosse uma das plataformas de referência. De acordo com as características da porta serial da sua plataforma específica, o DUT pode:

• agir como a plataforma de referência existente do OpenThread

  ,

• agir como uma nova plataforma de referência

funcionar como a plataforma de referência existente do OpenThread.

Se a porta serial do DUT funcionar nas configurações de 115200 8-N-1 e o dispositivo responder corretamente após cada redefinição física (por exemplo, para confirmar a conexão válida do dispositivo com a máquina Windows), a plataforma poderá usar a ferramenta OpenThread THCI. Essa ferramenta permite que o dispositivo atue como a plataforma de referência do OpenThread durante os testes.

1. Feche o arcabouço de testes GRL, se ele estiver aberto.
2. Conecte o dispositivo à máquina Windows.
3. Localize o identificador de hardware da porta serial do dispositivo usando o módulo pySerial do Python:
   1. Instale o pySerial na máquina Windows.
   2. Use o Python na linha de comando do Windows para enumerar todos os identificadores de hardware (VID e PID) para dispositivos conectados à máquina. Nesta saída, um dispositivo está conectado com um identificador de VID=1366 e PID=1015:

      python -m serial.tools.list_ports -v
      COM10
          desc: USB Serial Port (COM10)
          hwid: USB\VID_1366+PID_1015+MI_00

   3. Se você já conhece a porta COM, pode usar um comando diferente. Por exemplo, se a porta COM for 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. Atualize a lista de dispositivos Golden:
   1. Abra o C:\GRL\Thread1.1\Config\Configuration.ini
   2. Atualize o grupo OpenThread na matriz GoldenDeviceHardwareIds com o VID e o PID dos dispositivos:

      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. Ativar o modo DUT automático.

Uma nova plataforma de referência

Se a porta serial da DUT não funcionar nas configurações de porta serial adequadas ou se o dispositivo não responder corretamente após uma redefinição de dispositivo físico (saída de código ilegível dentro de três a seis segundos após a redefinição), a OpenThread THCI poderá ser personalizada para tratar o dispositivo como uma nova plataforma no Harness Test.

Por exemplo, para personalizar o THCI usando a plataforma Nordic Semiconductor nRF52840:

1. Feche o arcabouço de testes GRL, se ele estiver aberto.

2. Modifique /tools/harness-thci/OpenThread.py com base nas características da UART do dispositivo de destino. As modificações podem ser diferentes entre os dispositivos de destino. No caso da plataforma Nórdica nRF52840:

   1. Renomeie o arquivo OpenThread.py como nRF52840.py.

   2. Altere as três primeiras ocorrências de "OpenThread" para "nRF52840":

      >> Device : nRF52840 THCI
      >> Class : nRF52840
      
      class nRF52840(IThci):
      

   3. Altere os parâmetros da porta serial:

      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. Mude o tempo de suspensão para eliminar o impacto da saída de código ilegível após a redefinição do dispositivo:

      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. Copie o arquivo nRF52840.py modificado para C:\GRL\Thread1.1\Thread_Harness\THCI

4. Adicione as novas informações da plataforma ao arcabouço de testes:

   1. Crie um ícone (no formato png ou jpg) para facilitar a diferenciação da plataforma e copiá-lo para C:\GRL\Thread1.1\Web\images.

   2. Atualize C:\GRL\Thread1.1\Web\data\deviceInputFields.xml com uma nova seção DEVICE, em que o parâmetro thumbnail é o arquivo do ícone:

      <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. Conecte o dispositivo à máquina Windows.

6. Encontre o identificador de hardware da porta serial do dispositivo usando o módulo pySerial do Python:

   1. Instale o pySerial na máquina Windows.
   2. Use o Python na linha de comando do Windows para enumerar todos os identificadores de hardware (VID e PID) para dispositivos conectados à máquina. Nesta saída, um dispositivo está conectado com um identificador de VID=1366 e PID=1015:

      python -m serial.tools.list_ports -v
      COM10
          desc: USB Serial Port (COM10)
          hwid: USB\VID_1366+PID_1015+MI_00

   3. Se você já conhece a porta COM, pode usar um comando diferente. Por exemplo, se a porta COM for 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. Atualize a lista de dispositivos Golden:

   1. Abra o C:\GRL\Thread1.1\Config\Configuration.ini
   2. Adicione um novo grupo de plataformas na matriz GoldenDeviceHardwareIds com o VID e o PID do dispositivo:

      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. Ativar o modo DUT automático.

Ativar o modo DUT automático

Depois que uma das duas opções de configuração acima for concluída:

1. Abra o arcabouço de testes do GRL. Agora, o dispositivo/porta aparece como um novo dispositivo de referência.
2. Marque a caixa de seleção Enable Auto DUT Device Selection abaixo da lista "Hardware compatível".
3. Selecione o botão de opção Definir como DUT no dispositivo/porta de destino para definir o dispositivo como DUT.