IPv6

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

خلاصه

شمارش ها

anonymous enum {
OT_ADDRESS_ORIGIN_THREAD = 0,
OT_ADDRESS_ORIGIN_SLAAC = 1,
OT_ADDRESS_ORIGIN_DHCPV6 = 2,
OT_ADDRESS_ORIGIN_MANUAL = 3
}		 شمارش
مبدا آدرس IPv6.
anonymous enum {
OT_ECN_NOT_CAPABLE = 0x0,
OT_ECN_CAPABLE_0 = 0x2,
OT_ECN_CAPABLE_1 = 0x1,
OT_ECN_MARKED = 0x3
}		 شمارش
وضعیت های ECN که در سرآیند IP نشان داده شده است.
anonymous enum {
OT_IP6_PROTO_HOP_OPTS = 0,
OT_IP6_PROTO_TCP = 6,
OT_IP6_PROTO_UDP = 17,
OT_IP6_PROTO_IP6 = 41,
OT_IP6_PROTO_ROUTING = 43,
OT_IP6_PROTO_FRAGMENT = 44,
OT_IP6_PROTO_ICMP6 = 58,
OT_IP6_PROTO_NONE = 59,
OT_IP6_PROTO_DST_OPTS = 60
}		 شمارش
شماره پروتکل اینترنت

Typedefs

otIp6Address typedef
struct otIp6Address
این ساختار نشان دهنده یک آدرس IPv6 است.
otIp6AddressCallback )(const otIp6AddressInfo *aAddressInfo, bool aIsAdded, void *aContext) typedef
void(*
این نشانگر تابع زمانی فراخوانی می شود که یک آدرس IPv6 داخلی اضافه یا حذف شود.
otIp6AddressComponents typedef
این ساختار اجزای یک آدرس IPv6 را نشان می دهد.
otIp6AddressInfo typedef
otIp6InterfaceIdentifier typedef
این ساختار نشان دهنده شناسه رابط یک آدرس IPv6 است.
otIp6NetworkPrefix typedef
این ساختار نشان دهنده پیشوند شبکه یک آدرس IPv6 (مهمترین 64 بیت آدرس) است.
otIp6Prefix typedef
struct otIp6Prefix
این ساختار یک پیشوند IPv6 را نشان می دهد.
otIp6ReceiveCallback )(otMessage *aMessage, void *aContext) typedef
void(*
این نشانگر تابع زمانی فراخوانی می شود که دیتاگرام IPv6 دریافت می شود.
otIp6RegisterMulticastListenersCallback )(void *aContext, otError aError, uint8_t aMlrStatus, const otIp6Address *aFailedAddresses, uint8_t aFailedAddressNum) typedef
void(*
این نشانگر تابع با نتایج otIp6RegisterMulticastListeners می شود.
otIp6SlaacPrefixFilter )(otInstance *aInstance, const otIp6Prefix *aPrefix) typedef
bool(*
این نشانگر تابع به کاربر اجازه می دهد پیشوندها را فیلتر کند و اجازه اضافه کردن آدرس SLAAC بر اساس پیشوند را نمی دهد.
otMessageInfo typedef
این ساختار نشان دهنده آدرس سوکت IPv6 محلی و مشابه است.
otNetifAddress typedef
این ساختار نشان دهنده یک آدرس unicast رابط شبکه IPv6 است.
otNetifMulticastAddress typedef
این ساختار نشان دهنده یک آدرس چندپخشی رابط شبکه IPv6 است.
otSockAddr typedef
struct otSockAddr
این ساختار نشان دهنده یک آدرس سوکت IPv6 است.

متغیرها

OT_TOOL_PACKED_END

کارکرد

otIp6AddUnicastAddress ( otInstance *aInstance, const otNetifAddress *aAddress)
یک آدرس رابط شبکه به رابط Thread اضافه کنید.
otIp6AddUnsecurePort ( otInstance *aInstance, uint16_t aPort)
این تابع یک پورت را به لیست پورت های غیر ایمن مجاز اضافه می کند.
otIp6AddressFromString (const char *aString, otIp6Address *aAddress)
این تابع یک رشته آدرس IPv6 قابل خواندن توسط انسان را به یک نمایش باینری تبدیل می کند.
otIp6AddressToString (const otIp6Address *aAddress, char *aBuffer, uint16_t aSize)
void
این تابع یک آدرس IPv6 داده شده را به یک رشته قابل خواندن توسط انسان تبدیل می کند.
otIp6ArePrefixesEqual (const otIp6Prefix *aFirst, const otIp6Prefix *aSecond)
bool
تست کنید که آیا دو پیشوند IPv6 یکسان هستند یا خیر.
otIp6GetMulticastAddresses ( otInstance *aInstance)
فهرست آدرس‌های چندپخشی IPv6 مشترک در رابط Thread را دریافت کنید.
otIp6GetUnicastAddresses ( otInstance *aInstance)
لیست آدرس های IPv6 اختصاص داده شده به رابط Thread را دریافت کنید.
otIp6GetUnsecurePorts ( otInstance *aInstance, uint8_t *aNumEntries)
const uint16_t *
این تابع یک اشاره گر را به لیست پورت ناامن برمی گرداند.
otIp6IsAddressEqual (const otIp6Address *aFirst, const otIp6Address *aSecond)
bool
تست کنید که آیا دو آدرس IPv6 یکسان هستند یا خیر.
otIp6IsAddressUnspecified (const otIp6Address *aAddress)
bool
این تابع نشان می دهد که آیا آدرس IPv6 داده شده آدرس نامشخص است یا خیر.
otIp6IsEnabled ( otInstance *aInstance)
bool
این تابع نشان می دهد که آیا رابط IPv6 فعال است یا خیر.
otIp6IsMulticastPromiscuousEnabled ( otInstance *aInstance)
bool
بررسی کنید که آیا حالت چندپخشی در رابط Thread فعال است یا خیر.
otIp6IsReceiveFilterEnabled ( otInstance *aInstance)
bool
این تابع نشان می‌دهد که آیا ترافیک کنترل Thread هنگام ارائه دیتاگرام‌های IPv6 از طریق پاسخ تماس مشخص شده در ()otIp6SetReceiveCallback فیلتر می‌شود یا خیر.
otIp6IsSlaacEnabled ( otInstance *aInstance)
bool
این تابع نشان می دهد که آیا ماژول SLAAC فعال است یا خیر.
otIp6NewMessage ( otInstance *aInstance, const otMessageSettings *aSettings)
یک بافر پیام جدید برای ارسال پیام IPv6 اختصاص دهید.
otIp6NewMessageFromBuffer ( otInstance *aInstance, const uint8_t *aData, uint16_t aDataLength, const otMessageSettings *aSettings)
یک بافر پیام جدید اختصاص دهید و دیتاگرام IPv6 را در بافر پیام برای ارسال پیام IPv6 بنویسید.
otIp6PrefixMatch (const otIp6Address *aFirst, const otIp6Address *aSecond)
uint8_t
این تابع طول تطابق پیشوند (بیت) را برای دو آدرس IPv6 برمی گرداند.
otIp6PrefixToString (const otIp6Prefix *aPrefix, char *aBuffer, uint16_t aSize)
void
این تابع یک پیشوند IPv6 داده شده را به یک رشته قابل خواندن توسط انسان تبدیل می کند.
otIp6ProtoToString (uint8_t aIpProto)
const char *
این تابع یک شماره پروتکل IP داده شده را به یک رشته قابل خواندن توسط انسان تبدیل می کند.
otIp6RegisterMulticastListeners ( otInstance *aInstance, const otIp6Address *aAddresses, uint8_t aAddressNum, const uint32_t *aTimeout, otIp6RegisterMulticastListenersCallback aCallback, void *aContext)
این تابع شنوندگان Multicast را در مسیریاب اصلی ستون فقرات ثبت می کند.
otIp6RemoveAllUnsecurePorts ( otInstance *aInstance)
void
این تابع همه پورت ها را از لیست پورت های ناامن مجاز حذف می کند.
otIp6RemoveUnicastAddress ( otInstance *aInstance, const otIp6Address *aAddress)
یک آدرس رابط شبکه را از رابط Thread حذف کنید.
otIp6RemoveUnsecurePort ( otInstance *aInstance, uint16_t aPort)
این تابع یک پورت را از لیست پورت های ناامن مجاز حذف می کند.
otIp6SelectSourceAddress ( otInstance *aInstance, otMessageInfo *aMessageInfo)
این تابع انتخاب آدرس منبع OpenThread را انجام می دهد.
otIp6Send ( otInstance *aInstance, otMessage *aMessage)
این تابع یک دیتاگرام IPv6 را از طریق رابط Thread ارسال می کند.
otIp6SetAddressCallback ( otInstance *aInstance, otIp6AddressCallback aCallback, void *aCallbackContext)
void
این تابع برای اطلاع از تغییرات آدرس IPv6 داخلی یک تماس برگشتی را ثبت می کند.
otIp6SetEnabled ( otInstance *aInstance, bool aEnabled)
این تابع رابط IPv6 را بالا/پایین می آورد.
otIp6SetMeshLocalIid ( otInstance *aInstance, const otIp6InterfaceIdentifier *aIid)
این تابع Mesh Local ID را (برای هدف آزمایش) تنظیم می کند.
otIp6SetMulticastPromiscuousEnabled ( otInstance *aInstance, bool aEnabled)
void
حالت چندپخشی را در رابط Thread فعال کنید.
otIp6SetReceiveCallback ( otInstance *aInstance, otIp6ReceiveCallback aCallback, void *aCallbackContext)
void
این تابع برای ارائه دیتاگرام های IPv6 دریافتی یک تماس برگشتی را ثبت می کند.
otIp6SetReceiveFilterEnabled ( otInstance *aInstance, bool aEnabled)
void
این تابع تعیین می‌کند که آیا ترافیک کنترل Thread هنگام ارائه دیتاگرام‌های IPv6 از طریق پاسخ به تماس مشخص شده در ()otIp6SetReceiveCallback فیلتر شود یا خیر.
otIp6SetSlaacEnabled ( otInstance *aInstance, bool aEnabled)
void
این تابع ماژول SLAAC را فعال/غیرفعال می کند.
otIp6SetSlaacPrefixFilter ( otInstance *aInstance, otIp6SlaacPrefixFilter aFilter)
void
این تابع کنترل کننده فیلتر ماژول SLAAC را تنظیم می کند.
otIp6SockAddrToString (const otSockAddr *aSockAddr, char *aBuffer, uint16_t aSize)
void
این تابع یک آدرس سوکت IPv6 داده شده را به یک رشته قابل خواندن توسط انسان تبدیل می کند.
otIp6SubscribeMulticastAddress ( otInstance *aInstance, const otIp6Address *aAddress)
مشترک شدن رابط Thread در یک آدرس چندپخشی رابط شبکه.
otIp6UnsubscribeMulticastAddress ( otInstance *aInstance, const otIp6Address *aAddress)
اشتراک رابط Thread را از یک آدرس چندپخشی رابط شبکه لغو کنید.

سازه ها

آدرس otIp6

این ساختار نشان دهنده یک آدرس IPv6 است.

otIp6AddressComponents

این ساختار اجزای یک آدرس IPv6 را نشان می دهد.

otIp6AddressInfo

این ساختار اطلاعات آدرس IPv6 را نشان می دهد.

otIp6InterfaceIdentifier

این ساختار نشان دهنده شناسه رابط یک آدرس IPv6 است.

otIp6NetworkPrefix

این ساختار نشان دهنده پیشوند شبکه یک آدرس IPv6 (مهمترین 64 بیت آدرس) است.

پیشوند otIp6

این ساختار یک پیشوند IPv6 را نشان می دهد.

otMessageInfo

این ساختار نشان دهنده آدرس سوکت IPv6 محلی و مشابه است.

آدرس otNetif

این ساختار نشان دهنده یک آدرس unicast رابط شبکه IPv6 است.

otNetifMulticastAddress

این ساختار نشان دهنده یک آدرس چندپخشی رابط شبکه IPv6 است.

otSockAddr

این ساختار نشان دهنده یک آدرس سوکت IPv6 است.

اتحادیه ها

otIp6InterfaceIdentifier:: OT_TOOL_PACKED_FIELD

شمارش ها

شماره ناشناس

 anonymous enum

مبدا آدرس IPv6.

خواص
OT_ADDRESS_ORIGIN_DHCPV6

آدرس اختصاص داده شده به DHCPv6.

OT_ADDRESS_ORIGIN_MANUAL

آدرس اختصاص داده شده به صورت دستی

OT_ADDRESS_ORIGIN_SLAAC

آدرس اختصاص داده شده توسط SLAAC

OT_ADDRESS_ORIGIN_THREAD

آدرس اختصاص داده شده به رشته (ALOC، RLOC، MLEID، و غیره)

شماره ناشناس

 anonymous enum

وضعیت های ECN که در سرآیند IP نشان داده شده است.

خواص
OT_ECN_CAPABLE_0

ECT(0)

OT_ECN_CAPABLE_1

ECT (1)

OT_ECN_MARKED

ازدحام رخ داده (CE)

OT_ECN_NOT_CAPABLE

غیر ECT.

شماره ناشناس

 anonymous enum

شماره پروتکل اینترنت

خواص
OT_IP6_PROTO_DST_OPTS

گزینه های مقصد برای IPv6.

OT_IP6_PROTO_FRAGMENT

سربرگ قطعه برای IPv6.

OT_IP6_PROTO_HOP_OPTS

IPv6 گزینه Hop-by-Hop.

OT_IP6_PROTO_ICMP6

ICMP برای IPv6.

OT_IP6_PROTO_IP6

کپسوله سازی IPv6

OT_IP6_PROTO_NONE

بدون سربرگ بعدی برای IPv6.

OT_IP6_PROTO_ROUTING

سربرگ مسیریابی برای IPv6.

OT_IP6_PROTO_TCP

پروتکل کنترل انتقال

OT_IP6_PROTO_UDP

دیتاگرام کاربر.

Typedefs

آدرس otIp6

struct otIp6Address otIp6Address

این ساختار نشان دهنده یک آدرس IPv6 است.

otIp6Address Callback

void(* otIp6AddressCallback)(const otIp6AddressInfo *aAddressInfo, bool aIsAdded, void *aContext)

این نشانگر تابع زمانی فراخوانی می شود که یک آدرس IPv6 داخلی اضافه یا حذف شود.

جزئیات
مولفه های
[in] aAddressInfo
اشاره گر به اطلاعات آدرس IPv6.
[in] aIsAdded
اگر aAddress اضافه شده باشد، درست است، اگر aAddress حذف شود، نادرست است.
[in] aContext
اشاره‌ای به زمینه خاص برنامه.

otIp6AddressComponents

struct otIp6AddressComponents otIp6AddressComponents

این ساختار اجزای یک آدرس IPv6 را نشان می دهد.

otIp6AddressInfo

struct otIp6AddressInfo otIp6AddressInfo

otIp6InterfaceIdentifier

struct otIp6InterfaceIdentifier otIp6InterfaceIdentifier

این ساختار نشان دهنده شناسه رابط یک آدرس IPv6 است.

otIp6NetworkPrefix

struct otIp6NetworkPrefix otIp6NetworkPrefix

این ساختار نشان دهنده پیشوند شبکه یک آدرس IPv6 (مهمترین 64 بیت آدرس) است.

پیشوند otIp6

struct otIp6Prefix otIp6Prefix

این ساختار یک پیشوند IPv6 را نشان می دهد.

otIp6ReceiveCallback

void(* otIp6ReceiveCallback)(otMessage *aMessage, void *aContext)

این نشانگر تابع زمانی فراخوانی می شود که دیتاگرام IPv6 دریافت می شود.

جزئیات
مولفه های
[in] aMessage
یک اشاره گر به بافر پیام حاوی دیتاگرام IPv6 دریافتی. این تابع مالکیت aMessage را به گیرنده تماس برگشتی منتقل می کند. پیام پس از پردازش باید توسط گیرنده پاسخ به تماس آزاد شود (به otMessageFree() مراجعه کنید.
[in] aContext
اشاره‌ای به زمینه خاص برنامه.

otIp6RegisterMulticastListenersCallback

void(* otIp6RegisterMulticastListenersCallback)(void *aContext, otError aError, uint8_t aMlrStatus, const otIp6Address *aFailedAddresses, uint8_t aFailedAddressNum)

این نشانگر تابع با نتایج otIp6RegisterMulticastListeners می شود.

جزئیات
مولفه های
[in] aContext
اشاره گر به زمینه کاربر.
[in] aError
OT_ERROR_NONE هنگام ارسال موفقیت آمیز MLR.req و دریافت MLR.rsp، OT_ERROR_RESPONSE_TIMEOUT زمانی که MLR.rsp دریافت نشد، OT_ERROR_PARSE زمانی که تجزیه MLR.rsp انجام نشد.
[in] aMlrStatus
وضعیت ثبت شنونده چندپخشی زمانی که aError باشد.
[in] aFailedAddresses
زمانی که aError باشد، نشانگر آدرس‌های IPv6 ناموفق.
[in] aFailedAddressNum
تعداد آدرس‌های IPv6 ناموفق وقتی aError باشد.
همچنین ببینید:
otIp6RegisterMulticastListeners

otIp6SlaacPrefixFilter

bool(* otIp6SlaacPrefixFilter)(otInstance *aInstance, const otIp6Prefix *aPrefix)

این نشانگر تابع به کاربر اجازه می دهد پیشوندها را فیلتر کند و اجازه اضافه کردن آدرس SLAAC بر اساس پیشوند را نمی دهد.

otIp6SetSlaacPrefixFilter() را می توان برای تنظیم کنترل کننده فیلتر استفاده کرد. هنگامی که می خواهد یک آدرس SLAAC بر اساس یک پیشوند اضافه کند، کنترل کننده فیلتر توسط ماژول SLAAC فراخوانی می شود. مقدار بازگشتی بولی آن تعیین می کند که آیا آدرس فیلتر شده (افزوده نشده است) یا خیر.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aPrefix
یک اشاره گر به پیشوندی که آدرس SLAAC قرار است برای آن اضافه شود.
ارزش های بازگشتی
TRUE
نشان می دهد که آدرس SLAAC بر اساس پیشوند باید فیلتر شود و اضافه نشود.
FALSE
نشان می دهد که آدرس SLAAC بر اساس پیشوند باید اضافه شود.

otMessageInfo

struct otMessageInfo otMessageInfo

این ساختار نشان دهنده آدرس سوکت IPv6 محلی و مشابه است.

آدرس otNetif

struct otNetifAddress otNetifAddress

این ساختار نشان دهنده یک آدرس unicast رابط شبکه IPv6 است.

otNetifMulticastAddress

struct otNetifMulticastAddress otNetifMulticastAddress

این ساختار نشان دهنده یک آدرس چندپخشی رابط شبکه IPv6 است.

otSockAddr

struct otSockAddr otSockAddr

این ساختار نشان دهنده یک آدرس سوکت IPv6 است.

متغیرها

OT_TOOL_PACKED_END

OT_TOOL_PACKED_BEGIN struct otIp6InterfaceIdentifier OT_TOOL_PACKED_END

کارکرد

otIp6AddUnicastAddress

otError otIp6AddUnicastAddress(
  otInstance *aInstance,
  const otNetifAddress *aAddress
)

یک آدرس رابط شبکه به رابط Thread اضافه کنید.

نمونه پاس شده aAddress توسط رابط Thread کپی می شود. رابط Thread فقط از تعداد ثابتی از آدرس های unicast اضافه شده خارجی پشتیبانی می کند. به OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS مراجعه کنید.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aAddress
اشاره گر به آدرس رابط شبکه
ارزش های بازگشتی
OT_ERROR_NONE
آدرس رابط شبکه با موفقیت اضافه شد (یا به روز شد).
OT_ERROR_INVALID_ARGS
آدرس IP نشان داده شده توسط aAddress یک آدرس داخلی است.
OT_ERROR_NO_BUFS
رابط شبکه در حال حاضر حداکثر آدرس های خارجی مجاز را ذخیره می کند.

otIp6AddUnsecurePort

otError otIp6AddUnsecurePort(
  otInstance *aInstance,
  uint16_t aPort
)

این تابع یک پورت را به لیست پورت های غیر ایمن مجاز اضافه می کند.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aPort
مقدار پورت
ارزش های بازگشتی
OT_ERROR_NONE
پورت با موفقیت به لیست پورت ناامن مجاز اضافه شد.
OT_ERROR_INVALID_ARGS
پورت نامعتبر است (مقدار 0 برای استفاده داخلی رزرو شده است).
OT_ERROR_NO_BUFS
لیست پورت ناامن پر است.

otIp6AddressFromString

otError otIp6AddressFromString(
  const char *aString,
  otIp6Address *aAddress
)

این تابع یک رشته آدرس IPv6 قابل خواندن توسط انسان را به یک نمایش باینری تبدیل می کند.

جزئیات
مولفه های
[in] aString
یک اشاره گر به یک رشته با پایان NULL.
[out] aAddress
اشاره گر به آدرس IPv6.
ارزش های بازگشتی
OT_ERROR_NONE
رشته با موفقیت تجزیه شد.
OT_ERROR_INVALID_ARGS
تجزیه رشته انجام نشد.

otIp6AddressToString

void otIp6AddressToString(
  const otIp6Address *aAddress,
  char *aBuffer,
  uint16_t aSize
)

این تابع یک آدرس IPv6 داده شده را به یک رشته قابل خواندن توسط انسان تبدیل می کند.

رشته آدرس IPv6 به صورت 16 مقدار هگزا فرمت شده است که با ":" از هم جدا شده اند (یعنی "%x:%x:%x:...:%x").

اگر رشته به دست آمده در aBuffer (در کاراکترهای aSize آن) قرار نگیرد، رشته کوتاه می‌شود اما رشته خروجی همیشه تهی است.

جزئیات
مولفه های
[in] aAddress
اشاره گر به آدرس IPv6 (نباید NULL باشد).
[out] aBuffer
اشاره گر به آرایه char برای خروجی رشته (نباید NULL باشد).
[in] aSize
اندازه aBuffer (بر حسب بایت). توصیه می شود از OT_IP6_ADDRESS_STRING_SIZE استفاده کنید.

otIp6ArePrefixesEqual

bool otIp6ArePrefixesEqual(
  const otIp6Prefix *aFirst,
  const otIp6Prefix *aSecond
)

تست کنید که آیا دو پیشوند IPv6 یکسان هستند یا خیر.

جزئیات
مولفه های
[in] aFirst
اشاره گر به اولین پیشوند IPv6 برای مقایسه.
[in] aSecond
اشاره گر به پیشوند IPv6 دوم برای مقایسه.
ارزش های بازگشتی
TRUE
دو پیشوند IPv6 یکسان هستند.
FALSE
دو پیشوند IPv6 یکسان نیستند.

otIp6GetMulticastAddresses

const otNetifMulticastAddress * otIp6GetMulticastAddresses(
  otInstance *aInstance
)

فهرست آدرس‌های چندپخشی IPv6 مشترک در رابط Thread را دریافت کنید.

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

otIp6GetUnicastAddresses

const otNetifAddress * otIp6GetUnicastAddresses(
  otInstance *aInstance
)

لیست آدرس های IPv6 اختصاص داده شده به رابط Thread را دریافت کنید.

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

otIp6GetUnsecurePorts

const uint16_t * otIp6GetUnsecurePorts(
  otInstance *aInstance,
  uint8_t *aNumEntries
)

این تابع یک اشاره گر را به لیست پورت ناامن برمی گرداند.

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

otIp6IsAddressEqual

bool otIp6IsAddressEqual(
  const otIp6Address *aFirst,
  const otIp6Address *aSecond
)

تست کنید که آیا دو آدرس IPv6 یکسان هستند یا خیر.

جزئیات
مولفه های
[in] aFirst
اشاره گر به اولین آدرس IPv6 برای مقایسه.
[in] aSecond
اشاره گر به آدرس IPv6 دوم برای مقایسه.
ارزش های بازگشتی
TRUE
دو آدرس IPv6 یکسان هستند.
FALSE
دو آدرس IPv6 یکسان نیستند.

otIp6IsAddressUnspecified

bool otIp6IsAddressUnspecified(
  const otIp6Address *aAddress
)

این تابع نشان می دهد که آیا آدرس IPv6 داده شده آدرس نامشخص است یا خیر.

جزئیات
مولفه های
[in] aAddress
اشاره گر به آدرس IPv6.
ارزش های بازگشتی
TRUE
اگر آدرس IPv6 آدرس نامشخص باشد.
FALSE
اگر آدرس IPv6 آدرس نامشخص نباشد.

otIp6IsEnabled

bool otIp6IsEnabled(
  otInstance *aInstance
)

این تابع نشان می دهد که آیا رابط IPv6 فعال است یا خیر.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
ارزش های بازگشتی
TRUE
رابط IPv6 فعال است.
FALSE
رابط IPv6 غیرفعال است.

otIp6IsMulticastPromiscuousEnabled

bool otIp6IsMulticastPromiscuousEnabled(
  otInstance *aInstance
)

بررسی کنید که آیا حالت چندپخشی در رابط Thread فعال است یا خیر.

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

otIp6IsReceiveFilterEnabled

bool otIp6IsReceiveFilterEnabled(
  otInstance *aInstance
)

این تابع نشان می‌دهد که آیا ترافیک کنترل Thread هنگام ارائه دیتاگرام‌های IPv6 از طریق پاسخ تماس مشخص شده در ()otIp6SetReceiveCallback فیلتر می‌شود یا خیر.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
برمی گرداند
اگر ترافیک کنترل رشته فیلتر شود درست است، در غیر این صورت نادرست است.
همچنین ببینید:
otIp6SetReceiveCallback
otIp6SetReceiveFilterEnabled

otIp6IsSlaacEnabled

bool otIp6IsSlaacEnabled(
  otInstance *aInstance
)

این تابع نشان می دهد که آیا ماژول SLAAC فعال است یا خیر.

این تابع نیاز به فعال کردن ویژگی زمان ساخت OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE دارد.

جزئیات
ارزش های بازگشتی
TRUE
ماژول SLAAC فعال است.
FALSE
ماژول SLAAC غیرفعال است.

otIp6NewMessage

otMessage * otIp6NewMessage(
  otInstance *aInstance,
  const otMessageSettings *aSettings
)

یک بافر پیام جدید برای ارسال پیام IPv6 اختصاص دهید.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aSettings
یک اشاره گر به تنظیمات پیام یا NULL برای تنظیم تنظیمات پیش فرض.
برمی گرداند
اگر هیچ بافر پیامی در دسترس نباشد یا پارامترها نامعتبر باشند، یک اشاره گر به بافر پیام یا NULL.
همچنین ببینید:
otMessageFree

otIp6NewMessageFromBuffer

otMessage * otIp6NewMessageFromBuffer(
  otInstance *aInstance,
  const uint8_t *aData,
  uint16_t aDataLength,
  const otMessageSettings *aSettings
)

یک بافر پیام جدید اختصاص دهید و دیتاگرام IPv6 را در بافر پیام برای ارسال پیام IPv6 بنویسید.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aData
اشاره گر به بافر دیتاگرام IPv6.
[in] aDataLength
اندازه بافر دیتاگرام IPv6 که توسط aData شده است.
[in] aSettings
یک اشاره گر به تنظیمات پیام یا NULL برای تنظیم تنظیمات پیش فرض.
برمی گرداند
اگر سرصفحه IPv6 نادرست است یا بافرهای پیام کافی موجود نباشد، یک اشاره گر به پیام یا NULL.
همچنین ببینید:
otMessageFree

otIp6PrefixMatch

uint8_t otIp6PrefixMatch(
  const otIp6Address *aFirst,
  const otIp6Address *aSecond
)

این تابع طول تطابق پیشوند (بیت) را برای دو آدرس IPv6 برمی گرداند.

جزئیات
مولفه های
[in] aFirst
اشاره گر به اولین آدرس IPv6.
[in] aSecond
اشاره گر به آدرس IPv6 دوم.
برمی گرداند
طول پیشوند مطابق با بیت است.

otIp6PrefixToString

void otIp6PrefixToString(
  const otIp6Prefix *aPrefix,
  char *aBuffer,
  uint16_t aSize
)

این تابع یک پیشوند IPv6 داده شده را به یک رشته قابل خواندن توسط انسان تبدیل می کند.

رشته آدرس IPv6 به صورت "%x:%x:%x:...[::]/plen" فرمت شده است.

اگر رشته به دست آمده در aBuffer (در کاراکترهای aSize آن) قرار نگیرد، رشته کوتاه می‌شود اما رشته خروجی همیشه تهی است.

جزئیات
مولفه های
[in] aPrefix
اشاره گر به پیشوند IPv6 (نباید NULL باشد).
[out] aBuffer
اشاره گر به آرایه char برای خروجی رشته (نباید NULL باشد).
[in] aSize
اندازه aBuffer (بر حسب بایت). توصیه می شود از OT_IP6_PREFIX_STRING_SIZE استفاده کنید.

otIp6ProtoToString

const char * otIp6ProtoToString(
  uint8_t aIpProto
)

این تابع یک شماره پروتکل IP داده شده را به یک رشته قابل خواندن توسط انسان تبدیل می کند.

جزئیات
مولفه های
[in] aIpProto
یک شماره پروتکل IP (شماری OT_IP6_PROTO_* ).
برمی گرداند
رشته ای که aIpProto نشان می دهد.

otIp6RegisterMulticastListeners

otError otIp6RegisterMulticastListeners(
  otInstance *aInstance,
  const otIp6Address *aAddresses,
  uint8_t aAddressNum,
  const uint32_t *aTimeout,
  otIp6RegisterMulticastListenersCallback aCallback,
  void *aContext
)

این تابع شنوندگان Multicast را در مسیریاب اصلی ستون فقرات ثبت می کند.

توجه: فقط زمانی در دسترس است که هر دو OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE و OPENTHREAD_CONFIG_COMMISSIONER_ENABLE فعال باشند)

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aAddresses
یک آرایه آدرس چندپخشی برای ثبت نام.
[in] aAddressNum
تعداد آدرس های چندپخشی برای ثبت نام (0 اگر آدرس ها aAddresses باشد).
[in] aTimeout
یک اشاره گر به مقدار وقفه (بر حسب ثانیه) که باید در MLR.req گنجانده شود. مقدار وقفه 0 شنونده Multicast مربوطه را حذف می کند. اگر NULL باشد، MLR.req به طور پیش فرض فاقد Timeout Tlv خواهد بود.
[in] aCallback
اشاره گر به عملکرد برگشت به تماس.
[in] aContext
اشاره گر به زمینه کاربر.
ارزش های بازگشتی
OT_ERROR_NONE
MLR.req با موفقیت ارسال شد. اگر این روش aCallback را برگرداند، aCallback فراخوانی می‌شود.
OT_ERROR_BUSY
اگر ثبت نام قبلی در حال انجام بود.
OT_ERROR_INVALID_ARGS
اگر یک یا چند آرگومان نامعتبر باشد.
OT_ERROR_INVALID_STATE
اگر دستگاه برای ارسال MLR.req در وضعیت معتبری نبود (مثلاً Commissioner شروع نشده است، روتر اصلی Backbone یافت نشد).
OT_ERROR_NO_BUFS
اگر بافرهای پیام کافی موجود نیست.
همچنین ببینید:
otIp6RegisterMulticastListenersCallback

otIp6RemoveAllUnsecurePorts

void otIp6RemoveAllUnsecurePorts(
  otInstance *aInstance
)

این تابع همه پورت ها را از لیست پورت های ناامن مجاز حذف می کند.

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

otIp6RemoveUnicastAddress

otError otIp6RemoveUnicastAddress(
  otInstance *aInstance,
  const otIp6Address *aAddress
)

یک آدرس رابط شبکه را از رابط Thread حذف کنید.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aAddress
اشاره گر به آدرس IP
ارزش های بازگشتی
OT_ERROR_NONE
آدرس رابط شبکه با موفقیت حذف شد.
OT_ERROR_INVALID_ARGS
آدرس IP نشان داده شده توسط aAddress یک آدرس داخلی است.
OT_ERROR_NOT_FOUND
آدرس IP نشان داده شده توسط aAddress پیدا نشد.

otIp6RemoveUnsecurePort

otError otIp6RemoveUnsecurePort(
  otInstance *aInstance,
  uint16_t aPort
)

این تابع یک پورت را از لیست پورت های ناامن مجاز حذف می کند.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aPort
مقدار پورت
ارزش های بازگشتی
OT_ERROR_NONE
پورت با موفقیت از لیست پورت ناامن مجاز حذف شد.
OT_ERROR_INVALID_ARGS
پورت نامعتبر است (مقدار 0 برای استفاده داخلی رزرو شده است).
OT_ERROR_NOT_FOUND
پورت در لیست پورت ناامن یافت نشد.

otIp6SelectSourceAddress

otError otIp6SelectSourceAddress(
  otInstance *aInstance,
  otMessageInfo *aMessageInfo
)

این تابع انتخاب آدرس منبع OpenThread را انجام می دهد.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in,out] aMessageInfo
اشاره گر به اطلاعات پیام
ارزش های بازگشتی
OT_ERROR_NONE
یک آدرس منبع پیدا کرد و در mSockAddr از aMessageInfo شد.
OT_ERROR_NOT_FOUND
هیچ آدرس منبعی پیدا نشد و aMessageInfo بدون تغییر است.

otIp6Send

otError otIp6Send(
  otInstance *aInstance,
  otMessage *aMessage
)

این تابع یک دیتاگرام IPv6 را از طریق رابط Thread ارسال می کند.

هنگام برقراری این تماس، تماس‌گیرنده مالکیت aMessage را منتقل می‌کند. aMessage وقتی پردازش کامل شد، از جمله زمانی که مقداری غیر از OT_ERROR_NONE برگردانده شد، پیام را آزاد می کند.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aMessage
یک اشاره گر به بافر پیام حاوی دیتاگرام IPv6.
ارزش های بازگشتی
OT_ERROR_NONE
پیام با موفقیت پردازش شد.
OT_ERROR_DROP
پیام به خوبی شکل گرفته بود اما به دلیل قوانین پردازش بسته به طور کامل پردازش نشد.
OT_ERROR_NO_BUFS
هنگام پردازش دیتاگرام، بافرهای پیام لازم تخصیص داده نشد.
OT_ERROR_NO_ROUTE
عدم وجود مسیر به میزبان.
OT_ERROR_INVALID_SOURCE_ADDRESS
آدرس منبع نامعتبر است، به عنوان مثال یک آدرس anycast یا یک آدرس چندپخشی.
OT_ERROR_PARSE
هنگام پردازش پیام با سرصفحه نادرست مواجه شدیم.

otIp6SetAddress Callback

void otIp6SetAddressCallback(
  otInstance *aInstance,
  otIp6AddressCallback aCallback,
  void *aCallbackContext
)

این تابع برای اطلاع از تغییرات آدرس IPv6 داخلی یک تماس برگشتی را ثبت می کند.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aCallback
اشاره گر به تابعی که هنگام افزودن یا حذف یک آدرس IPv6 داخلی فراخوانی می شود. NULL برای غیرفعال کردن پاسخ تماس.
[in] aCallbackContext
اشاره‌ای به زمینه خاص برنامه.

otIp6SetEnabled

otError otIp6SetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

این تابع رابط IPv6 را بالا/پایین می آورد.

این تابع را برای فعال/غیرفعال کردن ارتباط IPv6 فراخوانی کنید.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aEnabled
TRUE برای فعال کردن IPv6، FALSE در غیر این صورت.
ارزش های بازگشتی
OT_ERROR_NONE
رابط IPv6 را با موفقیت بالا/پایین آورد.
OT_ERROR_INVALID_STATE
رابط IPv6 در دسترس نیست زیرا دستگاه در حالت پیوند خام کار می کند (فقط زمانی که ویژگی OPENTHREAD_CONFIG_LINK_RAW_ENABLE فعال باشد قابل استفاده است).

otIp6SetMeshLocalIid

otError otIp6SetMeshLocalIid(
  otInstance *aInstance,
  const otIp6InterfaceIdentifier *aIid
)

این تابع Mesh Local ID را (برای هدف آزمایش) تنظیم می کند.

فقط زمانی در دسترس است که OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE فعال باشد.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aIid
یک اشاره گر به Mesh Local ID برای تنظیم.
ارزش های بازگشتی
OT_ERROR_NONE
شناسه محلی Mesh با موفقیت تنظیم شد.
OT_ERROR_INVALID_STATE
پروتکل های رشته فعال هستند.

otIp6SetMulticastPromiscuousEnabled

void otIp6SetMulticastPromiscuousEnabled(
  otInstance *aInstance,
  bool aEnabled
)

حالت چندپخشی را در رابط Thread فعال کنید.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aEnabled
TRUE برای فعال کردن حالت Multicast Promiscuous، در غیر این صورت FALSE.
همچنین ببینید:
otIp6IsMulticastPromiscuousEnabled

otIp6SetReceiveCallback

void otIp6SetReceiveCallback(
  otInstance *aInstance,
  otIp6ReceiveCallback aCallback,
  void *aCallbackContext
)

این تابع برای ارائه دیتاگرام های IPv6 دریافتی یک تماس برگشتی را ثبت می کند.

به طور پیش فرض، این تماس برگشتی ترافیک کنترل Thread را عبور نمی دهد. برای تغییر تنظیمات فیلتر ترافیک کنترل Thread، به otIp6SetReceiveFilterEnabled() مراجعه کنید.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aCallback
اشاره گر به تابعی که هنگام دریافت دیتاگرام IPv6 فراخوانی می شود یا برای غیرفعال کردن پاسخ به تماس NULL فراخوانی می شود.
[in] aCallbackContext
اشاره‌ای به زمینه خاص برنامه.
همچنین ببینید:
otIp6IsReceiveFilterEnabled
otIp6SetReceiveFilterEnabled

otIp6SetReceiveFilterEnabled

void otIp6SetReceiveFilterEnabled(
  otInstance *aInstance,
  bool aEnabled
)

این تابع تعیین می‌کند که آیا ترافیک کنترل Thread هنگام ارائه دیتاگرام‌های IPv6 از طریق پاسخ به تماس مشخص شده در ()otIp6SetReceiveCallback فیلتر شود یا خیر.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aEnabled
اگر ترافیک کنترل رشته فیلتر شود درست است، در غیر این صورت نادرست است.
همچنین ببینید:
otIp6SetReceiveCallback
otIsReceiveIp6FilterEnabled

otIp6SetSlaacEnabled

void otIp6SetSlaacEnabled(
  otInstance *aInstance,
  bool aEnabled
)

این تابع ماژول SLAAC را فعال/غیرفعال می کند.

این تابع نیاز به فعال کردن ویژگی زمان ساخت OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE دارد.

وقتی ماژول SLAAC فعال است، آدرس‌های SLAAC (بر اساس پیشوندهای روی مش در داده‌های شبکه) به رابط اضافه می‌شوند. وقتی ماژول SLAAC غیرفعال است، هر آدرس SLAAC قبلاً اضافه شده حذف می شود.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aEnabled
TRUE برای فعال کردن، FALSE برای غیرفعال کردن.

otIp6SetSlaacPrefixFilter

void otIp6SetSlaacPrefixFilter(
  otInstance *aInstance,
  otIp6SlaacPrefixFilter aFilter
)

این تابع کنترل کننده فیلتر ماژول SLAAC را تنظیم می کند.

این تابع نیاز به فعال کردن ویژگی زمان ساخت OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE دارد.

کنترل کننده فیلتر توسط ماژول SLAAC زمانی فراخوانی می شود که می خواهد یک آدرس SLAAC را بر اساس پیشوند اضافه کند تا تصمیم بگیرد که آیا آدرس باید اضافه شود یا خیر.

یک کنترل کننده فیلتر NULL فیلتر کردن را غیرفعال می کند و اجازه می دهد تا تمام آدرس های SLAAC اضافه شوند.

اگر این تابع فراخوانی نشود، فیلتر پیش فرض استفاده شده توسط ماژول SLAAC NULL خواهد بود (فیلتر کردن غیرفعال است).

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aFilter
یک اشاره گر به کنترل کننده فیلتر پیشوند SLAAC یا NULL برای غیرفعال کردن فیلتر کردن.

otIp6SockAddrToString

void otIp6SockAddrToString(
  const otSockAddr *aSockAddr,
  char *aBuffer,
  uint16_t aSize
)

این تابع یک آدرس سوکت IPv6 داده شده را به یک رشته قابل خواندن توسط انسان تبدیل می کند.

رشته آدرس سوکت IPv6 به صورت "[

]: "کجا".
به صورت 16 مقدار هگز که با ':' و از هم جدا شده اند نشان داده می شود شماره پورت در قالب اعشاری است (یعنی "[%x:%x:...:%x]:%u")

اگر رشته به دست آمده در aBuffer (در کاراکترهای aSize آن) قرار نگیرد، رشته کوتاه می‌شود اما رشته خروجی همیشه تهی است.

جزئیات
مولفه های
[in] aSockAddr
اشاره گر به یک آدرس سوکت IPv6 (نباید NULL باشد).
[out] aBuffer
اشاره گر به آرایه char برای خروجی رشته (نباید NULL باشد).
[in] aSize
اندازه aBuffer (بر حسب بایت). توصیه می شود از OT_IP6_SOCK_ADDR_STRING_SIZE استفاده کنید.

otIp6SubscribeMulticastAddress

otError otIp6SubscribeMulticastAddress(
  otInstance *aInstance,
  const otIp6Address *aAddress
)

مشترک شدن رابط Thread در یک آدرس چندپخشی رابط شبکه.

به عنوان مثال aAddress شده توسط رابط Thread کپی می شود. رابط Thread فقط از تعداد ثابتی از آدرس های چندپخشی اضافه شده خارجی پشتیبانی می کند. OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS را ببینید.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aAddress
اشاره گر به آدرس IP
ارزش های بازگشتی
OT_ERROR_NONE
با موفقیت در آدرس چندپخشی رابط شبکه مشترک شد.
OT_ERROR_ALREADY
آدرس چندپخشی قبلاً مشترک شده است.
OT_ERROR_INVALID_ARGS
آدرس IP نشان داده شده توسط aAddress یک آدرس چندپخشی نامعتبر است.
OT_ERROR_REJECTED
آدرس IP نشان داده شده توسط aAddress یک آدرس چندپخشی داخلی است.
OT_ERROR_NO_BUFS
رابط شبکه در حال حاضر حداکثر آدرس های چندپخشی خارجی مجاز را ذخیره می کند.

otIp6UnsubscribeMulticastAddress

otError otIp6UnsubscribeMulticastAddress(
  otInstance *aInstance,
  const otIp6Address *aAddress
)

اشتراک رابط Thread را از یک آدرس چندپخشی رابط شبکه لغو کنید.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aAddress
اشاره گر به آدرس IP
ارزش های بازگشتی
OT_ERROR_NONE
اشتراک آدرس چندپخشی رابط شبکه با موفقیت لغو شد.
OT_ERROR_REJECTED
آدرس IP نشان داده شده توسط aAddress یک آدرس داخلی است.
OT_ERROR_NOT_FOUND
آدرس IP نشان داده شده توسط aAddress پیدا نشد.

ماکروها

OT_IP6_ADDRESS_SIZE

 OT_IP6_ADDRESS_SIZE 16

اندازه آدرس IPv6 (بایت)

OT_IP6_ADDRESS_STRING_SIZE

 OT_IP6_ADDRESS_STRING_SIZE 40

اندازه توصیه شده برای نمایش رشته ای آدرس IPv6.

OT_IP6_IID_SIZE

 OT_IP6_IID_SIZE 8

اندازه شناسه رابط IPv6 (بایت)

OT_IP6_MAX_MLR_ADDRESSES

 OT_IP6_MAX_MLR_ADDRESSES 15

حداکثر تعداد آدرس های IPv6 پشتیبانی شده توسط Multicast Listener Registration.

OT_IP6_PREFIX_BITSIZE

 OT_IP6_PREFIX_BITSIZE (OT_IP6_PREFIX_SIZE * 8)

اندازه پیشوند IPv6 (بیت)

OT_IP6_PREFIX_SIZE

 OT_IP6_PREFIX_SIZE 8

اندازه پیشوند IPv6 (بایت)

OT_IP6_PREFIX_STRING_SIZE

 OT_IP6_PREFIX_STRING_SIZE 45

اندازه توصیه شده برای نمایش رشته پیشوند IPv6.

OT_IP6_SOCK_ADDR_STRING_SIZE

 OT_IP6_SOCK_ADDR_STRING_SIZE 48

اندازه توصیه شده برای نمایش رشته آدرس سوکت IPv6.

منابع

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