SNTP

این ماژول شامل توابعی است که ارتباطات SNTP را کنترل می کند.

خلاصه

Typedefs

otSntpQuery typedef
struct otSntpQuery
این ساختار پارامترهای SNTP Query را پیاده سازی می کند.
otSntpResponseHandler )(void *aContext, uint64_t aTime, otError aResult) typedef
void(*
هنگامی که یک پاسخ SNTP دریافت می شود، این نشانگر تابع فراخوانی می شود.

کارکرد

otSntpClientQuery ( otInstance *aInstance, const otSntpQuery *aQuery, otSntpResponseHandler aHandler, void *aContext)
این تابع یک درخواست SNTP ارسال می کند.
otSntpClientSetUnixEra ( otInstance *aInstance, uint32_t aUnixEra)
void
این تابع عدد دوران یونیکس را تنظیم می کند.

سازه ها

otSntpQuery

این ساختار پارامترهای SNTP Query را پیاده سازی می کند.

Typedefs

otSntpQuery

struct otSntpQuery otSntpQuery

این ساختار پارامترهای SNTP Query را پیاده سازی می کند.

otSntpResponseHandler

void(* otSntpResponseHandler)(void *aContext, uint64_t aTime, otError aResult)

هنگامی که یک پاسخ SNTP دریافت می شود، این نشانگر تابع فراخوانی می شود.

جزئیات
مولفه های
[in] aContext
اشاره‌ای به زمینه خاص برنامه.
[in] aTime
زمانی را در سرور مشخص می کند که پاسخ برای مشتری در زمان یونیکس باقی بماند.
[in] aResult
نتیجه تراکنش SNTP.
ارزش های بازگشتی
OT_ERROR_NONE
پاسخ با موفقیت دریافت شد و زمان در aTime ارائه شده است.
OT_ERROR_ABORT
یک تراکنش SNTP توسط پشته لغو شد.
OT_ERROR_BUSY
بسته بوسه و مرگ دریافت شد.
OT_ERROR_RESPONSE_TIMEOUT
هیچ پاسخ SNTP در مهلت زمانی دریافت نشده است.
OT_ERROR_FAILED
پاسخی دریافت شد اما حاوی داده های نادرست است.

کارکرد

otSntpClientQuery

otError otSntpClientQuery(
  otInstance *aInstance,
  const otSntpQuery *aQuery,
  otSntpResponseHandler aHandler,
  void *aContext
)

این تابع یک پرسش SNTP را ارسال می کند.

این تابع فقط در صورتی در دسترس است که ویژگی OPENTHREAD_CONFIG_SNTP_CLIENT_ENABLE فعال باشد.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aQuery
یک اشاره گر برای تعیین پارامترهای پرس و جو SNTP.
[in] aHandler
یک نشانگر تابعی که باید در هنگام دریافت پاسخ یا زمان پایان فراخوانی شود.
[in] aContext
اشاره گر به اطلاعات زمینه دلخواه.

otSntpClientSetUnixEra

void otSntpClientSetUnixEra(
  otInstance *aInstance,
  uint32_t aUnixEra
)

این تابع عدد دوران یونیکس را تنظیم می کند.

مقدار پیش‌فرض یونیکس era روی 0 تنظیم شده است. دوره‌های بعدی پس از سال 2106 شروع می‌شوند.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aUnixEra
شماره دوران یونیکس

ماکروها

OT_SNTP_DEFAULT_SERVER_IP

 OT_SNTP_DEFAULT_SERVER_IP "2001:4860:4806:8::"

آدرس سرور SNTP پیش فرض - سرور NTP Google را تعریف می کند.

OT_SNTP_DEFAULT_SERVER_PORT

 OT_SNTP_DEFAULT_SERVER_PORT 123

پورت SNTP Server پیش فرض را تعریف می کند.

منابع

موضوعات مرجع OpenThread API از کد منبع موجود در GitHub سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.