OpenThread C API Reference Updates

See "api: platform" and "api: user" labeled Pull Requests on GitHub for additional details on API Reference updates.

June 22, 2021

• TCP API added.
• otMasterKey struct renamed to otNetworkKey in the Operational Dataset API.

May 10, 2021

• otSrpServerLeaseConfig struct added to the SRP API.

April 12, 2021

• DNS-SD Server API added.

April 5, 2021

• otPingSenderStatistics struct added to the Ping Sender API.
• otSrpClientBuffersServiceEntry struct added to the SRP API.

March 25, 2021

• Ping Sender API added.
• The UART Platform API has been removed.

March 9, 2021

• otDnsTxtEntry and otDnsTxtEntryIterator structs added to the DNS API.
• otMessage struct removed from the Message API.
• otMessageBuffer struct added to the Message Pool API.

February 22, 2021

• otDnsQueryConfig struct added to the DNS API.

February 16, 2021

• otDnsQuery struct removed from and otDnsServiceInfo struct added to the DNS API.

February 9, 2021

• otSrpClientGetServerAddress, otSrpClientIsRunning, and otSrpClientSetCallback functions added to the SRP API.
• Heap API is deprecated.

February 2, 2021

• otCoapBlockwiseResource struct added to the CoAP API.
• otSrpTxtEntry struct removed from the SRP API.

January 26, 2021

• SRP API added.

January 20, 2021

• Dataset Updater API added to Operational Dataset.
• Multi Radio Link API added.
• Thread Radio Encapsulation Link (TREL) API added.
• otCryptoSha256Hash struct added to the Crypto API.

November 9, 2020

• otLinkMetricsSeriesFlags struct added to the Link Metrics API.
• otBackboneRouterNdProxyInfo struct added to the Backbone Router API.

October 20, 2020

• otIp6AddressInfo struct added to the IPv6 API.

October 2, 2020

• Link Metrics API added.

August 31, 2020

• Added APIs for Coordinated Sampled Listening (CSL) support in Thread 1.2.
• otBackboneRouterMulticastListenerInfo struct added to the Backbone Router API.

August 12, 2020

• otThreadDiscoveryRequestInfo struct added to the General API.

July 15, 2020

• otBackboneRouterConfig function added to the Backbone Router API.

• otCoapAddResource function removed from the CoAP API.

• otJoinerPskd, otJoinerInfoType, otCommissionerAddJoinerWithDiscerner, and otCommissionerRemoveJoinerWithDiscerner functions added to the Commissioner API.

• otJoinerGetDiscerner, otJoinerSetDiscerner, and otJoinerDiscerner functions added to the Joiner API.

• otLinkFilterClearDefaultRssIn, and otLinkFilterSetDefaultRssIn functions added to the Link API.

• otLinkRawGetRadioTime, otLinkRawSetMacFrameCounter, and otLinkRawSetMacKey functions added to the Raw Link API.

• otDatasetGetActiveTlvs, otDatasetGetPendingTlvs, otDatasetSetActiveTlvs, otDatasetSetPendingTlvs, otThreadGetFixedDuaInterfaceIdentifier, and otThreadSetFixedDuaInterfaceIdentifier functions added to the General API.

• otUdpGetSockets function removed from the UDP Forward API.

• otUdpGetSockets function added to the UDP API.

• otPlatRadioGetNow, otPlatRadioSetMacFrameCounter, and otPlatRadioSetMacKey, functions added to the Platform Radio Configuration API.

April 27, 2020

• Backbone Router API added.
• Network Simulator Platform API added.
• otNetworkDiag* structs added to the General API for improved Network Diagnostic usability.
• otThreadGetDomainName and otThreadSetDomainName functions added to the General API.
• otCommissionerGeneratePskc function removed from the Commissioner API. Use the otDatasetGeneratePskc function in the General API to generate a PSKc going forward.
• Router API updated for access to the address cache table.

March 24, 2020

• Added OT_COAP_MAX_RETRANSMIT and OT_COAP_MIN_ACK_TIMEOUT macros to the CoAP API.

March 2, 2020

• Updated the CoAP API:
  • otCoapOptionIterator and otCoapTxParameters structs added.
  • Added helper functions to encode CoAP block options.
  • Added functions to specify per-message transmission parameters for CoAP requests and responses.

January 9, 2020

• Histogram retry functions added to the Link API.

December 3, 2019

• Server and Service configuration functions and structs moved from the Server API to the General API to support service registration by Leaders.
• *RouterRoleEnabled functions renamed to *RouterEligible in the Router API to support REED enhancements.
• otPlatLogv function removed from the Logging Platform API.
• OT_TOOL_ALIGN macro removed from the Toolchain Platform API and from various struct definitions.

November 11, 2019

• otThreadResetIp6Counters function added to the General API.
• New functions for reseting counters and getting and setting maximum frame retries added to the Link API.

October 25, 2019

• otThreadGetVersion function added to the General API.
• otPlatRadioGetCcaEnergyDetectThreshold and otPlatRadioSetCcaEnergyDetectThreshold functions added to the Radio Configuration Platform API.

September 19, 2019

• Split the Random API page into Crypto and Non-Crypto to align with source code.
• otJoinerInfo struct and otCommissionerGetNextJoinerInfo function added to the Commissioner API.
• otRadioCoexMetrics struct and otPlatRadioIsCoexEnabled function added to the Radio Types API.
• Changed the return type of numerous APIs that always succeed from otError to void.

August 9, 2019

• otPlatSettingsDeinit function added to the Settings Platform API.
• otPlatUartFlush function added to the UART Platform API.
• mTimestamp moved from the otRadioIeInfo struct to the otRadioFrame struct.
• otNetifInterfaceId enumeration removed from the IPv6 API.

June 17, 2019

• Added callbacks for notifying of state changes and joiner activity to the Commissioner API.
• Compiler-specific function modifiers of OTAPI, OTCALL, OT_CALL, and OT_CDECL removed in conjunction with removal of Windows support.

May 28, 2019

• otNeighborTableEntryInfo struct added to the Router/Leader API.
• otDatasetCreateNewNetwork and otThreadGetRloc functions added to the General API.
• otUdpSendDatagram function added to the UDP API.
• Random API moved from a platform abstraction to a module, with improved cryptographic random number generation.
• Entropy and Entropy Platform APIs added.

May 14, 2019

• otPlatRadioGetPreferredChannelMask and otPlatRadioGetSupportedChannelMask functions added to the Radio Operation Platform API.
• Removed physical layer channel functions from the Link API.

March 14, 2019

• Added support for OQPSK modulation in the 915MHz band to the Radio Types Platform API and the Link API.
• Various CoAP Secure API refinements.
• New SLAAC module functions added to the IPv6 API.
• otSemanticallyOpaqueIidGeneratorData struct and related functions removed from the IPv6 API.

February 25, 2019

• otIp6SlaacIidCreate and otIp6SlaacUpdate functions removed from the IPv6 API.

January 30, 2019

• Various CLI API refinements.
• mDidTx removed from the otRadioFrame struct.

January 23, 2019

• UDP Receiver functions added to the UDP API.
• otCoapHeader struct removed from the CoAP API. CoAP header information has been refined into the CoAP message.
• The DHCPv6 Server API has been removed.

January 7, 2019

• otIp6NewMessageFromBuffer function added to the IPv6 API.
• otDhcpAddress struct removed from the DHCPv6 API.