Konektor Adaptor Protokol Modbus-TCP - AWS IoT Greengrass

AWS IoT Greengrass Version 1 memasuki fase umur panjang pada 30 Juni 2023. Untuk informasi selengkapnya, lihat kebijakan AWS IoT Greengrass V1 pemeliharaan. Setelah tanggal ini, tidak AWS IoT Greengrass V1 akan merilis pembaruan yang menyediakan fitur, penyempurnaan, perbaikan bug, atau patch keamanan. Perangkat yang berjalan AWS IoT Greengrass V1 tidak akan terganggu dan akan terus beroperasi dan terhubung ke cloud. Kami sangat menyarankan Anda bermigrasi ke AWS IoT Greengrass Version 2, yang menambahkan fitur baru yang signifikan dan dukungan untuk platform tambahan.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Konektor Adaptor Protokol Modbus-TCP

Konektor Adaptor Protokol Modbus-TCP mengumpulkan data dari perangkat lokal melalui protokol ModBustCP dan menerbitkannya ke aliran StreamManager yang dipilih.

Anda juga dapat menggunakan konektor ini dengan IoT SiteWise konektor dan IoT Anda SiteWise gateway. Gateway Anda harus menyediakan konfigurasi untuk konektor. Untuk informasi selengkapnya, lihatMengkonfigurasi sumber Modbus TCPdalam IoT SiteWise panduan pengguna.

catatan

Konektor ini berjalan dalam mode isolasi Tanpa kontainer ini, sehingga Anda dapat men-deploy ke grup AWS IoT Greengrass yang berjalan pada kontainer 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.

Persyaratan

Konektor ini memiliki persyaratan sebagai berikut:

Version 1 - 3
  • AWS IoT Greengrass perangkat lunak Core v1.10.2 atau yang lebih baru.

  • Pengelola streaming diaktifkan pada 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 diAWS IoT Greengrasshost bahwa IoT SiteWise konektor dapat menulis data persisten untuk. Direktori default adalah /var/sitewise.

Nama tampilan dalamAWS IoTKonsol: Jalur penyimpanan lokal

Wajib: false

Jenis: string

Pola yang valid: ^\s*$|\/.

MaximumBufferSize

Ukuran maksimum dalam GB untuk IoT SiteWise penggunaan disk. Ukuran default-nya adalah 10GB.

Nama tampilan dalamAWS IoTKonsol: 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 dalamAWS IoTKonsol: 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 Protokol Modbus-TCP.

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 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 Protokol Modbus-TCP termasuk perangkat lunak/lisensi pihak ketiga berikut:

Konektor ini dirilis di bawah Perjanjian Lisensi Perangkat lunak core Greengrass.

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi konektor.

Versi

Perubahan

Tanggal

3 (direkomendasikan)

Versi ini berisi perbaikan bug.

22 Desember 2021

2

Ditambahkan dukungan untuk string sumber dikodekan ASCII, UTF8, dan ISO8859.

24 Mei 2021

1

Pelepasan .

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.

Lihat juga