openthread: update OpenThread pre-build libraries

Update OpenThread pre-build libraries for NCS v1.7 release.

Signed-off-by: Lukasz Maciejonczyk <[email protected]>

Author: lmaciejonczyk

openthread/include/openthread/border_router.h

@@ -86,6 +86,37 @@ otError otBorderRoutingInit(otInstance *aInstance, uint32_t aInfraIfIndex, bool
  */
 otError otBorderRoutingSetEnabled(otInstance *aInstance, bool aEnabled);
 
+/**
+ * This method returns the off-mesh-routable (OMR) prefix.
+ *
+ * The randomly generated 64-bit prefix will be published
+ * in the Thread network if there isn't already an OMR prefix.
+ *
+ * @param[in]   aInstance  A pointer to an OpenThread instance.
+ * @param[out]  aPrefix    A pointer to where the prefix will be output to.
+ *
+ * @retval  OT_ERROR_INVALID_STATE  The Border Routing Manager is not initialized yet.
+ * @retval  OT_ERROR_NONE           Successfully retrieved the OMR prefix.
+ *
+ */
+otError otBorderRoutingGetOmrPrefix(otInstance *aInstance, otIp6Prefix *aPrefix);
+
+/**
+ * This method returns the on-link prefix for the adjacent infrastructure link.
+ *
+ * The randomly generated 64-bit prefix will be advertised
+ * on the infrastructure link if there isn't already a usable
+ * on-link prefix being advertised on the link.
+ *
+ * @param[in]   aInstance  A pointer to an OpenThread instance.
+ * @param[out]  aPrefix    A pointer to where the prefix will be output to.
+ *
+ * @retval  OT_ERROR_INVALID_STATE  The Border Routing Manager is not initialized yet.
+ * @retval  OT_ERROR_NONE           Successfully retrieved the on-link prefix.
+ *
+ */
+otError otBorderRoutingGetOnLinkPrefix(otInstance *aInstance, otIp6Prefix *aPrefix);
+
 /**
  * This method provides a full or stable copy of the local Thread Network Data.
  *

openthread/include/openthread/dataset.h

@@ -50,35 +50,37 @@ extern "C" {
  *
  */
 
-#define OT_MASTER_KEY_SIZE 16 ///< Size of the Thread Master Key (bytes)
+#define OT_NETWORK_KEY_SIZE 16 ///< Size of the Thread Network Key (bytes)
 
 /**
- * @struct otMasterKey
+ * @struct otNetworkKey
  *
- * This structure represents a Thread Master Key.
+ * This structure represents a Thread Network Key.
  *
  */
 OT_TOOL_PACKED_BEGIN
-struct otMasterKey
+struct otNetworkKey
 {
-    uint8_t m8[OT_MASTER_KEY_SIZE]; ///< Byte values
+    uint8_t m8[OT_NETWORK_KEY_SIZE]; ///< Byte values
 } OT_TOOL_PACKED_END;
 
 /**
- * This structure represents a Thread Master Key.
+ * This structure represents a Thread Network Key.
  *
  */
-typedef struct otMasterKey otMasterKey;
+typedef struct otNetworkKey otNetworkKey;
 
 #define OT_NETWORK_NAME_MAX_SIZE 16 ///< Maximum size of the Thread Network Name field (bytes)
 
 /**
  * This structure represents a Network Name.
  *
+ * The `otNetworkName` is a null terminated C string (i.e., `m8` char array MUST end with null char `\0`).
+ *
  */
 typedef struct otNetworkName
 {
-    char m8[OT_NETWORK_NAME_MAX_SIZE + 1]; ///< Byte values
+    char m8[OT_NETWORK_NAME_MAX_SIZE + 1]; ///< Byte values. The `+ 1` is for null char.
 } otNetworkName;
 
 #define OT_EXT_PAN_ID_SIZE 8 ///< Size of a Thread PAN ID (bytes)
@@ -133,14 +135,14 @@ typedef struct otSecurityPolicy
 {
     uint16_t mRotationTime; ///< The value for thrKeyRotation in units of hours.
 
-    bool    mObtainMasterKeyEnabled : 1;         ///< Obtaining the Master Key for out-of-band commissioning is enabled
+    bool    mObtainNetworkKeyEnabled : 1;        ///< Obtaining the Network Key for out-of-band commissioning is enabled
     bool    mNativeCommissioningEnabled : 1;     ///< Native Commissioning using PSKc is allowed
     bool    mRoutersEnabled : 1;                 ///< Thread 1.0/1.1.x Routers are enabled
     bool    mExternalCommissioningEnabled : 1;   ///< External Commissioner authentication is allowed
     bool    mBeaconsEnabled : 1;                 ///< Thread 1.0/1.1.x Beacons are enabled
     bool    mCommercialCommissioningEnabled : 1; ///< Commercial Commissioning is enabled
     bool    mAutonomousEnrollmentEnabled : 1;    ///< Autonomous Enrollment is enabled
-    bool    mMasterKeyProvisioningEnabled : 1;   ///< Network Master-key Provisioning is enabled
+    bool    mNetworkKeyProvisioningEnabled : 1;  ///< Network Key Provisioning is enabled
     bool    mTobleLinkEnabled : 1;               ///< ToBLE link is enabled
     bool    mNonCcmRoutersEnabled : 1;           ///< Non-CCM Routers enabled
     uint8_t mVersionThresholdForRouting : 3;     ///< Version-threshold for Routing
@@ -187,7 +189,7 @@ typedef struct otOperationalDatasetComponents
 {
     bool mIsActiveTimestampPresent : 1;  ///< TRUE if Active Timestamp is present, FALSE otherwise.
     bool mIsPendingTimestampPresent : 1; ///< TRUE if Pending Timestamp is present, FALSE otherwise.
-    bool mIsMasterKeyPresent : 1;        ///< TRUE if Network Master Key is present, FALSE otherwise.
+    bool mIsNetworkKeyPresent : 1;       ///< TRUE if Network Key is present, FALSE otherwise.
     bool mIsNetworkNamePresent : 1;      ///< TRUE if Network Name is present, FALSE otherwise.
     bool mIsExtendedPanIdPresent : 1;    ///< TRUE if Extended PAN ID is present, FALSE otherwise.
     bool mIsMeshLocalPrefixPresent : 1;  ///< TRUE if Mesh Local Prefix is present, FALSE otherwise.
@@ -209,7 +211,7 @@ typedef struct otOperationalDataset
 {
     uint64_t                       mActiveTimestamp;  ///< Active Timestamp
     uint64_t                       mPendingTimestamp; ///< Pending Timestamp
-    otMasterKey                    mMasterKey;        ///< Network Master Key
+    otNetworkKey                   mNetworkKey;       ///< Network Key
     otNetworkName                  mNetworkName;      ///< Network Name
     otExtendedPanId                mExtendedPanId;    ///< Extended PAN ID
     otMeshLocalPrefix              mMeshLocalPrefix;  ///< Mesh Local Prefix
@@ -251,7 +253,7 @@ typedef enum otMeshcopTlvType
     OT_MESHCOP_TLV_EXTPANID                 = 2,   ///< meshcop Extended Pan Id TLV
     OT_MESHCOP_TLV_NETWORKNAME              = 3,   ///< meshcop Network Name TLV
     OT_MESHCOP_TLV_PSKC                     = 4,   ///< meshcop PSKc TLV
-    OT_MESHCOP_TLV_MASTERKEY                = 5,   ///< meshcop Network Master Key TLV
+    OT_MESHCOP_TLV_NETWORKKEY               = 5,   ///< meshcop Network Key TLV
     OT_MESHCOP_TLV_NETWORK_KEY_SEQUENCE     = 6,   ///< meshcop Network Key Sequence TLV
     OT_MESHCOP_TLV_MESHLOCALPREFIX          = 7,   ///< meshcop Mesh Local Prefix TLV
     OT_MESHCOP_TLV_STEERING_DATA            = 8,   ///< meshcop Steering Data TLV
@@ -288,6 +290,21 @@ typedef enum otMeshcopTlvType
     OT_MESHCOP_TLV_JOINERADVERTISEMENT      = 241, ///< meshcop Joiner Advertisement TLV
 } otMeshcopTlvType;
 
+/**
+ * This function pointer is called when a response to a MGMT_SET request is received or times out.
+ *
+ * @param[in]  aResult   A result of the operation.
+ * @param[in]  aContext  A pointer to application-specific context.
+ *
+ * @retval  OT_ERROR_NONE              The request was accepted by the leader.
+ * @retval  OT_ERROR_REJECTED          The request was rejected by the leader.
+ * @retval  OT_ERROR_PARSE             An error occurred during parsing the response.
+ * @retval  OT_ERROR_ABORT             The request was reset by peer.
+ * @retval  OT_ERROR_RESPONSE_TIMEOUT  No response or acknowledgment received during timeout period.
+ *
+ */
+typedef void (*otDatasetMgmtSetCallback)(otError aResult, void *aContext);
+
 /**
  * This function indicates whether a valid network is present in the Active Operational Dataset or not.
  *
@@ -328,7 +345,7 @@ otError otDatasetGetActiveTlvs(otInstance *aInstance, otOperationalDatasetTlvs *
  * If the dataset does not include an Active Timestamp, the dataset is only partially complete.
  *
  * If Thread is enabled on a device that has a partially complete Active Dataset, the device will attempt to attach to
- * an existing Thread network using any existing information in the dataset. Only the Thread Master Key is needed to
+ * an existing Thread network using any existing information in the dataset. Only the Thread Network Key is needed to
  * attach to a network.
  *
  * If channel is not included in the dataset, the device will send MLE Announce messages across different channels to
@@ -354,7 +371,7 @@ otError otDatasetSetActive(otInstance *aInstance, const otOperationalDataset *aD
  * If the dataset does not include an Active Timestamp, the dataset is only partially complete.
  *
  * If Thread is enabled on a device that has a partially complete Active Dataset, the device will attempt to attach to
- * an existing Thread network using any existing information in the dataset. Only the Thread Master Key is needed to
+ * an existing Thread network using any existing information in the dataset. Only the Thread Network Key is needed to
  * attach to a network.
  *
  * If channel is not included in the dataset, the device will send MLE Announce messages across different channels to
@@ -450,15 +467,20 @@ otError otDatasetSendMgmtActiveGet(otInstance *                          aInstan
  * @param[in]  aDataset   A pointer to operational dataset.
  * @param[in]  aTlvs      A pointer to TLVs.
  * @param[in]  aLength    The length of TLVs.
+ * @param[in]  aCallback  A pointer to a function that is called on response reception or timeout.
+ * @param[in]  aContext   A pointer to application-specific context for @p aCallback.
  *
  * @retval OT_ERROR_NONE          Successfully send the meshcop dataset command.
  * @retval OT_ERROR_NO_BUFS       Insufficient buffer space to send.
+ * @retval OT_ERROR_BUSY          A previous request is ongoing.
  *
  */
 otError otDatasetSendMgmtActiveSet(otInstance *                aInstance,
                                    const otOperationalDataset *aDataset,
                                    const uint8_t *             aTlvs,
-                                   uint8_t                     aLength);
+                                   uint8_t                     aLength,
+                                   otDatasetMgmtSetCallback    aCallback,
+                                   void *                      aContext);
 
 /**
  * This function sends MGMT_PENDING_GET.
@@ -486,15 +508,20 @@ otError otDatasetSendMgmtPendingGet(otInstance *                          aInsta
  * @param[in]  aDataset   A pointer to operational dataset.
  * @param[in]  aTlvs      A pointer to TLVs.
  * @param[in]  aLength    The length of TLVs.
+ * @param[in]  aCallback  A pointer to a function that is called on response reception or timeout.
+ * @param[in]  aContext   A pointer to application-specific context for @p aCallback.
  *
  * @retval OT_ERROR_NONE          Successfully send the meshcop dataset command.
  * @retval OT_ERROR_NO_BUFS       Insufficient buffer space to send.
+ * @retval OT_ERROR_BUSY          A previous request is ongoing.
  *
  */
 otError otDatasetSendMgmtPendingSet(otInstance *                aInstance,
                                     const otOperationalDataset *aDataset,
                                     const uint8_t *             aTlvs,
-                                    uint8_t                     aLength);
+                                    uint8_t                     aLength,
+                                    otDatasetMgmtSetCallback    aCallback,
+                                    void *                      aContext);
 
 /**
  * This function generates PSKc from a given pass-phrase, network name, and extended PAN ID.
@@ -515,6 +542,33 @@ otError otDatasetGeneratePskc(const char *           aPassPhrase,
                               const otExtendedPanId *aExtPanId,
                               otPskc *               aPskc);
 
+/**
+ * This function sets an `otNetworkName` instance from a given null terminated C string.
+ *
+ * This function also validates that the given @p aNameString follows UTF-8 encoding and its length is not longer than
+ * `OT_NETWORK_NAME_MAX_SIZE`.
+ *
+ * @param[out] aNetworkName        A pointer to the `otNetworkName` to set.
+ * @param[in]  aNameString         A name C string.
+ *
+ * @retval OT_ERROR_NONE           Successfully set @p aNetworkName from @p aNameString.
+ * @retval OT_ERROR_INVALID_ARGS   @p aNameStrng is invalid (too long or does not follow UTF-8 encoding).
+ *
+ */
+otError otNetworkNameFromString(otNetworkName *aNetworkName, const char *aNameString);
+
+/**
+ * This function parses an Operational Dataset from a `otOperationalDatasetTlvs`.
+ *
+ * @param[in]  aDatasetTlvs  A pointer to dataset TLVs.
+ * @param[out] aDataset      A pointer to where the dataset will be placed.
+ *
+ * @retval OT_ERROR_NONE          Successfully set @p aDataset from @p aDatasetTlvs.
+ * @retval OT_ERROR_INVALID_ARGS  @p aDatasetTlvs is invalid.
+ *
+ */
+otError otDatasetParseTlvs(const otOperationalDatasetTlvs *aDatasetTlvs, otOperationalDataset *aDataset);
+
 /**
  * @}
  *

openthread/include/openthread/diag.h

@@ -54,6 +54,9 @@ extern "C" {
 /**
  * This function processes a factory diagnostics command line.
  *
+ * The output of this function (the content written to @p aOutput) MUST terminate with `\0` and the `\0` is within the
+ * output buffer.
+ *
  * @param[in]   aInstance       A pointer to an OpenThread instance.
  * @param[in]   aArgsLength     The number of elements in @p aArgs.
  * @param[in]   aArgs           An array of arguments.
@@ -74,6 +77,9 @@ otError otDiagProcessCmd(otInstance *aInstance,
 /**
  * This function processes a factory diagnostics command line.
  *
+ * The output of this function (the content written to @p aOutput) MUST terminate with `\0` and the `\0` is within the
+ * output buffer.
+ *
  * @param[in]   aInstance       A pointer to an OpenThread instance.
  * @param[in]   aString         A NULL-terminated input string.
  * @param[out]  aOutput         The diagnostics execution result.

openthread/include/openthread/dns_client.h

@@ -124,6 +124,12 @@ const otDnsQueryConfig *otDnsClientGetDefaultConfig(otInstance *aInstance);
  * (value zero). The unspecified fields are replaced by the corresponding OT config option definitions
  * `OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_{}` to form the default query config.
  *
+ * When `OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE` is enabled, the server's IPv6 address in
+ * the default config is automatically set and updated by DNS client. This is done only when user does not explicitly
+ * set or specify it. This behavior requires SRP client and its auto-start feature to be enabled. SRP client will then
+ * monitor the Thread Network Data for DNS/SRP Service entries to select an SRP server. The selected SRP server address
+ * is also set as the DNS server address in the default config.
+ *
  * @param[in]  aInstance   A pointer to an OpenThread instance.
  * @param[in]  aConfig     A pointer to the new query config to use as default.
  *

openthread/include/openthread/error.h

@@ -234,6 +234,11 @@ typedef enum OT_MUST_USE_RESULT otError
      */
     OT_ERROR_PENDING = 36,
 
+    /**
+     * Request rejected.
+     */
+    OT_ERROR_REJECTED = 37,
+
     /**
      * The number of defined errors.
      */