ntptime — 간단한 NTP 클라이언트

이 모듈은 네트워크 시간 프로토콜(NTP, Network Time Protocol)을 위한 작은 클라이언트를 제공하며, 인터넷 시간 서버에서 현재 UTC 시간을 가져오거나 선택적으로 온보드 실시간 클럭을 설정하는 데 유용합니다. NTP 서버에 단일 UDP 요청을 수행하고 반환된 64비트 타임스탬프를 디코딩합니다.

이 모듈은 동작 중인 네트워크 연결에 의존합니다. 32비트 와이어 타임스탬프는 2036년 NTP 롤오버에 대해 자동으로 보정되어, 구현이 2160년 2월까지 유효하게 유지됩니다.

함수

ntptime.time() → int

구성된 NTP 서버(host)에 질의하여 현재 UTC 시간을 MicroPython 에포크 이후의 정수 초 단위로 반환합니다.

MicroPython 에포크는 time.gmtime()을 사용하여 런타임에 감지됩니다. 1970년(Unix)과 2000년 에포크가 모두 지원되며, 그 외의 에포크는 Exception을 발생시킵니다.

네트워크 오류는 호출자에게 전파됩니다. 내부 소켓은 반환되기 전에 항상 닫힙니다.

ntptime.settime() → None

time()을 사용하여 현재 시간을 가져오고 machine.RTC를 통해 온보드 RTC를 그에 맞게 설정합니다.

MicroPython에는 시간대 지원이 없다는 점에 유의하십시오. RTC는 항상 UTC로 설정됩니다.

상수

ntptime.host: str

질의할 NTP 서버의 호스트 이름입니다. 기본값은 "pool.ntp.org"입니다. 재정의하려면 런타임에 다시 할당하십시오. 예: ntptime.host = "time.google.com".

ntptime.timeout: int

NTP UDP 요청에 적용되는 소켓 타임아웃(초)입니다. 기본값은 1입니다. 느리거나 지연 시간이 높은 네트워크에서는 값을 늘리십시오.