OpenThread C API 參考資料更新

請參閱 API: 平台和 「api:user」 找到 GitHub 的「提取要求」,進一步瞭解 API 參考資料更新。

2024 年 8 月 29 日

  • 已將新的 otLinkGetFrameCounter 函式新增至 Link API。

2024 年 8 月 23 日

  • 已新增「ba counters」 新增至 CLI 指令參考資料

  • 新增了 「OPENTHREAD_CONFIG_BORDER_ROUTING_REACHABILITY_CHECK_ICMP6_ERROR_ENABLE」和 OPENTHREAD_CONFIG_BORDER_ROUTING_TESTING_API_ENABLE 巨集加到 邊界轉送管理員模組 參閱「設定變數參考資料」部分

  • 新增了 otTcatAdvertisedDeviceId 結構,並重新命名 otTcatDeviceId結構至 otTcatGeneralDeviceId,位於 BLE Secure API。

  • 已將新的 otBorderAgentGetCounters 函式新增至 Border Agent API。

  • 已將新的 otBorderAgentCounters 結構新增至 Border Agent API。

  • 已將新的 otBorderRoutingSetOnLinkPrefix 函式新增至 Border Relay Manager API。

2024 年 8 月 7 日

2024 年 7 月 26 日

2024 年 7 月 12 日

  • 已將新的 otCoapMessageAppendUriQueryOptions 函式新增至 CoAP API。

  • 新增了 OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE 巨集加到 邊界轉送管理員模組 參閱「設定變數參考資料」部分

2024 年 6 月 21 日

  • 已將新的 otBleSecureSetTcatVendorInfo 函式新增至 BLE Secure API。

  • 已將新的 otDiagSetOutputCallback 函式新增至 工廠診斷 - Thread Stack API。

  • 在 多點傳送 DNS API: otMdnsGetNextBrowser、otMdnsGetNextIp4AddressResolver、 otMdnsGetNextIp6AddressResolver, otMdnsGetNextSrvResolver 和 otMdnsGetNextTxtResolver。

  • 為 BLE platform extraction module 新增了函式: otPlatBleGapAdvSetData、otPlatBleGetAdvertisementBuffer、 otPlatBleGetLinkCapabilities 和 otPlatBleSupportsMultiRadio。

  • 已將新的 otPlatDiagSetOutputCallback 函式新增至 Factory Diagnostics - Platform abstraction module。

  • 已將 otTcatDeviceID 結構體新增至 BLE Secure API。

  • 已將 otMdnsCacheInfo 結構體新增至 多點傳送 DNS API。

  • 能完美整合平台或原生 mDNS 下列結構體新增至 DNS-SD (mDNS) 平台抽像模組: otPlatDnssdAddressAndTtl、otPlatDnssdAddressResolver、 otPlatDnssdAddressResult、otPlatDnssdBrowseResult、 otPlatDnssdBrowser、otPlatDnssdSrvResolver、 otPlatDnssdSrvResult、otPlatDnssdTxtResolver和 otPlatDnssdTxtResult。

    多點傳播 DNS API 已更新,現已採用 typedef 別名是對應的 otPlatDnssd 結構定義。

  • 已將 otBleLinkCapabilities 結構體新增至 BLE platform extraction module。

  • 將 OPENTHREAD_CONFIG_DNSSD_DISCOVERY_PROXY_ENABLE 巨集新增至 DNS-SD Server 模組 參閱「設定變數參考資料」部分

  • 已新增 OPENTHREAD_CONFIG_MULTICAST_DNS_ENTRY_ITERATION_API_ENABLE 巨集 「多點傳播 DNS」模組 參閱「設定變數參考資料」部分

2024 年 5 月 17 日

2024 年 4 月 29 日

  • 已新增「test tmforiginfilter」 新增至 CLI 指令參考資料

  • 已將新的 otBorderRoutingDhcp6PdSetRequestCallback 函式新增至 Border Relay Manager API。

  • 已將新的 otBorderRoutingRequestDhcp6PdCallback typedef 新增至 Border Relay Manager API。

  • 已將新的 otLinkMetricsManagerIsEnabled 函式新增至 Link Metrics API。

  • 在 多點傳送 DNS API: otMdnsAllocateIterator、otMdnsFreeIterator、otMdnsGetNextHost、 otMdnsGetNextKey 和 otMdnsGetNextService。

  • 在 Router/Leader API: otThreadIsTmfOriginFilterEnabled、otThreadSetThreadVersionCheckEnabled、 和 otThreadSetTmfOriginFilterEnabled。

  • 將 OPENTHREAD_CONFIG_MULTICAST_DNS_AUTO_ENABLE_ON_INFRA_IF 巨集新增至 多點傳播 DNS 模組 參閱「設定變數參考資料」部分

  • 已新增 OPENTHREAD_CONFIG_PLATFORM_DNSSD_ALLOW_RUN_TIME_SELECTION 巨集 「平台專屬服務」單元 參閱「設定變數參考資料」部分

2024 年 4 月 11 日

2024 年 3 月 28 日

2024 年 3 月 21 日

2024 年 3 月 8 日

2024 年 2 月 27 日

2024 年 2 月 14 日

2024 年 2 月 6 日

  • 在 CLI 指令參考資料中新增 coap 指令。 開頭為 coap cancel。
  • 已將 mMeshLocal 屬性新增至otIp6AddressInfo Ipv6 API。

2024 年 2 月 1 日

  • 在 CLI 指令參考資料中新增 commissioner 指令。 開頭為 commissioner announce。
  • 新增了 otCoapSecureIsClosed 和 otCoapSecureStartWithMaxConnAttempts 函式 CoAP Secure API。
  • 已新增 「otIp4FromIp4MappedIp6Address」和「otIp4ToIp4MappedIp6Address」 NAT64 API 使用函式。
  • 已將新的 otPlatRadioResetCsl 函式新增至 Radio Operation API。

2024 年 1 月 23 日

  • 將新的 TREL 模組新增至 設定變數參考資料。

2024 年 1 月 9 日

  • 已將新的 history 指令新增至 CLI 指令參考資料,開始指令 依照字母順序與 history ip addr 聯絡。
  • 已將新的 otPlatTrelCounters 結構新增至 TREL 平台。
  • 已將新的 otUpstreamDnsCounters 結構新增至 DNS-SD Server API。

2023 年 12 月 27 日

2023 年 12 月 13 日

2023 年 11 月 29 日

  • 已將新的 SRP 伺服器指令新增至 CLI 指令參考資料,從開始 依照字母順序與 srp server (enable,disable) 聯絡。
  • 為 Multipan 新增平台抽像模組。
  • 已將新的 otNcpHdlcInitMulti 函式新增至 網路共同處理器 API。
  • 已將新的 otInstanceInitMultiple 函式新增至 Instance API:
  • 新增了 otMessageIsMulticastLoopEnabled 和 otMessageSetMulticastLoopEnabled 函式對應至 Message API:

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 日

  • 已將新指令 mleadvimax 加入 CLI 指令參考資料
  • 已將 otThreadGetAdvertisementTrickleIntervalMax 函式新增至 Router/Leader API。

2023 年 7 月 26 日

2023 年 7 月 19 日

  • 新增 API 和相關 CLI 指令,讓使用者手動設定 已發布的路線偏好設定 Border Relay Manager API:
  • 更新 SRP API 以更有效地處理 服務執行個體名稱
  • 將新的結構體、函式和相關 CLI 指令新增至 Mesh Diagnostics API: 訊息在 TX 佇列中花費的時間統計資料。

2023 年 6 月 26 日

2023 年 6 月 13 日

2023 年 6 月 1 日

2023 年 5 月 17 日

2023 年 5 月 8 日

  • 在 CLI 指令參考資料中新增指令:
  • otBorderAgentGetId 函式添加到 Border Agent API。
  • otIp6PrefixFromString 函式中加入 IPv6 API。
  • otThreadGetVendorModel、otThreadGetVendorName、 otThreadGetVendorSwVersion、otThreadSetVendorModel、otThreadSetVendorName和otThreadSetVendorSwVersion 函式,並新增至 Thread - General API。

2023 年 5 月 1 日

  • otPlatCryptoEcdsaGenerateAndImportKey、otPlatCryptoEcdsaExportPublicKey、 otPlatCryptoEcdsaSignUsingKeyRef及otPlatCryptoEcdsaVerifyUsingKeyRef 函式並新增至 Crypto Platform API。
  • 已將 otPlatDiagRadioTransmitStream 函式新增至 Platform Factory Diagnostics API:

2023 年 4 月 18 日

  • 已將 otIp4CidrFromString 函式新增至 NAT64 API。

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 日

  • otNat64State、otNat64GetPrefixManagerState、otNat64GetTranslatorState、 和 otNat64SetEnabled 函式已新增到 NAT64 API。
  • 已新增 nat64 (enable,disable)敬上 和 nat64 state 到 CLI 指令參考資料

2022 年 10 月 13 日

2022 年 9 月 21 日

  • otIp4AddressFromString 和 otNat64SynthesizeIp6Address 函式 新增至 NAT64 API。
  • 「otSrpServerIsAutoEnableMode」和「otSrpServerSetAutoEnableMode」 函式數量。
  • TCP Abstractions API 列舉更新。

2022 年 9 月 15 日

  • 將新的列舉、typedefs 和函式新增至 NAT64 API 以支援新的 NAT64 CLI 指令。
  • 將 NAT64 指令新增至 CLI 指令參考資料,包括 NAT64 CIDR、前置字串 對應和計數器指令

2022 年 8 月 25 日

2022 年 8 月 24 日

  • otNat64ReceiveIp4Callback、otIp4NewMessage、otNat64Send、 已新增 otNat64SetIp4Cidr 和 otNat64SetReceiveIp4Callback 函式 NAT64 API。
  • 已新增 child 指令 CLI 指令參考資料

2022 年 8 月 16 日

  • 已將 otBorderRoutingGetFavoredNat64Prefix 函式新增至 Border Relay Manager API。
  • 已將 otThreadSearchForBetterParent 方法新增至 一般 API。
  • 「otPlatInfraIfDiscoverNat64Prefix」和 已將 otPlatInfraIfDiscoverNat64PrefixDone 方法新增至 基礎架構介面。
  • 已將 otIp6GetPrefix 方法新增至 IPv6 API:
  • 已新增 otIp4ExtractFromIp6Address 和 otIp4IsAddressEqual 函式至 NAT64 API。
  • 已更新 otRouterInfo 結構體。
  • 已新增 bbr 和其他指令 CLI 指令參考資料

2022 年 8 月 3 日

  • 將 channel 指令新增至 CLI 指令參考資料

2022 年 7 月 27 日

2022 年 7 月 20 日

2022 年 7 月 14 日

2022 年 7 月 7 日

  • 「otBorderRoutingGetRouteInfoOptionPreference」和 otBorderRoutingSetRouteInfoOptionPreference 函式已新增至 邊界路由器 API。

2022 年 6 月 28 日

  • OT_IP6_MAX_MLR_ADDRESSES 巨集已新增到 IPv6 API:
  • 已從「otNetDataPublishExternalRoute」和「OT_ERROR_ALREADY」中移除 otNetDataPublishOnMeshPrefix 中的 Thread - 一般 API。

2022 年 6 月 14 日

  • otTimestamp typedef 已新增至 Operational Dataset API
  • OT_SETTINGS_KEY_LEGACY_NAT64_PREFIX、OT_SETTINGS_KEY_LEGACY_OMR_PREFIX OT_SETTINGS_KEY_ON_LINK_PREFIX 和 OT_SETTINGS_KEY_RESERVED 列舉 已從 Platform - Settings API 中移除。
  • otSrpServerTtlConfig typedef 和 otSrpClientEnableAutoHostAddress, otSrpServerGetTtlConfig、otSrpServerServiceGetTtl和 otSrpServerSetTtlConfig 函式已新增到 SRP API。
  • otDetachGracefullyCallback typedef 和 otThreadDetachGracefully 函式,加入 Thread - 一般 API。

2022 年 5 月 31 日

  • 已將 otDnssdCounters typedef 和 otDnssdGetCounters 函式新增至 DNS-SD Server API:
  • 已移除並新增 otPlatRadioGetCslClockUncertainty 函式 otPlatRadioGetCslUncertainty 函式 Radio Operation API 的存取權。
  • otSrpServerLeaseInfo 和 otSrpServerResponseCounters typedefs、 otSrpClientGetTtl、otSrpClientSetTtl、otSrpServerGetPort、 otSrpServerGetResponseCounters、otSrpServerHostGetLeaseInfo、 和 otSrpServerServiceGetLeaseInfo 函式已新增到 SRP API。

2022 年 5 月 18 日

2022 年 4 月 20 日

2022 年 4 月 13 日

2022 年 3 月 30 日

  • 已從以下位置移除 otBackboneRouterConfigSkipSeqNumIncrease 方法: Backbone Router API。
  • 已移除 otPlatSettingsSetCriticalKeys 函式和 otPlatSettingsInit 更新於 Platform Settings API:

2022 年 3 月 15 日

  • 已將 otDnsClientResolveIp4Address 函式新增至 DNSv6 API。
  • 將 OT_SETTINGS_KEY_BR_ULA_PREFIX 列舉與其他列舉更新一併新增至 Platform Settings API:

2022 年 2 月 23 日

2022 年 2 月 2 日

  • 已將 otCoapMessageSetCode 函式新增至 CoAP API。
  • otPlatCryptoRandomDeinit、otPlatCryptoRandomGet和 otPlatCryptoRandomInit 函式已新增至 Crypto - Platform API。
  • otRandomCryptoMbedTlsContextGet已從以下位置移除: RNG Cryptographic API。
  • 已移除 Entropy Source API。
  • otHistoryTrackerNetDataEvent 列舉、otHistoryTrackerExternalRouteInfo 和 otHistoryTrackerOnMeshPrefixInfo typedefs otHistoryTrackerIterateExternalRouteHistory 和 otHistoryTrackerIterateOnMeshPrefixHistory 函式 新增至 History Tracker API。
  • 在 TCP API。
  • 已新增 Thread Radio Encapsulation Link (TREL) API Thread over Infrastructure
  • 將函式、typedef 和 struct 更新至 TREL - Platform API。

2022 年 1 月 19 日

2021 年 12 月 7 日

  • otLinkIsRadioFilterEnabled 和 otLinkSetRadioFilterEnabled 函式 新增至 Link API。
  • 已將 otThreadSetThreadVersionCheckEnabled 新增至 Router/Leader API。

2021 年 9 月 27 日

  • 已將 otCryptoContext 結構體新增至 Crypto API:

2021 年 9 月 20 日

  • 「otHistoryTrackerMulticastAddressInfo」和「otHistoryTrackerUnicastAddressInfo」 結構體已新增至 History Tracker API。

2021 年 9 月 13 日

2021 年 8 月 30 日

2021 年 8 月 24 日

2021 年 6 月 22 日

2021 年 5 月 10 日

  • 已將 otSrpServerLeaseConfig 結構體新增至 SRP API。

2021 年 4 月 12 日

2021 年 4 月 5 日

  • 已將 otPingSenderStatistics 結構體新增至 Ping Sender API。
  • 已將 otSrpClientBuffersServiceEntry 結構體新增至 SRP API。

2021 年 3 月 25 日

2021 年 3 月 9 日

  • otDnsTxtEntry 和 otDnsTxtEntryIterator 結構體已新增至 DNS API:
  • otMessage 結構體已從 Message API。
  • 已將 otMessageBuffer 結構體新增至 Message Pool API。

2021 年 2 月 22 日

  • 已將 otDnsQueryConfig 結構體新增至 DNS API:

2021 年 2 月 16 日

  • 已移除 otDnsQuery 結構體,並將 otDnsServiceInfo 結構體新增至 DNS API:

2021 年 2 月 9 日

  • otSrpClientGetServerAddress、otSrpClientIsRunning和 otSrpClientSetCallback 函式已新增至 SRP API。
  • Heap API 已淘汰。

2021 年 2 月 2 日

  • 已將 otCoapBlockwiseResource 結構體新增至 CoAP API。
  • otSrpTxtEntry 結構體已從 SRP API。

2021 年 1 月 26 日

2021 年 1 月 20 日

2020 年 11 月 9 日

2020 年 10 月 20 日

  • 已將 otIp6AddressInfo 結構體新增至 IPv6 API:

2020 年 10 月 2 日

2020 年 8 月 31 日

  • 在 Thread 1.2 新增支援協調取樣 (CSL) 的 API。
  • 已將 otBackboneRouterMulticastListenerInfo 結構體新增至 Backbone Router API。

2020 年 8 月 12 日

  • 已將 otThreadDiscoveryRequestInfo 結構體新增至 一般 API。

2020 年 7 月 15 日

  • 已將 otBackboneRouterConfig 函式新增至 Backbone Router API。

  • 已將 otCoapAddResource 函式從 CoAP API。

  • otJoinerPskd、otJoinerInfoType、otCommissionerAddJoinerWithDiscerner、 和 otCommissionerRemoveJoinerWithDiscerner 函式已新增到 Commissioner API:

  • otJoinerGetDiscerner、otJoinerSetDiscerner、 和 otJoinerDiscerner 函式已新增到 Joiner API:

  • otLinkFilterClearDefaultRssIn 和 otLinkFilterSetDefaultRssIn 函式 新增至 Link API。

  • otLinkRawGetRadioTime、otLinkRawSetMacFrameCounter和 otLinkRawSetMacKey 函式已新增至 Raw Link API。

  • otDatasetGetActiveTlvs、otDatasetGetPendingTlvs、 otDatasetSetActiveTlvs、otDatasetSetPendingTlvs、 otThreadGetFixedDuaInterfaceIdentifier和 otThreadSetFixedDuaInterfaceIdentifier 函式已新增到 一般 API。

  • 已將 otUdpGetSockets 函式從 UDP Forward API。

  • otUdpGetSockets 函式已新增至 UDP API。

  • otPlatRadioGetNow、otPlatRadioSetMacFrameCounter、 和 otPlatRadioSetMacKey,已新增至 Platform Radio Configuration API:

2020 年 4 月 27 日

2020 年 3 月 24 日

  • 已將 OT_COAP_MAX_RETRANSMIT 和 OT_COAP_MIN_ACK_TIMEOUT 巨集新增至 CoAP API:

2020 年 3 月 2 日

  • 已更新 CoAP API:
    • 已新增 otCoapOptionIterator 和 otCoapTxParameters 結構。
    • 新增輔助函式,用於編碼 CoAP 區塊選項。
    • 新增函式來指定 CoAP 的每則訊息傳輸參數 再來是非同步的

2020 年 1 月 9 日

  • 已將直方圖重試函式新增至連結 API。

2019 年 12 月 3 日

2019 年 11 月 11 日

2019 年 10 月 25 日

2019 年 9 月 19 日

  • 將 Random API 頁面分割為 Crypto 頁面 和非加密編譯,以符合 Cloud Build 觸發條件 會在您變更原始碼時自動啟動建構作業
  • 已新增 otJoinerInfo 結構體和 otCommissionerGetNextJoinerInfo 函式 Commissioner API 的存取權。
  • 已新增 otRadioCoexMetrics 結構體和 otPlatRadioIsCoexEnabled 函式至 Radio Types API 的組合。
  • 已變更一律從 otError 成功的多個 API 傳回類型 至 void。

2019 年 8 月 9 日

2019 年 6 月 17 日

  • 新增了回呼,用於通知狀態變更和彙整器活動 Commissioner API。
  • 編譯器專屬的函式修飾符 OTAPI、OTCALL、OT_CALL 和 移除 Windows 支援後,已移除 OT_CDECL。

2019 年 5 月 28 日

2019 年 5 月 14 日

2019 年 3 月 14 日

2019 年 2 月 25 日

  • 已將 otIp6SlaacIidCreate 和 otIp6SlaacUpdate 函式從 IPv6 API:

2019 年 1 月 30 日

  • 多項 CLI API 修正項目。
  • 已將「mDidTx」從「otRadioFrame」中移除 結構體

2019 年 1 月 23 日

2019 年 1 月 7 日