nl::Weave::Profiles::NetworkProvisioning

מרחב השמות הזה כולל את כל הממשקים ב-Weave עבור פרופיל הקצאת הרשת ב-Weave, הראשון מבין שלושת הפרופילים של הקצאת Weave.

סיכום

בממשקים מוגדרים קודי סטטוס, סוגי הודעות, תגים של רכיבי נתונים, קבועים אחרים, אובייקט שרת ואובייקט הענקת גישה.

פרופיל הקצאת הרשת של Nest Weave ממוקד באספקת הנתונים לקבלת ממשקי הרשת, כמו 802.15.4/Thread ו-802.11/Wi-Fi, עבור מכשיר שהוקצה ל-Weave כך שהמכשיר יוכל להשתתף ברשתות האלה.

ספירות

@212{
  kStatusCode_UnknownNetwork = 1,
  kStatusCode_TooManyNetworks = 2,
  kStatusCode_InvalidNetworkConfiguration = 3,
  kStatusCode_UnsupportedNetworkType = 4,
  kStatusCode_UnsupportedWiFiMode = 5,
  kStatusCode_UnsupportedWiFiRole = 6,
  kStatusCode_UnsupportedWiFiSecurityType = 7,
  kStatusCode_InvalidState = 8,
  kStatusCode_TestNetworkFailed = 9,
  kStatusCode_NetworkConnectFailed = 10,
  kStatusCode_NoRouterAvailable = 11,
  kStatusCode_UnsupportedRegulatoryDomain = 12,
  kStatusCode_UnsupportedOperatingLocation = 13
}
טיפוסים בני מנייה (enum)
קודי סטטוס של הקצאת רשת.
@213 טיפוסים בני מנייה (enum)
סוגים של מסרים להקצאת רשתות.
@214{
  kTag_Networks = 1,
  kTag_EnabledNetworks = 2,
  kTag_RendezvousMode = 3,
  kTag_NetworkInformation = 32,
  kTag_NetworkId = 33,
  kTag_NetworkType = 34,
  kTag_WirelessSignalStrength = 35,
  kTag_WiFiSSID = 64,
  kTag_WiFiMode = 65,
  kTag_WiFiRole = 66,
  kTag_WiFiSecurityType = 67,
  kTag_WiFiPreSharedKey = 68,
  kTag_ThreadExtendedPANId = 80,
  kTag_ThreadNetworkName = 81,
  kTag_ThreadNetworkKey = 82,
  kTag_ThreadMeshPrefix = 83,
  kTag_ThreadChannel = 84,
  kTag_ThreadPANId = 85,
  kTag_ThreadPSKc = 86,
  kTag_WirelessRegConfig_RegulatoryDomain = 1,
  kTag_WirelessRegConfig_OperatingLocation = 2,
  kTag_WirelessRegConfig_SupportedRegulatoryDomains = 3
}
טיפוסים בני מנייה (enum)
@215 טיפוסים בני מנייה (enum)
מזהה PAN של שרשור.
@216 טיפוסים בני מנייה (enum)
ערוץ שרשור.
GetNetworkFlags טיפוסים בני מנייה (enum)
קבלת התרעות רשת.
NetworkType טיפוסים בני מנייה (enum)
סוגי רשתות.
RendezvousModeFlags טיפוסים בני מנייה (enum)
דגלים במצב Rendezvous.
WiFiMode טיפוסים בני מנייה (enum)
מצבי הפעלה של WiFi.
WiFiRole טיפוסים בני מנייה (enum)
תפקיד ה-Wi-Fi במכשיר.
WiFiSecurityType טיפוסים בני מנייה (enum)
מצבי אבטחה של Wi-Fi.
WirelessOperatingLocation{
  kWirelessOperatingLocation_NotSpecified = 0x00,
  kWirelessOperatingLocation_Unknown = 0x01,
  kWirelessOperatingLocation_Indoors = 0x02,
  kWirelessOperatingLocation_Outdoors = 0x03
}
טיפוסים בני מנייה (enum)
מיקום ההפעלה של המכשיר, בהתאם לכללי הרגולציה של התקשורת האלחוטית.

פונקציות

ReplaceValue(char *& dest, const char *src)
ReplaceValue(uint8_t *& dest, uint32_t & destLen, const uint8_t *src, uint32_t srcLen)

מחלקות

nl::Weave::Profiles::NetworkProvisioning::NetworkInfo

סיווג של שירות לסידור רציף של מטענים ייעודיים (payloads) ולביצוע פעולת deserialize שלהם באמצעות פרופיל NetworkProvisioning. המחלקה כוללת את המידע שקשור לזיהוי ולהגדרה של רשתות.

nl::Weave::Profiles::NetworkProvisioning::NetworkProvisioningDelegate

הקצאת מחלקה ליישום פעולות של ניהול תצורה ברשת.

nl::Weave::Profiles::NetworkProvisioning::NetworkProvisioningServer

מחלקת שרת ליישום הפרופיל של הקצאת הרשת.

nl::Weave::Profiles::NetworkProvisioning::WirelessRegConfig

מאגר למידע על הגדרות תקינה של רגולציה אלחוטית.

מבנים

nl::Weave::Profiles::NetworkProvisioning::WirelessRegDomain

קוד בן 2 תווים המזהה את הדומיין של רגולציה אלחוטית.

ספירות

@212

 @212

קודי סטטוס של הקצאת רשת.

תכונות
kStatusCode_InvalidNetworkConfiguration

הגדרת הרשת שצוינה לא תקינה.

kStatusCode_InvalidState

לא ניתן לבצע את הפעולה של הקצאת הרשת במצב הנוכחי.

kStatusCode_NetworkConnectFailed

הניסיון להתחבר לרשת שצוינה נכשל.

kStatusCode_NoRouterAvailable

לא נמצא נתב רשת מתאים.

kStatusCode_TestNetworkFailed

בדיקת הקישוריות של הרשת שצוינה נכשלה.

kStatusCode_TooManyNetworks

הגעת למספר המקסימלי של רשתות שהוקצו.

kStatusCode_UnknownNetwork

לא נמצאה רשת מוקצית עם מזהה הרשת שצוין.

kStatusCode_UnsupportedNetworkType

סוג הרשת שצוין אינו ידוע או שאינו נתמך.

kStatusCode_UnsupportedOperatingLocation

מיקום ההפעלה האלחוטית שצוין אינו נתמך.

kStatusCode_UnsupportedRegulatoryDomain

דומיין הרגולציה האלחוטי שצוין אינו נתמך.

kStatusCode_UnsupportedWiFiMode

מצב ה-Wi-Fi שצוין אינו נתמך.

kStatusCode_UnsupportedWiFiRole

תפקיד ה-Wi-Fi שצוין אינו נתמך.

kStatusCode_UnsupportedWiFiSecurityType

סוג האבטחה של רשת ה-Wi-Fi שצוין אינו נתמך.

@213

 @213

סוגים של מסרים להקצאת רשתות.

@214

 @214

תגים של רכיבי נתונים להקצאת רשת.

תכונות
kTag_EnabledNetworks

[ מערך ] מערך של NetworkIds שמזהים את הרשתות המופעלות כרגע במכשיר.

kTag_NetworkId

[ uint, 32-bit max ] מספר שלם המזהה באופן ייחודי רשת מוקצה.

kTag_NetworkInformation

[ struct ] מבנה שמכיל מידע עבור רשת.

kTag_NetworkType

[ uint, 8-bit max ] ערך של מספר שלם לא חתום שמזהה את סוג הרשת.

kTag_Networks

[array ] מערך של מבני NetworkConfiguration.

kTag_RendezvousMode

[ uint ] שדה קטן שמציין את מצב החפיפה הפעיל כרגע.

kTag_ThreadChannel

[ uint, 8-bit max ] מספר הערוץ של שרשור (אופציונלי).

kTag_ThreadExtendedPANId

[ מחרוזת בייט ] מזהה ה-PAN המורחב של Thread.

kTag_ThreadMeshPrefix

[ מחרוזת בייטים, בדיוק 8 בייטים ] קידומת Thread mesh IPv6 /64 (אופציונלי).

kTag_ThreadNetworkKey

[byte string ] מפתח הרשת הראשי של Thread.

kTag_ThreadNetworkName

[מחרוזת UTF-8 ] מחרוזת UTF-8 שמכילה את השם של רשת Thread.

kTag_ThreadPANId

[ uint, מקסימום 16-bit ] מזהה PAN של שרשור (אופציונלי).

kTag_ThreadPSKc

[ uint, מקסימום 16-bit ] פרוטוקול Thread PSKc (אופציונלי).

kTag_WiFiMode

[ uint, 8-bit max ] מספר שלם שמזהה את מצב הפעולה של רשת ה-Wi-Fi.

kTag_WiFiPreSharedKey

[ מחרוזת בייט ] מחרוזת בבייט שמכילה את הסיסמה ל-Wi-Fi/מפתח משותף מראש.

kTag_WiFiRole

[ uint, 8-bit max ] מספר שלם שמזהה את התפקיד של המכשיר ברשת ה-Wi-Fi.

kTag_WiFiSSID

[ UTF-8 string ] מחרוזת שמכילה SSID של Wi-Fi.

kTag_WiFiSecurityType

[ uint, 8-bit max ] ערך של מספר שלם שמזהה את סוג האבטחה שרשת Wi-Fi משתמשת בה.

kTag_WirelessRegConfig_OperatingLocation

[ uint enum, 8-bit max ] מיקום הפעלה שרלוונטי לכללי הרגולציה של התקשורת האלחוטית.

kTag_WirelessRegConfig_RegulatoryDomain

[ UTF-8 string, len 2 ] דומיין רגולציה אלחוטית.

kTag_WirelessRegConfig_SupportedRegulatoryDomains

[מערך len 2 ] רשימת דומיינים רגולטוריים של תמיכה.

kTag_WirelessSignalStrength

[ int, 16-bit max ] ערך של מספר שלם חתום שנותן את עוצמת האות של רשת אלחוטית ב-dBm.

@215

 @215

מזהה PAN של שרשור.

@216

 @216

ערוץ שרשור.

GetNetworkFlags

 GetNetworkFlags

קבלת התרעות רשת.

NetworkType

 NetworkType

סוגי רשתות.

RendezvousModeFlags

 RendezvousModeFlags

דגלים במצב Rendezvous.

WiFiMode

 WiFiMode

מצבי הפעלה של WiFi.

WiFiRole

 WiFiRole

תפקיד ה-Wi-Fi במכשיר.

WiFiSecurityType

 WiFiSecurityType

מצבי אבטחה של Wi-Fi.

WirelessOperatingLocation

 WirelessOperatingLocation

מיקום ההפעלה של המכשיר, בהתאם לכללי הרגולציה של התקשורת האלחוטית.

תכונות
kWirelessOperatingLocation_Indoors

פעילות בשטח סגור.

מציין שמיקום הפעילות הצפוי של המכשיר הוא בתוך הבית.

kWirelessOperatingLocation_NotSpecified

ערך שמור.

לא ניתן לשלוח את השירות באופן אלחוטי.

kWirelessOperatingLocation_Outdoors

פעילות בחוץ.

מציין שמיקום הפעילות הצפוי של המכשיר הוא בחוץ.

kWirelessOperatingLocation_Unknown

מיקום הפעילות לא ידוע.

מציין שמיקום הפעילות הצפוי של המכשיר לא ידוע, או שהוא עשוי להשתנות עם הזמן.

פונקציות

ReplaceValue

WEAVE_ERROR ReplaceValue(
  char *& dest,
  const char *src
)

ReplaceValue

WEAVE_ERROR ReplaceValue(
  uint8_t *& dest,
  uint32_t & destLen,
  const uint8_t *src,
  uint32_t srcLen
)