nl::Weave::Profiles::NetworkProvisioning

此命名空间包含 Weave 中针对 Weave 网络配置文件(三个 Weave 配置文件中的第一个)的所有接口。

摘要

这些接口定义了状态代码、消息类型、数据元素标记、其他常量、服务器对象和委托对象。

Nest Weave 网络配置文件专注于提供数据,以便为 Weave 设备获取网络接口(例如 802.15.4/Thread 和 802.11/Wi-Fi),使设备可以加入这些网络。

枚举

@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
}
枚举
网络配置状态代码。
@213 枚举
网络配置消息类型。
@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
}
枚举
@215 枚举
线程 PAN ID。
@216 枚举
线程通道。
GetNetworkFlags 枚举
获取网络标记。
NetworkType 枚举
网络类型。
RendezvousModeFlags 枚举
Rendezvous 模式标志。
WiFiMode 枚举
Wi-Fi 操作模式。
WiFiRole 枚举
设备 Wi-Fi 角色。
WiFiSecurityType 枚举
Wi-Fi 安全模式。
WirelessOperatingLocation{
  kWirelessOperatingLocation_NotSpecified = 0x00,
  kWirelessOperatingLocation_Unknown = 0x01,
  kWirelessOperatingLocation_Indoors = 0x02,
  kWirelessOperatingLocation_Outdoors = 0x03
}
枚举
设备的运行地点(与无线法规规则相关)。

函数

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

一种实用程序类,用于对通过 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

找不到具有指定网络 ID 的已配置网络。

kStatusCode_UnsupportedNetworkType

指定的网络类型未知或不受支持。

kStatusCode_UnsupportedOperatingLocation

指定的无线运行位置不受支持。

kStatusCode_UnsupportedRegulatoryDomain

指定的无线监管网域不受支持。

kStatusCode_UnsupportedWiFiMode

指定的 Wi-Fi 模式不受支持。

kStatusCode_UnsupportedWiFiRole

指定的 Wi-Fi 角色不受支持。

kStatusCode_UnsupportedWiFiSecurityType

指定的 Wi-Fi 安全类型不受支持。

@213

 @213

网络配置消息类型。

@214

 @214

网络配置数据元素标记。

属性
kTag_EnabledNetworks

[ 数组 ] 用于标识设备上当前启用的网络的 NetworkId 数组。

kTag_NetworkId

[ uint,最大 32 位 ] 唯一标识已预配网络的整数。

kTag_NetworkInformation

[ struct ] 包含网络信息的结构。

kTag_NetworkType

[ uint,8 位最大值 ] 用于标识网络类型的无符号整数值。

kTag_Networks

[数组 ] NetworkConfiguration 结构的数组。

kTag_RendezvousMode

[ uint ] 表示当前处于活动状态的聚会模式的位字段。

kTag_ThreadChannel

[ uint,最多 8 位 ] 线程通道号(可选)。

kTag_ThreadExtendedPANId

[字节字符串 ] 线程扩展 PAN ID。

kTag_ThreadMeshPrefix

[ 字节字符串,正好 8 个字节 ] 线程网格 IPv6 /64 前缀(可选)。

kTag_ThreadNetworkKey

[字节字符串 ] Thread 主网络密钥。

kTag_ThreadNetworkName

[ UTF-8 字符串 ] 包含 Thread 网络名称的 UTF-8 字符串。

kTag_ThreadPANId

[ uint,最大 16 位 ] 线程 PAN ID(可选)。

kTag_ThreadPSKc

[ uint,最大 16 位 ] 线程 PSKc(可选)。

kTag_WiFiMode

[ uint,最大 8 位 ] 用于标识 Wi-Fi 网络操作模式的整数。

kTag_WiFiPreSharedKey

[字节字符串 ] 包含 WiFi 密码/预共享密钥的字节字符串。

kTag_WiFiRole

[ uint, 8-bit max ] 一个整数,用于标识设备在 Wi-Fi 网络中扮演的角色。

kTag_WiFiSSID

[UTF-8 字符串 ] 包含 Wi-Fi SSID 的字符串。

kTag_WiFiSecurityType

[ uint,最大值 8 位 ] 标识 WiFi 网络使用的安全类型的整数值。

kTag_WirelessRegConfig_OperatingLocation

[ uint enum, 8-bit max ] 与无线监管规则相关的操作位置。

kTag_WirelessRegConfig_RegulatoryDomain

[ UTF-8 字符串, len 2 ] 无线监管域。

kTag_WirelessRegConfig_SupportedRegulatoryDomains

[array of string len 2 ] 支持监管域的列表。

kTag_WirelessSignalStrength

[ int, 16-bit max ] 一个有符号整数值,表示无线网络的信号强度(以 dBm 为单位)。

@215

 @215

线程 PAN ID。

@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
)