

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

# Memulai dengan Microchip ATECC608A Secure Element dengan simulator Windows
<a name="getting_started_atecc608a"></a>

**penting**  <a name="deprecation-message"></a>
Integrasi referensi ini di-host di Amazon-FreeRTOS repositori yang tidak digunakan lagi. Kami menyarankan Anda [mulai di sini](freertos-getting-started-modular.md) ketika Anda membuat proyek baru. Jika Anda sudah memiliki proyek FreeRTOS yang ada berdasarkan repositori yang sekarang tidak digunakan lagi, Amazon-FreeRTOS lihat. [Amazon-FreeRTOS Panduan Migrasi Repositori Github](github-repo-migration.md)

Tutorial ini memberikan instruksi untuk memulai dengan Microchip ATECC608A Secure Element dengan Windows Simulator.

Anda memerlukan perangkat keras berikut:
+ [Microchip ATECC608A elemen aman clickboard](https://www.mikroe.com/secure-4-click)
+ [SAMD21 XPlained Pro](https://www.microchipdirect.com/product/ATSAMD21-XPRO?dfw_tracker=64197-ATSAMD21-XPRO&gclid=EAIaIQobChMIn5jIuM3C5QIVk_5kCh1m1Ag4EAQYASABEgLKtfD_BwE)
+ [MikroBus Xplained Pro adaptor](https://www.microchip.com/Developmenttools/ProductDetails/ATMBUSADAPTER-XPRO)

Sebelum memulai, Anda harus mengonfigurasi AWS IoT dan mengunduh FreeRTOS Anda untuk menghubungkan perangkat Anda ke Cloud. AWS Lihat [Langkah pertama](freertos-prereqs.md) untuk instruksi. Dalam tutorial ini, jalur ke direktori unduhan FreeRTOS disebut sebagai. {{freertos}}

## Ikhtisar
<a name="gsg-atcc608a-overview"></a>

Tutorial ini berisi langkah-langkah berikut:

1. Hubungkan papan Anda ke mesin host.

1. Instal perangkat lunak pada mesin host untuk mengembangkan dan men-debug aplikasi tertanam untuk papan mikrokontroler Anda.

1. Cross-compile aplikasi demo FreeRTOS ke gambar biner.

1. Muat gambar biner aplikasi ke papan Anda, lalu jalankan aplikasi.

## Siapkan perangkat keras Microchip ATECC608A
<a name="gsg-atcc608a-setup"></a>

Sebelum Anda dapat berinteraksi dengan perangkat Microchip ATECC608A Anda, Anda harus terlebih dahulu memprogram SAMD21.

**Untuk mengatur papan SAMD21 XPlained Pro**

1. Ikuti tautan [CryptoAuthSSH-XSTK (DM320109) - Firmware terbaru](http://ww1.microchip.com/downloads/en/DeviceDoc/ATCRYPTOAUTHSSH-XSTK_v1.0.1.zip) untuk mengunduh file.zip yang berisi instruksi (PDF) dan biner yang dapat diprogram ke D21.

1. Unduh dan instal [Atmel Studio 7](https://microchipdeveloper.com/atstudio:studio7intro) IDP. Pastikan Anda memilih arsitektur driver **SMART ARM MCU** selama instalasi.

1. Gunakan kabel USB 2.0 Micro B untuk memasang konektor “Debug USB” ke komputer Anda, dan ikuti instruksi dalam PDF. (Konektor “Debug USB” adalah port USB yang paling dekat dengan LED POWER dan pin.)

**Untuk menghubungkan perangkat keras**

1. Cabut kabel micro USB dari Debug USB.

1. Colokkan adaptor MikroBus XPlained Pro ke papan SAMD21 di lokasi EXT1.

1. Colokkan papan ATECC608A Secure 4 Click ke adaptor MikroBusX XPlained Pro. Pastikan sudut papan klik yang berlekuk cocok dengan ikon berlekuk di papan adaptor.

1. Colokkan kabel micro USB ke Target USB.

Pengaturan Anda akan terlihat seperti berikut ini.

![Papan tempat memotong roti dengan kabel USB berlabel “Target USB”, terhubung ke perangkat eksternal berlabel “Terhubung ke EXT 1", takik yang cocok dengan posisi jumper default.](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/samd21.png)


## Siapkan lingkungan pengembangan Anda
<a name="gsg-atecc608a-setup-dev-env"></a>

### Mendaftar untuk Akun AWS
<a name="sign-up-for-aws"></a>

Untuk memulai AWS, Anda membutuhkan Akun AWS. Untuk informasi tentang membuat Akun AWS, lihat [Memulai dengan Akun AWS](https://docs.aws.amazon.com//accounts/latest/reference/getting-started.html) di *Panduan AWS Account Management Referensi*.

Untuk memberikan akses dan menambahkan izin bagi pengguna, grup, atau peran Anda:
+ Pengguna dan grup di AWS IAM Identity Center:

  Buat rangkaian izin. Ikuti instruksi di [Buat rangkaian izin](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html) dalam *Panduan Pengguna AWS IAM Identity Center *.
+ Pengguna yang dikelola di IAM melalui penyedia identitas:

  Buat peran untuk federasi identitas. Ikuti instruksi dalam [Buat peran untuk penyedia identitas pihak ketiga (federasi)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html) dalam *Panduan Pengguna IAM*.
+ Pengguna IAM:
  + Buat peran yang dapat diambil pengguna Anda. Ikuti instruksi dalam [Buat peran untuk pengguna IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) dalam *Panduan Pengguna IAM*.
  + (Tidak disarankan) Lampirkan kebijakan langsung ke pengguna atau tambahkan pengguna ke grup pengguna. Ikuti petunjuk dalam [Menambahkan izin ke pengguna (konsol)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) dalam *Panduan Pengguna IAM*.

**Penyiapan**

1. [Unduh repo FreeRTOS dari repositori FreerTOS. GitHub ](https://github.com/aws/amazon-freertos)

   Untuk mengunduh FreeRTOS dari: GitHub

   1. Jelajahi repositori [FreeRTOS GitHub ](https://github.com/aws/amazon-freertos).

   1. Pilih **Klon atau unduh**.

   1. Dari baris perintah di komputer Anda, kloning repositori ke direktori di mesin host Anda.

      ```
      git clone https://github.com/aws/amazon-freertos.git -\-recurse-submodules
      ```
**penting**  
Dalam topik ini, jalur ke direktori unduhan FreeRTOS disebut sebagai. `{{freertos}}`
Karakter ruang di `{{freertos}}` jalur dapat menyebabkan kegagalan build. Saat Anda mengkloning atau menyalin repositori, pastikan jalur yang Anda buat tidak berisi karakter spasi.
Panjang maksimum jalur file di Microsoft Windows adalah 260 karakter. Jalur direktori unduhan FreerTOS yang panjang dapat menyebabkan kegagalan build.
Karena kode sumber mungkin berisi tautan simbolis, jika Anda menggunakan Windows untuk mengekstrak arsip, Anda mungkin harus:  
Aktifkan [Mode Pengembang](https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development) atau, 
Gunakan konsol yang ditinggikan sebagai administrator.
Dengan cara ini, Windows dapat membuat tautan simbolis dengan benar saat mengekstrak arsip. Jika tidak, tautan simbolis akan ditulis sebagai file normal yang berisi jalur tautan simbolis sebagai teks atau kosong. Untuk informasi lebih lanjut, lihat entri blog [Symlinks di Windows 10\!](https://blogs.windows.com/windowsdeveloper/2016/12/02/symlinks-windows-10/) .  
Jika Anda menggunakan Git di bawah Windows, Anda harus mengaktifkan Mode Pengembang atau Anda harus:   
Setel `core.symlinks` ke true dengan perintah berikut:  

          ```
          git config -\-global core.symlinks true
          ```
Gunakan konsol yang ditinggikan sebagai administrator setiap kali Anda menggunakan perintah git yang menulis ke sistem (misalnya,**git pull**,**git clone**, dan**git submodule update -\\-init -\\-recursive**).

   1. Dari `{{freertos}}` direktori, periksa cabang yang akan digunakan.

1. Siapkan lingkungan pengembangan Anda.

   1. Instal [WinPcap](https://www.winpcap.org) versi terbaru.

   1. Instal Microsoft Visual Studio.

      Visual Studio versi 2017 dan 2019 diketahui berfungsi. Semua edisi versi Visual Studio ini didukung (Komunitas, Profesional, atau Perusahaan).

      Selain IDE, instal pengembangan Desktop dengan komponen C\+\+. Kemudian, di bawah **Opsional**, instal SDK Windows 10 terbaru.

   1. Pastikan Anda memiliki koneksi Ethernet terprogram aktif.

## Bangun dan jalankan proyek demo FreeRTOS
<a name="gsg-atecc608a-build-and-run"></a>

**penting**  
Perangkat Microchip ATECC608A memiliki inisialisasi satu kali yang dikunci ke perangkat saat pertama kali proyek dijalankan (selama panggilan ke). `C_InitToken` Namun, proyek demo FreeRTOS dan proyek pengujian memiliki konfigurasi yang berbeda. Jika perangkat terkunci selama konfigurasi proyek demo, semua pengujian dalam proyek pengujian tidak akan berhasil.

**Untuk membangun dan menjalankan proyek demo FreeRTOS dengan Visual Studio IDE**

1. Muat proyek ke Visual Studio.

   Dari menu **File**, pilih **Buka**. Pilih **File/Solution**, navigasikan ke `{{freertos}}\projects\microchip\ecc608a_plus_winsim\visual_studio\aws_demos\aws_demos.sln` file, lalu pilih **Buka**.

1. Targetkan ulang proyek demo.

   Proyek demo tergantung pada Windows SDK, tetapi tidak memiliki versi Windows SDK yang ditentukan. Secara default, IDE mungkin mencoba membangun demo dengan versi SDK yang tidak ada di mesin Anda. **Untuk mengatur versi Windows SDK, klik kanan **aws\_demos**, lalu pilih Retarget Projects.** Ini membuka jendela **Review Solution Actions**. **Pilih versi Windows SDK yang ada di mesin Anda (gunakan nilai awal dalam daftar drop-down), lalu pilih OK.**

1. Membangun dan menjalankan proyek.

   Dari menu **Build**, pilih **Build Solution**, dan pastikan solusi dibangun tanpa kesalahan. Pilih **Debug, Mulai Debug** untuk menjalankan proyek. Pada proses pertama, Anda perlu mengkonfigurasi antarmuka perangkat Anda dan mengkompilasi ulang. Untuk informasi selengkapnya, lihat [Konfigurasikan antarmuka jaringan Anda](getting_started_windows.md#win-network-interface).

1. Menyediakan Microchip ATECC608A.

   Microchip telah menyediakan beberapa alat skrip untuk membantu pengaturan suku cadang ATECC608A. Arahkan ke`{{freertos}}\vendors\microchip\secure_elements\app\example_trust_chain_tool`, dan buka README.md file.

   Ikuti petunjuk dalam `README.md` file untuk menyediakan perangkat Anda. Langkah-langkahnya meliputi:

   1. Buat dan daftarkan otoritas sertifikat dengan AWS.

   1. Hasilkan kunci Anda di Microchip ATECC608A dan ekspor kunci publik dan nomor seri perangkat.

   1. Hasilkan sertifikat untuk perangkat dan daftarkan sertifikat itu dengan AWS.

   1. Muat sertifikat CA dan sertifikat perangkat ke perangkat.

1. Bangun dan jalankan sampel FreeRTOS.

   Re-run proyek demo lagi. Kali ini Anda harus terhubung\!

## Pemecahan masalah
<a name="ecc680a-troubleshooting"></a>

Untuk informasi pemecahan masalah umum, lihat. [Pemecahan masalah memulai](gsg-troubleshooting.md)