From mboxrd@z Thu Jan 1 00:00:00 1970 From: Animesh Manna Subject: [PATCH v7 10/10] drm/i915/dsb: Documentation for DSB. Date: Wed, 18 Sep 2019 13:27:45 +0530 Message-ID: <20190918075745.17076-11-animesh.manna@intel.com> References: <20190918075745.17076-1-animesh.manna@intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by gabe.freedesktop.org (Postfix) with ESMTPS id 899FA6EE3F for ; Wed, 18 Sep 2019 08:06:14 +0000 (UTC) In-Reply-To: <20190918075745.17076-1-animesh.manna@intel.com> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: intel-gfx@lists.freedesktop.org Cc: Jani Nikula List-Id: intel-gfx@lists.freedesktop.org QWRkZWQgZG9jYm9vayBpbmZvIHJlZ2FyZGluZyBEaXNwbGF5IFN0YXRlIEJ1ZmZlcihEU0IpIHdo aWNoCmlzIGFkZGVkIGZyb20gZ2VuMTIgb253YXJkcyB0byBiYXRjaCBzdWJtaXQgZGlzcGxheSBI VyBwcm9ncmFtbWluZy4KCnYxOiBJbml0aWFsIHZlcnNpb24gYXMgUkZDLgoKQ2M6IEphbmkgTmlr dWxhIDxqYW5pLm5pa3VsYUBpbnRlbC5jb20+CkNjOiBSb2RyaWdvIFZpdmkgPHJvZHJpZ28udml2 aUBpbnRlbC5jb20+CkNjOiBTaGFzaGFuayBTaGFybWEgPHNoYXNoYW5rLnNoYXJtYUBpbnRlbC5j b20+ClNpZ25lZC1vZmYtYnk6IEFuaW1lc2ggTWFubmEgPGFuaW1lc2gubWFubmFAaW50ZWwuY29t PgotLS0KIERvY3VtZW50YXRpb24vZ3B1L2k5MTUucnN0ICAgICAgICAgICAgICAgfCAgOSArKysr CiBkcml2ZXJzL2dwdS9kcm0vaTkxNS9kaXNwbGF5L2ludGVsX2RzYi5jIHwgNjggKysrKysrKysr KysrKysrKysrKysrKysrCiAyIGZpbGVzIGNoYW5nZWQsIDc3IGluc2VydGlvbnMoKykKCmRpZmYg LS1naXQgYS9Eb2N1bWVudGF0aW9uL2dwdS9pOTE1LnJzdCBiL0RvY3VtZW50YXRpb24vZ3B1L2k5 MTUucnN0CmluZGV4IGUyNDllYTdiMGVjNy4uNDY1Nzc5NjcwZmQ0IDEwMDY0NAotLS0gYS9Eb2N1 bWVudGF0aW9uL2dwdS9pOTE1LnJzdAorKysgYi9Eb2N1bWVudGF0aW9uL2dwdS9pOTE1LnJzdApA QCAtMjQ2LDYgKzI0NiwxNSBAQCBEaXNwbGF5IFBMTHMKIC4uIGtlcm5lbC1kb2M6OiBkcml2ZXJz L2dwdS9kcm0vaTkxNS9kaXNwbGF5L2ludGVsX2RwbGxfbWdyLmgKICAgIDppbnRlcm5hbDoKIAor RGlzcGxheSBTdGF0ZSBCdWZmZXIKKy0tLS0tLS0tLS0tLS0tLS0tLS0tCisKKy4uIGtlcm5lbC1k b2M6OiBkcml2ZXJzL2dwdS9kcm0vaTkxNS9kaXNwbGF5L2ludGVsX2RzYi5jCisgICA6ZG9jOiBE U0IKKworLi4ga2VybmVsLWRvYzo6IGRyaXZlcnMvZ3B1L2RybS9pOTE1L2Rpc3BsYXkvaW50ZWxf ZHNiLmMKKyAgIDppbnRlcm5hbDoKKwogTWVtb3J5IE1hbmFnZW1lbnQgYW5kIENvbW1hbmQgU3Vi bWlzc2lvbgogPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQogCmRpZmYg LS1naXQgYS9kcml2ZXJzL2dwdS9kcm0vaTkxNS9kaXNwbGF5L2ludGVsX2RzYi5jIGIvZHJpdmVy cy9ncHUvZHJtL2k5MTUvZGlzcGxheS9pbnRlbF9kc2IuYwppbmRleCBjYmY3ZjJjMzMwMGMuLjVi NTI3OGM5NGNhNyAxMDA2NDQKLS0tIGEvZHJpdmVycy9ncHUvZHJtL2k5MTUvZGlzcGxheS9pbnRl bF9kc2IuYworKysgYi9kcml2ZXJzL2dwdS9kcm0vaTkxNS9kaXNwbGF5L2ludGVsX2RzYi5jCkBA IC05LDYgKzksMjMgQEAKIAogI2RlZmluZSBEU0JfQlVGX1NJWkUgICAgKDIgKiBQQUdFX1NJWkUp CiAKKy8qKgorICogRE9DOiBEU0IKKyAqCisgKiBBIERTQiAoRGlzcGxheSBTdGF0ZSBCdWZmZXIp IGlzIGEgcXVldWUgb2YgTU1JTyBpbnN0cnVjdGlvbnMgaW4gdGhlIG1lbW9yeQorICogd2hpY2gg Y2FuIGJlIG9mZmxvYWRlZCB0byBEU0IgSFcgaW4gRGlzcGxheSBDb250cm9sbGVyLiBEU0IgSFcg aXMgYSBETUEKKyAqIGVuZ2luZSB0aGF0IGNhbiBiZSBwcm9ncmFtbWVkIHRvIGRvd25sb2FkIHRo ZSBEU0IgZnJvbSBtZW1vcnkuCisgKiBJdCBhbGxvd3MgZHJpdmVyIHRvIGJhdGNoIHN1Ym1pdCBk aXNwbGF5IEhXIHByb2dyYW1taW5nLiBUaGlzIGhlbHBzIHRvCisgKiByZWR1Y2UgbG9hZGluZyB0 aW1lIGFuZCBDUFUgYWN0aXZpdHksIHRoZXJlYnkgbWFraW5nIHRoZSBjb250ZXh0IHN3aXRjaAor ICogZmFzdGVyLiBEU0IgU3VwcG9ydCBhZGRlZCBmcm9tIEdlbjEyIEludGVsIGdyYXBoaWNzIGJh c2VkIHBsYXRmb3JtLgorICoKKyAqIERTQidzIGNhbiBhY2Nlc3Mgb25seSB0aGUgcGlwZSwgcGxh bmUsIGFuZCB0cmFuc2NvZGVyIERhdGEgSXNsYW5kIFBhY2tldAorICogcmVnaXN0ZXJzLgorICoK KyAqIERTQiBIVyBjYW4gc3VwcG9ydCBvbmx5IHJlZ2lzdGVyIHdyaXRlcyAoYm90aCBpbmRleGVk IGFuZCBkaXJlY3QgTU1JTworICogd3JpdGVzKS4gVGhlcmUgYXJlIG5vIHJlZ2lzdGVycyByZWFk cyBwb3NzaWJsZSB3aXRoIERTQiBIVyBlbmdpbmUuCisgKi8KKwogLyogRFNCIG9wY29kZXMuICov CiAjZGVmaW5lIERTQl9PUENPREVfU0hJRlQJCTI0CiAjZGVmaW5lIERTQl9PUENPREVfTU1JT19X UklURQkJMHgxCkBAIC02Niw2ICs4MywxNyBAQCBzdGF0aWMgaW5saW5lIGJvb2wgaW50ZWxfZHNi X2Rpc2FibGVfZW5naW5lKHN0cnVjdCBpbnRlbF9kc2IgKmRzYikKIAlyZXR1cm4gdHJ1ZTsKIH0K IAorLyoqCisgKiBpbnRlbF9kc2JfZ2V0KCkgLSBBbGxvY2F0ZSBkc2IgY29udGV4dCBhbmQgcmV0 dXJuIGEgZHNiIGluc3RhbmNlLgorICogQGNydGM6IGludGVsX2NydGMgc3RydWN0dXJlIHRvIGdl dCBwaXBlIGluZm8uCisgKgorICogVGhpcyBmdW5jdGlvbiB3aWxsIGdpdmUgaGFuZGxlIG9mIHRo ZSBEU0IgaW5zdGFuY2Ugd2hpY2gKKyAqIHVzZXIgd2FudCB0byBvcGVyYXRlIG9uLgorICoKKyAq IFJldHVybiA6IGFkZHJlc3Mgb2YgSW50ZWxfZHNiIGluc3RhbmNlIHJlcXVlc3RlZCBmb3IuCisg KiBJbiBmYWlsdXJlIGNhc2UsIHRoZSBkc2IgaW5zdGFuY2Ugd2lsbCBub3QgaGF2ZSBhbnkgY29t bWFuZCBidWZmZXIuCisgKi8KKwogc3RydWN0IGludGVsX2RzYiAqCiBpbnRlbF9kc2JfZ2V0KHN0 cnVjdCBpbnRlbF9jcnRjICpjcnRjKQogewpAQCAtMTE2LDYgKzE0NCwxNCBAQCBpbnRlbF9kc2Jf Z2V0KHN0cnVjdCBpbnRlbF9jcnRjICpjcnRjKQogCXJldHVybiBkc2I7CiB9CiAKKy8qKgorICog aW50ZWxfZHNiX3B1dCgpIC0gVG8gZGVzdHJveSBEU0IgY29udGV4dC4KKyAqIEBkc2I6IGludGVs X2RzYiBzdHJ1Y3R1cmUuCisgKgorICogVGhpcyBmdW5jdGlvbiBpcyB1c2VkIHRvIGRlc3Ryb3kg dGhlIGRzYi1jb250ZXh0IGJ5IGRvaW5nIHVucGluCisgKiBhbmQgcmVsZWFzZSB0aGUgdm1hIG9i amVjdC4KKyAqLworCiB2b2lkIGludGVsX2RzYl9wdXQoc3RydWN0IGludGVsX2RzYiAqZHNiKQog ewogCXN0cnVjdCBpbnRlbF9jcnRjICpjcnRjID0gY29udGFpbmVyX29mKGRzYiwgdHlwZW9mKCpj cnRjKSwgZHNiKTsKQEAgLTEzNyw2ICsxNzMsMTkgQEAgdm9pZCBpbnRlbF9kc2JfcHV0KHN0cnVj dCBpbnRlbF9kc2IgKmRzYikKIAl9CiB9CiAKKy8qKgorICogaW50ZWxfZHNiX2luZGV4ZWRfcmVn X3dyaXRlKCkgLVdyaXRlIHRvIHRoZSBkc2IgY29udGV4dCBmb3IgYXV0bworICogaW5jcmVtZW50 IHJlZ2lzdGVyLgorICogQGRzYjogaW50ZWxfZHNiIHN0cnVjdHVyZS4KKyAqIEByZWc6IHJlZ2lz dGVyIGFkZHJlc3MuCisgKiBAdmFsOiB2YWx1ZS4KKyAqCisgKiBUaGlzIGZ1bmN0aW9uIGlzIHVz ZWQgZm9yIGF1dG8taW5jcmVtZW50IHJlZ2lzdGVyIGFuZCBpbnRlbF9kc2JfcmVnX3dyaXRlKCkK KyAqIGlzIHVzZWQgZm9yIG5vcm1hbCByZWdpc3Rlci4gRHVyaW5nIGNvbW1hbmQgYnVmZmVyIG92 ZXJmbG93LCBhIHdhcm5pbmcKKyAqIGlzIHRocm93biBhbmQgcmVzdCBhbGwgZXJyb25lb3VzIGNv bmRpdGlvbiByZWdpc3RlciBwcm9ncmFtbWluZyBpcyBkb25lCisgKiB0aHJvdWdoIG1taW8gd3Jp dGUuCisgKi8KKwogdm9pZCBpbnRlbF9kc2JfaW5kZXhlZF9yZWdfd3JpdGUoc3RydWN0IGludGVs X2RzYiAqZHNiLCBpOTE1X3JlZ190IHJlZywKIAkJCQkgdTMyIHZhbCkKIHsKQEAgLTIwMSw2ICsy NTAsMTggQEAgdm9pZCBpbnRlbF9kc2JfaW5kZXhlZF9yZWdfd3JpdGUoc3RydWN0IGludGVsX2Rz YiAqZHNiLCBpOTE1X3JlZ190IHJlZywKIAkJYnVmW2RzYi0+ZnJlZV9wb3NdID0gMDsKIH0KIAor LyoqCisgKiBpbnRlbF9kc2JfcmVnX3dyaXRlKCkgLVdyaXRlIHRvIHRoZSBkc2IgY29udGV4dCBm b3Igbm9ybWFsCisgKiByZWdpc3Rlci4KKyAqIEBkc2I6IGludGVsX2RzYiBzdHJ1Y3R1cmUuCisg KiBAcmVnOiByZWdpc3RlciBhZGRyZXNzLgorICogQHZhbDogdmFsdWUuCisgKgorICogVGhpcyBm dW5jdGlvbiBpcyB1c2VkIGZvciB3cml0aW5nIHJlZ2lzdGVyLXZhbHVlIHBhaXIgaW4gY29tbWFu ZAorICogYnVmZmVyIG9mIERTQi4gRHVyaW5nIGNvbW1hbmQgYnVmZmVyIG92ZXJmbG93LCBhIHdh cm5pbmcKKyAqIGlzIHRocm93biBhbmQgcmVzdCBhbGwgZXJyb25lb3VzIGNvbmRpdGlvbiByZWdp c3RlciBwcm9ncmFtbWluZyBpcyBkb25lCisgKiB0aHJvdWdoIG1taW8gd3JpdGUuCisgKi8KIHZv aWQgaW50ZWxfZHNiX3JlZ193cml0ZShzdHJ1Y3QgaW50ZWxfZHNiICpkc2IsIGk5MTVfcmVnX3Qg cmVnLCB1MzIgdmFsKQogewogCXN0cnVjdCBpbnRlbF9jcnRjICpjcnRjID0gY29udGFpbmVyX29m KGRzYiwgdHlwZW9mKCpjcnRjKSwgZHNiKTsKQEAgLTIyMyw2ICsyODQsMTMgQEAgdm9pZCBpbnRl bF9kc2JfcmVnX3dyaXRlKHN0cnVjdCBpbnRlbF9kc2IgKmRzYiwgaTkxNV9yZWdfdCByZWcsIHUz MiB2YWwpCiAJCQkgICAgICAgaTkxNV9tbWlvX3JlZ19vZmZzZXQocmVnKTsKIH0KIAorLyoqCisg KiBpbnRlbF9kc2JfY29tbWl0KCkgLSBUcmlnZ2VyIHdvcmtsb2FkIGV4ZWN1dGlvbiBvZiBEU0Iu CisgKiBAZHNiOiBpbnRlbF9kc2Igc3RydWN0dXJlLgorICoKKyAqIFRoaXMgZnVuY3Rpb24gaXMg dXNlZCB0byBkbyBhY3R1YWwgd3JpdGUgdG8gaGFyZHdhcmUgdXNpbmcgRFNCLgorICogT24gZXJy b3JzLCBmYWxsIGJhY2sgdG8gTU1JTy4gQWxzbyB0aGlzIGZ1bmN0aW9uIGhlbHAgdG8gcmVzZXQg dGhlIGNvbnRleHQuCisgKi8KIHZvaWQgaW50ZWxfZHNiX2NvbW1pdChzdHJ1Y3QgaW50ZWxfZHNi ICpkc2IpCiB7CiAJc3RydWN0IGludGVsX2NydGMgKmNydGMgPSBjb250YWluZXJfb2YoZHNiLCB0 eXBlb2YoKmNydGMpLCBkc2IpOwotLSAKMi4yMi4wCgpfX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fXwpJbnRlbC1nZnggbWFpbGluZyBsaXN0CkludGVsLWdmeEBs aXN0cy5mcmVlZGVza3RvcC5vcmcKaHR0cHM6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1h bi9saXN0aW5mby9pbnRlbC1nZng=