Microchip Curiosity PIC32MZ EF 시작하기 - 무료RTOS
개요Microchip Curiosity PIC32MZ EF 하드웨어 설정PKOB(PICkit On Board)를 사용하여 Microchip Curiosity PIC32MZ EF 하드웨어 설정개발 환경 설정클라우드에서 MQTT 메시지 모니터링FreeRTOS 데모 프로젝트 빌드 및 실행문제 해결

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Microchip Curiosity PIC32MZ EF 시작하기

중요

이 라이브러리는 더 이상 사용되지 않는 Amazon-FreeRTOS 리포지토리에서 호스팅됩니다. 새 프로젝트를 생성할 때는 여기서 시작하는 것이 좋습니다. 현재 사용되지 않는 Amazon-FreeRTOS 리포지토리를 기반으로 하는 기존 FreeRTOS 프로젝트가 이미 있는 경우에는 Amazon-FreeRTOS Github 리포지토리 마이그레이션 가이드 섹션을 참조하세요.

참고

Microchip의 합의에 따라 AWS는 FreeRTOS 참조 통합 리포지토리 메인 브랜치에서 Curiosity PIC32MZEF(DM320104)를 제거하고 새 릴리스에는 더 이상 제공하지 않을 예정입니다. Microchip은 PIC32MZEF(DM320104)를 더 이상 새로운 설계에 사용하지 않는 것이 좋다는 공지문을 발표했습니다. PIC32MZEF 프로젝트 및 소스 코드는 이전 릴리스 태그를 통해 계속 액세스할 수 있습니다. Microchip은 고객이 새로운 설계에 Curiosity PIC32MZ-EF-2.0 개발 보드(DM320209)를 사용할 것을 권장합니다. PIC32MZv1 플랫폼은 FreeRTOS 참조 통합 리포지토리의 v202012.00에서 계속 찾을 수 있습니다. 그러나 FreeRTOS 참조의 v202107.00에서는 이 플랫폼을 더 이상 지원하지 않습니다.

이 자습서에서는 Microchip Curiosity PIC32MZ EF를 시작하기 위한 지침을 제공합니다. Microchip Curiosity PIC32MZ EF 번들이 없는 경우 AWS Partner Device Catalog를 방문하여 파트너에서 구입하시기 바랍니다.

번들에는 다음 항목이 포함됩니다.

또한 디버깅을 위해 다음 항목도 필요합니다.

시작하려면 먼저 디바이스를 AWS 클라우드에 연결하도록 AWS IoT 및 FreeRTOS 다운로드를 구성해야 합니다. 자세한 내용은 첫 번째 단계 섹션을 참조하세요.

중요

  • 이 주제에서는 FreeRTOS 다운로드 디렉터리의 경로를 freertos이라고 합니다.

  • freertos 경로의 공백 문자로 인해 빌드 실패가 발생할 수 있습니다. 리포지토리를 복제하거나 복사할 때 생성하는 경로에 공백 문자가 없어야 합니다.

  • Microsoft Windows에서 파일 경로의 최대 길이는 260자입니다. FreeRTOS 다운로드 디렉터리 경로가 길면 빌드 오류가 발생할 수 있습니다.

  • 소스 코드에 심볼 링크가 포함될 수 있으므로 Windows를 사용하여 아카이브를 추출하는 경우 다음을 수행해야 할 수 있습니다.

    • 개발자 모드를 활성화합니다. 또는

    • 관리자 권한으로 승격된 콘솔을 사용합니다.

    이렇게 하면 Windows에서 아카이브를 추출할 때 심볼 링크를 제대로 생성할 수 있습니다. 그렇지 않으면 심볼 링크는 심볼 링크의 경로를 텍스트로 포함하는 일반 파일 또는 비어 있는 일반 파일로 작성됩니다. 자세한 내용은 Symlinks in Windows 10! 블로그 항목을 참조하세요.

    Windows에서 Git을 사용하는 경우 개발자 모드를 활성화하거나 다음을 수행해야 합니다.

    • 다음 명령을 사용하여 core.symlinks를 true로 설정합니다.

      git config --global core.symlinks true

    • 시스템에 쓰는 git 명령(예: git pull, git clone 및git submodule update --init --recursive)을 사용할 때마다 관리자 권한으로 승격되는 콘솔을 사용하세요.

개요

이 자습서에는 다음의 시작하기 단계에 대한 지침이 포함되어 있습니다.

  1. 보드를 호스트 시스템에 연결합니다.

  2. 마이크로 컨트롤러 보드용 내장형 애플리케이션을 개발 및 디버깅하기 위한 소프트웨어를 호스트 시스템에 설치합니다.

  3. FreeRTOS 데모 애플리케이션을 바이너리 이미지로 크로스 컴파일합니다.

  4. 애플리케이션 바이너리 이미지를 보드에 로드한 후 애플리케이션을 실행합니다.

  5. 모니터링 및 디버깅을 위해 직렬 연결로 보드에서 실행되는 애플리케이션과 상호 작용합니다.

Microchip Curiosity PIC32MZ EF 하드웨어 설정

  1. MikroElectronika USB UART Click Board를 Microchip Curiosity PIC32MZ EF의 microBUS 1 커넥터에 연결합니다.

  2. PIC32 LAN8720 PHY 도터 보드를 Microchip Curiosity PIC32MZ EF의 J18 헤더에 연결합니다.

  3. USB A - USB 미니 B 케이블을 사용하여 MikroElectronika USB UART Click Board를 컴퓨터에 연결합니다.

  4. 보드를 인터넷에 연결하려면 다음 옵션 중 하나를 사용하십시오.

    • Wi-Fi를 사용하려면 MikroElectronika Wi-Fi 7 클릭 보드를 Microchip Curiosity PIC32MZ EF의 microBUS 2 커넥터에 연결합니다. 무료RTOS 데모 구성 섹션을 참조하세요.

    • 이더넷을 사용하여 Microchip Curiosity PIC32MZ EF 보드를 인터넷에 연결하려면, PIC32 LAN8720 PHY 부속 보드를 Microchip Curiosity PIC32MZ EF의 J18 헤더에 연결합니다. 이더넷 케이블의 한 쪽 끝을 LAN8720 PHY 도터 보드에 연결합니다. 다른 쪽 끝을 라우터 또는 다른 인터넷 포트에 연결합니다. 또한 프리프로세서 매크로 PIC32_USE_ETHERNET을 정의해야 합니다.

  5. 아직 연결하지 않은 경우 앵글 커넥터를 Microchip Curiosity PIC32MZ EF의 ICSP 헤더에 납땜합니다.

  6. PICkit 3 Programming Cable Kit의 ICSP 케이블 한쪽 끝을 Microchip Curiosity PIC32MZ EF에 연결합니다.

    PICkit 3 Programming Cable Kit가 없는 경우 M-F Dupont 와이어 점퍼를 사용하여 연결합니다. 흰색 원은 Pin 1의 위치를 나타냅니다.

  7. ICSP 케이블(또는 점퍼)의 다른쪽 끝을 MPLAB Snap Debugger에 연결합니다. 8핀 SIL Programming Connector의 Pin 1은 보드 오른쪽 하단에 검은색 사각형으로 표시됩니다.

    Microchip Curiosity PIC32MZ EF의 Pin 1에 연결된 케이블(흰색 원으로 표시됨)이 MPLAB Snap Debugger의 Pin 1에 맞아야 합니다.

    MPLAB Snap Debugger에 대한 자세한 내용은 MPLAB Snap In-Circuit Debugger Information Sheet를 참조하세요.

PKOB(PICkit On Board)를 사용하여 Microchip Curiosity PIC32MZ EF 하드웨어 설정

이전 섹션의 설정 절차를 따르는 것이 좋습니다. 그러나 다음 단계에 따라 통합 PKOB(PICkit On Board) 프로그래머/디버거를 사용하여 기본 디버깅으로 FreeRTOS 데모를 평가 및 실행할 수 있습니다.

  1. MikroElectronika USB UART Click Board를 Microchip Curiosity PIC32MZ EF의 microBUS 1 커넥터에 연결합니다.

  2. 보드를 인터넷에 연결하려면 다음 중 하나를 수행합니다.

    • Wi-Fi를 사용하려면 MikroElectronika Wi-Fi 7 클릭 보드를 Microchip Curiosity PIC32MZ EF의 microBUS 2 커넥터에 연결합니다. (무료RTOS 데모 구성의 "Wi-Fi를 구성하려면"에 나오는 단계를 따르십시오.)

    • 이더넷을 사용하여 Microchip Curiosity PIC32MZ EF 보드를 인터넷에 연결하려면, PIC32 LAN8720 PHY 부속 보드를 Microchip Curiosity PIC32MZ EF의 J18 헤더에 연결합니다. 이더넷 케이블의 한 쪽 끝을 LAN8720 PHY 도터 보드에 연결합니다. 다른 쪽 끝을 라우터 또는 다른 인터넷 포트에 연결합니다. 또한 프리프로세서 매크로 PIC32_USE_ETHERNET을 정의해야 합니다.

  3. USB 마이크로 B 케이블에 대한 USB 타입 A를 사용하여 Microchip Curiosity PIC32MZ EF 보드의 "USB DEBUG"라는 USB 마이크로 B 포트를 컴퓨터에 연결합니다.

  4. USB A - USB 미니 B 케이블을 사용하여 MikroElectronika USB UART Click Board를 컴퓨터에 연결합니다.

개발 환경 설정

참고

이 디바이스의 FreeRTOS 프로젝트는 MPLAB Harmony v2를 기반으로 합니다. 프로젝트를 빌드하려면 MPLAB XC32 Compiler 버전 v2.10 및 MHLB Harmony Configurator(MHC) 버전 2.X.X와 같은 Harmony v2와 호환되는 MPLAB 도구 버전을 사용해야 합니다.

  1. Python 버전 3.x 이상을 설치합니다.

  2. MPLAB X IDE를 설치합니다.

    참고

    FreeRTOS AWS Reference Integrations v202007.00은 현재 MPLabv5.35에서만 지원됩니다. 이전 버전의 AWS FreeRTOS Reference Integrations는 MPLabv5.40에서 지원됩니다.

    MPLABv5.35 다운로드
    최신 MPLab 다운로드(MPLAb v5.40)

  3. MPLAB XC32 Compiler를 설치합니다.

  4. UART 터미널 에뮬레이터를 시작하고 다음 설정으로 연결을 엽니다.

    • 전송 속도: 115200

    • 데이터: 8비트

    • 패리티: 없음

    • 정지 비트: 1

    • 흐름 제어: 없음

클라우드에서 MQTT 메시지 모니터링

FreeRTOS 데모 프로젝트를 실행하기 전에 AWS IoT 콘솔에서 디바이스가 AWS 클라우드로 보내는 메시지를 모니터링하도록 MQTT 클라이언트를 설정할 수 있습니다.

AWS IoT MQTT 클라이언트를 사용하여 MQTT 주제를 구독하려면

  1. AWS IoT 콘솔에 로그인합니다.

  2. 탐색 창에서 테스트를 선택한 다음 MQTT 테스트 클라이언트를 선택하여 MQTT 클라이언트를 엽니다.

  3. 구독 주제에 your-thing-name/example/topic을 입력한 다음 주제 구독을 선택합니다.

데모 프로젝트가 디바이스에서 성공적으로 실행되면 ‘Hello World!’가 구독한 주제로 여러 번 전송된 것을 볼 수 있습니다.

FreeRTOS 데모 프로젝트 빌드 및 실행

MPLAB IDE에서 FreeRTOS 데모 열기

  1. MPLAB IDE를 엽니다. 두 개 이상의 컴파일러 버전이 설치된 경우 IDE에서 사용할 컴파일러를 선택해야 합니다.

  2. 파일 메뉴에서 Open Project(프로젝트 열기)를 선택합니다.

  3. projects/microchip/curiosity_pic32mzef/mplab/aws_demos로 이동하여 엽니다.

  4. Open project(프로젝트 열기)를 선택합니다.

참고

프로젝트를 처음 열면 컴파일러에 대한 오류 메시지가 표시될 수 있습니다. IDE에서 도구, 옵션, Embedded(임베디드)로 이동한 다음 프로젝트에 사용 중인 컴파일러를 선택합니다.

이더넷으로 연결하려면 프리프로세서 매크로 PIC32_USE_ETHERNET을 정의해야 합니다.

MPLAB IDE를 사용하여 이더넷으로 연결하려면

  1. MPLAB IDE에서 프로젝트를 마우스 오른쪽 버튼으로 클릭한 다음 속성을 선택합니다.

  2. 프로젝트 속성 대화 상자에서 compiler-name(글로벌 옵션)을 선택하여 확장한 다음 compiler-name-gcc를 선택합니다.

  3. 옵션 범주에서 전처리 및 메시지를 선택하고 PIC32_USE_ETHERNET 문자열을 프리프로세서 매크로에 추가합니다.

FreeRTOS 데모 프로젝트 실행

  1. 프로젝트를 다시 빌드합니다.

  2. Projects(프로젝트) 탭에서 aws_demos 최상위 수준 폴더를 마우스 오른쪽 버튼으로 클릭하고 Debug(디버그)를 선택합니다.

  3. 디버거가 main()의 중단점에서 중지되면 실행 메뉴에서 다시 시작을 선택합니다.

CMake로 FreeRTOS 데모 빌드

FreeRTOS 개발용 IDE를 사용하지 않으려는 경우 CMake를 사용하여 데모 애플리케이션이나 타사 코드 편집기 및 디버깅 도구를 사용하여 개발한 애플리케이션을 빌드하고 실행할 수 있습니다.

CMake로 FreeRTOS 데모를 빌드하려면

  1. 생성된 빌드 파일을 포함하는 디렉터리를 생성합니다(예: build-directory).

  2. 소스 코드에서 빌드 파일을 생성하려면 다음 명령을 사용합니다.

    cmake -DVENDOR=microchip -DBOARD=curiosity_pic32mzef -DCOMPILER=xc32 -DMCHP_HEXMATE_PATH=path/microchip/mplabx/version/mplab_platform/bin  -DAFR_TOOLCHAIN_PATH=path/microchip/xc32/version/bin -S freertos -B build-folder
    참고

    Hexmate 및 도구 체인 바이너리에 대한 올바른 경로를 지정해야 합니다(예: C:\Program Files (x86)\Microchip\MPLABX\v5.35\mplab_platform\bin 및 C:\Program Files\Microchip\xc32\v2.40\bin 경로).

  3. 디렉터리를 빌드 디렉터리(build-directory)로 변경하고 해당 디렉터리에서 make를 실행합니다.

자세한 내용은 FreeRTOS에서 CMake 사용 섹션을 참조하세요.

이더넷으로 연결하려면 프리프로세서 매크로 PIC32_USE_ETHERNET을 정의해야 합니다.

문제 해결

문제 해결 정보는 시작하기 문제 해결를 참조하세요.