STMicroelectronics STM32WBA 시리즈 시작하기

제품 정보

명세서:

• 제품 이름: STM32CubeWBA MCU 패키지
• 제조업체: ST마이크로일렉트로닉스
• 호환성: STM32WBA 시리즈 마이크로컨트롤러
• 라이센스: 오픈 소스 BSD 라이선스

제품 사용 지침

STM32CubeWBA MCU 패키지의 주요 특징:
STM32CubeWBA MCU 패키지는 STM32WBA 시리즈 마이크로컨트롤러에서 애플리케이션을 개발하는 데 필요한 모든 내장형 소프트웨어 구성 요소를 제공합니다. STM32 시리즈 내에서 이식성이 뛰어나며 HAL 및 LL API와 함께 제공됩니다.amp파일 및 미들웨어 구성 요소.

아키텍처 오버view:
STM32CubeWBA MCU 패키지의 아키텍처는 애플리케이션, 라이브러리 및 프로토콜 기반 구성 요소, 하드웨어 추상화 계층, BSP 드라이버, 코어 드라이버 및 하위 계층 API의 세 가지 수준으로 구성됩니다.

자주 묻는 질문

• STM32CubeWBA MCU 패키지에는 무엇이 포함되어 있나요?
  패키지에는 하위 계층(LL) 및 하드웨어 추상화 계층(HAL) API가 포함되어 있습니다.amp파일, 애플리케이션, 미들웨어 구성요소 FileX/LevelX, NetX Duo, mbed-crypto 라이브러리 등.
• STM32CubeWBA MCU 패키지는 STM32CubeMX 코드 생성기와 호환됩니까?
  예, 패키지는 초기화 코드 생성을 위한 STM32CubeMX 코드 생성기와 완벽하게 호환됩니다.

소개

• STM32Cube는 개발 노력, 시간, 비용을 줄여 설계자의 생산성을 크게 향상시키기 위한 STMicroelectronics의 독창적인 이니셔티브입니다. STM32Cube는 전체 STM32 포트폴리오를 포괄합니다.
  STM32Cube에는 다음이 포함됩니다.
  • 개념에서 실현까지 프로젝트 개발을 포괄하는 사용자 친화적인 소프트웨어 개발 도구 세트는 다음과 같습니다.
    • 그래픽 마법사를 사용하여 C 초기화 코드를 자동으로 생성할 수 있는 그래픽 소프트웨어 구성 도구인 STM32CubeMX
    • STM32CubeIDE, 주변 장치 구성, 코드 생성, 코드 컴파일 및 디버그 기능을 갖춘 올인원 개발 도구
    • 코드 컴파일, 보드 프로그래밍 및 디버그 기능을 갖춘 올인원 명령줄 개발 도구 세트인 STM32CubeCLT
    • 그래픽 및 명령줄 버전에서 사용할 수 있는 프로그래밍 도구인 STM32CubeProgrammer(STM32CubeProg)
    • STM32CubeMonitor(STM32CubeMonitor, STM32CubeMonPwr, STM32CubeMonRF, STM32CubeMonUCPD)는 STM32 애플리케이션의 동작과 성능을 실시간으로 미세 조정하는 강력한 모니터링 도구입니다.
  • STM32Cube MCU 및 MPU 패키지는 각 마이크로컨트롤러 및 마이크로프로세서 시리즈(예: STM32WBA 시리즈용 STM32CubeWBA)에 특정한 포괄적인 내장형 소프트웨어 플랫폼으로 다음을 포함합니다.
    • STM32Cube 하드웨어 추상화 계층(HAL), STM32 포트폴리오 전반에 걸쳐 극대화된 이식성 보장
    • STM32Cube 하위 계층 API, 하드웨어에 대한 높은 수준의 사용자 제어로 최고의 성능 및 설치 공간 보장
    • ThreadX와 같은 일관된 미들웨어 구성 요소 집합, FileX / LevelX, NetX Duo, USBX, 터치 라이브러리, mbed-crypto, TFM, MCUboot, OpenBL 및 STM32_WPAN(Bluetooth® Low Energy pro 포함)file및 서비스, Mesh, Zigbee®, OpenThread, Matter 및 802.15.4 MAC 계층)
    • 주변 장치 및 응용 프로그램의 전체 세트가 포함된 모든 임베디드 소프트웨어 유틸리티amp레
  • 다음을 통해 STM32Cube MCU 및 MPU 패키지의 기능을 보완하는 임베디드 소프트웨어 구성 요소가 포함된 STM32Cube 확장 패키지:
    • 미들웨어 확장 및 적용 계층
    • Examp일부 특정 STMicroelectronics 개발 보드에서 실행되는 파일
• 이 사용자 매뉴얼은 STM32CubeWBA MCU 패키지를 시작하는 방법을 설명합니다.
  • 섹션 2 STM32CubeWBA 주요 기능에서는 STM32CubeWBA MCU 패키지의 주요 기능을 설명합니다.
  • 섹션 3 STM32CubeWBA 아키텍처view 이상을 제공view STM32CubeWBA 아키텍처 및 MCU 패키지 구조.

일반 정보

STM32CubeWBA MCU 패키지는 Arm® TrustZone® 및 FPU를 갖춘 Arm® Cortex®-M32 프로세서 기반 STM32 33비트 마이크로컨트롤러에서 실행됩니다.
메모: Arm 및 TrustZone은 미국 및/또는 기타 지역에서 Arm Limited(또는 그 자회사)의 등록 상표입니다.

STM32CubeWBA 주요 기능

• STM32CubeWBA MCU 패키지는 TrustZone® 및 FPU를 갖춘 Arm® Cortex®-M32 프로세서 기반 STM32 33비트 마이크로컨트롤러에서 실행됩니다.
• STM32CubeWBA는 STM32WBA 시리즈 마이크로컨트롤러용 애플리케이션을 개발하는 데 필요한 모든 일반 임베디드 소프트웨어 구성 요소를 단일 패키지에 모았습니다. STM32Cube 이니셔티브에 따라 이 구성 요소 세트는 STM32WBA 시리즈 마이크로 컨트롤러 내에서뿐만 아니라 다른 STM32 시리즈에서도 이식성이 뛰어납니다.
• STM32CubeWBA는 STM32CubeMX 코드 생성기와 완벽하게 호환되어 초기화 코드를 생성합니다. 패키지에는 마이크로컨트롤러 하드웨어를 포괄하는 LL(낮은 계층) 및 HAL(하드웨어 추상화 계층) API와 광범위한 EX API 세트가 포함되어 있습니다.ampSTMicroelectronics 보드에서 실행되는 파일입니다. HAL 및 LL API는 사용자 편의를 위해 오픈 소스 BSD 라이센스로 제공됩니다.
• STM32CubeWBA MCU 패키지에는 Microsoft® Azure® RTOS 미들웨어와 기타 내부 및 오픈 소스 스택을 중심으로 구성된 포괄적인 미들웨어 구성 요소도 포함되어 있습니다.amp레.
• 사용자 친화적인 무료 라이센스 조건이 제공됩니다.
  • 모든 기능을 갖춘 통합형 Azure® RTOS: Azure® RTOS ThreadX
  • Azure® RTOS ThreadX를 사용한 CMSIS-RTOS 구현
  • 다양한 클래스와 함께 제공되는 USB 호스트 및 장치 스택: Azure® RTOS USBX
  • 고급의 file 시스템 및 플래시 번역 레이어: FileX / 레벨X
  • 산업용 등급 네트워킹 스택: 다양한 IoT 프로토콜의 성능에 최적화됨: NetX Duo
  • 오픈부트로더
  • Arm® Trusted Firmware-M(TF‑M) 통합 솔루션
  • mbed 암호화 라이브러리
  • ST 네트워크 라이브러리
  • STMTouch 터치 센싱 라이브러리 솔루션
• 이러한 모든 미들웨어 구성 요소를 구현하는 여러 애플리케이션과 데모도 STM32CubeWBA MCU 패키지에 제공됩니다.
• STM32CubeWBA MCU 패키지 구성요소 레이아웃은 그림 1에 설명되어 있습니다. STM32CubeWBA MCU 패키지 구성요소.

  

STM32CubeWBA 아키텍처 이상view

STM32CubeWBA MCU 패키지 솔루션은 그림 2. STM32CubeWBA MCU 패키지 아키텍처에 설명된 대로 쉽게 상호 작용하는 세 가지 독립적인 레벨을 중심으로 구축되었습니다.

레벨 0

이 수준은 세 가지 하위 계층으로 나뉩니다.

• 보드 지원 패키지(BSP).
• 하드웨어 추상화 계층(HAL):
  • HAL 주변 장치 드라이버
  • 낮은 계층 드라이버
• 기본 주변기기 사용법 예시amp레.

보드 지원 패키지(BSP)
이 계층은 하드웨어 보드의 하드웨어 구성 요소(예: LCD, 오디오, microSD™ 및 MEMS 드라이버)와 관련된 API 세트를 제공합니다. 이는 두 부분으로 구성됩니다.

• 구성 요소 드라이버:
  이 드라이버는 STM32 장치가 아닌 보드의 외부 장치와 관련이 있습니다. 구성 요소 드라이버는 BSP 드라이버 외부 구성 요소에 특정 API를 제공하며 다른 보드에 이식할 수 있습니다.
• BSP 드라이버:
  BSP 드라이버를 사용하면 구성 요소 드라이버를 특정 보드에 연결할 수 있으며 사용자에게 친숙한 일련의 드라이버를 제공합니다.
  아피스. API 명명 규칙은 BSP_FUNCT_Action()입니다.
  Examp파일: BSP_LED_Init(), BSP_LED_On()
  BSP는 낮은 수준의 루틴을 구현함으로써 모든 하드웨어에 쉽게 포팅할 수 있는 모듈식 아키텍처를 기반으로 합니다.

HAL(하드웨어 추상화 계층) 및 LL(하위 계층)
STM32CubeWBA HAL 및 LL은 상호 보완적이며 광범위한 애플리케이션 요구 사항을 포괄합니다.

• HAL 드라이버는 높은 수준의 기능 중심, 이식성이 뛰어난 API를 제공합니다. 이는 최종 사용자에게 MCU 및 주변 장치의 복잡성을 숨깁니다.
  HAL 드라이버는 즉시 사용 가능한 프로세스를 제공하여 사용자 애플리케이션 구현을 단순화하는 일반 다중 인스턴스 기능 지향 API를 제공합니다. 예를 들어ample, 통신 주변기기(I2S, UART 등)에 대해 주변기기 초기화 및 구성, 폴링, 인터럽트 또는 DMA 프로세스를 기반으로 데이터 전송을 관리하고, 통신 중에 발생할 수 있는 통신 오류를 처리할 수 있는 API를 제공합니다. HAL 드라이버 API는 두 가지 범주로 나뉩니다.
  1. 모든 STM32 시리즈 마이크로컨트롤러에 공통적이고 일반적인 기능을 제공하는 일반 API입니다.
  2. 특정 제품군 또는 특정 부품 번호에 대해 구체적이고 사용자 정의된 기능을 제공하는 확장 API입니다.
• 하위 계층 API는 레지스터 수준에서 최적화가 향상되었지만 이식성이 떨어지는 하위 수준 API를 제공합니다.
  • MCU 및 주변 장치 사양에 대한 깊은 지식이 필요합니다.
  • LL 드라이버는 HAL보다 하드웨어에 더 가까운 빠르고 가벼운 전문가 중심 레이어를 제공하도록 설계되었습니다. HAL과 달리 LL API는 최적화된 액세스가 핵심 기능이 아닌 주변 장치나 무거운 소프트웨어 구성 또는 복잡한 상위 수준 스택이 필요한 주변 장치에는 제공되지 않습니다.
  • LL 드라이버 기능:
    • 데이터 구조에 지정된 매개변수에 따라 주변 주요 기능을 초기화하는 기능 세트입니다.
    • 각 필드에 해당하는 재설정 값으로 초기화 데이터 구조를 채우는 함수 세트입니다.
    • 주변 장치 초기화 해제 기능(주변 장치 레지스터가 기본값으로 복원됨)
    • 직접 및 원자 레지스터 액세스를 위한 인라인 함수 세트입니다.
    • HAL로부터 완전히 독립되어 있으며 독립형 모드(HAL 드라이버 없이)에서 사용할 수 있습니다.
    • 지원되는 주변 장치 기능을 모두 포괄합니다.

기본 주변기기 사용법 예시amp레
이 레이어는 ex를 포함합니다.ampHAL 및 BSP 리소스만 사용하여 STM32 주변 장치에 구축된 파일입니다.

레벨 1

이 수준은 두 개의 하위 계층으로 나뉩니다.

• 미들웨어 구성요소
• Examp미들웨어 구성 요소를 기반으로 하는 파일

미들웨어 구성요소

• 미들웨어는 Bluetooth® Low Energy(Linklayer, HCI, Stack), Thread®, Zigbee®,
• Matter, OpenBootloader, Microsoft® Azure® RTOS, TF-M, MCUboot 및 mbed-crypto.
• 이 레이어의 구성 요소 간의 수평적 상호 작용은 주요 API를 호출하여 수행됩니다.
• 하위 계층 드라이버와의 수직 상호 작용은 라이브러리 시스템 호출 인터페이스에 구현된 특정 콜백 및 정적 매크로를 통해 수행됩니다.
• 각 미들웨어 구성요소의 주요 기능은 다음과 같습니다.
  • Microsoft® Azure® RTOS
    • Azure® RTOS ThreadX: 두 가지 기능 모드를 갖춘 임베디드 시스템용으로 설계된 RTOS(실시간 운영 체제)입니다.
      • 공통 모드: 스레드 관리 및 동기화, 메모리 풀 관리, 메시징 및 이벤트 처리와 같은 일반적인 RTOS 기능입니다.
      • 모듈 모드: 모듈 관리자를 통해 즉시 사전 링크된 ThreadX 모듈을 로드 및 언로드할 수 있는 고급 사용자 모드입니다.
    • NetX 듀오
    • FileX
    • USBX
  • Bluetooth® 저에너지(BLE): 링크 및 스택 계층에 대해 Bluetooth® 저에너지 프로토콜을 구현합니다.
  • MCUboot(오픈 소스 소프트웨어)
  • 스택 및 관련 클러스터를 위한 Zigbee® 프로토콜.
  • Thread® 프로토콜 스택 및 링크 계층.
  • Arm® 신뢰할 수 있는 펌웨어-M, TF‑M(오픈 소스 소프트웨어): 관련 보안 서비스를 갖춘 TrustZone®용 Arm® 플랫폼 보안 아키텍처(PSA)의 참조 구현입니다.
  • mbed-crypto(오픈 소스 소프트웨어): mbed-crypto 미들웨어는 PSA 암호화 API 구현을 제공합니다.
  • STM32 터치 감지 라이브러리: 근접, 터치키, 선형 및 회전식 터치 센서를 지원하는 견고한 STMTouch 정전식 터치 감지 솔루션입니다. 이는 검증된 표면 전하 이동 획득 원리를 기반으로 합니다.

Examp미들웨어 구성 요소를 기반으로 하는 파일
각 미들웨어 구성요소에는 하나 이상의 ex가 포함되어 있습니다.amp사용 방법을 보여주는 파일(응용 프로그램이라고도 함)입니다. 통합 전amp여러 미들웨어 구성 요소를 사용하는 파일도 제공됩니다.

STM32CubeWBA 펌웨어 패키지 이상view

지원되는 STM32WBA 시리즈 장치 및 하드웨어

• STM32Cube는 일반 아키텍처를 기반으로 구축된 휴대성이 뛰어난 HAL(하드웨어 추상화 계층)을 제공합니다. 미들웨어 레이어를 사용하여 어떤 MCU가 사용되는지 심층적으로 알지 않고도 기능을 구현하는 것과 같은 레이어 기반 구축 원칙을 허용합니다. 이는 라이브러리 코드 재사용성을 향상시키고 다른 장치로의 쉬운 이식성을 보장합니다.
• 또한 STM32CubeWBA는 계층형 아키텍처 덕분에 모든 STM32WBA 시리즈를 완벽하게 지원합니다.
• 사용자는 stm32wbaxx.h에서 올바른 매크로를 정의하기만 하면 됩니다.
• 표 1은 사용되는 STM32WBA 시리즈 장치에 따라 정의하는 매크로를 보여줍니다. 이 매크로는 컴파일러 전처리기에서도 정의되어야 합니다.
  표 1. STM32WBA 시리즈용 매크로

  stm32wbaxx.h에 정의된 매크로	STM32WBA 시리즈 장치
  stm32wba52xx	STM32WBA52CGU6, STM32WBA52KGU6, STM32WBA52CEU6, STM32WBA52KEU6
  stm32wba55xx	STM32WBA55CGU6, STM32WBA55CGU6U, STM32WBA55CGU7, STM32WBA55CEU6, STM32WBA55CEU7

   
• STM32CubeWBA는 풍부한 EX 기능 세트를 갖추고 있습니다.amp모든 수준의 파일 및 애플리케이션을 통해 HAL 드라이버 또는 미들웨어 구성 요소를 쉽게 이해하고 사용할 수 있습니다. 이 전amp파일은 표 2에 나열된 STMicroelectronics 보드에서 실행됩니다.
  표 2. STM32WBA 시리즈용 보드

  판자	보드 STM32WBA 지원 장치
  NUCLEO-WBA52CG	STM32WBA52CGU6
  NUCLEO-WBA55CG	STM32WBA55CGU6
  STM32WBA55-DK1	STM32WBA55CGU7

• STM32CubeWBA MCU 패키지는 모든 호환 하드웨어에서 실행될 수 있습니다. 사용자는 제공된 ex를 포팅하기 위해 BSP 드라이버를 업데이트하기만 하면 됩니다.amp후자가 동일한 하드웨어 기능(예: LED, LCD 디스플레이 및 버튼)을 갖는 경우 보드에 파일을 저장합니다.

펌웨어 패키지 종료view

• STM32CubeWBA 패키지 솔루션은 그림 3에 표시된 구조를 갖는 하나의 단일 zip 패키지로 제공됩니다. STM32CubeWBA 펌웨어 패키지 구조.

  

• 각 보드에 대해 ex 세트amp파일은 EWARM, MDK-ARM 및 STM32CubeIDE 도구 체인에 대해 사전 구성된 프로젝트와 함께 제공됩니다.
• 그림 4. STM32CubeWBA 예amp끝났어view NUCLEO‑WBA52CG, NUCLEO-WBA55CG 및 STM32WBA55G-DK1 보드의 프로젝트 구조를 보여줍니다.

  

• 전직amp파일은 적용되는 STM32Cube 레벨에 따라 분류되며 다음과 같이 이름이 지정됩니다.
  • 레벨 0 예amples는 Ex라고 불려요amp레, 엑스amples_LL 및 Examples_MIX. 미들웨어 구성 요소 없이 각각 HAL 드라이버, LL 드라이버, HAL과 LL 드라이버 혼합을 사용합니다.
  • 레벨 1 예amp파일을 응용프로그램이라고 합니다. 각 미들웨어 구성 요소의 일반적인 사용 사례를 제공합니다. 특정 보드에 대한 모든 펌웨어 애플리케이션은 Templates 및 Templates_LL 디렉토리에서 사용할 수 있는 템플릿 프로젝트 덕분에 빠르게 구축될 수 있습니다.

TrustZone® 지원 프로젝트

• TrustZone® 지원 Examp파일 이름에는 _TrustZone 접두사가 포함됩니다. 이 규칙은 애플리케이션에도 적용됩니다(기본적으로 TrustZone®용인 TFM 및 SBSFU 제외).
• TrustZone® 지원 Examp파일과 애플리케이션은 그림 5에 표시된 것처럼 보안 하위 프로젝트와 비보안 하위 프로젝트로 구성된 다중 프로젝트 구조로 제공됩니다. 다중 프로젝트 보안 및 비보안 프로젝트 구조.
• TrustZone® 지원 프로젝트는 시스템 파티셔닝 헤더를 포함하도록 확장된 CMSIS-5 장치 템플릿에 따라 개발되었습니다. file 분할_ .h는 SAU(보안 속성 단위), FPU 설정 및 보안 실행 상태에서 보안/비보안 인터럽트 할당을 주로 담당합니다.
• 이 설정은 보안 애플리케이션 main() 함수에 들어가기 전에 시작 시 호출되는 보안 CMSIS SystemInit() 함수에서 수행됩니다. 소프트웨어 지침은 Arm® TrustZone®-M 문서를 참조하세요.

  

• STM32CubeWBA 패키지 펌웨어 패키지는 파티션에 기본 메모리 파티셔닝을 제공합니다. .시간 file\Drivers\CMSIS\Device\ST\STM32WBAxx\Include\T 템플릿에서 사용 가능
• 이들 파티션에는 files, SAU는 기본적으로 비활성화되어 있습니다. 결과적으로 IDAU 메모리 매핑은 보안 속성에 사용됩니다. RM0495 참조 매뉴얼의 TrustZone® 기술을 사용한 보안/비보안 파티셔닝 그림을 참조하세요.
• 사용자가 SAU를 활성화하면 기본 SAU 지역 구성이 파티션에 미리 정의됩니다. files는 다음과 같습니다:
  • SAU 영역 0: 0x08080000 – 0x081FFFFF(플래시 메모리의 비보안 보안 절반(512KB))
  • SAU 지역 1: 0x0BF88000 – 0x0BF97FFF(비보안 시스템 메모리)
  • SAU 지역 2: 0x0C07E000 – 0x0C07FFFF(보안, 비보안 호출 가능)
  • SAU 영역 3: 0x20010000 – 0x2001FFFF(비보안 SRAM2(64KB))
  • SAU 영역 4: 0x40000000 – 0x4FFFFFFF(비보안 주변 장치 매핑 메모리)
• 기본 파티셔닝을 일치시키려면 STM32WBAxx 시리즈 장치에는 다음과 같은 사용자 옵션 바이트 세트가 있어야 합니다.
  • TZEN = 1(TrustZone® 지원 장치)
  • SECWM1_PSTRT = 0x0 SECWM1_PEND = 0x3F (내부 플래시 메모리 64페이지 중 128페이지가 보안으로 설정됨) 참고: 내부 플래시 메모리는 TZEN = 1에서 기본적으로 완전히 안전합니다. 사용자 옵션 바이트 SECWM1_PSTRT/SECWM1_PEND는 애플리케이션에 따라 설정되어야 합니다. 메모리 구성(SAU 영역, SAU가 활성화된 경우) 보안/비보안 애플리케이션 프로젝트 링커 files도 정렬되어야 합니다.
• 모든 전amp파일의 구조는 동일합니다.
  • 모든 헤더를 포함하는 \Inc 폴더 files.
  • 소스 코드가 포함된 Src 폴더입니다.
  • 각 툴체인에 대해 사전 구성된 프로젝트가 포함된 \EWARM, \MDK-ARM 및 \STM32CubeIDE 폴더입니다.
  • ex를 설명하는 readme.md 및 readme.htmlamp행동과 그것이 작동하도록 하는 데 필요한 환경.
  • 아이오씨 file 이를 통해 사용자는 대부분의 펌웨어 ex를 열 수 있습니다.ampSTM32CubeMX 내의 파일.

STM32CubeWBA 시작하기

첫 번째 HAL ex 실행ample

이 섹션에서는 첫 번째 ex를 실행하는 것이 얼마나 간단한지 설명합니다.ampSTM32CubeWBA 내의 파일입니다. NUCLEO-WBA52CG 보드에서 실행되는 간단한 LED 토글 생성을 예시로 사용합니다.

1. STM32CubeWBA MCU 패키지를 다운로드하세요.
2. 원하는 디렉토리에 압축을 푼다.
3. 그림 1에 표시된 패키지 구조를 수정하지 마십시오. 루트 볼륨(C:\ST 또는 G:\Tests)에 가까운 위치에 패키지를 복사하는 것이 좋습니다. 일부 IDE에서는 경로가 변경될 때 문제가 발생하기 때문입니다. 길이가 너무 깁니다.

첫 번째 TrustZone® 활성화 ex 실행ample

• TrustZone® 지원 ex를 로드하고 실행하기 전ample, ex를 읽어야합니다amp읽어보기 file 특정 구성에 대해 섹션 4.2.1 TrustZone® 지원 프로젝트(TZEN=1(사용자 옵션 바이트))에 설명된 대로 보안이 활성화되도록 합니다.
  1. \Projects\NUCLEO-WBA52CG\Ex로 이동합니다.amp레.
  2. \GPIO를 연 다음 \GPIO_IOToggle_TrustZone 폴더를 엽니다.
  3. 원하는 도구 체인을 사용하여 프로젝트를 엽니다. 빨리 끝내세요view ex를 열고, 빌드하고, 실행하는 방법에 대해 알아보세요.amp지원되는 툴체인이 포함된 파일은 아래와 같습니다.
  4. 모든 보안 프로젝트와 비보안 프로젝트를 순서대로 다시 빌드하세요. files를 실행하고 보안 이미지와 비보안 이미지를 대상 메모리에 로드합니다.
  5. 전을 실행ample: 정기적으로 보안 애플리케이션은 2초마다 LD3를 전환하고, 비보안 애플리케이션은 LDXNUMX를 두 배 빠르게 전환합니다. 자세한 내용은 읽어보기를 참조하세요. file 전의amp르.
• ex를 열고, 빌드하고, 실행하려면amp지원되는 툴체인을 사용하려면 아래 단계를 따르세요.
  • EWARM:
    1. 전직에서amp파일 폴더에서 \EWARM 하위 폴더를 엽니다.
    2. Project.eww 작업공간 실행
    3. xxxxx_S 보안 프로젝트 다시 빌드 files: [프로젝트]>[모두 다시 빌드].
    4. xxxxx_NS 비보안 프로젝트를 활성 애플리케이션으로 설정합니다(xxxxx_NS 프로젝트를 마우스 오른쪽 버튼으로 클릭[활성으로 설정]).
    5. xxxxx_NS 비보안 프로젝트를 다시 빌드합니다. files: [프로젝트]>[모두 다시 빌드].
    6. [프로젝트]>[다운로드]>[활성 애플리케이션 다운로드]를 사용하여 비보안 바이너리를 플래시합니다.
    7. xxxxx_S를 활성 애플리케이션으로 설정합니다(xxxxx_S 프로젝트 [활성으로 설정]를 마우스 오른쪽 버튼으로 클릭합니다.
    8. [다운로드 및 디버그](Ctrl+D)를 사용하여 보안 바이너리를 플래시합니다.
    9. 프로그램 실행: [디버그]>[Go(F5)]
  • MDK-ARM:
    1. \MDK-ARM 도구 체인을 엽니다.
    2. 다중 프로젝트 작업 영역 열기 file 프로젝트.uvmpw.
    3. xxxxx_s 프로젝트를 활성 애플리케이션으로 선택합니다([활성 프로젝트로 설정]).
    4. xxxxx_s 프로젝트를 빌드합니다.
    5. xxxxx_ns 프로젝트를 활성 프로젝트로 선택합니다([활성 프로젝트로 설정]).
    6. xxxxx_ns 프로젝트를 빌드합니다.
    7. 비보안 바이너리를 로드합니다([F8]). \MDK-ARM\xxxxx_ns\Exe\xxxxx_ns.axf를 플래시 메모리로 다운로드합니다.
    8. Project_s 프로젝트를 활성 프로젝트로 선택합니다([활성 프로젝트로 설정]).
    9. 보안 바이너리를 로드합니다([F8]). 그러면 \MDK-ARM\xxxxx_s\Exe\xxxxx_s.axf가 플래시 메모리로 다운로드됩니다.
    10. 전을 실행amp르.
  • STM32큐브IDE:
    1. STM32CubeIDE 툴체인을 엽니다.
    2. 다중 프로젝트 작업 영역 열기 file .프로젝트.
    3. xxxxx_Secure 프로젝트를 다시 빌드하십시오.
    4. xxxxx_NonSecure 프로젝트를 다시 빌드합니다.
    5. 보안 프로젝트를 위해 [STM32 Cortex-M C/C++로 디버그] 애플리케이션을 실행합니다.
    6. [구성 편집] 창에서 [시작] 패널을 선택하고 보안되지 않은 프로젝트의 이미지와 심볼을 추가 로드합니다.
       중요한: 비보안 프로젝트는 보안 프로젝트보다 먼저 로드되어야 합니다.
    7. [확인]을 클릭하세요.
    8. 전을 실행amp디버그 관점에 관한 파일입니다.

첫 번째 TrustZone® 실행이 비활성화되었습니다. example

• TrustZone®을 로드하고 실행하기 전에 비활성화됨 example, ex를 읽어야합니다amp읽어보기 file 특정 구성의 경우. 특별한 언급이 없으면 보드 장치의 보안이 비활성화되어 있는지 확인하십시오(TZEN=0(사용자 옵션 바이트)). TZEN = 0으로의 선택적 회귀 수행에 대해서는 FAQ를 참조하세요.
  1. \Projects\NUCLEO-WBA52CG\Ex로 이동합니다.amp레.
  2. \GPIO를 연 다음 \GPIO_EXTI 폴더를 엽니다.
  3. 원하는 도구 체인을 사용하여 프로젝트를 엽니다. 빨리 끝내세요view ex를 열고, 빌드하고, 실행하는 방법에 대해 알아보세요.amp지원되는 툴체인이 포함된 파일은 아래와 같습니다.
  4. 모두 재 구축 files를 선택하고 이미지를 대상 메모리에 로드합니다.
  5. 전을 실행ample: [USER] 푸시 버튼을 누를 때마다 LD1 LED가 전환됩니다. 자세한 내용은 읽어보기를 참조하세요. file 전의amp르.
• ex를 열고, 빌드하고, 실행하려면amp지원되는 툴체인을 사용하려면 아래 단계를 따르세요.
  • EWARM:
    1. 전직에서amp파일 폴더에서 \EWARM 하위 폴더를 엽니다.
    2. Project.eww 작업 공간을 시작합니다(작업 공간 이름은 이전 이름에서 변경될 수 있음).amp다른 사람에게).
    3. 모두 재 구축 files: [프로젝트]>[모두 다시 빌드].
    4. 프로젝트 이미지를 로드합니다: [프로젝트]>[디버그].
    5. 프로그램 실행: [디버그]>[이동(F5)].
  • MDK-ARM:
    1. 전직에서amp파일 폴더에서 \MDK-ARM 하위 폴더를 엽니다.
    2. Project.uvproj 작업 공간을 시작합니다(작업 공간 이름은 예에서 변경될 수 있음).amp다른 사람에게).
    3. 모두 재 구축 files:[프로젝트]>[모든 대상 다시 빌드 fileNS].
    4. 프로젝트 이미지를 로드합니다: [디버그]>[디버그 세션 시작/중지].
    5. 프로그램 실행: [디버그]>[실행(F5)].
  • STM32큐브IDE:
    1. STM32CubeIDE 툴체인을 엽니다.
    2. [File]>[작업 공간 전환]>[기타]를 선택하고 STM32CubeIDE 작업 공간 디렉터리를 찾습니다.
    3. [File]>[가져오기] 에서 [일반]>[기존 프로젝트를 작업공간으로]를 선택한 후 [다음]을 클릭하세요.
    4. STM32CubeIDE 작업 공간 디렉터리로 이동하여 프로젝트를 선택합니다.
    5. 모든 프로젝트를 다시 빌드 files: [프로젝트 탐색기] 창에서 프로젝트를 선택한 후 [프로젝트]>[프로젝트 빌드] 메뉴를 클릭합니다.
    6. 프로그램 실행: [실행]>[디버그(F11)]

맞춤형 애플리케이션 개발

메모: 플래시 메모리에서 0 대기 상태 실행을 얻고 최대 성능과 더 나은 전력 소비에 도달하려면 소프트웨어가 명령어 캐시(ICACHE)를 활성화해야 합니다.

STM32CubeMX를 사용하여 애플리케이션 개발 또는 업데이트

• STM32CubeWBA MCU 패키지에서는 거의 모든 프로젝트가amp파일은 STM32CubeMX 도구를 사용하여 생성되어 시스템, 주변 장치 및 미들웨어를 초기화합니다.
• 기존 프로젝트를 직접 사용ampSTM32CubeMX 도구의 파일에는 STM32CubeMX 6.10.0 이상이 필요합니다.
  • STM32CubeMX를 설치한 후 제안된 프로젝트를 열고 필요한 경우 업데이트하십시오. 기존 프로젝트를 여는 가장 간단한 방법은 *.ioc를 두 번 클릭하는 것입니다. file STM32CubeMX가 자동으로 프로젝트와 소스를 열도록 files.
  • STM32CubeMX는 이러한 프로젝트의 초기화 소스 코드를 생성합니다. 주요 애플리케이션 소스 코드는 "USER CODE BEGIN" 및 "USER CODE END" 주석에 포함되어 있습니다. IP 선택 및 설정이 수정되는 경우 STM32CubeMX는 코드의 초기화 부분을 업데이트하지만 기본 애플리케이션 소스 코드는 유지합니다.
• STM32CubeMX에서 맞춤형 프로젝트를 개발하려면 단계별 프로세스를 따르십시오.
  1. 필요한 주변 장치 세트와 일치하는 STM32 마이크로 컨트롤러를 선택하십시오.
  2. 핀아웃 충돌 해결기, 클록 트리 설정 도우미, 전력 소비 계산기, MCU 주변 장치 구성(예: GPIO 또는 USART) 및 미들웨어 스택(예: USB)을 수행하는 유틸리티를 사용하여 필요한 모든 임베디드 소프트웨어를 구성합니다.
  3. 선택한 구성을 기반으로 초기화 C 코드를 생성합니다. 이 코드는 여러 개발 환경에서 사용할 준비가 되었습니다. 사용자 코드는 다음 코드 생성 시 유지됩니다.
• STM32CubeMX에 대한 자세한 내용은 STM32 구성 및 초기화 C 코드 생성(UM32)을 위한 STM1718CubeMX 사용 설명서를 참조하세요.
• 사용 가능한 프로젝트 목록을 보려면 exampSTM32CubeWBA용 파일은 STM32Cube 펌웨어 애플리케이션 노트(ex)를 참조하세요.ampSTM32WBA 시리즈(AN5929)용 파일입니다.

드라이버 애플리케이션

HAL 애플리케이션
이 섹션에서는 STM32CubeWBA를 사용하여 사용자 정의 HAL 애플리케이션을 생성하는 데 필요한 단계를 설명합니다.

1. 프로젝트 만들기
   • 새 프로젝트를 생성하려면 \Projects\ 아래의 각 보드에 제공된 템플릿 프로젝트에서 시작하십시오. \템플릿 또는 \Projects\ 아래의 사용 가능한 프로젝트에서 \예제 또는 \Projects\ \Applications(여기서 STM32CubeWBA와 같은 보드 이름을 나타냅니다.
   • 템플릿 프로젝트는 빈 메인 루프 기능을 제공합니다. 그러나 STM32CubeWBA 프로젝트 설정을 이해하는 것은 좋은 출발점입니다. 템플릿에는 다음과 같은 특징이 있습니다.
     • 여기에는 특정 보드에서 코드를 개발하는 데 필요한 최소 구성 요소 세트인 HAL 소스 코드, CMSIS 및 BSP 드라이버가 포함되어 있습니다.
     • 여기에는 모든 펌웨어 구성 요소에 대한 포함된 경로가 포함되어 있습니다.
     • 지원되는 STM32WBA 시리즈 장치를 정의하여 CMSIS 및 HAL 드라이버를 올바르게 구성할 수 있습니다.
     • 바로 사용할 수 있는 사용자 제공 file아래와 같이 사전 구성되어 있습니다.
       HAL은 Arm® 코어 SysTick을 사용하여 기본 시간축으로 초기화되었습니다. HAL_Delay() 목적으로 구현된 SysTick ISR입니다.
       메모: 기존 프로젝트를 다른 위치에 복사할 때 포함된 모든 경로가 업데이트되었는지 확인하세요.
2. 사용자 프로젝트에 필요한 미들웨어 추가(선택 사항)
   출처를 식별하려면 file프로젝트에 추가할 항목 file 목록은 각 미들웨어별로 제공되는 문서를 참고하세요. \Projects\STM32xxx_yyy\Applications\ 아래의 애플리케이션을 참조하세요. (어디 ThreadX와 같은 미들웨어 스택을 참조하여 소스가 무엇인지 파악합니다. files 및 포함 경로를 추가해야 합니다.
3. 펌웨어 구성요소 구성
   HAL 및 미들웨어 구성요소는 헤더에 선언된 #define 매크로를 사용하여 일련의 빌드 시간 구성 옵션을 제공합니다. file. 템플릿 구성 file 프로젝트 폴더에 복사해야 하는 각 구성 요소 내에 제공됩니다(일반적으로 구성 file xxx_conf_template.h라는 이름은 프로젝트 폴더에 복사할 때 _template이라는 단어를 제거해야 합니다. 구성 file 각 구성 옵션의 영향을 이해하는 데 충분한 정보를 제공합니다. 자세한 내용은 각 구성 요소에 대해 제공되는 설명서에서 확인할 수 있습니다.
4. HAL 라이브러리 시작
   기본 프로그램으로 점프한 후 애플리케이션 코드는 HAL_Init() API를 호출하여 다음 작업을 수행하는 HAL 라이브러리를 초기화해야 합니다.
   • 플래시 메모리 프리패치 및 SysTick 인터럽트 우선순위 구성(st m32wbaxx_hal_conf.h에 정의된 매크로를 통해)
   • stm32wbaxx_hal_conf.h에 정의된 SysTick 인터럽트 우선순위 TICK_INT_PRIO에서 밀리초마다 인터럽트를 생성하도록 SysTick을 구성합니다.
   • NVIC 그룹 우선순위를 0으로 설정합니다.
   • stm32wbaxx_hal_msp.c 사용자에 정의된 HAL_MspInit() 콜백 함수 호출 file 전역 하위 수준 하드웨어 초기화를 수행합니다.
5. 시스템 시계 구성
   시스템 시계 구성은 아래 설명된 두 가지 API를 호출하여 수행됩니다.
   • HAL_RCC_OscConfig(): 이 API는 내부 및 외부 발진기를 구성합니다. 사용자는 하나 또는 모든 발진기를 구성하도록 선택합니다.
   • HAL_RCC_ClockConfig(): 이 API는 시스템 클록 소스, 플래시 메모리 대기 시간, AHB 및 APB 프리스케일러를 구성합니다.
6. 주변기기 초기화
   • 먼저 주변 장치 HAL_PPP_MspInit 함수를 작성합니다. 다음과 같이 진행하세요:
     • 주변장치 시계를 활성화합니다.
     • 주변 GPIO를 구성합니다.
     • DMA 채널을 구성하고 DMA 인터럽트를 활성화합니다(필요한 경우).
     • 주변기기 인터럽트를 활성화합니다(필요한 경우).
   • 필요한 경우 stm32xxx_it.c를 편집하여 필요한 인터럽트 핸들러(주변 장치 및 DMA)를 호출하십시오.
   • 주변기기 인터럽트나 DMA를 사용할 계획이라면 프로세스 완료 콜백 함수를 작성하세요.
   • 사용자 main.c에서 file, 주변 장치 핸들 구조를 초기화한 다음 HAL_PPP_Init() 함수를 호출하여 주변 장치를 초기화합니다.
7. 애플리케이션 개발
   • 이 s에서tage, 시스템이 준비되고 사용자 애플리케이션 코드 개발을 시작할 수 있습니다.
   • HAL은 주변기기를 구성하기 위해 직관적이고 즉시 사용 가능한 API를 제공합니다. 모든 애플리케이션 요구 사항을 수용하기 위해 폴링, 인터럽트 및 DMA 프로그래밍 모델을 지원합니다. 각 주변기기의 자세한 사용법은 리치엑스를 참고하세요.amp파일 세트는 STM32CubeWBA MCU 패키지에 제공됩니다.
     주의: 기본 HAL 구현에서는 SysTick 타이머가 타임베이스로 사용됩니다. 즉, 정기적인 시간 간격으로 인터럽트를 생성합니다. HAL_Delay()가 주변 ISR 프로세스에서 호출되는 경우 SysTick 인터럽트가 주변 인터럽트보다 높은 우선순위(숫자적으로 낮은)를 갖는지 확인하십시오. 그렇지 않으면 호출자 ISR 프로세스가 차단됩니다. 타임베이스 구성에 영향을 미치는 함수는 __weak로 선언되어 사용자의 다른 구현이 있는 경우 재정의가 가능합니다. file (예를 들어 범용 타이머 사용)amp파일 또는 다른 시간 소스). 자세한 내용은 HAL_TimeBase ex를 참조하세요.amp르.

LL 지원
이 섹션에서는 STM32CubeWBA를 사용하여 사용자 정의 LL 애플리케이션을 생성하는 데 필요한 단계를 설명합니다.

1. 프로젝트 만들기
   • 새 프로젝트를 생성하려면 \Projects\ 아래의 각 보드에 제공된 Templates_LL 프로젝트에서 시작하거나 \Templates_LL 또는 \Projects\ 아래의 사용 가능한 프로젝트에서 \전amples_LL( NUCLEO-WBA32CG와 같은 보드 이름을 나타냅니다.
   • 템플릿 프로젝트는 STM32CubeWBA에 대한 프로젝트 설정을 이해하는 데 좋은 시작점이 되는 빈 메인 루프 기능을 제공합니다. 템플릿의 주요 특징은 다음과 같습니다.
     • 여기에는 특정 보드에서 코드를 개발하는 데 필요한 최소 구성 요소 세트인 LL 및 CMSIS 드라이버의 소스 코드가 포함되어 있습니다.
     • 여기에는 필요한 모든 펌웨어 구성 요소에 대한 포함된 경로가 포함되어 있습니다.
     • 지원되는 STM32WBA 시리즈 장치를 선택하고 CMSIS 및 LL 드라이버를 올바르게 구성할 수 있습니다.
     • 바로 사용할 수 있는 사용자를 제공합니다. file다음과 같이 사전 구성되어 있습니다.
       ◦ main.h: LED 및 USER_BUTTON 정의 추상화 계층.
       ◦ main.c: 최대 주파수에 대한 시스템 클럭 구성입니다.
2. 기존 프로젝트를 다른 보드로 포팅
   다른 대상 보드의 기존 프로젝트를 지원하려면 각 보드에 제공되고 \Projects\에서 사용 가능한 Templates_LL 프로젝트에서 시작하세요. \템플릿_LL.
   • LL ex를 선택하세요ample: LL ex가 있는 보드를 찾으려면amp파일이 배포되었습니다. LL ex 목록을 참조하세요.amp파일 STM32CubeProjectsList.html.
3. LL ex 포팅amp르 :
   • 초기 소스를 유지하려면 Templates_LL 폴더를 복사하여 붙여넣거나 기존 Temp lates_LL 프로젝트를 직접 업데이트하세요.
   • 그런 다음 포팅은 주로 Templates_LL을 교체하는 것으로 구성됩니다. fileEx의 이름이야amples_LL 대상 프로젝트.
   • 모든 보드 특정 부품을 유지하십시오. 명확성을 위해 보드 특정 부품에는 특정 플래그가 지정되어 있습니다. tags:

     

   • 따라서 주요 포팅 단계는 다음과 같습니다.
     • stm32wbaxx_it.h를 교체하십시오. file
     • stm32wbaxx_it.c를 교체하십시오. file
     • main.h를 교체하세요. file 업데이트합니다. BOARD SPECIFIC CONFIGURATION 아래에 LL 템플릿의 LED 및 사용자 버튼 정의를 유지합니다. tags.
     • main.c를 교체하세요. file 업데이트하세요.
   • BOARD SPECIFIC CONFIGURATION에서 SystemClock_Config() LL 템플릿 함수의 클럭 구성을 유지합니다. tags.
   • LED 정의에 따라 각 LDx 발생을 main.h에서 사용할 수 있는 다른 LDy로 교체합니다. file.
   • 이러한 수정을 통해 example는 이제 대상 보드에서 실행됩니다.

보안 애플리케이션
이 패키지는 보안 애플리케이션과 함께 제공됩니다.

SBSFU 애플리케이션

• SBSFU는 보안 부팅 및 보안 펌웨어 업데이트 기능(MCUboot 기반)을 포함한 Root of Trust 솔루션을 제공합니다.
• 솔루션은 애플리케이션을 실행하기 전에 사용됩니다.
• 솔루션은 ex를 제공합니다.amp비보안 애플리케이션과 격리된 보안 서비스 파일(GPIO 토글)입니다. 런타임 시 보안되지 않은 애플리케이션은 계속해서 이 솔루션을 사용할 수 있습니다.

TFM 애플리케이션
TFM은 보안 부팅 및 보안 펌웨어 업데이트 기능을 포함한 Root of Trust 솔루션을 제공합니다.
(MCUboot 기반). 솔루션은 애플리케이션을 실행하기 전에 사용됩니다. 이 솔루션은 비보안 애플리케이션에서 격리된 TFM 보안 서비스를 제공합니다. 런타임 시 보안되지 않은 애플리케이션은 계속해서 이 솔루션을 사용할 수 있습니다.

RF 애플리케이션
RF 애플리케이션은 이 애플리케이션 노트 STM32WBA 시리즈 마이크로컨트롤러(AN5928)를 사용하여 무선 애플리케이션 구축에 설명되어 있습니다.

STM32CubeWBA 릴리스 업데이트 받기
최신 STM32CubeWBA MCU 패키지 릴리스 및 패치는 STM32WBA 시리즈에서 제공됩니다. STM32CubeMX의 업데이트 확인 버튼에서 검색할 수 있습니다. 자세한 내용은 STM3 구성 및 초기화 C 코드 생성(UM32)에 대한 사용자 매뉴얼 STM32CubeMX의 섹션 1718을 참조하세요.

자주 묻는 질문

• LL 드라이버 대신 HAL을 언제 사용해야 합니까?
  • HAL 드라이버는 높은 수준의 이식성과 함께 높은 수준의 기능 지향 API를 제공합니다. 최종 사용자에게는 제품 또는 주변 장치의 복잡성이 숨겨집니다.
  • LL 드라이버는 최적화가 더 뛰어나지만 이식성이 떨어지는 낮은 계층 레지스터 수준 API를 제공합니다. 제품이나 IP 사양에 대한 심층적인 지식이 필요합니다.
• HAL 드라이버와 LL 드라이버를 함께 사용할 수 있나요? 가능하다면 제약은 무엇입니까?
  • HAL 드라이버와 LL 드라이버를 모두 사용할 수 있습니다. IP 초기화 단계에 HAL을 사용한 다음 LL 드라이버로 I/O 작업을 관리합니다.
  • HAL과 LL의 주요 차이점은 HAL 드라이버는 작업 관리를 위해 핸들을 생성하고 사용해야 하는 반면 LL 드라이버는 주변 장치 레지스터에서 직접 작동한다는 것입니다. 엑스amples_MIX 예amp파일은 HAL과 LL을 혼합하는 방법을 보여줍니다.
• LL 초기화 API는 어떻게 활성화되나요?
  • LL 초기화 API 및 관련 리소스(구조, 리터럴 및 프로토타입)의 정의는 USE_FULL_LL_DRIVER 컴파일 스위치에 의해 조정됩니다.
  • LL 초기화 API를 사용하려면 툴체인 컴파일러 전처리기에 이 스위치를 추가하세요.
• STM32CubeMX는 임베디드 소프트웨어를 기반으로 코드를 어떻게 생성할 수 있나요?
  STM32CubeMX에는 사용자에게 그래픽 표현을 제공하고 *.h 또는 *.c를 생성할 수 있는 주변 장치 및 소프트웨어를 포함하여 STM32 마이크로 컨트롤러에 대한 지식이 내장되어 있습니다. file사용자 구성을 기반으로 합니다.

중요 공지 – 주의 깊게 읽어보세요

• STMicroelectronics NV 및 그 자회사("ST")는 언제든지 통지 없이 ST 제품 및/또는 이 문서를 변경, 수정, 개선, 수정 및 개선할 권리를 보유합니다. 구매자는 주문하기 전에 ST 제품에 대한 최신 관련 정보를 얻어야 합니다. ST 제품은 주문 확인 시점에 적용되는 ST의 판매 약관에 따라 판매됩니다.
• 구매자는 ST 제품의 선택, 선정 및 사용에 대한 전적인 책임을 지며, ST는 구매자의 제품 설계나 애플리케이션 지원에 대한 책임을 지지 않습니다.
• ST는 본 계약에 따라 어떠한 지적 재산권에 대한 명시적 또는 묵시적 라이센스도 부여하지 않습니다.
• 여기에 명시된 정보와 다른 조항이 적용된 ST 제품을 재판매할 경우, ST가 해당 제품에 대하여 부여한 모든 보증은 무효화됩니다.
• ST 및 ST 로고는 ST의 상표입니다. ST 상표에 대한 추가 정보는 www.st.com/trademarks를 참조하십시오. 다른 모든 제품 또는 서비스 이름은 해당 소유자의 자산입니다.
• 이 문서의 정보는 이 문서의 이전 버전에서 제공된 정보를 대체하고 교체합니다.
• © 2023 STMicroelectronics – 모든 권리 보유

문서 / 리소스

STMicroelectronics STM32WBA 시리즈 시작하기 [PDF 파일] 사용자 매뉴얼 STM32WBA 시리즈 시작하기, 시작하기, 시작하기

참고문헌

• 사용자 설명서