

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

# Gambar SDK Hub Integrasi Terkelola pada Raspberry Pi
<a name="raspberrypi-device-hub-sdk"></a>

**catatan**  
 Implementasi AWS IoT Hub SDK pada Raspberry Pi ini adalah proyek demonstrasi yang ditujukan untuk tujuan pembelajaran dan pengujian saja dan tidak dimaksudkan untuk digunakan di lingkungan produksi. Untuk keperluan demo ini, atur konfigurasi berikut untuk kemudahan pengembangan:   
 **AWS penyimpanan kredensial**: Hanya untuk tujuan demo, kredensional dan sertifikat disimpan di lokasi yang dapat diakses untuk pengujian dan pengembangan yang lebih mudah. Lingkungan produksi harus menggunakan solusi penyimpanan aman seperti AWS Secrets Manager, atau Systems Manager Parameter Store. Mereka harus menerapkan enkripsi saat istirahat, dan mengikuti pedoman AWS IoT keamanan.   
 **Hak istimewa kontainer**: Demo berjalan dengan hak istimewa yang ditingkatkan untuk memungkinkan akses tidak terbatas ke sumber daya host dan menyederhanakan alur kerja pengembangan. Dalam produksi, kontainer harus beroperasi dengan hak istimewa minimal yang diperlukan.   
 **Konfigurasi jembatan jaringan**: Demo menggunakan konfigurasi jembatan jaringan yang mengekspos lalu lintas jaringan internal untuk memudahkan debugging dan pemantauan. Dalam lingkungan produksi, terapkan isolasi dan segmentasi jaringan yang tepat untuk mencegah akses tidak sah ke lalu lintas jaringan internal.   
 **Izin perangkat USB**: Akses perangkat USB yang tidak dibatasi diaktifkan untuk memudahkan koneksi periferal pengembangan dan perangkat pengujian. Untuk produksi, terapkan kontrol dan validasi perangkat USB yang ketat untuk mencegah serangan spoofing perangkat.   
 Konfigurasi ini memungkinkan pengujian langsung dan tidak boleh digunakan di lingkungan produksi. Saat menerapkan ke produksi, ikuti praktik terbaik keamanan untuk mencegah kompromi sistem host dan akses tidak sah ke kredensi. 

## Prasyarat
<a name="deployment-prerequisites"></a>

Lengkapi persyaratan ini sebelum menerapkan gambar Raspberry Pi:
+ Unduh dan instal [Raspberry Pi imager.](https://www.raspberrypi.com/software/)
+ Dapatkan [Kartu SD](https://www.amazon.com/dp/B0CWPPDS3D?ref=ppx_yo2ov_dt_b_fed_asin_title).
+ Siapkan [Raspberry Pi 5 dengan CPU quad-core 2.4Ghz 64-bit (](https://www.amazon.com/CanaKit-Raspberry-Starter-Kit-PRO/dp/B0CRSNCJ6Y/)RAM 8GB).
+ Hubungkan [Dongle USB Sonoff Zigbee](https://www.amazon.com/Plus-ZBDongle-Interface-Pre-Installed-Coordinated-Zigbee2MQTT/dp/B0B6P22YJC/).
+ [Flash firmware ke dongle USB Sonoff Zigbee](supported-raspberry.md#sonoff-zigbee-firmware-flashing).
+ Hubungkan Dongle [Silicon Labs SLUSB001A](https://www.digikey.com/en/products/detail/silicon-labs/SLUSB001A/9867108).
+ [Mendaftar untuk sebuah AWS akun](https://docs.aws.amazon.com/iot-mi/latest/devguide/setting-up.html#sign-up-for-aws).
+ Instal versi terbaru [AWS CLI dari Referensi AWS CLI Perintah Integrasi Terkelola](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/).

## Flash gambar Raspberry Pi pada kartu SD baru
<a name="image-deployment"></a>

Flash gambar Integrasi Terkelola ke kartu SD Anda menggunakan langkah-langkah berikut:

1. Unduh [Integrasi Terkelola Raspberry Pi Hub SDK Image](https://d2no7dt1utuyzo.cloudfront.net/IotMI-HubSDK-RaspberryPi/1.0.0/IotMI-HubSDK-RPi-Image-v1.0.0.img.gz).

1. Luncurkan Raspberry Pi Imager di desktop Anda.

1. Masukkan kartu SD ke pembaca kartu SD bawaan komputer Anda, atau pembaca kartu USB eksternal.

1. Pilih **Pilih Perangkat** → Raspberry Pi 5.

1. Pilih **Pilih OS** → Gunakan kustom → Temukan IotMI-HubSDK-RPi-Image-v1.0.0.img.gz file → Buka.

1. Pilih **Pilih penyimpanan** → Pilih Pembaca Kartu SD Anda.

1. Verifikasi konfigurasi Anda cocok dengan layar berikut:  
![Layar konfigurasi Raspberry Pi Imager yang menampilkan pilihan perangkat, OS, dan penyimpanan](https://docs.aws.amazon.com/id_id/iot-mi/latest/devguide/images/raspberry-pi-imager-config.png)

1. Klik **Berikutnya**.

1. Konfigurasikan pengaturan kustomisasi OS:
   + **Nama host:** Pilih **raspberrypi**.
   + **Nama Pengguna dan Kata Sandi:**
     + Aktifkan **Tetapkan nama pengguna dan kata sandi**:
     + Untuk **Nama Pengguna:**, masukan`hub123456`.
     + Untuk **Kata Sandi:**, masukan`sh123456`.
   + **LAN nirkabel:**
     + Aktifkan **Konfigurasi LAN nirkabel**.
     + Masukkan **SSID** router Anda, dan **kata sandi**.

       Contoh pengaturan:
       + **SSID**: `iotmi-tplink`
       + **Kata sandi**: `********` (Minimal 8 karakter)
     + Tetapkan **Negara:** ke`US`.
   + **Setel Pengaturan Lokal:**
     + Atur **Zona waktu:** ke`America/Los Angeles`.
     + Setel **Tata Letak Keyboard:** ke`US`.
   + **SSH:**
     + Pilih tab **layanan**.
     + Periksa **Aktifkan SSH**.
     + Pilih **Gunakan otentikasi kata sandi**.

1. Konfirmasikan semua popup untuk kustomisasi OS dan penghapusan data.

1. Tunggu proses penulisan selesai.

1. Verifikasi penyelesaian yang berhasil dengan layar berikut:  
![Layar sukses Raspberry Pi Imager menunjukkan operasi penulisan selesai](https://docs.aws.amazon.com/id_id/iot-mi/latest/devguide/images/raspberry-pi-write-success.png)

1. Klik **Lanjutkan**.

1. Keluarkan kartu SD dan masukkan ke dalam Raspberry Pi Anda.

## Jalankan Hub SDK pada Raspberry Pi
<a name="hub-sdk-execution"></a>

Mulai layanan Hub SDK pada Raspberry Pi yang dikonfigurasi:

1. Masukkan kartu SD yang disiapkan ke perangkat Raspberry Pi 5.

1. Hubungkan Sonoff Zigbee USB Dongle dan Silicon Labs SLUSB001A Dongle ke Raspberry Pi.

1. Nyalakan Raspberry Pi.

1. Pastikan Raspberry Pi dan komputer Anda (dari mana Anda SSH) berada di jaringan yang sama.

1. SSH ke Raspberry Pi menggunakan kredenal yang Anda tetapkan selama penerapan gambar.

   ```
   ssh username@hostname
   ```

1. Arahkan ke direktori SDK hub:

   ```
   cd /data/aws/iotmi
   ```

1. Selesaikan [pengaturan orientasi Hub](https://docs.aws.amazon.com/iot-mi/latest/devguide/managedintegrations-sdk-v2-cookbook-hubsetup.html) untuk menambahkan materi otentikasi dan konfigurasi.
**catatan**  
Anda harus berada di `YUL` atau `DUB` wilayah untuk melakukan langkah ini.

1. Jalankan Hub SDK:

   ```
   cd /data/aws/iotmi
   bash start_hub_sdk.sh
   ```

Sistem menampilkan respons berikut untuk memulai Hub SDK yang berhasil:

```
-------Stopping SDK running processes---
-------Starting Hub SDK-------------
-------Creating logs directory----------
Logs directory created.
-------Verifying Middleware paths-------
All middleware libraries exist
-------Verifying Middleware pre reqs---
AIPC and KVstroage directories exist
-------Starting HubOnboarding-----------
-------Starting MQTT Proxy-----------
-------Staring Log Daemon---
-------Starting Event Manager-----------
-------Starting Zigbee Service----------
--Checking Zigbee network information--
-------Starting Zwave Service----------
/data/aws/iotmi/middleware/AceZwave/bin /data/aws/iotmi
/data/aws/iotmi
-------Starting CDMB--------------------
-------Starting Agent--------------------
-------Starting Provisioner--------------
-------Checking SDK status---------------
hub1234+    1780  0.2  0.1 1093936 16368 pts/1   Sl+  16:34   0:00 ./iotmi_mqtt_proxy -C /data/aws/iotmi/config/iotmi_config.json
Process 'iotmi_mqtt_proxy' is running.
hub1234+    1884  0.0  0.0 236272  2624 pts/1    Sl+  16:34   0:00 ./middleware/AceCommon/bin/ace_eventmgr
Process 'ace_eventmgr' is running.
hub1234+    1892  9.1  0.1 393040  8352 pts/1    Sl+  16:34   0:04 ./middleware/AceZigbee/bin/ace_zigbee_service
Process 'ace_zigbee_service' is running.
hub1234+    1923  0.0  0.1 1570736 12736 pts/1   Sl+  16:34   0:00 ./zwave_svc
Process 'zwave_svc' is running.
hub1234+    1958  0.0  0.0 1067632 5776 pts/1    Sl+  16:34   0:00 ./iotmi_cdmb
Process 'iotmi_cdmb' is running.
hub1234+    2001  0.2  0.2 2017712 21264 pts/1   Sl+  16:35   0:00 ./iotmi_device_agent
Process 'iotmi_device_agent' is running.
hub1234+    2045  0.0  0.1 1457824 12624 pts/1   Sl+  16:35   0:00 ./iotmi_lpw_provisioner
Process 'iotmi_lpw_provisioner' is running.
hub1234+    1813  0.0  0.0 875152  6848 pts/1    Sl+  16:34   0:00 ./iotmi_log_daemon
Process 'iotmi_log_daemon' is running.
------Successfully Started Hub SDK----
```

## Langkah selanjutnya
<a name="next-steps"></a>

Setelah berhasil memulai Hub SDK, lanjutkan dengan orientasi dan pengelolaan perangkat di. [Penyiapan yang dipandu pengguna untuk onboard dan mengoperasikan perangkat](managedintegrations-sdk-v2-cookbook-ugs.md)