mmagic_datalink_controller.h

/*
 * Copyright 2024 Morse Micro
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#pragma once
 
#include <stdbool.h>
#include <stdint.h>
#include <stddef.h>
 
#include "mmbuf.h"
 
#ifdef __cplusplus
extern "C"
{
#endif
 
#define MMAGIC_DATALINK_PAYLOAD_TYPE_SIZE (1)
#define MMAGIC_DATALINK_PAYLOAD_LEN_SIZE (2)
#define MMAGIC_DATALINK_PAYLOAD_HEADER_SIZE \
    (MMAGIC_DATALINK_PAYLOAD_TYPE_SIZE + MMAGIC_DATALINK_PAYLOAD_LEN_SIZE)
 
enum mmagic_datalink_payload_type
{
    MMAGIC_DATALINK_NACK,
    MMAGIC_DATALINK_ACK,
    MMAGIC_DATALINK_WRITE,
    MMAGIC_DATALINK_READ,
    MMAGIC_DATALINK_REREAD,
};
 
struct mmagic_datalink_controller;
 
typedef void (*mmagic_datalink_controller_rx_buffer_cb_t)(
    struct mmagic_datalink_controller *controller_dl,
    void *arg,
    struct mmbuf *buf);
 
struct mmagic_datalink_controller_init_args
{
    mmagic_datalink_controller_rx_buffer_cb_t rx_callback;
    void *rx_arg;
};
 
#define MMAGIC_DATALINK_CONTROLLER_ARGS_INIT { 0 }
 
struct mmagic_datalink_controller *mmagic_datalink_controller_init(
    const struct mmagic_datalink_controller_init_args *args);
 
void mmagic_datalink_controller_deinit(struct mmagic_datalink_controller *controller_dl);
 
struct mmbuf *mmagic_datalink_controller_alloc_buffer_for_tx(
    struct mmagic_datalink_controller *controller_dl,
    size_t header_size,
    size_t payload_size);
 
int mmagic_datalink_controller_tx_buffer(struct mmagic_datalink_controller *controller_dl,
                                         struct mmbuf *buf);
 
#ifdef __cplusplus
}
#endif