Zephyr Project API  3.3.0
A Scalable Open Source RTOS
msg.h
Go to the documentation of this file.
1
5/*
6 * Copyright (c) 2021 Nordic Semiconductor ASA
7 *
8 * SPDX-License-Identifier: Apache-2.0
9 */
10#ifndef ZEPHYR_INCLUDE_BLUETOOTH_MESH_MSG_H_
11#define ZEPHYR_INCLUDE_BLUETOOTH_MESH_MSG_H_
12
20#include <zephyr/kernel.h>
21#include <zephyr/net/buf.h>
22
23#ifdef __cplusplus
24extern "C" {
25#endif
26
27struct bt_mesh_model;
28
30#define BT_MESH_MIC_SHORT 4
32#define BT_MESH_MIC_LONG 8
33
39#define BT_MESH_MODEL_OP_LEN(_op) ((_op) <= 0xff ? 1 : (_op) <= 0xffff ? 2 : 3)
40
50#define BT_MESH_MODEL_BUF_LEN(_op, _payload_len) \
51 (BT_MESH_MODEL_OP_LEN(_op) + (_payload_len) + BT_MESH_MIC_SHORT)
52
62#define BT_MESH_MODEL_BUF_LEN_LONG_MIC(_op, _payload_len) \
63 (BT_MESH_MODEL_OP_LEN(_op) + (_payload_len) + BT_MESH_MIC_LONG)
64
72#define BT_MESH_MODEL_BUF_DEFINE(_buf, _op, _payload_len) \
73 NET_BUF_SIMPLE_DEFINE(_buf, BT_MESH_MODEL_BUF_LEN(_op, (_payload_len)))
74
79
82
85
88
91
94
97
100};
101
111#define BT_MESH_MSG_CTX_INIT(net_key_idx, app_key_idx, dst, ttl) \
112 { \
113 .net_idx = (net_key_idx), \
114 .app_idx = (app_key_idx), \
115 .addr = (dst), \
116 .send_ttl = (ttl), \
117 }
118
125#define BT_MESH_MSG_CTX_INIT_APP(app_key_idx, dst) \
126 BT_MESH_MSG_CTX_INIT(0, app_key_idx, dst, BT_MESH_TTL_DEFAULT)
127
135#define BT_MESH_MSG_CTX_INIT_DEV(net_key_idx, dst) \
136 BT_MESH_MSG_CTX_INIT(net_key_idx, BT_MESH_KEY_DEV_REMOTE, dst, BT_MESH_TTL_DEFAULT)
137
143#define BT_MESH_MSG_CTX_INIT_PUB(pub) \
144 BT_MESH_MSG_CTX_INIT(0, (pub)->key, (pub)->addr, (pub)->ttl)
145
155
160 struct k_sem sem;
163 void *user_data;
164};
165
173static inline void bt_mesh_msg_ack_ctx_init(struct bt_mesh_msg_ack_ctx *ack)
174{
175 k_sem_init(&ack->sem, 0, 1);
176}
177
184static inline void bt_mesh_msg_ack_ctx_reset(struct bt_mesh_msg_ack_ctx *ack)
185{
186 k_sem_reset(&ack->sem);
187}
188
197
211 uint32_t op, uint16_t dst, void *user_data);
212
220static inline bool bt_mesh_msg_ack_ctx_busy(struct bt_mesh_msg_ack_ctx *ack)
221{
222 return (ack->op != 0);
223}
224
235
242static inline void bt_mesh_msg_ack_ctx_rx(struct bt_mesh_msg_ack_ctx *ack)
243{
244 k_sem_give(&ack->sem);
245}
246
258 uint32_t op, uint16_t addr, void **user_data);
259
260#ifdef __cplusplus
261}
262#endif
263
268#endif /* ZEPHYR_INCLUDE_BLUETOOTH_MESH_MSG_H_ */
ZTEST_BMEM int timeout
Definition: main.c:31
int bt_mesh_msg_ack_ctx_prepare(struct bt_mesh_msg_ack_ctx *ack, uint32_t op, uint16_t dst, void *user_data)
Prepare an acknowledged message context for the incoming message to wait.
static void bt_mesh_msg_ack_ctx_rx(struct bt_mesh_msg_ack_ctx *ack)
Mark a message as acknowledged.
Definition: msg.h:242
void bt_mesh_msg_ack_ctx_clear(struct bt_mesh_msg_ack_ctx *ack)
Clear parameters of an acknowledged message context.
int bt_mesh_msg_ack_ctx_wait(struct bt_mesh_msg_ack_ctx *ack, k_timeout_t timeout)
Wait for a message acknowledge.
static void bt_mesh_msg_ack_ctx_reset(struct bt_mesh_msg_ack_ctx *ack)
Reset the synchronization semaphore in an acknowledged message context.
Definition: msg.h:184
static bool bt_mesh_msg_ack_ctx_busy(struct bt_mesh_msg_ack_ctx *ack)
Check if the acknowledged message context is initialized with an opcode.
Definition: msg.h:220
void bt_mesh_model_msg_init(struct net_buf_simple *msg, uint32_t opcode)
Initialize a model message.
static void bt_mesh_msg_ack_ctx_init(struct bt_mesh_msg_ack_ctx *ack)
Initialize an acknowledged message context.
Definition: msg.h:173
bool bt_mesh_msg_ack_ctx_match(const struct bt_mesh_msg_ack_ctx *ack, uint32_t op, uint16_t addr, void **user_data)
Check if an opcode and address of a message matches the expected one.
void k_sem_reset(struct k_sem *sem)
Resets a semaphore's count to zero.
void k_sem_give(struct k_sem *sem)
Give a semaphore.
int k_sem_init(struct k_sem *sem, unsigned int initial_count, unsigned int limit)
Initialize a semaphore.
Public kernel APIs.
Buffer management.
__UINT32_TYPE__ uint32_t
Definition: stdint.h:90
__UINT8_TYPE__ uint8_t
Definition: stdint.h:88
__UINT16_TYPE__ uint16_t
Definition: stdint.h:89
__INT8_TYPE__ int8_t
Definition: stdint.h:72
Definition: access.h:560
Definition: msg.h:159
uint32_t op
Definition: msg.h:161
void * user_data
Definition: msg.h:163
struct k_sem sem
Definition: msg.h:160
uint16_t dst
Definition: msg.h:162
Definition: msg.h:76
uint16_t net_idx
Definition: msg.h:78
int8_t recv_rssi
Definition: msg.h:90
bool send_rel
Definition: msg.h:96
uint16_t addr
Definition: msg.h:84
uint8_t send_ttl
Definition: msg.h:99
uint16_t app_idx
Definition: msg.h:81
uint16_t recv_dst
Definition: msg.h:87
uint8_t recv_ttl
Definition: msg.h:93
Kernel timeout type.
Definition: sys_clock.h:65
Simple network buffer representation.
Definition: buf.h:82
static void msg(uint64_t c64)
Definition: main.c:17
static const intptr_t user_data[5]
Definition: main.c:588