기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# STMicroelectronics STM32L4 Discovery Kit IoT Node 시작하기
**중요**
이 라이브러리는 더 이상 사용되지 않는 Amazon-FreeRTOS 리포지토리에서 호스팅됩니다. 새 프로젝트를 생성할 때는 [여기서 시작](freertos-getting-started-modular.md)하는 것이 좋습니다. 현재 사용되지 않는 Amazon-FreeRTOS 리포지토리를 기반으로 하는 기존 FreeRTOS 프로젝트가 이미 있는 경우에는 [Amazon-FreeRTOS Github 리포지토리 마이그레이션 가이드](github-repo-migration.md) 섹션을 참조하세요.
이 자습서에서는 STMicroelectronics STM32L4 Discovery Kit IoT 노드를 시작하기 위한 지침을 제공합니다. STMicroelectronics STM32L4 Discovery Kit IoT 노드가 아직 없는 경우 AWS 파트너 디바이스 카탈로그를 방문하여 [파트너](https://devices.amazonaws.com/detail/a3G0L00000AANsWUAX/STM32L4-Discovery-Kit-IoT-Node)에서 구입하세요.
최신 Wi-Fi 펌웨어를 설치했는지 확인합니다. 최신 Wi-Fi 펌웨어를 다운로드하려면 [STM32L4 Discovery 키트 IoT 노드, 저전력 무선, Bluetooth Low Energy, NFC, SubGHz, Wi-Fi](https://www.st.com/resource/en/utilities/inventek_fw_updater.zip)를 참조하십시오. **Binary Resources(바이너리 리소스)**에서 **Inventek ISM 43362 Wi-Fi module firmware update (read the readme file for instructions)(Inventek ISM 43362 Wi-Fi 모듈 펌웨어 업데이트(지침은 readme 파일 참조))**를 선택합니다.
시작하기 전에 디바이스를 AWS 클라우드에 연결하도록 AWS IoT, FreeRTOS 다운로드 및 Wi-Fi를 구성해야 합니다. 자세한 내용은 [첫 번째 단계](freertos-prereqs.md) 섹션을 참조하세요. 이 자습서에서는 FreeRTOS 다운로드 디렉터리의 경로를 `{{freertos}}`라고 합니다.
## 개요
이 자습서에는 다음의 시작하기 단계에 대한 지침이 포함되어 있습니다.
1. 마이크로 컨트롤러 보드용 내장형 애플리케이션을 개발 및 디버깅하기 위한 소프트웨어를 호스트 시스템에 설치합니다.
1. FreeRTOS 데모 애플리케이션을 바이너리 이미지로 크로스 컴파일합니다.
1. 애플리케이션 바이너리 이미지를 보드에 로드한 후 애플리케이션을 실행합니다.
## 개발 환경 설정
### System Workbench for STM32 설치
1. [OpenSTM32.org](http://www.openstm32.org/HomePage)로 이동합니다.
1. OpenSTM32 웹 페이지에서 등록합니다. System Workbench를 다운로드하려면 로그인해야 합니다.
1. [System Workbench for STM32 설치 관리자](http://www.openstm32.org/System%2BWorkbench%2Bfor%2BSTM32)로 이동하여 System Workbench를 다운로드하고 설치합니다.
설치 중에 문제가 발생하면 [System Workbench 웹 사이트](http://www.openstm32.org/HomePage)의 FAQ를 참조하십시오.
## FreeRTOS 데모 프로젝트 빌드 및 실행
### FreeRTOS 데모를 STM32 System Workbench로 가져오기
1. STM32 System Workbench를 열고 새 작업 공간의 이름을 입력합니다.
1. **파일** 메뉴에서 **가져오기**를 선택합니다. **General(일반)**을 확장하고 **Existing Projects into Workspace(기존 프로젝트를 작업 공간으로)**를 선택한 다음 **Next(다음)**를 선택합니다.
1. **Select Root Directory(루트 디렉터리 선택)**에 `projects/st/stm32l475_discovery/ac6/aws_demos`를 입력합니다.
1. `aws_demos` 프로젝트가 기본적으로 선택되어야 합니다.
1. **Finish(완료)**를 선택하여 프로젝트를 STM32 System Workbench로 가져옵니다.
1. **Project(프로젝트)** 메뉴에서 **Build All(모두 빌드)**을 선택합니다. 오류 없이 프로젝트가 컴파일되는지 확인합니다.
### 클라우드에서 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**을 입력한 다음 **주제 구독**을 선택합니다.
데모 프로젝트가 디바이스에서 성공적으로 실행되면 ‘Hello World\!’가 구독한 주제로 여러 번 전송된 것을 볼 수 있습니다.
### FreeRTOS 데모 프로젝트 실행
1. USB 케이블을 사용하여 STMicroelectronics STM32L4 Discovery Kit IoT Node를 컴퓨터에 연결합니다. (사용할 올바른 USB 포트는 보드와 함께 제공된 제조업체 설명서를 참조하세요.)
1. **Project Explorer**에서 `aws_demos`를 마우스 오른쪽 버튼으로 클릭하고 **Debug As(다른 형식으로 디버그)**를 선택한 다음 **Ac6 STM32 C/C\+\+ Application(Ac6 STM32 C/C\+\+ 애플리케이션)**을 선택합니다.
디버그 세션을 처음 시작할 때 디버그 오류가 발생하는 경우 다음 단계를 따릅니다.
1. STM32 System Workbench의 **Run(실행)** 메뉴에서 **Debug Configurations(디버그 구성)**를 선택합니다.
1. **aws\_demos Debug(aws\_demos 디버그)**를 선택합니다. (**Ac6 STM32 Debugging(Ac6 STM32 디버깅)**을 확장해야 할 수 있습니다.)
1. **Debugger(디버거)** 탭을 선택합니다.
1. **Configuration Script(구성 스크립트)**에서 **Show Generator Options(생성기 옵션 표시)**를 선택합니다.
1. **Mode Setup(모드 설정)**에서 **Reset Mode(모드 재설정)**를 **Software System Reset(소프트웨어 시스템 재설정)**으로 설정합니다. [**Apply**]를 선택한 다음 [**Debug**]를 선택합니다.
1. 디버거가 `main()`의 중단점에서 중지되면 **실행** 메뉴에서 **다시 시작**을 선택합니다.
### FreeRTOS에서 CMake 사용
FreeRTOS 개발용 IDE를 사용하지 않으려는 경우 CMake를 사용하여 데모 애플리케이션이나 타사 코드 편집기 및 디버깅 도구를 사용하여 개발한 애플리케이션을 빌드하고 실행할 수 있습니다.
먼저 생성된 빌드 파일을 포함할 폴더({{build-folder}})를 생성합니다.
빌드 파일을 생성할 때는 다음 명령을 사용합니다.
```
cmake -DVENDOR=st -DBOARD=stm32l475_discovery -DCOMPILER=arm-gcc -S {{freertos}} -B {{build-folder}}
```
`arm-none-eabi-gcc`가 셸 경로에 없으면 `AFR_TOOLCHAIN_PATH` CMake 변수도 설정해야 합니다. 예제:
```
-D AFR_TOOLCHAIN_PATH=/home/user/opt/gcc-arm-none-eabi/bin
```
FreeRTOS에서 CMake를 사용하는 방법에 대한 자세한 내용은 [FreeRTOS에서 CMake 사용](getting-started-cmake.md) 섹션을 참조하세요.
## 문제 해결
데모 애플리케이션의 UART 출력에 다음이 나타나면 Wi-Fi 모듈의 펌웨어를 업데이트해야 할 수 있습니다.
```
[Tmr Svc] WiFi firmware version is: xxxxxxxxxxxxx
[Tmr Svc] [WARN] WiFi firmware needs to be updated.
```
최신 Wi-Fi 펌웨어를 다운로드하려면 [STM32L4 Discovery 키트 IoT 노드, 저전력 무선, Bluetooth Low Energy, NFC, SubGHz, Wi-Fi](https://www.st.com/resource/en/utilities/inventek_fw_updater.zip)를 참조하십시오. **Binary Resources(바이너리 리소스)**에서 **Inventek ISM 43362 Wi-Fi module firmware update(Inventek ISM 43362 Wi-Fi 모듈 펌웨어 업데이트)**의 다운로드 링크를 선택합니다.
FreeRTOS 시작하기에 대한 일반 문제 해결 정보는 [시작하기 문제 해결](gsg-troubleshooting.md) 섹션을 참조하세요.