기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# IDT-FreeRTOS UI 시작하기
이 섹션에서는 IDT-FreeRTOS UI를 사용하여 구성을 생성하거나 수정하는 방법을 보여주고 테스트를 실행하는 방법을 보여줍니다.
**Topics**
+ [AWS 자격 증명 구성](#configure-aws-credentials)
+ [IDT-FreeRTOS UI 열기](#open-idt-ui)
+ [새 구성 생성](#create-new-configuration)
+ [기존 구성 수정](#modify-existing-configuration)
+ [검증 테스트 실행](#run-tests-from-ui)
## AWS 자격 증명 구성
에서 생성한 AWS 사용자의 자격 증명을 구성해야 합니다[AWS 계정 생성 및 구성](dev-tester-ui-prereqs.md#ui-config-aws-account). 두 가지 방법 중 하나로 자격 증명을 지정할 수 있습니다.
+ 자격 증명 파일에서
+ 환경 변수로
### AWS 자격 증명 파일을 사용하여 자격 증명 구성
IDT는 AWS CLI와 동일한 자격 증명 파일을 사용합니다. 자세한 내용은 [구성 및 자격 증명 파일](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html)을 참조하십시오.
자격 증명 파일의 위치는 사용하는 운영 체제에 따라 달라집니다.
+ macOS, Linux의 경우: `~/.aws/credentials`
+ Windows: `C:\Users\{{UserName}}\.aws\credentials`
다음 형식으로 자격 AWS 증명을 `credentials` 파일에 추가합니다.
```
[default]
aws_access_key_id = {{}}
aws_secret_access_key = {{}}
```
**참고**
`default` AWS 프로필을 사용하지 않는 경우 IDT-FreeRTOS UI에서 프로필 이름을 지정해야 합니다. 프로필에 대한 자세한 내용은 [구성 및 자격 증명 파일 설정](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html)을 참조하세요.
### 환경 변수를 사용하여 AWS 자격 증명 구성
환경 변수는 운영 체제에서 유지 관리하고 시스템 명령에서 사용하는 변수입니다. 이들은 SSH 세션을 닫으면 저장되지 않습니다. IDT-FreeRTOS UI는 `AWS_ACCESS_KEY_ID` 및 `AWS_SECRET_ACCESS_KEY` 환경 변수를 사용하여 AWS 자격 증명 정보를 저장합니다.
Linux, macOS 또는 Unix에서 이러한 변수를 설정하려면 **export**를 사용합니다.
```
export AWS_ACCESS_KEY_ID={{}}
export AWS_SECRET_ACCESS_KEY={{}}
```
Windows에서 이러한 변수를 설정하려면 **set**을 사용합니다.
```
set AWS_ACCESS_KEY_ID={{}}
set AWS_SECRET_ACCESS_KEY={{}}
```
## IDT-FreeRTOS UI 열기
**IDT-FreeRTOS UI를 열려면**
1. 지원되는 IDT-FreeRTOS 버전을 다운로드하고 읽기 및 쓰기 권한이 있는 파일 시스템에서 다운로드한 아카이브의 압축을 풉니다.
1. 다음 명령을 실행하여 IDT-FreeRTOS 설치 디렉터리로 이동합니다.
```
cd {{devicetester-extract-location}}/bin
```
1. 다음 명령을 실행하여 IDT-FreeRTOS UI를 엽니다.
------
#### [ Linux ]
```
.devicetestergui_linux_x86-64.exe
```
------
#### [ Windows ]
```
./devicetestergui_win_x64-64
```
------
#### [ macOS ]
```
./devicetestergui_mac_x86-64
```
**참고**
Mac의 경우 시스템에서 UI를 실행하도록 허용하려면 **시스템 환경설정 -> 보안 및 개인정보 보호**로 이동합니다. 테스트를 실행할 때 이 작업을 세 번 더 수행해야 할 수도 있습니다.
------
IDT-FreeRTOS UI가 기본 브라우저에서 열립니다. 지원되는 브라우저에 대한 자세한 내용은 [지원되는 웹 브라우저 사용](dev-tester-ui-prereqs.md#idt-ui-supported-web-browser) 섹션을 참조하세요.
## 새 구성 생성
처음 사용하는 경우 새 구성을 생성하여 IDT-FreeRTOS에서 테스트를 실행하는 데 필요한 JSON 구성 파일을 설정해야 합니다. 그런 다음 테스트를 실행하거나 생성된 구성을 수정할 수 있습니다.
`config.json`, `device.json` 및 `userdata.json` 파일의 예제는 [마이크로컨트롤러 보드의 첫 번째 테스트](qual-steps.md) 섹션을 참조하세요. Bluetooth Low Energy(BLE) 테스트 실행에만 사용되는 `resource.json` 파일의 예제는 [블루투스 로우 에너지 테스트 실행](afr-bridgekeeper-dt-bt.md) 섹션을 참조하세요.
**새 구성을 생성하려면**
1. IDT-FreeRTOS UI에서 탐색 메뉴를 연 다음 **새 구성 생성**을 선택합니다.
**중요**
UI를 열기 전에 AWS 자격 증명을 구성해야 합니다. 자격 증명 정보를 구성하지 않은 경우 IDT-FreeRTOS UI 브라우저 창을 닫고 [AWS 자격 증명 구성](#configure-aws-credentials)의 단계를 수행한 다음 IDT-FreeRTOS UI를 다시 엽니다.
1. 구성 마법사를 따라 검증 테스트를 실행하는 데 사용되는 IDT 구성 설정을 입력합니다. 마법사는 `{{devicetester-extract-location}}/config` 디렉터리에 있는 JSON 구성 파일에서 다음 설정을 구성합니다.
+ **AWS 설정** AWS 계정 - IDT-FreeRTOS가 테스트 실행 중에 AWS 리소스를 생성하는 데 사용하는 정보입니다. 이러한 설정은 `config.json` 파일에서 구성됩니다.
+ **FreeRTOS 리포지토리** - FreeRTOS 리포지토리 및 이식된 코드의 절대 경로와 수행하려는 검증 유형입니다. 이러한 설정은 `userdata.json` 파일에서 구성됩니다.
검증 테스트를 실행하려면 먼저 디바이스의 FreeRTOS를 이식해야 합니다. 자세한 내용은 [FreeRTOS 이식 안내서](https://docs.aws.amazon.com/freertos/latest/portingguide/)를 참조하세요.
+ **빌드 및 플래시** - IDT가 자동으로 테스트를 빌드하고 보드에 플래시할 수 있도록 하는 하드웨어용 빌드 및 플래시 명령입니다. 이러한 설정은 `userdata.json` 파일에서 구성됩니다.
+ **디바이스** - 테스트할 디바이스의 디바이스 풀 설정입니다. 이러한 설정은 `device.json` 파일에서 `id` 및 `sku` 필드와 디바이스 풀의 `devices` 블록에서 구성됩니다.
+ **네트워킹** - 디바이스에 대한 네트워크 통신 지원을 테스트하기 위한 설정입니다. 이러한 설정은 `device.json` 파일의 `features` 블록과 `userdata.json` 파일의 `clientWifiConfig` 및 `testWifiConfig` 블록에서 구성됩니다.
+ **에코 서버** - 보안 소켓 테스트를 위한 에코 서버 구성 설정입니다. 이러한 설정은 `userdata.json` 파일에서 구성됩니다.
에코 서버 구성 파일에 대한 자세한 내용은 [https://docs.aws.amazon.com/freertos/latest/portingguide/afr-echo-server.html](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-echo-server.html) 섹션을 참조하세요.
+ **CMake** - (선택 사항) CMake 빌드 기능 테스트를 실행하기 위한 설정입니다. 이 구성은 CMake를 빌드 시스템으로 사용하는 경우에만 필요합니다. 이러한 설정은 `userdata.json` 파일에서 구성됩니다.
+ **BLE** - Bluetooth Low Energy 기능 테스트를 실행하기 위한 설정입니다. 이러한 설정은 `device.json` 파일의 `features` 블록과 `resource.json` 파일에서 구성됩니다.
+ **OTA** - OTA 기능 테스트를 실행하기 위한 설정입니다. 이러한 설정은 `device.json` 파일의 `features` 블록과 `userdata.json` 파일에서 구성됩니다.
1. **검토** 페이지에서 구성 정보를 확인합니다.
구성 검토를 마친 후 검증 테스트를 실행하려면 **테스트 실행**을 선택합니다.
## 기존 구성 수정
IDT용 구성 파일을 이미 설정한 경우 IDT-FreeRTOS UI를 사용하여 기존 구성을 수정할 수 있습니다. `{{devicetester-extract-location}}/config` 디렉터리에서 기존 구성 파일을 사용할 수 있는지 확인하세요.
**새 구성을 수정하려면**
1. IDT-FreeRTOS UI에서 탐색 메뉴를 연 다음 **기존 구성 편집**을 선택합니다.
구성 대시보드에 기존 구성 설정에 대한 정보가 표시됩니다. 구성이 잘못되었거나 사용할 수 없는 경우 해당 구성의 상태는 `Error validating configuration`입니다.
1. 기존 구성 설정을 수정하려면 다음 단계를 완료합니다.
1. 구성 설정의 이름을 선택하여 설정 페이지를 엽니다.
1. 설정을 수정한 다음 **저장**을 선택하여 구성 파일을 다시 생성합니다.
구성 수정을 완료한 후 모든 구성 설정이 유효성 검사를 통과했는지 확인하세요. 각 구성 설정의 상태가 `Valid`인 경우 이 구성을 사용하여 검증 테스트를 실행할 수 있습니다.
## 검증 테스트 실행
IDT-FreeRTOS용 구성을 생성한 후에는 검증 테스트를 실행할 수 있습니다.
**검증 테스트를 실행하려면**
1. 구성을 확인합니다.
1. 탐색 메뉴에서 **테스트 실행**을 선택합니다.
1. 테스트 실행을 시작하려면 **테스트 시작**을 선택합니다.
IDT-FreeRTOS가 검증 테스트를 실행하고 **테스트 실행기** 콘솔에 테스트 실행 요약 및 모든 오류를 표시합니다. 테스트 실행이 완료되면 다음 위치에서 테스트 결과 및 로그를 볼 수 있습니다.
+ 테스트 결과는 `{{devicetester-extract-location}}/results/{{execution-id}}` 디렉터리에 있습니다.
+ 테스트 로그는 `{{devicetester-extract-location}}/results/{{execution-id}}/logs` 디렉터리에 있습니다.
테스트 결과 및 로그에 대한 자세한 내용은 [FreeRTOS용 IDT 결과 보기](view-results-frq.md)과 [FreeRTOS용 IDT 로그 보기](view-logs-frq.md) 섹션을 참조하세요.