[bbr] remove domain prefix support from stack and harness (openthread#13203)

This commit removes all Domain Prefix configuration and management logic
from the OpenThread stack, CLI commands, unit tests, and GRL harness
THCI wrapper.

- Removed public Backbone Router Domain Prefix APIs.
- Removed Domain Prefix flag ('mDp') and 'D' flag parser/formatter
  from core network data types, Spinel, and CLI.
- Cleaned up local Backbone Router and Leader logic to exclude Domain
  Prefix configuration, tracking, and events.
- Updated RoutingManager prefix advertisement (RIO) to exclude
  special handling for Domain Prefix.
- Updated CLI documentation to remove Domain Prefix references.
- Removed domain prefix helper methods from python test certification
  scripts.
- Removed auto-addition of default domain prefix and D flag support
  from GRL harness OpenThread.py.

Author: jwhui

include/openthread/backbone_router_ftd.h

@@ -43,7 +43,6 @@
 #include <openthread/error.h>
 #include <openthread/instance.h>
 #include <openthread/ip6.h>
-#include <openthread/netdata.h>
 
 #ifdef __cplusplus
 extern "C" {
@@ -175,17 +174,6 @@ uint8_t otBackboneRouterGetRegistrationJitter(otInstance *aInstance);
  */
 void otBackboneRouterSetRegistrationJitter(otInstance *aInstance, uint8_t aJitter);
 
-/**
- * Gets the local Domain Prefix configuration.
- *
- * @param[in]  aInstance A pointer to an OpenThread instance.
- * @param[out] aConfig   A pointer to the Domain Prefix configuration.
- *
- * @retval OT_ERROR_NONE       Successfully got the Domain Prefix configuration.
- * @retval OT_ERROR_NOT_FOUND  No Domain Prefix was configured.
- */
-otError otBackboneRouterGetDomainPrefix(otInstance *aInstance, otBorderRouterConfig *aConfig);
-
 /**
  * Configures the response status for the next Multicast Listener Registration.
  *
@@ -300,37 +288,6 @@ otError otBackboneRouterMulticastListenerGetNext(otInstance
                                                  otBackboneRouterMulticastListenerIterator *aIterator,
                                                  otBackboneRouterMulticastListenerInfo     *aListenerInfo);
 
-/**
- * Represents the Domain Prefix events.
- */
-typedef enum
-{
-    OT_BACKBONE_ROUTER_DOMAIN_PREFIX_ADDED   = 0, ///< Domain Prefix was added.
-    OT_BACKBONE_ROUTER_DOMAIN_PREFIX_REMOVED = 1, ///< Domain Prefix was removed.
-    OT_BACKBONE_ROUTER_DOMAIN_PREFIX_CHANGED = 2, ///< Domain Prefix was changed.
-} otBackboneRouterDomainPrefixEvent;
-
-/**
- * Pointer is called whenever the Domain Prefix changed.
- *
- * @param[in] aContext       The user context pointer.
- * @param[in] aEvent         The Domain Prefix event.
- * @param[in] aDomainPrefix  The new Domain Prefix if added or changed, NULL otherwise.
- */
-typedef void (*otBackboneRouterDomainPrefixCallback)(void                             *aContext,
-                                                     otBackboneRouterDomainPrefixEvent aEvent,
-                                                     const otIp6Prefix                *aDomainPrefix);
-/**
- * Sets the Backbone Router Domain Prefix callback.
- *
- * @param[in] aInstance  A pointer to an OpenThread instance.
- * @param[in] aCallback  A pointer to the Domain Prefix callback.
- * @param[in] aContext   A user context pointer.
- */
-void otBackboneRouterSetDomainPrefixCallback(otInstance                          *aInstance,
-                                             otBackboneRouterDomainPrefixCallback aCallback,
-                                             void                                *aContext);
-
 /**
  * @}
  */

include/openthread/border_routing.h

@@ -603,7 +603,6 @@ otError otBorderRoutingGetNextRouterEntry(otInstance                         *aI
  *
  * - It has added at least one external route entry.
  * - It has added at least one prefix entry with both the default-route and on-mesh flags set.
- * - It has added at least one domain prefix (with both the domain and on-mesh flags set).
  *
  * The list of peer BRs specifically excludes the current device, even if it is itself acting as a BR.
  *
@@ -629,7 +628,6 @@ otError otBorderRoutingGetNextPeerBrEntry(otInstance                           *
  *
  * - It has added at least one external route entry.
  * - It has added at least one prefix entry with both the default-route and on-mesh flags set.
- * - It has added at least one domain prefix (with both the domain and on-mesh flags set).
  *
  * The list of peer BRs specifically excludes the current device, even if it is itself acting as a BR.
  *

include/openthread/instance.h

@@ -52,7 +52,7 @@ extern "C" {
  *
  * @note This number versions both OpenThread platform and user APIs.
  */
-#define OPENTHREAD_API_VERSION (602)
+#define OPENTHREAD_API_VERSION (603)
 
 /**
  * @addtogroup api-instance

include/openthread/netdata.h

@@ -73,7 +73,7 @@ typedef struct otBorderRouterConfig
     bool        mOnMesh : 1;       ///< Whether this prefix is considered on-mesh.
     bool        mStable : 1;       ///< Whether this configuration is considered Stable Network Data.
     bool        mNdDns : 1;        ///< Whether this border router can supply DNS information via ND.
-    bool        mDp : 1;           ///< Whether prefix is a Thread Domain Prefix (added since Thread 1.2).
+    bool        mDp : 1;           ///< Reserved (previously Thread Domain Prefix flag).
     uint16_t    mRloc16;           ///< The border router's RLOC16 (value ignored on config add).
 } otBorderRouterConfig;
 

src/cli/README.md

@@ -3543,7 +3543,7 @@ Done
 
 ### prefix
 
-Get the prefix list in the local Network Data. Note: For the Thread 1.2 border router with backbone capability, the local Domain Prefix would be listed as well (with flag `D`), with preceding `-` if backbone functionality is disabled.
+Get the prefix list in the local Network Data.
 
 ```bash
 > prefix
@@ -3556,8 +3556,6 @@ Done
 
 Add a valid prefix to the Network Data.
 
-Note: The Domain Prefix flag (`D`) is only available for Thread 1.2.
-
 - p: Preferred flag
 - a: Stateless IPv6 Address Autoconfiguration flag
 - d: DHCPv6 IPv6 Address Configuration flag
@@ -3566,7 +3564,6 @@ Note: The Domain Prefix flag (`D`) is only available for Thread 1.2.
 - o: On Mesh flag
 - s: Stable flag
 - n: Nd Dns flag
-- D: Domain Prefix flag
 - prf: Default router preference, which may be 'high', 'med', or 'low'.
 
 ```bash

src/cli/README_BR.md

@@ -430,7 +430,6 @@ Peer BRs are other devices within the Thread mesh that provide external IP conne
 
 - It has added at least one external route entry.
 - It has added at least one prefix entry with both the default-route and on-mesh flags set.
-- It has added at least one domain prefix (with both the domain and on-mesh flags set).
 
 The list of peer BRs specifically excludes the current device, even if it is itself acting as a BR.
 

src/cli/README_HISTORY.md

@@ -466,7 +466,6 @@ The flags are as follows:
 - `o`: On Mesh flag
 - `s`: Stable flag
 - `n`: Nd Dns flag
-- `D`: Domain Prefix flag
 
 Print the history as a table.
 

src/cli/README_NETDATA.md

@@ -283,7 +283,6 @@ Publish an on-mesh prefix entry.
 - o: On Mesh flag
 - s: Stable flag
 - n: Nd Dns flag
-- D: Domain Prefix flag (only available for Thread 1.2).
 - prf: Preference, which may be 'high', 'med', or 'low'.
 
 ```bash
@@ -352,7 +351,6 @@ On-mesh prefixes are listed under `Prefixes` header:
   - o: On Mesh flag
   - s: Stable flag
   - n: Nd Dns flag
-  - D: Domain Prefix flag (only available for Thread 1.2).
 - Preference `high`, `med`, or `low`
 - RLOC16 of device which added the on-mesh prefix
 

src/cli/cli.cpp

@@ -5450,9 +5450,6 @@ template <> otError Interpreter::Process<Cmd("prefix")>(Arg aArgs[])
      * @endcode
      * @par
      * Get the prefix list in the local Network Data.
-     * @note For the Thread 1.2 border router with backbone capability, the local Domain Prefix
-     * is listed as well and includes the `D` flag. If backbone functionality is disabled, a dash
-     * `-` is printed before the local Domain Prefix.
      * @par
      * For more information about #otBorderRouterConfig flags, refer to @overview.
      * @sa otBorderRouterGetNextOnMeshPrefix
@@ -5466,15 +5463,6 @@ template <> otError Interpreter::Process<Cmd("prefix")>(Arg aArgs[])
         {
             mNetworkData.OutputPrefix(config);
         }
-
-#if OPENTHREAD_FTD && OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
-        if (otBackboneRouterGetState(GetInstancePtr()) == OT_BACKBONE_ROUTER_STATE_DISABLED)
-        {
-            SuccessOrExit(otBackboneRouterGetDomainPrefix(GetInstancePtr(), &config));
-            OutputFormat("- ");
-            mNetworkData.OutputPrefix(config);
-        }
-#endif
     }
     /**
      * @cli prefix add

src/cli/cli_br.cpp

@@ -670,7 +670,6 @@ template <> otError Br::Process<Cmd("peers")>(Arg aArgs[])
      * Data entries:
      * - It has added at least one external route entry.
      * - It has added at least one prefix entry with both the default-route and on-mesh flags set.
-     * - It has added at least one domain prefix (with both the domain and on-mesh flags set).
      * The list of peer BRs specifically excludes the current device, even if its is itself acting as a BR.
      * Info per BR entry:
      * - RLOC16 of the BR