Comando start_control_#
Important
Funzione Expert
La gestione delle telecamere di controllo (Control Camera) è una funzione Expert: richiede conoscenza di Cognex VisionPro e degli script C#, ed è destinata a utenti esperti. Per informazioni sulla modalità Expert, consultare Cosa è e Quando Serve.
Note
Prerequisiti
Il comando start_control_ richiede una telecamera di controllo configurata e uno script VisionPro caricato. Consultare Telecamere di Controllo. Disponibile dalla versione software v0.24.
Il comando start_control_ consente al robot di richiedere un’ispezione visiva con una telecamera di controllo. Il robot può aggiungere un parametro testuale, che FlexiVision inoltra allo script VisionPro.
Formato del comando#
start_control_<parametro>
L’underscore finale del prefisso è obbligatorio. Il parametro può essere vuoto oppure contenere numeri, lettere e ulteriori underscore.
Comando inviato dal robot |
Testo ricevuto da VisionPro |
Comportamento dello script di esempio |
|---|---|---|
|
|
Esegue entrambi i PMRedLine |
|
|
Esegue solo PMRedLine 1 |
|
|
Esegue solo PMRedLine 2 |
|
|
Parametro personalizzato: richiede logica dedicata nello script |
Important
Il parametro è trattato come testo. FlexiVision non attribuisce alcun significato a valori come ABC_123: è lo script VisionPro del cliente che deve interpretarli.
Note
Anche start_control_ 1 viene letto come parametro "1": gli spazi all’inizio e alla fine vengono eliminati. Per evitare ambiguità si raccomanda di inviare start_control_1, senza spazi.
Il prefisso start_control_ non viene passato allo script: arriva soltanto la parte successiva (ad esempio "2" per start_control_2).
Il comando può essere eseguito anche senza robot connesso dall’HMI tramite Test Tool; in tal caso il risultato è mostrato nell’HMI ma non viene trasmesso via TCP.
Risposta al robot#
La risposta è la stringa Output_String prodotta dallo script VisionPro. Il formato mostrato di seguito è quello dello script di esempio e può essere adattato al protocollo richiesto dal robot.
Situazione |
Esempio di Output_String |
|---|---|
Oggetto trovato |
|
Nessun oggetto trovato |
|
Entrambi i tool eseguiti |
|
Parametro non previsto |
|
Errore al tool 2 |
|
Per ogni tool eseguito viene utilizzato soltanto il primo oggetto riconosciuto. Se sono eseguiti entrambi i tool, le risposte sono precedute dai prefissi 1: e 2: e separate da |.
Note
XeYsono espressi nel sistema di coordinate configurato nello strumento VisionPro (pixel o unità calibrate): non sono automaticamente in millimetri.Rzè espresso in gradi.Tre cifre decimali; il punto è sempre usato come separatore decimale, indipendentemente dalla lingua di Windows.
Not_Found ed errori#
Not_Found non è un errore: indica che il tool è stato eseguito ma non ha trovato alcun oggetto. Gli errori degli script di controllo iniziano sempre con il prefisso #Error_Control_; gli errori della telecamera possono essere comunicati separatamente con il prefisso #Error_Camera. Se almeno un tool produce un errore di esecuzione, lo script scrive l’errore all’inizio della risposta (nell’esempio ha priorità il tool 1).
L’elenco completo dei messaggi e delle azioni consigliate è disponibile in Risoluzione problemi – Telecamere di Controllo.
Esempi di scambio#
Caso A – solo Locator 2
Comando inviato dal robot: start_control_2. VisionPro riceve Input_Control = "2", esegue CogPMRedLineTool2, legge X, Y e Rz del primo risultato e produce la risposta testuale. Il display mostra il record del Tool 2.
Caso B – due Locator
Comando inviato: start_control_. VisionPro riceve una stringa vuota ed esegue entrambi i tool. La risposta contiene due sezioni, una per ogni locator. Il record dell’immagine proviene dal Tool 1, salvo diversa scelta nello script.
Caso C – parametro applicativo
Comando inviato: start_control_ABC_123. Il parametro raggiunge VisionPro senza essere interpretato da FlexiVision. Lo script di esempio risponde #Error_Control_INVALID_CONTROL; per usarlo come comando reale occorre aggiungere la relativa logica nello script C#.
Tip
Per l’elenco completo dei comandi robot, consultare Protocollo Comunicazione Robot-Visione.