Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Adaptor protokol Modbus-RTU
Komponen adaptor protokol Modbus-RTU (aws.greengrass.Modbus) mengumpulkan informasi dari perangkat Modbus RTU lokal.
Untuk meminta informasi dari perangkat Modbus RTU lokal dengan komponen ini, publikasikan pesan ke topik di mana komponen ini berlangganan. Dalam pesan, tentukan permintaan Modbus RTU yang akan dikirim ke perangkat. Kemudian, komponen ini akan menerbitkan respon yang berisi hasil permintaan Modbus RTU.
catatan
Komponen ini menyediakan fungsionalitas yang mirip dengan konektor adaptor protokol Modbus RTU di AWS IoT Greengrass V1. Untuk informasi selengkapnya, lihat konektor adaptor protokol RTU Modbus di Panduan Developer V1 AWS IoT Greengrass .
Topik
Versi
Komponen ini memiliki versi berikut:
-
2.1.x
-
2.0.x
Tipe
Komponen ini adalah komponen Lambda () aws.greengrass.lambda. Inti Greengrass menjalankan fungsi Lambda komponen ini menggunakan komponen peluncur Lambda.
Untuk informasi selengkapnya, lihat Jenis komponen.
Sistem operasi
Komponen ini hanya dapat diinstal pada perangkat inti Linux.
Persyaratan
Komponen ini memiliki persyaratan sebagai berikut:
-
Perangkat inti Anda harus memenuhi persyaratan untuk menjalankan fungsi Lambda. Jika Anda ingin perangkat inti untuk menjalankan fungsi Lambda kontainer, perangkat harus memenuhi persyaratan untuk melakukannya. Untuk informasi selengkapnya, lihat Persyaratan fungsi Lambda.
-
Python
versi 3.7 diinstal pada perangkat inti dan ditambahkan ke variabel lingkungan PATH. -
Koneksi fisik antara perangkat AWS IoT Greengrass inti dan perangkat Modbus. Perangkat inti harus terhubung secara fisik ke jaringan Modbus RTU melalui port serial, seperti port USB.
-
Untuk menerima data keluaran dari komponen ini, Anda harus menggabungkan pemutakhiran konfigurasi berikut untuk komponen router langganan lama (aws.greengrass.LegacySubscriptionRouter) saat menerapkan komponen ini. Konfigurasi ini menentukan topik di mana komponen ini menerbitkan tanggapan.
Untuk informasi selengkapnya, lihat Buat deployment.
-
Adaptor protokol Modbus-RTU didukung untuk berjalan di VPC.
Dependensi
Saat Anda menerapkan komponen, gunakan AWS IoT Greengrass juga versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk versi yang dirilis dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di konsol AWS IoT Greengrass
Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.
Konfigurasi
Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen.
catatan
Konfigurasi default komponen ini meliputi parameter fungsi Lambda. Kami sarankan Anda mengedit hanya parameter berikut untuk mengonfigurasi komponen ini pada perangkat Anda.
Data input
Komponen ini menerima parameter permintaan Modbus RTU pada topik berikut dan mengirimkan permintaan Modbus RTU ke perangkat. Secara default, komponen ini berlangganan topik publikasi/berlangganan lokal. Untuk informasi lebih lanjut tentang cara mempublikasikan pesan ke komponen ini dari komponen kustom Anda, lihat Pesan lokal publikasi/berlangganan.
Topik default (publish/subscribe lokal): modbus/adapter/request
Pesan menerima properti berikut. Pesan input harus dalam format JSON.
request-
Parameter untuk permintaan Modbus RTU yang akan dikirim.
Bentuk pesan permintaan tergantung pada jenis Modbus RTU permintaan yang diwakilinya. Properti berikut diperlukan untuk semua permintaan.
Jenis:
objectyang berisi informasi berikut:operation-
Nama operasi yang akan dijalankan. Sebagai contoh, tentukan
ReadCoilsRequestuntuk membaca kumparan pada perangkat Modbus RTU. Untuk informasi lebih lanjut tentang operasi tulis, lihat Permintaan dan tanggapan Modbus RTU.Tipe:
string device-
Perangkat target permintaan.
Nilai ini harus berupa bilangan bulat antara
0dan247.Tipe:
integer
Parameter lain yang akan tercakup dalam permintaan tergantung pada operasi. Komponen ini menangani pemeriksaan redundansi siklik (CRC)
untuk memverifikasi permintaan data untuk Anda. catatan
Jika permintaan Anda mencakup properti
address, Anda harus menentukan nilainya sebagai bilangan bulat. Misalnya,"address": 1. id-
ID acak untuk permintaan. Gunakan properti ini untuk memetakan permintaan inpun untuk respons output. Ketika Anda menentukan properti ini, komponen menetapkan properti
iddi objek respons untuk nilai ini.Tipe:
string
contoh Contoh input: Baca permintaan kumparan
{ "request": { "operation": "ReadCoilsRequest", "device": 1, "address": 1, "count": 1 }, "id": "MyRequest" }
Data output
Komponen ini menerbitkan tanggapan sebagai data output pada topik MQTT berikut secara default. Anda harus menentukan topik ini sebagai subject dalam konfigurasi untuk komponen router langganan warisan. Untuk informasi lebih lanjut tentang cara mempublikasikan pesan ke komponen ini dari komponen kustom Anda, lihat Terbitkan/berlangganan pesan MQTT AWS IoT Core.
Topik default (AWS IoT Core MQTT): modbus/adapter/response
Bentuk pesan respon tergantung pada operasi permintaan dan status respon. Sebagai contoh, lihat Contoh permintaan dan respons.
Setiap respons mencakup properti berikut:
response-
Respons dari perangkat Modbus RTU.
Jenis:
objectyang berisi informasi berikut:status-
Status HTTP dari permintaan. Nilai bisa jadi salah satu dari yang berikut:
-
Success— Permintaannya valid, komponen mengirim permintaan ke jaringan Modbus RTU, dan jaringan RTU Modbus mengembalikan respons. -
Exception— Permintaannya valid, komponen mengirim permintaan ke jaringan Modbus RTU, dan jaringan RTU Modbus mengembalikan pengecualian. Untuk informasi selengkapnya, lihat Status respons: Pengecualian. -
No Response— Permintaan tidak valid, dan komponen menangkap kesalahan sebelum mengirim permintaan ke jaringan Modbus RTU. Untuk informasi selengkapnya, lihat Status respon: Tidak ada respon.
-
operation-
Operasi yang diminta komponen.
device-
Perangkat tempat komponen mengirim permintaan.
payload-
Respons dari perangkat Modbus RTU. Jika
statusadalahNo Response, objek ini hanya akan berisi propertierrordengan deskripsi kesalahan (misalnya,[Input/Output] No Response received from the remote unit).
id-
ID dari permintaan, yang dapat Anda gunakan untuk mengidentifikasi respons yang sesuai dengan yang diminta.
catatan
Sebuah respons untuk operasi write hanyalah pengulangan dari permintaan. Meskipun tanggapan write tidak mencakup informasi yang berarti, ia merupakan praktik yang baik untuk memeriksa status respons untuk melihat apakah permintaan berhasil atau gagal.
contoh Contoh output: Berhasil
{ "response" : { "status" : "success", "device": 1, "operation": "ReadCoilsRequest", "payload": { "function_code": 1, "bits": [1] } }, "id" : "MyRequest" }
contoh Contoh output: Gagal
{ "response" : { "status" : "fail", "error_message": "Internal Error", "error": "Exception", "device": 1, "operation": "ReadCoilsRequest", "payload": { "function_code": 129, "exception_code": 2 } }, "id" : "MyRequest" }
Untuk contoh lainnya, lihat Contoh permintaan dan respons.
Permintaan dan tanggapan Modbus RTU
Konektor ini menerima parameter permintaan Modbus RTU sebagai data input dan menerbitkan tanggapan sebagai data output.
Operasi umum berikut ini didukung.
| Nama operasi dalam permintaan | Kode fungsi dalam respons |
|---|---|
| ReadCoilsRequest | 01 |
| ReadDiscreteInputsRequest | 02 |
| ReadHoldingRegistersRequest | 03 |
| ReadInputRegistersRequest | 04 |
| WriteSingleCoilRequest | 05 |
| WriteSingleRegisterRequest | 06 |
| WriteMultipleCoilsRequest | 15 |
| WriteMultipleRegistersRequest | 16 |
| MaskWriteRegisterRequest | 22 |
| ReadWriteMultipleRegistersRequest | 23 |
Berikut ini adalah contoh permintaan dan tanggapan untuk operasi yang didukung.
- Baca kumparan
-
Contoh permintaan:
{ "request": { "operation": "ReadCoilsRequest", "device": 1, "address": 1, "count": 1 }, "id": "TestRequest" }Contoh respons:
{ "response": { "status": "success", "device": 1, "operation": "ReadCoilsRequest", "payload": { "function_code": 1, "bits": [1] } }, "id" : "TestRequest" } - Baca input diskrit
-
Contoh permintaan:
{ "request": { "operation": "ReadDiscreteInputsRequest", "device": 1, "address": 1, "count": 1 }, "id": "TestRequest" }Contoh respons:
{ "response": { "status": "success", "device": 1, "operation": "ReadDiscreteInputsRequest", "payload": { "function_code": 2, "bits": [1] } }, "id" : "TestRequest" } - Baca register yang memiliki
-
Contoh permintaan:
{ "request": { "operation": "ReadHoldingRegistersRequest", "device": 1, "address": 1, "count": 1 }, "id": "TestRequest" }Contoh respons:
{ "response": { "status": "success", "device": 1, "operation": "ReadHoldingRegistersRequest", "payload": { "function_code": 3, "registers": [20,30] } }, "id" : "TestRequest" } - Baca register input
-
Contoh permintaan:
{ "request": { "operation": "ReadInputRegistersRequest", "device": 1, "address": 1, "count": 1 }, "id": "TestRequest" } - Tulis kumparan tunggal
-
Contoh permintaan:
{ "request": { "operation": "WriteSingleCoilRequest", "device": 1, "address": 1, "value": 1 }, "id": "TestRequest" }Contoh respons:
{ "response": { "status": "success", "device": 1, "operation": "WriteSingleCoilRequest", "payload": { "function_code": 5, "address": 1, "value": true } }, "id" : "TestRequest" } - Tulis register tunggal
-
Contoh permintaan:
{ "request": { "operation": "WriteSingleRegisterRequest", "device": 1, "address": 1, "value": 1 }, "id": "TestRequest" } - Tulis beberapa kumparan
-
Contoh permintaan:
{ "request": { "operation": "WriteMultipleCoilsRequest", "device": 1, "address": 1, "values": [1,0,0,1] }, "id": "TestRequest" }Contoh respons:
{ "response": { "status": "success", "device": 1, "operation": "WriteMultipleCoilsRequest", "payload": { "function_code": 15, "address": 1, "count": 4 } }, "id" : "TestRequest" } - Tulis beberapa register
-
Contoh permintaan:
{ "request": { "operation": "WriteMultipleRegistersRequest", "device": 1, "address": 1, "values": [20,30,10] }, "id": "TestRequest" }Contoh respons:
{ "response": { "status": "success", "device": 1, "operation": "WriteMultipleRegistersRequest", "payload": { "function_code": 23, "address": 1, "count": 3 } }, "id" : "TestRequest" } - Register mask write
-
Contoh permintaan:
{ "request": { "operation": "MaskWriteRegisterRequest", "device": 1, "address": 1, "and_mask": 175, "or_mask": 1 }, "id": "TestRequest" }Contoh respons:
{ "response": { "status": "success", "device": 1, "operation": "MaskWriteRegisterRequest", "payload": { "function_code": 22, "and_mask": 0, "or_mask": 8 } }, "id" : "TestRequest" } - Baca tulis beberapa register
-
Contoh permintaan:
{ "request": { "operation": "ReadWriteMultipleRegistersRequest", "device": 1, "read_address": 1, "read_count": 2, "write_address": 3, "write_registers": [20,30,40] }, "id": "TestRequest" }Contoh respons:
{ "response": { "status": "success", "device": 1, "operation": "ReadWriteMultipleRegistersRequest", "payload": { "function_code": 23, "registers": [10,20,10,20] } }, "id" : "TestRequest" }catatan
Tanggapan meliputi register yang dibaca komponen.
Pengecualian dapat terjadi bila format permintaan valid, tetapi permintaan tersebut tidak berhasil diselesaikan. Dalam kasus ini, respons berisi informasi berikut:
-
statusditetapkan keException. -
function_codesama dengan kode fungsi permintaan + 128. -
exception_codeberisi kode pengecualian. Untuk informasi selengkapnya, lihat kode pengecualian Modbus.
Contoh:
{ "response": { "status": "fail", "error_message": "Internal Error", "error": "Exception", "device": 1, "operation": "ReadCoilsRequest", "payload": { "function_code": 129, "exception_code": 2 } }, "id": "TestRequest" }
Konektor ini melakukan pemeriksaan validasi pada permintaan Modbus. Sebagai contoh, ia memeriksa format yang tidak sah dan kolom yang hilang. Jika validasi gagal, konektor tidak akan mengirim permintaan. Sebaliknya, ia mengembalikan respon yang berisi informasi berikut:
-
statusditetapkan keNo Response. -
errorberisi alasan kesalahan. -
error_messageberisi pesan kesalahan.
Contoh:
{ "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" }
Jika permintaan menargetkan perangkat yang tidak ada atau jika jaringan Modbus RTU tidak berfungsi, Anda mungkin mendapatkan ModbusIOException, yang menggunakan format No Response.
{ "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 log lokal
Komponen ini menggunakan file log berikut.
/logs/aws.greengrass.Modbus.log/greengrass/v2
Untuk melihat log komponen ini
-
Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti
/greengrass/v2sudo tail -f/greengrass/v2
Lisensi
Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut:
Komponen ini dirilis menurut Perjanjian Lisensi Perangkat Lunak Greengrass Core
Changelog
Tabel berikut menjelaskan perubahan dalam setiap versi komponen.
|
Versi |
Perubahan |
|---|---|
|
2.1.8 |
Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. |
|
2.1.7 |
Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. |
|
2.1.6 |
Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. |
|
2.1.5 |
|
|
2.1.4 |
Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. |
|
2.1.3 |
Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. |
|
2.1.2 |
Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. |
|
2.1.1 |
Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. |
|
2.1.0 |
|
|
2.0.8 |
Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. |
|
2.0.7 |
Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. |
|
2.0.6 |
Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. |
|
2.0.5 |
Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. |
|
2.0.4 |
Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0. |
|
2.0.3 |
Versi awal. |
