mctp_i3c_controller.h

Go to the documentation of this file.

/*
 * Copyright (c) 2025 Intel Corporation
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 */

 
#ifndef ZEPHYR_INCLUDE_PMCI_MCTP_MCTP_I3C_CONTROLLER_H_
#define ZEPHYR_INCLUDE_PMCI_MCTP_MCTP_I3C_CONTROLLER_H_
 
#include <stdint.h>
#include <zephyr/kernel.h>
#include <zephyr/device.h>
#include <zephyr/drivers/i3c.h>
#include <zephyr/pmci/mctp/mctp_i3c_common.h>
#include <libmctp.h>

struct mctp_binding_i3c_controller {
        struct mctp_binding binding;
        size_t num_endpoints;
        const struct device **devices;
        uint8_t *endpoint_ids;
        struct i3c_device_desc **endpoint_i3c_devs;
        enum mctp_i3c_endpoint_state *endpoint_states;
        size_t rx_buf_len;
        uint8_t *rx_buf;
        uint8_t tx_storage[MCTP_PKTBUF_SIZE(MCTP_I3C_MAX_PKT_SIZE)] PKTBUF_STORAGE_ALIGN;
#ifdef CONFIG_MCTP_I3C_CONTROLLER_POLLING_MODE
        struct k_work_delayable poll_work;
        k_timeout_t poll_interval;
#endif
};

int mctp_i3c_controller_start(struct mctp_binding *binding);
int mctp_i3c_controller_tx(struct mctp_binding *binding, struct mctp_pktbuf *pkt);
 
#define MCTP_I3C_ENDPOINT_IDS(_node_id, _name)                                  \
        static uint8_t _name##_endpoint_ids[DT_PROP_LEN(_node_id, endpoints)]   \
                = DT_PROP(_node_id, endpoint_ids)
 
#define MCTP_I3C_ENDPOINT_DEVICE(_idx, _node_id, ...)                           \
        DEVICE_DT_GET_BY_IDX(_node_id, endpoints, _idx)
 
#define MCTP_I3C_CONTROLLER_DEFINE_DEVICES(_node_id, _name)                     \
        const struct device *_name##_endpoints[] = {                            \
                LISTIFY(DT_PROP_LEN(_node_id, endpoints),                       \
                        MCTP_I3C_ENDPOINT_DEVICE, (,), _node_id)                \
        }


#define MCTP_I3C_CONTROLLER_DT_DEFINE(_name, _node_id)                                          \
        MCTP_I3C_CONTROLLER_DEFINE_DEVICES(_node_id, _name);                                    \
        MCTP_I3C_ENDPOINT_IDS(_node_id, _name);                                                 \
        static struct i3c_device_desc                                                           \
                *_name##_endpoint_i3c_devs[DT_PROP_LEN(_node_id, endpoints)];                   \
        static struct mctp_binding_i3c_controller _name = {                                     \
                .binding = {                                                                    \
                        .name = STRINGIFY(_name), .version = 1,                                 \
                        .start = mctp_i3c_controller_start,                                     \
                        .tx = mctp_i3c_controller_tx,                                           \
                        .pkt_size = MCTP_I3C_MAX_PKT_SIZE,                                      \
                        .tx_storage = _name.tx_storage,                                         \
                },                                                                              \
                .num_endpoints = DT_PROP_LEN(_node_id, endpoints),                              \
                .devices = _name##_endpoints,                                                   \
                .endpoint_ids = _name##_endpoint_ids,                                           \
                .endpoint_i3c_devs = _name##_endpoint_i3c_devs,                                 \
                COND_CODE_1(CONFIG_MCTP_I3C_CONTROLLER_POLLING_MODE,                            \
                        (.poll_interval =                                                       \
                                K_MSEC(CONFIG_MCTP_I3C_CONTROLLER_POLL_INTERVAL_MS)), ())       \
        };
 
#endif /* ZEPHYR_INCLUDE_PMCI_MCTP_MCTP_I3C_CONTROLLER_H_ */