Memulai dengan Nordic NRF52840-DK - Gratis RTOS
Gambaran UmumSiapkan perangkat keras NordikSiapkan lingkungan pengembangan AndaBuat koneksi serialUnduh dan mengonfigurasi FreeRTOSBangun dan jalankan proyek demo FreeRTOSPemecahan Masalah

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

Memulai dengan Nordic NRF52840-DK

penting

Integrasi referensi ini di-host di repositori Amazon-freertos yang tidak digunakan lagi. Kami menyarankan Anda mulai di sini ketika Anda membuat proyek baru. Jika Anda sudah memiliki proyek FreeRTOS yang sudah ada berdasarkan repositori Amazon-freertos yang sekarang tidak digunakan lagi, lihatPanduan Migrasi Repositori RTOS Github Bebas Amazon.

Tutorial ini memberikan petunjuk untuk memulai dengan Nordic NRF52840-dk. Jika Anda tidak memiliki Nordic NRF52840-dk, kunjungi Katalog PerangkatAWS Mitra untuk membelinya dari mitra kami.

Sebelum memulai, Anda harus melakukannyaSiapkan AWS IoT dan Amazon Cognito untuk FreerTOS Bluetooth Low Energy.

Untuk menjalankan demo FreeRTOS Bluetooth Low Energy, Anda juga memerlukan perangkat seluler iOS atau Android dengan kemampuan Bluetooth dan Wi-Fi.

catatan

Jika Anda menggunakan perangkat iOS, Anda memerlukan Xcode untuk membangun aplikasi seluler demo. Jika Anda menggunakan perangkat Android, Anda dapat menggunakan Android Studio untuk membuat aplikasi seluler demo.

Gambaran Umum

Tutorial ini berisi petunjuk untuk langkah-langkah memulai berikut:

  1. Menghubungkan papan Anda ke mesin host.

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

  3. Cross kompilasi aplikasi demo FreeRTOS ke gambar biner.

  4. Memuat gambar biner aplikasi ke papan Anda, dan kemudian menjalankan aplikasi.

  5. Berinteraksi dengan aplikasi yang berjalan di papan Anda melalui koneksi serial, untuk tujuan pemantauan dan debugging.

Siapkan perangkat keras Nordik

Connect komputer host Anda ke port USB berlabel J2, terletak tepat di atas dudukan baterai sel koin di papan Nordic NRF52840 Anda.

Untuk informasi selengkapnya tentang pengaturan Nordic NRF52840-dk, lihat Panduan Pengguna Kit Pengembangan NRF52840.

Siapkan lingkungan pengembangan Anda

Unduh dan instal Segger Embedded Studio

FreeRTOS mendukung Segger Embedded Studio sebagai lingkungan pengembangan untuk Nordic NRF52840-DK.

Untuk pengaturan lingkungan Anda, Anda perlu mengunduh dan menginstal Segger Embedded Studio di komputer host Anda.

Untuk mengunduh dan menginstal Segger Embedded Studio

  1. Buka halaman Segger Embedded Studio Downloads, dan pilih opsi Embedded Studio for ARM untuk sistem operasi Anda.

  2. Jalankan penginstal dan ikuti petunjuk penyelesaian.

Mengatur aplikasi demo FreeRTOS Bluetooth Low Energy Mobile SDK

Untuk menjalankan proyek demo FreeRTOS di Bluetooth Low Energy, Anda perlu menjalankan aplikasi demo FreeRTOS Bluetooth Low Energy Mobile SDK di perangkat seluler Anda.

Mengatur aplikasi Demo SDK Mobile FreeRTOS Bluetooth Low Energy

  1. Ikuti petunjukSDK Seluler untuk perangkat Bluetooth FreeRTOS untuk mengunduh dan menginstal SDK untuk platform seluler Anda di komputer host Anda.

  2. Ikuti petunjukAplikasi demo SDK Seluler Energi Rendah FreeRTOS Bluetooth untuk mengatur aplikasi mobile demo pada perangkat mobile Anda.

Buat koneksi serial

Segger Embedded Studio menyertakan emulator terminal yang dapat Anda gunakan untuk menerima pesan log melalui koneksi serial ke papan Anda.

Untuk membuat koneksi serial dengan Segger Embedded Studio

  1. Buka Segger Embedded Studio.

  2. Dari menu atas, pilih Target, Connect J-Link.

  3. Dari menu atas, pilih Tools, Terminal Emulator, Properties, dan atur properti seperti yang diinstruksikanMemasang emulator terminal.

  4. Dari menu atas, pilih Tools, Terminal Emulator, Connect port (115200, N,8,1).

catatan

Emulator terminal studio tertanam Segger tidak mendukung kemampuan input. Untuk ini, gunakan emulator terminal seperti PuTTy, Tera Term, atau GNU Screen. Konfigurasikan terminal untuk terhubung ke papan Anda dengan koneksi serial seperti yang diinstruksikanMemasang emulator terminal.

Unduh dan mengonfigurasi FreeRTOS

Setelah menyiapkan perangkat keras dan lingkungan, Anda dapat mengunduh FreeRTOS.

Unduh FreeRTOS

Untuk mengunduh FreeRTOS untuk Nordic NRF52840-DK, buka GitHub halaman FreeRTOS dan kloning repositori. Lihat file README.md untuk instruksi.

penting

  • Dalam topik ini, jalur ke direktori unduhan FreeRTOS disebut sebagaifreertos.

  • Karakter spasi difreertos jalur dapat menyebabkan kegagalan build. Saat mengkloning atau menyalin repositori, pastikan jalur yang Anda buat tidak mengandung karakter spasi.

  • Panjang maksimal jalur file pada Microsoft Windows adalah 260 karakter. Jalur direktori unduhan FreeRTOS yang panjang dapat menyebabkan kegagalan build.

  • Karena kode sumber mungkin berisi tautan simbolik, jika Anda menggunakan Windows untuk mengekstrak arsip, Anda mungkin harus:

    • Aktifkan Mode Pengembang 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 selengkapnya, lihat entri blog Symlink di Windows 10! .

    Jika Anda menggunakan Git di bawah Windows, Anda harus mengaktifkan Mode Pengembang atau Anda harus:

    • Aturcore.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, dangit submodule update --init --recursive).

Konfigurasikan proyek Anda

Untuk mengaktifkan demo, Anda perlu mengonfigurasi proyek Anda agar berfungsiAWS IoT. Untuk mengonfigurasi proyek Anda agar berfungsiAWS IoT, perangkat Anda harus terdaftar sebagaiAWS IoT sesuatu. Anda seharusnya mendaftarkan perangkat Anda saat AndaSiapkan AWS IoT dan Amazon Cognito untuk FreerTOS Bluetooth Low Energy.

Untuk mengonfigurasiAWS IoT titik akhir

  1. Masuk ke konsol AWS IoT tersebut.

  2. Di panel navigasi, pilih Pengaturan.

    AWS IoTTitik akhir Anda muncul di kotak teks titik akhir data perangkat. Itu seharusnya terlihat seperti 1234567890123-ats.iot.us-east-1.amazonaws.com. Ingatlah titik akhir ini.

  3. Dalam panel navigasi, pilih Kelola, lalu pilih Hal. Ingatlah namaAWS IoT benda untuk perangkat Anda.

  4. DenganAWS IoT endpoint dan namaAWS IoT benda Anda di tangan, bukafreertos/demos/include/aws_clientcredential.h di IDE Anda, dan tentukan nilai untuk#define konstanta berikut:

    • clientcredentialMQTT_BROKER_ENDPOINTAWS IoTEndpoint Anda

    • clientcredentialIOT_THING_NAMENamaAWS IoT hal papan Anda

Untuk mengaktifkan demo

  1. Periksa apakah Demo GATT Bluetooth Energi Rendah diaktifkan. Pergi kevendors/nordic/boards/nrf52840-dk/aws_demos/config_files/iot_ble_config.h, dan tambahkan#define IOT_BLE_ADD_CUSTOM_SERVICES ( 1 ) ke daftar pernyataan define.

  2. Bukavendors/nordic/boards/nrf52840-dk/aws_demos/config_files/aws_demo_config.h, dan tentukan salah satuCONFIG_OTA_MQTT_BLE_TRANSPORT_DEMO_ENABLED atauCONFIG_OTA_HTTP_BLE_TRANSPORT_DEMO_ENABLED seperti dalam contoh ini.

    /* To run a particular demo you need to define one of these.
 * Only one demo can be configured at a time
 *
 *          CONFIG_BLE_GATT_SERVER_DEMO_ENABLED
 *          CONFIG_MQTT_BLE_TRANSPORT_DEMO_ENABLED
 *          CONFIG_SHADOW_BLE_TRANSPORT_DEMO_ENABLED
 *          CONFIG_OTA_MQTT_BLE_TRANSPORT_DEMO_ENABLED
 *          CONFIG_OTA_HTTP_BLE_TRANSPORT_DEMO_ENABLED
 *          CONFIG_POSIX_DEMO_ENABLED
 *
 *  These defines are used in iot_demo_runner.h for demo selection */

#define CONFIG_OTA_MQTT_BLE_TRANSPORT_DEMO_ENABLED

  3. Karena chip Nordic dilengkapi dengan RAM yang sangat sedikit (250KB), konfigurasi BLE mungkin perlu diubah untuk memungkinkan entri tabel GATT yang lebih besar dibandingkan dengan ukuran masing-masing atribut. Dengan cara ini Anda dapat menyesuaikan jumlah memori yang didapat aplikasi. Untuk melakukan ini, ganti definisi atribut berikut dalam filefreertos/vendors/nordic/boards/nrf52840-dk/aws_demos/config_files/sdk_config.h:

    • NRF_SDH_BLE_VS_UUID_COUNT

      Jumlah UUID khusus vendor. Tingkatkan jumlah ini sebesar 1 saat Anda menambahkan UUID khusus vendor baru.

    • NRF_SDH_BLE_GATTS_ATTR_TAB_SIZE

      Ukuran tabel atribut dalam byte. Ukurannya harus kelipatan dari 4. Nilai ini menunjukkan jumlah memori yang ditetapkan khusus untuk tabel atribut (termasuk ukuran karakteristik), jadi ini akan bervariasi dari proyek ke proyek. Jika Anda melebihi ukuran tabel atribut Anda akan mendapatkan kesalahan NRF_ERROR_NO_MEM. Jika Anda memodifikasi NRF_SDH_BLE_GATTS_ATTR_TAB_SIZE biasanya Anda juga harus mengkonfigurasi ulang pengaturan RAM.

    (Untuk pengujian, lokasi file tersebutfreertos/vendors/nordic/boards/nrf52840-dk/aws_tests/config_files/sdk_config.h.)

Bangun dan jalankan proyek demo FreeRTOS

Setelah Anda men-download FreeRTOS dan mengkonfigurasi proyek demo Anda, Anda siap untuk membangun dan menjalankan proyek demo di papan Anda.

penting

Jika ini adalah pertama kalinya Anda menjalankan demo di papan ini, Anda perlu mem-flash bootloader ke papan sebelum demo dapat berjalan.

Untuk membangun dan mem-flash bootloader, ikuti langkah-langkah di bawah ini, tetapi alih-alih menggunakan fileprojects/nordic/nrf52840-dk/ses/aws_demos/aws_demos.emProject proyek, gunakanprojects/nordic/nrf52840-dk/ses/aws_demos/bootloader/bootloader.emProject.

Untuk membangun dan menjalankan demo FreeRTOS Bluetooth Low Energy dari Segger Embedded Studio

  1. Buka Segger Embedded Studio. Dari menu atas, pilih File, pilih Open Solution, dan kemudian arahkan ke file proyekprojects/nordic/nrf52840-dk/ses/aws_demos/aws_demos.emProject

  2. Jika Anda menggunakan emulator terminal Segger Embedded Studio, pilih Tools dari menu atas, lalu pilih Terminal Emulator, Terminal Emulator untuk menampilkan informasi dari koneksi serial Anda.

    Jika Anda menggunakan alat terminal lain, Anda dapat memantau alat untuk output dari koneksi serial Anda.

  3. Klik kanan proyekaws_demos demo di Project Explorer, dan pilih Build.

    catatan

    Jika ini adalah pertama kalinya Anda menggunakan Segger Embedded Studio, Anda mungkin melihat Anda peringatan “Tidak ada lisensi untuk penggunaan komersial”. Segger Embedded Studio dapat digunakan secara gratis untuk perangkat Nordic Semiconductor. Minta lisensi gratis, selama pengaturan pilih Aktifkan Lisensi Gratis Anda, dan ikuti instruksinya.

  4. Pilih Debug, lalu pilih Pergi.

    Setelah demo dimulai, ia menunggu untuk dipasangkan dengan perangkat seluler di Bluetooth Low Energy.

  5. Ikuti petunjuk untuk MQTT melalui Aplikasi Demo Bluetooth Energi Rendah untuk menyelesaikan demo dengan aplikasi demo FreeRTOS Bluetooth Low Energy Mobile SDK sebagai proxy MQTT seluler.

Pemecahan Masalah

Untuk informasi pemecahan masalah umum tentang Memulai FreeRTOS, lihatMemulai masalah saat memulai.