Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Demo unduhan dasar CoreHTTP S3
penting
Demo 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, lihat. Panduan Migrasi Repositori RTOS Github Bebas Amazon
Pengantar
Demo ini menunjukkan cara menggunakan permintaan rentangHTTPClient_AddRangeHeader untuk membuat permintaan HTTP. Untuk lingkungan mikrokontroler, permintaan jangkauan sangat dianjurkan. Dengan mengunduh file besar dalam rentang terpisah, alih-alih dalam satu permintaan, setiap bagian file dapat diproses tanpa memblokir soket jaringan. Permintaan jangkauan menurunkan risiko paket yang jatuh, yang memerlukan transmisi ulang pada koneksi TCP, sehingga meningkatkan konsumsi daya perangkat.
Contoh ini menggunakan antarmuka transport jaringan
catatan
Untuk mengatur dan menjalankan demo FreeRTOS, ikuti langkah-langkahnya. Memulai dengan Gratis RTOS
Berulir tunggal versus multi ulir
Ada dua model penggunaan CoreHTTP, single threaded dan multithreaded (multitasking). Meskipun demo di bagian ini menjalankan perpustakaan HTTP di utas, ini sebenarnya menunjukkan cara menggunakan CoreHTTP dalam satu lingkungan berulir (hanya satu tugas yang menggunakan API HTTP dalam demo). Meskipun aplikasi single threaded harus berulang kali memanggil perpustakaan HTTP, aplikasi multithreaded malah dapat mengirim permintaan HTTP di latar belakang dalam tugas agen (atau daemon).
Organisasi kode sumber
Proyek demo diberi nama http_demo_s3_download.c dan dapat ditemukan di freertos/demos/coreHTTP/
Mengkonfigurasi koneksi server HTTP Amazon S3
Demo ini menggunakan URL yang telah ditandatangani sebelumnya untuk terhubung ke server HTTP Amazon S3 dan mengotorisasi akses ke objek untuk diunduh. Koneksi TLS server HTTP Amazon S3 hanya menggunakan otentikasi server. Pada tingkat aplikasi, akses ke objek diautentikasi dengan parameter dalam kueri URL yang telah ditandatangani sebelumnya. Ikuti langkah-langkah di bawah ini untuk mengonfigurasi koneksi Anda AWS.
-
Siapkan AWS akun:
-
Jika Anda belum melakukannya, buat dan aktifkan AWS akun
. -
Akun dan izin ditetapkan menggunakan AWS Identity and Access Management (IAM). IAM memungkinkan Anda mengelola izin untuk setiap pengguna di akun Anda. Secara default, pengguna tidak memiliki izin sampai diberikan oleh pemilik root.
-
Untuk menambahkan pengguna ke AWS akun Anda, lihat Panduan Pengguna IAM.
-
Berikan izin ke AWS akun Anda untuk mengakses FreeRTOS AWS IoT dan dengan menambahkan kebijakan ini:
-
AmazonS3 FullAccess
-
-
-
-
Buat bucket di S3 dengan mengikuti langkah-langkah di Bagaimana cara membuat Bucket S3? di Panduan Pengguna Konsol Layanan Penyimpanan Sederhana Amazon.
-
Unggah file ke S3 dengan mengikuti langkah-langkah di Bagaimana cara mengunggah file dan folder ke bucket S3? .
-
Hasilkan URL yang telah ditandatangani sebelumnya menggunakan skrip yang terletak di
FreeRTOS-Plus/Demo/coreHTTP_Windows_Simulator/Common/presigned_url_generator/presigned_urls_gen.py. Untuk petunjuk penggunaan, lihatFreeRTOS-Plus/Demo/coreHTTP_Windows_Simulator/Common/presigned_url_generator/README.md.
Fungsionalitas
Demo mengambil ukuran file terlebih dahulu. Kemudian ia meminta setiap rentang byte secara berurutan, dalam satu lingkaran, dengan ukuran rentang. democonfigRANGE_REQUEST_LENGTH
Kode sumber untuk demo dapat ditemukan di situs GitHub
Menghubungkan ke server HTTP Amazon S3
Fungsi connectToServerWithBackoffRetries () mencobaconnectToServerWithBackoffRetries()mengembalikan status kegagalan jika koneksi TCP ke server tidak dapat dibuat setelah jumlah upaya yang dikonfigurasi.
Fungsi ini prvConnectToServer() menunjukkan cara membuat koneksi ke server HTTP Amazon S3 hanya menggunakan otentikasi server. Ini menggunakan antarmuka transport berbasis MBEDTLS yang diimplementasikan dalam file Freertos-Plus/Source/Application-Protocols/Network_Transport/Freertos_Plus_TCP/USING_MBEDTLS/USING_MBEDTLS.C.
Kode sumber untuk prvConnectToServer() dapat ditemukan di GitHub
Membuat permintaan rentang
Fungsi API HTTPClient_AddRangeHeader() mendukung serialisasi rentang byte ke header permintaan HTTP untuk membentuk permintaan rentang. Rentang permintaan digunakan dalam demo ini untuk mengambil ukuran file dan untuk meminta setiap bagian dari file.
Fungsi prvGetS3ObjectFileSize() mengambil ukuran file di bucket S3. Connection: keep-aliveHeader ditambahkan dalam permintaan pertama ini ke Amazon S3 untuk menjaga koneksi tetap terbuka setelah respons dikirim. Server HTTP S3 saat ini tidak mendukung permintaan HEAD menggunakan URL yang telah ditandatangani sebelumnya, sehingga byte ke-0 diminta. Ukuran file terkandung dalam bidang Content-Range header respon. 206 Partial ContentRespons diharapkan dari server; kode status respons lain yang diterima adalah kesalahan.
Kode sumber untuk prvGetS3ObjectFileSize() dapat ditemukan di GitHub
Setelah mengambil ukuran file, demo ini membuat permintaan rentang baru untuk setiap rentang byte file yang akan diunduh. Ini digunakan HTTPClient_AddRangeHeader() untuk setiap bagian file.
Mengirim permintaan jangkauan dan menerima tanggapan
Fungsi prvDownloadS3ObjectFile() mengirimkan permintaan rentang dalam satu lingkaran hingga seluruh file diunduh. Fungsi API HTTPClient_Send() mengirimkan permintaan dan menerima respons secara sinkron. Ketika fungsi kembali, respon diterima dalam filexResponse. Kode status kemudian diverifikasi menjadi 206 Partial Content dan jumlah byte yang diunduh sejauh ini ditambah dengan nilai header. Content-Length
Kode sumber untuk prvDownloadS3ObjectFile() dapat ditemukan di GitHub
