tt_grendel_i3c.h

Go to the documentation of this file.

/*
 * Copyright (c) 2026 Tenstorrent AI ULC
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_DRIVERS_MISC_TT_GRENDEL_I3C_H_
#define ZEPHYR_INCLUDE_DRIVERS_MISC_TT_GRENDEL_I3C_H_

 
#include <stdint.h>
 
#include <zephyr/device.h>
#include <zephyr/kernel.h>
#include <zephyr/toolchain.h>

#define TT_GRENDEL_I3C_CMD_PING 0x01U

#define TT_GRENDEL_I3C_CMD_D2D_INIT 0x02U

#define TT_GRENDEL_I3C_CMD_D2D_START 0x03U

enum tt_grendel_i3c_result {
        TT_GRENDEL_I3C_OK = 0,
        TT_GRENDEL_I3C_NOT_OK = 1,
};

struct tt_grendel_i3c_d2d_req {
        uint8_t instance;
} __packed;

#define TT_GRENDEL_I3C_CMD_PAYLOAD_MAX_LEN sizeof(struct tt_grendel_i3c_d2d_req)

struct tt_grendel_i3c_cmd_frame {
        uint8_t opcode;
        uint8_t payload[TT_GRENDEL_I3C_CMD_PAYLOAD_MAX_LEN];
} __packed;

struct tt_grendel_i3c_response {
        uint8_t result;
        uint8_t opcode;
        uint8_t reserved[2];
} __packed;
 
BUILD_ASSERT(sizeof(struct tt_grendel_i3c_response) == 4, "response frame must stay 4 bytes");

int tt_grendel_i3c_wait_ready(const struct device *dev, k_timeout_t timeout);

int tt_grendel_i3c_d2d_init(const struct device *dev, uint8_t instance, k_timeout_t timeout);

int tt_grendel_i3c_d2d_start(const struct device *dev, uint8_t instance, k_timeout_t timeout);
 
#endif /* ZEPHYR_INCLUDE_DRIVERS_MISC_TT_GRENDEL_I3C_H_ */