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

# Unduh IDT untuk FreeRTOS
<a name="idt-programmatic-download"></a>

Topik ini menjelaskan opsi untuk mengunduh IDT untuk FreeRTOS. Anda dapat menggunakan salah satu tautan unduhan perangkat lunak berikut atau Anda dapat mengikuti petunjuk untuk mengunduh IDT secara terprogram.

**penting**  
Per Oktober 2022, AWS IoT Device Tester untuk Kualifikasi AWS IoT FreerTOS (FRQ) 1.0 tidak menghasilkan laporan kualifikasi yang ditandatangani. Anda tidak dapat memenuhi syarat perangkat AWS IoT FreeRTOS baru untuk dicantumkan di AWS Katalog Perangkat [Mitra melalui Program Kualifikasi Perangkat](https://partners.amazonaws.com/qualified-devices) [menggunakan versi AWS IDT](https://aws.amazon.com/partners/programs/dqp/) FRQ 1.0. Meskipun Anda tidak dapat memenuhi syarat perangkat FreerTOS menggunakan IDT FRQ 1.0, Anda dapat terus menguji perangkat FreeRTOS Anda dengan FRQ 1.0. [Kami menyarankan Anda menggunakan [IDT FRQ 2.0](https://docs.aws.amazon.com/freertos/latest/userguide/lts-idt-freertos-qualification.html) untuk memenuhi syarat dan daftar perangkat FreeRTOS di Katalog Perangkat Mitra.AWS](https://partners.amazonaws.com/qualified-devices) 

**Topics**
+ [

## Unduh IDT secara manual
](#idt-download-options)
+ [

# Unduh IDT secara terprogram
](idt-programmatic-download-process.md)

Dengan mengunduh perangkat lunak, Anda menyetujui Perjanjian AWS IoT Device Tester Lisensi yang terkandung dalam arsip unduhan.

**catatan**  
IDT tidak mendukung untuk dijalankan oleh beberapa pengguna dari lokasi bersama, seperti direktori NFS atau folder bersama jaringan Windows. Kami sarankan Anda mengekstraksi paket IDT ke drive lokal dan menjalankan biner IDT pada workstation lokal Anda.

## Unduh IDT secara manual
<a name="idt-download-options"></a>

Topik ini mencantumkan versi IDT yang didukung untuk FreeRTOS. Sebagai praktik terbaik, kami menyarankan Anda menggunakan versi terbaru AWS IoT Device Tester yang mendukung FreeRTOS versi target Anda. Rilis baru FreeRTOS mungkin mengharuskan Anda mengunduh versi baru. AWS IoT Device Tester Anda menerima pemberitahuan ketika Anda memulai uji coba jika tidak AWS IoT Device Tester kompatibel dengan versi FreeRTOS yang Anda gunakan.

Lihat [Versi yang didukung AWS IoT Device Tester](dev-test-versions-afr.md)

# Unduh IDT secara terprogram
<a name="idt-programmatic-download-process"></a>

IDT menyediakan operasi API yang dapat Anda gunakan untuk mengambil URL tempat Anda dapat mengunduh IDT secara terprogram. Anda juga dapat menggunakan operasi API ini untuk memeriksa apakah Anda memiliki IDT versi terbaru. Operasi API ini memiliki titik akhir berikut.

```
https://download.devicetester.iotdevicesecosystem.amazonaws.com/latestidt
```

Untuk memanggil operasi API ini, Anda harus memiliki izin untuk melakukan **iot-device-tester:LatestIdt** tindakan. Sertakan AWS tanda tangan Anda, dengan `iot-device-tester` sebagai Nama Layanan

## Permintaan API
<a name="idt-programmatic-download-request"></a>

HostOs — Sistem operasi mesin host. Pilih dari salah satu pilihan berikut:  
+ `mac`
+ `linux`
+ `windows`

TestSuiteType — Jenis test suite. Pilih opsi berikut:  
`FR`— IDT untuk FreeRTOS

ProductVersion  
(Opsional) Versi FreeRTOS. Layanan ini mengembalikan versi IDT terbaru yang kompatibel untuk versi FreeRTOS tersebut. Jika Anda tidak menentukan opsi ini, layanan akan mengembalikan IDT versi terbaru.

## Respon API
<a name="idt-programmatic-download-response"></a>

Respons API memiliki format berikut. `DownloadURL`Termasuk file zip.

```
{
    "Success": True or False,
    "Message": Message,
    "LatestBk": {
        "Version": The version of the IDT binary,
        "TestSuiteVersion": The version of the test suite,
        "DownloadURL": The URL to download the IDT Bundle, valid for one hour
    }
 }
```

## Contoh
<a name="idt-programmatic-download-examples"></a>

Anda dapat mereferensikan contoh-contoh berikut untuk mengunduh IDT secara terprogram. Contoh-contoh ini menggunakan kredensil yang Anda simpan dalam variabel `AWS_ACCESS_KEY_ID` dan `AWS_SECRET_ACCESS_KEY` lingkungan. Untuk mengikuti praktik keamanan terbaik, jangan simpan kredensil Anda dalam kode Anda.

**Example**  
**Contoh: Unduh menggunakan cURL versi 7.75.0 atau yang lebih baru (Mac dan Linux)**  
Jika Anda memiliki cURL versi 7.75.0 atau yang lebih baru, Anda dapat menggunakan `aws-sigv4` flag untuk menandatangani permintaan API. Contoh ini menggunakan [jq](https://stedolan.github.io/jq/) untuk mengurai URL unduhan dari respons.  
`aws-sigv4`Bendera membutuhkan parameter kueri dari permintaan GET curl berada dalam urutan **HostOs/ProductVersion/TestSuiteType**atau **HostOs/TestSuiteType**. Pesanan yang tidak sesuai, akan mengakibatkan kesalahan mendapatkan tanda tangan yang tidak cocok untuk String Canonical dari API Gateway.  
Jika parameter **ProductVersion**opsional disertakan, Anda harus menggunakan versi produk yang didukung seperti yang didokumentasikan dalam versi yang [didukung AWS IoT Device Tester untuk FreeRTOS](https://docs.aws.amazon.com/freertos/latest/userguide/dev-test-versions-afr.html). 
+ Ganti *us-west-2* dengan Anda Wilayah AWS. Untuk daftar kode Region, lihat [Titik akhir Regional](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints).
+ Ganti *linux* dengan sistem operasi mesin host Anda.
+ Ganti *202107.00* dengan versi FreeRTOS Anda.

```
url=$(curl --request GET "https://download.devicetester.iotdevicesecosystem.amazonaws.com/latestidt?HostOs=linux&ProductVersion=202107.00&TestSuiteType=FR" \
--user $AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY \
--aws-sigv4 "aws:amz:us-west-2:iot-device-tester" \
| jq -r '.LatestBk["DownloadURL"]')

curl $url --output devicetester.zip
```

**Example**  
**Contoh: Unduh menggunakan cURL versi sebelumnya (Mac dan Linux)**  
Anda dapat menggunakan perintah cURL berikut dengan AWS tanda tangan yang Anda tanda tangani dan hitung. Untuk informasi selengkapnya tentang cara menandatangani dan menghitung AWS tanda tangan, lihat [Menandatangani permintaan AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html).  
+ Ganti *linux* dengan sistem operasi mesin host Anda.
+ Ganti *Timestamp* dengan tanggal dan waktu, seperti**20220210T004606Z**.
+ Ganti *Date* dengan tanggal, seperti**20220210**.
+ Ganti *AWSRegion* dengan Anda Wilayah AWS. Untuk daftar kode Region, lihat [Titik akhir Regional](https://docs.aws.amazon.com/general/latest/gr/rande.html).
+ Ganti *AWSSignature* dengan [AWS tanda tangan](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv-create-signed-request.html) yang Anda hasilkan.

```
curl --location --request GET 'https://download.devicetester.iotdevicesecosystem.amazonaws.com/latestidt?HostOs=linux&TestSuiteType=FR' \
--header 'X-Amz-Date: Timestamp \
--header 'Authorization: AWS4-HMAC-SHA256 Credential=$AWS_ACCESS_KEY_ID/Date/AWSRegion/iot-device-tester/aws4_request, SignedHeaders=host;x-amz-date, Signature=AWSSignature'
```

**Example**  
**Contoh: Unduh menggunakan skrip Python**  
Contoh ini menggunakan pustaka [permintaan](https://pypi.org/project/requests/) Python. Contoh ini diadaptasi dari contoh Python untuk [Menandatangani permintaan AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) di Referensi *AWS Umum*.    
  
+ Ganti *us-west-2* dengan wilayah Anda. Untuk daftar kode Region, lihat [Titik akhir Regional](https://docs.aws.amazon.com/general/latest/gr/rande.html).
+ Ganti *linux* dengan sistem operasi mesin host Anda.

```
# Copyright 2010-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
#
# This file is licensed under the Apache License, Version 2.0 (the "License").
# You may not use this file except in compliance with the License. A copy of the
#License is located at
#
# http://aws.amazon.com/apache2.0/
#
# This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS
# OF ANY KIND, either express or implied. See the License for the specific
# language governing permissions and limitations under the License.

# See: http://docs.aws.amazon.com/general/latest/gr/sigv4_signing.html
# This version makes a GET request and passes the signature
# in the Authorization header.
import sys, os, base64, datetime, hashlib, hmac 
import requests # pip install requests
# ************* REQUEST VALUES *************
method = 'GET'
service = 'iot-device-tester'
host = 'download.devicetester.iotdevicesecosystem.amazonaws.com'
region = 'us-west-2'
endpoint = 'https://download.devicetester.iotdevicesecosystem.amazonaws.com/latestidt'
request_parameters = 'HostOs=linux&TestSuiteType=FR'

# Key derivation functions. See:
# http://docs.aws.amazon.com/general/latest/gr/signature-v4-examples.html#signature-v4-examples-python
def sign(key, msg):
    return hmac.new(key, msg.encode('utf-8'), hashlib.sha256).digest()

def getSignatureKey(key, dateStamp, regionName, serviceName):
    kDate = sign(('AWS4' + key).encode('utf-8'), dateStamp)
    kRegion = sign(kDate, regionName)
    kService = sign(kRegion, serviceName)
    kSigning = sign(kService, 'aws4_request')
    return kSigning

# Read AWS access key from env. variables or configuration file. Best practice is NOT
# to embed credentials in code.
access_key = os.environ.get('AWS_ACCESS_KEY_ID')
secret_key = os.environ.get('AWS_SECRET_ACCESS_KEY')
if access_key is None or secret_key is None:
    print('No access key is available.')
    sys.exit()

# Create a date for headers and the credential string
t = datetime.datetime.utcnow()
amzdate = t.strftime('%Y%m%dT%H%M%SZ')
datestamp = t.strftime('%Y%m%d') # Date w/o time, used in credential scope

# ************* TASK 1: CREATE A CANONICAL REQUEST *************
# http://docs.aws.amazon.com/general/latest/gr/sigv4-create-canonical-request.html
# Step 1 is to define the verb (GET, POST, etc.)--already done.
# Step 2: Create canonical URI--the part of the URI from domain to query 
# string (use '/' if no path)
canonical_uri = '/latestidt' 
# Step 3: Create the canonical query string. In this example (a GET request),
# request parameters are in the query string. Query string values must
# be URL-encoded (space=%20). The parameters must be sorted by name.
# For this example, the query string is pre-formatted in the request_parameters variable.
canonical_querystring = request_parameters
# Step 4: Create the canonical headers and signed headers. Header names
# must be trimmed and lowercase, and sorted in code point order from
# low to high. Note that there is a trailing \n.
canonical_headers = 'host:' + host + '\n' + 'x-amz-date:' + amzdate + '\n'
# Step 5: Create the list of signed headers. This lists the headers
# in the canonical_headers list, delimited with ";" and in alpha order.
# Note: The request can include any headers; canonical_headers and
# signed_headers lists those that you want to be included in the 
# hash of the request. "Host" and "x-amz-date" are always required.
signed_headers = 'host;x-amz-date'
# Step 6: Create payload hash (hash of the request body content). For GET
# requests, the payload is an empty string ("").
payload_hash = hashlib.sha256(('').encode('utf-8')).hexdigest()
# Step 7: Combine elements to create canonical request
canonical_request = method + '\n' + canonical_uri + '\n' + canonical_querystring + '\n' + canonical_headers + '\n' + signed_headers + '\n' + payload_hash

# ************* TASK 2: CREATE THE STRING TO SIGN*************
# Match the algorithm to the hashing algorithm you use, either SHA-1 or
# SHA-256 (recommended)
algorithm = 'AWS4-HMAC-SHA256'
credential_scope = datestamp + '/' + region + '/' + service + '/' + 'aws4_request'
string_to_sign = algorithm + '\n' +  amzdate + '\n' +  credential_scope + '\n' +  hashlib.sha256(canonical_request.encode('utf-8')).hexdigest()
# ************* TASK 3: CALCULATE THE SIGNATURE *************
# Create the signing key using the function defined above.
signing_key = getSignatureKey(secret_key, datestamp, region, service)
# Sign the string_to_sign using the signing_key
signature = hmac.new(signing_key, (string_to_sign).encode('utf-8'), hashlib.sha256).hexdigest()

# ************* TASK 4: ADD SIGNING INFORMATION TO THE REQUEST *************
# The signing information can be either in a query string value or in 
# a header named Authorization. This code shows how to use a header.
# Create authorization header and add to request headers
authorization_header = algorithm + ' ' + 'Credential=' + access_key + '/' + credential_scope + ', ' +  'SignedHeaders=' + signed_headers + ', ' + 'Signature=' + signature
# The request can include any headers, but MUST include "host", "x-amz-date", 
# and (for this scenario) "Authorization". "host" and "x-amz-date" must
# be included in the canonical_headers and signed_headers, as noted
# earlier. Order here is not significant.
# Python note: The 'host' header is added automatically by the Python 'requests' library.
headers = {'x-amz-date':amzdate, 'Authorization':authorization_header}

# ************* SEND THE REQUEST *************
request_url = endpoint + '?' + canonical_querystring
print('\nBEGIN REQUEST++++++++++++++++++++++++++++++++++++')
print('Request URL = ' + request_url)
response = requests.get(request_url, headers=headers)
print('\nRESPONSE++++++++++++++++++++++++++++++++++++')
print('Response code: %d\n' % response.status_code)
print(response.text)

download_url = response.json()["LatestBk"]["DownloadURL"]
r = requests.get(download_url)
open('devicetester.zip', 'wb').write(r.content)
```