From: Sagar Arun Kamble Subject: Re: [PATCH v5 01/12] drm/i915/guc: Add documentation for MMIO based communication Date: Tue, 27 Mar 2018 15:35:21 +0530 Message-ID: <0f11173f-dec2-7942-8a12-bb20ef8dc8f7@intel.com> References: <20180326194829.58836-1-michal.wajdeczko@intel.com> <20180326194829.58836-2-michal.wajdeczko@intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8"; Format="flowed" Content-Transfer-Encoding: base64 Return-path: Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by gabe.freedesktop.org (Postfix) with ESMTPS id B84876E484 for ; Tue, 27 Mar 2018 10:05:26 +0000 (UTC) In-Reply-To: <20180326194829.58836-2-michal.wajdeczko@intel.com> Content-Language: en-US List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: Michal Wajdeczko , intel-gfx@lists.freedesktop.org List-Id: intel-gfx@lists.freedesktop.org CgpPbiAzLzI3LzIwMTggMToxOCBBTSwgTWljaGFsIFdhamRlY3prbyB3cm90ZToKPiBBcyB3ZSBh cmUgZ29pbmcgdG8gZXh0ZW5kIG91ciB1c2Ugb2YgTU1JTyBiYXNlZCBjb21tdW5pY2F0aW9uLAo+ IHRyeSB0byBleHBsYWluIGl0cyBtZWNoYW5pY3MgYW5kIHVwZGF0ZSBjb3JyZXNwb25kaW5nIGRl ZmluaXRpb25zLgo+Cj4gdjI6IGZpeCBjaGVja3BhdGNoIE1BQ1JPX0FSR19SRVVTRQo+Cj4gU2ln bmVkLW9mZi1ieTogTWljaGFsIFdhamRlY3prbyA8bWljaGFsLndhamRlY3prb0BpbnRlbC5jb20+ Cj4gQ2M6IERhbmllbGUgQ2VyYW9sbyBTcHVyaW8gPGRhbmllbGUuY2VyYW9sb3NwdXJpb0BpbnRl bC5jb20+Cj4gQ2M6IFNhZ2FyIEFydW4gS2FtYmxlIDxzYWdhci5hLmthbWJsZUBpbnRlbC5jb20+ Cj4gQ2M6IEtlbHZpbiBHYXJkaW5lciA8a2VsdmluLmdhcmRpbmVyQGludGVsLmNvbT4KPiBSZXZp ZXdlZC1ieTogTWljaGVsIFRoaWVycnkgPG1pY2hlbC50aGllcnJ5QGludGVsLmNvbT4gIzEKPiAt LS0KPgo8c25pcD4KPiAgIH0KPiBkaWZmIC0tZ2l0IGEvZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50 ZWxfZ3VjX2Z3aWYuaCBiL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2ludGVsX2d1Y19md2lmLmgKPiBp bmRleCA3Mjk0MWJkLi44MzE0M2U4IDEwMDY0NAo+IC0tLSBhL2RyaXZlcnMvZ3B1L2RybS9pOTE1 L2ludGVsX2d1Y19md2lmLmgKPiArKysgYi9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9ndWNf ZndpZi5oCj4gQEAgLTU2MCw3ICs1NjAsNjggQEAgc3RydWN0IGd1Y19zaGFyZWRfY3R4X2RhdGEg ewo+ICAgCXN0cnVjdCBndWNfY3R4X3JlcG9ydCBwcmVlbXB0X2N0eF9yZXBvcnRbR1VDX01BWF9F TkdJTkVTX05VTV07Cj4gICB9IF9fcGFja2VkOwo+ICAgCj4gLS8qIFRoaXMgQWN0aW9uIHdpbGwg YmUgcHJvZ3JhbW1lZCBpbiBDMTgwIC0gU09GVF9TQ1JBVENIX09fUkVHICovCj4gKy8qKgo+ICsg KiBET0M6IE1NSU8gYmFzZWQgY29tbXVuaWNhdGlvbgo+ICsgKgo+ICsgKiBUaGUgTU1JTyBiYXNl ZCBjb21tdW5pY2F0aW9uIGJldHdlZW4gSG9zdCBhbmQgR3VDIHVzZXMgc29mdHdhcmUgc2NyYXRj aAo+ICsgKiByZWdpc3RlcnMsIHdoZXJlIGZpcnN0IHJlZ2lzdGVyIGhvbGRzIGRhdGEgdHJlYXRl ZCBhcyBtZXNzYWdlIGhlYWRlciwKPiArICogYW5kIG90aGVyIHJlZ2lzdGVycyBhcmUgdXNlZCB0 byBob2xkIG1lc3NhZ2UgcGF5bG9hZC4KPiArICoKPiArICogRm9yIEdlbjkrLCBHdUMgdXNlcyBz b2Z0d2FyZSBzY3JhdGNoIHJlZ2lzdGVycyAweEMxODAtMHhDMUI4CmRpYWdyYW0gYmVsb3cgc2hv dWxkIGJlIG1hcmtlZCBhcyByZVNUIGxpdGVyYWwgYmxvY2sgd2l0aCAiOjoiCj4gKyAqCj4gKyAq ICAgICAgKy0tLS0tLS0tLS0tKy0tLS0tLS0tLSstLS0tLS0tLS0rLS0tLS0tLS0tKwo+ICsgKiAg ICAgIHwgIE1NSU9bMF0gIHwgTU1JT1sxXSB8ICAgLi4uICAgfCBNTUlPW25dIHwKPiArICogICAg ICArLS0tLS0tLS0tLS0rLS0tLS0tLS0tKy0tLS0tLS0tLSstLS0tLS0tLS0rCj4gKyAqICAgICAg fCBoZWFkZXIgICAgfCAgICAgIG9wdGlvbmFsIHBheWxvYWQgICAgICAgfAo+ICsgKiAgICAgICs9 PT09PT0rPT09PSs9PT09PT09PT0rPT09PT09PT09Kz09PT09PT09PSsKPiArICogICAgICB8IDMx OjI4fHR5cGV8ICAgICAgICAgfCAgICAgICAgIHwgICAgICAgICB8Cj4gKyAqICAgICAgKy0tLS0t LSstLS0tKyAgICAgICAgIHwgICAgICAgICB8ICAgICAgICAgfAo+ICsgKiAgICAgIHwgMjc6MTZ8 ZGF0YXwgICAgICAgICB8ICAgICAgICAgfCAgICAgICAgIHwKPiArICogICAgICArLS0tLS0tKy0t LS0rICAgICAgICAgfCAgICAgICAgIHwgICAgICAgICB8Cj4gKyAqICAgICAgfCAgMTU6MHxjb2Rl fCAgICAgICAgIHwgICAgICAgICB8ICAgICAgICAgfAo+ICsgKiAgICAgICstLS0tLS0rLS0tLSst LS0tLS0tLS0rLS0tLS0tLS0tKy0tLS0tLS0tLSsKPiArICoKPiArICogVGhlIG1lc3NhZ2UgaGVh ZGVyIGNvbnNpc3RzIG9mOgo+ICsgKgo+ICsgKiAtICoqdHlwZSoqLCBpbmRpY2F0ZXMgbWVzc2Fn ZSB0eXBlCj4gKyAqIC0gKipjb2RlKiosIGluZGljYXRlcyBtZXNzYWdlIGNvZGUsIGlzIHNwZWNp ZmljIGZvciAqKnR5cGUqKgo+ICsgKiAtICoqZGF0YSoqLCBpbmRpY2F0ZXMgbWVzc2FnZSBkYXRh LCBvcHRpb25hbCwgZGVwZW5kcyBvbiAqKmNvZGUqKgo+ICsgKgo+ICsgKiBUaGUgZm9sbG93aW5n IG1lc3NhZ2UgKip0eXBlcyoqIGFyZSBzdXBwb3J0ZWQ6Cj4gKyAqCj4gKyAqIC0gKipSRVFVRVNU KiosIGluZGljYXRlcyBIb3N0LXRvLUd1QyByZXF1ZXN0LCByZXF1ZXN0ZWQgR3VDIGFjdGlvbiBj b2RlCj4gKyAqICAgbXVzdCBiZSBwcmlvdmlkZWQgaW4gKipjb2RlKiogZmllbGQuIE9wdGlvbmFs IGFjdGlvbiBzcGVjaWZpYyBwYXJhbWV0ZXJzCj4gKyAqICAgY2FuIGJlIHByb3ZpZGVkIGluIHJl bWFpbmluZyBwYXlsb2FkIHJlZ2lzdGVycyBvciAqKmRhdGEqKiBmaWVsZC4KPiArICoKPiArICog LSAqKlJFU1BPTlNFKiosIGluZGljYXRlcyBHdUMtdG8tSG9zdCByZXNwb25zZSBmcm9tIGVhcmxp ZXIgR3VDIHJlcXVlc3QsCj4gKyAqICAgYWN0aW9uIHJlc3BvbnNlIHN0YXR1cyB3aWxsIGJlIHBy b3ZpZGVkIGluICoqY29kZSoqIGZpZWxkLiBPcHRpb25hbAo+ICsgKiAgIHJlc3BvbnNlIGRhdGEg Y2FuIGJlIHJldHVybmVkIGluIHJlbWFpbmluZyBwYXlsb2FkIHJlZ2lzdGVycyBvciAqKmRhdGEq Kgo+ICsgKiAgIGZpZWxkLgo+ICsgKi8KPiArCj4gKyNkZWZpbmUgSU5URUxfR1VDX01TR19UWVBF X1NISUZUCTI4Cj4gKyNkZWZpbmUgSU5URUxfR1VDX01TR19UWVBFX01BU0sJCSgweEYgPDwgSU5U RUxfR1VDX01TR19UWVBFX1NISUZUKQo+ICsjZGVmaW5lIElOVEVMX0dVQ19NU0dfREFUQV9TSElG VAkxNgo+ICsjZGVmaW5lIElOVEVMX0dVQ19NU0dfREFUQV9NQVNLCQkoMHhGRkYgPDwgSU5URUxf R1VDX01TR19EQVRBX1NISUZUKQo+ICsjZGVmaW5lIElOVEVMX0dVQ19NU0dfQ09ERV9TSElGVAkw Cj4gKyNkZWZpbmUgSU5URUxfR1VDX01TR19DT0RFX01BU0sJCSgweEZGRkYgPDwgSU5URUxfR1VD X01TR19DT0RFX1NISUZUKQo+ICsKPiArI2RlZmluZSBfX0lOVEVMX0dVQ19NU0dfR0VUKFQsIG0p IFwKPiArCSgoKG0pICYgSU5URUxfR1VDX01TR18gIyMgVCAjIyBfTUFTSykgPj4gSU5URUxfR1VD X01TR18gIyMgVCAjIyBfU0hJRlQpCj4gKyNkZWZpbmUgSU5URUxfR1VDX01TR19UT19UWVBFKG0p CV9fSU5URUxfR1VDX01TR19HRVQoVFlQRSwgbSkKPiArI2RlZmluZSBJTlRFTF9HVUNfTVNHX1RP X0RBVEEobSkJX19JTlRFTF9HVUNfTVNHX0dFVChEQVRBLCBtKQo+ICsjZGVmaW5lIElOVEVMX0dV Q19NU0dfVE9fQ09ERShtKQlfX0lOVEVMX0dVQ19NU0dfR0VUKENPREUsIG0pCj4gKwo+ICtlbnVt IGludGVsX2d1Y19tc2dfdHlwZSB7Cj4gKwlJTlRFTF9HVUNfTVNHX1RZUEVfUkVRVUVTVCA9IDB4 MCwKPiArCUlOVEVMX0dVQ19NU0dfVFlQRV9SRVNQT05TRSA9IDB4RiwKPiArfTsKPiArCj4gKyNk ZWZpbmUgX19JTlRFTF9HVUNfTVNHX1RZUEVfSVMoVCwgbSkgXAo+ICsJKElOVEVMX0dVQ19NU0df VE9fVFlQRShtKSA9PSBJTlRFTF9HVUNfTVNHX1RZUEVfICMjIFQpCj4gKyNkZWZpbmUgSU5URUxf R1VDX01TR19JU19SRVFVRVNUKG0pCV9fSU5URUxfR1VDX01TR19UWVBFX0lTKFJFUVVFU1QsIG0p CipfTVNHX0lTX1JFUVVFU1QgaXNuJ3QgdXNlZC4gRG8gd2UgcGxhbiB0byB1c2UgdGhpcz8KPiAr I2RlZmluZSBJTlRFTF9HVUNfTVNHX0lTX1JFU1BPTlNFKG0pCV9fSU5URUxfR1VDX01TR19UWVBF X0lTKFJFU1BPTlNFLCBtKQo+ICsKPiAgIGVudW0gaW50ZWxfZ3VjX2FjdGlvbiB7Cj4gciAJSU5U RUxfR1VDX0FDVElPTl9ERUZBVUxUID0gMHgwLAo+ICAgCUlOVEVMX0dVQ19BQ1RJT05fUkVRVUVT VF9QUkVFTVBUSU9OID0gMHgyLAo+IEBAIC01OTcsMjQgKzY1OCwxNyBAQCBlbnVtIGludGVsX2d1 Y19yZXBvcnRfc3RhdHVzIHsKPiAgICNkZWZpbmUgR1VDX0xPR19DT05UUk9MX1ZFUkJPU0lUWV9N QVNLCSgweEYgPDwgR1VDX0xPR19DT05UUk9MX1ZFUkJPU0lUWV9TSElGVCkKPiAgICNkZWZpbmUg R1VDX0xPR19DT05UUk9MX0RFRkFVTFRfTE9HR0lORwkoMSA8PCA4KQo+ICAgCj4gLS8qCj4gLSAq IFRoZSBHdUMgc2VuZHMgaXRzIHJlc3BvbnNlIHRvIGEgY29tbWFuZCBieSBvdmVyd3JpdGluZyB0 aGUKPiAtICogY29tbWFuZCBpbiBTUzAuIFRoZSByZXNwb25zZSBpcyBkaXN0aW5ndWlzaGFibGUg ZnJvbSBhIGNvbW1hbmQKPiAtICogYnkgdGhlIGZhY3QgdGhhdCBhbGwgdGhlIE1BU0sgYml0cyBh cmUgc2V0LiBUaGUgcmVtYWluaW5nIGJpdHMKPiAtICogZ2l2ZSBtb3JlIGRldGFpbC4KPiAtICov Cj4gLSNkZWZpbmUJSU5URUxfR1VDX1JFQ1ZfTUFTSwkoKHUzMikweEYwMDAwMDAwKQo+IC0jZGVm aW5lCUlOVEVMX0dVQ19SRUNWX0lTX1JFU1BPTlNFKHgpCSgodTMyKSh4KSA+PSBJTlRFTF9HVUNf UkVDVl9NQVNLKQo+IC0jZGVmaW5lCUlOVEVMX0dVQ19SRUNWX1NUQVRVUyh4KQkoSU5URUxfR1VD X1JFQ1ZfTUFTSyB8ICh4KSkKPiAtCj4gLS8qIEdVQyB3aWxsIHJldHVybiBzdGF0dXMgYmFjayB0 byBTT0ZUX1NDUkFUQ0hfT19SRUcgKi8KPiAtZW51bSBpbnRlbF9ndWNfc3RhdHVzIHsKPiAtCUlO VEVMX0dVQ19TVEFUVVNfU1VDQ0VTUyA9IElOVEVMX0dVQ19SRUNWX1NUQVRVUygweDApLAo+IC0J SU5URUxfR1VDX1NUQVRVU19BTExPQ0FURV9ET09SQkVMTF9GQUlMID0gSU5URUxfR1VDX1JFQ1Zf U1RBVFVTKDB4MTApLAo+IC0JSU5URUxfR1VDX1NUQVRVU19ERUFMTE9DQVRFX0RPT1JCRUxMX0ZB SUwgPSBJTlRFTF9HVUNfUkVDVl9TVEFUVVMoMHgyMCksCj4gLQlJTlRFTF9HVUNfU1RBVFVTX0dF TkVSSUNfRkFJTCA9IElOVEVMX0dVQ19SRUNWX1NUQVRVUygweDAwMDBGMDAwKQo+ICtlbnVtIGlu dGVsX2d1Y19yZXNwb25zZV9zdGF0dXMgewo+ICsJSU5URUxfR1VDX1JFU1BPTlNFX1NUQVRVU19T VUNDRVNTID0gMHgwLAo+ICsJSU5URUxfR1VDX1JFU1BPTlNFX1NUQVRVU19HRU5FUklDX0ZBSUwg PSAweEYwMDAsCj4gICB9Owo+ICAgCj4gKyNkZWZpbmUgSU5URUxfR1VDX01TR19JU19SRVNQT05T RV9TVUNDRVNTKG0pIFwKPiArCSAodHlwZWNoZWNrKHUzMiwgKG0pKSAmJiBcCj4gKwkgICgobSkg JiAoSU5URUxfR1VDX01TR19UWVBFX01BU0sgfCBJTlRFTF9HVUNfTVNHX0NPREVfTUFTSykpID09 IFwKPiArCSAgKChJTlRFTF9HVUNfTVNHX1RZUEVfUkVTUE9OU0UgPDwgSU5URUxfR1VDX01TR19U WVBFX1NISUZUKSB8IFwKPiArCSAgIChJTlRFTF9HVUNfUkVTUE9OU0VfU1RBVFVTX1NVQ0NFU1Mg PDwgSU5URUxfR1VDX01TR19DT0RFX1NISUZUKSkpCj4gKwo+ICAgLyogVGhpcyBhY3Rpb24gd2ls bCBiZSBwcm9ncmFtbWVkIGluIEMxQkMgLSBTT0ZUX1NDUkFUQ0hfMTVfUkVHICovCj4gICBlbnVt IGludGVsX2d1Y19yZWN2X21lc3NhZ2Ugewo+ICAgCUlOVEVMX0dVQ19SRUNWX01TR19DUkFTSF9E VU1QX1BPU1RFRCA9IEJJVCgxKSwKCi0tIApUaGFua3MsClNhZ2FyCgpfX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpJbnRlbC1nZnggbWFpbGluZyBsaXN0Cklu dGVsLWdmeEBsaXN0cy5mcmVlZGVza3RvcC5vcmcKaHR0cHM6Ly9saXN0cy5mcmVlZGVza3RvcC5v cmcvbWFpbG1hbi9saXN0aW5mby9pbnRlbC1nZngK