SRP Client

This module includes configuration variables for the SRP Client.

Summary

Macros

OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE 1
Define to 1 to enable SRP Client auto-start feature and its APIs.
OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_DEFAULT_MODE 1
Define the default mode (enabled or disabled) of auto-start mode.
OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_ENABLE OPENTHREAD_CONFIG_SRP_CLIENT_ENABLE
Define to 1 to enable SRP Client buffers and service pool feature.
OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_HOST_NAME_SIZE 64
Specifies the size (number of chars) of host name string buffer in the SRP client buffers and service pool.
OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_MAX_HOST_ADDRESSES 2
Specifies number of host IPv6 address entries in the SRP client buffers and service pool.
OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_MAX_SERVICES 2
Specifies number of service entries in the SRP client service pool.
OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_SERVICE_INSTANCE_NAME_SIZE 64
Specifies the size (number of chars) of service instance name string buffer in the SRP client buffers and service pool.
OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_SERVICE_MAX_SUB_TYPES 6
Specifies the maximum number of service subtype labels (array length) in the SRP client buffers and service pool.
OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_SERVICE_NAME_SIZE 96
Specifies the size (number of chars) of service name string buffer in the SRP client buffers and service pool.
OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_TXT_BUFFER_SIZE 64
Specifies the size (number of bytes) of TXT record value buffer in the SRP client buffers and service pool.
OPENTHREAD_CONFIG_SRP_CLIENT_DEFAULT_KEY_LEASE (14 * 24 * 60 * 60)
Specifies the default requested key lease interval (in seconds).
OPENTHREAD_CONFIG_SRP_CLIENT_DEFAULT_LEASE (2 * 60 * 60)
Specifies the default requested lease interval (in seconds).
OPENTHREAD_CONFIG_SRP_CLIENT_DISALLOW_SERVER_SWITCH_WITH_REGISTERED_HOST 1
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.
OPENTHREAD_CONFIG_SRP_CLIENT_DOMAIN_NAME_API_ENABLE 0
Define to 1 for the SRP client implementation to provide APIs that get/set the domain name.
OPENTHREAD_CONFIG_SRP_CLIENT_EARLY_LEASE_RENEW_FACTOR_DENOMINATOR 2
Specifies the denominator of early lease renewal factor.
OPENTHREAD_CONFIG_SRP_CLIENT_EARLY_LEASE_RENEW_FACTOR_NUMERATOR 1
Specifies the numerator of early lease renewal factor.
OPENTHREAD_CONFIG_SRP_CLIENT_ENABLE 0
Define to 1 to enable SRP Client support.
OPENTHREAD_CONFIG_SRP_CLIENT_LEASE_RENEW_GUARD_INTERVAL 120
Specifies the guard interval (in seconds) for lease renew time.
OPENTHREAD_CONFIG_SRP_CLIENT_MAX_RETRY_WAIT_INTERVAL (1 * 60 * 60 * 1000)
Specifies the maximum wait interval (in msec) between SRP update message retries.
OPENTHREAD_CONFIG_SRP_CLIENT_MAX_TIMEOUT_FAILURES_TO_SWITCH_SERVER 3
Specifies number of timeout failures to trigger a switch of server.
OPENTHREAD_CONFIG_SRP_CLIENT_MIN_RETRY_WAIT_INTERVAL 1800
Specifies the minimum wait interval (in msec) between SRP update message retries.
OPENTHREAD_CONFIG_SRP_CLIENT_RETRY_INTERVAL_GROWTH_FACTOR_DENOMINATOR 10
Specifies the denominator of the retry wait interval growth factor fraction.
OPENTHREAD_CONFIG_SRP_CLIENT_RETRY_INTERVAL_GROWTH_FACTOR_NUMERATOR 17
Specifies the numerator of the retry wait interval growth factor fraction.
OPENTHREAD_CONFIG_SRP_CLIENT_RETRY_WAIT_INTERVAL_JITTER 500
Specifies jitter (in msec) for retry wait interval.
OPENTHREAD_CONFIG_SRP_CLIENT_SAVE_SELECTED_SERVER_ENABLE 1
Define to 1 to enable SRP client feature to save the selected server in non-volatile settings.
OPENTHREAD_CONFIG_SRP_CLIENT_SWITCH_SERVER_ON_FAILURE 1
Define to 1 to enable SRP client to switch server on failure (when auto-start feature is used).

Macros

OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE

 OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE 1

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).

OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_DEFAULT_MODE

 OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_DEFAULT_MODE 1

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.

OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_ENABLE

 OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_ENABLE OPENTHREAD_CONFIG_SRP_CLIENT_ENABLE

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

OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_HOST_NAME_SIZE

 OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_HOST_NAME_SIZE 64

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.

OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_MAX_HOST_ADDRESSES

 OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_MAX_HOST_ADDRESSES 2

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.

OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_MAX_SERVICES

 OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_MAX_SERVICES 2

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.

OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_SERVICE_INSTANCE_NAME_SIZE

 OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_SERVICE_INSTANCE_NAME_SIZE 64

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.

OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_SERVICE_MAX_SUB_TYPES

 OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_SERVICE_MAX_SUB_TYPES 6

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.

OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_SERVICE_NAME_SIZE

 OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_SERVICE_NAME_SIZE 96

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.

OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_TXT_BUFFER_SIZE

 OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_TXT_BUFFER_SIZE 64

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.

OPENTHREAD_CONFIG_SRP_CLIENT_DEFAULT_KEY_LEASE

 OPENTHREAD_CONFIG_SRP_CLIENT_DEFAULT_KEY_LEASE (14 * 24 * 60 * 60)

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

Set to 14 days.

OPENTHREAD_CONFIG_SRP_CLIENT_DEFAULT_LEASE

 OPENTHREAD_CONFIG_SRP_CLIENT_DEFAULT_LEASE (2 * 60 * 60)

Specifies the default requested lease interval (in seconds).

Set to two hours.

OPENTHREAD_CONFIG_SRP_CLIENT_DISALLOW_SERVER_SWITCH_WITH_REGISTERED_HOST

 OPENTHREAD_CONFIG_SRP_CLIENT_DISALLOW_SERVER_SWITCH_WITH_REGISTERED_HOST 1

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).

OPENTHREAD_CONFIG_SRP_CLIENT_DOMAIN_NAME_API_ENABLE

 OPENTHREAD_CONFIG_SRP_CLIENT_DOMAIN_NAME_API_ENABLE 0

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

OPENTHREAD_CONFIG_SRP_CLIENT_EARLY_LEASE_RENEW_FACTOR_DENOMINATOR

 OPENTHREAD_CONFIG_SRP_CLIENT_EARLY_LEASE_RENEW_FACTOR_DENOMINATOR 2

Specifies the denominator of early lease renewal factor.

Please see OPENTHREAD_CONFIG_SRP_CLIENT_EARLY_LEASE_RENEW_FACTOR_NUMERATOR for more details.

OPENTHREAD_CONFIG_SRP_CLIENT_EARLY_LEASE_RENEW_FACTOR_NUMERATOR

 OPENTHREAD_CONFIG_SRP_CLIENT_EARLY_LEASE_RENEW_FACTOR_NUMERATOR 1

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).

OPENTHREAD_CONFIG_SRP_CLIENT_ENABLE

 OPENTHREAD_CONFIG_SRP_CLIENT_ENABLE 0

Define to 1 to enable SRP Client support.

OPENTHREAD_CONFIG_SRP_CLIENT_LEASE_RENEW_GUARD_INTERVAL

 OPENTHREAD_CONFIG_SRP_CLIENT_LEASE_RENEW_GUARD_INTERVAL 120

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.

OPENTHREAD_CONFIG_SRP_CLIENT_MAX_RETRY_WAIT_INTERVAL

 OPENTHREAD_CONFIG_SRP_CLIENT_MAX_RETRY_WAIT_INTERVAL (1 * 60 * 60 * 1000)

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

OPENTHREAD_CONFIG_SRP_CLIENT_MAX_TIMEOUT_FAILURES_TO_SWITCH_SERVER

 OPENTHREAD_CONFIG_SRP_CLIENT_MAX_TIMEOUT_FAILURES_TO_SWITCH_SERVER 3

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.

OPENTHREAD_CONFIG_SRP_CLIENT_MIN_RETRY_WAIT_INTERVAL

 OPENTHREAD_CONFIG_SRP_CLIENT_MIN_RETRY_WAIT_INTERVAL 1800

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.

OPENTHREAD_CONFIG_SRP_CLIENT_RETRY_INTERVAL_GROWTH_FACTOR_DENOMINATOR

 OPENTHREAD_CONFIG_SRP_CLIENT_RETRY_INTERVAL_GROWTH_FACTOR_DENOMINATOR 10

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

OPENTHREAD_CONFIG_SRP_CLIENT_RETRY_INTERVAL_GROWTH_FACTOR_NUMERATOR

 OPENTHREAD_CONFIG_SRP_CLIENT_RETRY_INTERVAL_GROWTH_FACTOR_NUMERATOR 17

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).

OPENTHREAD_CONFIG_SRP_CLIENT_RETRY_WAIT_INTERVAL_JITTER

 OPENTHREAD_CONFIG_SRP_CLIENT_RETRY_WAIT_INTERVAL_JITTER 500

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).

OPENTHREAD_CONFIG_SRP_CLIENT_SAVE_SELECTED_SERVER_ENABLE

 OPENTHREAD_CONFIG_SRP_CLIENT_SAVE_SELECTED_SERVER_ENABLE 1

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.

OPENTHREAD_CONFIG_SRP_CLIENT_SWITCH_SERVER_ON_FAILURE

 OPENTHREAD_CONFIG_SRP_CLIENT_SWITCH_SERVER_ON_FAILURE 1

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).

Resources

OpenThread API Reference topics originate from the source code, available on GitHub. For more information, or to contribute to our documentation, refer to Resources.