nRF Connect SDK API 0.1.0
Loading...
Searching...
No Matches

◆ bt_mesh_lvl_cli_delta_set()

int bt_mesh_lvl_cli_delta_set ( struct bt_mesh_lvl_cli cli,
struct bt_mesh_msg_ctx *  ctx,
const struct bt_mesh_lvl_delta_set delta_set,
struct bt_mesh_lvl_status rsp 
)

#include <include/bluetooth/mesh/gen_lvl_cli.h>

Trigger a differential level state change in the server.

Makes the server move its level state by some delta value. If multiple delta_set messages are sent in a row (with less than 6 seconds interval), and delta_set::new_transaction is set to false, the server will continue using the same base value for its delta as in the first message, unless some other client made changes to the server.

This call is blocking if the rsp buffer is non-NULL. Otherwise, this function will return, and the response will be passed to the bt_mesh_lvl_cli::status_handler callback.

Parameters
[in]cliClient model to send on.
[in]ctxMessage context, or NULL to use the configured publish parameters.
[in]delta_setState change to make. Set set::transition to NULL to use the server's default transition parameters.
[out]rspResponse status buffer, or NULL to keep from blocking.
Return values
0Successfully sent the message and populated the rsp buffer.
-EALREADYA blocking request is already in progress.
-EADDRNOTAVAILA message context was not provided and publishing is not configured.
-EAGAINThe device has not been provisioned.
-ETIMEDOUTThe request timed out without a response.