Organize the format of zsda compress,<br />including the location of macros and the format of some code comments, etc.<br /> <br />Signed-off-by: Hanxiao Li <li.hanxiao@zte.com.cn> <br />---<br /> drivers/common/zsda/zsda_device.h     |  4 +--<br /> drivers/common/zsda/zsda_qp.h         | 48 +++++++++++++--------------<br /> drivers/common/zsda/zsda_qp_common.h  | 43 +++++++++++-------------<br /> drivers/compress/zsda/zsda_comp_pmd.c |  5 +--<br /> drivers/compress/zsda/zsda_comp_pmd.h | 11 ++++--<br /> 5 files changed, 56 insertions(+), 55 deletions(-)<br /> <br />diff --git a/drivers/common/zsda/zsda_device.h b/drivers/common/zsda/zsda_device.h<br />index dd0fa35ba6..245579359d 100644<br />--- a/drivers/common/zsda/zsda_device.h<br />+++ b/drivers/common/zsda/zsda_device.h<br />@@ -8,7 +8,7 @@<br /> #include "zsda_qp_common.h" <br /> #include "zsda_comp_pmd.h" <br />  <br />-#define MAX_QPS_ON_FUNCTION            128<br />+#define MAX_QPS_ON_FUNCTION        128<br /> #define ZSDA_DEV_NAME_MAX_LEN        64<br />  <br /> struct zsda_device_info {<br />@@ -39,8 +39,8 @@ struct zsda_qp_hw {<br />     struct zsda_qp_hw_data data[MAX_QPS_ON_FUNCTION];<br /> };<br />  <br />+/* Data used by all services */<br /> struct zsda_pci_device {<br />-    /* Data used by all services */<br />     char name[ZSDA_DEV_NAME_MAX_LEN];<br />     /**< Name of zsda pci device */<br />     uint8_t zsda_dev_id;<br />diff --git a/drivers/common/zsda/zsda_qp.h b/drivers/common/zsda/zsda_qp.h<br />index 486474ee70..4dbefe7bbd 100644<br />--- a/drivers/common/zsda/zsda_qp.h<br />+++ b/drivers/common/zsda/zsda_qp.h<br />@@ -9,43 +9,43 @@<br />  <br /> #include "zsda_device.h" <br />  <br />-#define ZSDA_ADMIN_Q_START        0x100<br />-#define ZSDA_ADMIN_Q_STOP        0x100<br />+#define ZSDA_ADMIN_Q_START    0x100<br />+#define ZSDA_ADMIN_Q_STOP    0x100<br /> #define ZSDA_ADMIN_Q_STOP_RESP    0x104<br />-#define ZSDA_ADMIN_Q_CLR        0x108<br />+#define ZSDA_ADMIN_Q_CLR    0x108<br /> #define ZSDA_ADMIN_Q_CLR_RESP    0x10C<br />  <br />-#define ZSDA_IO_Q_START            0x200<br />-#define ZSDA_IO_Q_STOP            0x200<br />-#define ZSDA_IO_Q_STOP_RESP        0x400<br />-#define ZSDA_IO_Q_CLR            0x600<br />-#define ZSDA_IO_Q_CLR_RESP        0x800<br />+#define ZSDA_IO_Q_START        0x200<br />+#define ZSDA_IO_Q_STOP        0x200<br />+#define ZSDA_IO_Q_STOP_RESP    0x400<br />+#define ZSDA_IO_Q_CLR        0x600<br />+#define ZSDA_IO_Q_CLR_RESP    0x800<br />  <br />-#define ZSDA_ADMIN_WQ            0x40<br />-#define ZSDA_ADMIN_WQ_BASE7        0x5C<br />-#define ZSDA_ADMIN_WQ_CRC        0x5C<br />+#define ZSDA_ADMIN_WQ        0x40<br />+#define ZSDA_ADMIN_WQ_BASE7    0x5C<br />+#define ZSDA_ADMIN_WQ_CRC    0x5C<br /> #define ZSDA_ADMIN_WQ_VERSION    0x5D<br />-#define ZSDA_ADMIN_WQ_FLAG        0x5E<br />-#define ZSDA_ADMIN_CQ            0x60<br />-#define ZSDA_ADMIN_CQ_BASE7        0x7C<br />-#define ZSDA_ADMIN_CQ_CRC        0x7C<br />+#define ZSDA_ADMIN_WQ_FLAG    0x5E<br />+#define ZSDA_ADMIN_CQ        0x60<br />+#define ZSDA_ADMIN_CQ_BASE7    0x7C<br />+#define ZSDA_ADMIN_CQ_CRC    0x7C<br /> #define ZSDA_ADMIN_CQ_VERSION    0x7D<br />-#define ZSDA_ADMIN_CQ_FLAG        0x7E<br />-#define ZSDA_ADMIN_WQ_TAIL        0x80<br />-#define ZSDA_ADMIN_CQ_HEAD        0x84<br />+#define ZSDA_ADMIN_CQ_FLAG    0x7E<br />+#define ZSDA_ADMIN_WQ_TAIL    0x80<br />+#define ZSDA_ADMIN_CQ_HEAD    0x84<br />  <br /> #define ZSDA_Q_START        0x1<br />-#define ZSDA_Q_STOP            0x0<br />+#define ZSDA_Q_STOP        0x0<br /> #define ZSDA_CLEAR_VALID    0x1<br /> #define ZSDA_CLEAR_INVALID    0x0<br /> #define ZSDA_RESP_VALID        0x1<br /> #define ZSDA_RESP_INVALID    0x0<br />  <br />-#define ADMIN_BUF_DATA_LEN        0x1C<br />-#define ADMIN_BUF_TOTAL_LEN        0x20<br />+#define ADMIN_BUF_DATA_LEN    0x1C<br />+#define ADMIN_BUF_TOTAL_LEN    0x20<br />  <br /> #define IO_DB_INITIAL_CONFIG    0x1C00<br />-#define SET_CYCLE            0xff<br />+#define SET_CYCLE        0xff<br /> #define SET_HEAD_INTI        0x0<br />  <br /> #define ZSDA_TIME_SLEEP_US    100<br />@@ -55,8 +55,8 @@<br /> #define WQ_CSR_UBASE    0x1004<br /> #define CQ_CSR_LBASE    0x1400<br /> #define CQ_CSR_UBASE    0x1404<br />-#define WQ_TAIL            0x1800<br />-#define CQ_HEAD            0x1804<br />+#define WQ_TAIL        0x1800<br />+#define CQ_HEAD        0x1804<br />  <br /> /* CSR write macro */<br /> #define ZSDA_CSR_WR(csrAddr, csrOffset, val)                                   \<br />diff --git a/drivers/common/zsda/zsda_qp_common.h b/drivers/common/zsda/zsda_qp_common.h<br />index 941278c6d2..ffa1959c78 100644<br />--- a/drivers/common/zsda/zsda_qp_common.h<br />+++ b/drivers/common/zsda/zsda_qp_common.h<br />@@ -16,10 +16,10 @@<br /> #include "bus_pci_driver.h" <br /> #include "zsda_logs.h" <br />  <br />-#define ZSDA_MAX_DEV                RTE_PMD_ZSDA_MAX_PCI_DEVICES<br />+#define ZSDA_MAX_DEV    RTE_PMD_ZSDA_MAX_PCI_DEVICES<br />  <br />-#define ZSDA_SUCCESS            0<br />-#define ZSDA_FAILED                (-1)<br />+#define ZSDA_SUCCESS    0<br />+#define ZSDA_FAILED    (-1)<br />  <br /> enum zsda_service_type {<br />     ZSDA_SERVICE_COMPRESSION = 0,<br />@@ -33,21 +33,16 @@ enum zsda_service_type {<br /> #define ZSDA_CSR_READ8(addr)          rte_read8((addr))<br /> #define ZSDA_CSR_WRITE8(addr, value)  rte_write8_relaxed((value), (addr))<br />  <br />-#define NB_DES                    512<br />-#define ZSDA_SGL_MAX_NUMBER        512<br />-#define COMP_REMOVE_SPACE_LEN 16<br />+#define NB_DES            512<br />+#define ZSDA_SGL_MAX_NUMBER    512<br />+#define COMP_REMOVE_SPACE_LEN    16<br />  <br /> #define ZSDA_MAX_DESC        512<br /> #define ZSDA_MAX_CYCLE        256<br /> #define ZSDA_MAX_DEV        RTE_PMD_ZSDA_MAX_PCI_DEVICES<br />-#define MAX_NUM_OPS            0x1FF<br />+#define MAX_NUM_OPS        0x1FF<br /> #define ZSDA_SGL_FRAGMENT_SIZE    32<br />-<br />-#define ZSDA_OPC_COMP_GZIP        0x10 /* Encomp deflate-Gzip */<br />-#define ZSDA_OPC_COMP_ZLIB        0x11 /* Encomp deflate-Zlib */<br />-#define ZSDA_OPC_DECOMP_GZIP    0x18 /* Decomp inflate-Gzip */<br />-#define ZSDA_OPC_DECOMP_ZLIB    0x19 /* Decomp inflate-Zlib */<br />-#define ZSDA_OPC_INVALID        0xff<br />+#define ZSDA_OPC_INVALID    0xFF<br />  <br /> #define CQE_VALID(value) (value & 0x8000)<br /> #define CQE_ERR0(value) (value & 0xFFFF)<br />@@ -96,10 +91,10 @@ struct __rte_packed_begin zsda_admin_resp_qcfg {<br /> struct zsda_queue {<br />     char memz_name[RTE_MEMZONE_NAMESIZE];<br />     uint8_t *io_addr;<br />-    uint8_t *base_addr;       /* Base address */<br />-    rte_iova_t base_phys_addr; /* Queue physical address */<br />-    uint16_t head;           /* Shadow copy of the head */<br />-    uint16_t tail;           /* Shadow copy of the tail */<br />+    uint8_t *base_addr;       /**< Base address */<br />+    rte_iova_t base_phys_addr; /**< Queue physical address */<br />+    uint16_t head;           /**< Shadow copy of the head */<br />+    uint16_t tail;           /**< Shadow copy of the tail */<br />     uint16_t modulo_mask;<br />     uint16_t msg_size;<br />     uint16_t queue_size;<br />@@ -107,27 +102,27 @@ struct zsda_queue {<br />     uint16_t pushed_wqe;<br />  <br />     uint8_t hw_queue_number;<br />-    uint32_t csr_head; /* last written head value */<br />-    uint32_t csr_tail; /* last written tail value */<br />+    uint32_t csr_head; /**< last written head value */<br />+    uint32_t csr_tail; /**< last written tail value */<br />  <br />     uint8_t valid;<br />     uint16_t sid;<br /> };<br />  <br /> struct zsda_qp_stat {<br />-    /**< Count of all operations enqueued */<br />     uint64_t enqueued_count;<br />-    /**< Count of all operations dequeued */<br />+    /**< Count of all operations enqueued */<br />     uint64_t dequeued_count;<br />+    /**< Count of all operations dequeued */<br />  <br />-    /**< Total error count on operations enqueued */<br />     uint64_t enqueue_err_count;<br />-    /**< Total error count on operations dequeued */<br />+    /**< Total error count on operations enqueued */<br />     uint64_t dequeue_err_count;<br />+    /**< Total error count on operations dequeued */<br /> };<br />  <br /> struct __rte_packed_begin zsda_cqe {<br />-    uint8_t valid; /* cqe_cycle */<br />+    uint8_t valid; /**< cqe_cycle */<br />     uint8_t op_code;<br />     uint16_t sid;<br />     uint8_t state;<br />diff --git a/drivers/compress/zsda/zsda_comp_pmd.c b/drivers/compress/zsda/zsda_comp_pmd.c<br />index e4d0600c0b..88dab9b3e5 100644<br />--- a/drivers/compress/zsda/zsda_comp_pmd.c<br />+++ b/drivers/compress/zsda/zsda_comp_pmd.c<br />@@ -282,7 +282,6 @@ zsda_comp_qp_setup(struct rte_compressdev *dev, uint16_t qp_id,<br /> }<br />  <br /> static struct rte_compressdev_ops compress_zsda_ops = {<br />-<br />     .dev_configure = zsda_comp_dev_config,<br />     .dev_start = zsda_comp_dev_start,<br />     .dev_stop = zsda_comp_dev_stop,<br />@@ -305,7 +304,9 @@ static struct rte_compressdev_ops compress_zsda_ops = {<br />  */<br /> static const char zsda_comp_drv_name[] = RTE_STR(COMPRESSDEV_NAME_ZSDA_PMD);<br /> static const struct rte_driver compdev_zsda_driver = {<br />-    .name = zsda_comp_drv_name, .alias = zsda_comp_drv_name};<br />+    .name = zsda_comp_drv_name,<br />+    .alias = zsda_comp_drv_name<br />+};<br />  <br /> static uint16_t<br /> zsda_comp_pmd_enqueue_op_burst(void *qp, struct rte_comp_op **ops,<br />diff --git a/drivers/compress/zsda/zsda_comp_pmd.h b/drivers/compress/zsda/zsda_comp_pmd.h<br />index 1e691d7cc6..92c44079ef 100644<br />--- a/drivers/compress/zsda/zsda_comp_pmd.h<br />+++ b/drivers/compress/zsda/zsda_comp_pmd.h<br />@@ -9,9 +9,14 @@<br />  <br /> #include "zsda_qp.h" <br />  <br />-/**< ZSDA Compression PMD driver name */<br />+/* ZSDA Compression PMD driver name */<br /> #define COMPRESSDEV_NAME_ZSDA_PMD compress_zsda<br />  <br />+#define ZSDA_OPC_COMP_GZIP    0x10 /**< Encomp deflate-Gzip */<br />+#define ZSDA_OPC_COMP_ZLIB    0x11 /**< Encomp deflate-Zlib */<br />+#define ZSDA_OPC_DECOMP_GZIP    0x18 /**< Decomp inflate-Gzip */<br />+#define ZSDA_OPC_DECOMP_ZLIB    0x19 /**< Decomp inflate-Zlib */<br />+<br /> /** private data structure for a ZSDA compression device.<br />  * This ZSDA device is a device offering only a compression service,<br />  * there can be one of these on each zsda_pci_device (VF).<br />@@ -22,11 +27,11 @@ struct zsda_comp_dev_private {<br />     struct rte_compressdev *compressdev;<br />     /**< The pointer to this compression device structure */<br />     const struct rte_compressdev_capabilities *zsda_dev_capabilities;<br />-    /* ZSDA device compression capabilities */<br />+    /**< ZSDA device compression capabilities */<br />     struct rte_mempool *xformpool;<br />     /**< The device's pool for zsda_comp_xforms */<br />     const struct rte_memzone *capa_mz;<br />-    /* Shared memzone for storing capabilities */<br />+    /**< Shared memzone for storing capabilities */<br /> };<br />  <br /> struct zsda_comp_xform {<br />--  <br />2.27.0<br />