From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753285AbbLKTnZ (ORCPT ); Fri, 11 Dec 2015 14:43:25 -0500 Received: from mail-bn1bbn0104.outbound.protection.outlook.com ([157.56.111.104]:9856 "EHLO na01-bn1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1752864AbbLKTnP (ORCPT ); Fri, 11 Dec 2015 14:43:15 -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 RESEND v2 7/8] staging: fsl-mc: update TODO and README for restool driver Date: Fri, 11 Dec 2015 13:25:53 -0600 Message-ID: <1449861954-2824-8-git-send-email-Lijun.Pan@freescale.com> X-Mailer: git-send-email 2.3.3 In-Reply-To: <1449861954-2824-1-git-send-email-Lijun.Pan@freescale.com> References: <1449861954-2824-1-git-send-email-Lijun.Pan@freescale.com> X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1;BL2FFO11FD013;1:rkzUwoDBEeTtLT/4AqVTs7hUwdLTeBFJySlcUWllB/OOtnPbIOMdaw5tXD0qxHZUGxJb5z5oSdo5BbtwkPPxRwFZe1/mTGssdo5uzwrhjtQQ/W919NeR0R749Eod7jx9XMDzSFn3CZINu4m0JIt9wISmJbkBtlG9zmuJhlJ4Qwm6dYBlIJGjbLxg/XiOxriWVLJ3T8kL8ws2dOTsSfvu2CchpLTWFrcpl7Qc1z3WXloRo2ni52be8xynLfsps4WPBuW5uCXs5bCX+j10F/3iEdJv/WXsheqS3ED3SeI6eJyPd/6/k7m9ZmtH4/1e5R4U/loCj3tgFKU9tn4/+JfoVf+9b9JyNeEocJusWozx6QvMHtoeZolTFB605srGptrgmU+x0HQOwkA/afoBC0WxzV1MDrvNKcj1jJM3oPo8hi4= X-Forefront-Antispam-Report: CIP:192.88.168.50;CTRY:US;IPV:NLI;EFV:NLI;SFV:NSPM;SFS:(10019020)(6009001)(2980300002)(448002)(189002)(199003)(5001960100002)(50226001)(6806005)(104016004)(189998001)(86362001)(5008740100001)(5001770100001)(586003)(107886002)(5003940100001)(36756003)(19580405001)(1096002)(4001430100002)(1220700001)(19580395003)(76176999)(2950100001)(92566002)(77096005)(81156007)(85326001)(50986999)(2201001)(48376002)(11100500001)(87936001)(50466002)(229853001)(47776003)(97736004)(106466001)(217873001);DIR:OUT;SFP:1102;SCL:1;SRVR:DM2PR03MB510;H:tx30smr01.am.freescale.net;FPR:;SPF:PermError;PTR:InfoDomainNonexistent;MX:1;A:1;LANG:en; MIME-Version: 1.0 Content-Type: text/plain X-Microsoft-Exchange-Diagnostics: 1;DM2PR03MB510;2:o+M2MMbKmiktPRwoe1DOi/UvIIbl2sQkJl0MXCysn+QupXdNSk/NrV4UQdX2Gh5l0CkqMs7zgbCb2GJJ68xUFIzIuO41CfO0Zr7/r0cmR9VWbxLIAiEGWceVxWVWmufdthgL9L9K5WYOwxQjLOuf7Q==;3:zsSL8UmAJ0JbvjYW5Zz1E3125Lrm9rO0zeozdv7h3R88CM+QEr0yapzG5OtBgUvg8rP3dU/j660apBRNEQphUMGJ3Bs5ldHA47R3plPTd4uw0sDhexXdXhE2qRmdwztlkGk2c3Wapi2t1vuxtlI40n8eVPFFpfR9TfeSXJ9OyocTCa0jFb09txOkXy4t7LMgxoaOX+eTircRH4Gs5Q0sBvLyRGFP02S9dpQkGRrMnWQ=;25:tIQZjExnFqvS0CcgBFG6eJdssybx9Xq1qn/Hl8CaSC/GQYxs6MXjiqEMuNca1JSfqWt74V8NWHlK3kROguPnLsyeMFGXrAi1yMCtW/Rp4XdB3AVDHTnoRyDcGxl6iq84CY4gCLRR6K4WQdZJCrbxFL7i3h5mdsOh1uyBOyxcIxfI5aL1+dHp0nIOCDvpKQTFNidDnkyaKapSW2uAYUGQjgIuc7xdcpcmHxawkeqdarCQh8Gl4Q+ngNh3J5/fRER1VhWLXDY5gk6SStvsEV/Bdw== X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:DM2PR03MB510; X-Microsoft-Exchange-Diagnostics: 1;DM2PR03MB510;20:ZX1Jn0POmgClsR28BMXHoQ51lsqpsnC1ZXBRqxNamynGC4JVmi1O+ZbrInmwQuxrrFaX9V3WQWlGOwWqOVEf4WsDPSyBRzMKbCg05v+9j3F4zROmGI8Jwy9Xr5Zw9iBCGT043zX5rUti8164oYPSxnpWR54Heoiv8bai/5QuasKTyezod/IVd9c/dUb6/vA4FR/6W2pxgnWfDMb5u5TQ05tsnUK7fyMwH1fefeVAR5ILq3s0NptsWVB7vIjSLl4AmX1YO320ECHcGyoAp198d21hwS4AQ/NwPYgfCcdyUg/u+p4JPiX+lLDS52xXJVtoIpQMgaQO//WNi0ZVu7gvzU4bIQ2tGv5WkOhE9qDqw3o=;4:B/IIYnatJiB2NoXdMAXqXcUwdnNq8CD4LwxiCP1T6iwSaKrm3Z60HLQW20ZoMgZOfY7aiRPJjQi/2JtBmP2JTTSzlw4sWrGs0wL2AqzSGlNRmxOnxYS4cCIxoB0U30s9lfFHvSF0jKeXd2tSwpgQ7425ZQZwVD1IGcJ0d8RYa8DYN6YBbvqLL0FvYJHOOeSrXt1Dd6g4285wMVSRelsJpJKQhL87kscS1tU10qk/aQfVMXn/szTv43p7PrLqpuK9/+M3i6WoaXTD3uTrZAx2y/OFFu61TKX1Kya/a0P5AdxUp2E7SocRXkwaWBi0xommrUnWJdXnxY/VJVTdDJd9AMFXaqfq7b+C0uPXpaF3qrnVXZjtNxtFaViUsLaT9d3aAfjxfOzdupXtnoIuKzDpgagrH8Eqn1+mwCWLvcn2EDY5APkDaJxLG/2hLvQPxhL8 X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(101931422205132); X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(601004)(2401047)(520078)(8121501046)(5005006)(10201501046)(3002001);SRVR:DM2PR03MB510;BCL:0;PCL:0;RULEID:;SRVR:DM2PR03MB510; X-Forefront-PRVS: 0787459938 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;DM2PR03MB510;23:n4PWcMLjEVjdSDef5UfxQ3NNJf+hNwBWQ+hOQeVqj8?= =?us-ascii?Q?4WNUlrhpbxwLdWLrZXAJ5Zc/J438PnKN1SFF4txdFl9tctbzfTd6pJ6ueaaZ?= =?us-ascii?Q?fhkyydzlvAoLMuI7Sywm9IXAOpePWoN+X2DW6HkUJ3qYALJNJwsXy2kieu1B?= =?us-ascii?Q?mpQ01vVuQeIJtuj3YO9g5YIpHdek5ey6B5l+5EC5TkN3cd5MnutVCkQt0Tv2?= =?us-ascii?Q?1LJGhOQeJFuY8IRgEsTyJSh9Dg8/mcZ1L7UspmRt+bzNHY0XFiWC6IQXz1SO?= =?us-ascii?Q?g1FconGtF/A2Xm0z6vOwInhZnSscuw1lJJ6sFELoKLZPpCr70ILmE/C68U9F?= =?us-ascii?Q?ddobHc2r2nh+w39n1srDMbiNJBx7eWMfB8H0Epxf6pDJFvnXeODkH2qqmjTW?= =?us-ascii?Q?2j9M2bkgdY3Zm9EepeQa/wbuHdCDsHeYERtnpuGUB93LVp+K6XGTjG8EwsXT?= =?us-ascii?Q?4AdVGWso6Boskc+CSQL2JZXckqEAexOrD9/IEnD82dz3L4dE1s+lfbbLybUA?= =?us-ascii?Q?2G5XNCgBtks+Wa9TvVn0gHkFYrjSBd7pU4saAW33v5SwSpYjpDCuGJ6iofMh?= =?us-ascii?Q?MkjzPay/VLEkIMZ5KXt0ki5oW060XPe5jZlWUIFlWt5q801FWGJAmbKhVKfE?= =?us-ascii?Q?XtehNMctEA8cKG/mbeiB2h9h6/ozMNeWXKo5xtK0Ejfnr3wF9xtzgAg1TSBP?= =?us-ascii?Q?H8Mv3e3opTJOMK3IhqNm09Cv3G3AEtqJ/Di+ZjkATZgKJRdwLGqiPmaEsdkz?= =?us-ascii?Q?LwNqez9SoIhu1gmkx2DND18OCn3QK8jg8AOXAYdP//1FbWw42SE31tsV8Xyr?= =?us-ascii?Q?sG7arJExe5zwlhWyNK3dlv6BdfuPJ1uBDB5MEscb8FcHbaQ7canty01A8CcW?= =?us-ascii?Q?7/4KUYl7CqyekyTQCAWnlw2GRB9eJaahGd8e4Z20AebJnaj3Rl9qtBv+P0iD?= =?us-ascii?Q?veHeF8OibCQQm7/6P+w0dGuyXHM8A2/uTi1J6FMRaM/ZOEJdfrdXZ3qlwfay?= =?us-ascii?Q?ISrarsMtBIQxdhHVn40ui8+5cuBK1eMMYmjVF1fF2zrOfGkEhm0dIdpoPNRA?= =?us-ascii?Q?RTZ1I=3D?= X-Microsoft-Exchange-Diagnostics: 1;DM2PR03MB510;5:0JzRgfyEYaKiD183Hii3i7/QTaOIyTg0YZWD+GqGpiMZSOh+7o4sAIwW7jFK/yNor3Q30KYKh9dohIBCobZNpTpTls+zTkacvvTnZ1koPHSvAADF5xQ30KM1yFg39wmLHXn053iQ/708pxL+8RqRxA==;24:LkAK9M3dA0LEIcBHrdR/cWNK1wN6jfbTT267W53mQTGuGPBQtcRqOiJxvcL1tx9HLyHm2zVJhcFHpcfl/UG7plEV2hE3gd3nKcsCgLb4JGY= X-OriginatorOrg: freescale.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Dec 2015 19:43:11.5491 (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: DM2PR03MB510 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: -- 2.3.3