기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Cypress CYW943907AEVAL1F 개발 키트 시작하기
**중요**
이 라이브러리는 더 이상 사용되지 않는 Amazon-FreeRTOS 리포지토리에서 호스팅됩니다. 새 프로젝트를 생성할 때는 [여기서 시작](freertos-getting-started-modular.md)하는 것이 좋습니다. 현재 사용되지 않는 Amazon-FreeRTOS 리포지토리를 기반으로 하는 기존 FreeRTOS 프로젝트가 이미 있는 경우에는 [Amazon-FreeRTOS Github 리포지토리 마이그레이션 가이드](github-repo-migration.md) 섹션을 참조하세요.
이 자습서에서는 Cypress CYW943907AEVAL1F 개발 키트를 시작하기 위한 지침을 제공합니다. Cypress CYW943907AEVAL1F 개발 키트가 없는 경우 AWS Partner Device Catalog를 방문하여 [파트너](https://devices.amazonaws.com/detail/a3G0L00000AAPg0UAH/CYW943907AEVAL1F)에서 구입하시기 바랍니다.
**참고**
이 자습서는 coreMQTT 상호 인증 데모를 설정하고 실행하는 단계를 안내합니다. 현재, 이 보드의 FreeRTOS 포트는 TCP 서버 및 클라이언트 데모를 지원하지 않습니다.
시작하기 전에 AWS IoT 및 FreeRTOS 다운로드를 구성하여 디바이스를 AWS 클라우드에 연결해야 합니다. 자세한 내용은 [첫 번째 단계](freertos-prereqs.md) 섹션을 참조하세요.
**중요**
이 주제에서는 FreeRTOS 다운로드 디렉터리의 경로를 `freertos`이라고 합니다.
`freertos` 경로의 공백 문자로 인해 빌드 실패가 발생할 수 있습니다. 리포지토리를 복제하거나 복사할 때 생성하는 경로에 공백 문자가 없어야 합니다.
Microsoft Windows에서 파일 경로의 최대 길이는 260자입니다. FreeRTOS 다운로드 디렉터리 경로가 길면 빌드 오류가 발생할 수 있습니다.
소스 코드에 심볼 링크가 포함될 수 있으므로 Windows를 사용하여 아카이브를 추출하는 경우 다음을 수행해야 할 수 있습니다.
[개발자 모드](https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development)를 활성화합니다. 또는,
관리자 권한으로 승격된 콘솔을 사용합니다.
이렇게 하면 Windows에서 아카이브를 추출할 때 심볼 링크를 제대로 생성할 수 있습니다. 그렇지 않으면 심볼 링크는 심볼 링크의 경로를 텍스트로 포함하는 일반 파일 또는 비어 있는 일반 파일로 작성됩니다. 자세한 내용은 [Symlinks in Windows 10\$1](https://blogs.windows.com/windowsdeveloper/2016/12/02/symlinks-windows-10/) 블로그 항목을 참조하세요.
Windows에서 Git을 사용하는 경우 개발자 모드를 활성화하거나 다음을 수행해야 합니다.
다음 명령을 사용하여 `core.symlinks`를 true로 설정합니다.
```
git config --global core.symlinks true
```
시스템에 쓰는 git 명령(예: **git pull**, **git clone** 및**git submodule update --init --recursive**)을 사용할 때마다 관리자 권한으로 승격되는 콘솔을 사용하세요.
[FreeRTOS 다운로드](freertos-prereqs.md#freertos-download)에서 언급했듯이 Cypress용 FreeRTOS 포트는 현재 [GitHub](https://github.com/aws/amazon-freertos)에서만 사용할 수 있습니다.
## 개요
이 자습서에는 다음의 시작하기 단계에 대한 지침이 포함되어 있습니다.
1. 마이크로 컨트롤러 보드용 내장형 애플리케이션을 개발 및 디버깅하기 위한 소프트웨어를 호스트 시스템에 설치합니다.
1. FreeRTOS 데모 애플리케이션을 바이너리 이미지로 크로스 컴파일합니다.
1. 애플리케이션 바이너리 이미지를 보드에 로드한 후 애플리케이션을 실행합니다.
1. 모니터링 및 디버깅을 위해 직렬 연결로 보드에서 실행되는 애플리케이션과 상호 작용합니다.
## 개발 환경 설정
### WICED Studio SDK 다운로드 및 설치
이 시작 안내서에서는 Cypress WICED Studio SDK를 사용하여 FreeRTOS 데모로 보드를 프로그래밍합니다. [WICED Software](https://www.cypress.com/products/wiced-software) 웹 사이트를 방문하여 Cypress에서 WICED Studio SDK를 다운로드합니다. 이 소프트웨어를 다운로드하려면 무료 Cypress 계정에 등록해야 합니다. WICED Studio SDK는 Windows, macOS, Linux 운영 체제와 호환됩니다.
**참고**
일부 운영 체제에는 추가 설치 단계가 필요합니다. 운영 체제와 설치하려는 WICED Studio 버전에 대한 모든 설치 지침을 읽고 따라야 합니다.
### 환경 변수 설정
WICED Studio를 사용하여 보드를 프로그래밍하기 전에 WICED Studio SDK 설치 디렉터리의 환경 변수를 만들어야 합니다. 변수를 만드는 동안 WICED Studio를 실행하는 경우, 변수를 설정한 후 애플리케이션을 다시 시작해야 합니다.
**참고**
WICED Studio 설치 관리자는 시스템에 `WICED-Studio-m.n`이라는 별도의 두 폴더를 생성합니다. 여기서 `m` 및 `n`은 각각 메이저 및 마이너 버전 번호입니다. 이 문서에서는 `WICED-Studio-6.2`의 폴더 이름을 가정하지만, 설치한 버전의 정확한 이름을 사용해야 합니다. `WICED_STUDIO_SDK_PATH` 환경 변수를 정의할 때 WICED Studio IDE의 설치 경로가 아닌, WICED Studio SDK의 전체 설치 경로를 지정해야 합니다. Windows 및 macOS에서는 SDK의 `WICED-Studio-m.n` 폴더가 기본적으로 `Documents` 폴더에 생성됩니다.
**Windows에서 환경 변수를 만들려면**
1. **제어판**을 열고 **시스템**을 선택한 후 **고급 시스템 설정**을 선택합니다.
1. **고급** 탭에서 **환경 변수**를 선택합니다.
1. **사용자 변수** 아래에서 **새로 만들기**를 선택합니다.
1. **변수 이름**에 **WICED\$1STUDIO\$1SDK\$1PATH**를 입력합니다. **변수 값**에 WICED Studio SDK 설치 디렉터리를 입력합니다.
**Linux 또는 macOS에서 환경 변수를 만들려면**
1. 시스템에서 `/etc/profile` 파일을 열고, 파일의 마지막 줄에 다음을 추가합니다.
```
export WICED_STUDIO_SDK_PATH=installation-path/WICED-Studio-6.2
```
1. 시스템을 다시 시작합니다.
1. 터미널을 열고 다음 명령을 실행합니다.
```
cd freertos/vendors/cypress/WICED_SDK
```
```
perl platform_adjust_make.pl
```
```
chmod +x make
```
## 직렬 연결 설정
**호스트 시스템과 보드 간의 직렬 연결을 설정하려면**
1. USB 스탠다드-A-마이크로-B 케이블을 사용하여 보드를 호스트 컴퓨터에 연결합니다.
1. 호스트 컴퓨터의 보드에 연결할 수 있도록 USB 직렬 포트 번호를 확인합니다.
1. 직렬 터미널을 시작하고 다음 설정으로 연결을 엽니다.
+ 전송 속도: 115200
+ 데이터: 8비트
+ 패리티: 없음
+ 정지 비트: 1
+ 흐름 제어: 없음
터미널 설치 및 직렬 연결 설정에 대한 자세한 내용은 [터미널 에뮬레이터 설치](gsg-troubleshooting.md#uart-term)를 참조하십시오.
## 클라우드에서 MQTT 메시지 모니터링
FreeRTOS 데모 프로젝트를 실행하기 전에 AWS IoT 콘솔에서 MQTT 클라이언트를 설정하여 디바이스가 AWS 클라우드로 보내는 메시지를 모니터링할 수 있습니다.
**MQTT 클라이언트를 사용하여 AWS IoT MQTT 주제를 구독하려면**
1. [AWS IoT 콘솔](https://console.aws.amazon.com/iotv2/)에 로그인합니다.
1. 탐색 창에서 **테스트**를 선택한 다음 **MQTT 테스트 클라이언트**를 선택하여 MQTT 클라이언트를 엽니다.
1. **구독 주제**에 ***your-thing-name*/example/topic**을 입력한 다음 **주제 구독**을 선택합니다.
## FreeRTOS 데모 프로젝트 빌드 및 실행
보드에 대해 직렬 연결을 설정했으면 FreeRTOS 데모 프로젝트를 빌드하고, 데모를 보드에 전송한 후 데모를 실행합니다.
**WICED Studio에서 FreeRTOS 데모 프로젝트를 빌드하고 실행하려면**
1. WICED Studio를 시작합니다.
1. **파일** 메뉴에서 **가져오기**를 선택합니다. `General` 폴더를 확장하고 **기존 프로젝트를 Workspace로**를 선택한 후 **다음**을 선택합니다.
1. **루트 디렉터리 선택**에서 **찾아보기...**를 선택하고 `freertos/projects/cypress/CYW943907AEVAL1F/wicedstudio` 경로로 이동한 후 **확인**을 선택합니다.
1. **프로젝트**에서 **aws\$1demo** 프로젝트의 상자만 선택합니다. **완료**를 선택하여 프로젝트를 가져옵니다. 대상 프로젝트 **aws\$1demo**가 **대상 만들기** 창에 나타나야 합니다.
1. **WICED 플랫폼** 메뉴를 확장하고 **WICED 필터 끄기**를 선택합니다.
1. **대상 만들기** 창에서 **aws\$1demo**를 확장하고 `demo.aws_demo` 파일을 마우스 오른쪽 버튼으로 누르고 **대상 빌드**를 선택하여 데모를 빌드하고 보드로 다운로드합니다. 데모를 빌드하여 보드에 다운로드하면 자동으로 실행되어야 합니다.
## 문제 해결
+ Windows를 사용하는 경우, 데모 프로젝트를 빌드 및 실행할 때 다음 오류가 표시될 수 있습니다.
```
: recipe for target 'download_dct' failed
make.exe[1]: *** [download_dct] Error 1
```
이 오류 문제를 해결하려면 다음을 수행합니다.
1. `WICED-Studio-SDK-PATH\WICED-Studio-6.2\43xxx_Wi-Fi\tools\OpenOCD\Win32`로 이동하고 `openocd-all-brcm-libftdi.exe` 파일을 두 번 클릭합니다.
1. `WICED-Studio-SDK-PATH\WICED-Studio-6.2\43xxx_Wi-Fi\tools\drivers\CYW9WCD1EVAL1`로 이동하고 `InstallDriver.exe` 파일을 두 번 클릭합니다.
+ Linux 또는 macOS를 사용하는 경우, 데모 프로젝트를 빌드 및 실행할 때 다음 오류가 표시될 수 있습니다.
```
make[1]: *** [download_dct] Error 127
```
이 오류 문제를 해결하려면 다음 명령을 사용하여 libusb-dev 패키지를 업데이트합니다.
```
sudo apt-get install libusb-dev
```
FreeRTOS 시작하기에 대한 일반 문제 해결 정보는 [시작하기 문제 해결](gsg-troubleshooting.md) 섹션을 참조하세요.