From patchwork Wed Sep 28 18:21:50 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alan Tull X-Patchwork-Id: 9354563 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 35A7C60757 for ; Wed, 28 Sep 2016 18:27:14 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 267D0297A3 for ; Wed, 28 Sep 2016 18:27:14 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 1B0F1297A7; Wed, 28 Sep 2016 18:27:14 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.1 required=2.0 tests=BAD_ENC_HEADER,BAYES_00, DKIM_SIGNED, RCVD_IN_DNSWL_MED, T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.9]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id F3014297A4 for ; Wed, 28 Sep 2016 18:27:12 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.85_2 #1 (Red Hat Linux)) id 1bpJXq-0003gj-Ud; Wed, 28 Sep 2016 18:25:26 +0000 Received: from mail-bl2nam02on0049.outbound.protection.outlook.com ([104.47.38.49] helo=NAM02-BL2-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.85_2 #1 (Red Hat Linux)) id 1bpJUt-0000Iq-K9 for linux-arm-kernel@lists.infradead.org; Wed, 28 Sep 2016 18:22:34 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=altera.onmicrosoft.com; s=selector1-opensource-altera-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=Ro7jo+n3p6NDanfxE+dnzLuxWNNGTmvlX/vEvsKRlrw=; b=KL7nkxTkFwBOYH1/BfA46xcb4gvLE0WkujNizyo00DRVNkO+oOZmelWuonDJSssuj9uQXaOcSXJ7rDKFM0jMZ3kyxWUM8fvFmoS57BTdExZL5ocLOZVzEmmxJ6AvlT7wD3W48aYQzbhBYLkcEtooKVj2FjrHQjtVqJDg9jYyjAM= Received: from BN3PR0301CA0031.namprd03.prod.outlook.com (10.160.180.169) by CH1PR03MB1916.namprd03.prod.outlook.com (10.164.115.156) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.649.6; Wed, 28 Sep 2016 18:21:52 +0000 Received: from BL2FFO11FD008.protection.gbl (2a01:111:f400:7c09::178) by BN3PR0301CA0031.outlook.office365.com (2a01:111:e400:4000::41) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.639.5 via Frontend Transport; Wed, 28 Sep 2016 18:21:52 +0000 Authentication-Results: spf=fail (sender IP is 66.35.236.227) smtp.mailfrom=opensource.altera.com; ni.com; dkim=pass (signature was verified) header.d=altera.onmicrosoft.com; ni.com; dmarc=none action=none header.from=opensource.altera.com; Received-SPF: Fail (protection.outlook.com: domain of opensource.altera.com does not designate 66.35.236.227 as permitted sender) receiver=protection.outlook.com; client-ip=66.35.236.227; helo=sj-itexedge03.altera.priv.altera.com; Received: from sj-itexedge03.altera.priv.altera.com (66.35.236.227) by BL2FFO11FD008.mail.protection.outlook.com (10.173.161.4) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA_P384) id 15.1.629.5 via Frontend Transport; Wed, 28 Sep 2016 18:21:45 +0000 Received: from NAM02-BL2-obe.outbound.protection.outlook.com (207.46.163.85) by webmail.altera.com (66.35.236.227) with Microsoft SMTP Server (TLS) id 14.3.174.1; Wed, 28 Sep 2016 11:21:29 -0700 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=altera.onmicrosoft.com; s=selector1-opensource-altera-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=Ro7jo+n3p6NDanfxE+dnzLuxWNNGTmvlX/vEvsKRlrw=; b=KL7nkxTkFwBOYH1/BfA46xcb4gvLE0WkujNizyo00DRVNkO+oOZmelWuonDJSssuj9uQXaOcSXJ7rDKFM0jMZ3kyxWUM8fvFmoS57BTdExZL5ocLOZVzEmmxJ6AvlT7wD3W48aYQzbhBYLkcEtooKVj2FjrHQjtVqJDg9jYyjAM= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=atull@opensource.altera.com; Received: from linuxheads99.altera.com (64.129.157.38) by BLUPR03MB1508.namprd03.prod.outlook.com (10.163.81.26) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.639.5; Wed, 28 Sep 2016 18:21:39 +0000 From: Alan Tull To: Rob Herring Subject: [PATCH v19 02/12] doc: fpga-mgr: add fpga image info to api Date: Wed, 28 Sep 2016 13:21:50 -0500 Message-ID: <20160928182200.15800-3-atull@opensource.altera.com> X-Mailer: git-send-email 2.10.0 In-Reply-To: <20160928182200.15800-1-atull@opensource.altera.com> References: <20160928182200.15800-1-atull@opensource.altera.com> MIME-Version: 1.0 X-Originating-IP: [64.129.157.38] X-ClientProxiedBy: BY2PR1001CA0078.namprd10.prod.outlook.com (10.164.163.46) To BLUPR03MB1508.namprd03.prod.outlook.com (10.163.81.26) X-MS-Office365-Filtering-Correlation-Id: 81f4abcb-76ec-40f4-62af-08d3e7cc517c X-Microsoft-Exchange-Diagnostics-untrusted: 1; BLUPR03MB1508; 2:cHv3S5HdaM3vpd4Od+DzWo37p23QpPE2UB9ghpP6vuR79SH4xjaH21rl2tcpSbdkUZ2gKW9mUT1H5m+UYK4dEYQAy51/09YLqiRPzOgYKMTqRbtVhikMkMRpso5OYIDxPcrNhavFNwWZ1hF+pXuDE6PVlGjuMY8K93erjnfammUTZALooGm45Q3vfHp7zlJh; 3:biHzL0KvK3VQnTaDrvvaRIwEJQy69pzbJipebjzR6ad9gvT++0fmCg9OPUvUJl8E3IX8lhKl2tKwYN7cjMq6OlqnsL8bvF2m88BuoKqvsvnEkmUQqJn+gjcB6eQlwUo5 X-Microsoft-Antispam-Untrusted: UriScan:; BCL:0; PCL:0; RULEID:; SRVR:BLUPR03MB1508; X-Microsoft-Exchange-Diagnostics-untrusted: 1; BLUPR03MB1508; 25:J2iSqYvH5jqBvMsLr0IL1q3Cf8m4b/xKapecMkSJOTQQoU49wrOpP4zX8s2dvFwPW5GC0gyy02TcDtaIGX1hkzVvfl82O96QTsQDzvOmJjGW6WtSNx9w6RrrEcnT1qPTnqV+mZnABT0JFZJSi1mh8qUv7rIuRbACmOiz8DiNRrDgEyxIUOeBoh0398wV9Icdj3jqKY5K574jEBe76yu2SfiQVi1y/Ta1ktDdHo60a/iW5LMvLPPzBeVh8wFBmnvNr5uq0Sn8ncJpHVGVdRBHyrqZX96YeeoU3Q1S7cwhTsGsY2APw7SRZBES8z4HWceVRk/stSCwj5Uzg3hCPUja/K3WDasmCpXenpDMrDpWQILCZ/zNEIf1XcDnaMwRl0YSeJZS4rXRuyY6DQdruUSkpFDUbDJ48+DbW2gPiHtqwsiOMPiKKa3grRz9x6xktkSfSmpHz2Uo4MjfmqqJu+h2otvzmFIU1j7tbrD0cylWN4ZYVXZV2S/5ZHY45MukVqmhITVuT/VoIFTfVsH8sNXDSbYgAEHW80XmDg+bIKWyQsql6i8VjuMV65A9vq+TIO2sOE+X31N5m0VfoC6QbO+E3JHbIfY3OuhF5932Dc0xjZySOHhBs6Hob2+k9bZW0xQvL9UwdDSxG2PyY9GxCx7fNfBuL33FSy5AS+blLxbtazzb0KduNBKeZI7IPbSRIA0aLko9zZY2rKykFNvADSpEyBpbmJxYhHHKf6Li3pvZRqs= X-Microsoft-Exchange-Diagnostics-untrusted: 1; BLUPR03MB1508; 31:0UChPpiG7Hb2FEadKUr6ZfTqdTa+LyaRAsukwGBu8MBUvD0fbolhzFdySrTEDqXZS6eqWQJXdsN/JLi+le3iRDiUARJl/c/J6P+wUljTR+hFQL99tHx50j+3kZAVa4E7bAArJ77PAwGF0ucxVOkicT6YjYq9WfpgltWX8qm1GIFb4Cwq7QTxazbiIYbeVhUjaKQQJNmM8ow8toM7LlOVC/Z9dZYN9NT3K9meJM6E7I8=; 20:deZINqmegAJ/W2vFCHFZbFlGDPMsQ8fb/pd1gaTglV62N4sjtsiv/6WFu2WZ0Ux0Mf4kVxcHHBAgbEsz3H1GPXp4PSD29WsQXuqEy9weaz8vtevD8S1Ku21VnzKNejvgLOJBa5SSa/H02g9lFTLV3Ucdh8GMeEKDIsejLaOzFRo=; 4:TDftpcqHuoI3/GFBTXuH2lr/FL+fTuIxlztraWhPi3Jlk2UFJToZUet4cTvtlSAA7P9snAvTpch5QmpFivMnGRJGTfr2ZJQf8B8H7EqECFXtNc7BA8w1S/MPiy2V7uEdw0b5kd4ucQc03nyOPyyK1dpJ6+9lfNF4CgLGRlqk8Ih9/rDwP77abLukmaxaScvjZMdm4Ohh+bMC5RlZqK+fDpRMST/oo4LAp/j/eFGvW3TfT8E2MKemDObEZ9LDtKq/+Pv2ZzY7FW3Da1Aa7/AKqIromIAIM0NLrHcxBxY5uvN9/mkuUaDcwzBjE+BsYAPPq/yFNSqrJwYap3fgYYQxW3hGCPUsFBAjOLa7oW8XVv+AMEZehXbQKYSLDklyXjoivkCv3GCb548OD0Q02QzC4bg7GYirtb5gMjeqzsGbOXK+PoelhaHx6j7eEVhLwm2NRzbv2VUaj7qMbpsCRSdZEQ== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(80048183373757); UriScan:(80048183373757); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040176)(601004)(2401047)(8121501046)(5005006)(3002001)(10201501046)(6055026); SRVR:BLUPR03MB1508; BCL:0; PCL:0; RULEID:; SRVR:BLUPR03MB1508; BCL:0; PCL:0; RULEID:(6040176)(601004)(2401047)(13024025)(13023025)(13017025)(13015025)(13018025)(5005006)(8121501046)(10201501046)(3002001)(6055026); SRVR:CH1PR03MB1916; BCL:0; PCL:0; RULEID:; SRVR:CH1PR03MB1916; X-Forefront-PRVS: 0079056367 X-Forefront-Antispam-Report-Untrusted: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(7916002)(199003)(189002)(53416004)(97736004)(189998001)(107886002)(19580405001)(86362001)(33646002)(19580395003)(5660300001)(7416002)(2950100002)(42882006)(76176999)(110136003)(101416001)(77096005)(5003940100001)(4326007)(106356001)(92566002)(50986999)(66066001)(2906002)(42186005)(48376002)(1076002)(105586002)(50466002)(47776003)(586003)(6116002)(3846002)(50226002)(229853001)(69596002)(4001430100002)(81156014)(81166006)(7736002)(7846002)(305945005)(8676002)(8666005)(68736007)(7059030); DIR:OUT; SFP:1101; SCL:1; SRVR:BLUPR03MB1508; H:linuxheads99.altera.com; FPR:; SPF:None; PTR:InfoNoRecords; A:0; MX:1; LANG:en; Received-SPF: None (protection.outlook.com: opensource.altera.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics-untrusted: =?us-ascii?Q?1; BLUPR03MB1508; 23:uNBQpZIFopzcEOEtlzV6P2koCWXBFaAJDlcp6Ub1L?= =?us-ascii?Q?YAgMEDtYncALonYdM73bsEk4IWSwQ4ZNd9aqcAEAPPPkXsmUJ6U7voIDi9vl?= =?us-ascii?Q?8P3/DOa5ZpGCyuBV0B+FhHwkqCymnNgN0BltnGzGRlo3I4GDI2SeVABDgkL0?= =?us-ascii?Q?NeJjF8NXdzt1rJw1VaM6hu/FT2frrjSJmRCrESp5quAG0RJDmQ/faUmT+Min?= =?us-ascii?Q?ROqdhr3VKP/FIiMXL741pPR0VRPRINt5xZZziz2ixr1yKqK7a8UqQIaA3xvE?= =?us-ascii?Q?k6Flc3R4WcAg8kL2IDDUCa97AgKUTPgkIze+Bv8NsdjupVzbiG0V77yME1C5?= =?us-ascii?Q?kH5h7XgIrY0+RWeO8aDtKEDd6DChpyDA6dD4u9vQerZIiT5gXS3NJ/RDl7Xk?= =?us-ascii?Q?7IdBESmcAlLm3ozKe5GVs8t06uqC2EGKKhzevbDkJPZeGXdfb6mZC1WndlUF?= =?us-ascii?Q?gGc3Df5W+V54LHL5QKx/i6ODgDLt8IoDre+04GhPPEdaqfoq1WV7sLEuPgs2?= =?us-ascii?Q?hXdCAM31k/sluqpzRZyGlU2eK5ME8Zyc96nlBsp11yQS/KVYhOdlsYEK+pgT?= =?us-ascii?Q?6pyPBedeNCX49Ql34t5c5U5zMFErFb/REMf6PBs5RX7hZJddQSkwJOHYZmkh?= =?us-ascii?Q?MyBdA9OlJXdJyWpPeDWU76/BMXdaZTcglDOh/khieHuaFXI/lz5jdBf6azEO?= =?us-ascii?Q?dEIbI9xxXOgbXq0yZ+TChwP3IX99m4qdP78wspo9UvLNqUg/FnYt2PAofh4A?= =?us-ascii?Q?RrR/BLzZBs1A4lWEVA8QaY4Ca44LDYg0Gn5sodC0+nc9e7bY9lx0N47GHTqU?= =?us-ascii?Q?bl97NkpNhBYqf1x9EZqlevTKOq5Oab74nPGfhvu8LrphiCr6qZlpZI3rqtfk?= =?us-ascii?Q?Z0w1zUdRfpIb1OCZ71d2Q29AbXhvgYY+AaB12WS9A/Ez+300tCy+2KmkM/gN?= =?us-ascii?Q?Yh8y41LrifToFo9O2dr5nwkn0z3mAFwThkZEI8w+DfLQgYUaPcTJqfbw46lu?= =?us-ascii?Q?vkUbD/obiVFjiQvFVwpzawBv23ZduCp4NAKBaEC3ouoLrOlzf35JCYc2DAsO?= =?us-ascii?Q?dZIjHCBj8nec7SnF8dPea+s/lC5uqMrSn83+54XNNWGLm9zuKa01ArD/YKY2?= =?us-ascii?Q?MPI+xbMkzZAS+uME8phefokDSnR/RXfXeuV8tz4kHm/sCEHBuj0Y+6LRlf0y?= =?us-ascii?Q?IflxqX4qZlSc7wPIJSaGVRWfaSdWadC97/W?= X-Microsoft-Exchange-Diagnostics-untrusted: 1; BLUPR03MB1508; 6:uEGvYzEMv9tAJGIH5e0r+2p+gXqyqCuqmtY1WZE+GJmTaZG5WWy6FZGsVbPzXNyT17tZgQWnPR79KsrpPWEl33CcMFr+FWENaVX9I+YTK4kUJU8pWBicjA8ZWHcagTzNgaUS6KZlIV81QpXmYq/3gPlJWK9XCdm3GsX00NCWknlMDtCi+zwaaVpPIwPh2mNDpd+pfj+gfwAn3170BFWt3dz1GTmJhn3cUHu5lVnhfBRZgQYQzDS91y8pQoOvWKmyis8PeiAaoYkjR0M7ddj6nr7F0S/YTF1dG8N4iDVgBPm1zInRKi5R+3O/4kdrIUTRhp5fqwG0l1Afc5/h5Ywh7A==; 5:GeLfoN78EfAESN7Xin1trk7RawbojPh5FqlcSmtmCHsmneKE8cCkedZY3eG96Ph9A5o2OP9Q8PIe5vNXGN6uYC3Vz2x0azPF0QECL8Cam0aEA5prURK6G0KDMGKtbEjq55+4EUHUPbQvhUqnoY/3kg==; 24:aKmgEnmMQaznVp3kjmMmvBlmEMglGf9V+Rb/GW9RYaRbCLiWNnmpq/B8qeftI+MPnpHkN/KmZ0eqRkHl5yBfQ7OFmB41B6K17vioV9HZs8U=; 7:Uz4PaJq3NEhKQjN0HjHQEHPxTEfN/+VevVAhnJLxgQwg6c+3ApBrArA83DfGVcEmn9GLu8sgTFYgWYJ8JYLAghITYofnh5d2CROVqvdy6BvC174DiNfdR35puBJqvi75nLdK8ZW3RFyfeSJScllOMKtF12iBaAa2zktnHA0iNHF80KTCddsONsp4PP6ZRdVdKuT6pVnqxvyX8Z8H4rfwgSOdfnHRO5HxDLgIIlVVvQU3Um1gRLjI3sG18sZIotpcex/BOA2Js+eRBl/4mP5bXEepRUAht4mTk0gdnnZjM0fpJ0HeQfUndmy+2Y/yMjHq SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-MS-Exchange-Transport-CrossTenantHeadersStamped: BLUPR03MB1508 X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report: CIP:66.35.236.227; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(7916002)(2980300002)(1109001)(1110001)(339900001)(189002)(199003)(66066001)(107886002)(47776003)(956001)(5660300001)(1076002)(586003)(110136003)(189998001)(85426001)(2906002)(33646002)(97736004)(626004)(48376002)(4326007)(16796002)(42882006)(7416002)(2950100002)(50466002)(4001430100002)(6070500001)(86362001)(336002)(7736002)(92566002)(7846002)(106466001)(3720700001)(229853001)(87936001)(305945005)(356003)(8666005)(76176999)(50986999)(5003940100001)(77096005)(19580395003)(8676002)(50226002)(53416004)(81166006)(19580405001)(68736007)(105606002)(3846002)(81156014)(11100500001)(6116002)(8936002)(7099028)(7059030); DIR:OUT; SFP:1101; SCL:1; SRVR:CH1PR03MB1916; H:sj-itexedge03.altera.priv.altera.com; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; MX:1; A:0; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11FD008; 1:puliYU7tCl+ePT2wJCmuZb6PIK7l8ilMIWOW3aE/1MmgzrluFxoNyve86Kbesy4aJYHaCd/Aqb3DjC4AJl2thvUktCQShuZKjPXpovtDsHvniWVAfaAKJXmZ6t9AobThpo7GqYXoTmXJgecjoS2xn38+feT2oX/kjZZ+C5cMf/VnjXV6XG90Sio1TYvGqNhnpb8SCGR+YWTgQ6Lu/Un7LJXwRZJWrda7izb10jJjqisQbDrHGWEXIAueHnLPgLmPXW4iUDfyMT88h5uAMrf9+f3Woee/L1yzyxv1zxjjdntsQ2iqMyuVmuk/Kgbmo0++pzbfeO6zf6Q9eoNnaZMdgtRQLhr2A1i6mbUFbs7kjAYv4D96NZNxacYp7hnHWdeGaE7dGSQvH8b4dDmdMXnQM6IZD5lzcQRcBzCi3nExAAxAjx42FOOSTn4nuEE/gwctdMeL/7iJ8TIxwGTmKfetOBY1WSzPpzryPUUa2XPWLgHzx3+9QvyBeKsVBndkGJLcLwTQPX1kNlmbnWPjWMY87x1YU3bkUrmHFrkQTsF3BwfdmWAq1VPfMqqLizYyfw8CkOatnxfF+ZyGjXSrYM2P5JyBuQ8OvS6DhVv7EMmEFoY= X-MS-Exchange-Transport-CrossTenantHeadersStripped: BL2FFO11FD008.protection.gbl X-Microsoft-Exchange-Diagnostics: 1; CH1PR03MB1916; 2:w+GwAhCSmkjtXQzDfkrkRQkkETL3dlCpghA3TkCjg+kGxdUWilL2Jj8beHfkPWdRabLC1Y7bK8g7Pjmr6J32bx+AUMFFUg6Qq796SPYVCr9tEqaSYBB/rX984eJs0JKMgm6dHH4LZVjhx6inlPcwtZN4rS00uBEj1CfL7xmVH0rqDpvmHSnx+j83+CEtywkX1Tw54MGF+0ApDP2yOy52Rw==; 3:MrTcgz2OMnhA7zF6hqyj3vnYIR2ZTOrN/5EbyxlRXgmqX2kV2n37n0H+h/sA3QkRTonzGlAwgdCQisrGlzwHbXh4Zhl8lEyg54UCCifVErKBa4cn8LbuGtENczLcR2TadFsFUOUg8FlywzlBykbTMUVpUVXjp2G8fr9oGvcGv0R0rvmALoMdKJFAs2DrqYJnp9cuABn9nbkFkV4CHYWDz83zUBhpNKatVIa3r9k+1hxiOrs63RXQY9T3KU93oAsbMoRw7RgtBd+kYFbBpjkqtg== X-DkimResult-Test: Passed X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(3001016); SRVR:CH1PR03MB1916; X-Microsoft-Exchange-Diagnostics: 1; CH1PR03MB1916; 25:38k3R01vc5fKRvPTRpinvE+D3jhOEcBMMM/81goYPGIeYVxEcv42GA2sKKacjRFP5GlgNn/l8IMz9dJbTmsLjWWUMmDAKDf9NBUr2SZOfSAFXH0bblvpr/GqpiWf9ulCsG8GlVKa0JUlGMmUedSzOBJOHhLm3sVEir/DWORwd2iQPSXV1iqVBisAficE2jPvav+kXAERZp4TV68uc3kai2JbSqZOT+40Q0FdULkdS4v4Zfv9QgDb9AzdBJYInoMNEZhT+dsKxgdhKQrzgtp0FeXThkhCRWNaSrb6exXgF2rYiy8tGBdi8rBZ5D35z6I8QQ3wzeMHB6vwLiLjfwN75Bl3UdGBgA2nMhYU51WCR8M7lwjFYxtucha2xk1X9izmqsbmBm1PXp+IcZwGNY5QsZPCOzIG847+1QlMzEF6tAjiCLdAJyfJKMPhjq962UcdFCtD9sLxj5OVvLEumzL+ZnP+tP/wKmVFtXyEiFkZDKAS00A6LWJwBbrKLiWvD1knY7cWOb7mJNF5hlC5XidiYjTMb/T4THRdvDy3ABkPoZqWwIS+8GYAHjN1aEj2jE8ZPSIORc8XHM1EMYPtGjl2jQ3uUsxA/arodnLpgCe99xI8ZilQOpYr4Ne/s5iXDIX1z7BlOU0w80bzgaVqdwUT5UN5zE/j39Iy+rDX1ud+jC8zJtMuCkwhKZ3l/HZNwnafmxa2JQTnyy9IqUg5pXOXWmdcxYqovQ1G5XDxmkYKX2bgO+YIFsRsx3tzwYzE/uws X-Microsoft-Exchange-Diagnostics: 1; CH1PR03MB1916; 31:aPUGH/+WMYlQnc5O+Snhpb2FjLuFUAdxNERFLjeRktVgOdNcz5yhHhqa0rcA61Cx6Z4t5xtRhsbP+9TZ+WWTbfUsnJMcXn84yC8Kj4omqDcCvNf6Tr4BqnojUBFEToEoTJTGhcId7ZbT+VGbtlvMKrITFKpr/KOLIpoYOXaQj8sQea44qTKT5/+07/v3nYQtcZjmExvf3/suElo9HK0NBAkEUEr2ZgWrKHDMv12VnTvlEnYW+Afi0NMl5qAMCUG6; 20:JrGNWSOukODWW1Z8h5u2oX36AUKq4pOZmxxKHbJpZjZgYoMavNg1c/d7NpC+m6VQfL1NEnKebx6eHXYdqy05JmkzRHA4FioZiTcUG48UqmfBhvsBBrQ0LR4gHnPTtv3jU/Xo3hDCdU2U9xkISVZXDk2F4EA11O5cbcnyt8H1L2I= X-Microsoft-Exchange-Diagnostics: 1; CH1PR03MB1916; 4:lrmFeETUH1zTBmzwwEbwg63fexoNBhJAO+usqxH6kB6yT8UMUO88oFE9iHGv5Lk93AX4AlRyMkgq5y7/cqbhFl2MW/J0vkyISUS8k9TfrD3nvEfV3+HArpimyIo26hgCsnwkeOKlRd5YOlik3FV3bqJ6WvFdrUu8lRe3SjuZv5W1kadu5ZCKdvL1lVrRULoycDIowApzPAx5Bm6y9S+wITRjD0uWF+3hUplJG+crfLxvbB+g5CwkHFe5ZvNfB/Ixg2f2ZQOxw0rSLVPg2g+JY3cnoFqDzuIfI2uy1R/llMwdlWqVFU5ZT5UweBeLa0HVpJ2HtGUBSvnHf9VKSSeavIw29RUwPwWF+kSBxYKl9DwFviMS/Jj0bikOSsWQWe5yU7Hc4t38IhjrWQBNao4lXpvVNrSIBU7cQdkSJflkLefN29QEUC+8lcxnAqS8Ym/v2fg5rq9KZsziPNuwI0DqBOICt2qNchppXoz2LYV5GXMDcJ+UnDoRUms+aE8UFbRSIkxMEMdK4B6h1JSUmUaqyKPtpF8x56eJFNQe0dpn52d1oDRjFocx29gaIWyNxrhO X-Forefront-PRVS: 0079056367 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; CH1PR03MB1916; 23:IlV7JZ6AZ1Lp8ElvfrA5UVvK/Q0GShm4NIAvwyqjy?= =?us-ascii?Q?oTdZBGPHBhNnyM1CLlX0cZwYdttLmRS47VF9eNknBUcgHktn7m7PP8JqZz1D?= =?us-ascii?Q?GY5u++yKOnxRB/lVYVZWS1ZYpLPqfgugPJsK+mYahi9eD/hlpNgF8OUy0XwA?= =?us-ascii?Q?uB0Z2EtaFiufD8CNcZA9v72XqAjQdKOEykPNtAwc1hmUxpj3RK4IDdeZACzU?= =?us-ascii?Q?QpNnz05zLLEGOM9VVUjRJTe3spMB+US86rQgogyO2DCtceRDV/joCktt6epz?= =?us-ascii?Q?qNxHSu1YosWrlwC9HttDK1Xkg7B38YP3vVkc4rUcPUMprdUq+m8G+ffg0E1x?= =?us-ascii?Q?w3GOzRt9MdzLTzBbAqp4NfLSTbrzv95+rRwIMZ2517wdnSqa5Kbjl7OkPE8V?= =?us-ascii?Q?7zqL6C+kplAdlw7H6qSBfxFQmDrmWhHpa/us5Enp4IFIPmAhQApKK0ya2lkU?= =?us-ascii?Q?lV2tmAQBb9raB91lRQueAuCL/P+ERKpISpoZGBf/DHM2B5uwY8ACY1Zq0ROL?= =?us-ascii?Q?6DWwmGB1hzQLfoHnv21Bgdx4bwOJwijqjfenshDOzVTPUkeJoe7By8jRdw+0?= =?us-ascii?Q?I8OYivwYmhD1LKoKFFFRurR5H9YF7vyOhqmm/FphqwCSzxQTUTA7Oa0qbBdM?= =?us-ascii?Q?CS48BDa0V0QU3M/8YvNtfE27mh8/lmpaGn4iZ7yUi5WfBsxB5s4dF10tEysB?= =?us-ascii?Q?OfG8hSOaTab7xe1xTNSBYX6XL2aHndC4iRWaCD/Fv9qrfGRyFzFhDqKYXN14?= =?us-ascii?Q?BuE0ivAxHVOor+oEIjNzduh3mMoQuuVH60Eg2WTWOGwA1XRswRLWb+LaphyY?= =?us-ascii?Q?yfaas9GgGUVKDubwOnWVC0Cw/xpTykAVRbQiPzrVSsPkRnG/TUyTOUfvb4b8?= =?us-ascii?Q?FRE3OJ/68lHYA0eWrRPar4cFwh1IvONAOMigR7LWoEh/5oNfZDJcCUPG4UBc?= =?us-ascii?Q?dpRhk/LADqxJ+s9H+VxzeoESjCTgfKn8k44fyHGpzlmW2GiGZLjS6ZfQUr2q?= =?us-ascii?Q?pZ1DmTDysnMrOxQm+UBI1HoW/BGC81KIFA/M6Ni63pk/ZcTUDaqnJc9i4RNU?= =?us-ascii?Q?iuKKkWHEtgNVQdXYWtDZXWrkANAExnN70N/MvpuHrJ+qbq55LpYbAkeeu2dN?= =?us-ascii?Q?cNX/GJFvKCpsmxdQPrqbFPBJ+OMOwkjcBKvzF+agUIelw4/llXrIulpNtJxd?= =?us-ascii?Q?wMOg/CsIuLfhUqnp7g+NkTbuRRC5LCXHDZmHAwUUYMCxROrdzV/TWaphs4EB?= =?us-ascii?Q?bhuBOnUd2mLF8tUmTslIRKXO0NQH9gTjfYFcjiAjGylnkLL75GEwgQve1Cbg?= =?us-ascii?Q?hIcT3lkG4g1EleFENaorivL1v/F5SSyPcglXKk4DX8ymzmOoInQYBDPMaAbE?= =?us-ascii?Q?HcW2/LSrHXaankzFXAa+IffD9g48EXhcs/qDm3R8tmZdhm6OV5OcwFzjbgSw?= =?us-ascii?Q?nbDX9+H9OvdBLrT//4vfjUiBjfON8s=3D?= X-Microsoft-Exchange-Diagnostics: 1; CH1PR03MB1916; 6:RsJVFVnz5d50ZFrqDRVzF99UYWb/FlUiW4gijA+9Be5G9S2joBdkqyjlCLka0HOf7RDwrN4I7ACSZ9Wn5dmnlLgkU/oJ0w2RB2z6RHorQcsZ5zp+yKaZbHSS2I+/ofGdGOPoGqdr8jAt4r1flzsssvc1NVos2zEuOomebKEOrq0xoP8Xh5ibo8rg1mJEnS2MqLnaE3+1ExjewKwjoM1wsUF67ddKhu0ob+7516pTB4fzIdwDy1PubOlhkBShDYWKTtu9xr5YaU3dJh116qxPWPgSyb2ByWuSivaGqlhW+tx6ZmhbossRoBLqqsDPmHgiSrno4+cprPbUrBunKsx/2TuNAEVr8hmhW+PTeBbnZoU=; 5:GBOnq+mHsAQ6gAxJA1rF/UWZSi2bjkSAeBli5hMblNW+GZ7AYeeM1Yz6aE3lYrO/vZtD6nZxbJzoD1fGqiOkP6DeNodU/kUCgl7qSJGmyVnAx++sBQCXIH8jmUtUTWlUq75FCdrDaI7gmpS6mc77SFMLfuoFC3vgml9INMTOtls=; 24:hT80Mw+5VA/iemfeOt5japNGRslPaWVr7MPYoEiXstjzcdOFDY+9yVH2WlFeZXpvUVpVHjh9R+AmusH0lmT/mvzKGfRnub+GiwtZ3vdycy0=; 7:WCzLS+cgqpX2EDJ+q2KiGlZyLTyn2RLOiIzxeMNZ/nuBJuVl1HHwzWqNMDiUeQlaAr+tHHO11/soHzuAHSTbjWkzAK/Us7b6SA4GD81Bd0ORL4Wn4FiPoag/EdhRglhp7vrVjkU/QfZG4GHLiiBIclOGmm67Tc5tflOHrJTmaVNzSECXNTbGkzkyoWKQUk/i5n9mZ3P6skp1+2hYQpFFjuTgWFTZ0Bh55bo8xJ0nAvxVtRmm9sTOQs0BR2Mjq2yp5ATjHR99aeD/bzPi1hIzFVj8R6G3r/SFcuEx12vorhw= X-OriginatorOrg: opensource.altera.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 28 Sep 2016 18:21:45.6543 (UTC) X-MS-Exchange-CrossTenant-Id: fbd72e03-d4a5-4110-adce-614d51f2077a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=fbd72e03-d4a5-4110-adce-614d51f2077a; Ip=[66.35.236.227]; Helo=[sj-itexedge03.altera.priv.altera.com] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH1PR03MB1916 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20160928_112224_254916_6D60CE02 X-CRM114-Status: UNSURE ( 5.53 ) X-CRM114-Notice: Please train this message. X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Mark Rutland , Moritz Fischer , delicious.quinoa@gmail.com, Ian Campbell , Alan Tull , Greg Kroah-Hartman , Josh Cartwright , Michal Simek , linux-kernel@vger.kernel.org, Cyril Chemparathy , devicetree@vger.kernel.org, Dinh Nguyen , Jon Masters , Matthew Gerlach , Frank Rowand , Walter Goossens , linux-arm-kernel@lists.infradead.org Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP This patch adds a minor change in the FPGA Mangager API to hold information that is specific to an FPGA image file. This change is expected to bring little, if any, pain. An FPGA image file will have particulars that affect how the image is programmed to the FPGA. One example is that current 'flags' currently has one bit which shows whether the FPGA image was built for full reconfiguration or partial reconfiguration. Another example is timeout values for enabling or disabling the bridges in the FPGA. As the complexity of the FPGA design increases, the bridges in the FPGA may take longer times to enable or disable. This patch documents the change in the FPGA Manager API functions, replacing the 'u32 flag' parameter with a pointer to struct fpga_image_info. Signed-off-by: Alan Tull --- v19: Added in v19 of this patchset --- Documentation/fpga/fpga-mgr.txt | 32 +++++++++++++++++++++----------- 1 file changed, 21 insertions(+), 11 deletions(-) diff --git a/Documentation/fpga/fpga-mgr.txt b/Documentation/fpga/fpga-mgr.txt index ce3e84f..9227e3f 100644 --- a/Documentation/fpga/fpga-mgr.txt +++ b/Documentation/fpga/fpga-mgr.txt @@ -18,21 +18,25 @@ API Functions: To program the FPGA from a file or from a buffer: ------------------------------------------------- - int fpga_mgr_buf_load(struct fpga_manager *mgr, u32 flags, + int fpga_mgr_buf_load(struct fpga_manager *mgr, + struct fpga_image_info *info, const char *buf, size_t count); Load the FPGA from an image which exists as a buffer in memory. - int fpga_mgr_firmware_load(struct fpga_manager *mgr, u32 flags, + int fpga_mgr_firmware_load(struct fpga_manager *mgr, + struct fpga_image_info *info, const char *image_name); Load the FPGA from an image which exists as a file. The image file must be on -the firmware search path (see the firmware class documentation). - -For both these functions, flags == 0 for normal full reconfiguration or -FPGA_MGR_PARTIAL_RECONFIG for partial reconfiguration. If successful, the FPGA -ends up in operating mode. Return 0 on success or a negative error code. +the firmware search path (see the firmware class documentation). If successful, +the FPGA ends up in operating mode. Return 0 on success or a negative error +code. +A FPGA design contained in a FPGA image file will likely have particulars that +affect how the image is programmed to the FPGA. These are contained in struct +fpga_image_info. Currently the only such particular is a single flag bit +indicating whether the image is for full or partial reconfiguration. To get/put a reference to a FPGA manager: ----------------------------------------- @@ -70,8 +74,11 @@ struct device_node *mgr_node = ... char *buf = ... int count = ... +/* struct with information about the FPGA image to program. */ +struct fpga_image_info info; + /* flags indicates whether to do full or partial reconfiguration */ -int flags = 0; +info.flags = 0; int ret; @@ -79,7 +86,7 @@ int ret; struct fpga_manager *mgr = of_fpga_mgr_get(mgr_node); /* Load the buffer to the FPGA */ -ret = fpga_mgr_buf_load(mgr, flags, buf, count); +ret = fpga_mgr_buf_load(mgr, &info, buf, count); /* Release the FPGA manager */ fpga_mgr_put(mgr); @@ -96,8 +103,11 @@ struct device_node *mgr_node = ... /* FPGA image is in this file which is in the firmware search path */ const char *path = "fpga-image-9.rbf" +/* struct with information about the FPGA image to program. */ +struct fpga_image_info info; + /* flags indicates whether to do full or partial reconfiguration */ -int flags = 0; +info.flags = 0; int ret; @@ -105,7 +115,7 @@ int ret; struct fpga_manager *mgr = of_fpga_mgr_get(mgr_node); /* Get the firmware image (path) and load it to the FPGA */ -ret = fpga_mgr_firmware_load(mgr, flags, path); +ret = fpga_mgr_firmware_load(mgr, &info, path); /* Release the FPGA manager */ fpga_mgr_put(mgr);