/* SPDX-License-Identifier: BSD-3-Clause
- * Copyright(c) 2019-2020 Broadcom
+ * Copyright(c) 2019-2021 Broadcom
* All rights reserved.
*/
#include "tf_core.h"
#include "tf_identifier.h"
-#include "tf_tbl_type.h"
+#include "tf_tbl.h"
#include "tf_tcam.h"
+#include "tf_if_tbl.h"
+#include "tf_global_cfg.h"
struct tf;
struct tf_session;
+/**
+ * Device module types
+ */
+enum tf_device_module_type {
+ /**
+ * Identifier module
+ */
+ TF_DEVICE_MODULE_TYPE_IDENTIFIER,
+ /**
+ * Table type module
+ */
+ TF_DEVICE_MODULE_TYPE_TABLE,
+ /**
+ * TCAM module
+ */
+ TF_DEVICE_MODULE_TYPE_TCAM,
+ /**
+ * EM module
+ */
+ TF_DEVICE_MODULE_TYPE_EM,
+ TF_DEVICE_MODULE_TYPE_MAX
+};
+
/**
* The Device module provides a general device template. A supported
* device type should implement one or more of the listed function
* - (-EINVAL) parameter failure.
* - (-ENODEV) no such device supported.
*/
-int dev_bind(struct tf *tfp,
- enum tf_device_type type,
- bool shadow_copy,
- struct tf_session_resources *resources,
- struct tf_dev_info *dev_handle);
+int tf_dev_bind(struct tf *tfp,
+ enum tf_device_type type,
+ bool shadow_copy,
+ struct tf_session_resources *resources,
+ struct tf_dev_info *dev_handle);
/**
* Device release handles cleanup of the device specific information.
* - (-EINVAL) parameter failure.
* - (-ENODEV) no such device supported.
*/
-int dev_unbind(struct tf *tfp,
- struct tf_dev_info *dev_handle);
+int tf_dev_unbind(struct tf *tfp,
+ struct tf_dev_info *dev_handle);
/**
* Truflow device specific function hooks structure
int (*tf_dev_free_ident)(struct tf *tfp,
struct tf_ident_free_parms *parms);
+ /**
+ * Search of an identifier element.
+ *
+ * This API search the specified identifier element from a
+ * device specific identifier shadow DB. The allocated element
+ * is returned.
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] parms
+ * Pointer to identifier search parameters
+ *
+ * Returns
+ * - (0) if successful.
+ * - (-EINVAL) on failure.
+ */
+ int (*tf_dev_search_ident)(struct tf *tfp,
+ struct tf_ident_search_parms *parms);
+
/**
* Allocation of a table type element.
*
int (*tf_dev_alloc_tbl)(struct tf *tfp,
struct tf_tbl_alloc_parms *parms);
+ /**
+ * Allocation of a external table type element.
+ *
+ * This API allocates the specified table type element from a
+ * device specific table type DB. The allocated element is
+ * returned.
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] parms
+ * Pointer to table allocation parameters
+ *
+ * Returns
+ * - (0) if successful.
+ * - (-EINVAL) on failure.
+ */
+ int (*tf_dev_alloc_ext_tbl)(struct tf *tfp,
+ struct tf_tbl_alloc_parms *parms);
+
/**
* Free of a table type element.
*
int (*tf_dev_free_tbl)(struct tf *tfp,
struct tf_tbl_free_parms *parms);
+ /**
+ * Free of a external table type element.
+ *
+ * This API free's a previous allocated table type element from a
+ * device specific table type DB.
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] parms
+ * Pointer to table free parameters
+ *
+ * Returns
+ * - (0) if successful.
+ * - (-EINVAL) on failure.
+ */
+ int (*tf_dev_free_ext_tbl)(struct tf *tfp,
+ struct tf_tbl_free_parms *parms);
+
/**
* Searches for the specified table type element in a shadow DB.
*
int (*tf_dev_set_tbl)(struct tf *tfp,
struct tf_tbl_set_parms *parms);
+ /**
+ * Sets the specified external table type element.
+ *
+ * This API sets the specified element data by invoking the
+ * firmware.
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] parms
+ * Pointer to table set parameters
+ *
+ * Returns
+ * - (0) if successful.
+ * - (-EINVAL) on failure.
+ */
+ int (*tf_dev_set_ext_tbl)(struct tf *tfp,
+ struct tf_tbl_set_parms *parms);
+
/**
* Retrieves the specified table type element.
*
* - (-EINVAL) on failure.
*/
int (*tf_dev_get_tbl)(struct tf *tfp,
- struct tf_tbl_get_parms *parms);
+ struct tf_tbl_get_parms *parms);
+
+ /**
+ * Retrieves the specified table type element using 'bulk'
+ * mechanism.
+ *
+ * This API retrieves the specified element data by invoking the
+ * firmware.
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] parms
+ * Pointer to table get bulk parameters
+ *
+ * Returns
+ * - (0) if successful.
+ * - (-EINVAL) on failure.
+ */
+ int (*tf_dev_get_bulk_tbl)(struct tf *tfp,
+ struct tf_tbl_get_bulk_parms *parms);
/**
* Allocation of a tcam element.
* 0 - Success
* -EINVAL - Error
*/
- int (*tf_dev_insert_em_entry)(struct tf *tfp,
- struct tf_insert_em_entry_parms *parms);
+ int (*tf_dev_insert_int_em_entry)(struct tf *tfp,
+ struct tf_insert_em_entry_parms *parms);
/**
* Delete EM hash entry API
* 0 - Success
* -EINVAL - Error
*/
- int (*tf_dev_delete_em_entry)(struct tf *tfp,
- struct tf_delete_em_entry_parms *parms);
+ int (*tf_dev_delete_int_em_entry)(struct tf *tfp,
+ struct tf_delete_em_entry_parms *parms);
+
+ /**
+ * Insert EEM hash entry API
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] parms
+ * Pointer to E/EM insert parameters
+ *
+ * Returns:
+ * 0 - Success
+ * -EINVAL - Error
+ */
+ int (*tf_dev_insert_ext_em_entry)(struct tf *tfp,
+ struct tf_insert_em_entry_parms *parms);
+
+ /**
+ * Delete EEM hash entry API
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] parms
+ * Pointer to E/EM delete parameters
+ *
+ * returns:
+ * 0 - Success
+ * -EINVAL - Error
+ */
+ int (*tf_dev_delete_ext_em_entry)(struct tf *tfp,
+ struct tf_delete_em_entry_parms *parms);
+
+ /**
+ * Allocate EEM table scope
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] parms
+ * Pointer to table scope alloc parameters
+ *
+ * returns:
+ * 0 - Success
+ * -EINVAL - Error
+ */
+ int (*tf_dev_alloc_tbl_scope)(struct tf *tfp,
+ struct tf_alloc_tbl_scope_parms *parms);
+ /**
+ * Map EEM parif
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] pf
+ * PF associated with the table scope
+ *
+ * [in] parif_bitmask
+ * Bitmask of PARIFs to enable
+ *
+ * [in/out] pointer to the parif_2_pf data to be updated
+ *
+ * [in/out] pointer to the parif_2_pf mask to be updated
+ *
+ * [in] sz_in_bytes - number of bytes to be written
+ *
+ * returns:
+ * 0 - Success
+ * -EINVAL - Error
+ */
+ int (*tf_dev_map_parif)(struct tf *tfp,
+ uint16_t parif_bitmask,
+ uint16_t pf,
+ uint8_t *data,
+ uint8_t *mask,
+ uint16_t sz_in_bytes);
+ /**
+ * Map EEM table scope
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] parms
+ * Pointer to table scope map parameters
+ *
+ * returns:
+ * 0 - Success
+ * -EINVAL - Error
+ */
+ int (*tf_dev_map_tbl_scope)(struct tf *tfp,
+ struct tf_map_tbl_scope_parms *parms);
+
+ /**
+ * Free EEM table scope
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] parms
+ * Pointer to table scope free parameters
+ *
+ * returns:
+ * 0 - Success
+ * -EINVAL - Error
+ */
+ int (*tf_dev_free_tbl_scope)(struct tf *tfp,
+ struct tf_free_tbl_scope_parms *parms);
+
+ /**
+ * Sets the specified interface table type element.
+ *
+ * This API sets the specified element data by invoking the
+ * firmware.
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] parms
+ * Pointer to interface table set parameters
+ *
+ * Returns
+ * - (0) if successful.
+ * - (-EINVAL) on failure.
+ */
+ int (*tf_dev_set_if_tbl)(struct tf *tfp,
+ struct tf_if_tbl_set_parms *parms);
+
+ /**
+ * Retrieves the specified interface table type element.
+ *
+ * This API retrieves the specified element data by invoking the
+ * firmware.
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] parms
+ * Pointer to table get parameters
+ *
+ * Returns
+ * - (0) if successful.
+ * - (-EINVAL) on failure.
+ */
+ int (*tf_dev_get_if_tbl)(struct tf *tfp,
+ struct tf_if_tbl_get_parms *parms);
+
+ /**
+ * Update global cfg
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] parms
+ * Pointer to global cfg parameters
+ *
+ * returns:
+ * 0 - Success
+ * -EINVAL - Error
+ */
+ int (*tf_dev_set_global_cfg)(struct tf *tfp,
+ struct tf_global_cfg_parms *parms);
+
+ /**
+ * Get global cfg
+ *
+ * [in] tfp
+ * Pointer to TF handle
+ *
+ * [in] parms
+ * Pointer to global cfg parameters
+ *
+ * returns:
+ * 0 - Success
+ * -EINVAL - Error
+ */
+ int (*tf_dev_get_global_cfg)(struct tf *tfp,
+ struct tf_global_cfg_parms *parms);
};
/**