SDK  23.9.2
For IoT System Software Development
Public Types | Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
McuSTM32WLxx Class Reference

STMicroelectronics STM32WLxx MCU. More...

#include <McuSTM32WLxx.hpp>

Inheritance diagram for McuSTM32WLxx:
McuARMCortexM RTCCalendar McuGeneric SystemPLM150 SystemRAK3172

Public Types

enum  {
  RESET_REASON_LPWR = (1 << 31), RESET_REASON_WWDG = (1 << 30), RESET_REASON_IWDG = (1 << 29), RESET_REASON_SOFT = (1 << 28),
  RESET_REASON_BOR = (1 << 27), RESET_REASON_PIN = (1 << 26), RESET_REASON_OBL = (1 << 25), RESET_REASON_RFILA = (1 << 24)
}
 

Public Member Functions

 McuSTM32WLxx (uint32_t)
 
void feedWatchdog () override
 Watchdog reset을 방지하기 위하여 watchdog에 신호를 줍니다. More...
 
void reconfigClock ()
 
uint32_t getSystickCount ()
 
void waitSystick (uint32_t startTick, uint32_t numTicks)
 
uint32_t MicrosToSystick (uint32_t usec) override
 
uint32_t SystickToMicros (uint32_t ticks) override
 
void getTimeSinceBoot (struct timeval *tv) override
 보드 부팅 이후부터 현재까지의 경과 시간을 구합니다. More...
 
uint32_t getResetReason ()
 마지막으로 리셋된 원인을 가져옵니다. More...
 
int32_t getBatteryVoltage ()
 VBAT를 구합니다. More...
 
int32_t getAnalogReferenceVoltage ()
 Analog reference voltage (VREF+)를 구합니다. More...
 
- Public Member Functions inherited from McuARMCortexM
 McuARMCortexM (uint32_t clockHz, uint32_t systickHz, uint32_t maxSystickCount)
 
const CoreRegisterDumpgetLastCoreRegisterDump ()
 
void saveCoreRegisterValues (uint32_t r0, uint32_t r1, uint32_t r2, uint32_t r3, uint32_t r12, uint32_t lr, uint32_t pc, uint32_t psr)
 
- Public Member Functions inherited from McuGeneric
 McuGeneric (uint32_t clockHz, uint32_t systickHz, uint32_t maxSystickCount)
 
- Public Member Functions inherited from RTCCalendar
void getDateTime (struct tm &t)
 현재 로컬 시간을 가져옵니다. More...
 
time_t getDateTime ()
 현재 로컬 시간을 가져옵니다. More...
 
void getUTC (struct tm &t)
 현재 UTC 시간을 가져옵니다. More...
 
time_t getUTC ()
 현재 UTC 시간을 가져옵니다. More...
 
void setDateTime (struct tm &t)
 현재 로컬 시간을 설정합니다. More...
 
void setDateTime (time_t t)
 현재 로컬 시간을 설정합니다. More...
 
void setUTC (struct tm &t)
 현재 UTC 시간을 설정합니다. More...
 
void setUTC (time_t t)
 현재 UTC 시간을 설정합니다. More...
 
void setDateTimeAlarm (struct tm &t)
 현재 로컬 시간을 기준으로 알람을 설정합니다. More...
 
void setDateTimeAlarm (time_t t)
 현재 로컬 시간을 기준으로 알람을 설정합니다. More...
 
error_t setTimeAlarm (uint8_t hour, uint8_t min, uint8_t sec=0)
 현재 로컬 시간을 기준으로 알람을 설정합니다. More...
 
void onDateTimeAlarm (void(*func)())
 알람 발생시 호출될 콜백함수를 지정합니다. More...
 
void setTimeDiff (int16_t diffMinutes)
 UTC와 로컬 시간과의 차이를 분 단위로 지정합니다. More...
 
int16_t getTimeDiff ()
 UTC와 로컬 시간과의 차이를 반환합니다. More...
 
virtual void signalAlarm ()
 

Protected Member Functions

void initialize () override
 
void sleep () override
 
void setUTCToHardware (uint16_t year, uint8_t month, uint8_t day, uint8_t hour, uint8_t min, uint8_t sec, int32_t subsec=-1) override
 
void setUTCAlarmToHardware (uint8_t hour, uint8_t min, uint8_t sec) override
 
void getUTCFromHardware (uint16_t *year, uint8_t *month, uint8_t *day, uint8_t *hour, uint8_t *min, uint8_t *sec, uint32_t *subsec) override
 
- Protected Member Functions inherited from McuGeneric
virtual void wakeup ()
 

Protected Attributes

uint32_t resetReason
 
struct timeval bootTime
 
- Protected Attributes inherited from RTCCalendar
void(* handlerAlarm )()
 

Additional Inherited Members

- Public Attributes inherited from McuGeneric
const uint32_t CLOCK_HZ
 CPU clock frequency in unit of Hz.
 
const uint32_t SYSTICK_HZ
 System tick frequency in unit of Hz.
 
const uint32_t MAX_SYSTICK_COUNT
 Maximum value of systick counter.
 
bool useSleep = true
 true 이면 MCU가 유휴(idle) 상태일 때 저전력을 위하여 sleep 합니다. More...
 

Detailed Description

STMicroelectronics STM32WLxx MCU.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum
Enumerator
RESET_REASON_LPWR 

Low-power management reset

RESET_REASON_WWDG 

Window watchdog reset

RESET_REASON_IWDG 

Independent watchdog reset

RESET_REASON_SOFT 

Software reset

RESET_REASON_BOR 

BOR reset

RESET_REASON_PIN 

Pin reset

RESET_REASON_OBL 

Option byte loading reset

RESET_REASON_RFILA 

Sub-GHz radio illegal commnad reset

86  { RESET_REASON_LPWR = (1 << 31),
87  RESET_REASON_WWDG = (1 << 30),
88  RESET_REASON_IWDG = (1 << 29),
89  RESET_REASON_SOFT = (1 << 28),
90  RESET_REASON_BOR = (1 << 27),
91  RESET_REASON_PIN = (1 << 26),
92  RESET_REASON_OBL = (1 << 25),
93  RESET_REASON_RFILA = (1 << 24),
94  };

Member Function Documentation

◆ feedWatchdog()

void McuSTM32WLxx::feedWatchdog ( )
overridevirtual

Watchdog reset을 방지하기 위하여 watchdog에 신호를 줍니다.

Nol.A-SDK에서는 특정 태스크의 MCU 점유 시간이 길어지는 경우 watchdog reset이 발생합니다. 따라서 postTask(), Timer 등으로 실행되는 태스크의 실행시간은 가능한 짧아야 합니다. 하지만, 간혹 busy wait를 해야 하거나 blocking 함수로 인해 실행시간이 길어질 수 있습니다. 이 경우 태스크의 중간 중간마다 이 함수를 호출하여 watchdog reset이 발생하는 것을 방지할 수 있습니다.

Implements McuGeneric.

◆ getAnalogReferenceVoltage()

int32_t McuSTM32WLxx::getAnalogReferenceVoltage ( )

Analog reference voltage (VREF+)를 구합니다.

Returns
  • 0 이상의 값: analog reference voltage (VREF+) 값 (단위: mV)
  • 0 보다 작은 값: 실패

◆ getBatteryVoltage()

int32_t McuSTM32WLxx::getBatteryVoltage ( )

VBAT를 구합니다.

Returns
  • 0 이상의 값: VBAT 값 (단위: mV)
  • 0 보다 작은 값: 실패

◆ getResetReason()

uint32_t McuSTM32WLxx::getResetReason ( )

마지막으로 리셋된 원인을 가져옵니다.

마지막으로 보드가 리셋된 원인을 반환합니다. 원인이 둘 이상인 경우, OR 된 값이 반환됩니다.

Returns

리셋 원인에 대한 자세한 정보는 ST Microelectronics의 STM32WLEx advanced Arm®-based 32-bit MCUs with sub-GHz radio solution Reference Manual (RM0461)의 6. Reset and clock control 또는 STM32WL5x advanced Arm®-based 32-bit MCUs with sub-GHz radio solution Reference Manual (RM0453)의 7. Reset and clock control을 참고하시기 바랍니다.

◆ getTimeSinceBoot()

void McuSTM32WLxx::getTimeSinceBoot ( struct timeval *  tv)
overridevirtual

보드 부팅 이후부터 현재까지의 경과 시간을 구합니다.

Parameters
tv[out]경과 시간이 반환될 timeval 포인터

Implements RTCCalendar.


The documentation for this class was generated from the following file:
McuSTM32WLxx::RESET_REASON_IWDG
@ RESET_REASON_IWDG
Definition: McuSTM32WLxx.hpp:88
McuSTM32WLxx::RESET_REASON_BOR
@ RESET_REASON_BOR
Definition: McuSTM32WLxx.hpp:90
McuSTM32WLxx::RESET_REASON_OBL
@ RESET_REASON_OBL
Definition: McuSTM32WLxx.hpp:92
McuSTM32WLxx::RESET_REASON_RFILA
@ RESET_REASON_RFILA
Definition: McuSTM32WLxx.hpp:93
McuSTM32WLxx::RESET_REASON_SOFT
@ RESET_REASON_SOFT
Definition: McuSTM32WLxx.hpp:89
McuSTM32WLxx::RESET_REASON_PIN
@ RESET_REASON_PIN
Definition: McuSTM32WLxx.hpp:91
McuSTM32WLxx::RESET_REASON_WWDG
@ RESET_REASON_WWDG
Definition: McuSTM32WLxx.hpp:87
McuSTM32WLxx::RESET_REASON_LPWR
@ RESET_REASON_LPWR
Definition: McuSTM32WLxx.hpp:86