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

# Memulai dengan NuMaker-IoT-M Nuvoton 487
<a name="getting-started-nuvoton-m487"></a>

**penting**  <a name="deprecation-message"></a>
Integrasi referensi ini di-host di repositori Amazon-Freertos 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 sudah ada berdasarkan repositori Amazon-Freertos yang sekarang tidak digunakan lagi, lihat. [Panduan Migrasi Repositori Github Amazon-freertos](github-repo-migration.md)

Tutorial ini memberikan instruksi untuk memulai dengan papan pengembangan Nuvoton NuMaker-IoT-M 487. Mikrokontroler seri, dan termasuk modul RJ45 Ethernet dan Wi-Fi bawaan. Jika Anda tidak memiliki Nuvoton NuMaker-IoT-M 487, kunjungi [Katalog Perangkat AWS Mitra untuk membelinya dari mitra](https://devices.amazonaws.com/detail/a3G0h000000Tg9cEAC/NuMaker-IoT-M487) kami. 

Sebelum Anda mulai, Anda harus mengkonfigurasi AWS IoT dan perangkat lunak FreeRTOS Anda untuk menghubungkan papan pengembangan Anda ke Cloud. AWS Untuk petunjuk, lihat [Langkah pertama](freertos-prereqs.md). Dalam tutorial ini, jalur ke direktori unduhan FreeRTOS disebut sebagai. `freertos`

## Ikhtisar
<a name="getting-started-nuvoton-m487-overview"></a>

Tutorial ini memandu Anda melalui langkah-langkah berikut:

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

1. Kompilasi silang aplikasi demo FreerTOS ke gambar biner.

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

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

Edisi Keil MDK Nuvoton dirancang untuk mengembangkan dan men-debug aplikasi untuk papan Nuvoton M487. Versi Keil MDK v5 Essential, Plus, atau Pro juga harus berfungsi untuk MCU Nuvoton M487 (Cortex-M4 core). Anda dapat mengunduh edisi Keil MDK Nuvoton dengan diskon harga untuk seri Nuvoton Cortex-M4. MCUs Keil MDK hanya didukung pada Windows.

**Untuk menginstal alat pengembangan untuk NuMaker-IoT-M 487**

1. Unduh [Keil MDK Nuvoton Edition](https://store.developer.arm.com/store/embedded-iot-software-tools/keil-mdk-nuvoton-edition?edition=1164) dari situs web Keil MDK. 

1. Instal MDK Keil di mesin host Anda menggunakan lisensi Anda. Keil MDK mencakup Keil µVision IDE, rantai alat kompilasi C/C\$1\$1, dan debugger µVision.

   Jika Anda mengalami masalah selama instalasi, hubungi [Nuvoton](https://www.nuvoton.com/contact-us) untuk bantuan.

1. [Instal **Nu-Link\$1Keil\$1Driver\$1v3.06.7215R (atau versi terbaru), yang ada di halaman Alat Pengembangan Nuvoton**.](https://www.nuvoton.com/tool-and-software/ide-and-compiler/)

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

**Untuk membangun proyek demo FreeRTOS**

1. Buka Keil µVision IDE.

1. Pada menu **File**, pilih **Buka**. Dalam kotak dialog **Open file**, pastikan pemilih jenis file diatur ke **Project Files**.

1. Pilih salah satu proyek demo Wi-Fi atau Ethernet untuk dibangun.
   + Untuk membuka proyek demo Wi-Fi, pilih proyek target `aws_demos.uvproj` di `freertos\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos` direktori. 
   + Untuk membuka proyek demo Ethernet, pilih proyek target `aws_demos_eth.uvproj` di `freertos\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos_eth` direktori. 

1. Untuk memastikan pengaturan Anda benar untuk mem-flash papan, klik kanan `aws_demo` proyek di IDE, lalu pilih **Opsi**. (Lihat [Pemecahan masalah](#gsg-nuvoton-m487-troubleshoot) untuk lebih jelasnya.)

1. Pada tab **Utilities**, verifikasi bahwa **Use Target Driver for Flash Programming** dipilih, dan **Nuvoton Nu-Link Debugger** ditetapkan sebagai driver target. 

1. **Pada tab **Debug**, di sebelah **Nuvoton Nu-Link Debugger, pilih** Pengaturan.**

1. Verifikasi bahwa **Jenis Chip** diatur ke **M480**. 

1. Di panel navigasi Keil µVision IDE **Project**, pilih project. `aws_demos` Pada menu **Project**, pilih **Build Target**. 

Anda dapat menggunakan klien MQTT di AWS IoT konsol untuk memantau pesan yang dikirim perangkat Anda ke Cloud. AWS 

**Untuk berlangganan topik MQTT dengan klien MQTT AWS IoT**

1. Masuk ke [konsol AWS IoT](https://console.aws.amazon.com/iotv2) tersebut.

1. Di panel navigasi, pilih **Uji**, lalu pilih klien **pengujian MQTT untuk membuka klien** MQTT. 

1. Dalam **Subscription topic**, masukkan***your-thing-name*/example/topic**, lalu pilih **Subscribe to topic**. 

**Untuk menjalankan proyek demo FreeRTOS**

1. Hubungkan papan Numaker-IoT-M 487 Anda ke mesin host Anda (komputer). 

1. Membangun kembali proyek. 

1. **Di Keil µVision IDE, pada menu **Flash**, pilih Unduh.** 

1. Pada menu **Debug**, pilih **Start/Stop** Debug Session.

1. Ketika debugger berhenti di breakpoint`main()`, buka menu **Run, lalu pilih Run** **(**F5).

   Anda akan melihat pesan MQTT yang dikirim oleh perangkat Anda di klien MQTT di konsol. AWS IoT 

## Menggunakan CMake dengan FreeRTOS
<a name="gsg-nuvoton-m487-cmake"></a>

Anda juga dapat menggunakan CMake untuk membangun dan menjalankan aplikasi demo FreeRTOS atau aplikasi yang telah Anda kembangkan menggunakan editor kode pihak ketiga dan alat debugging. 

Pastikan Anda telah menginstal sistem CMake build. Ikuti instruksi di[Menggunakan CMake dengan FreeRTOS](getting-started-cmake.md), lalu ikuti langkah-langkah di bagian ini.

**catatan**  
Pastikan jalur ke lokasi kompiler (Keil) ada di variabel sistem Path Anda, misalnya,. `C:\Keil_v5\ARM\ARMCC\bin` 

Anda juga dapat menggunakan klien MQTT di AWS IoT konsol untuk memantau pesan yang dikirim perangkat Anda ke Cloud. AWS 

**Untuk berlangganan topik MQTT dengan klien MQTT AWS IoT**

1. Masuk ke [konsol AWS IoT](https://console.aws.amazon.com/iotv2) tersebut.

1. Di panel navigasi, pilih **Uji**, lalu pilih klien **pengujian MQTT untuk membuka klien** MQTT. 

1. Dalam **Subscription topic**, masukkan***your-thing-name*/example/topic**, lalu pilih **Subscribe to topic**. 

**Untuk menghasilkan file build dari file sumber dan menjalankan proyek demo**

1. Di mesin host Anda, buka prompt perintah dan arahkan ke *freertos* folder. 

1. Buat folder untuk berisi file build yang dihasilkan. Kami akan merujuk ke folder ini sebagai*BUILD\$1FOLDER*. 

1. Buat file build untuk demo Wi-Fi atau Ethernet.
   + Untuk Wi-Fi:

     Arahkan ke direktori yang berisi file sumber untuk proyek demo FreeRTOS. Kemudian, buat file build dengan menjalankan perintah berikut. 

     ```
     cmake -DVENDOR=nuvoton -DBOARD=numaker_iot_m487_wifi -DCOMPILER=arm-keil -S . -B BUILD_FOLDER -G Ninja 
     ```
   + Untuk Ethernet:

     Arahkan ke direktori yang berisi file sumber untuk proyek demo FreeRTOS. Kemudian, buat file build dengan menjalankan perintah berikut. 

     ```
     cmake -DVENDOR=nuvoton -DBOARD=numaker_iot_m487_wifi -DCOMPILER=arm-keil -DAFR_ENABLE_ETH=1 -S . -B BUILD_FOLDER -G Ninja 
     ```

1. Hasilkan biner untuk flash ke M487 dengan menjalankan perintah berikut.

   ```
   cmake --build BUILD_FOLDER 
   ```

   Pada titik ini, file biner `aws_demos.bin` harus ada di `BUILD_FOLDER/vendors/Nuvoton/boards/numaker_iot_m487_wifi` folder. 

1. Untuk mengkonfigurasi papan untuk mode flashing, pastikan sakelar MSG (No.4 dari ISW1 pada ICE) diaktifkan. Saat Anda mencolokkan papan, jendela (dan drive) akan ditetapkan. (Lihat [Pemecahan masalah](#gsg-nuvoton-m487-troubleshoot)).

1. Buka emulator terminal untuk melihat pesan melalui UART. Ikuti petunjuk di [Menginstal emulator terminal](gsg-troubleshooting.md#uart-term).

1. Jalankan proyek demo dengan menyalin biner yang dihasilkan ke perangkat. 

   Jika Anda berlangganan topik MQTT dengan klien MQTT, Anda akan melihat pesan AWS IoT MQTT yang dikirim oleh perangkat Anda di konsol. AWS IoT 

## Pemecahan masalah
<a name="gsg-nuvoton-m487-troubleshoot"></a>
+ Jika windows Anda tidak dapat mengenali perangkat`VCOM`, instal driver port serial NuMaker windows dari tautan [Nu-Link USB Driver](https://www.nuvoton.com/export/resource-files/Nu-Link_USB_Driver_V1.6.zip) v1.6.
+ Jika Anda menghubungkan perangkat Anda ke Keil MDK (IDE) melalui Nu-Link, pastikan sakelar MSG (No.4 dari ISW1 pada ICE) MATI, seperti yang ditunjukkan.  
![\[Papan sirkuit dengan slot kartu SD, mikrokontroler, pin, konektor daya dan reset berlabel.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/nuvoton-m487-gsg.png)

Jika Anda mengalami masalah saat menyiapkan lingkungan pengembangan atau menghubungkan ke papan Anda, hubungi [Nuvoton](http://www.nuvoton.com/contact-us/).

### Mendebug proyek FreeRTOS di Keil μVision
<a name="gsg-nuvoton-m487-troubleshoot-debug-projects"></a>

**Untuk memulai sesi debug di Keil μVision**

1. Buka Keil μVision. 

1. Ikuti langkah-langkah untuk membangun proyek demo FreeRTOS di. [Bangun dan jalankan proyek demo FreeRTOS](#gsg-nuvoton-m487-build-run)

1. Pada menu **Debug**, pilih **Start/Stop** Debug Session. 

   Jendela **Call Stack \$1 Locals** muncul saat Anda memulai sesi debug. μVision mem-flash demo ke papan, menjalankan demo, dan berhenti di awal fungsi. `main()` 

1. Tetapkan breakpoint dalam kode sumber proyek Anda, lalu jalankan kodenya. Proyek ini akan terlihat seperti berikut ini.  
![\[File kode sumber utama dengan inisialisasi perangkat keras, penjadwalan tugas, penyediaan kunci untuk proyek mikrokontroler perangkat.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/numaker-iot-m487-debug.png)

### Pemecahan masalah pengaturan debug μVision
<a name="gsg-nuvoton-m487-troubleshoot-debug"></a>

Jika Anda mengalami masalah saat men-debug aplikasi, periksa apakah pengaturan debug Anda diatur dengan benar di Keil μVision.

**Untuk memverifikasi bahwa pengaturan debug μVision sudah benar**

1. Buka Keil μVision. 

1. Klik kanan `aws_demo` proyek di IDE, lalu pilih **Options**. 

1. Pada tab **Utilities**, verifikasi bahwa **Use Target Driver for Flash Programming** dipilih, dan **Nuvoton Nu-Link Debugger** ditetapkan sebagai driver target.   
![\[Jendela opsi yang menampilkan pengaturan konfigurasi untuk pemrograman flash, debugging, dan pemrosesan file output.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/nulink-debugger-target.png)

1. **Pada tab **Debug**, di sebelah **Nuvoton Nu-Link Debugger, pilih** Pengaturan.**  
![\[Dialog pengaturan Nu-Link Debugger dengan opsi untuk versi driver, versi ICE, keluarga perangkat, ID perangkat, port, jam maks, jenis chip, mode koneksi, opsi reset, dan tegangan kontrol daya.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/nulink-driver-setup.png)

1. Verifikasi bahwa **Jenis Chip** diatur ke **M480**.