From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM01-BN3-obe.outbound.protection.outlook.com (mail-bn3nam01on0051.outbound.protection.outlook.com [104.47.33.51]) by dpdk.org (Postfix) with ESMTP id 14DBB5320 for ; Tue, 17 Jan 2017 14:19:41 +0100 (CET) Received: from BN3PR0301CA0030.namprd03.prod.outlook.com (10.160.180.168) by DM2PR0301MB0749.namprd03.prod.outlook.com (10.160.97.145) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.860.13; Tue, 17 Jan 2017 13:19:39 +0000 Received: from BY2FFO11FD042.protection.gbl (207.46.163.242) by BN3PR0301CA0030.outlook.office365.com (10.160.180.168) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.845.12 via Frontend Transport; Tue, 17 Jan 2017 13:19:39 +0000 Authentication-Results: spf=fail (sender IP is 192.88.168.50) smtp.mailfrom=nxp.com; nxp.com; dkim=none (message not signed) header.d=none;nxp.com; dmarc=fail action=none header.from=nxp.com;nxp.com; dkim=none (message not signed) header.d=none; Received-SPF: Fail (protection.outlook.com: domain of nxp.com does not designate 192.88.168.50 as permitted sender) receiver=protection.outlook.com; client-ip=192.88.168.50; helo=tx30smr01.am.freescale.net; Received: from tx30smr01.am.freescale.net (192.88.168.50) by BY2FFO11FD042.mail.protection.outlook.com (10.1.14.227) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.803.8 via Frontend Transport; Tue, 17 Jan 2017 13:19:37 +0000 Received: from bf-netperf1.idc ([10.232.134.28]) by tx30smr01.am.freescale.net (8.14.3/8.14.0) with ESMTP id v0HDJ8mE021741; Tue, 17 Jan 2017 06:19:34 -0700 From: Hemant Agrawal To: CC: , , , , , , Alex Marginean , Hemant Agrawal Date: Wed, 18 Jan 2017 00:22:28 +0530 Message-ID: <1484679174-4174-8-git-send-email-hemant.agrawal@nxp.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1484679174-4174-1-git-send-email-hemant.agrawal@nxp.com> References: <1482988612-6638-1-git-send-email-shreyansh.jain@nxp.com> <1484679174-4174-1-git-send-email-hemant.agrawal@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131291327779313376; (91ab9b29-cfa4-454e-5278-08d120cd25b8); () X-Forefront-Antispam-Report: CIP:192.88.168.50; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(336005)(7916002)(39840400002)(39850400002)(39410400002)(39400400002)(39380400002)(39450400003)(39860400002)(2980300002)(1109001)(1110001)(339900001)(199003)(189002)(36756003)(81156014)(50466002)(81166006)(110136003)(97736004)(8676002)(33646002)(104016004)(4326007)(189998001)(48376002)(85426001)(8656002)(54906002)(38730400001)(77096006)(21840400001)(86362001)(2950100002)(6916009)(626004)(8936002)(6666003)(5660300001)(76176999)(2351001)(50986999)(356003)(47776003)(5003940100001)(92566002)(106466001)(30001)(68736007)(305945005)(50226002)(105606002)(2906002)(2004002); DIR:OUT; SFP:1101; SCL:1; SRVR:DM2PR0301MB0749; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11FD042; 1:u/jsdpOyuvduHjUYkjJqohQzyjPnCp/0xlIypVD9KAfz4Zh0t8MjWzWc7qcuq30OgLUDocK19G+ClY3zNBGLM4hx5ilKqd2Zz9IVKAJyUiXmhcdyu23yBYt7ldCzueA2u6deKFLsiUuESJOwd453KxZUyRLE70Qm1zWnDHY05f01lMOJMozeAaT61vDrU3JaR7yxbX9Wyn47hrSGoS476CUll9L3xIVwwaExqUYDVyJXLqcX4SSN2Kw3BgiMYGHJ2/NXcMhUUSHaTFwxeJt83pUR8df6gbsNiuo2dxj8LVVCDER2CVRmErtcAgiYWhNdCgAwCbvKJ2NZSSxn1Bfpm3AlE+rWAOFhwqJAPZchTGIV+TGsufUqXuF+jqGG0syuaColtDJ/U99MaZwFULaaKuXw0IuF4F8pDe19JEhr4bmYV24KnCDP20vV2xsGtb0F7BWcuSAZOU1Tb7SB8U4uHEB4DoNPPAP/qMPLTwykbldbjwds8blG9qAegOVwzooWop0LUjkZsmHmIRiNh3eqECtvSbA/rfeCszGSClqm1/mnAnobyMoFOqj7oj0udWklkmK8jdIW9RlVkkaXj15VMcyEBcE57u1d7Vmthv7ZcTqqqAlGALYS5oyOHYy5yOcW+8VYC9zBTncHXF+dskMqmeXCBXTCeHeSbIi6bAxQ2BKp1E1J19lL60Xz4oLtLLhjy61xC9ES/CNGMY+oLaoAT5mJ5mRXObp4HmZXlVdQ0rl46S3HaMw6LsD3EbTni+JX MIME-Version: 1.0 Content-Type: text/plain X-MS-Office365-Filtering-Correlation-Id: 3871f9ae-d38f-4b8b-16e0-08d43edb7cd7 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001); SRVR:DM2PR0301MB0749; X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0749; 3:OYCxLIXfoSkHFnJSx+drElHKODQPZjd9+uq99vHGP7Ilq/e3AsDKL8yaKE9TTZgoSb11cCIen5y0tuy6zsuMsMDdOlIH3s6uwiEd6xOgZIZum7eOLyI8jUcp6eixEsCQ7RlvhxaNbPDAcfIpda9MXdKuR5uDf455dPjxJsUyqFq8DynfPL/LGr/XQr7N8a4lJkblg9oK4mDFYukRnmv68rjjRJI2m4I+D7Y0pqeUnDGEU048d05tbOwbPu2bq/dEt0H07iTN9qfQb02nUQspqCXyuh/2OCr2kKWGA/MoM621zV8gVE7QgXaCVFJGF5KQNXLjD3M03f0Wh2lAOJZidhGTvA+sV+DI7Uvk9HI3j+ROvDGIfcp1rksqrjhowtS2 X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0749; 25:Zb8hV1QbRq3cXemo8IGwA8cBllbPsFhN0FcO5LMzZBzlELhWUw2XNlc00nYLCbApZnY61Hh93rRnIJ7l462K5Rxvc6Vxyr3p2Q2OtoAd52YeDvsBmkL7DPUtbnlrz/Q3Ypb/V9WpPxKThej0nBIFnffkztJ0pqUt8f76HxrTujMw4xAL5Do/1Cm8h/XXOXqpQVosxrgkzfH1oglBXXEwIZT6IRjQaoFv1dDnQrXaKf7uXGop4w2QE4rkMBhEKlnpaiDzA5G0yIX2AvWoOxBvHrCqN+tkVs+xqxoCSPZnreZakJRk9tymHWHEQPE4kC5IU2R2a6bdoyoiRkQ7JHesok6lTjO//nmDfsBItIel5/RaBU4ll/Osp+9CrHIx41QP5sJjm2VVt9KSpvttQX5Ezgf4WP2aScJNMVKup1+cRecK4/c6+kd7voOlfhqdmt2Rd1pFfPJY6au9UD5RY7VsRpQJP2qv+SV8kqbWUPn7LEzeouSXDJ1YEiGMMhpeaSl8GDPfhnQpGxqc5PCS4+QwyVOzvPZjL1dRwYEJkz+6+hwTkcjiPZqaYrLnLnDBxnh8KWrSqokTvNV1rQnS3YaRTrbd/RJO80/jjnK1JdbDtzFyLsLcFSSu7m79RgmTAy4YbwPX0y7iKoPKY4EeJ4ZFWhfoBxLTSHuwevfBSMhi731ASMwhVgOl5UsnDbgWBaIOzIlc+Bk4wOaYqtOUHUxjToXE4Q3ZJ7qe0C4w8XxcUQKwvCPsJFUN5lFuEeWgo6GRrnyElOT4ZQQyOmzLHrNOyxu9BH8fMpdxbwu4kUnYV8w= X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0749; 31:ciAmc5WNxcn2kf7uF7Fk41Xmp/I4CXOKAx5bo5c5g1TIxywPWXiCe7TUX6SQ52MXmEbx4McHhEmyZBt+ch1r51abK77pPCcrgSseVl6dWJrFfabjjNWXZ2icPne+L+mewnW83LiHFFOsY6XzWuDMSq4kyXeKHJixGRsFMxd2rNOz91k9zaIdIJCU1TFlVdcKWSN/Io5d57rJF7SMF7W4EZ3xo+TF6f7DGpvunYY6ge7YiR4MVI4G3IlfhE0lNvNxQl8m1DuKXpy7RjEo+ij0nQ== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197)(227817650892897)(275809806118684); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6095060)(601004)(2401047)(13023025)(13017025)(13015025)(13024025)(13018025)(5005006)(8121501046)(3002001)(10201501046)(6055026)(6096035)(20161123561025)(20161123559025)(20161123556025)(20161123563025)(20161123565025); SRVR:DM2PR0301MB0749; BCL:0; PCL:0; RULEID:(400006); SRVR:DM2PR0301MB0749; X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0749; 4:9ExX1ogYwOtQJM1PV4nLYAiDbdkS0peWuql0iYp3pPr9v+VH+zhHinIxY0r0WoSub97dNmW4AZi9iwmdFtQf1orysjjw1ndFTyc908j2c5GK8i2k8GjFSivIqoqe7nX7onexyzy6tg3Uwke5aJhw4Ehjar3HykHo1hUW7bwGbe3J7dGHBo+gVt1yHssUyyCBnNL6lnOu9n8q5EevIt/loYZja/a1Tthtw6MjTx0BnhgzsJ/omxF6FNZym8sLwyAk2ZP+NpQ2h7s+bQ7TwyCov7Tuw52RxFtfOXIainjYSXm2UwPH4I83hT/C12S4wXfcfFZjxLwayYh8wIz6zwRaE5E4uZ/FJFoV7aEsiYOYUPmlR0C1hePfAnPa1e4+A5oES+iD8PaU99cx1SDd92lSsSUgN/zJwG+VXR1g2QA4Cj1L5ViiBnADcuGgCaY7uZoKaR75DNHSFtswy1u9OPpXOAAvY45mgRQQOTF9kvxNo42AcEka8vvuTuJZKhFy9YfAp1g86I16lXMKp9i7V7XqLjwDSNzEUjbNY0cMJV66LK/b82DqJw05nBdnuhGoeXrpxis/2nw7+kk1NzNwQAxmDwyhekgwMolG2+wyfFy6l8HOV70T3G9XHiUUdJoO91Fh7Ku+4KN5+xeq6M/JQ0OAI5cUJvH2HxHpwFSNcWRUKM7xV+UL3GZbfNHbzCEK4Fp5enbeFgIk0qjyTQHy146ZvOl5dNPbgzhfHiji1S55lsRv+yTSpYSUZGyPRm/76yyU7DPysTPKYBVXWHryGc06at2WQeWgb7s0sgi6M/pMvA9sG04MtP5KgUxb1x/j0CbU X-Forefront-PRVS: 01901B3451 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DM2PR0301MB0749; 23:OE9M+R4ZmXG2POIgHPisLQXbYbJ6WYXYIhUQkTY?= =?us-ascii?Q?6Ccghn77SezUlw00YwjqiEr06PXYeTHA/HrFRI7ZpjiQVlipePD22TDkjPhU?= =?us-ascii?Q?JDEsgj/sAfZFG13FQr4uSIP/uwFEwt61vPYCEUkpoEdquUmvUotLmChgvs+N?= =?us-ascii?Q?FLLKaKI9xzHShPk7VoX2CTONfNaOXQL0Mz+5oITkHtV3JXIT95XfhQyq5qZ2?= =?us-ascii?Q?KaTXPC+8nvSp1AvN9ntJdvWxjxd8krQj+rMzNB4qR0Pj7ALgWYJqt02zGZ4X?= =?us-ascii?Q?0nD30rLbFdUUrTzzPsl7CSPE0pzLZciQ7LDbPW7sqhfbehfQvJZQ/g+oviVC?= =?us-ascii?Q?UNAHLa9g/4wclcaUJeSTjiZGFppjIGd8W7N12P7wqerWpSw4FIEsWeAJwr56?= =?us-ascii?Q?NxPVHn6viyIQ73s2CqLmGe2vSJ8oFMr8WM4Vn8ab6T6RYsWrdCWC1x0oZ5tD?= =?us-ascii?Q?qNmEUTeHsQPy05KwVJhzxjOiV7NNL5ZLIPBi9V+On3Z26RzPqq1rg+1RTBBg?= =?us-ascii?Q?y0oVGo2EFa7Uubq/asUIw0d6HIBikeu3ellOvda+VrfTFbcUc9sC6n/WbWA+?= =?us-ascii?Q?5JPk0ScbSPG18oRdD64/n5IyIRwDRUUY167hwZdGtOE3WKmwFLBSwY5z3jaU?= =?us-ascii?Q?YrCRyadZAmWWJ6VUEhaYaR52TvwQZj0TBCRzfNg9mRQzUt8t1b3iaQI5xGxa?= =?us-ascii?Q?ts9zKmKfHPK8z54pOZmXKgbo5j11vWT+r2+mpme164QWucU0vwmrP4IX+oRL?= =?us-ascii?Q?eYP+xw3tfWF5HtSyGQ62TtpsroV1JT3erBwFUhRfVUWLey/Lb7uYsUbSVfOe?= =?us-ascii?Q?IpJG3x0oAdptM4cJn5yD72ZxaGBPOKnT6FkBfxby02G+4TeGJHTOcZ0LslZT?= =?us-ascii?Q?hHBI5lsw5aYO7SIF+Xy0tqVh8cRyAvzaABfsCE2qNLxLjkT+wenLiRznYexw?= =?us-ascii?Q?cJpFASfQQCYRBRlN8dnbXjMo/KtfjZMoYiXV7A25/pypJdqcSfa3kTfCqxnS?= =?us-ascii?Q?fniCKZiL0DtkpSgIwWVMbxOpXV2tbw2vcP2C/hjUvC6Sr7d7yL5tou0QCi8v?= =?us-ascii?Q?hcViDvu7Beek4bvN/lxTuIWRuhbQB96Lia0zqSXlc0pLXxVvZ/RMl4Ty1sQo?= =?us-ascii?Q?FYWi09BPUOvckjmbhs5G//Ql2p1CNs41ZhgPVenuANQyunIYsOmReRMbWmBN?= =?us-ascii?Q?R7kd8KO5hLunzMSMApFEIIWxiPwJ19OgR5bfFzmyHyNfoKgz8TNqcyfo8H26?= =?us-ascii?Q?J6cyg01skFIeneHXCXgxC5VrGZUwePqZNrgUyfTuFfS2knVPF+7qESIprzcj?= =?us-ascii?Q?eJw2J7RulPSmQhGYNuZbkEiea5SG9/77HMXrTsyfUsYJVKwp6kqMFe1T7Raj?= =?us-ascii?Q?qlL6jbw=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0749; 6:hml457Ioe+NItNSmLLFpucZrn8qw34MF/mw7n0YsFmYXy3i3KnI+TL0d0x94OPLUAzVxNLwaSxbNdPQKg87IvcCMmm7z2+UDEPpSgftJ+YQaOEz68zEDkja6ftnI+t+0pRGQ+bkMD3c7ZA5+VpR7llM8gBIqUpR8/Tmytp48C5aj1JjPRmJ9rxNTEdPTL1u61Z63MGTxfUU+EqQDs+NtxZgtIatJ7AA5mnsgid5+DbdXEMtbPFZ2tXsAFceqZi8pJaMh9g5+9vB3gYMOvr33dqFds2+rWIy8KJJ2vnHrB5j13j/1IInmUGoq4hsQoJlyxKDTteXaDiHGTCrXM6U+5+jM5Ler/FBt+QwZKWelzaK6dpfARu7QZNwTiBDQYTut+vFBcjSthODGbpDv36l8TFuSi61tFahKiJLNvObcBcfWSPlujgn3NlyiX2v4Kxte; 5:lY79dUzhmBKXFYTzFzYM2Xf/+VoFzsSrsSwQnrVPRnccGIAHcit7s7RbuC5A53FNB5fHzBq7fK7bY1Og5V4QmGm5xWNPHhAvLMa6E8CfK7xKrOtaA8FSe3N9rUZMXwajcOc631jCb7st+eZXRA1lgJ9hAyDa96wMElbC/OiarcQ2Znkwx5DGnEa9F4uDtYzT; 24:l8Ad7hgDxnYtqsPDDkYdsmXoxLtGooiHOzEhzfhmdmgCCmSuhqMZl33uEAXUVKb0mJINwxyq8lgozPWgchRlBk64l98CX51NGYY5RrpZOkc= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM2PR0301MB0749; 7:ad984t2pm8T3BssNPe4eZbosgOmO5jPUo0ybOViAXu8d0SYRa/l9dXRs4b0NHCpdl06V0gpfoIO//voFyqcVhziHmtPH7y7Hj8wzbqFx4CXrv47vqEwN7u7HPsZ+MpLQZ53KMclWDKab+UEakfUz3xj5Mb+hdLw1Mg4qxuoDkr44aGA59wZQt6dIXFZzzxjpTmrxgnKGNDZO0JxiXymbnOjlP5lctvBFewDlqzfm/qn0dmVcz0znxJJykhfs/2B2XYz7chplcaZA2hwt5/BO7Yj5hUx+2O016ia/Lqiri5zdNsRaV+WWAeTRzPPi9RsGe7HiweFWdiv2l03hXNaA/p645PElm8LIV8LsNFw8PD0rCHyzPFM56YPNTzbXN6RQfNsGNZ2MQWOJv1q2sRF6WwIhEod69vpAlNYy6OWk8ABzk8e6PhWxXNjs9FxpF2iGTVevIFMhOjUapQUuG2A8iQ== X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Jan 2017 13:19:37.7285 (UTC) X-MS-Exchange-CrossTenant-Id: 5afe0b00-7697-4969-b663-5eab37d5f47e X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=5afe0b00-7697-4969-b663-5eab37d5f47e; Ip=[192.88.168.50]; Helo=[tx30smr01.am.freescale.net] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM2PR0301MB0749 Subject: [dpdk-dev] [PATCHv4 07/33] bus/fslmc: add mc dpio object support X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 Jan 2017 13:19:41 -0000 This patch adds the DPIO object support in MC driver. DPIO - Data Path Input Output represent the processing context to access the QBMAN HW for packet I/O. Signed-off-by: Alex Marginean Signed-off-by: Hemant Agrawal --- drivers/bus/fslmc/Makefile | 1 + drivers/bus/fslmc/mc/dpio.c | 272 ++++++++++++++++++++++++ drivers/bus/fslmc/mc/fsl_dpio.h | 275 +++++++++++++++++++++++++ drivers/bus/fslmc/mc/fsl_dpio_cmd.h | 114 ++++++++++ drivers/bus/fslmc/rte_pmd_fslmcbus_version.map | 8 + 5 files changed, 670 insertions(+) create mode 100644 drivers/bus/fslmc/mc/dpio.c create mode 100644 drivers/bus/fslmc/mc/fsl_dpio.h create mode 100644 drivers/bus/fslmc/mc/fsl_dpio_cmd.h diff --git a/drivers/bus/fslmc/Makefile b/drivers/bus/fslmc/Makefile index c3616e6..fa1ce13 100644 --- a/drivers/bus/fslmc/Makefile +++ b/drivers/bus/fslmc/Makefile @@ -50,6 +50,7 @@ LIBABIVER := 1 SRCS-$(CONFIG_RTE_LIBRTE_FSLMC_BUS) += \ mc/dpni.c \ + mc/dpio.c \ mc/mc_sys.c SRCS-$(CONFIG_RTE_LIBRTE_FSLMC_BUS) += fslmc_bus.c diff --git a/drivers/bus/fslmc/mc/dpio.c b/drivers/bus/fslmc/mc/dpio.c new file mode 100644 index 0000000..35a06d6 --- /dev/null +++ b/drivers/bus/fslmc/mc/dpio.c @@ -0,0 +1,272 @@ +/* Copyright 2013-2016 Freescale Semiconductor Inc. + * Copyright (c) 2016 NXP. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the name of the above-listed copyright holders nor the + * names of any contributors may be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * + * ALTERNATIVELY, this software may be distributed under the terms of the + * GNU General Public License ("GPL") as published by the Free Software + * Foundation, either version 2 of that License or (at your option) any + * later version. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE + * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. + */ +#include +#include +#include +#include + +int dpio_open(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + int dpio_id, + uint16_t *token) +{ + struct mc_command cmd = { 0 }; + int err; + + /* prepare command */ + cmd.header = mc_encode_cmd_header(DPIO_CMDID_OPEN, + cmd_flags, + 0); + DPIO_CMD_OPEN(cmd, dpio_id); + + /* send command to mc*/ + err = mc_send_command(mc_io, &cmd); + if (err) + return err; + + /* retrieve response parameters */ + *token = MC_CMD_HDR_READ_TOKEN(cmd.header); + + return 0; +} + +int dpio_close(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token) +{ + struct mc_command cmd = { 0 }; + + /* prepare command */ + cmd.header = mc_encode_cmd_header(DPIO_CMDID_CLOSE, + cmd_flags, + token); + + /* send command to mc*/ + return mc_send_command(mc_io, &cmd); +} + +int dpio_create(struct fsl_mc_io *mc_io, + uint16_t dprc_token, + uint32_t cmd_flags, + const struct dpio_cfg *cfg, + uint32_t *obj_id) +{ + struct mc_command cmd = { 0 }; + int err; + + /* prepare command */ + cmd.header = mc_encode_cmd_header(DPIO_CMDID_CREATE, + cmd_flags, + dprc_token); + DPIO_CMD_CREATE(cmd, cfg); + + /* send command to mc*/ + err = mc_send_command(mc_io, &cmd); + if (err) + return err; + + /* retrieve response parameters */ + CMD_CREATE_RSP_GET_OBJ_ID_PARAM0(cmd, *obj_id); + + return 0; +} + +int dpio_destroy(struct fsl_mc_io *mc_io, + uint16_t dprc_token, + uint32_t cmd_flags, + uint32_t object_id) +{ + struct mc_command cmd = { 0 }; + + /* prepare command */ + cmd.header = mc_encode_cmd_header(DPIO_CMDID_DESTROY, + cmd_flags, + dprc_token); + /* set object id to destroy */ + CMD_DESTROY_SET_OBJ_ID_PARAM0(cmd, object_id); + /* send command to mc*/ + return mc_send_command(mc_io, &cmd); +} + +int dpio_enable(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token) +{ + struct mc_command cmd = { 0 }; + + /* prepare command */ + cmd.header = mc_encode_cmd_header(DPIO_CMDID_ENABLE, + cmd_flags, + token); + + /* send command to mc*/ + return mc_send_command(mc_io, &cmd); +} + +int dpio_disable(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token) +{ + struct mc_command cmd = { 0 }; + + /* prepare command */ + cmd.header = mc_encode_cmd_header(DPIO_CMDID_DISABLE, + cmd_flags, + token); + + /* send command to mc*/ + return mc_send_command(mc_io, &cmd); +} + +int dpio_is_enabled(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token, + int *en) +{ + struct mc_command cmd = { 0 }; + int err; + /* prepare command */ + cmd.header = mc_encode_cmd_header(DPIO_CMDID_IS_ENABLED, cmd_flags, + token); + + /* send command to mc*/ + err = mc_send_command(mc_io, &cmd); + if (err) + return err; + + /* retrieve response parameters */ + DPIO_RSP_IS_ENABLED(cmd, *en); + + return 0; +} + +int dpio_reset(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token) +{ + struct mc_command cmd = { 0 }; + + /* prepare command */ + cmd.header = mc_encode_cmd_header(DPIO_CMDID_RESET, + cmd_flags, + token); + + /* send command to mc*/ + return mc_send_command(mc_io, &cmd); +} + +int dpio_get_attributes(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token, + struct dpio_attr *attr) +{ + struct mc_command cmd = { 0 }; + int err; + + /* prepare command */ + cmd.header = mc_encode_cmd_header(DPIO_CMDID_GET_ATTR, + cmd_flags, + token); + + /* send command to mc*/ + err = mc_send_command(mc_io, &cmd); + if (err) + return err; + + /* retrieve response parameters */ + DPIO_RSP_GET_ATTR(cmd, attr); + + return 0; +} + +int dpio_set_stashing_destination(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token, + uint8_t sdest) +{ + struct mc_command cmd = { 0 }; + + /* prepare command */ + cmd.header = mc_encode_cmd_header(DPIO_CMDID_SET_STASHING_DEST, + cmd_flags, + token); + DPIO_CMD_SET_STASHING_DEST(cmd, sdest); + + /* send command to mc*/ + return mc_send_command(mc_io, &cmd); +} + +int dpio_get_stashing_destination(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token, + uint8_t *sdest) +{ + struct mc_command cmd = { 0 }; + int err; + + /* prepare command */ + cmd.header = mc_encode_cmd_header(DPIO_CMDID_GET_STASHING_DEST, + cmd_flags, + token); + + /* send command to mc*/ + err = mc_send_command(mc_io, &cmd); + if (err) + return err; + + /* retrieve response parameters */ + DPIO_RSP_GET_STASHING_DEST(cmd, *sdest); + + return 0; +} + +int dpio_get_api_version(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t *major_ver, + uint16_t *minor_ver) +{ + struct mc_command cmd = { 0 }; + int err; + + cmd.header = mc_encode_cmd_header(DPIO_CMDID_GET_API_VERSION, + cmd_flags, + 0); + + err = mc_send_command(mc_io, &cmd); + if (err) + return err; + + DPIO_RSP_GET_API_VERSION(cmd, *major_ver, *minor_ver); + + return 0; +} diff --git a/drivers/bus/fslmc/mc/fsl_dpio.h b/drivers/bus/fslmc/mc/fsl_dpio.h new file mode 100644 index 0000000..8cb4b99 --- /dev/null +++ b/drivers/bus/fslmc/mc/fsl_dpio.h @@ -0,0 +1,275 @@ +/* Copyright 2013-2016 Freescale Semiconductor Inc. + * Copyright (c) 2016 NXP. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the name of the above-listed copyright holders nor the + * names of any contributors may be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * + * ALTERNATIVELY, this software may be distributed under the terms of the + * GNU General Public License ("GPL") as published by the Free Software + * Foundation, either version 2 of that License or (at your option) any + * later version. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE + * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. + */ +#ifndef __FSL_DPIO_H +#define __FSL_DPIO_H + +/* Data Path I/O Portal API + * Contains initialization APIs and runtime control APIs for DPIO + */ + +struct fsl_mc_io; + +/** + * dpio_open() - Open a control session for the specified object + * @mc_io: Pointer to MC portal's I/O object + * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' + * @dpio_id: DPIO unique ID + * @token: Returned token; use in subsequent API calls + * + * This function can be used to open a control session for an + * already created object; an object may have been declared in + * the DPL or by calling the dpio_create() function. + * This function returns a unique authentication token, + * associated with the specific object ID and any MC portals + * assigned to the parent container; this token must be used in + * all subsequent commands for this specific object. + * + * Return: '0' on Success; Error code otherwise. + */ +int dpio_open(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + int dpio_id, + uint16_t *token); + +/** + * dpio_close() - Close the control session of the object + * @mc_io: Pointer to MC portal's I/O object + * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' + * @token: Token of DPIO object + * + * Return: '0' on Success; Error code otherwise. + */ +int dpio_close(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token); + +/** + * enum dpio_channel_mode - DPIO notification channel mode + * @DPIO_NO_CHANNEL: No support for notification channel + * @DPIO_LOCAL_CHANNEL: Notifications on data availability can be received by a + * dedicated channel in the DPIO; user should point the queue's + * destination in the relevant interface to this DPIO + */ +enum dpio_channel_mode { + DPIO_NO_CHANNEL = 0, + DPIO_LOCAL_CHANNEL = 1, +}; + +/** + * struct dpio_cfg - Structure representing DPIO configuration + * @channel_mode: Notification channel mode + * @num_priorities: Number of priorities for the notification channel (1-8); + * relevant only if 'channel_mode = DPIO_LOCAL_CHANNEL' + */ +struct dpio_cfg { + enum dpio_channel_mode channel_mode; + uint8_t num_priorities; +}; + +/** + * dpio_create() - Create the DPIO object. + * @mc_io: Pointer to MC portal's I/O object + * @dprc_token: Parent container token; '0' for default container + * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' + * @cfg: Configuration structure + * @obj_id: returned object id + * + * Create the DPIO object, allocate required resources and + * perform required initialization. + * + * The object can be created either by declaring it in the + * DPL file, or by calling this function. + * + * The function accepts an authentication token of a parent + * container that this object should be assigned to. The token + * can be '0' so the object will be assigned to the default container. + * The newly created object can be opened with the returned + * object id and using the container's associated tokens and MC portals. + * + * Return: '0' on Success; Error code otherwise. + */ +int dpio_create(struct fsl_mc_io *mc_io, + uint16_t dprc_token, + uint32_t cmd_flags, + const struct dpio_cfg *cfg, + uint32_t *obj_id); + +/** + * dpio_destroy() - Destroy the DPIO object and release all its resources. + * @mc_io: Pointer to MC portal's I/O object + * @dprc_token: Parent container token; '0' for default container + * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' + * @object_id: The object id; it must be a valid id within the container that + * created this object; + * + * The function accepts the authentication token of the parent container that + * created the object (not the one that currently owns the object). The object + * is searched within parent using the provided 'object_id'. + * All tokens to the object must be closed before calling destroy. + * + * Return: '0' on Success; Error code otherwise + */ +int dpio_destroy(struct fsl_mc_io *mc_io, + uint16_t dprc_token, + uint32_t cmd_flags, + uint32_t object_id); + +/** + * dpio_enable() - Enable the DPIO, allow I/O portal operations. + * @mc_io: Pointer to MC portal's I/O object + * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' + * @token: Token of DPIO object + * + * Return: '0' on Success; Error code otherwise + */ +int dpio_enable(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token); + +/** + * dpio_disable() - Disable the DPIO, stop any I/O portal operation. + * @mc_io: Pointer to MC portal's I/O object + * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' + * @token: Token of DPIO object + * + * Return: '0' on Success; Error code otherwise + */ +int dpio_disable(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token); + +/** + * dpio_is_enabled() - Check if the DPIO is enabled. + * @mc_io: Pointer to MC portal's I/O object + * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' + * @token: Token of DPIO object + * @en: Returns '1' if object is enabled; '0' otherwise + * + * Return: '0' on Success; Error code otherwise. + */ +int dpio_is_enabled(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token, + int *en); + +/** + * dpio_reset() - Reset the DPIO, returns the object to initial state. + * @mc_io: Pointer to MC portal's I/O object + * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' + * @token: Token of DPIO object + * + * Return: '0' on Success; Error code otherwise. + */ +int dpio_reset(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token); + +/** + * dpio_set_stashing_destination() - Set the stashing destination. + * @mc_io: Pointer to MC portal's I/O object + * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' + * @token: Token of DPIO object + * @sdest: stashing destination value + * + * Return: '0' on Success; Error code otherwise. + */ +int dpio_set_stashing_destination(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token, + uint8_t sdest); + +/** + * dpio_get_stashing_destination() - Get the stashing destination.. + * @mc_io: Pointer to MC portal's I/O object + * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' + * @token: Token of DPIO object + * @sdest: Returns the stashing destination value + * + * Return: '0' on Success; Error code otherwise. + */ +int dpio_get_stashing_destination(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token, + uint8_t *sdest); + +/** + * struct dpio_attr - Structure representing DPIO attributes + * @id: DPIO object ID + * @qbman_portal_ce_offset: offset of the software portal cache-enabled area + * @qbman_portal_ci_offset: offset of the software portal cache-inhibited area + * @qbman_portal_id: Software portal ID + * @channel_mode: Notification channel mode + * @num_priorities: Number of priorities for the notification channel (1-8); + * relevant only if 'channel_mode = DPIO_LOCAL_CHANNEL' + * @qbman_version: QBMAN version + */ +struct dpio_attr { + int id; + uint64_t qbman_portal_ce_offset; + uint64_t qbman_portal_ci_offset; + uint16_t qbman_portal_id; + enum dpio_channel_mode channel_mode; + uint8_t num_priorities; + uint32_t qbman_version; + uint32_t clk; +}; + +/** + * dpio_get_attributes() - Retrieve DPIO attributes + * @mc_io: Pointer to MC portal's I/O object + * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' + * @token: Token of DPIO object + * @attr: Returned object's attributes + * + * Return: '0' on Success; Error code otherwise + */ +int dpio_get_attributes(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t token, + struct dpio_attr *attr); + +/** + * dpio_get_api_version() - Get Data Path I/O API version + * @mc_io: Pointer to MC portal's I/O object + * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' + * @major_ver: Major version of data path i/o API + * @minor_ver: Minor version of data path i/o API + * + * Return: '0' on Success; Error code otherwise. + */ +int dpio_get_api_version(struct fsl_mc_io *mc_io, + uint32_t cmd_flags, + uint16_t *major_ver, + uint16_t *minor_ver); + +#endif /* __FSL_DPIO_H */ diff --git a/drivers/bus/fslmc/mc/fsl_dpio_cmd.h b/drivers/bus/fslmc/mc/fsl_dpio_cmd.h new file mode 100644 index 0000000..e40ec28 --- /dev/null +++ b/drivers/bus/fslmc/mc/fsl_dpio_cmd.h @@ -0,0 +1,114 @@ +/* Copyright 2013-2016 Freescale Semiconductor Inc. + * Copyright (c) 2016 NXP. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the name of the above-listed copyright holders nor the + * names of any contributors may be used to endorse or promote products + * derived from this software without specific prior written permission. + * + * + * ALTERNATIVELY, this software may be distributed under the terms of the + * GNU General Public License ("GPL") as published by the Free Software + * Foundation, either version 2 of that License or (at your option) any + * later version. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE + * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. + */ +#ifndef _FSL_DPIO_CMD_H +#define _FSL_DPIO_CMD_H + +/* DPIO Version */ +#define DPIO_VER_MAJOR 4 +#define DPIO_VER_MINOR 2 + +/* Command IDs */ +#define DPIO_CMDID_CLOSE ((0x800 << 4) | (0x1)) +#define DPIO_CMDID_OPEN ((0x803 << 4) | (0x1)) +#define DPIO_CMDID_CREATE ((0x903 << 4) | (0x1)) +#define DPIO_CMDID_DESTROY ((0x983 << 4) | (0x1)) +#define DPIO_CMDID_GET_API_VERSION ((0xa03 << 4) | (0x1)) + +#define DPIO_CMDID_ENABLE ((0x002 << 4) | (0x1)) +#define DPIO_CMDID_DISABLE ((0x003 << 4) | (0x1)) +#define DPIO_CMDID_GET_ATTR ((0x004 << 4) | (0x1)) +#define DPIO_CMDID_RESET ((0x005 << 4) | (0x1)) +#define DPIO_CMDID_IS_ENABLED ((0x006 << 4) | (0x1)) + +#define DPIO_CMDID_SET_STASHING_DEST ((0x120 << 4) | (0x1)) +#define DPIO_CMDID_GET_STASHING_DEST ((0x121 << 4) | (0x1)) +#define DPIO_CMDID_ADD_STATIC_DEQUEUE_CHANNEL ((0x122 << 4) | (0x1)) +#define DPIO_CMDID_REMOVE_STATIC_DEQUEUE_CHANNEL ((0x123 << 4) | (0x1)) + +/* cmd, param, offset, width, type, arg_name */ +#define DPIO_CMD_OPEN(cmd, dpio_id) \ + MC_CMD_OP(cmd, 0, 0, 32, uint32_t, dpio_id) + +/* cmd, param, offset, width, type, arg_name */ +#define DPIO_CMD_CREATE(cmd, cfg) \ +do { \ + MC_CMD_OP(cmd, 0, 16, 2, enum dpio_channel_mode, \ + cfg->channel_mode);\ + MC_CMD_OP(cmd, 0, 32, 8, uint8_t, cfg->num_priorities);\ +} while (0) + +/* cmd, param, offset, width, type, arg_name */ +#define DPIO_RSP_IS_ENABLED(cmd, en) \ + MC_RSP_OP(cmd, 0, 0, 1, int, en) + +/* cmd, param, offset, width, type, arg_name */ +#define DPIO_RSP_GET_ATTR(cmd, attr) \ +do { \ + MC_RSP_OP(cmd, 0, 0, 32, int, attr->id);\ + MC_RSP_OP(cmd, 0, 32, 16, uint16_t, attr->qbman_portal_id);\ + MC_RSP_OP(cmd, 0, 48, 8, uint8_t, attr->num_priorities);\ + MC_RSP_OP(cmd, 0, 56, 4, enum dpio_channel_mode, attr->channel_mode);\ + MC_RSP_OP(cmd, 1, 0, 64, uint64_t, attr->qbman_portal_ce_offset);\ + MC_RSP_OP(cmd, 2, 0, 64, uint64_t, attr->qbman_portal_ci_offset);\ + MC_RSP_OP(cmd, 3, 0, 32, uint32_t, attr->qbman_version);\ + MC_RSP_OP(cmd, 4, 0, 32, uint32_t, attr->clk);\ +} while (0) + +/* cmd, param, offset, width, type, arg_name */ +#define DPIO_CMD_SET_STASHING_DEST(cmd, sdest) \ + MC_CMD_OP(cmd, 0, 0, 8, uint8_t, sdest) + +/* cmd, param, offset, width, type, arg_name */ +#define DPIO_RSP_GET_STASHING_DEST(cmd, sdest) \ + MC_RSP_OP(cmd, 0, 0, 8, uint8_t, sdest) + +/* cmd, param, offset, width, type, arg_name */ +#define DPIO_CMD_ADD_STATIC_DEQUEUE_CHANNEL(cmd, dpcon_id) \ + MC_CMD_OP(cmd, 0, 0, 32, int, dpcon_id) + +/* cmd, param, offset, width, type, arg_name */ +#define DPIO_RSP_ADD_STATIC_DEQUEUE_CHANNEL(cmd, channel_index) \ + MC_RSP_OP(cmd, 0, 0, 8, uint8_t, channel_index) + +/* cmd, param, offset, width, type, arg_name */ +#define DPIO_CMD_REMOVE_STATIC_DEQUEUE_CHANNEL(cmd, dpcon_id) \ + MC_CMD_OP(cmd, 0, 0, 32, int, dpcon_id) + +/* cmd, param, offset, width, type, arg_name */ +#define DPIO_RSP_GET_API_VERSION(cmd, major, minor) \ +do { \ + MC_RSP_OP(cmd, 0, 0, 16, uint16_t, major);\ + MC_RSP_OP(cmd, 0, 16, 16, uint16_t, minor);\ +} while (0) + +#endif /* _FSL_DPIO_CMD_H */ diff --git a/drivers/bus/fslmc/rte_pmd_fslmcbus_version.map b/drivers/bus/fslmc/rte_pmd_fslmcbus_version.map index d49dda8..daf6b8f 100644 --- a/drivers/bus/fslmc/rte_pmd_fslmcbus_version.map +++ b/drivers/bus/fslmc/rte_pmd_fslmcbus_version.map @@ -1,5 +1,13 @@ DPDK_17.02 { global: + + dpio_close; + dpio_disable; + dpio_enable; + dpio_get_attributes; + dpio_open; + dpio_reset; + dpio_set_stashing_destination; dpni_close; dpni_disable; dpni_enable; -- 1.9.1