From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Sharma, Shashank" Subject: Re: [PATCH v7 10/10] drm/i915/dsb: Documentation for DSB. Date: Thu, 19 Sep 2019 11:26:20 +0530 Message-ID: <8c2c454f-74dd-d538-a9a1-c44841bebaea@intel.com> References: <20190918075745.17076-1-animesh.manna@intel.com> <20190918075745.17076-11-animesh.manna@intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8"; Format="flowed" Content-Transfer-Encoding: base64 Return-path: Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by gabe.freedesktop.org (Postfix) with ESMTPS id C579D6E0EB for ; Thu, 19 Sep 2019 05:56:23 +0000 (UTC) In-Reply-To: <20190918075745.17076-11-animesh.manna@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: Animesh Manna , intel-gfx@lists.freedesktop.org Cc: Jani Nikula List-Id: intel-gfx@lists.freedesktop.org Ck9uIDkvMTgvMjAxOSAxOjI3IFBNLCBBbmltZXNoIE1hbm5hIHdyb3RlOgo+IEFkZGVkIGRvY2Jv b2sgaW5mbyByZWdhcmRpbmcgRGlzcGxheSBTdGF0ZSBCdWZmZXIoRFNCKSB3aGljaAo+IGlzIGFk ZGVkIGZyb20gZ2VuMTIgb253YXJkcyB0byBiYXRjaCBzdWJtaXQgZGlzcGxheSBIVyBwcm9ncmFt bWluZy4KPgo+IHYxOiBJbml0aWFsIHZlcnNpb24gYXMgUkZDLgo+Cj4gQ2M6IEphbmkgTmlrdWxh IDxqYW5pLm5pa3VsYUBpbnRlbC5jb20+Cj4gQ2M6IFJvZHJpZ28gVml2aSA8cm9kcmlnby52aXZp QGludGVsLmNvbT4KPiBDYzogU2hhc2hhbmsgU2hhcm1hIDxzaGFzaGFuay5zaGFybWFAaW50ZWwu Y29tPgo+IFNpZ25lZC1vZmYtYnk6IEFuaW1lc2ggTWFubmEgPGFuaW1lc2gubWFubmFAaW50ZWwu Y29tPgo+IC0tLQo+ICAgRG9jdW1lbnRhdGlvbi9ncHUvaTkxNS5yc3QgICAgICAgICAgICAgICB8 ICA5ICsrKysKPiAgIGRyaXZlcnMvZ3B1L2RybS9pOTE1L2Rpc3BsYXkvaW50ZWxfZHNiLmMgfCA2 OCArKysrKysrKysrKysrKysrKysrKysrKysKPiAgIDIgZmlsZXMgY2hhbmdlZCwgNzcgaW5zZXJ0 aW9ucygrKQo+Cj4gZGlmZiAtLWdpdCBhL0RvY3VtZW50YXRpb24vZ3B1L2k5MTUucnN0IGIvRG9j dW1lbnRhdGlvbi9ncHUvaTkxNS5yc3QKPiBpbmRleCBlMjQ5ZWE3YjBlYzcuLjQ2NTc3OTY3MGZk NCAxMDA2NDQKPiAtLS0gYS9Eb2N1bWVudGF0aW9uL2dwdS9pOTE1LnJzdAo+ICsrKyBiL0RvY3Vt ZW50YXRpb24vZ3B1L2k5MTUucnN0Cj4gQEAgLTI0Niw2ICsyNDYsMTUgQEAgRGlzcGxheSBQTExz Cj4gICAuLiBrZXJuZWwtZG9jOjogZHJpdmVycy9ncHUvZHJtL2k5MTUvZGlzcGxheS9pbnRlbF9k cGxsX21nci5oCj4gICAgICA6aW50ZXJuYWw6Cj4gICAKPiArRGlzcGxheSBTdGF0ZSBCdWZmZXIK PiArLS0tLS0tLS0tLS0tLS0tLS0tLS0KPiArCj4gKy4uIGtlcm5lbC1kb2M6OiBkcml2ZXJzL2dw dS9kcm0vaTkxNS9kaXNwbGF5L2ludGVsX2RzYi5jCj4gKyAgIDpkb2M6IERTQgo+ICsKPiArLi4g a2VybmVsLWRvYzo6IGRyaXZlcnMvZ3B1L2RybS9pOTE1L2Rpc3BsYXkvaW50ZWxfZHNiLmMKPiAr ICAgOmludGVybmFsOgo+ICsKPiAgIE1lbW9yeSBNYW5hZ2VtZW50IGFuZCBDb21tYW5kIFN1Ym1p c3Npb24KPiAgID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0KPiAgIAo+ IGRpZmYgLS1naXQgYS9kcml2ZXJzL2dwdS9kcm0vaTkxNS9kaXNwbGF5L2ludGVsX2RzYi5jIGIv ZHJpdmVycy9ncHUvZHJtL2k5MTUvZGlzcGxheS9pbnRlbF9kc2IuYwo+IGluZGV4IGNiZjdmMmMz MzAwYy4uNWI1Mjc4Yzk0Y2E3IDEwMDY0NAo+IC0tLSBhL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2Rp c3BsYXkvaW50ZWxfZHNiLmMKPiArKysgYi9kcml2ZXJzL2dwdS9kcm0vaTkxNS9kaXNwbGF5L2lu dGVsX2RzYi5jCj4gQEAgLTksNiArOSwyMyBAQAo+ICAgCj4gICAjZGVmaW5lIERTQl9CVUZfU0la RSAgICAoMiAqIFBBR0VfU0laRSkKPiAgIAo+ICsvKioKPiArICogRE9DOiBEU0IKPiArICoKPiAr ICogQSBEU0IgKERpc3BsYXkgU3RhdGUgQnVmZmVyKSBpcyBhIHF1ZXVlIG9mIE1NSU8gaW5zdHJ1 Y3Rpb25zIGluIHRoZSBtZW1vcnkKPiArICogd2hpY2ggY2FuIGJlIG9mZmxvYWRlZCB0byBEU0Ig SFcgaW4gRGlzcGxheSBDb250cm9sbGVyLiBEU0IgSFcgaXMgYSBETUEKPiArICogZW5naW5lIHRo YXQgY2FuIGJlIHByb2dyYW1tZWQgdG8gZG93bmxvYWQgdGhlIERTQiBmcm9tIG1lbW9yeS4KPiAr ICogSXQgYWxsb3dzIGRyaXZlciB0byBiYXRjaCBzdWJtaXQgZGlzcGxheSBIVyBwcm9ncmFtbWlu Zy4gVGhpcyBoZWxwcyB0bwo+ICsgKiByZWR1Y2UgbG9hZGluZyB0aW1lIGFuZCBDUFUgYWN0aXZp dHksIHRoZXJlYnkgbWFraW5nIHRoZSBjb250ZXh0IHN3aXRjaAo+ICsgKiBmYXN0ZXIuIERTQiBT dXBwb3J0IGFkZGVkIGZyb20gR2VuMTIgSW50ZWwgZ3JhcGhpY3MgYmFzZWQgcGxhdGZvcm0uCj4g KyAqCj4gKyAqIERTQidzIGNhbiBhY2Nlc3Mgb25seSB0aGUgcGlwZSwgcGxhbmUsIGFuZCB0cmFu c2NvZGVyIERhdGEgSXNsYW5kIFBhY2tldAo+ICsgKiByZWdpc3RlcnMuCj4gKyAqCj4gKyAqIERT QiBIVyBjYW4gc3VwcG9ydCBvbmx5IHJlZ2lzdGVyIHdyaXRlcyAoYm90aCBpbmRleGVkIGFuZCBk aXJlY3QgTU1JTwo+ICsgKiB3cml0ZXMpLiBUaGVyZSBhcmUgbm8gcmVnaXN0ZXJzIHJlYWRzIHBv c3NpYmxlIHdpdGggRFNCIEhXIGVuZ2luZS4KPiArICovCj4gKwo+ICAgLyogRFNCIG9wY29kZXMu ICovCj4gICAjZGVmaW5lIERTQl9PUENPREVfU0hJRlQJCTI0Cj4gICAjZGVmaW5lIERTQl9PUENP REVfTU1JT19XUklURQkJMHgxCj4gQEAgLTY2LDYgKzgzLDE3IEBAIHN0YXRpYyBpbmxpbmUgYm9v bCBpbnRlbF9kc2JfZGlzYWJsZV9lbmdpbmUoc3RydWN0IGludGVsX2RzYiAqZHNiKQo+ICAgCXJl dHVybiB0cnVlOwo+ICAgfQo+ICAgCj4gKy8qKgo+ICsgKiBpbnRlbF9kc2JfZ2V0KCkgLSBBbGxv Y2F0ZSBkc2IgY29udGV4dCBhbmQgcmV0dXJuIGEgZHNiIGluc3RhbmNlLgp3ZSBhcmUgdXNpbmcg J2RzYicgYW5kICdEU0InIGJvdGguIFBsZWFzZSB1c2Ugb25lIG9mIHRoZXNlLCBhbmQgbWFrZSBp dCAKdW5pZm9ybSBhY3Jvc3MgdGhlIGRvYy4gSSB3aWxsIHByZWZlciBEU0IgKGV4cGVjdCBmdW5j dGlvbiBuYW1lcyBvZiAKY291cnNlIDopKQo+ICsgKiBAY3J0YzogaW50ZWxfY3J0YyBzdHJ1Y3R1 cmUgdG8gZ2V0IHBpcGUgaW5mby4KPiArICoKPiArICogVGhpcyBmdW5jdGlvbiB3aWxsIGdpdmUg aGFuZGxlIG9mIHRoZSBEU0IgaW5zdGFuY2Ugd2hpY2gKPiArICogdXNlciB3YW50IHRvIG9wZXJh dGUgb24uCkxpdHRsZSByZS1hcnJhbmdlbWVudDogVGhpcyBmdW5jdGlvbiBwcm92aWRlcyBoYW5k bGUgb2YgYSBEU0IgaW5zdGFuY2UsIApmb3IgdGhlIGZ1cnRoZXIgRFNCIG9wZXJhdGlvbnMuCj4g KyAqCj4gKyAqIFJldHVybiA6IGFkZHJlc3Mgb2YgSW50ZWxfZHNiIGluc3RhbmNlIHJlcXVlc3Rl ZCBmb3IuClJldHVybnM6Cj4gKyAqIEluIGZhaWx1cmUgY2FzZSwgdGhlIGRzYiBpbnN0YW5jZSB3 aWxsIG5vdCBoYXZlIGFueSBjb21tYW5kIGJ1ZmZlci4KRmFpbHVyZTogUmV0dXJucyB0aGUgc2Ft ZSBEU0IgaW5zdGFuY2UsIGJ1dCB3aXRob3V0IGEgY29tbWFuZCBidWZmZXIuCj4gKyAqLwo+ICsK PiAgIHN0cnVjdCBpbnRlbF9kc2IgKgo+ICAgaW50ZWxfZHNiX2dldChzdHJ1Y3QgaW50ZWxfY3J0 YyAqY3J0YykKPiAgIHsKPiBAQCAtMTE2LDYgKzE0NCwxNCBAQCBpbnRlbF9kc2JfZ2V0KHN0cnVj dCBpbnRlbF9jcnRjICpjcnRjKQo+ICAgCXJldHVybiBkc2I7Cj4gICB9Cj4gICAKPiArLyoqCj4g KyAqIGludGVsX2RzYl9wdXQoKSAtIFRvIGRlc3Ryb3kgRFNCIGNvbnRleHQuCj4gKyAqIEBkc2I6 IGludGVsX2RzYiBzdHJ1Y3R1cmUuCj4gKyAqCj4gKyAqIFRoaXMgZnVuY3Rpb24gaXMgdXNlZCB0 byBkZXN0cm95IHRoZSBkc2ItY29udGV4dCBieSBkb2luZyB1bnBpbgo+ICsgKiBhbmQgcmVsZWFz ZSB0aGUgdm1hIG9iamVjdC4KVGhpcyBmdW5jdGlvbiBkZXN0cm95cyB0aGUgRFNCIGNvbnRleHQg YWxsb2NhdGVkIGJ5IGEgZHNiX2dldCgpLCBieSAKdW5waW5uaW5nIGFuZCByZWxlYXNpbmcgdGhl IFZNQSBvYmplY3QgYXNzb2NpYXRlZCB3aXRoIGl0Lgo+ICsgKi8KPiArCj4gICB2b2lkIGludGVs X2RzYl9wdXQoc3RydWN0IGludGVsX2RzYiAqZHNiKQo+ICAgewo+ICAgCXN0cnVjdCBpbnRlbF9j cnRjICpjcnRjID0gY29udGFpbmVyX29mKGRzYiwgdHlwZW9mKCpjcnRjKSwgZHNiKTsKPiBAQCAt MTM3LDYgKzE3MywxOSBAQCB2b2lkIGludGVsX2RzYl9wdXQoc3RydWN0IGludGVsX2RzYiAqZHNi KQo+ICAgCX0KPiAgIH0KPiAgIAo+ICsvKioKPiArICogaW50ZWxfZHNiX2luZGV4ZWRfcmVnX3dy aXRlKCkgLVdyaXRlIHRvIHRoZSBkc2IgY29udGV4dCBmb3IgYXV0bwo+ICsgKiBpbmNyZW1lbnQg cmVnaXN0ZXIuCj4gKyAqIEBkc2I6IGludGVsX2RzYiBzdHJ1Y3R1cmUuCj4gKyAqIEByZWc6IHJl Z2lzdGVyIGFkZHJlc3MuCj4gKyAqIEB2YWw6IHZhbHVlLgo+ICsgKgo+ICsgKiBUaGlzIGZ1bmN0 aW9uIGlzIHVzZWQgZm9yIGF1dG8taW5jcmVtZW50IHJlZ2lzdGVyIGFuZCBpbnRlbF9kc2JfcmVn X3dyaXRlKCkKPiArICogaXMgdXNlZCBmb3Igbm9ybWFsIHJlZ2lzdGVyLgoKSSBhbSBub3QgYWJs ZSB0byBnZXQgdGhlIG1lc3NhZ2Ugb3V0IG9mIHRoaXMgbGluZS4gd2h5IGFyZSB3ZSBhZGRpbmcg dGhlIApkZXNjcmlwdGlvbiBvZiBpbnRlbF9kc2JfcmVnX3dyaXRlKCkgaGVyZSA/CgpQbGVhc2Ug a2VlcCB0aGlzIHNpbXBsZSBhbmQgZXhwbGFpbiBvbmx5IGZ1bmN0aW9uIHVuZGVyIGRlc2NyaXB0 aW9uLgoKPiBEdXJpbmcgY29tbWFuZCBidWZmZXIgb3ZlcmZsb3csIGEgd2FybmluZwo+ICsgKiBp cyB0aHJvd24gYW5kIHJlc3QgYWxsIGVycm9uZW91cyBjb25kaXRpb24gcmVnaXN0ZXIgcHJvZ3Jh bW1pbmcgaXMgZG9uZQo+ICsgKiB0aHJvdWdoIG1taW8gd3JpdGUuCj4gKyAqLwo+ICsKPiAgIHZv aWQgaW50ZWxfZHNiX2luZGV4ZWRfcmVnX3dyaXRlKHN0cnVjdCBpbnRlbF9kc2IgKmRzYiwgaTkx NV9yZWdfdCByZWcsCj4gICAJCQkJIHUzMiB2YWwpCj4gICB7Cj4gQEAgLTIwMSw2ICsyNTAsMTgg QEAgdm9pZCBpbnRlbF9kc2JfaW5kZXhlZF9yZWdfd3JpdGUoc3RydWN0IGludGVsX2RzYiAqZHNi LCBpOTE1X3JlZ190IHJlZywKPiAgIAkJYnVmW2RzYi0+ZnJlZV9wb3NdID0gMDsKPiAgIH0KPiAg IAo+ICsvKioKPiArICogaW50ZWxfZHNiX3JlZ193cml0ZSgpIC1Xcml0ZSB0byB0aGUgZHNiIGNv bnRleHQgZm9yIG5vcm1hbAo+ICsgKiByZWdpc3Rlci4KPiArICogQGRzYjogaW50ZWxfZHNiIHN0 cnVjdHVyZS4KPiArICogQHJlZzogcmVnaXN0ZXIgYWRkcmVzcy4KPiArICogQHZhbDogdmFsdWUu Cj4gKyAqCj4gKyAqIFRoaXMgZnVuY3Rpb24gaXMgdXNlZCBmb3Igd3JpdGluZyByZWdpc3Rlci12 YWx1ZSBwYWlyIGluIGNvbW1hbmQKPiArICogYnVmZmVyIG9mIERTQi4gRHVyaW5nIGNvbW1hbmQg YnVmZmVyIG92ZXJmbG93LCBhIHdhcm5pbmcKPiArICogaXMgdGhyb3duIGFuZCByZXN0IGFsbCBl cnJvbmVvdXMgY29uZGl0aW9uIHJlZ2lzdGVyIHByb2dyYW1taW5nIGlzIGRvbmUKPiArICogdGhy b3VnaCBtbWlvIHdyaXRlLgo+ICsgKi8KPiAgIHZvaWQgaW50ZWxfZHNiX3JlZ193cml0ZShzdHJ1 Y3QgaW50ZWxfZHNiICpkc2IsIGk5MTVfcmVnX3QgcmVnLCB1MzIgdmFsKQo+ICAgewo+ICAgCXN0 cnVjdCBpbnRlbF9jcnRjICpjcnRjID0gY29udGFpbmVyX29mKGRzYiwgdHlwZW9mKCpjcnRjKSwg ZHNiKTsKPiBAQCAtMjIzLDYgKzI4NCwxMyBAQCB2b2lkIGludGVsX2RzYl9yZWdfd3JpdGUoc3Ry dWN0IGludGVsX2RzYiAqZHNiLCBpOTE1X3JlZ190IHJlZywgdTMyIHZhbCkKPiAgIAkJCSAgICAg ICBpOTE1X21taW9fcmVnX29mZnNldChyZWcpOwo+ICAgfQo+ICAgCj4gKy8qKgo+ICsgKiBpbnRl bF9kc2JfY29tbWl0KCkgLSBUcmlnZ2VyIHdvcmtsb2FkIGV4ZWN1dGlvbiBvZiBEU0IuCj4gKyAq IEBkc2I6IGludGVsX2RzYiBzdHJ1Y3R1cmUuCj4gKyAqCj4gKyAqIFRoaXMgZnVuY3Rpb24gaXMg dXNlZCB0byBkbyBhY3R1YWwgd3JpdGUgdG8gaGFyZHdhcmUgdXNpbmcgRFNCLgo+ICsgKiBPbiBl cnJvcnMsIGZhbGwgYmFjayB0byBNTUlPLiBBbHNvIHRoaXMgZnVuY3Rpb24gaGVscCB0byByZXNl dCB0aGUgY29udGV4dC4KPiArICovCj4gICB2b2lkIGludGVsX2RzYl9jb21taXQoc3RydWN0IGlu dGVsX2RzYiAqZHNiKQo+ICAgewo+ICAgCXN0cnVjdCBpbnRlbF9jcnRjICpjcnRjID0gY29udGFp bmVyX29mKGRzYiwgdHlwZW9mKCpjcnRjKSwgZHNiKTsKCldpdGggdGhlIGNvbW1lbnRzIGFib3Zl IGZpeGVkLCBQbGVhc2UgZmVlbCBmcmVlIHRvIHVzZToKClJldmlld2VkLWJ5OiBTaGFzaGFuayBT aGFybWEgPHNoYXNoYW5rLnNoYXJtYUBpbnRlbC5jb20+CgpSZWdhcmRzCgpTaGFzaGFuawoKX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KSW50ZWwtZ2Z4IG1h aWxpbmcgbGlzdApJbnRlbC1nZnhAbGlzdHMuZnJlZWRlc2t0b3Aub3JnCmh0dHBzOi8vbGlzdHMu ZnJlZWRlc2t0b3Aub3JnL21haWxtYW4vbGlzdGluZm8vaW50ZWwtZ2Z4