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

Microchip SAM D21 MCU. More...

#include <McuATSAMD21.hpp>

Inheritance diagram for McuATSAMD21:
RTCCalendar McuARMCortexM McuGeneric SystemFeatherM0

Public Types

enum  AdcReference_t {
  VREF_DEFAULT = 0, VREF_INTERNAL = 0, VREF_INTERNAL1V = 1, VREF_INTERNALdiv1_48 = 0,
  VREF_INTERNALdiv2 = 2, VREF_EXTERNAL = 4, VREF_EXTERNAL_A = 3, VREF_EXTERNAL_B = 4
}
 ADC (analogRead()) 기준 전압 More...
 
enum  {
  RESET_REASON_SYST = (1 << 6), RESET_REASON_WDT = (1 << 5), RESET_REASON_EXT = (1 << 4), RESET_REASON_BOD33 = (1 << 2),
  RESET_REASON_BOD12 = (1 << 1), RESET_REASON_POR = (1 << 0)
}
 

Public Member Functions

 McuATSAMD21 (uint32_t)
 
virtual void feedWatchdog () override
 Watchdog reset을 방지하기 위하여 watchdog에 신호를 줍니다. More...
 
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...
 
- 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 ()
 
- 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)
 

Protected Member Functions

void sleep () override
 
void initialize () 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

uint64_t nextAlarm = 0
 
uint64_t countSeconds = 0
 
HardwareTimerTick_t countAtLastSec = 0
 
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

Microchip SAM D21 MCU.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum
Enumerator
RESET_REASON_SYST 

System reset requested

RESET_REASON_WDT 

Watchdog reset

RESET_REASON_EXT 

External reset

RESET_REASON_BOD33 

Brown out 33 detector reset

RESET_REASON_BOD12 

Brown out 12 detector reset

RESET_REASON_POR 

Power on reset

101  {
102  RESET_REASON_SYST = (1 << 6),
103  RESET_REASON_WDT = (1 << 5),
104  RESET_REASON_EXT = (1 << 4),
105  RESET_REASON_BOD33 = (1 << 2),
106  RESET_REASON_BOD12 = (1 << 1),
107  RESET_REASON_POR = (1 << 0),
108  };

◆ AdcReference_t

ADC (analogRead()) 기준 전압

Enumerator
VREF_DEFAULT 

Default: INTERNALdiv1_48

VREF_INTERNAL 

Internal default: VREF_INTERNALdiv1_48

VREF_INTERNAL1V 

Internal static 1.0V

VREF_INTERNALdiv1_48 

VDDANA / 1.48 V

VREF_INTERNALdiv2 

VDDANA / 2 V (only for VDDANA > 2.0V)

VREF_EXTERNAL 

External default: VREF_EXTERNAL_B

VREF_EXTERNAL_A 

External reference VREFA

VREF_EXTERNAL_B 

External reference VREFB

91  { VREF_DEFAULT = 0,
92  VREF_INTERNAL = 0,
93  VREF_INTERNAL1V = 1,
95  VREF_INTERNALdiv2 = 2,
96  VREF_EXTERNAL = 4,
97  VREF_EXTERNAL_A = 3,
98  VREF_EXTERNAL_B = 4,
99  };

Member Function Documentation

◆ feedWatchdog()

virtual void McuATSAMD21::feedWatchdog ( )
inlineoverridevirtual

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

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

Implements McuGeneric.

Reimplemented in SystemFeatherM0.

69  {
70  }

◆ getResetReason()

uint32_t McuATSAMD21::getResetReason ( )

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

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

Returns

리셋 원인에 대한 자세한 정보는 Microchip의 SAM D21 Family Datasheet의 16.6.2.7. Reset Controller 를 참고하시기 바랍니다.

◆ getTimeSinceBoot()

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

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

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

Implements RTCCalendar.


The documentation for this class was generated from the following file:
McuATSAMD21::RESET_REASON_BOD12
@ RESET_REASON_BOD12
Definition: McuATSAMD21.hpp:106
McuATSAMD21::RESET_REASON_EXT
@ RESET_REASON_EXT
Definition: McuATSAMD21.hpp:104
McuATSAMD21::VREF_DEFAULT
@ VREF_DEFAULT
Definition: McuATSAMD21.hpp:91
McuATSAMD21::VREF_EXTERNAL
@ VREF_EXTERNAL
Definition: McuATSAMD21.hpp:96
McuATSAMD21::RESET_REASON_POR
@ RESET_REASON_POR
Definition: McuATSAMD21.hpp:107
McuATSAMD21::VREF_INTERNALdiv1_48
@ VREF_INTERNALdiv1_48
Definition: McuATSAMD21.hpp:94
McuATSAMD21::RESET_REASON_BOD33
@ RESET_REASON_BOD33
Definition: McuATSAMD21.hpp:105
McuATSAMD21::VREF_INTERNAL
@ VREF_INTERNAL
Definition: McuATSAMD21.hpp:92
McuATSAMD21::VREF_EXTERNAL_A
@ VREF_EXTERNAL_A
Definition: McuATSAMD21.hpp:97
McuATSAMD21::VREF_INTERNAL1V
@ VREF_INTERNAL1V
Definition: McuATSAMD21.hpp:93
McuATSAMD21::RESET_REASON_WDT
@ RESET_REASON_WDT
Definition: McuATSAMD21.hpp:103
McuATSAMD21::VREF_INTERNALdiv2
@ VREF_INTERNALdiv2
Definition: McuATSAMD21.hpp:95
McuATSAMD21::RESET_REASON_SYST
@ RESET_REASON_SYST
Definition: McuATSAMD21.hpp:102
McuATSAMD21::VREF_EXTERNAL_B
@ VREF_EXTERNAL_B
Definition: McuATSAMD21.hpp:98