Antilatency Radio Metrics Library

Antilatency Radio Metrics Library

用于评估使用Antilatency Radio Protocol(Antilatency无线电协议)的设备之间的无线连接质量的库。

库功能

此库允许获取反映客户端和接入点之间连接质量的当前无线电度量。例如,信号强度(RSSI)和无线数据包丢失率。

使用库

  1. 加载库;
  2. 获取ILibrary
  3. 对于目标客户端(TargetNode),使用Antilatency.DeviceNetwork.INetwork.nodeGetParent确定其父客户端(ParentNode);
  4. 使用startTask从上一步开始在ParentNode上启动Task(任务);
  5. 使用ICotask.getMetrics以一定间隔请求TargetNode的统计信息。最佳间隔为100-500 ms。
每个ICotask.getMetrics请求或ICotask.getExtendedMetrics请求都会重置以前累积的统计信息。因此,同时使用两个请求是没有意义的。
当您使用当前未连接到ParentNodetargetNode时,ICotask.getMetricsICotask.getExtendedMetrics方法将引发异常。

度量

struct Metrics {
sbyte averageRssi;
float packetLossRate;
}
Metrics结构包含两个值,在大多数情况下,这两个值足以评估当前无线电质量:

扩展度量

struct ExtendedMetrics {
uint txBytes;
uint txPacketsCount;
uint rxBytes;
uint rxPacketsCount;
uint flowCount;
sbyte averageRssi;
sbyte minRssi;
sbyte maxRssi;
uint missedPacketsCount;
uint failedPacketsCount;
}
ExtendedMetrics包含许多可用于调试和诊断无线电连接的值。例如,自上次请求以来成功接收/传输的数据包数和数据量、平均/最小/最大RSSI值以及丢失和失败的数据包数。
所选无线信道的拥塞可能会导致大量数据包丢失。使用RadioScanner实用程序分析无线电拥塞并选择更合适的信道。

有用链接