From: =?UTF-8?q?Noralf=20Tr=C3=B8nnes?= Subject: [PATCH v3 3/7] drm/drv: DOC: Add driver example code Date: Mon, 25 Feb 2019 15:42:28 +0100 Message-ID: <20190225144232.20761-4-noralf@tronnes.org> References: <20190225144232.20761-1-noralf@tronnes.org> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <20190225144232.20761-1-noralf@tronnes.org> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: dri-devel@lists.freedesktop.org Cc: david@lechnology.com, daniel.vetter@ffwll.ch, intel-gfx@lists.freedesktop.org, sam@ravnborg.org List-Id: dri-devel@lists.freedesktop.org QWRkIGRyaXZlciBleGFtcGxlIHRoYXQgc2hvd3MgaG93IGRldm1fZHJtX2Rldl9pbml0KCkgY2Fu IGJlIHVzZWQuCgp2MjogRXhwYW5kIGRvY3MgKFNhbSwgRGFuaWVsKQoKU2lnbmVkLW9mZi1ieTog Tm9yYWxmIFRyw7hubmVzIDxub3JhbGZAdHJvbm5lcy5vcmc+CkFja2VkLWJ5OiBEYW5pZWwgVmV0 dGVyIDxkYW5pZWwudmV0dGVyQGZmd2xsLmNoPgotLS0KIGRyaXZlcnMvZ3B1L2RybS9kcm1fZHJ2 LmMgfCAxMzIgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysKIDEgZmlsZSBj aGFuZ2VkLCAxMzIgaW5zZXJ0aW9ucygrKQoKZGlmZiAtLWdpdCBhL2RyaXZlcnMvZ3B1L2RybS9k cm1fZHJ2LmMgYi9kcml2ZXJzL2dwdS9kcm0vZHJtX2Rydi5jCmluZGV4IDkzNDc4MGE0YzAzMy4u NTBkODQ5ZDFiYzZlIDEwMDY0NAotLS0gYS9kcml2ZXJzL2dwdS9kcm0vZHJtX2Rydi5jCisrKyBi L2RyaXZlcnMvZ3B1L2RybS9kcm1fZHJ2LmMKQEAgLTI4Niw2ICsyODYsMTM4IEBAIHZvaWQgZHJt X21pbm9yX3JlbGVhc2Uoc3RydWN0IGRybV9taW5vciAqbWlub3IpCiAgKiBOb3RlIHRoYXQgdGhl IGxpZmV0aW1lIHJ1bGVzIGZvciAmZHJtX2RldmljZSBpbnN0YW5jZSBoYXMgc3RpbGwgYSBsb3Qg b2YKICAqIGhpc3RvcmljYWwgYmFnZ2FnZS4gSGVuY2UgdXNlIHRoZSByZWZlcmVuY2UgY291bnRp bmcgcHJvdmlkZWQgYnkKICAqIGRybV9kZXZfZ2V0KCkgYW5kIGRybV9kZXZfcHV0KCkgb25seSBj YXJlZnVsbHkuCisgKgorICogRGlzcGxheSBkcml2ZXIgZXhhbXBsZQorICogfn5+fn5+fn5+fn5+ fn5+fn5+fn5+fgorICoKKyAqIFRoZSBmb2xsb3dpbmcgZXhhbXBsZSBzaG93cyBhIHR5cGljYWwg c3RydWN0dXJlIG9mIGEgRFJNIGRpc3BsYXkgZHJpdmVyLgorICogVGhlIGV4YW1wbGUgZm9jdXMg b24gdGhlIHByb2JlKCkgZnVuY3Rpb24gYW5kIHRoZSBvdGhlciBmdW5jdGlvbnMgdGhhdCBpcwor ICogYWxtb3N0IGFsd2F5cyBwcmVzZW50IGFuZCBzZXJ2ZXMgYXMgYSBkZW1vbnN0cmF0aW9uIG9m IGRldm1fZHJtX2Rldl9pbml0KCkKKyAqIHVzYWdlIHdpdGggaXRzIGFjY29tcGFueWluZyBkcm1f ZHJpdmVyLT5yZWxlYXNlIGNhbGxiYWNrLgorICoKKyAqIC4uIGNvZGUtYmxvY2s6OiBjCisgKgor ICoJc3RydWN0IGRyaXZlcl9kZXZpY2UgeworICoJCXN0cnVjdCBkcm1fZGV2aWNlIGRybTsKKyAq CQl2b2lkICp1c2Vyc3BhY2VfZmFjaW5nOworICoJCXN0cnVjdCBjbGsgKnBjbGs7CisgKgl9Owor ICoKKyAqCXN0YXRpYyB2b2lkIGRyaXZlcl9kcm1fcmVsZWFzZShzdHJ1Y3QgZHJtX2RldmljZSAq ZHJtKQorICoJeworICoJCXN0cnVjdCBkcml2ZXJfZGV2aWNlICpwcml2ID0gY29udGFpbmVyX29m KC4uLik7CisgKgorICoJCWRybV9tb2RlX2NvbmZpZ19jbGVhbnVwKGRybSk7CisgKgkJZHJtX2Rl dl9maW5pKGRybSk7CisgKgkJa2ZyZWUocHJpdi0+dXNlcnNwYWNlX2ZhY2luZyk7CisgKgkJa2Zy ZWUocHJpdik7CisgKgl9CisgKgorICoJc3RhdGljIHN0cnVjdCBkcm1fZHJpdmVyIGRyaXZlcl9k cm1fZHJpdmVyID0geworICoJCVsuLi5dCisgKgkJLnJlbGVhc2UgPSBkcml2ZXJfZHJtX3JlbGVh c2UsCisgKgl9OworICoKKyAqCXN0YXRpYyBpbnQgZHJpdmVyX3Byb2JlKHN0cnVjdCBwbGF0Zm9y bV9kZXZpY2UgKnBkZXYpCisgKgl7CisgKgkJc3RydWN0IGRyaXZlcl9kZXZpY2UgKnByaXY7Cisg KgkJc3RydWN0IGRybV9kZXZpY2UgKmRybTsKKyAqCQlpbnQgcmV0OworICoKKyAqCQlbCisgKgkJ ICBkZXZtX2t6YWxsb2MoKSBjYW4ndCBiZSB1c2VkIGhlcmUgYmVjYXVzZSB0aGUgZHJtX2Rldmlj ZQorICoJCSAgbGlmZXRpbWUgY2FuIGV4Y2VlZCB0aGUgZGV2aWNlIGxpZmV0aW1lIGlmIGRyaXZl ciB1bmJpbmQKKyAqCQkgIGhhcHBlbnMgd2hlbiB1c2Vyc3BhY2Ugc3RpbGwgaGFzIG9wZW4gZmls ZSBkZXNjcmlwdG9ycy4KKyAqCQldCisgKgkJcHJpdiA9IGt6YWxsb2Moc2l6ZW9mKCpwcml2KSwg R0ZQX0tFUk5FTCk7CisgKgkJaWYgKCFwcml2KQorICoJCQlyZXR1cm4gLUVOT01FTTsKKyAqCisg KgkJZHJtID0gJnByaXYtPmRybTsKKyAqCisgKgkJcmV0ID0gZGV2bV9kcm1fZGV2X2luaXQoJnBk ZXYtPmRldiwgZHJtLCAmZHJpdmVyX2RybV9kcml2ZXIpOworICoJCWlmIChyZXQpIHsKKyAqCQkJ a2ZyZWUoZHJtKTsKKyAqCQkJcmV0dXJuIHJldDsKKyAqCQl9CisgKgorICoJCWRybV9tb2RlX2Nv bmZpZ19pbml0KGRybSk7CisgKgorICoJCXByaXYtPnVzZXJzcGFjZV9mYWNpbmcgPSBremFsbG9j KC4uLiwgR0ZQX0tFUk5FTCk7CisgKgkJaWYgKCFwcml2LT51c2Vyc3BhY2VfZmFjaW5nKQorICoJ CQlyZXR1cm4gLUVOT01FTTsKKyAqCisgKgkJcHJpdi0+cGNsayA9IGRldm1fY2xrX2dldChkZXYs ICJQQ0xLIik7CisgKgkJaWYgKElTX0VSUihwcml2LT5wY2xrKSkKKyAqCQkJcmV0dXJuIFBUUl9F UlIocHJpdi0+cGNsayk7CisgKgorICoJCVsgRnVydGhlciBzZXR1cCwgZGlzcGxheSBwaXBlbGlu ZSBldGMgXQorICoKKyAqCQlwbGF0Zm9ybV9zZXRfZHJ2ZGF0YShwZGV2LCBkcm0pOworICoKKyAq CQlkcm1fbW9kZV9jb25maWdfcmVzZXQoZHJtKTsKKyAqCisgKgkJcmV0ID0gZHJtX2Rldl9yZWdp c3Rlcihkcm0pOworICoJCWlmIChyZXQpCisgKgkJCXJldHVybiByZXQ7CisgKgorICoJCWRybV9m YmRldl9nZW5lcmljX3NldHVwKGRybSwgMzIpOworICoKKyAqCQlyZXR1cm4gMDsKKyAqCX0KKyAq CisgKglbIFRoaXMgZnVuY3Rpb24gaXMgY2FsbGVkIGJlZm9yZSB0aGUgZGV2bV8gcmVzb3VyY2Vz IGFyZSByZWxlYXNlZCBdCisgKglzdGF0aWMgaW50IGRyaXZlcl9yZW1vdmUoc3RydWN0IHBsYXRm b3JtX2RldmljZSAqcGRldikKKyAqCXsKKyAqCQlzdHJ1Y3QgZHJtX2RldmljZSAqZHJtID0gcGxh dGZvcm1fZ2V0X2RydmRhdGEocGRldik7CisgKgorICoJCWRybV9kZXZfdW5yZWdpc3Rlcihkcm0p OworICoJCWRybV9hdG9taWNfaGVscGVyX3NodXRkb3duKGRybSkKKyAqCisgKgkJcmV0dXJuIDA7 CisgKgl9CisgKgorICoJWyBUaGlzIGZ1bmN0aW9uIGlzIGNhbGxlZCBvbiBrZXJuZWwgcmVzdGFy dCBhbmQgc2h1dGRvd24gXQorICoJc3RhdGljIHZvaWQgZHJpdmVyX3NodXRkb3duKHN0cnVjdCBw bGF0Zm9ybV9kZXZpY2UgKnBkZXYpCisgKgl7CisgKgkJZHJtX2F0b21pY19oZWxwZXJfc2h1dGRv d24ocGxhdGZvcm1fZ2V0X2RydmRhdGEocGRldikpOworICoJfQorICoKKyAqCXN0YXRpYyBpbnQg X19tYXliZV91bnVzZWQgZHJpdmVyX3BtX3N1c3BlbmQoc3RydWN0IGRldmljZSAqZGV2KQorICoJ eworICoJCXJldHVybiBkcm1fbW9kZV9jb25maWdfaGVscGVyX3N1c3BlbmQoZGV2X2dldF9kcnZk YXRhKGRldikpOworICoJfQorICoKKyAqCXN0YXRpYyBpbnQgX19tYXliZV91bnVzZWQgZHJpdmVy X3BtX3Jlc3VtZShzdHJ1Y3QgZGV2aWNlICpkZXYpCisgKgl7CisgKgkJZHJtX21vZGVfY29uZmln X2hlbHBlcl9yZXN1bWUoZGV2X2dldF9kcnZkYXRhKGRldikpOworICoKKyAqCQlyZXR1cm4gMDsK KyAqCX0KKyAqCisgKglzdGF0aWMgY29uc3Qgc3RydWN0IGRldl9wbV9vcHMgZHJpdmVyX3BtX29w cyA9IHsKKyAqCQlTRVRfU1lTVEVNX1NMRUVQX1BNX09QUyhkcml2ZXJfcG1fc3VzcGVuZCwgZHJp dmVyX3BtX3Jlc3VtZSkKKyAqCX07CisgKgorICoJc3RhdGljIHN0cnVjdCBwbGF0Zm9ybV9kcml2 ZXIgZHJpdmVyX2RyaXZlciA9IHsKKyAqCQkuZHJpdmVyID0geworICoJCQlbLi4uXQorICoJCQku cG0gPSAmZHJpdmVyX3BtX29wcywKKyAqCQl9LAorICoJCS5wcm9iZSA9IGRyaXZlcl9wcm9iZSwK KyAqCQkucmVtb3ZlID0gZHJpdmVyX3JlbW92ZSwKKyAqCQkuc2h1dGRvd24gPSBkcml2ZXJfc2h1 dGRvd24sCisgKgl9OworICoJbW9kdWxlX3BsYXRmb3JtX2RyaXZlcihkcml2ZXJfZHJpdmVyKTsK KyAqCisgKiBEcml2ZXJzIHRoYXQgd2FudCB0byBzdXBwb3J0IGRldmljZSB1bnBsdWdnaW5nIChV U0IsIERUIG92ZXJsYXkgdW5sb2FkKSBzaG91bGQKKyAqIHVzZSBkcm1fZGV2X3VucGx1ZygpIGlu c3RlYWQgb2YgZHJtX2Rldl91bnJlZ2lzdGVyKCkuIFRoZSBkcml2ZXIgbXVzdCBwcm90ZWN0Cisg KiByZWdpb25zIHRoYXQgaXMgYWNjZXNzaW5nIGRldmljZSByZXNvdXJjZXMgdG8gcHJldmVudCB1 c2UgYWZ0ZXIgdGhleSdyZQorICogcmVsZWFzZWQuIFRoaXMgaXMgZG9uZSB1c2luZyBkcm1fZGV2 X2VudGVyKCkgYW5kIGRybV9kZXZfZXhpdCgpLiBUaGVyZSBpcyBvbmUKKyAqIHNob3J0Y29taW5n IGhvd2V2ZXIsIGRybV9kZXZfdW5wbHVnKCkgbWFya3MgdGhlIGRybV9kZXZpY2UgYXMgdW5wbHVn Z2VkIGJlZm9yZQorICogZHJtX2F0b21pY19oZWxwZXJfc2h1dGRvd24oKSBpcyBjYWxsZWQuIFRo aXMgbWVhbnMgdGhhdCBpZiB0aGUgZGlzYWJsZSBjb2RlCisgKiBwYXRocyBhcmUgcHJvdGVjdGVk LCB0aGV5IHdpbGwgbm90IHJ1biBvbiByZWd1bGFyIGRyaXZlciBtb2R1bGUgdW5sb2FkLAorICog cG9zc2liaWx5IGxlYXZpbmcgdGhlIGhhcmR3YXJlIGVuYWJsZWQuCiAgKi8KIAogLyoqCi0tIAoy LjIwLjEKCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmRy aS1kZXZlbCBtYWlsaW5nIGxpc3QKZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRw czovL2xpc3RzLmZyZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2RyaS1kZXZlbA==