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 枚举
WiFi 操作模式。
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

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

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

[字节字符串 ] Thread 扩展 PAN ID。

kTag_ThreadMeshPrefix

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

kTag_ThreadNetworkKey

[字节字符串 ] Thread 主网络键。

kTag_ThreadNetworkName

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

kTag_ThreadPANId

[ uint, 16-bit max ] 线程 PAN ID(可选)。

kTag_ThreadPSKc

[ uint, 16-bit max ] 线程 PSKc(可选)。

kTag_WiFiMode

[ uint, 8-bit max ] 一个整数用于标识 Wi-Fi 网络的操作模式。

kTag_WiFiPreSharedKey

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

kTag_WiFiRole

[ uint, 8-bit max ] 一个整数用于标识设备在 Wi-Fi 网络中发挥的作用。

kTag_WiFiSSID

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

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

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