Siapkan prasyarat kualifikasi LTS - FreeRTOS
Mempersiapkan kualifikasi FreeRTOSUnduh IDT untuk FreeRTOSUnduh GitBuat AWS akunAWS IoT Device Tester kebijakan terkelola(Opsional) Instal AWS Command Line Interface

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

Siapkan prasyarat kualifikasi LTS

Bagian ini menjelaskan prasyarat untuk menguji mikrokontroler dengan. AWS IoT Device Tester

Mempersiapkan kualifikasi FreeRTOS

catatan

AWS IoT Device Tester untuk FreeRTOS sangat merekomendasikan menggunakan rilis patch terbaru dari versi Freertos-LTS terbaru.

IDT untuk FRQ 2.0 adalah kualifikasi untuk FreeRTOS. Sebelum menjalankan IDT FRQ 2.0 untuk kualifikasi, Anda harus menyelesaikan Kualifikasi papan Anda di Panduan Kualifikasi FreerTOS. Untuk mem-port pustaka, pengujian, dan penyiapanmanifest.yml, lihat Mem-porting pustaka FreeRTOS di Panduan Porting FreerTOS. FRQ 2.0 berisi proses kualifikasi yang berbeda. Lihat Perubahan terbaru dalam kualifikasi dalam panduan kualifikasi FreeRTOS untuk detailnya.

Repositori Freertos-Libraries-Integration-Tests harus ada agar IDT dapat dijalankan. Lihat README.md tentang cara mengkloning dan mem-port repositori ini ke proyek sumber Anda. FreeRTOS-Libraries-Integration-Testsharus menyertakan yang manifest.yml terletak di root proyek Anda, agar IDT dapat berjalan.

catatan

IDT tergantung pada implementasi repositori pengujian. UNITY_OUTPUT_CHAR Log keluaran pengujian dan log perangkat tidak boleh saling bertautan. Lihat Menerapkan bagian makro logging pustaka di Panduan Porting FreeRTOS untuk detail lebih lanjut.

Unduh IDT untuk FreeRTOS

Setiap versi FreeRTOS memiliki versi IDT yang sesuai untuk FreerTOS untuk melakukan tes kualifikasi. Unduh versi IDT yang sesuai untuk FreeRTOS dari versi yang didukung untuk FreeRTOS. AWS IoT Device Tester

Ekstrak IDT untuk FreeRTOS ke lokasi pada sistem file tempat Anda telah membaca dan menulis izin. Karena Microsoft Windows memiliki batas karakter untuk panjang jalur, ekstrak IDT untuk FreeRTOS ke direktori root seperti atau. C:\ D:\

catatan

Beberapa pengguna tidak boleh menjalankan IDT dari lokasi bersama, seperti direktori NFS atau folder bersama jaringan Windows. Ini akan mengakibatkan crash atau korupsi data. Kami menyarankan Anda mengekstrak paket IDT ke drive lokal.

Unduh Git

IDT harus menginstal Git sebagai prasyarat untuk memastikan integritas kode sumber.

Ikuti petunjuk dalam GitHubpanduan untuk menginstal Git. Untuk memverifikasi versi Git yang diinstal saat ini, masukkan perintah git --version di terminal.

Awas

IDT menggunakan Git untuk menyelaraskan dengan status direktori bersih atau kotor. Jika Git tidak diinstal, grup FreeRTOSIntegrity pengujian akan gagal, atau tidak akan berjalan seperti yang diharapkan. Jika IDT mengembalikan kesalahan seperti git executable not found ataugit command not found, instal atau instal ulang Git dan coba lagi.

Buat AWS akun

catatan

Suite kualifikasi IDT lengkap hanya didukung dalam hal berikut Wilayah AWS

  • AS Timur (Virginia Utara)

  • AS Barat (Oregon)

  • Asia Pasifik (Tokyo)

  • Eropa (Irlandia)

Untuk menguji perangkat Anda, IDT untuk FreeRTOS membuat sumber daya seperti AWS IoT hal-hal, grup FreeRTOS, dan fungsi Lambda. Untuk membuat sumber daya tersebut, IDT untuk FreeRTOS mengharuskan Anda membuat dan mengonfigurasi AWS akun, dan kebijakan IAM yang memberikan izin IDT untuk FreeRTOS untuk mengakses sumber daya atas nama Anda saat menjalankan pengujian.

Langkah-langkah berikut adalah membuat dan mengkonfigurasi AWS akun Anda.

  1. Jika Anda sudah memiliki AWS akun, lompat ke langkah berikutnya. Lain buat AWS akun.

  2. Ikuti langkah-langkah dalam Membuat peran IAM. Jangan menambahkan izin atau kebijakan saat ini.

  3. Untuk menjalankan tes kualifikasi OTA, lanjutkan ke Langkah 4. Lain pergi ke Langkah 5.

  4. Lampirkan kebijakan inline izin IAM OTA ke peran IAM Anda.

    1. penting

      Templat kebijakan berikut memberikan izin IDT untuk membuat peran, membuat kebijakan, dan melampirkan kebijakan ke peran. IDT untuk FreeRTOS menggunakan izin ini untuk pengujian yang membuat peran. Meskipun templat kebijakan tidak memberikan hak administrator kepada pengguna, izin tersebut dapat digunakan untuk mendapatkan akses administrator ke akun Anda AWS .

    2. Ikuti langkah-langkah di bawah ini untuk melampirkan izin yang diperlukan ke peran IAM Anda:

      1. Pada halaman Izin, pilih Tambahkan izin.

      2. Pilih Buat kebijakan sebaris.

      3. Pilih tab JSON dan salin izin berikut ke kotak teks JSON. Gunakan template di bawah Sebagian Besar Wilayah jika Anda tidak berada di wilayah Tiongkok. Jika Anda berada di wilayah Tiongkok, gunakan templat di bawah Wilayah Beijing dan Ningxia.

        Most Regions
        {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iotdeviceadvisor:*",
            "Resource": [
                "arn:aws:iotdeviceadvisor:*:*:suiterun/*/*",
                "arn:aws:iotdeviceadvisor:*:*:suitedefinition/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": "arn:aws:iam::*:role/idt*",
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": "iotdeviceadvisor.amazonaws.com"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "execute-api:Invoke*",
                "iam:ListRoles",
                "iot:Connect",  
                "iot:CreateJob",
                "iot:DeleteJob",
                "iot:DescribeCertificate", 
                "iot:DescribeEndpoint",
                "iot:DescribeJobExecution",
                "iot:DescribeJob",                                 
                "iot:DescribeThing",
                "iot:GetPolicy",
                "iot:ListAttachedPolicies",
                "iot:ListCertificates",
                "iot:ListPrincipalPolicies",
                "iot:ListThingPrincipals",
                "iot:ListThings",
                "iot:Publish",    
                "iot:UpdateThingShadow",                
                "logs:CreateLogGroup",
                "logs:CreateLogStream",
                "logs:DescribeLogGroups",
                "logs:DescribeLogStreams",
                "logs:PutLogEvents",
                "logs:PutRetentionPolicy"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "iotdeviceadvisor:*",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "logs:DeleteLogGroup",
            "Resource": "arn:aws:logs:*:*:log-group:/aws/iot/deviceadvisor/*"
        },
        {
            "Effect": "Allow",
            "Action": "logs:GetLogEvents",
            "Resource": "arn:aws:logs:*:*:log-group:/aws/iot/deviceadvisor/*:log-stream:*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:CreatePolicy",
                "iam:DetachRolePolicy",
                "iam:DeleteRolePolicy",
                "iam:DeletePolicy",
                "iam:CreateRole",
                "iam:DeleteRole",
                "iam:AttachRolePolicy"
            ],
            "Resource": [
                "arn:aws:iam::*:policy/idt*",
                "arn:aws:iam::*:role/idt*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "ssm:GetParameters"
            ],
            "Resource": [
                "arn:aws:ssm:*::parameter/aws/service/ami-amazon-linux-latest/amzn2-ami-hvm-x86_64-gp2"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeInstances",
                "ec2:RunInstances",
                "ec2:CreateSecurityGroup",
                "ec2:CreateTags",
                "ec2:DeleteTags"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "ec2:CreateKeyPair",
                "ec2:DeleteKeyPair"
            ],
            "Resource": [
                "arn:aws:ec2:*:*:key-pair/idt-ec2-ssh-key-*"
            ]
        },
        {
            "Effect": "Allow",
            "Condition": {
                "StringEqualsIgnoreCase": {
                    "aws:ResourceTag/Owner": "IoTDeviceTester"
                }
            },
            "Action": [
                "ec2:TerminateInstances",
                "ec2:DeleteSecurityGroup",
                "ec2:AuthorizeSecurityGroupIngress",
                "ec2:RevokeSecurityGroupIngress"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}
        Beijing and Ningxia Regions

        Template kebijakan berikut dapat digunakan di Wilayah Beijing dan Ningxia.

        {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iam:CreatePolicy",
                "iam:DetachRolePolicy",
                "iam:DeleteRolePolicy",
                "iam:DeletePolicy",
                "iam:CreateRole",
                "iam:DeleteRole",
                "iam:AttachRolePolicy"
            ],
            "Resource": [
                "arn:aws-cn:iam::*:policy/idt*",
                "arn:aws-cn:iam::*:role/idt*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "ssm:GetParameters"
            ],
            "Resource": [
                "arn:aws-cn:ssm:*::parameter/aws/service/ami-amazon-linux-latest/amzn2-ami-hvm-x86_64-gp2"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeInstances",
                "ec2:RunInstances",
                "ec2:CreateSecurityGroup",
                "ec2:CreateTags",
                "ec2:DeleteTags"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "ec2:CreateKeyPair",
                "ec2:DeleteKeyPair"
            ],
            "Resource": [
                "arn:aws-cn:ec2:*:*:key-pair/idt-ec2-ssh-key-*"
            ]
        },
        {
            "Effect": "Allow",
            "Condition": {
                "StringEqualsIgnoreCase": {
                    "aws-cn:ResourceTag/Owner": "IoTDeviceTester"
                }
            },
            "Action": [
                "ec2:TerminateInstances",
                "ec2:DeleteSecurityGroup",
                "ec2:AuthorizeSecurityGroupIngress",
                "ec2:RevokeSecurityGroupIngress"
            ],
            "Resource": [
                "*"
            ]
        }       
    ]
}

      4. Setelah selesai, pilih Tinjau kebijakan.

      5. Masukkan IDTFreeRTOSIAMPermissionssebagai nama kebijakan.

      6. Pilih Buat kebijakan.

  5. Lampirkan AWSIoTDeviceTesterForFreeRTOSFullAkses ke peran IAM Anda.

    1. Untuk melampirkan izin yang diperlukan ke peran IAM Anda:

      1. Pada halaman Izin, pilih Tambahkan izin.

      2. Pilih Lampirkan kebijakan.

      3. Cari kebijakan AWSIoTDeviceTesterForFreeRTOSFullAkses. Centang kotaknya.

    2. Pilih Tambahkan izin.

  6. Ekspor kredensi untuk IDT. Lihat Mendapatkan kredensi peran IAM untuk akses CLI untuk detailnya.

AWS IoT Device Tester kebijakan terkelola

Kebijakan AWSIoTDeviceTesterForFreeRTOSFullAccess terkelola berisi AWS IoT Device Tester izin berikut untuk pemeriksaan versi, fitur pembaruan otomatis, dan kumpulan metrik.

  • iot-device-tester:SupportedVersion

    Memberikan AWS IoT Device Tester izin untuk mengambil daftar produk yang didukung, rangkaian pengujian, dan versi IDT.

  • iot-device-tester:LatestIdt

    Memberikan AWS IoT Device Tester izin untuk mengambil versi IDT terbaru yang tersedia untuk diunduh.

  • iot-device-tester:CheckVersion

    Memberikan AWS IoT Device Tester izin untuk memeriksa kompatibilitas versi untuk IDT, suite pengujian, dan produk.

  • iot-device-tester:DownloadTestSuite

    Memberikan AWS IoT Device Tester izin untuk mengunduh pembaruan rangkaian pengujian.

  • iot-device-tester:SendMetrics

    Memberikan AWS izin untuk mengumpulkan metrik tentang penggunaan AWS IoT Device Tester internal.

(Opsional) Instal AWS Command Line Interface

Anda mungkin lebih suka menggunakan AWS CLI untuk melakukan beberapa operasi. Jika Anda belum AWS CLI menginstal, ikuti petunjuk di Install the AWS CLI.

Konfigurasikan AWS CLI untuk AWS Wilayah yang ingin Anda gunakan dengan menjalankan aws configure dari baris perintah. Untuk informasi tentang AWS Wilayah yang mendukung IDT untuk FreeRTOS,AWS lihat Wilayah dan Titik Akhir. Untuk informasi selengkapnya, aws configure lihat Konfigurasi cepat dengan aws configure.