rte_bbdev_op.h

Go to the documentation of this file.

/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright(c) 2017 Intel Corporation
 */

#ifndef _RTE_BBDEV_OP_H_
#define _RTE_BBDEV_OP_H_

#ifdef __cplusplus
extern "C" {
#endif

#include <stdint.h>

#include <rte_common.h>
#include <rte_mbuf.h>
#include <rte_memory.h>
#include <rte_mempool.h>

/* Number of columns in sub-block interleaver (36.212, section 5.1.4.1.1) */
#define RTE_BBDEV_C_SUBBLOCK (32)
/* Maximum size of Transport Block (36.213, Table, Table 7.1.7.2.5-1) */
#define RTE_BBDEV_MAX_TB_SIZE (391656)
/* Maximum size of Code Block (36.212, Table 5.1.3-3) */
#define RTE_BBDEV_MAX_CB_SIZE (6144)
/* Minimum size of Code Block (36.212, Table 5.1.3-3) */
#define RTE_BBDEV_MIN_CB_SIZE (40)
/* Maximum size of circular buffer */
#define RTE_BBDEV_MAX_KW (18528)
/*
 * Maximum number of Code Blocks in Transport Block. It is calculated based on
 * maximum size of one Code Block and one Transport Block (considering CRC24A
 * and CRC24B):
 * (391656 + 24) / (6144 - 24) = 64
 */
#define RTE_BBDEV_MAX_CODE_BLOCKS (64)

enum rte_bbdev_op_td_flag_bitmasks {
    RTE_BBDEV_TURBO_SUBBLOCK_DEINTERLEAVE = (1ULL << 0),
    RTE_BBDEV_TURBO_CRC_TYPE_24B = (1ULL << 1),
    RTE_BBDEV_TURBO_EQUALIZER = (1ULL << 2),
    RTE_BBDEV_TURBO_SOFT_OUT_SATURATE = (1ULL << 3),
    RTE_BBDEV_TURBO_HALF_ITERATION_EVEN = (1ULL << 4),
    RTE_BBDEV_TURBO_CONTINUE_CRC_MATCH = (1ULL << 5),
    RTE_BBDEV_TURBO_SOFT_OUTPUT = (1ULL << 6),
    RTE_BBDEV_TURBO_EARLY_TERMINATION = (1ULL << 7),
    RTE_BBDEV_TURBO_DEC_INTERRUPTS = (1ULL << 9),
    RTE_BBDEV_TURBO_POS_LLR_1_BIT_IN = (1ULL << 10),
    RTE_BBDEV_TURBO_NEG_LLR_1_BIT_IN = (1ULL << 11),
    RTE_BBDEV_TURBO_POS_LLR_1_BIT_SOFT_OUT = (1ULL << 12),
    RTE_BBDEV_TURBO_NEG_LLR_1_BIT_SOFT_OUT = (1ULL << 13),
    RTE_BBDEV_TURBO_MAP_DEC = (1ULL << 14),
    RTE_BBDEV_TURBO_DEC_SCATTER_GATHER = (1ULL << 15),
    RTE_BBDEV_TURBO_DEC_TB_CRC_24B_KEEP = (1ULL << 16)
};

enum rte_bbdev_op_te_flag_bitmasks {
    RTE_BBDEV_TURBO_RV_INDEX_BYPASS = (1ULL << 0),
    RTE_BBDEV_TURBO_RATE_MATCH = (1ULL << 1),
    RTE_BBDEV_TURBO_CRC_24B_ATTACH = (1ULL << 2),
    RTE_BBDEV_TURBO_CRC_24A_ATTACH = (1ULL << 3),
    RTE_BBDEV_TURBO_ENC_INTERRUPTS = (1ULL << 4),
    RTE_BBDEV_TURBO_ENC_SCATTER_GATHER = (1ULL << 5)
};

struct rte_bbdev_op_data {
    struct rte_mbuf *data;
    uint32_t offset;
    uint32_t length;
};

struct rte_bbdev_op_dec_cb_params {
    uint16_t k;
    uint32_t e;
};

struct rte_bbdev_op_dec_tb_params {
    uint16_t k_neg;
    uint16_t k_pos;
    uint8_t c_neg;
    uint8_t c;
    uint8_t cab;
    uint32_t ea;
    uint32_t eb;
    uint8_t r;
};

struct rte_bbdev_op_turbo_dec {
    struct rte_bbdev_op_data input;
    struct rte_bbdev_op_data hard_output;
    struct rte_bbdev_op_data soft_output;

    uint32_t op_flags;  
    uint8_t rv_index;  
    uint8_t iter_min:4;
    uint8_t iter_max:4;
    uint8_t iter_count;
    uint8_t ext_scale;
    uint8_t num_maps;

    uint8_t code_block_mode; 
    union {
        struct rte_bbdev_op_dec_cb_params cb_params;
        struct rte_bbdev_op_dec_tb_params tb_params;
    };
};

struct rte_bbdev_op_enc_cb_params {
    uint16_t k;
    uint32_t e;
    uint16_t ncb;
};

struct rte_bbdev_op_enc_tb_params {
    uint16_t k_neg;
    uint16_t k_pos;
    uint8_t c_neg;
    uint8_t c;
    uint8_t cab;
    uint32_t ea;
    uint32_t eb;
    uint16_t ncb_neg;
    uint16_t ncb_pos;
    uint8_t r;
};

struct rte_bbdev_op_turbo_enc {
    struct rte_bbdev_op_data input;
    struct rte_bbdev_op_data output;

    uint32_t op_flags;  
    uint8_t rv_index;  
    uint8_t code_block_mode; 
    union {
        struct rte_bbdev_op_enc_cb_params cb_params;
        struct rte_bbdev_op_enc_tb_params tb_params;
    };
};

struct rte_bbdev_op_cap_turbo_dec {
    uint32_t capability_flags;
    int8_t max_llr_modulus;
    uint8_t num_buffers_src;  
    uint8_t num_buffers_hard_out;
    uint8_t num_buffers_soft_out;
};

struct rte_bbdev_op_cap_turbo_enc {
    uint32_t capability_flags;
    uint8_t num_buffers_src;  
    uint8_t num_buffers_dst;  
};

enum rte_bbdev_op_type {
    RTE_BBDEV_OP_NONE,  
    RTE_BBDEV_OP_TURBO_DEC,  
    RTE_BBDEV_OP_TURBO_ENC,  
    RTE_BBDEV_OP_TYPE_COUNT,  
};

enum {
    RTE_BBDEV_DRV_ERROR,
    RTE_BBDEV_DATA_ERROR,
    RTE_BBDEV_CRC_ERROR,
};

struct rte_bbdev_enc_op {
    int status;  
    struct rte_mempool *mempool;  
    void *opaque_data;  
    struct rte_bbdev_op_turbo_enc turbo_enc;
};

struct rte_bbdev_dec_op {
    int status;  
    struct rte_mempool *mempool;  
    void *opaque_data;  
    struct rte_bbdev_op_turbo_dec turbo_dec;
};

struct rte_bbdev_op_cap {
    enum rte_bbdev_op_type type;  
    union {
        struct rte_bbdev_op_cap_turbo_dec turbo_dec;
        struct rte_bbdev_op_cap_turbo_enc turbo_enc;
    } cap;  
};

struct rte_bbdev_op_pool_private {
    enum rte_bbdev_op_type type;  
};

const char* __rte_experimental
rte_bbdev_op_type_str(enum rte_bbdev_op_type op_type);

struct rte_mempool * __rte_experimental
rte_bbdev_op_pool_create(const char *name, enum rte_bbdev_op_type type,
        unsigned int num_elements, unsigned int cache_size,
        int socket_id);

static inline int __rte_experimental
rte_bbdev_enc_op_alloc_bulk(struct rte_mempool *mempool,
        struct rte_bbdev_enc_op **ops, uint16_t num_ops)
{
    struct rte_bbdev_op_pool_private *priv;
    int ret;

    /* Check type */
    priv = (struct rte_bbdev_op_pool_private *)
            rte_mempool_get_priv(mempool);
    if (unlikely(priv->type != RTE_BBDEV_OP_TURBO_ENC))
        return -EINVAL;

    /* Get elements */
    ret = rte_mempool_get_bulk(mempool, (void **)ops, num_ops);
    if (unlikely(ret < 0))
        return ret;

    return 0;
}

static inline int __rte_experimental
rte_bbdev_dec_op_alloc_bulk(struct rte_mempool *mempool,
        struct rte_bbdev_dec_op **ops, uint16_t num_ops)
{
    struct rte_bbdev_op_pool_private *priv;
    int ret;

    /* Check type */
    priv = (struct rte_bbdev_op_pool_private *)
            rte_mempool_get_priv(mempool);
    if (unlikely(priv->type != RTE_BBDEV_OP_TURBO_DEC))
        return -EINVAL;

    /* Get elements */
    ret = rte_mempool_get_bulk(mempool, (void **)ops, num_ops);
    if (unlikely(ret < 0))
        return ret;

    return 0;
}

static inline void __rte_experimental
rte_bbdev_dec_op_free_bulk(struct rte_bbdev_dec_op **ops, unsigned int num_ops)
{
    if (num_ops > 0)
        rte_mempool_put_bulk(ops[0]->mempool, (void **)ops, num_ops);
}

static inline void __rte_experimental
rte_bbdev_enc_op_free_bulk(struct rte_bbdev_enc_op **ops, unsigned int num_ops)
{
    if (num_ops > 0)
        rte_mempool_put_bulk(ops[0]->mempool, (void **)ops, num_ops);
}

#ifdef __cplusplus
}
#endif

#endif /* _RTE_BBDEV_OP_H_ */