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à.
Modbus-RTU adattatore di protocollo
Il componente dell'adattatore di Modbus-RTU protocollo (aws.greengrass.Modbus) raccoglie le informazioni dai dispositivi Modbus RTU locali.
Per richiedere informazioni a un dispositivo Modbus RTU locale con questo componente, pubblica un messaggio nell'argomento a cui questo componente è abbonato. Nel messaggio, specifica la richiesta Modbus RTU da inviare a un dispositivo. Quindi, questo componente pubblica una risposta che contiene il risultato della richiesta Modbus RTU.
Nota
Questo componente offre funzionalità simili al connettore dell'adattatore di protocollo Modbus RTU in V1. AWS IoT Greengrass Per ulteriori informazioni, vedere il connettore dell'adattatore di protocollo Modbus RTU nella V1 Developer Guide. AWS IoT Greengrass
Argomenti
Versioni
Questo componente ha le seguenti versioni:
-
2.1.x
-
2.0.x
Tipo
Questo componente è un componente Lambda (aws.greengrass.lambda). Il nucleo di Greengrass esegue la funzione Lambda di questo componente utilizzando il componente di avvio Lambda.
Per ulteriori informazioni, consulta Tipi di componenti.
Sistema operativo
Questo componente può essere installato solo su dispositivi Linux core.
Requisiti
Questo componente ha i seguenti requisiti:
-
Il dispositivo principale deve soddisfare i requisiti per eseguire le funzioni Lambda. Se desideri che il dispositivo principale esegua funzioni Lambda containerizzate, il dispositivo deve soddisfare i requisiti per farlo. Per ulteriori informazioni, consulta Requisiti della funzione Lambda.
-
La
versione 3.7 di Python è stata installata sul dispositivo principale e aggiunta alla variabile di ambiente PATH. -
Una connessione fisica tra il dispositivo AWS IoT Greengrass principale e i dispositivi Modbus. Il dispositivo principale deve essere connesso fisicamente alla rete Modbus RTU tramite una porta seriale, ad esempio una porta USB.
-
Per ricevere i dati di output da questo componente, è necessario unire il seguente aggiornamento di configurazione per il vecchio componente router in abbonamento (
aws.greengrass.LegacySubscriptionRouter) quando si distribuisce questo componente. Questa configurazione specifica l'argomento in cui questo componente pubblica le risposte.Per ulteriori informazioni, consulta Creare distribuzione.
-
L'adattatore di Modbus-RTU protocollo è supportato per l'esecuzione in un VPC.
Dipendenze
Quando si distribuisce un componente, vengono distribuite AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti del componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni rilasciate di questo componente e i vincoli semantici della versione che definiscono le versioni dei componenti per ciascuna dipendenza. È inoltre possibile visualizzare le dipendenze per ciascuna versione del componente nella console. AWS IoT Greengrass
Per ulteriori informazioni sulle dipendenze dei componenti, consultate il riferimento alla composizione dei componenti.
Configurazione
Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.
Nota
La configurazione predefinita di questo componente include i parametri della funzione Lambda. Ti consigliamo di modificare solo i seguenti parametri per configurare questo componente sui tuoi dispositivi.
Dati di input
Questo componente accetta i parametri di richiesta Modbus RTU sull'argomento seguente e invia la richiesta Modbus RTU al dispositivo. Per impostazione predefinita, questo componente si iscrive ai messaggi locali. publish/subscribe Per ulteriori informazioni su come pubblicare messaggi su questo componente dai componenti personalizzati, vederePubblicare/sottoscrivere messaggi locali.
Argomento predefinito (locale publish/subscribe): modbus/adapter/request
Il messaggio accetta le seguenti proprietà. I messaggi di input devono essere in formato JSON.
request-
I parametri per l'invio della richiesta Modbus RTU.
La forma del messaggio di richiesta dipende dal tipo di richiesta Modbus RTU che rappresenta. Le seguenti proprietà sono obbligatorie per tutte le richieste.
Tipo:
objectche contiene le seguenti informazioni:operation-
Il nome dell'operazione da eseguire. Ad esempio, specifica
ReadCoilsRequestdi leggere le bobine su un dispositivo Modbus RTU. Per ulteriori informazioni sulle operazioni supportate, vedere. Richieste e risposte RTU ModbusTipo:
string device-
Il dispositivo di destinazione della richiesta.
Questo valore deve essere un numero intero compreso tra
0e247.Tipo:
integer
Gli altri parametri di includere nella richiesta variano a seconda dell'operazione. Questo componente gestisce il controllo di ridondanza ciclica (CRC)
per verificare le richieste di dati per te. Nota
Se la richiesta include una
addressproprietà, è necessario specificarne il valore come numero intero. Ad esempio,"address": 1. id-
Un ID arbitrario della richiesta. Utilizzate questa proprietà per mappare una richiesta di input a una risposta di output. Quando si specifica questa proprietà, il componente imposta la
idproprietà nell'oggetto di risposta su questo valore.Tipo:
string
Esempio Esempio di input: richiesta lettura nastri
{ "request": { "operation": "ReadCoilsRequest", "device": 1, "address": 1, "count": 1 }, "id": "MyRequest" }
Dati di output
Per impostazione predefinita, questo componente pubblica le risposte come dati di output sul seguente argomento MQTT. È necessario specificare questo argomento come subject nella configurazione per il componente router in abbonamento legacy. Per ulteriori informazioni su come sottoscrivere i messaggi su questo argomento nei componenti personalizzati, vederePublish/subscribe AWS IoT Core Messaggi MQTT.
Argomento predefinito (AWS IoT Core MQTT): modbus/adapter/response
La forma del messaggio di risposta dipende dall'operazione della richiesta e dallo stato della risposta. Per alcuni esempi, consulta Richieste e risposte di esempio.
Ogni risposta include le seguenti proprietà:
response-
La risposta del dispositivo Modbus RTU.
Tipo:
objectche contiene le seguenti informazioni:status-
Stato della richiesta. Lo stato può avere uno dei seguenti valori:
-
Success— La richiesta era valida, il componente ha inviato la richiesta alla rete Modbus RTU e la rete Modbus RTU ha restituito una risposta. -
Exception— La richiesta era valida, il componente ha inviato la richiesta alla rete Modbus RTU e la rete Modbus RTU ha restituito un'eccezione. Per ulteriori informazioni, consulta Stato risposta: eccezione. -
No Response— La richiesta non era valida e il componente ha rilevato l'errore prima di inviare la richiesta alla rete Modbus RTU. Per ulteriori informazioni, consulta Stato risposta: nessuna risposta.
-
operation-
L'operazione richiesta dal componente.
device-
Il dispositivo in cui il componente ha inviato la richiesta.
payload-
La risposta del dispositivo Modbus RTU. Se
statusèNo Response, questo oggetto contiene solo unaerrorproprietà con la descrizione dell'errore (ad esempio,[Input/Output] No Response received from the remote unit).
id-
L'ID della richiesta, che puoi utilizzare per identificare quale risposta corrisponde a quale richiesta.
Nota
Una risposta a un'operazione di scrittura è semplicemente un eco della richiesta. Sebbene le risposte scritte non includano informazioni significative, è buona norma controllare lo stato della risposta per vedere se la richiesta ha esito positivo o negativo.
Esempio Output di esempio: Operazione riuscita
{ "response" : { "status" : "success", "device": 1, "operation": "ReadCoilsRequest", "payload": { "function_code": 1, "bits": [1] } }, "id" : "MyRequest" }
Esempio Esempio di output: Errore
{ "response" : { "status" : "fail", "error_message": "Internal Error", "error": "Exception", "device": 1, "operation": "ReadCoilsRequest", "payload": { "function_code": 129, "exception_code": 2 } }, "id" : "MyRequest" }
Per ulteriori esempi, consulta Richieste e risposte di esempio.
Richieste e risposte RTU Modbus
Questo connettore accetta i parametri della richiesta RTU Modbus come dati di input e pubblica le risposte come dati di output.
Sono supportate le seguenti operazioni comuni.
| Nome dell'operazione nella richiesta | Codice della funzione in risposta |
|---|---|
| ReadCoilsRequest | 01 |
| ReadDiscreteInputsRequest | 02 |
| ReadHoldingRegistersRequest | 03 |
| ReadInputRegistersRequest | 04 |
| WriteSingleCoilRequest | 05 |
| WriteSingleRegisterRequest | 06 |
| WriteMultipleCoilsRequest | 15 |
| WriteMultipleRegistersRequest | 16 |
| MaskWriteRegisterRequest | 22 |
| ReadWriteMultipleRegistersRequest | 23 |
Di seguito sono riportate alcune richieste e risposte di esempio per le operazioni supportate.
- Leggi le bobine
-
Esempio di richiesta:
{ "request": { "operation": "ReadCoilsRequest", "device": 1, "address": 1, "count": 1 }, "id": "TestRequest" }Esempio di risposta:
{ "response": { "status": "success", "device": 1, "operation": "ReadCoilsRequest", "payload": { "function_code": 1, "bits": [1] } }, "id" : "TestRequest" } - Leggi gli ingressi discreti
-
Esempio di richiesta:
{ "request": { "operation": "ReadDiscreteInputsRequest", "device": 1, "address": 1, "count": 1 }, "id": "TestRequest" }Esempio di risposta:
{ "response": { "status": "success", "device": 1, "operation": "ReadDiscreteInputsRequest", "payload": { "function_code": 2, "bits": [1] } }, "id" : "TestRequest" } - Leggi i registri di attesa
-
Esempio di richiesta:
{ "request": { "operation": "ReadHoldingRegistersRequest", "device": 1, "address": 1, "count": 1 }, "id": "TestRequest" }Esempio di risposta:
{ "response": { "status": "success", "device": 1, "operation": "ReadHoldingRegistersRequest", "payload": { "function_code": 3, "registers": [20,30] } }, "id" : "TestRequest" } - Leggi i registri di input
-
Esempio di richiesta:
{ "request": { "operation": "ReadInputRegistersRequest", "device": 1, "address": 1, "count": 1 }, "id": "TestRequest" } - Scrivi una bobina
-
Esempio di richiesta:
{ "request": { "operation": "WriteSingleCoilRequest", "device": 1, "address": 1, "value": 1 }, "id": "TestRequest" }Esempio di risposta:
{ "response": { "status": "success", "device": 1, "operation": "WriteSingleCoilRequest", "payload": { "function_code": 5, "address": 1, "value": true } }, "id" : "TestRequest" } - Scrivi un registro singolo
-
Esempio di richiesta:
{ "request": { "operation": "WriteSingleRegisterRequest", "device": 1, "address": 1, "value": 1 }, "id": "TestRequest" } - Scrivi più bobine
-
Esempio di richiesta:
{ "request": { "operation": "WriteMultipleCoilsRequest", "device": 1, "address": 1, "values": [1,0,0,1] }, "id": "TestRequest" }Esempio di risposta:
{ "response": { "status": "success", "device": 1, "operation": "WriteMultipleCoilsRequest", "payload": { "function_code": 15, "address": 1, "count": 4 } }, "id" : "TestRequest" } - Scrivere più registri
-
Esempio di richiesta:
{ "request": { "operation": "WriteMultipleRegistersRequest", "device": 1, "address": 1, "values": [20,30,10] }, "id": "TestRequest" }Esempio di risposta:
{ "response": { "status": "success", "device": 1, "operation": "WriteMultipleRegistersRequest", "payload": { "function_code": 23, "address": 1, "count": 3 } }, "id" : "TestRequest" } - Maschera: registro di scrittura
-
Esempio di richiesta:
{ "request": { "operation": "MaskWriteRegisterRequest", "device": 1, "address": 1, "and_mask": 175, "or_mask": 1 }, "id": "TestRequest" }Esempio di risposta:
{ "response": { "status": "success", "device": 1, "operation": "MaskWriteRegisterRequest", "payload": { "function_code": 22, "and_mask": 0, "or_mask": 8 } }, "id" : "TestRequest" } - Leggi e scrivi più registri
-
Esempio di richiesta:
{ "request": { "operation": "ReadWriteMultipleRegistersRequest", "device": 1, "read_address": 1, "read_count": 2, "write_address": 3, "write_registers": [20,30,40] }, "id": "TestRequest" }Esempio di risposta:
{ "response": { "status": "success", "device": 1, "operation": "ReadWriteMultipleRegistersRequest", "payload": { "function_code": 23, "registers": [10,20,10,20] } }, "id" : "TestRequest" }Nota
La risposta include i registri letti dal componente.
Le eccezioni possono verificarsi se il formato della richiesta è valido, ma la richiesta non è stata completata. In questo caso, la risposta contiene le seguenti informazioni:
-
Il
statusè impostato suException. -
function_codeè pari al codice della funzione della richiesta + 128. -
exception_codecontiene il codice dell'eccezione. Per ulteriori informazioni sull'eccezione , consulta Codici delle eccezioni Modbus.
Esempio:
{ "response": { "status": "fail", "error_message": "Internal Error", "error": "Exception", "device": 1, "operation": "ReadCoilsRequest", "payload": { "function_code": 129, "exception_code": 2 } }, "id": "TestRequest" }
Questo connettore esegue controlli di convalida sulla richiesta Modbus. Ad esempio, verifica l'eventuale presenza di formati non validi e campi non compilati. Se la convalida ha esito negativo, il connettore non invia la richiesta. Al contrario, restituirà una risposta contenente le seguenti informazioni:
-
Il
statusè impostato suNo Response. -
errorcontiene il motivo dell'errore. -
error_messagecontiene il messaggio dell'errore.
Esempi:
{ "response": { "status": "fail", "error_message": "Invalid address field. Expected <type 'int'>, got <type 'str'>", "error": "No Response", "device": 1, "operation": "ReadCoilsRequest", "payload": { "error": "Invalid address field. Expected Expected <type 'int'>, got <type 'str'>" } }, "id": "TestRequest" }
Se la richiesta è destinata a un dispositivo inesistente o se la rete RTU Modbus non funziona, potrebbe venire restituito ModbusIOException, che utilizza il formato Nessuna risposta.
{ "response": { "status": "fail", "error_message": "[Input/Output] No Response received from the remote unit", "error": "No Response", "device": 1, "operation": "ReadCoilsRequest", "payload": { "error": "[Input/Output] No Response received from the remote unit" } }, "id": "TestRequest" }
File di registro locale
Questo componente utilizza il seguente file di registro.
/logs/aws.greengrass.Modbus.log/greengrass/v2
Per visualizzare i log di questo componente
-
Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituiscilo
/greengrass/v2sudo tail -f/greengrass/v2
Licenze
Questo componente include le seguenti terze parti software/licensing:
Questo componente è rilasciato in base al contratto di licenza software Greengrass Core.
Changelog
La tabella seguente descrive le modifiche in ciascuna versione del componente.
|
Versione |
Modifiche |
|---|---|
|
2.1.11 |
Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. |
|
2.1.10 |
Versione aggiornata per la versione 2.14.0 di Greengrass nucleus. |
|
2.1.9 |
Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. |
|
2.1.8 |
Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. |
|
2.1.7 |
Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. |
|
2.1.6 |
Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. |
|
2.1.5 |
|
|
2.1.4 |
Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. |
|
2.1.3 |
Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. |
|
2.1.2 |
Versione aggiornata per la versione 2.7.0 di Greengrass nucleus. |
|
2.1.1 |
Versione aggiornata per la versione 2.6.0 di Greengrass nucleus. |
|
2.1.0 |
|
|
2.0.8 |
Versione aggiornata per la versione 2.5.0 di Greengrass nucleus. |
|
2.0.7 |
Versione aggiornata per la versione 2.4.0 di Greengrass nucleus. |
|
2.0.6 |
Versione aggiornata per la versione 2.3.0 di Greengrass nucleus. |
|
2.0.5 |
Versione aggiornata per la versione 2.2.0 di Greengrass nucleus. |
|
2.0.4 |
Versione aggiornata per la versione 2.1.0 di Greengrass nucleus. |
|
2.0.3 |
Versione iniziale. |
