smp.h

Go to the documentation of this file.

/*
 * Copyright Runtime.io 2018. All rights reserved.
 * Copyright (c) 2022-2023 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_MGMT_SMP_H_
#define ZEPHYR_INCLUDE_MGMT_SMP_H_
 
#include <zephyr/kernel.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
struct smp_transport;
struct zephyr_smp_transport;
struct net_buf;
 
typedef int (*smp_transport_out_fn)(struct net_buf *nb);
 
typedef uint16_t (*smp_transport_get_mtu_fn)(const struct net_buf *nb);
 
typedef int (*smp_transport_ud_copy_fn)(struct net_buf *dst,
 const struct net_buf *src);
 
typedef void (*smp_transport_ud_free_fn)(void *ud);
 
typedef bool (*smp_transport_query_valid_check_fn)(struct net_buf *nb, void *arg);
 
struct smp_transport_api_t {
 smp_transport_out_fn output;
 
 smp_transport_get_mtu_fn get_mtu;
 
 smp_transport_ud_copy_fn ud_copy;
 
 smp_transport_ud_free_fn ud_free;
 
 smp_transport_query_valid_check_fn query_valid_check;
};
 
struct smp_transport {
 /* Must be the first member. */
 struct k_work work;
 
 /* FIFO containing incoming requests to be processed. */
 struct k_fifo fifo;
 
 /* Function pointers */
 struct smp_transport_api_t functions;
 
#ifdef CONFIG_MCUMGR_TRANSPORT_REASSEMBLY
 /* Packet reassembly internal data, API access only */
 struct {
 struct net_buf *current; /* net_buf used for reassembly */
 uint16_t expected; /* expected bytes to come */
 } __reassembly;
#endif
};
 
enum smp_transport_type {
 SMP_SERIAL_TRANSPORT = 0,
 SMP_BLUETOOTH_TRANSPORT,
 SMP_SHELL_TRANSPORT,
 SMP_UDP_IPV4_TRANSPORT,
 SMP_UDP_IPV6_TRANSPORT,
 SMP_USER_DEFINED_TRANSPORT
};
 
struct smp_client_transport_entry {
 sys_snode_t node;
 struct smp_transport *smpt;
 int smpt_type;
};
 
int smp_transport_init(struct smp_transport *smpt);
 
void smp_rx_remove_invalid(struct smp_transport *zst, void *arg);
 
void smp_rx_clear(struct smp_transport *zst);
 
void smp_client_transport_register(struct smp_client_transport_entry *entry);
 
struct smp_transport *smp_client_transport_get(int smpt_type);
 
#ifdef __cplusplus
}
#endif
 
#endif