Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, AWS akan menghentikan dukungan untuk. AWS IoT Greengrass Version 1 Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses sumber daya. AWS IoT Greengrass V1 Untuk informasi lebih lanjut, silakan kunjungi [Migrasi dari AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Modbus-TCP Konektor Adaptor Protokol [Konektor](connectors.md) Adaptor Modbus-TCP Protokol mengumpulkan data dari perangkat lokal melalui protokol ModBustCP dan menerbitkannya ke aliran yang dipilih. `StreamManager` Anda juga dapat menggunakan konektor ini dengan konektor IoT dan gateway SiteWise IoT Anda. SiteWise Gateway Anda harus menyediakan konfigurasi untuk konektor. Untuk informasi selengkapnya, lihat [Mengkonfigurasi sumber TCP Modbus](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-modbus-source.html) di panduan pengguna SiteWise IoT. **catatan** Konektor ini berjalan dalam mode [Tanpa isolasi kontainer](lambda-group-config.md#no-container-mode), sehingga Anda dapat menerapkannya ke AWS IoT Greengrass grup yang berjalan di wadah Docker. Konektor ini memiliki versi berikut. | Versi | ARN | | --- | --- | | 3 | `arn:aws:greengrass:{{region}}::/connectors/ModbusTCPConnector/versions/3` | | 2 | `arn:aws:greengrass:{{region}}::/connectors/ModbusTCPConnector/versions/2` | | 1 | `arn:aws:greengrass:{{region}}::/connectors/ModbusTCPConnector/versions/1` | Untuk informasi tentang perubahan versi, lihat [Changelog](#modbus-tcp-connector-changelog). ## Persyaratan Konektor ini memiliki persyaratan sebagai berikut: ------ #### [ Version 1 - 3 ] + AWS IoT Greengrass Perangkat lunak inti v1.10.2 atau yang lebih baru. + Manajer aliran diaktifkan di AWS IoT Greengrass grup. + Java 8 diinstal pada perangkat core dan ditambahkan ke variabel lingkungan `PATH` ini. **catatan** Konektor ini hanya tersedia dalam wilayah berikut: ap-southeast-1 ap-southeast-2 eu-central-1 eu-west-1 us-east-1 us-west-2 cn-north-1 ------ ## Parameter Konektor Konektor ini mendukung parameter berikut: `LocalStoragePath` Direktori pada AWS IoT Greengrass host tempat SiteWise konektor IoT dapat menulis data persisten. Direktori default adalah `/var/sitewise`. Nama tampilan di AWS IoT konsol: **Jalur penyimpanan lokal** Wajib: `false` Jenis: `string` Pola yang valid: `^\s*$|\/.` `MaximumBufferSize` Ukuran maksimum dalam GB untuk penggunaan SiteWise disk IoT. Ukuran default-nya adalah 10GB. Nama tampilan di AWS IoT konsol: Ukuran **buffer disk maksimum** Wajib: `false` Jenis: `string` Pola yang valid: `^\s*$|[0-9]+` `CapabilityConfiguration` Atur konfigurasi kolektor Modbus TCP yang konektor mengumpulkan data dari dan terhubung ke. Nama tampilan di AWS IoT konsol: **CapabilityConfiguration** Wajib: `false` Jenis: Sebuah string JSON terbentuk yang mendefinisikan himpunan konfigurasi umpan balik yang didukung. Berikut ini adalah contoh dari `CapabilityConfiguration`: ``` { "sources": [ { "type": "ModBusTCPSource", "name": "SourceName1", "measurementDataStreamPrefix": "SourceName1_Prefix", "destination": { "type": "StreamManager", "streamName": "SiteWise_Stream_1", "streamBufferSize": 8 }, "endpoint": { "ipAddress": "127.0.0.1", "port": 8081, "unitId": 1 }, "propertyGroups": [ { "name": "GroupName", "tagPathDefinitions": [ { "type": "ModBusTCPAddress", "tag": "TT-001", "address": "30001", "size": 2, "srcDataType": "float", "transformation": "byteWordSwap", "dstDataType": "double" } ], "scanMode": { "type": "POLL", "rate": 100 } } ] } ] } ``` ### Buat Contoh Konektor (AWS CLI) Perintah CLI berikut membuat `ConnectorDefinition` dengan versi awal yang berisi konektor Adaptor Modbus-TCP Protokol. ``` aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version ' { "Connectors": [ { "Id": "MyModbusTCPConnector", "ConnectorArn": "arn:aws:greengrass:{{region}}::/connectors/ModbusTCP/versions/3", "Parameters": { "capability_configuration": "{\"version\":1,\"namespace\":\"iotsitewise:modbuscollector:1\",\"configuration\":\"{\"sources\":[{\"type\":\"ModBusTCPSource\",\"name\":\"SourceName1\",\"measurementDataStreamPrefix\":\"\",\"endpoint\":{\"ipAddress\":\"127.0.0.1\",\"port\":8081,\"unitId\":1},\"propertyGroups\":[{\"name\":\"PropertyGroupName\",\"tagPathDefinitions\":[{\"type\":\"ModBusTCPAddress\",\"tag\":\"TT-001\",\"address\":\"30001\",\"size\":2,\"srcDataType\":\"hexdump\",\"transformation\":\"noSwap\",\"dstDataType\":\"string\"}],\"scanMode\":{\"rate\":200,\"type\":\"POLL\"}}],\"destination\":{\"type\":\"StreamManager\",\"streamName\":\"SiteWise_Stream\",\"streamBufferSize\":10},\"minimumInterRequestDuration\":200}]}\"}" } } ] }' ``` **catatan** Fungsi Lambda dalam konektor mempunyai siklus hidup yang [berumur panjang](lambda-functions.md#lambda-lifecycle) ini. ## Data input Konektor ini tidak menerima pesan MQTT sebagai data input. ## Data output Konektor ini menerbitkan data ke `StreamManager`. Anda harus mengonfigurasi aliran pesan tujuan. Pesan output dari struktur berikut: ``` { "alias": "string", "messages": [ { "name": "string", "value": boolean|double|integer|string, "timestamp": number, "quality": "string" } ] } ``` ## Lisensi Konektor Adaptor Modbus-TCP Protokol mencakup pihak ketiga berikut software/licensing: + Modbus [Petri Digital](https://github.com/digitalpetri/modbus) Konektor ini dirilis di bawah [Perjanjian Lisensi Perangkat lunak core Greengrass](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi konektor. | Versi | Perubahan | Date | | --- | --- | --- | | 3 (disarankan) | Versi ini berisi perbaikan bug. | Desember 22, 2021 | | 2 | Ditambahkan dukungan untuk string sumber dikodekan ASCII, UTF8, dan ISO8859. | 24 Mei 2021 | | 1 | Pelepasan awal. | 15 Desember 2020 | Sebuah grup Greengrass dapat berisi hanya satu versi konektor pada suatu waktu. Untuk informasi lebih lanjut tentang pembaruan versi konektor, lihat [Versi upgrade konektor](connectors.md#upgrade-connector-versions). ## Lihat juga + [Integrasikan dengan layanan dan protokol menggunakan konektor Greengrass](connectors.md) + [Memulai dengan konektor Greengrass (konsol)](connectors-console.md) + [Memulai dengan konektor Greengrass (CLI)](connectors-cli.md)