SRP Client

Define to 1 to enable SRP Client auto-start feature and its APIs.

When enabled, the SRP client can be configured to automatically start when it detects the presence of an SRP server (by monitoring the Thread Network Data for SRP Server Service entries).

Define the default mode (enabled or disabled) of auto-start mode.

This config is applicable only when OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE is enabled.

Define to 1 to enable SRP Client buffers and service pool feature.

Specifies the size (number of chars) of host name string buffer in the SRP client buffers and service pool.

This config is applicable only when OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_ENABLE is enabled.

Specifies number of host IPv6 address entries in the SRP client buffers and service pool.

This config is applicable only when OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_ENABLE is enabled.

Specifies number of service entries in the SRP client service pool.

This config is applicable only when OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_ENABLE is enabled.

Specifies the size (number of chars) of service instance name string buffer in the SRP client buffers and service pool.

This config is applicable only when OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_ENABLE is enabled.

Specifies the maximum number of service subtype labels (array length) in the SRP client buffers and service pool.

This config is applicable only when OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_ENABLE is enabled.

Specifies the size (number of chars) of service name string buffer in the SRP client buffers and service pool.

This config is applicable only when OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_ENABLE is enabled.

Specifies the size (number of bytes) of TXT record value buffer in the SRP client buffers and service pool.

This config is applicable only when OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_ENABLE is enabled.

Specifies the default requested key lease interval (in seconds).

Set to 14 days.

Specifies the default requested lease interval (in seconds).

Set to two hours.

Define to 1 to disallow SRP client to switch server (when auto-start is used) on failure if host (or any services) were previously successfully registered with the currently selected server.

This config is only applicable when OPENTHREAD_CONFIG_SRP_CLIENT_SWITCH_SERVER_ON_FAILURE is enabled.

If this is enabled, once SRP client successfully registers with an auto-start selected SRP server, it stays with the selected SRP server (even if future SRP updates fail or timeout) while the related server entry remains present in the Thread Network Data. If the entry is removed from Network Data, then SRP client will try to select a new server.

Enabling this behavior would be useful allowing more aggressive switch logic (e.g., switch after fewer timeouts OPENTHREAD_CONFIG_SRP_CLIENT_MAX_TIMEOUT_FAILURES_TO_SWITCH_SERVER) while not allowing switch due to temporary failures on the currently selected server. This can help avoid situation where the old server may still remember the registered host/service info and client switching to a new server then failing due to name conflict (when new server probes for the host/service name original server would not allow new registration).

Define to 1 for the SRP client implementation to provide APIs that get/set the domain name.

Specifies the denominator of early lease renewal factor.

Please see OPENTHREAD_CONFIG_SRP_CLIENT_EARLY_LEASE_RENEW_FACTOR_NUMERATOR for more details.

Specifies the numerator of early lease renewal factor.

This value is used for opportunistic early refresh behave. When sending an SRP update, the services that are not yet expired but are close, are allowed to refresh early and are included in the SRP update.

The "early lease renewal interval" is used to determine if a service can renew early. The interval is calculated by multiplying the accepted lease interval by the "early lease renewal factor" which is given as a fraction (numerator and denominator).

If the factor is set to zero (numerator=0, denominator=1), the opportunistic early refresh behavior is disabled. If denominator is set to zero (the factor is set to infinity), then all services (including previously registered ones) are always included in SRP update message.

Default value is 1/2 (i.e., services that are within half of the lease interval are allowed to refresh early).

Define to 1 to enable SRP Client support.

Specifies the guard interval (in seconds) for lease renew time.

The guard interval determines how much earlier (relative to the lease expiration time) the SRP client will send an SRP update for lease renewal.

Specifies the maximum wait interval (in msec) between SRP update message retries.

Specifies number of timeout failures to trigger a switch of server.

This is applicable only when OPENTHREAD_CONFIG_SRP_CLIENT_SWITCH_SERVER_ON_FAILURE is used.

Specifies the minimum wait interval (in msec) between SRP update message retries.

The update message is retransmitted if there is no response from server or if server rejects the update. The wait interval starts from the minimum value and is increased by the growth factor every failure up to the max value.

Specifies the denominator of the retry wait interval growth factor fraction.

Specifies the numerator of the retry wait interval growth factor fraction.

The growth factor is represented as a fraction (e.g., for 1.5, we can use 15 as the numerator and 10 as the denominator).

Specifies jitter (in msec) for retry wait interval.

If the current retry wait interval is smaller than the jitter then the wait interval itself is used as jitter (e.g., with jitter 500 msec and if retry interval is 300ms the retry interval is then randomly selected from [0, 2*300] ms).

Define to 1 to enable SRP client feature to save the selected server in non-volatile settings.

When enabled, the SRP client will save the selected server info by auto-start feature in the non-volatile settings and on a client restart (e.g., due to a device reset) it will select the same server when searching to discover and pick one from the Thread Network Data service entries. The server info is saved only after the host info is successfully registered with the server and if it is selected by auto-start from a network data SRP unicast service entry.

Define to 1 to enable SRP client to switch server on failure (when auto-start feature is used).

This config is only used when OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE is enabled.

When enabled, the client will try to select the next server from entries in Thread Network Data when the current server rejects an SRP update or there is no response (timeout waiting for response from server).