OpenThread C API 参考文档更新

如需详细了解 API 参考文档更新,请参阅 GitHub 上带“拉取请求”标签的 "api: platform""api: user"

2024 年 4 月 11 日

2024 年 3 月 28 日

2024 年 3 月 21 日

2024 年 3 月 8 日

2024 年 2 月 27 日

2024 年 2 月 14 日

  • 向 CLI 命令参考文档中添加了新的 coaps 命令,以字母顺序开头 coaps connect
  • 针对 DNS-SD 添加了新的平台抽象模块。
  • 平台专用服务模块添加了新的 OPENTHREAD_CONFIG_PLATFORM_DNSSD_ENABLE 宏。
  • SRP 服务器模块中新增了 OPENTHREAD_CONFIG_SRP_SERVER_ADVERTISING_PROXY_ENABLE 宏。

2021 年 2 月

  • 向 CLI 命令参考文档中添加了新的 coap 命令,以字母顺序开头 coap cancel
  • Ipv6 APIotIp6AddressInfo 结构体添加了 mMeshLocal 属性。

2024 年 2 月 1 日

  • 向 CLI 命令参考文档中添加了新的 commissioner 命令,以字母顺序开头 commissioner announce
  • CoAP Secure API 添加了新的 otCoapSecureIsClosedotCoapSecureStartWithMaxConnAttempts 函数。
  • NAT64 API 添加了新的 otIp4FromIp4MappedIp6AddressotIp4ToIp4MappedIp6Address 函数。
  • Radio Operation API 添加了新的 otPlatRadioResetCsl 函数。

2024 年 1 月 23 日

2024 年 1 月 9 日

  • 向 CLI 命令参考添加了新的 history 命令,按字母顺序以 history ip addr 开头。
  • TREL 平台添加了新的 otPlatTrelCounters 结构体。
  • DNS-SD Server API 添加了新的 otUpstreamDnsCounters 结构体。

2023 年 12 月 27 日

2023 年 12 月 13 日

2023 年 11 月 29 日

  • 向 CLI 命令参考添加了新的 SRP 服务器命令,按字母顺序以 srp server (enable,disable) 开头。
  • Multipan 添加了新的平台抽象模块。
  • Network Co-Processor API 添加了新的 otNcpHdlcInitMulti 函数。
  • Instance API 添加了新的 otInstanceInitMultiple 函数。
  • Message API 添加了新的 otMessageIsMulticastLoopEnabledotMessageSetMulticastLoopEnabled 函数。

2023 年 11 月 21 日

2023 年 11 月 7 日

  • 向 CLI 命令参考添加了新的 TCP 命令,以字母顺序开头 tcp abort

2023 年 11 月 2 日

2023 年 10 月 13 日

2023 年 10 月 5 日

2023 年 9 月 28 日

2023 年 9 月 22 日

2023 年 9 月 14 日

2023 年 9 月 8 日

2023 年 8 月 29 日

2023 年 8 月 15 日

2023 年 7 月 31 日

  • 向 CLI 命令参考添加了新命令 mleadvimax
  • Router/Leader API 中添加了 otThreadGetAdvertisementTrickleIntervalMax 函数。

2023 年 7 月 26 日

2023 年 7 月 19 日

  • 新增了 API 和相关 CLI 命令,可让用户手动将发布的路由偏好设置设置为 Border Routing Manager API
  • 更新了 SRP API,以便更好地处理服务实例名称。
  • Mesh Diagnostics API 添加了新的结构体、函数和相关 CLI 命令,以收集消息在 TX 队列中的时间的统计信息。

2023 年 6 月 26 日

2023 年 6 月 13 日

2023 年 6 月 1 日

2023 年 5 月 17 日

2023 年 5 月 8 日

  • 向 CLI 命令参考添加了新命令:
  • Border Agent API 添加了 otBorderAgentGetId 函数。
  • IPv6 API 添加了 otIp6PrefixFromString 函数。
  • Thread - General API 添加了 otThreadGetVendorModelotThreadGetVendorNameotThreadGetVendorSwVersionotThreadSetVendorModelotThreadSetVendorNameotThreadSetVendorSwVersion 函数。

2023 年 5 月 1 日

  • Crypto Platform API 中添加了 otPlatCryptoEcdsaGenerateAndImportKeyotPlatCryptoEcdsaExportPublicKeyotPlatCryptoEcdsaSignUsingKeyRefotPlatCryptoEcdsaVerifyUsingKeyRef 函数。
  • Platform Factory Diagnostics API 添加了 otPlatDiagRadioTransmitStream 函数。

2023 年 4 月 18 日

  • NAT64 API 中添加了 otIp4CidrFromString 函数。

2023 年 3 月 28 日

2023 年 3 月 23 日

2023 年 3 月 15 日

2023 年 3 月 2 日

2023 年 2 月 20 日

2023 年 2 月 14 日

2023 年 1 月 31 日

2023 年 1 月 18 日

2023 年 1 月 3 日

2022 年 11 月 18 日

2022 年 10 月 26 日

2022 年 10 月 19 日

2022 年 10 月 13 日

2022 年 9 月 21 日

  • NAT64 API 添加了 otIp4AddressFromStringotNat64SynthesizeIp6Address 函数。
  • SRP API 中添加了 otSrpServerIsAutoEnableModeotSrpServerSetAutoEnableMode 函数。
  • TCP Abstractions API 的枚举更新。

2022 年 9 月 15 日

  • NAT64 API 添加了新的枚举、类型定义符和函数,以支持新的 NAT64 CLI 命令。
  • 向 CLI 命令参考添加了 NAT64 命令,包括 NAT64 CIDR、前缀、映射和计数器命令。

2022 年 8 月 25 日

2022 年 8 月 24 日

  • NAT64 API 添加了 otNat64ReceiveIp4CallbackotIp4NewMessageotNat64SendotNat64SetIp4CidrotNat64SetReceiveIp4Callback 函数。
  • 向 CLI 命令参考添加了 child 命令。

2022 年 8 月 16 日

  • Border Routing Manager API 添加了 otBorderRoutingGetFavoredNat64Prefix 函数。
  • General API 中添加了 otThreadSearchForBetterParent 方法。
  • 基础架构接口中添加了 otPlatInfraIfDiscoverNat64PrefixotPlatInfraIfDiscoverNat64PrefixDone 方法。
  • IPv6 API 中添加了 otIp6GetPrefix 方法。
  • NAT64 API 添加了 otIp4ExtractFromIp6AddressotIp4IsAddressEqual 函数。
  • 更新了 otRouterInfo 结构体
  • 向 CLI 命令参考添加了 bbr 和其他命令。

2022 年 8 月 3 日

  • 向 CLI 命令参考添加了 channel 命令。

2022 年 7 月 27 日

2022 年 7 月 20 日

2022 年 7 月 14 日

2022 年 7 月 7 日

  • Border Router API 添加了 otBorderRoutingGetRouteInfoOptionPreferenceotBorderRoutingSetRouteInfoOptionPreference 函数。

2022 年 6 月 28 日

  • IPv6 API 添加了 OT_IP6_MAX_MLR_ADDRESSES 宏。
  • Thread - General APIotNetDataPublishExternalRouteotNetDataPublishOnMeshPrefix 函数中移除了 OT_ERROR_ALREADY

2022 年 6 月 14 日

  • Operational Dataset API 添加了 otTimestamp 类型定义。
  • Platform - Settings API 中移除了 OT_SETTINGS_KEY_LEGACY_NAT64_PREFIXOT_SETTINGS_KEY_LEGACY_OMR_PREFIX OT_SETTINGS_KEY_ON_LINK_PREFIXOT_SETTINGS_KEY_RESERVED 枚举。
  • SRP API 添加了 otSrpServerTtlConfig 类型定义符以及 otSrpClientEnableAutoHostAddressotSrpServerGetTtlConfigotSrpServerServiceGetTtlotSrpServerSetTtlConfig 函数。
  • Thread - General API 中添加了 otDetachGracefullyCallback 类型定义符和 otThreadDetachGracefully 函数。

2022 年 5 月 31 日

  • DNS-SD Server API 中添加了 otDnssdCounters typedef 和 otDnssdGetCounters 函数。
  • 移除了 otPlatRadioGetCslClockUncertainty 函数,并向 Radio Operation API 添加了 otPlatRadioGetCslUncertainty 函数。
  • SRP API 中添加了 otSrpServerLeaseInfootSrpServerResponseCounters 类型定义符、otSrpClientGetTtlotSrpClientSetTtlotSrpServerGetPortotSrpServerGetResponseCountersotSrpServerHostGetLeaseInfootSrpServerServiceGetLeaseInfo 函数。

2022 年 5 月 18 日

  • Commissioner API 添加了 otCommissionerGetIdotCommissionerSetId 函数。
  • 添加了 TCP Abstractions API
  • 添加了 otTcpForwardProgress 类型定义符,从 TCP API 中移除了 otTcpBytesAckedotTcpSendReady 类型定义符。
  • Thread - General API 中添加了 otNetDataContainsOmrPrefix 函数。

2022 年 4 月 20 日

2022 年 4 月 13 日

2022 年 3 月 30 日

2022 年 3 月 15 日

  • DNSv6 API 添加了 otDnsClientResolveIp4Address 函数。
  • Platform Settings API 添加了 OT_SETTINGS_KEY_BR_ULA_PREFIX 枚举以及其他枚举更新。

2022 年 2 月 23 日

  • 命令行界面 API 中移除了 otCliPlatLogLine 函数。
  • Logging - Platform API 中移除了 otPlatLogLine 函数。
  • Logging - Thread Stack API 中添加了 otDumpCritPlatotDumpDebgPlatotDumpInfoPlatotDumpNotePlatotDumpWarnPlatotLogCliotLogCritPlatotLogDebgPlatotLogInfoPlatotLogNotePlatotLogWarnPlat 函数。

2022 年 2 月 2 日

  • CoAP API 中添加了 otCoapMessageSetCode 函数。
  • Crypto - Platform API 中添加了 otPlatCryptoRandomDeinitotPlatCryptoRandomGetotPlatCryptoRandomInit 函数。
  • RNG Cryptographic API 中移除了 otRandomCryptoMbedTlsContextGet
  • Entropy Source API 已被移除。
  • History Tracker API 中添加了 otHistoryTrackerNetDataEvent 枚举、otHistoryTrackerExternalRouteInfootHistoryTrackerOnMeshPrefixInfo 类型定义符、otHistoryTrackerIterateExternalRouteHistoryotHistoryTrackerIterateOnMeshPrefixHistory 函数。
  • TCP API 添加了新的转换控制块 (TCB) 宏。
  • 添加了适用于 Thread Over Infrastructure 的 Thread Radio Encapsulation Link (TREL) API
  • TREL - Platform API 的函数、typedef 和结构体更新。

2022 年 1 月 19 日

  • Backbone Router API 中添加了 otBackboneRouterNdProxyInfo 类型定义符和 otBackboneRouterConfigSkipSeqNumIncrease 方法。
  • Border Router API 中添加了 otBorderRoutingGetNat64Prefix 函数。
  • 更新了 IPv6 API 中的 otIp6SubscribeMulticastAddress 返回值。
  • Joiner API 添加了 otJoinerStateToString 函数。
  • 更新了 Logging - Platform API 中的 otPlatLogLine 函数。
  • Settings API 上的设置枚举添加了 OT_SETTINGS_KEY_NAT64_PREFIX 键。

2021 年 12 月 7 日

  • Link API 中添加了 otLinkIsRadioFilterEnabledotLinkSetRadioFilterEnabled 函数。
  • Router/Leader API 添加了 otThreadSetThreadVersionCheckEnabled

2021 年 9 月 27 日

  • Crypto API 中添加了 otCryptoContext 结构体。

2021 年 9 月 20 日

  • History Tracker API 添加了 otHistoryTrackerMulticastAddressInfootHistoryTrackerUnicastAddressInfo 结构体。

2021 年 9 月 13 日

2021 年 8 月 30 日

2021 年 8 月 24 日

2021 年 6 月 22 日

2021 年 5 月 10 日

  • SRP API 添加了 otSrpServerLeaseConfig 结构体。

2021 年 4 月 12 日

2021 年 4 月 5 日

  • Ping Sender API 中添加了 otPingSenderStatistics 结构体。
  • SRP API 添加了 otSrpClientBuffersServiceEntry 结构体。

2021 年 3 月 25 日

2021 年 3 月 9 日

  • DNS API 中添加了 otDnsTxtEntryotDnsTxtEntryIterator 结构体。
  • Message API 中移除了 otMessage 结构体。
  • Message Pool API 添加了 otMessageBuffer 结构体。

2021 年 2 月 22 日

  • DNS API 添加了 otDnsQueryConfig 结构体。

2021 年 2 月 16 日

  • DNS API 中移除了 otDnsQuery 结构体,并向其中添加了 otDnsServiceInfo 结构体。

2021 年 2 月 9 日

  • SRP API 添加了 otSrpClientGetServerAddressotSrpClientIsRunningotSrpClientSetCallback 函数。
  • Heap API 已弃用。

2021 年 2 月 2 日

  • CoAP API 添加了 otCoapBlockwiseResource 结构体。
  • SRP API 中移除了 otSrpTxtEntry 结构体。

2021 年 1 月 26 日

2021 年 1 月 20 日

2020 年 11 月 9 日

2020 年 10 月 20 日

  • IPv6 API 添加了 otIp6AddressInfo 结构体。

2020 年 10 月 2 日

2020 年 8 月 31 日

  • 在 Thread 1.2 中添加了用于实现协调采样监听 (CSL) 的 API。
  • Backbone Router API 添加了 otBackboneRouterMulticastListenerInfo 结构体。

2020 年 8 月 12 日

  • 常规 API 中添加了 otThreadDiscoveryRequestInfo 结构体。

2020 年 7 月 15 日

  • Backbone Router API 添加了 otBackboneRouterConfig 函数。

  • CoAP API 中移除了 otCoapAddResource 函数。

  • Commissioner API 添加了 otJoinerPskdotJoinerInfoTypeotCommissionerAddJoinerWithDiscernerotCommissionerRemoveJoinerWithDiscerner 函数。

  • Joiner API 添加了 otJoinerGetDiscernerotJoinerSetDiscernerotJoinerDiscerner 函数。

  • Link API 添加了 otLinkFilterClearDefaultRssInotLinkFilterSetDefaultRssIn 函数。

  • Raw Link API 中添加了 otLinkRawGetRadioTimeotLinkRawSetMacFrameCounterotLinkRawSetMacKey 函数。

  • General API 中添加了 otDatasetGetActiveTlvsotDatasetGetPendingTlvsotDatasetSetActiveTlvsotDatasetSetPendingTlvsotThreadGetFixedDuaInterfaceIdentifierotThreadSetFixedDuaInterfaceIdentifier 函数。

  • UDP Forward API 中移除了 otUdpGetSockets 函数。

  • UDP API 添加了 otUdpGetSockets 函数。

  • otPlatRadioGetNowotPlatRadioSetMacFrameCounterotPlatRadioSetMacKey 是添加到 Platform Radio Configuration API 中的函数。

2020 年 4 月 27 日

2020 年 3 月 24 日

  • CoAP API 添加了 OT_COAP_MAX_RETRANSMITOT_COAP_MIN_ACK_TIMEOUT 宏。

2020 年 3 月 2 日

  • 更新了 CoAP API
    • 添加了 otCoapOptionIteratorotCoapTxParameters 结构体。
    • 添加了辅助函数,以对 CoAP 屏蔽选项进行编码。
    • 添加了一些函数,用于为 CoAP 请求和响应指定每条消息的传输参数。

2020 年 1 月 9 日

  • Link API 中添加了直方图重试函数。

2019 年 12 月 3 日

  • 将服务器和服务配置函数及结构体从服务器 API 移至通用 API,以支持主要方的服务注册。
  • Router API 中,*RouterRoleEnabled 函数已重命名为 *RouterEligible,以支持 REED 增强功能。
  • Logging Platform API 中移除了 otPlatLogv 函数。
  • Toolchain Platform API 和各种结构体定义中移除了 OT_TOOL_ALIGN 宏。

2019 年 11 月 11 日

  • 向 General API 添加了 otThreadResetIp6Counters 函数。
  • Link API 添加了用于重置计数器以及获取和设置帧重试次数上限的新函数。

2019 年 10 月 25 日

2019 年 9 月 19 日

  • 将“Random API”页面拆分为 CryptoNon-Crypto 以与源代码一致。
  • Commissioner API 添加了 otJoinerInfo 结构体和 otCommissionerGetNextJoinerInfo 函数。
  • Radio Types API 中添加了 otRadioCoexMetrics 结构体和 otPlatRadioIsCoexEnabled 函数。
  • 将始终成功的众多 API 的返回值类型从 otError 更改为了 void

2019 年 8 月 9 日

2019 年 6 月 17 日

  • Commissioner API 添加了用于通知状态变化和联接 activity 的回调。
  • 不仅移除了 Windows 支持,还移除了 OTAPIOTCALLOT_CALLOT_CDECL 的编译器专用函数修饰符。

2019 年 5 月 28 日

2019 年 5 月 14 日

2019 年 3 月 14 日

2019 年 2 月 25 日

  • IPv6 API 中移除了 otIp6SlaacIidCreateotIp6SlaacUpdate 函数。

2019 年 1 月 30 日

2019 年 1 月 23 日

  • UDP API 添加了 UDP 接收器函数。
  • CoAP API 中移除了 otCoapHeader 结构体。CoAP 标头信息已优化为 CoAP 消息。
  • DHCPv6 Server API 已被移除。

2019 年 1 月 7 日