ntptime --- máy khách NTP đơn giản

Mô-đun này cung cấp một máy khách nhỏ cho Giao thức Thời gian Mạng (NTP), hữu ích để lấy thời gian UTC hiện tại từ máy chủ thời gian internet và tùy chọn thiết lập đồng hồ thời gian thực trên bo mạch. Nó thực hiện một yêu cầu UDP đơn đến máy chủ NTP và giải mã dấu thời gian 64-bit được trả về.

Mô-đun này yêu cầu kết nối mạng đang hoạt động. Dấu thời gian 32-bit truyền qua mạng được tự động hiệu chỉnh cho sự kiện NTP rollover năm 2036, cho phép triển khai này tiếp tục hoạt động đến tháng 2 năm 2160.

Hàm

ntptime.time() → int

Truy vấn máy chủ NTP đã cấu hình (host) và trả về thời gian UTC hiện tại dưới dạng số nguyên tính bằng giây kể từ epoch của MicroPython.

Epoch của MicroPython được phát hiện tại thời điểm chạy bằng cách sử dụng time.gmtime(). Cả epoch năm 1970 (Unix) và năm 2000 đều được hỗ trợ; bất kỳ epoch nào khác sẽ gây ra Exception.

Lỗi mạng được truyền đến người gọi; socket bên dưới luôn được đóng trước khi trả về.

ntptime.settime() → None

Lấy thời gian hiện tại bằng cách sử dụng time() và thiết lập RTC trên bo mạch tương ứng thông qua machine.RTC.

Lưu ý rằng MicroPython không hỗ trợ múi giờ: RTC luôn được thiết lập theo UTC.

Hằng số

ntptime.host: str

Tên máy chủ NTP để truy vấn. Mặc định là "pool.ntp.org". Gán lại tại thời điểm chạy để ghi đè, ví dụ: ntptime.host = "time.google.com".

ntptime.timeout: int

Thời gian chờ socket tính bằng giây áp dụng cho yêu cầu UDP NTP. Mặc định là 1. Tăng giá trị này trên các mạng chậm hoặc có độ trễ cao.