From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1760712AbbJ3TsI (ORCPT ); Fri, 30 Oct 2015 15:48:08 -0400 Received: from mail-by2on0114.outbound.protection.outlook.com ([207.46.100.114]:17636 "EHLO na01-by2-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1760107AbbJ3Trq (ORCPT ); Fri, 30 Oct 2015 15:47:46 -0400 Authentication-Results: spf=fail (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 v2 7/8] staging: fsl-mc: update TODO and README for restool driver Date: Fri, 30 Oct 2015 14:32:09 -0500 Message-ID: <1446233530-8918-8-git-send-email-Lijun.Pan@freescale.com> X-Mailer: git-send-email 2.3.3 In-Reply-To: <1446233530-8918-1-git-send-email-Lijun.Pan@freescale.com> References: <1446233530-8918-1-git-send-email-Lijun.Pan@freescale.com> X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1;BL2FFO11FD023;1:aZW1R52unxdanqRwxkMYYT+pJtW8gNqMh6NvrIH9iYB2F/x0plpeoXjUcAUjzH/FImCKsvJSJny5ivcAlL5mffw944fUUDa8a4Hoxcx1EwKVquaCEMiu09ncNBleNUApKzzGoio41r0BNBWHbyoo1IGobOxcKx73kM2ucERYIwtaLs+3qk5idkZOOoeltl24XkcUxh8aF2vqzF5/TyzqyiPfsbrvN56zmW3v0NlRkTaoGTCHX/0K42NX1Xfg2aabqpxaR7vugdokHklUQ4YFkm/5o++XuT5wOzbIVig1pULjLKth/hRpbxAJcTTu12l1dLNfrVuTN00UirNcNk2ZPDpigvcx6Q7KLoeBCn/X/70W09QxjNK7UyE5UFPELuMCy5cwyVBrSv3Tbj2GkqUQ4w== X-Forefront-Antispam-Report: CIP:192.88.168.50;CTRY:US;IPV:NLI;EFV:NLI;SFV:NSPM;SFS:(10019020)(6009001)(2980300002)(1109001)(1110001)(339900001)(189002)(199003)(5008740100001)(97736004)(50226001)(5001770100001)(85426001)(2201001)(81156007)(5003940100001)(6806005)(76176999)(86362001)(4001430100002)(19580405001)(50986999)(104016004)(189998001)(50466002)(5007970100001)(229853001)(105606002)(77096005)(106466001)(107886002)(2950100001)(48376002)(92566002)(87936001)(36756003)(5001960100002)(47776003)(19580395003);DIR:OUT;SFP:1102;SCL:1;SRVR:BLUPR03MB502;H:tx30smr01.am.freescale.net;FPR:;SPF:Fail;PTR:InfoDomainNonexistent;MX:1;A:1;LANG:en; MIME-Version: 1.0 Content-Type: text/plain X-Microsoft-Exchange-Diagnostics: 1;BLUPR03MB502;2:YIGi6EO9zonxcjHpAj5reQTkB81SNBQDYdYGjeIElSiR/C2vDgFYSbMKVpXGfr+dCXr1At//tFKX7DTk3S+kDUVw0rqiYWMUuYwzQCCEqGafFKXRO38MXKyZSVDwb3JqHivXHJllFKGABE8AILMfnIS9j7GxvrbiZLEi8jCLMcE=;3:2Fc7rHOOvw83KBDV880LBWNEuB9FaE86aaaVDzZBsk6Az6mb1FYiDyHdTxE/yvjO13KdWEQFfKN1ujmXV85/y+HzN+DGKQi1DnvF213MgzIP5HBX8k/qsTV27IuNCB4GTfShgBOWQPwq9iP8n8cFDRJqvst8/VeaVLosz4U+KX14KD+O1/jye2sN18UhS24H2ptyTASoeNfl3+H4kBgvuMKPZHWD1BZCTRiff3fZBs4=;25:NwlVXFBETVK4L/aVjzwpR6bLWImtepLckv4p8Jk5vgQieCB2t50i07Qm47oHA4kZOK0ZO+1MIQRFtfQvFmpROp/zf6pFnXwQf1sXul/fCW/HKV0Q2FRbHE4H4GJonsFlJNaPmKkFV6lgg1ZUJ33b2cvP5TbSBV4QmFDcLRn2egKnVCGedhgavvqhf6ce2GHVJAr/PfQAAaL32k0xfxdeLpB7dWjsKz54j+z2QhV53tijSuS8DW6WqAfP/sWtOe2aWU+QkWSh84rlMmQ34rOB8A== X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BLUPR03MB502; X-Microsoft-Exchange-Diagnostics: 1;BLUPR03MB502;20:GYL2TKPDP/po6yXFAC7WKM7logb/EGL2V00Rc3y+1hW/5w8Zm59kTcaOQIQOIQ/LIqCGT47JxaU8eGvWsWz25Q+UXXBgHCzpK9kual5ka4GFaEv8iGovbnUec7x9kJY3ZwGeUG0HPsFKyHUQDVQuQvyjroaofWGJbP0feHOf7WG+U1jq3MUudlS/f9zFcgNJLoJdERPIYthKA1HlO02mtpgXd/N1GHd8ic2m0AFvv+a5KC4x96NRvwd1/5uYKXGklgk+QnQ29uYZFgHFOzWlIXp5U0qV7tfMg2dse4zrlkHtqSlkswr4QURbAj/zLVg6grDCh7Juc1CrWIJ/Xe02j23z2BsOHB8SdzRluDF3TJc=;4:9uq+ipRAlJbC0+r35s+y6TU01sK8kd72gqj9QWm3exv3m/eL3i9/i24KGvp6N5nLiy3lXKVphukXpDZMd8i/5kn+lXUGapK+mqHC0SvxC8EUCUw7HdKpGMsJwnXV4BtY/iF/ma24ezSgZeDpz3bPhyO6SS5PJ0+uQIuQYmQSMka6FTcUN0sGPEhpORGmmj+7sRgqdqwChyPyYc2/lVDVKjVa9bCM4UYfltC8vA1Ev8Dasl0FVfB/0w+Y6uwbAHm7uCjQrt/QubE3IxOCQVd9ItltOmwsXbz/sOgSOFBzgdnltaPz3UCMjBVFtbIsZ7/QdSxbNhLd/0tvfYYqpghYl18uEkbuu1vjw1k4GG/xfhdLo1mC7Wi000vbbubagvrhEnXX5TbSWswcON6HaJZZVQ== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(101931422205132); X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(601004)(2401047)(8121501046)(5005006)(520078)(3002001)(10201501046)(102215026);SRVR:BLUPR03MB502;BCL:0;PCL:0;RULEID:;SRVR:BLUPR03MB502; X-Forefront-PRVS: 07459438AA X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;BLUPR03MB502;23:hwfSL33UVXAas01gCMwTIqe7HelJsWMo5ibLfKOlDl?= =?us-ascii?Q?f3ToWxy84EtjSeFegU7+GVWvkAAXAXVKcqpUrjsizqnZMJ2+n0+UIzeI7Me3?= =?us-ascii?Q?QrVnNmT31/YT+h0nsgFKw5EnSisX4qH2MWNgAyxu2ktzmySXOPz9laRvTmly?= =?us-ascii?Q?DC1UPvGgztYwtfACnRrxNHLyMC9R+wH0eEiz19XdwnsItx3n+cQ9fsUdh3+L?= =?us-ascii?Q?xaAXBArmvy3uik4smUrVmKBkw6oJJJXi/6kg4XPSQnjqRa+zhp5XKLYfB7YI?= =?us-ascii?Q?dLQyvVj1xgmBKJVqQhAW0GG1KvdJmRpuFY1UcKrBK8xeEHV49rjpNTz/CPXH?= =?us-ascii?Q?yiE1UiVDhMyR6oqSk2jEgu/FM/xH2QwkJAG/G2vYVDg//0A5zngy2PM77Ll+?= =?us-ascii?Q?/VkHOJjeISBiSJPnYQXxk2EjJxBIlqhBpViBOxzPA0b7YKnXdag5HKcPfPcf?= =?us-ascii?Q?yMh2qQun337MtMIOMDWU0nsk4RAaMELY9t1sxqN+hMqS3yYUo6x95FbJn1J6?= =?us-ascii?Q?S0ADljMG28KHjxJusuosRd+eyXwHaNrGFytyjoyHDelUqZ2ThbvTL0E3kUbG?= =?us-ascii?Q?FTnlJmxLMgzDMCstzXQ8BSeM1/Y13e/H3G3r3DHX/GUhX1fWj9rqboD0VXw5?= =?us-ascii?Q?wS1IyLIEMnuI0u1Xj46IeadmdaT8zQcmL2n9JzYYAwK9E9cU1ZdifRsO9qjC?= =?us-ascii?Q?71lKWRhdTc6pvARS22FnId4Pc+7aM4M7yVNvOioiu6dntiHVzNzhkFNNu9j6?= =?us-ascii?Q?aTPuu/GZd5EyOSUvTEq7C2cdJzHHrxnnbsPATcDqvtZ5UJqGYXaynd5KaGvx?= =?us-ascii?Q?R0ID8dkE0DXxo1ouOYdhKI0kaz9nIbHmiFOjCl7SvKqw/2/6Bo/DHTiyvFyt?= =?us-ascii?Q?7pUhDShsrlQvjCZbeg8RfxKZsbG4CjgwoBMqZNubwSI0ktcD+BYpOuL0GAc7?= =?us-ascii?Q?d4uYYogg1wqWuVKci73nQbAoeNKlSJBP6gI+lI/bXzVzK2MjRAXQgS2X7pfe?= =?us-ascii?Q?BtNJPPweMEZ7bG+cRetx3hIzw///d1KS6mDeryweGQQauHH3+FFjb65YBpMc?= =?us-ascii?Q?FrnD4=3D?= X-Microsoft-Exchange-Diagnostics: 1;BLUPR03MB502;5:vv/8crcEYUUNcE0xu6TTRbKpmmaC0Z+Ezbtvx+ctex4OdypN8KLbrI6RpjnDBSFVyLvxATXgpU1m4rm76hem/1fLC7gfmoulcoy/U7BSRw156NwhqZmAF3lKexflieiJxW8GfxjvWV8V26iaRjbcpw==;24:2Yg1yqH6S0wv9beDFg6BPEwSWMW94wUCifVXcQUpGhRUSGkMaGhWPQxobY/ndoH+nRx9pB/fbhEVdZCWlG+6yi3ZwToup3hKtsTCMQDR+fU=;20:etzDuxam4hx+vsgk/ic5gJECiVq+7cyo9VBR2AxHOj9Uz8YFD93RoGryilUaxqt0+ygJGw3ZA685XEWP+mbseQ== X-OriginatorOrg: freescale.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Oct 2015 19:47:42.9404 (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: BLUPR03MB502 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