

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.

# Konektor Adaptor Protokol IP Ethernet IoT
<a name="ethernet-ip-connector"></a>

[Konektor](connectors.md) Adaptor Protokol IP IoT Ethernet mengumpulkan data dari perangkat lokal menggunakan protokol. Ethernet/IP Anda dapat menggunakan konektor ini untuk mengumpulkan data dari beberapa perangkat dan menerbitkannyanya ke `StreamManager` aliran pesan. 

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 [Mengonfigurasi sumber Ethernet/IP (EIP)](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-eip-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 | 
| --- | --- | 
| 2 (disarankan) | `arn:aws:greengrass:{{region}}::/connectors/IoTEIPProtocolAdaptor/versions/2` | 
| 1 | `arn:aws:greengrass:{{region}}::/connectors/IoTEIPProtocolAdaptor/versions/1` | 

Untuk informasi tentang perubahan versi, lihat [Changelog](#ethernet-ip-connector-changelog).

## Persyaratan
<a name="ethernet-ip-connector-req"></a>

Konektor ini memiliki persyaratan sebagai berikut:

------
#### [ Version 1 and 2 ]
+ 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.
+ Minimal 256 MB RAM tambahan. Persyaratan ini merupakan tambahan untuk persyaratan memori AWS IoT Greengrass Core.

**catatan**  
 Konektor ini hanya tersedia dalam Wilayah berikut:   
cn-north-1
ap-southeast-1
ap-southeast-2
eu-central-1
eu-west-1
us-east-1
us-west-2

------

## Parameter Konektor
<a name="ethernet-ip-connector-param"></a>

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*$|\/.`

`ProtocolAdapterConfiguration`  
Kumpulan konfigurasi Ethernet/IP kolektor yang konektor mengumpulkan data dari atau terhubung ke. Ini bisa menjadi daftar kosong.  
Nama tampilan di AWS IoT konsol: **Konfigurasi Adaptor Protokol**  
Wajib: `true`  
Jenis: Sebuah string JSON terbentuk yang mendefinisikan himpunan konfigurasi umpan balik yang didukung.

 Berikut ini adalah contoh dari `ProtocolAdapterConfiguration`: 

```
{
    "sources": [
        {
            "type": "EIPSource",
            "name": "TestSource",
            "endpoint": {
                "ipAddress": "52.89.2.42",
                "port": 44818
            },
            "destination": {
                "type": "StreamManager",
                "streamName": "MyOutput_Stream",
                "streamBufferSize": 10
            },
            "destinationPathPrefix": "EIPSource_Prefix",
            "propertyGroups": [
                {
                    "name": "DriveTemperatures",
                    "scanMode": {
                        "type": "POLL",
                        "rate": 10000
                    },
                    "tagPathDefinitions": [
                        {
                            "type": "EIPTagPath",
                            "path": "arrayREAL[0]",
                            "dstDataType": "double"
                        }
                    ]
                }
            ]
        }
    ]
}
```

### Buat Contoh Konektor (AWS CLI)
<a name="eip-connector-create"></a>

Perintah CLI berikut membuat `ConnectorDefinition` dengan versi awal yang mengandung konektor Adaptor Protokol IP Ethernet IoT.

```
aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version 
'{
    "Connectors": [
        {
            "Id": "MyIoTEIPProtocolConnector",
            "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTEIPProtocolAdaptor/versions/2",
            "Parameters": {
                "ProtocolAdaptorConfiguration": "{ \"sources\": [{ \"type\": \"EIPSource\", \"name\": \"Source1\", \"endpoint\": { \"ipAddress\": \"54.245.77.218\", \"port\": 44818 }, \"destinationPathPrefix\": \"EIPConnector_Prefix\", \"propertyGroups\": [{ \"name\": \"Values\", \"scanMode\": { \"type\": \"POLL\", \"rate\": 2000 }, \"tagPathDefinitions\": [{ \"type\": \"EIPTagPath\", \"path\": \"arrayREAL[0]\", \"dstDataType\": \"double\" }]}]}]}",
                "LocalStoragePath": "/var/MyIoTEIPProtocolConnectorState"
            }
        }
    ]
}'
```

**catatan**  
Fungsi Lambda dalam konektor mempunyai siklus hidup yang [berumur panjang](lambda-functions.md#lambda-lifecycle) ini.

## Data input
<a name="ethernet-ip-connector-data-input"></a>

Konektor ini tidak menerima pesan MQTT sebagai data input.

## Data output
<a name="ethernet-ip-connector-data-output"></a>

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
<a name="ethernet-ip-connector-license"></a>

Konektor Adaptor Protokol IP IoT Ethernet mencakup pihak ketiga berikut: software/licensing
+ [Ethernet/IP klien](https://github.com/digitalpetri/ethernet-ip/blob/master/LICENSE)
+ [MapDB](https://github.com/jankotek/mapdb/blob/master/LICENSE.txt)
+ [Elsa](https://github.com/jankotek/elsa/blob/master/LICENSE.txt)

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
<a name="ethernet-ip-connector-changelog"></a>

Tabel berikut menjelaskan perubahan dalam setiap versi konektor.


| Versi | Perubahan | Date | 
| --- | --- | --- | 
| 2 | Versi ini berisi perbaikan bug. | Desember 23, 2021 | 
| 1 | Pelepasan awal. | 15 Desember 2020 | 

<a name="one-conn-version"></a>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
<a name="ethernet-ip-connector-see-also"></a>
+ [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)