From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933234AbcBIASR (ORCPT ); Mon, 8 Feb 2016 19:18:17 -0500 Received: from mail-bn1on0112.outbound.protection.outlook.com ([157.56.110.112]:20121 "EHLO na01-bn1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S932691AbcBIAOQ (ORCPT ); Mon, 8 Feb 2016 19:14:16 -0500 Authentication-Results: spf=permerror (sender IP is 192.88.168.50) smtp.mailfrom=freescale.com; freescale.mail.onmicrosoft.com; dkim=none (message not signed) header.d=none;freescale.mail.onmicrosoft.com; dmarc=none action=none header.from=freescale.com; From: Lijun Pan To: , , , CC: , , , , , , , , , , , , , Lijun Pan Subject: [PATCH v3 7/8] staging: fsl-mc: update TODO and README for restool driver Date: Mon, 8 Feb 2016 17:40:17 -0600 Message-ID: <1454974818-5385-8-git-send-email-Lijun.Pan@freescale.com> X-Mailer: git-send-email 1.7.9.5 In-Reply-To: <1454974818-5385-1-git-send-email-Lijun.Pan@freescale.com> References: <1454974818-5385-1-git-send-email-Lijun.Pan@freescale.com> X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1;BN1BFFO11FD047;1:Yxtzpk5JY4hFnNS91NVfY5u5pZPVGiGDqXCB8UlykKO91SoV+dhh5rddN/fg4HGQ53Ua4QxNKGuwPUVIucL4D+udPX5K7Qmt2JqjxNcamYknp+m+BSWfy6Fe9X/9rdM68J+gEaZR22nmhmloHp3YaSDg+SdU+I7dOy+zVybdcpzWSPbtqIafnZpKILoew1pL5CxIFqaQCjMyxiyDP0D4Zw14Uj1oElnXm+0MwSTzs6+ElfVxZ5mx2/rk12hKJ2K7K0A5GcektLtqE/qfx3ojafLTK3x5ty95l8sVrkV3XQXb1kUO5RF5C47D6TsJeLLQaC1WH8YVq9ShNJjJwFDMltClI/6mg/g1zulpWjDhsLDcLAyLlAXbFM6l75HolrRDin6lCyvNwiuoCFNDTAFubL4IRiDvbirManiee2S14VxJssV5nz56z8VAenPT095/jyGCj8VZvefhE651hRf3yrKzEfbyCLam9Ow/xmKwA4hEDO06QziP/Njb1QBlTqCk X-Forefront-Antispam-Report: CIP:192.88.168.50;CTRY:US;IPV:NLI;EFV:NLI;SFV:NSPM;SFS:(10019020)(6009001)(2980300002)(3190300001)(199003)(189002)(76176999)(50986999)(77096005)(86362001)(2201001)(48376002)(87936001)(47776003)(229853001)(2950100001)(106466001)(36756003)(85326001)(50226001)(19580395003)(19580405001)(92566002)(104016004)(586003)(5003940100001)(11100500001)(1220700001)(2906002)(4326007)(50466002)(4001430100002)(189998001)(107886002)(5001960100002)(5001770100001)(5008740100001)(1096002)(6806005);DIR:OUT;SFP:1102;SCL:1;SRVR:BN3PR03MB1446;H:tx30smr01.am.freescale.net;FPR:;SPF:PermError;MLV:sfv;A:1;MX:1;LANG:en; MIME-Version: 1.0 Content-Type: text/plain X-MS-Office365-Filtering-Correlation-Id: 134787c6-a73e-49fb-f249-08d330e3f751 X-Microsoft-Exchange-Diagnostics: 1;BN3PR03MB1446;2:sLHChJJ7oOWq/ylO2/rpEir3VDbOsyz9liaa0j5x10LAMuuq2e8JdA6j/cnDKZW4nObTvqb5JAGdoZLe30OvT5PSlPOYVcM2f2PFcYRge42TKXZEIqL5LuqecefUN4/j4s3taefPAUGrA+DJUO05l7wCCkfopOzw1nylUl88fMb6eltjGK8efWDPnPFvwkrH;3:XTl60Svf5EPjvW2v0IckU9uSwaWebTFgNEBl1Mv+RS5S80nnLPn91PyP1NQBvwJvAicJW9NMsIuXqFYva5YDiUNHDBxkXW973Hf6vJO1LecJE7cqDDAD1BQmGosuH9XSvg9npN2r2N+62V/MeS50n9e+W3MWqX0+TtJOhalk7bXJNZM5BoFysmMmloPUirrTeuz3brvTY3CbhRyspxhMssqdOEIU32lEpF3Mu/gpdiw=;25:B/QeXN6QrzHeh60UnHeGbKLt94YD/XCeqwoc988NKX+KLjTD98j6OXiPwalPKLRqg5BQwCWuFcG04zyp2/IxR32uG2wxYt6cPXDQPOvlZ8z2+4Wn+fxO/J0V7BscTDH5Fh5BCq4CMW18/Vn0LLCif/nxwSmnjsaDOqzlxyH3pxiBw90t1YJDI0mJBguD6i12uWTWi8qSu1BKw3aQaTJd7M6usVlO3vFNAglEdMtm6ZAA88vkmmxThoN0Om9KkclNLlFgx4U3bErIY6JmsvxBmj4iMR5ZV+1sAM1YYr/vI+IbJbAM4NKwVSSO3PeHREXZ X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BN3PR03MB1446; X-Microsoft-Exchange-Diagnostics: 1;BN3PR03MB1446;20:+K0/8tFgokiahYhzF+9MMd0pozQ8wO4ZCOATSLYKvriN4KEtdXd90u2HEyMUQdvkVge4O2uCUgBQxxVo3sbW3dZGzEXw/BqU52nrxcWBG2jl/P/6/AK2Fh9O8YtG9JybKN3mxzW1BrUlafCQViDEDk4l3LH0UbKJxrFI6N8vhJCEcBlo1KfUF1XeomS01EcQiB+sxjIGysXyIZzKD7UTvP3dQSzzVoIn9+acjP7zhwwuYOWUnvxVzW6nO1rjVWjSxO1IRJS00fW46hG6qPwc10J5RDDUNZN1tM+K2TaaTLnW5ayv6UlrtAXMsij6Mn4KcsxKSjTc9ON1lOtZv4E99igXJ5W374F9lcc1yMDp+Rnw/+b1qtuSn0X4Wle5pM+ge0kaaSqEwUrobQdiYNpjbUuY/r5/cfzgoCScQSuJySyO+dFTnl4zU89evrpj/Sro;4:tivcvpEC9XWd4SBtaXPcy8o5qU0iKobXuQs1dIxN9NKEwcFwLMW6HRLDy+rs+fixHSklwFH/L4lM5SHt1Guk711e8TC6WbT3pAsnUaNZBzHZPWqpI03XUg/wDGiPjOHxM3ZbbgjYyL7p/IXdKuMCna+yplvoeby3XCwo4YYikSfsLJzdPWs8YZ011/z6DdA4Q2xIuLuRHZsJ9HPywO3hzEIejsC2OPOhtmYvZeZWZogUbLOmKuQ2DD1CRk8NrFn7Ziz1+P0qE39kfirXNyBy6beR6JiJQdMSYwS4LnGrNKDprRjPE3jxBQw2VPFFSYejJbiJ8e4iv390lbHjbCT243xQBiFIBl8LRkL25s4sMxnVSyQ82A64K9lQwsj20SZb5oxTDeojd+p2J9G9AvKXA1thfH1jCHk6drvgFHwzlzt3vq+woW6gKqeq+EzvzYPmIu3wsveWBURTsulxmDad0qCPzfkVL31xEovaag6gyWe0AjZjakU5WMh8smWUUHr6 X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(101931422205132); X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(601004)(2401047)(13024025)(13017025)(13015025)(8121501046)(5005006)(13023025)(13018025)(10201501046)(3002001);SRVR:BN3PR03MB1446;BCL:0;PCL:0;RULEID:;SRVR:BN3PR03MB1446; X-Forefront-PRVS: 08476BC6EF X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;BN3PR03MB1446;23:biUUzGePZSFk9ftlYdx+TpTp2yPNM+YoMTapY33+y?= =?us-ascii?Q?1I6yd7r65L32ZEf+zSP0rEeoTYcZ157tBjEaErhX+VinsuBko8R/Gb0JG+5Z?= =?us-ascii?Q?YBhcuD2blB0UYR9w6SQafvXaTcfynbv4kkGoAKeSEX/XWpkelZE0nSVs18pI?= =?us-ascii?Q?9rNtJRok+plEYKSwvcNty0KikmtIRaBRKzN+3xopHqsbfHVZspKmo4gF85Xn?= =?us-ascii?Q?yb3xOWzlfORAgcLH2StvtrYTBC7o20rY9S2qWGcISNTaR2S/QofHg4wFyKCG?= =?us-ascii?Q?upP2/YLxlszTk9xWBp2wOiSfxpuNUS9pq9Va6tdqZuiiSJM979IxH8KzZ730?= =?us-ascii?Q?S5cau8lXOKnYIdD4wOfC1iX7TvNtwFuQdbMa9bz3SWLqTaotEUwcWVxIQ0kD?= =?us-ascii?Q?K589jtx7Vffvqd56zzInM/kJ6j+vflUkLAfU0rZ6LliDjYMjLMuU3rP+D1Hj?= =?us-ascii?Q?xNZ5akUiaks3RSJhHCubbK54nFIh4DGQ3AIgKJTBi7i7mueKGcidVILe0oiV?= =?us-ascii?Q?wUMhAIHh1xHyNM/Ap9tZunoyGnwTcSVBumRoky5T16z3lKF8rHE120Frjy23?= =?us-ascii?Q?4FwD4iAOEM9MuqNqKlNG7/74tKa0ahtlgw3BisKKs89him259RFA7uTWCsga?= =?us-ascii?Q?fdc46nFXk8nZNaJ6hvxhDfZP83i1ONRkFg4o0ABmVNieLco6yXzaQ2Gd4sFp?= =?us-ascii?Q?qlntRrnZHs+CuTKWzCKia3P8yc7YXo93Y//jRCH1p6oR5E5XPILKi8o2p6QC?= =?us-ascii?Q?YSQT8gjTGiD1eIuuyKTXgvvlHIr6buWc+527YFfQnaAyQ4v5Id0+BJTPsxTy?= =?us-ascii?Q?aBRXpTXGyiwcf8tD4pseYTCxvAEbwQSJ/vM7epIAc75rp1Lufh0KObeJT3u1?= =?us-ascii?Q?M52IHzbG76TprGbMSEeubM+kX1W+e+c03lRbt/Sj2tVL4m1ktjdoAJZ2n/ny?= =?us-ascii?Q?TGsrs0bFVrViqZo51z9bEUgODx4D/35TYt0JasHCg6xyP3YhWOUnNTCj+7QP?= =?us-ascii?Q?KYxHnbEkxaPZWc90ocNp6+szSp04pHie+OgkkZXknvvHw=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1;BN3PR03MB1446;5:EgzZC67Wnzf8akE0bHbK6MfrC2ifkQykbJ77WnidfgNQfg3j0T0xAE7yYTB63MBynC+gbUB4dy7qzHMIyDlMIWYx+EY/ya9hBhld5zEQB58WTFWR4xl2J+P1dvGA3Ef/tnGucURocpMEAEXQr8IVxw==;24:o+PwTJ8jPnVWxKX7f1LSmpJ6IfEgpDwSJF61nwgXJN42iStQ6cIhgs+7im8ST5FT+NJ2hC9KMCoyGrf+MfIRaujH1n9dnI4XP6LWNhI6M9Y= X-OriginatorOrg: freescale.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Feb 2016 00:00:05.1304 (UTC) X-MS-Exchange-CrossTenant-Id: 710a03f5-10f6-4d38-9ff4-a80b81da590d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=710a03f5-10f6-4d38-9ff4-a80b81da590d;Ip=[192.88.168.50];Helo=[tx30smr01.am.freescale.net] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN3PR03MB1446 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Add more introduction of restool driver and state why restool driver is needed in helping moving fsl-mc bus out of staging tree. Signed-off-by: Lijun Pan --- drivers/staging/fsl-mc/README.txt | 11 ++++++++++- drivers/staging/fsl-mc/TODO | 18 ++++++++++++++++-- 2 files changed, 26 insertions(+), 3 deletions(-) diff --git a/drivers/staging/fsl-mc/README.txt b/drivers/staging/fsl-mc/README.txt index 8214102..e9ec507 100644 --- a/drivers/staging/fsl-mc/README.txt +++ b/drivers/staging/fsl-mc/README.txt @@ -130,7 +130,16 @@ the objects involved in creating a network interfaces. via a config file passed to the MC when firmware starts it. There is also a Linux user space tool called "restool" that can be used to create/destroy containers and objects - dynamically. + dynamically. The kernel side restool driver communicates with + user space restool via ioctl. Restool relies on allocator driver + to allocate dpmcp resources, enumerates fsl-mc bus to find root dprc + objects of interest. When the user space restool program sends a request + to restool driver to create a dp* objects in MC firmware, an interrupt + will be triggered by MC firmware and the dprc driver's interrupt handler + shall process the interrupt (synchronizing the objects in MC firmware and + objects in Linux kernel). Though small, restool driver helps verify all + the functionality of fsl-mc bus, dprc driver, allocator driver, + and MC flib API. -DPAA2 Objects for an Ethernet Network Interface diff --git a/drivers/staging/fsl-mc/TODO b/drivers/staging/fsl-mc/TODO index 5065821..4892eb6 100644 --- a/drivers/staging/fsl-mc/TODO +++ b/drivers/staging/fsl-mc/TODO @@ -5,10 +5,24 @@ fsl-mc bus out of staging. * Decide if multiple root fsl-mc buses will be supported per Linux instance, - and if so add support for this. + and if so add support for this. No matter fsl-mc bus support multiple root + dprc or not, restool driver is designed to support multiple root if fsl-mc + bus is ready some day later. If there is only one root dprc, restool driver + works fine. + +* Add at least one driver utilizing fsl-mc bus. Restool driver is a very + small and simple driver, which interacts with fsl-mc bus, dprc driver, + allocator driver. Restool relies on allocator driver to allocate + dpmcp resources, enumerates fsl-mc bus to find root dprc objects of interest. + When the user space restool program sends a request to restool driver to + create a dp* objects in MC firmware, an interrupt will be triggered by + MC firmware and the dprc driver's interrupt handler shall process the + interrupt. Though small, restool driver helps verify all the functionality + of fsl-mc bus, dprc driver, allocator driver, and MC flib API. Restool + driver helps in moving fsl-mc bus out of staging branch. * Add at least one device driver for a DPAA2 object (child device of the - fsl-mc bus). Most likely candidate for this is adding DPAA2 Ethernet + fsl-mc bus). Most likely candidate for this is adding DPAA2 Ethernet driver support, which depends on drivers for several objects: DPNI, DPIO, DPMAC. Other pre-requisites include: -- 1.7.9.5