Pruva di simplificazione
L'automatizazione cù
tm_devices è Python
COME GUIDA

Simplifying Test Automation With tm_ Devices And Python

COME GUIDA
Simplifying Test Automation with tm_devices è Python
L'ingegneri in parechje industrie utilizanu l'automatizazione per allargà e capacità di i so strumenti di prova. Parechji ingegneri sceglienu a lingua di prugrammazione libera Python per fà questu. Ci sò assai vantaghji significativutages chì facenu Python un grande linguaghju di prugrammazione per l'automatizazione:

• Versatilità
• Facile à insignà è amparà
• Leggibilità di u codice
• Basi di cunniscenza è moduli largamente dispunibili

Ci hè dui casi di usu principali per l'automatizazione:

• Routine chì imitanu u cumpurtamentu umanu per automatizà u pannellu frontale è risparmià tempu, per esempiu, teste di conformità automatizata.
  Piuttostu chè à pusà à u scopu, aghjunghjendu misurazioni appropritate, è scrive i risultati ogni volta chì avete bisognu di pruvà una nova parte, l'ingegnere sviluppa un script chì face tuttu ciò è mostra u risultatu.
• Usi chì allarganu a funziunalità di u strumentu; per example: logging di misurazione, validazione o assicurazione di qualità.
  L'automatizazione permette à l'ingegnere di eseguisce testi cumplessi senza parechji svantaghji inerenti à questi testi. Ùn ci hè micca bisognu di un operatore per stabilisce u scopu è registrà manualmente i risultati, è a prova pò esse realizata in u listessu modu ogni volta.
  Questa guida cumu si copre ciò chì avete bisognu per inizià i scopi di prugrammazione in Python, cumprese i principii di l'interfacce programmatiche è cumu scaricà è eseguisce un ex.ample.

Cosa hè una Interfaccia Programmatica?

Una interfaccia programmatica (PI) hè un cunfini o un settore di cunfini trà dui sistemi di calculu chì ponu esse programati per eseguisce cumpurtamenti specifichi. Per i nostri scopi, hè u ponte trà l'urdinatore chì gestisce ogni pezzu di l'equipaggiu di prova Tektronix, è l'applicazione scritta da un utilizatore finale. Per ristrettu questu ancu più, hè un cumandamenti sof chì pò esse mandatu remotamente à un strumentu chì poi processa quelli cumandamenti è eseguisce un compitu currispundente. U PI Stack (Figura 1) mostra u flussu di l'infurmazioni da u controller host à l'instrumentu. U codice di l'applicazione scrittu da l'utilizatore finale definisce u cumpurtamentu di u strumentu di destinazione. Questu hè generalmente scrittu in una di e plataforme di sviluppu populate in l'industria cum'è Python, MATLAB, Lab.VIEW, C++, o C#. Questa applicazione mandarà dati utilizendu u furmatu di Comandi Standard per Strumentazioni Programmable (SCPI), chì hè un standard supportatu da a maiò parte di l'equipaggiu di prova è misurazione. I cumandamenti SCPI sò spessu mandati per una strata di Virtual Instrument Software Architecture (VISA), chì hè aduprata per facilità u trasferimentu di dati includendu robustezza supplementu (per esempiu, verificazione di errore) à u protocolu di cumunicazione. In certi casi, l'applicazioni ponu chjamà un driver chì poi mandarà unu o più cumandamenti SCPI à a capa VISA.Figura 1. U stack di l'interfaccia di prugrammazione (PI) mostra u flussu di l'infurmazioni trà un controller d'ospite è un strumentu.

Chì ghjè u pacchettu tm_devices?

tm_devices hè un pacchettu di gestione di u dispositivu sviluppatu da Tektronix chì include una multitùdine di cumandamenti è funzioni per aiutà l'utilizatori à automatizà facilmente e teste nantu à i prudutti Tektronix è Keithley utilizendu a lingua di prugrammazione Python. Pò esse usatu in l'IDE più populari per Python è supporta l'aiuti di cumpleta di codice. Stu pacchettu rende l'automatizazione di codificazione è teste simplice è faciule per ingegneri cù cumpetenze di software di ogni livellu. L'installazione hè ancu simplice è usa pip, u sistema di gestione di pacchetti di Python.

Configurazione di u vostru Ambiente

Questa sezione vi guidarà à traversu i prerequisiti è l'installazione per preparà per fà u travagliu di sviluppu cù tm_devices. Include ancu struzzioni chì supportanu l'ambienti virtuali in Python (venvs) per fà i vostri prughjetti più faciuli di gestisce è di mantene, soprattuttu s'è vo site solu pruvà stu pacchettu prima di impegnà à u so usu.
Nota: Se tenete un ambiente senza accessu direttu à l'internet, avete da mudificà i vostri passi cù i cumandamenti in l'appendice. Sè vo avete prublemi, sentite liberu di postà in u discussioni github per aiutu.

Installazione è Prerequisites Overview

1. Installa Python
   a. Python ≥ 3.8
2. PyCharm - Installazione di PyCharm, Cumincià un prughjettu, è installazione di tm_devices
3. VSCode - Installazione di VSCode, Inizio di un prughjettu, è installazione di tm_devices

Edizione PyCharm Community (gratuita).
PyCharm hè un popular IDE Python utilizatu da i sviluppatori di software in tutti i settori. PyCharm hà un tester di unità integrata chì permette à l'utilizatori di eseguisce testi file, classa, metudu, o tutti i testi in un cartulare. Cum'è a maiò parte di l'IDE muderni, hà una forma di cumplimentu di codice chì accelera u vostru sviluppu tremendamente nantu à un editore di testu di basa.
Andemu per l'installazione di l'edizione di a cumunità PyCharm (gratuita), seguita da installà tm_devices in l'IDE è stabilisce un ambiente virtuale per sviluppà in.

1. Andà à https://www.jetbrains.com/pycharm/
2. Scorri PyCharm Professional à PyCharm Community Edition, cliccate nantu à scaricà
3. Tu avissi a èssiri capaci di cuntinuà cù solu i passi di stallazione predeterminatu. Ùn avemu bisognu di nunda unicu.
4. Benvenuti à PyCharm!
5. Avà vi tuccherà à creà un novu prughjettu è assicuratevi di stallà un ambiente virtuale. Cliccate "New Project"
6. Cunfirmà a strada per u prugettu, assicuratevi chì "Virtualenv" hè sceltu
7. Aprite un terminal. Se u vostru view ùn include micca u buttone etichettatu in u fondu cercate questu:
8. Confirmate chì l'ambiente virtuale hè stallatu cuntrollandu (venv) prima di u prompt in u vostru terminal
9. Installa u driver da u terminal
   Type: pip install tm_devices
10. U vostru terminal deve esse senza errore! Felice pirate !

Visual Studio Code
Visual Studio Code hè un altru IDE gratuitu populari chì i sviluppatori di software in tutte e industrie utilizanu. Hè grande per a maiò parte di e lingue è hà estensioni per a maiò parte di e lingue chì facenu a codificazione in questu IDE assai còmuda è efficace. Visual Studio Code furnisce IntelliSense chì hè un strumentu estremamente utile à u sviluppu, perchè aiuta in u cumpletu di u codice, l'infurmazioni di parametri, è altre informazioni riguardanti l'uggetti è e classi. Convenientemente, tm_devices sustene u cumpletu di codice chì descrive l'arburu di cumanda di l'uggetti è e classi.
Avemu una guida eccellente nantu à a stallazione di Python è Visual Studio Code, cumprese l'infurmazioni nantu à a configurazione di l'ambiente virtuale quì.

Exampu codice

In sta rùbbrica avemu da passà à traversu pezzi di un codice sèmplice example è mette in risaltu qualchi cumpunenti nicissariu à aduprà tm_ dispusitivi effittivamenti.
ImportazioniSti dui linii sò critichi per l'usu efficace di tm_devices. In a prima linea impurtamu u DeviceManager. Questu hà da gestisce a cunnessione è a disconnessione di più classi di dispositivi.
In a seconda linea impurtamu un cunduttore specificu, in questu casu u MSO5B.
Avemu stallatu un gestore di cuntestu cù u DeviceManager:E dopu quandu usemu u gestore di u dispositivu è u driver inseme:

Pudemu instantiate un strumentu cù un set di cumandamenti specifichi chì currisponde à u so mudellu. Basta à inserisce l'indirizzu IP di u vostru strumentu (altri indirizzi VISA funzionanu ancu).
Cù questi quattru linii cumpleti, pudemu cumincià à scrive un automatizazione significativu è specificu per u MSO5B!
Frammenti di codice
Fighjemu uni pochi di azzioni simplici -
Stabbilisce u tipu di trigger à EdgeEccu cumu aghjunghje è dumandate una misurazione di piccu à piccu nantu à CH1:Sè vo vulete piglià un ampmisurazione di lititudine nantu à CH2:

Utilizà IntelliSense/Code Completion

IntelliSense - U nome di Microsoft per u Code Completion hè una funzione assai putente di l'IDE chì avemu pruvatu à sfruttà quant'è pussibule.
Una di e barriere core à l'automatizazione cù i dispositi di prova è di misurazione hè u set di cumandamenti SCPI. Hè una struttura datata cù sintassi micca largamente supportata in a cumunità di sviluppu.
Ciò chì avemu fattu cù tm_devices hè di creà un settore di cumandamenti Python per ogni cumanda SCPI. Questu ci hà permessu di generà codice Python da a sintassi di cumanda esistenti per evità u sviluppu manuale di i cunduttori, è ancu di creà una struttura chì hè familiar à l'utilizatori SCPI esistenti. Hè ancu mappa à u codice di livellu più bassu chì puderia esse bisognu di debugging intenzionale durante a creazione di u vostru prugramma. A struttura di i cumandamenti di Python imita l'SCPI (o in certi casi Keithley TSP) struttura di cumandamenti cusì se site familiarizatu cù SCPI, sarete familiarizatu cù questi.
Questu hè un example di cumu IntelliSense mostra tutti i cumandamenti dispunibuli cù u cumandamentu digitatu prima:
In a lista scrollable chì appare dopu à u puntu nantu à u scopu, pudemu vede una lista alfabetica di categurie di cummandu di u scopu:Selezziunate afg, simu capaci di vede una lista di categurie AFG:Cumandamentu finali scrittu cù l'aiutu di IntelliSense:

Docstring Help

Cume u codice, o mentre leghjite u codice di qualcunu altru, pudete passà sopra e diverse parti di a sintassi per uttene a documentazione d'aiutu specifica di quellu livellu. U più vicinu à a sintassi di cumandamentu cumpleta, u più specificu serà.Sicondu e vostre cundizioni IDE, pudete vede l'aiutu di IntelliSense è docstring à u stessu tempu.Cù sta guida avete vistu alcuni di i benefici di u pacchettu di driver python di Tek tm_devices è pudete inizià u vostru viaghju di automatizazione. Cù l'installazione faciule, u cumpletu di u codice, è l'aiutu integratu, puderà amparà senza abbandunà u vostru IDE, accelerà u vostru tempu di sviluppu è codice cun più fiducia.
Ci sò linee di cuntribuzione in u repo di Github se vulete migliurà u pacchettu. Ci sò assai ex più avanzatiampi evidenziati in a documentazione è in u cuntenutu di u pacchettu in l'Examples folder.

Risorse extra

tm_devices · PyPI - Scaricamentu di driver di pacchettu è informazioni
tm_devices Github - Codice surghjente, seguimentu di prublemi, cuntribuzione
tm_devices Github - Documentazione in linea

Risoluzione di prublemi

L'aghjurnamentu di pip hè di solitu un bonu primu passu per risolve i prublemi:
In u vostru tipu di terminal: Python.exe -m pip install -upgrade pip
Errore: whl s'assumiglia à a filenome, ma file ùn esiste micca OR .whl ùn hè micca una rota supportata nantu à sta piattaforma.

Soluzione: Pip installà a rota in modu chì ricunnosce u file furmatu.
In u vostru tipu di terminal: pip install wheel
Sè avete bisognu di stallà a rota offline, pudete seguità struzzioni simili à l'Appendice A, ma richiede u tar.gz download invece di u .whl. file.

Appendice A - Installazione offline di tm_devices

1. In un urdinatore cù Internet, scaricate u pacchettu cù tutte e dipendenze à u locu di u percorsu specificatu usendu:
   pip download -dest wheel setuptools tm_devices
2. Copia u files à u vostru urdinatore chì ùn hà micca accessu à Internet
3. Dopu, seguitate l'istruzzioni da a guida principale per qualsiasi IDE chì site aduprate, ma scambià u cumandimu di installazione per i seguenti:
   pip install –no-index –find-links files> tm_devices

Informazioni di cuntattu:
Australia 1 800 709 465
Austria* 00800 2255 4835
Balcani, Israele, Sudafrica è altri Paesi ISE +41 52 675 3777
Belgio * 00800 2255 4835
Brasile +55 (11) 3530-8901
Canada 1 800 833 9200
Europa Centrale Orientale / Baltiche +41 52 675 3777
Europa Centrale / Grecia +41 52 675 3777
Danimarca +45 80 88 1401
Finlandia +41 52 675 3777
Francia* 00800 2255 4835
Germania * 00800 2255 4835
Hong Kong 400 820 5835
India 000 800 650 1835
Indonesia 007 803 601 5249
Italia 00800 2255 4835
Giappone 81 (3) 6714 3086
Luxembourg +41 52 675 3777
Malaysia 1 800 22 55835
Messicu, America Centrale/Sud è Caraibi 52 (55) 88 69 35 25
Mediu Oriente, Asia è Africa di u Nordu +41 52 675 3777
Paesi Bassi* 00800 2255 4835
Nova Zelanda 0800 800 238
Norvegia 800 16098
Republica Populari Chine 400 820 5835
Filippine 1 800 1601 0077
Pulonia +41 52 675 3777
Portugallu 80 08 12370
Repubblica di Corea +82 2 565 1455
Russia / CIS +7 (495) 6647564
Singapore 800 6011 473
Sudafrica +41 52 675 3777
Spagna* 00800 2255 4835
Svezia* 00800 2255 4835
Svizzera* 00800 2255 4835
Taiwan 886 (2) 2656 6688
Tailanda 1 800 011 931
Regnu Unitu / Irlanda * 00800 2255 4835
USA 1 800 833 9200
Vietnam 12060128
* Numeru europeu gratuitu. Se no
accessibile, chjamate: +41 52 675 3777
Rev. 02.2022

Truvate risorse più preziose in TEK.COM
Copyright © Tektronix. Tutti i diritti riservati. I prudutti Tektronix sò cuparti da brevetti americani è stranieri, emessi è in sospensione. L'infurmazioni in sta publicazione sustituiscenu quella in tuttu u materiale publicatu in precedenza. Specifiche è privilegi di cambiamentu di prezzu riservati. TEKTRONIX è TEK sò marchi registrati di Tektronix, Inc. Tutti l'altri nomi commerciali riferiti sò i marchi di serviziu, marchi o marchi registrati di e so rispettive imprese.
052124 SBG 46W-74037-1

Documenti / Risorse

Tektronix Simplifying Test Automation With tm_ Devices And Python [pdfGuida di l'utente 48W-73878-1, Simplifying Test Automation With tm_ Devices And Python, Test Automation With tm_ Devices And Python, Automation With tm_ Devices And Python, tm_ Dispositivi è Python, Dispositivi è Python, Python

Referenze

• Manuale d'usu