Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/80193/?format=api
{ "id": 80193, "url": "http://patches.dpdk.org/api/patches/80193/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/931cbea6d091f16a51ad7eed736b4b6e69df93aa.1602258833.git.anatoly.burakov@intel.com/", "project": { "id": 1, "url": "http://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<931cbea6d091f16a51ad7eed736b4b6e69df93aa.1602258833.git.anatoly.burakov@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/931cbea6d091f16a51ad7eed736b4b6e69df93aa.1602258833.git.anatoly.burakov@intel.com", "date": "2020-10-09T16:02:21", "name": "[v5,04/10] ethdev: add simple power management API", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "0ed1a2411bb319525606326e034c30b6fe92d7f9", "submitter": { "id": 4, "url": "http://patches.dpdk.org/api/people/4/?format=api", "name": "Burakov, Anatoly", "email": "anatoly.burakov@intel.com" }, "delegate": { "id": 1, "url": "http://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/931cbea6d091f16a51ad7eed736b4b6e69df93aa.1602258833.git.anatoly.burakov@intel.com/mbox/", "series": [ { "id": 12833, "url": "http://patches.dpdk.org/api/series/12833/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=12833", "date": "2020-10-09T16:02:18", "name": "[v5,01/10] eal: add new x86 cpuid support for WAITPKG", "version": 5, "mbox": "http://patches.dpdk.org/series/12833/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/80193/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/80193/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 9F191A04BC;\n\tFri, 9 Oct 2020 18:03:49 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id E6ED71D728;\n\tFri, 9 Oct 2020 18:02:44 +0200 (CEST)", "from mga05.intel.com (mga05.intel.com [192.55.52.43])\n by dpdk.org (Postfix) with ESMTP id C2A251D727\n for <dev@dpdk.org>; Fri, 9 Oct 2020 18:02:42 +0200 (CEST)", "from orsmga005.jf.intel.com ([10.7.209.41])\n by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 09 Oct 2020 09:02:41 -0700", "from silpixa00399498.ir.intel.com (HELO\n silpixa00399498.ger.corp.intel.com) ([10.237.222.52])\n by orsmga005.jf.intel.com with ESMTP; 09 Oct 2020 09:02:37 -0700" ], "IronPort-SDR": [ "\n bFY2FOpLpxOvM8dvfVKi51y/jD8dd4t7PpQmDnPLUTuunNNuaCJ8v/vWiDYprnY4fGxjE+lpvF\n 1PhqlNYFNepg==", "\n EeTgId3zgrL9dGZoFlysz7wz82FcGJKwj/Llp3fWhVHqsHeCkv2SSm6SMkHzqfnc9hNtYsgxoT\n 74RY/Axt/HVQ==" ], "X-IronPort-AV": [ "E=McAfee;i=\"6000,8403,9769\"; a=\"250197349\"", "E=Sophos;i=\"5.77,355,1596524400\"; d=\"scan'208\";a=\"250197349\"", "E=Sophos;i=\"5.77,355,1596524400\"; d=\"scan'208\";a=\"528981877\"" ], "X-Amp-Result": "SKIPPED(no attachment in message)", "X-Amp-File-Uploaded": "False", "X-ExtLoop1": "1", "From": "Anatoly Burakov <anatoly.burakov@intel.com>", "To": "dev@dpdk.org", "Cc": "Liang Ma <liang.j.ma@intel.com>, Thomas Monjalon <thomas@monjalon.net>,\n Ferruh Yigit <ferruh.yigit@intel.com>,\n Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>,\n Ray Kinsella <mdr@ashroe.eu>, Neil Horman <nhorman@tuxdriver.com>,\n david.hunt@intel.com, konstantin.ananyev@intel.com, jerinjacobk@gmail.com,\n bruce.richardson@intel.com, timothy.mcdaniel@intel.com,\n gage.eads@intel.com, chris.macnamara@intel.com", "Date": "Fri, 9 Oct 2020 17:02:21 +0100", "Message-Id": "\n <931cbea6d091f16a51ad7eed736b4b6e69df93aa.1602258833.git.anatoly.burakov@intel.com>", "X-Mailer": "git-send-email 2.17.1", "In-Reply-To": [ "\n <532f45c5d79b4c30a919553d322bb66e91534466.1602258833.git.anatoly.burakov@intel.com>", "<1601647919-25312-1-git-send-email-liang.j.ma@intel.com>" ], "References": [ "\n <532f45c5d79b4c30a919553d322bb66e91534466.1602258833.git.anatoly.burakov@intel.com>", "<1601647919-25312-1-git-send-email-liang.j.ma@intel.com>" ], "Subject": "[dpdk-dev] [PATCH v5 04/10] ethdev: add simple power management API", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.15", "Precedence": "list", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "From: Liang Ma <liang.j.ma@intel.com>\n\nAdd a simple API to allow getting address of next RX descriptor from the\nPMD, as well as release notes information.\n\nSigned-off-by: Liang Ma <liang.j.ma@intel.com>\nSigned-off-by: Anatoly Burakov <anatoly.burakov@intel.com>\n---\n\nNotes:\n v5:\n - Bring function format in line with other functions in the file\n - Ensure the API is supported by the driver before calling it (Konstantin)\n\n doc/guides/rel_notes/release_20_11.rst | 16 ++++++++++++++\n lib/librte_ethdev/rte_ethdev.c | 17 ++++++++++++++\n lib/librte_ethdev/rte_ethdev.h | 24 ++++++++++++++++++++\n lib/librte_ethdev/rte_ethdev_driver.h | 28 ++++++++++++++++++++++++\n lib/librte_ethdev/rte_ethdev_version.map | 1 +\n 5 files changed, 86 insertions(+)", "diff": "diff --git a/doc/guides/rel_notes/release_20_11.rst b/doc/guides/rel_notes/release_20_11.rst\nindex 808bdc4e54..e85af5d3e9 100644\n--- a/doc/guides/rel_notes/release_20_11.rst\n+++ b/doc/guides/rel_notes/release_20_11.rst\n@@ -55,6 +55,11 @@ New Features\n Also, make sure to start the actual text at the margin.\n =======================================================\n \n+* **ethdev: add 1 new EXPERIMENTAL API for PMD power management.**\n+\n+ * ``rte_eth_get_wake_addr()``\n+ * add new eth_dev_ops ``get_wake_addr``\n+\n * **Updated Broadcom bnxt driver.**\n \n Updated the Broadcom bnxt driver with new features and improvements, including:\n@@ -136,6 +141,17 @@ New Features\n * Extern objects and functions can be plugged into the pipeline.\n * Transaction-oriented table updates.\n \n+* **Add PMD power management mechanism**\n+\n+ 3 new Ethernet PMD power management mechanism is added through existing\n+ RX callback infrastructure.\n+\n+ * Add power saving scheme based on UMWAIT instruction (x86 only)\n+ * Add power saving scheme based on ``rte_pause()``\n+ * Add power saving scheme based on frequency scaling through the power library\n+ * Add new EXPERIMENTAL API ``rte_power_pmd_mgmt_queue_enable()``\n+ * Add new EXPERIMENTAL API ``rte_power_pmd_mgmt_queue_disable()``\n+\n \n Removed Items\n -------------\ndiff --git a/lib/librte_ethdev/rte_ethdev.c b/lib/librte_ethdev/rte_ethdev.c\nindex 48d1333b17..352108f43c 100644\n--- a/lib/librte_ethdev/rte_ethdev.c\n+++ b/lib/librte_ethdev/rte_ethdev.c\n@@ -4804,6 +4804,23 @@ rte_eth_tx_burst_mode_get(uint16_t port_id, uint16_t queue_id,\n \t\t dev->dev_ops->tx_burst_mode_get(dev, queue_id, mode));\n }\n \n+int\n+rte_eth_get_wake_addr(uint16_t port_id, uint16_t queue_id,\n+\t\tvolatile void **wake_addr, uint64_t *expected, uint64_t *mask)\n+{\n+\tstruct rte_eth_dev *dev;\n+\n+\tRTE_ETH_VALID_PORTID_OR_ERR_RET(port_id, -ENODEV);\n+\n+\tdev = &rte_eth_devices[port_id];\n+\n+\tRTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->get_wake_addr, -ENOTSUP);\n+\n+\treturn eth_err(port_id,\n+\t\tdev->dev_ops->get_wake_addr(dev->data->rx_queues[queue_id],\n+\t\t\twake_addr, expected, mask));\n+}\n+\n int\n rte_eth_dev_set_mc_addr_list(uint16_t port_id,\n \t\t\t struct rte_ether_addr *mc_addr_set,\ndiff --git a/lib/librte_ethdev/rte_ethdev.h b/lib/librte_ethdev/rte_ethdev.h\nindex d2bf74f128..a6cfe3cd57 100644\n--- a/lib/librte_ethdev/rte_ethdev.h\n+++ b/lib/librte_ethdev/rte_ethdev.h\n@@ -4014,6 +4014,30 @@ __rte_experimental\n int rte_eth_tx_burst_mode_get(uint16_t port_id, uint16_t queue_id,\n \tstruct rte_eth_burst_mode *mode);\n \n+/**\n+ * Retrieve the wake up address from specific queue\n+ *\n+ * @param port_id\n+ * The port identifier of the Ethernet device.\n+ * @param queue_id\n+ * The Tx queue on the Ethernet device for which information\n+ * will be retrieved.\n+ * @param wake_addr\n+ * The pointer point to the address which is used for monitoring.\n+ * @param expected\n+ * The pointer point to value to be expected when descriptor is set.\n+ * @param mask\n+ * The pointer point to comparison bitmask for the expected value.\n+ *\n+ * @return\n+ * - 0: Success.\n+ * -EINVAL: Failed to get wake address.\n+ */\n+__rte_experimental\n+int rte_eth_get_wake_addr(uint16_t port_id, uint16_t queue_id,\n+\t\t\t volatile void **wake_addr,\n+\t\t\t uint64_t *expected, uint64_t *mask);\n+\n /**\n * Retrieve device registers and register attributes (number of registers and\n * register size)\ndiff --git a/lib/librte_ethdev/rte_ethdev_driver.h b/lib/librte_ethdev/rte_ethdev_driver.h\nindex c3062c246c..935d46f25c 100644\n--- a/lib/librte_ethdev/rte_ethdev_driver.h\n+++ b/lib/librte_ethdev/rte_ethdev_driver.h\n@@ -574,6 +574,31 @@ typedef int (*eth_tx_hairpin_queue_setup_t)\n \t uint16_t nb_tx_desc,\n \t const struct rte_eth_hairpin_conf *hairpin_conf);\n \n+/**\n+ * @internal\n+ * Get the Wake up address.\n+ *\n+ * @param rxq\n+ * Ethdev queue pointer.\n+ * @param tail_desc_addr\n+ * The pointer point to descriptor address var.\n+ * @param expected\n+ * The pointer point to value to be expected when descriptor is set.\n+ * @param mask\n+ * The pointer point to comparison bitmask for the expected value.\n+ * @return\n+ * Negative errno value on error, 0 on success.\n+ *\n+ * @retval 0\n+ * Success.\n+ * @retval -EINVAL\n+ * Failed to get descriptor address.\n+ */\n+typedef int (*eth_get_wake_addr_t)\n+\t(void *rxq, volatile void **tail_desc_addr,\n+\t uint64_t *expected, uint64_t *mask);\n+\n+\n /**\n * @internal A structure containing the functions exported by an Ethernet driver.\n */\n@@ -713,6 +738,9 @@ struct eth_dev_ops {\n \t/**< Set up device RX hairpin queue. */\n \teth_tx_hairpin_queue_setup_t tx_hairpin_queue_setup;\n \t/**< Set up device TX hairpin queue. */\n+\teth_get_wake_addr_t get_wake_addr;\n+\t/**< Get wake up address. */\n+\n };\n \n /**\ndiff --git a/lib/librte_ethdev/rte_ethdev_version.map b/lib/librte_ethdev/rte_ethdev_version.map\nindex c95ef5157a..3cb2093980 100644\n--- a/lib/librte_ethdev/rte_ethdev_version.map\n+++ b/lib/librte_ethdev/rte_ethdev_version.map\n@@ -229,6 +229,7 @@ EXPERIMENTAL {\n \t# added in 20.11\n \trte_eth_link_speed_to_str;\n \trte_eth_link_to_str;\n+\trte_eth_get_wake_addr;\n };\n \n INTERNAL {\n", "prefixes": [ "v5", "04/10" ] }