2019-06-28 03:13:18 +00:00
|
|
|
// Copyright 2017-2019 Espressif Systems (Shanghai) PTE LTD
|
2019-01-07 07:16:47 +00:00
|
|
|
//
|
|
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
// you may not use this file except in compliance with the License.
|
|
|
|
// You may obtain a copy of the License at
|
|
|
|
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
//
|
|
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
// See the License for the specific language governing permissions and
|
|
|
|
// limitations under the License.
|
|
|
|
|
2019-10-12 06:41:21 +00:00
|
|
|
#ifndef _CLIENT_COMMON_H_
|
|
|
|
#define _CLIENT_COMMON_H_
|
2019-01-07 07:16:47 +00:00
|
|
|
|
|
|
|
#include "mesh_access.h"
|
|
|
|
|
2019-09-02 04:06:20 +00:00
|
|
|
/** Client model opcode pair table */
|
2019-01-07 07:16:47 +00:00
|
|
|
typedef struct {
|
2019-09-02 04:06:20 +00:00
|
|
|
u32_t cli_op; /* Client message opcode */
|
|
|
|
u32_t status_op; /* Corresponding status message opcode */
|
2019-01-07 07:16:47 +00:00
|
|
|
} bt_mesh_client_op_pair_t;
|
|
|
|
|
2019-09-02 04:06:20 +00:00
|
|
|
/** Client model user data context */
|
2019-01-07 07:16:47 +00:00
|
|
|
typedef struct {
|
2019-09-02 04:06:20 +00:00
|
|
|
/** Pointer to the client model */
|
2019-01-07 07:16:47 +00:00
|
|
|
struct bt_mesh_model *model;
|
2019-09-02 04:06:20 +00:00
|
|
|
|
|
|
|
/** Size of the opcode pair table */
|
|
|
|
int op_pair_size;
|
|
|
|
|
|
|
|
/** Pointer to the opcode pair table */
|
2019-01-07 07:16:47 +00:00
|
|
|
const bt_mesh_client_op_pair_t *op_pair;
|
2019-09-02 04:06:20 +00:00
|
|
|
|
2019-01-07 07:16:47 +00:00
|
|
|
/**
|
|
|
|
* @brief This function is a callback function used to push the received unsolicited
|
|
|
|
* messages to the application layer.
|
|
|
|
*
|
|
|
|
* @param[in] opcode: Opcode of received status message
|
|
|
|
* @param[in] model: Model associated with the status message
|
|
|
|
* @param[in] ctx: Context information of the status message
|
|
|
|
* @param[in] buf: Buffer contains the status message value
|
|
|
|
*
|
|
|
|
* @return None
|
|
|
|
*/
|
|
|
|
void (*publish_status)(u32_t opcode, struct bt_mesh_model *model, struct bt_mesh_msg_ctx *ctx, struct net_buf_simple *buf);
|
|
|
|
|
2019-09-02 04:06:20 +00:00
|
|
|
/** Pointer to the internal data of client model */
|
|
|
|
void *internal_data;
|
|
|
|
|
|
|
|
/** Role of the device to which the client model belongs */
|
|
|
|
u8_t msg_role;
|
|
|
|
} bt_mesh_client_user_data_t;
|
|
|
|
|
|
|
|
/** Client model internal data context */
|
2019-01-07 07:16:47 +00:00
|
|
|
typedef struct {
|
|
|
|
sys_slist_t queue;
|
2019-09-02 04:06:20 +00:00
|
|
|
} bt_mesh_client_internal_data_t;
|
2019-01-07 07:16:47 +00:00
|
|
|
|
2019-09-02 04:06:20 +00:00
|
|
|
/** Client model sending message related context */
|
2019-01-07 07:16:47 +00:00
|
|
|
typedef struct {
|
|
|
|
sys_snode_t client_node;
|
2019-09-02 04:06:20 +00:00
|
|
|
struct bt_mesh_msg_ctx ctx; /* Message context */
|
|
|
|
u32_t opcode; /* Message opcode */
|
|
|
|
u32_t op_pending; /* Expected status message opcode */
|
|
|
|
struct k_delayed_work timer; /* Time used to get response. Only for internal use. */
|
2019-01-07 07:16:47 +00:00
|
|
|
} bt_mesh_client_node_t;
|
|
|
|
|
2019-09-02 04:06:20 +00:00
|
|
|
/** Client model sending message parameters */
|
|
|
|
typedef struct {
|
|
|
|
u32_t opcode; /* Message opcode */
|
|
|
|
struct bt_mesh_model *model; /* Pointer to the client model */
|
|
|
|
struct bt_mesh_msg_ctx ctx; /* Message context */
|
|
|
|
s32_t msg_timeout; /* Time to get corresponding response */
|
|
|
|
const struct bt_mesh_send_cb *cb; /* User defined callback function */
|
|
|
|
void *cb_data; /* User defined callback value */
|
|
|
|
} bt_mesh_client_common_param_t;
|
|
|
|
|
2019-09-16 07:05:14 +00:00
|
|
|
void bt_mesh_client_model_lock(void);
|
|
|
|
|
|
|
|
void bt_mesh_client_model_unlock(void);
|
|
|
|
|
2019-01-07 07:16:47 +00:00
|
|
|
int bt_mesh_client_init(struct bt_mesh_model *model);
|
|
|
|
|
|
|
|
/**
|
2019-09-02 04:06:20 +00:00
|
|
|
* @brief Check if the msg received by client model is a publish msg or not
|
2019-01-07 07:16:47 +00:00
|
|
|
*
|
|
|
|
* @param model Mesh (client) Model that the message belongs to.
|
|
|
|
* @param ctx Message context, includes keys, TTL, etc.
|
|
|
|
* @param buf The message buffer
|
|
|
|
* @param need_pub Indicate if the msg sent to app layer as a publish msg
|
|
|
|
* @return 0 on success, or (negative) error code on failure.
|
|
|
|
*/
|
2019-09-02 04:06:20 +00:00
|
|
|
bt_mesh_client_node_t *bt_mesh_is_client_recv_publish_msg(
|
2019-10-21 14:53:25 +00:00
|
|
|
struct bt_mesh_model *model,
|
|
|
|
struct bt_mesh_msg_ctx *ctx,
|
|
|
|
struct net_buf_simple *buf, bool need_pub);
|
2019-01-07 07:16:47 +00:00
|
|
|
|
|
|
|
int bt_mesh_client_send_msg(struct bt_mesh_model *model,
|
|
|
|
u32_t opcode,
|
|
|
|
struct bt_mesh_msg_ctx *ctx,
|
|
|
|
struct net_buf_simple *msg,
|
|
|
|
k_work_handler_t timer_handler,
|
|
|
|
s32_t timeout, bool need_ack,
|
|
|
|
const struct bt_mesh_send_cb *cb, void *cb_data);
|
|
|
|
|
2019-09-26 11:38:25 +00:00
|
|
|
int bt_mesh_client_free_node(bt_mesh_client_node_t *node);
|
2019-01-07 07:16:47 +00:00
|
|
|
|
2019-12-20 06:08:33 +00:00
|
|
|
int bt_mesh_client_clear_list(void *data);
|
|
|
|
|
2019-01-07 07:16:47 +00:00
|
|
|
enum {
|
|
|
|
NODE = 0,
|
|
|
|
PROVISIONER,
|
|
|
|
FAST_PROV,
|
|
|
|
};
|
|
|
|
|
2019-09-02 04:06:20 +00:00
|
|
|
#define ROLE_NVAL 0xFF
|
2019-01-07 07:16:47 +00:00
|
|
|
|
2019-09-02 04:06:20 +00:00
|
|
|
typedef struct {
|
2019-01-07 07:16:47 +00:00
|
|
|
struct bt_mesh_model *model; /* The client model structure */
|
|
|
|
u8_t role; /* Role of the device - Node/Provisioner */
|
|
|
|
} bt_mesh_role_param_t;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief This function copies node_index for stack internal use.
|
|
|
|
*
|
2019-09-02 04:06:20 +00:00
|
|
|
* @param[in] common: Pointer to the bt_mesh_role_param_t structure
|
2019-01-07 07:16:47 +00:00
|
|
|
*
|
|
|
|
* @return Zero - success, otherwise - fail
|
|
|
|
*/
|
2019-09-02 04:06:20 +00:00
|
|
|
int bt_mesh_set_client_model_role(bt_mesh_role_param_t *common);
|
2019-01-07 07:16:47 +00:00
|
|
|
|
2019-10-12 06:41:21 +00:00
|
|
|
#endif /* _CLIENT_COMMON_H_ */
|
2019-01-07 07:16:47 +00:00
|
|
|
|