Funzione che permette di scrivere un parametro SoE (scrittura del parametro stru.idn sul dispositivo identificato da stru.rid e informazioni prese in source).
La scrittura può avvenire in modo passante o in modo bloccante (utilizzabile solo nei task 1-:-8).
Per modo passante si intende che la funzione deve essere continuamente chiamata e questa rende lo stato attuale dell'operazione.
Per modo bloccante si intende che la funzione viene invocata e ritorna solo quando ha completato l'operazione di scrittura.
La funzione rende un esito sullo stato dell'esecuzione.
NOTA: Per scrivere comandi alle procedure SoE, impostare stru.cmd al valore interessato (vedi direttiva soe_widn).
Sintassi |
i32 soe_widn (stru_soe_idn stru, source) |
|---|---|
stru |
Struttura di tipo stru_soe_idn contenente le informazione per la scrittura di un parametro SoE. |
source |
Contiene il valore da scrivere. source deve essere un oggetto compatibile con i dati che si stanno scrivendo (se si scrive una VISIBLE STRING, source sarà di tipo string, se si scrive un OCTET_STRING sarà un array di byte o una struttura). In caso di scrittura di array verranno gestite solo informazioni la cui lunghezza è <= a 256 byte. Dovendo scrivere informazioni di maggior dimensione utilizzare come tipo dati OCTET_STRING e fornire un buffer di souce sufficientemente grande (ovviamente l'interpretazione dei dati è a carico dell'applicativo). |
Risultato |
Variabile contenente il risultato. Vedi gestione passante e/o bloccante. |
Validità |
Rule, Task. |
Requisiti di sistema |
RTE 34.18.3 |
Note |
•Imporre stru.phase = 1 per inizializzare la scrittura. •Se non specificato il tipo di dato (stru.dataType=0), viene eseguita la lettura del tipo di dato su dispositivo remoto. La variabile stru.phase viene cambiata. •Il comando di scrittura viene inviato al dispositivo remoto e si attende risposta. La variabile stru.phase viene cambiata. •Attesa della risposta. •Ricezione risposta con esito positivo. RTE cambia stru.phase = 4. •Ricezione risposta con esito negativo. RTE cambia stru.phase = 0. o-2, gestore comunicazione occupato o-3, crash gestore comunicazione (riavvio) o-5, comando a un dispositivo non presente (stru.rid) o-6, nessuna operazione in esecuzione. stru.phase non inizializzata o-12, valore illegale di idn (allarme 9900 arg 12) o-13, valore illegale di element/cmd (allarme 9900 arg 13) o-14, valore illegale di datatype (allarme 9900 arg 4/arg 14) o-15, valore illegale di datalen (allarme 9900 arg 5/arg 15) o-16, valore illegale di phase (allarme 9900 arg 6) o-21, destinazione non specificata (allarme 9900 arg 16) o-22, destinazione cambiata (allarme 9900 arg 32) o-23, errore software o2, comando di cui si è già ricevuto risposta positiva, valore disponibile in destination o>2, codice di errore SDO, vedi tabella sotto |
•Imporre stru.phase = -1 per eseguire la scrittura. •Se non specificato il tipo di dato (stru.dataType=0), viene eseguita la lettura del tipo di dato su dispositivo remoto. La variabile stru.phase viene cambiata. •Il comando di scrittura viene inviato al dispositivo remoto e si attende risposta. La variabile stru.phase viene cambiata. •Attesa della risposta. Se la risposta non arriva entro un massimo di 3 secondi la funzione esce con un errore (timeout, rende -2). •Ricezione risposta con esito positivo. RTE cambia stru.phase = 4. •Ricezione risposta con esito negativo. RTE cambia stru.phase = 0. o-2, gestore comunicazione occupato o-3, crash gestore comunicazione (riavvio) o-4, gestione bloccante non permessa nel task corrente (stru.phase = 1) (rule, ladder). Comando non accettato o-5, comando a un dispositivo non presente (stru.rid) o-6, nessuna operazione in esecuzione. stru.phase non inizializzata o-12, valore illegale di idn (allarme 9900 arg 12) o-13, valore illegale di element/cmd (allarme 9900 arg 13) o-14, valore illegale di datatype (allarme 9900 arg 4/arg 14) o-15, valore illegale di datalen (allarme 9900 arg 5/arg 15) o-16, valore illegale di phase (allarme 9900 arg 6) o-21, destinazione non specificata (allarme 9900 arg 16) o-22, destinazione cambiata (allarme 9900 arg 32) o-23, errore software o2, comando di cui si è già ricevuto risposta positiva, valore disponibile in destination o>2, codice di errore SDO, vedi tabella sotto |
Vedi esempio per funzione soe_ridn(). |
