View a markdown version of this page

Esegui il debug ed esegui suite di test personalizzate - FreeRTOS
Esegui IDT in modalità debugComandi IDT CLI per eseguire i test

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esegui il debug ed esegui suite di test personalizzate

Dopo aver impostato la configurazione Configura le impostazioni per i test runner richiesta, IDT può eseguire la suite di test. Il tempo di esecuzione della suite di test completa dipende dall'hardware e dalla composizione della suite di test. Come riferimento, sono necessari circa 30 minuti per completare la suite completa di test di qualificazione FreeRTOS su un Raspberry Pi 3B.

Mentre scrivi la tua suite di test, puoi usare IDT per eseguire la suite di test in modalità debug per controllare il codice prima di eseguirlo o fornirlo ai test runner.

Esegui IDT in modalità debug

Poiché le suite di test dipendono da IDT per interagire con i dispositivi, fornire il contesto e ricevere risultati, non puoi semplicemente eseguire il debug delle suite di test in un IDE senza alcuna interazione con IDT. A tale scopo, l'IDT CLI fornisce il debug-test-suite comando che consente di eseguire IDT in modalità debug. Eseguite il comando seguente per visualizzare le opzioni disponibili per: debug-test-suite

devicetester_[linux | mac | win_x86-64] debug-test-suite -h

Quando si esegue IDT in modalità debug, IDT non avvia effettivamente la suite di test né esegue il test orchestrator; interagisce invece con l'IDE per rispondere alle richieste fatte dalla suite di test in esecuzione nell'IDE e stampa i log sulla console. IDT non scade e attende di uscire finché non viene interrotto manualmente. In modalità debug, IDT inoltre non esegue il test orchestrator e non genera alcun file di report. Per eseguire il debug della suite di test, è necessario utilizzare l'IDE per fornire alcune informazioni che IDT di solito ottiene dai file di configurazione. Assicuratevi di fornire le seguenti informazioni:

  • Variabili di ambiente e argomenti per ogni test. IDT non leggerà queste informazioni da test.json osuite.json.

  • Argomenti per selezionare i dispositivi delle risorse. IDT non leggerà queste informazioni datest.json.

Per eseguire il debug delle tue suite di test, completa i seguenti passaggi:

  1. Crea i file di configurazione delle impostazioni necessari per eseguire la suite di test. Ad esempio, se la tua suite di test richiede i file device.json resource.jsonuser data.json, e, assicurati di configurarli tutti secondo necessità.

  2. Esegui il comando seguente per mettere IDT in modalità debug e selezionare tutti i dispositivi necessari per eseguire il test.

    devicetester_[linux | mac | win_x86-64] debug-test-suite [options]

    Dopo aver eseguito questo comando, IDT attende le richieste dalla suite di test e quindi risponde ad esse. IDT genera anche le variabili di ambiente necessarie per l'elaborazione dei casi per l'IDT Client SDK.

  3. Nel tuo IDE, usa la debug configurazione run or per fare quanto segue:

    1. Imposta i valori delle variabili di IDT-generated ambiente.

    2. Imposta il valore di tutte le variabili di ambiente o gli argomenti che hai specificato nel tuo suite.json file test.json and.

    3. Imposta i punti di interruzione in base alle esigenze.

  4. Esegui la suite di test nel tuo IDE.

    Puoi eseguire il debug e rieseguire la suite di test tutte le volte che è necessario. IDT non scade in modalità debug.

  5. Dopo aver completato il debug, interrompi IDT per uscire dalla modalità di debug.

Comandi IDT CLI per eseguire i test

La sezione seguente descrive i comandi IDT CLI:

IDT v4.0.0
help

Elenca le informazioni sul comando specificato.

list-groups

Elenca i gruppi in una determinata suite di test.

list-suites

Elenca le suite di test disponibili.

list-supported-products

Elenca i prodotti supportati per la tua versione di IDT, in questo caso le versioni FreeRTOS e le versioni della suite di test di qualificazione FreeRTOS disponibili per la versione IDT corrente.

list-test-cases

Elenca i casi di test in un determinato gruppo di test. È supportata la seguente opzione:

  • group-id. Il gruppo di test da cercare. Questa opzione è obbligatoria e deve specificare un singolo gruppo.

run-suite

Esegue una suite di test in un determinato pool di dispositivi. Di seguito sono riportate alcune opzioni di uso comune:

  • suite-id. La versione della suite di test da eseguire. Se non specificato, IDT utilizza la versione più recente nella cartella tests.

  • group-id. I gruppi di test da eseguire, sotto forma di elenco separato da virgole. Se non specificato, IDT esegue tutti i gruppi di test nella suite di test.

  • test-id. I casi di test da eseguire, come elenco separato da virgole. Quando specificato, group-id deve specificare un singolo gruppo.

  • pool-id. Il pool di dispositivi da testare. I test runner devono specificare un pool se nel device.json file sono definiti più pool di dispositivi.

  • timeout-multiplier. Configura IDT per modificare il timeout di esecuzione del test specificato nel test.json file per un test con un moltiplicatore definito dall'utente.

  • stop-on-first-failure. Configura IDT per interrompere l'esecuzione al primo errore. Questa opzione deve essere utilizzata con group-id per eseguire il debug dei gruppi di test specificati.

  • userdata. Imposta il file che contiene le informazioni sui dati utente necessarie per eseguire la suite di test. Questo è richiesto solo se userdataRequired è impostato su true nel suite.json file della suite di test.

Per ulteriori informazioni sulle opzioni run-suite, utilizzare l'opzione help:

devicetester_[linux | mac | win_x86-64] run-suite -h
debug-test-suite

Esegui la suite di test in modalità debug. Per ulteriori informazioni, consulta Esegui IDT in modalità debug.