From mboxrd@z Thu Jan 1 00:00:00 1970 From: Hans Verkuil Subject: Re: [PATCH v5 11/11] DocBook/media: add CEC documentation Date: Sun, 03 May 2015 12:59:17 +0200 Message-ID: <5545FF85.2050508@xs4all.nl> References: <1430301765-22202-1-git-send-email-k.debski@samsung.com> <1430301765-22202-12-git-send-email-k.debski@samsung.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <1430301765-22202-12-git-send-email-k.debski@samsung.com> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: Kamil Debski , dri-devel@lists.freedesktop.org, linux-media@vger.kernel.org Cc: linux-samsung-soc@vger.kernel.org, sean@mess.org, mchehab@osg.samsung.com, dmitry.torokhov@gmail.com, lars@opdenkamp.eu, Hans Verkuil , kyungmin.park@samsung.com, thomas@tommie-lie.de, linux-input@vger.kernel.org, m.szyprowski@samsung.com List-Id: linux-input@vger.kernel.org U29tZSBjb21tZW50czoKCk9uIDA0LzI5LzIwMTUgMTI6MDIgUE0sIEthbWlsIERlYnNraSB3cm90 ZToKPiBGcm9tOiBIYW5zIFZlcmt1aWwgPGh2ZXJrdWlsQHhzNGFsbC5ubD4KPiAKPiBBZGQgRG9j Qm9vayBkb2N1bWVudGF0aW9uIGZvciB0aGUgQ0VDIEFQSS4KPiAKPiBTaWduZWQtb2ZmLWJ5OiBI YW5zIFZlcmt1aWwgPGhhbnN2ZXJrQGNpc2NvLmNvbT4KPiBbay5kZWJza2lAc2Ftc3VuZy5jb206 IGFkZCBkb2N1bWVudGF0aW9uIGZvciBwYXNzdGhyb3VnaCBtb2RlXQo+IFtrLmRlYnNraUBzYW1z dW5nLmNvbTogbWlub3IgZml4ZXMgYW5kIGNoYW5nZSBvZiByZXNlcnZlZCBmaWVsZCBzaXplc10K PiBTaWduZWQtb2ZmLWJ5OiBLYW1pbCBEZWJza2kgPGsuZGVic2tpQHNhbXN1bmcuY29tPgo+IC0t LQo+ICBEb2N1bWVudGF0aW9uL0RvY0Jvb2svbWVkaWEvTWFrZWZpbGUgICAgICAgICAgICAgICB8 ICAgIDQgKy0KPiAgRG9jdW1lbnRhdGlvbi9Eb2NCb29rL21lZGlhL3Y0bC9iaWJsaW8ueG1sICAg ICAgICAgfCAgIDEwICsKPiAgRG9jdW1lbnRhdGlvbi9Eb2NCb29rL21lZGlhL3Y0bC9jZWMtYXBp LnhtbCAgICAgICAgfCAgIDc0ICsrKysrKwo+ICBEb2N1bWVudGF0aW9uL0RvY0Jvb2svbWVkaWEv djRsL2NlYy1mdW5jLWNsb3NlLnhtbCB8ICAgNTkgKysrKysKPiAgRG9jdW1lbnRhdGlvbi9Eb2NC b29rL21lZGlhL3Y0bC9jZWMtZnVuYy1pb2N0bC54bWwgfCAgIDczICsrKysrKwo+ICBEb2N1bWVu dGF0aW9uL0RvY0Jvb2svbWVkaWEvdjRsL2NlYy1mdW5jLW9wZW4ueG1sICB8ICAgOTQgKysrKysr Kwo+ICBEb2N1bWVudGF0aW9uL0RvY0Jvb2svbWVkaWEvdjRsL2NlYy1mdW5jLXBvbGwueG1sICB8 ICAgODkgKysrKysrKwo+ICAuLi4vRG9jQm9vay9tZWRpYS92NGwvY2VjLWlvYy1nLWFkYXAtbG9n LWFkZHJzLnhtbCB8ICAyNzUgKysrKysrKysrKysrKysrKysrKysKPiAgLi4uL0RvY0Jvb2svbWVk aWEvdjRsL2NlYy1pb2MtZy1hZGFwLXBoeXMtYWRkci54bWwgfCAgIDc4ICsrKysrKwo+ICAuLi4v RG9jQm9vay9tZWRpYS92NGwvY2VjLWlvYy1nLWFkYXAtc3RhdGUueG1sICAgICB8ICAgODcgKysr KysrKwo+ICBEb2N1bWVudGF0aW9uL0RvY0Jvb2svbWVkaWEvdjRsL2NlYy1pb2MtZy1jYXBzLnht bCB8ICAxNjcgKysrKysrKysrKysrCj4gIC4uLi9Eb2NCb29rL21lZGlhL3Y0bC9jZWMtaW9jLWct ZXZlbnQueG1sICAgICAgICAgIHwgIDE0MiArKysrKysrKysrCj4gIC4uLi9Eb2NCb29rL21lZGlh L3Y0bC9jZWMtaW9jLWctdmVuZG9yLWlkLnhtbCAgICAgIHwgICA3MCArKysrKwo+ICAuLi4vRG9j Qm9vay9tZWRpYS92NGwvY2VjLWlvYy1yZWNlaXZlLnhtbCAgICAgICAgICB8ICAxODUgKysrKysr KysrKysrKwo+ICBEb2N1bWVudGF0aW9uL0RvY0Jvb2svbWVkaWFfYXBpLnRtcGwgICAgICAgICAg ICAgICB8ICAgIDYgKy0KPiAgMTUgZmlsZXMgY2hhbmdlZCwgMTQxMCBpbnNlcnRpb25zKCspLCAz IGRlbGV0aW9ucygtKQo+ICBjcmVhdGUgbW9kZSAxMDA2NDQgRG9jdW1lbnRhdGlvbi9Eb2NCb29r L21lZGlhL3Y0bC9jZWMtYXBpLnhtbAo+ICBjcmVhdGUgbW9kZSAxMDA2NDQgRG9jdW1lbnRhdGlv bi9Eb2NCb29rL21lZGlhL3Y0bC9jZWMtZnVuYy1jbG9zZS54bWwKPiAgY3JlYXRlIG1vZGUgMTAw NjQ0IERvY3VtZW50YXRpb24vRG9jQm9vay9tZWRpYS92NGwvY2VjLWZ1bmMtaW9jdGwueG1sCj4g IGNyZWF0ZSBtb2RlIDEwMDY0NCBEb2N1bWVudGF0aW9uL0RvY0Jvb2svbWVkaWEvdjRsL2NlYy1m dW5jLW9wZW4ueG1sCj4gIGNyZWF0ZSBtb2RlIDEwMDY0NCBEb2N1bWVudGF0aW9uL0RvY0Jvb2sv bWVkaWEvdjRsL2NlYy1mdW5jLXBvbGwueG1sCj4gIGNyZWF0ZSBtb2RlIDEwMDY0NCBEb2N1bWVu dGF0aW9uL0RvY0Jvb2svbWVkaWEvdjRsL2NlYy1pb2MtZy1hZGFwLWxvZy1hZGRycy54bWwKPiAg Y3JlYXRlIG1vZGUgMTAwNjQ0IERvY3VtZW50YXRpb24vRG9jQm9vay9tZWRpYS92NGwvY2VjLWlv Yy1nLWFkYXAtcGh5cy1hZGRyLnhtbAo+ICBjcmVhdGUgbW9kZSAxMDA2NDQgRG9jdW1lbnRhdGlv bi9Eb2NCb29rL21lZGlhL3Y0bC9jZWMtaW9jLWctYWRhcC1zdGF0ZS54bWwKPiAgY3JlYXRlIG1v ZGUgMTAwNjQ0IERvY3VtZW50YXRpb24vRG9jQm9vay9tZWRpYS92NGwvY2VjLWlvYy1nLWNhcHMu eG1sCj4gIGNyZWF0ZSBtb2RlIDEwMDY0NCBEb2N1bWVudGF0aW9uL0RvY0Jvb2svbWVkaWEvdjRs L2NlYy1pb2MtZy1ldmVudC54bWwKPiAgY3JlYXRlIG1vZGUgMTAwNjQ0IERvY3VtZW50YXRpb24v RG9jQm9vay9tZWRpYS92NGwvY2VjLWlvYy1nLXZlbmRvci1pZC54bWwKPiAgY3JlYXRlIG1vZGUg MTAwNjQ0IERvY3VtZW50YXRpb24vRG9jQm9vay9tZWRpYS92NGwvY2VjLWlvYy1yZWNlaXZlLnht bAo+IAoKPHNuaXA+Cgo+IGRpZmYgLS1naXQgYS9Eb2N1bWVudGF0aW9uL0RvY0Jvb2svbWVkaWEv djRsL2NlYy1pb2MtZy1jYXBzLnhtbCBiL0RvY3VtZW50YXRpb24vRG9jQm9vay9tZWRpYS92NGwv Y2VjLWlvYy1nLWNhcHMueG1sCgo8c25pcD4KCj4gKyAgICA8dGFibGUgcGd3aWRlPSIxIiBmcmFt ZT0ibm9uZSIgaWQ9ImNlYy1jYXBhYmlsaXRpZXMiPgo+ICsgICAgICA8dGl0bGU+Q0VDIENhcGFi aWxpdGllcyBGbGFnczwvdGl0bGU+Cj4gKyAgICAgIDx0Z3JvdXAgY29scz0iMyI+Cj4gKwkmY3Mt ZGVmOwo+ICsJPHRib2R5IHZhbGlnbj0idG9wIj4KPiArCSAgPHJvdz4KPiArCSAgICA8ZW50cnk+ PGNvbnN0YW50PkNFQ19DQVBfU1RBVEU8L2NvbnN0YW50PjwvZW50cnk+Cj4gKwkgICAgPGVudHJ5 PjB4MDAwMDAwMDE8L2VudHJ5Pgo+ICsJICAgIDxlbnRyeT5Vc2Vyc3BhY2UgaGFzIHRvIGNvbmZp Z3VyZSB0aGUgYWRhcHRlciBzdGF0ZSAoZW5hYmxlIG9yIGRpc2FibGUgaXQpIGJ5Cj4gKwkgICAg Y2FsbGluZyAmQ0VDLVMtQURBUC1TVEFURTsuPC9lbnRyeT4KPiArCSAgPC9yb3c+Cj4gKwkgIDxy b3c+Cj4gKwkgICAgPGVudHJ5Pjxjb25zdGFudD5DRUNfQ0FQX1BIWVNfQUREUjwvY29uc3RhbnQ+ PC9lbnRyeT4KPiArCSAgICA8ZW50cnk+MHgwMDAwMDAwMjwvZW50cnk+Cj4gKwkgICAgPGVudHJ5 PlVzZXJzcGFjZSBoYXMgdG8gY29uZmlndXJlIHRoZSBwaHlzaWNhbCBhZGRyZXNzIGJ5Cj4gKwkg ICAgY2FsbGluZyAmQ0VDLVMtQURBUC1QSFlTLUFERFI7LjwvZW50cnk+Cj4gKwkgIDwvcm93Pgo+ ICsJICA8cm93Pgo+ICsJICAgIDxlbnRyeT48Y29uc3RhbnQ+Q0VDX0NBUF9MT0dfQUREUlM8L2Nv bnN0YW50PjwvZW50cnk+Cj4gKwkgICAgPGVudHJ5PjB4MDAwMDAwMDQ8L2VudHJ5Pgo+ICsJICAg IDxlbnRyeT5Vc2Vyc3BhY2UgaGFzIHRvIGNvbmZpZ3VyZSB0aGUgbG9naWNhbCBhZGRyZXNzZXMg YnkKPiArCSAgICBjYWxsaW5nICZDRUMtUy1BREFQLUxPRy1BRERSUzsuPC9lbnRyeT4KPiArCSAg PC9yb3c+Cj4gKwkgIDxyb3c+Cj4gKwkgICAgPGVudHJ5Pjxjb25zdGFudD5DRUNfQ0FQX1RSQU5T TUlUPC9jb25zdGFudD48L2VudHJ5Pgo+ICsJICAgIDxlbnRyeT4weDAwMDAwMDA4PC9lbnRyeT4K PiArCSAgICA8ZW50cnk+VXNlcnNwYWNlIGNhbiB0cmFuc21pdCBtZXNzYWdlcyBieSBjYWxsaW5n ICZDRUMtVFJBTlNNSVQ7LjwvZW50cnk+Cj4gKwkgIDwvcm93Pgo+ICsJICA8cm93Pgo+ICsJICAg IDxlbnRyeT48Y29uc3RhbnQ+Q0VDX0NBUF9SRUNFSVZFPC9jb25zdGFudD48L2VudHJ5Pgo+ICsJ ICAgIDxlbnRyeT4weDAwMDAwMDEwPC9lbnRyeT4KPiArCSAgICA8ZW50cnk+VXNlcnNwYWNlIGNh biByZWNlaXZlIG1lc3NhZ2VzIGJ5IGNhbGxpbmcgJkNFQy1SRUNFSVZFOy48L2VudHJ5Pgo+ICsJ ICA8L3Jvdz4KPiArCSAgPHJvdz4KPiArCSAgICA8ZW50cnk+PGNvbnN0YW50PkNFQ19DQVBfVkVO RE9SX0lEPC9jb25zdGFudD48L2VudHJ5Pgo+ICsJICAgIDxlbnRyeT4weDAwMDAwMDIwPC9lbnRy eT4KPiArCSAgICA8ZW50cnk+VXNlcnNwYWNlIGhhcyB0byBjb25maWd1cmUgdGhlIHZlbmRvciBJ RCBieQo+ICsJICAgIGNhbGxpbmcgJkNFQy1TLVZFTkRPUi1JRDsuPC9lbnRyeT4KPiArCSAgPC9y b3c+CgpDQVBfUEFTU1RIUk9VR0ggaXMgbWlzc2luZyBoZXJlLgoKPiArCTwvdGJvZHk+Cj4gKyAg ICAgIDwvdGdyb3VwPgo+ICsgICAgPC90YWJsZT4KPiArICA8L3JlZnNlY3QxPgo+ICsKPiArICA8 cmVmc2VjdDE+Cj4gKyAgICAmcmV0dXJuLXZhbHVlOwo+ICsgIDwvcmVmc2VjdDE+Cj4gKzwvcmVm ZW50cnk+Cj4gZGlmZiAtLWdpdCBhL0RvY3VtZW50YXRpb24vRG9jQm9vay9tZWRpYS92NGwvY2Vj LWlvYy1nLWV2ZW50LnhtbCBiL0RvY3VtZW50YXRpb24vRG9jQm9vay9tZWRpYS92NGwvY2VjLWlv Yy1nLWV2ZW50LnhtbAo+IG5ldyBmaWxlIG1vZGUgMTAwNjQ0Cj4gaW5kZXggMDAwMDAwMC4uMmI3 ZThlOQo+IC0tLSAvZGV2L251bGwKPiArKysgYi9Eb2N1bWVudGF0aW9uL0RvY0Jvb2svbWVkaWEv djRsL2NlYy1pb2MtZy1ldmVudC54bWwKCjxzbmlwPgoKPiArICA8cmVmc2VjdDE+Cj4gKyAgICA8 dGl0bGU+RGVzY3JpcHRpb248L3RpdGxlPgo+ICsKPiArICAgIDxwYXJhPkNFQyBkZXZpY2VzIGNh biBzZW5kIGFzeW5jaHJvbm91cyBldmVudHMuIFRoZXNlIGNhbiBiZSByZXRyaWV2ZWQgYnkgY2Fs bGluZwo+ICsgICAgdGhlIDxjb25zdGFudD5DRUNfR19FVkVOVDwvY29uc3RhbnQ+IGlvY3RsLiBJ ZiB0aGUgZmlsZSBkZXNjcmlwdG9yIGlzIGluIG5vbi1ibG9ja2luZwo+ICsgICAgbW9kZSBhbmQg bm8gZXZlbnQgaXMgcGVuZGluZywgdGhlbiBpdCB3aWxsIHJldHVybiAtMSBhbmQgc2V0IGVycm5v IHRvIHRoZSAmRUFHQUlOOy48L3BhcmE+CgpXZSBzaG91bGQgYWRkIHNvbWV0aGluZyBsaWtlIHRo aXM6Cgo8cGFyYT5UaGVyZSBjYW4gYmUgdXAgdG8gMTYgZXZlbnRzIHF1ZXVlZCB1cC4gSWYgbW9y ZSBldmVudHMgYXJlIGFkZGVkLCB0aGVuIHRoZSBvbGRlc3QKZXZlbnQgd2lsbCBiZSBkaXNjYXJk ZWQuPC9wYXJhPgoKSSB0aGluayB3ZSBzaG91bGQgaW5jcmVhc2UgdGhlIG51bWJlciBvZiBldmVu dHMgdG8gNDA6IGdpdmVuIHRoZSBzcGVlZCBvZiB0aGUgYnVzIChvciBsYWNrCnRoZXJlb2YpIHRo aXMgc2hvdWxkIGJlIG1vcmUgdGhhbiBzdWZmaWNpZW50IHByb3ZpZGVkIHRoZSBhcHBsaWNhdGlv biB3aWxsIGNoZWNrIGV2ZW50cwphdCBsZWFzdCBvbmNlIHBlciBzZWNvbmQuIFRoZSBhbHRlcm5h dGl2ZSB3b3VsZCBiZSB0byB1c2UgYSBmcmFtZXdvcmsgbGlrZSB2NGwyX2V2ZW50LCBidXQKdGhh dCBpcyBJTUhPIG92ZXJraWxsIGZvciBhIGJ1cyBsaWtlIHRoaXMuCgo8c25pcD4KCj4gKyAgICA8 dGFibGUgcGd3aWRlPSIxIiBmcmFtZT0ibm9uZSIgaWQ9ImNlYy1ldmVudHMiPgo+ICsgICAgICA8 dGl0bGU+Q0VDIEV2ZW50czwvdGl0bGU+Cj4gKyAgICAgIDx0Z3JvdXAgY29scz0iMyI+Cj4gKwkm Y3MtZGVmOwo+ICsJPHRib2R5IHZhbGlnbj0idG9wIj4KPiArCSAgPHJvdz4KPiArCSAgICA8ZW50 cnk+PGNvbnN0YW50PkNFQ19FVkVOVF9DT05ORUNUPC9jb25zdGFudD48L2VudHJ5Pgo+ICsJICAg IDxlbnRyeT4xPC9lbnRyeT4KPiArCSAgICA8ZW50cnk+R2VuZXJhdGVkIHdoZW4gdGhlIEhETUkg Y2FibGUgaXMgY29ubmVjdGVkLjwvZW50cnk+Cj4gKwkgIDwvcm93Pgo+ICsJICA8cm93Pgo+ICsJ ICAgIDxlbnRyeT48Y29uc3RhbnQ+Q0VDX0VWRU5UX1JFQURZPC9jb25zdGFudD48L2VudHJ5Pgo+ ICsJICAgIDxlbnRyeT4yPC9lbnRyeT4KPiArCSAgICA8ZW50cnk+R2VuZXJhdGVkIHdoZW4gYWxs IGxvZ2ljYWwgYWRkcmVzc2VzIGFyZSBjbGFpbWVkLjwvZW50cnk+Cj4gKwkgIDwvcm93Pgo+ICsJ ICA8cm93Pgo+ICsJICAgIDxlbnRyeT48Y29uc3RhbnQ+Q0VDX0VWRU5UX0RJU0NPTk5FQ1Q8L2Nv bnN0YW50PjwvZW50cnk+Cj4gKwkgICAgPGVudHJ5PjM8L2VudHJ5Pgo+ICsJICAgIDxlbnRyeT5H ZW5lcmF0ZWQgd2hlbiB0aGUgSERNSSBjYWJsZSBpcyBkaXNjb25uZWN0ZWQuPC9lbnRyeT4KPiAr CSAgPC9yb3c+Cj4gKwkgIDxyb3c+Cj4gKwkgICAgPGVudHJ5Pjxjb25zdGFudD5DRUNfRVZFTlRf R09UX1JFUExZPC9jb25zdGFudD48L2VudHJ5Pgo+ICsJICAgIDxlbnRyeT40PC9lbnRyeT4KPiAr CSAgICA8ZW50cnk+R2VuZXJhdGVkIHdoZW4gYSBwcmVseSBpcyByZWNlaXZlZCBmb3IgYSBwcmV2 aW91c2x5IHNlbnQKCnByZWx5IC0+IHJlcGx5Cgo+ICsJICAgIG1lc3NhZ2UuIEdlbmVyYXRlZCBv bmx5IGlmIGEgcmVwbHkgd2FzIHJlcXVlc3RlZCBhbmQgb25seSBpZiB0aGUKPiArCSAgICBtZXNz YWdlIHdhcyBzZW50IGluIG5vbi1ibG9ja2luZyBtb2RlLjwvZW50cnk+CgpMb29raW5nIGF0IHRo ZSBjb2RlIGluIGNlYy5jLCBjZWNfcmVjZWl2ZWRfbXNnKCk6CgoJaWYgKCFpc19yZXBseSB8fCAo aXNfcmVwbHkgJiYgIWRzdF9kYXRhLT5ibG9ja2luZykpCgkJYWRhcC0+cmVjdl9ub3RpZmllcihh ZGFwLCBtc2cpOwoJaWYgKGlzX3JlcGx5KQoJCWNlY19wb3N0X2V2ZW50KGFkYXAsIENFQ19FVkVO VF9HT1RfUkVQTFksIG1zZy0+c2VxdWVuY2UpOwp9CgppdCBzZWVtcyB0aGF0IHRoZSBldmVudCBp cyBwb3N0ZWQgYWxzbyBpZiBkc3RfZGF0YS0+YmxvY2tpbmcgaXMgdHJ1ZS4KClRoYXQgY29uZmxp Y3RzIHdpdGggdGhlIGRvY3VtZW50YXRpb24uIEkgdGhpbmsgdGhlIGNvZGUgc2hvdWxkIGZvbGxv dyB0aGUKZG9jdW1lbnRhdGlvbi4KCjxzbmlwPgoKRmluYWxseSwgdGhlIHBhc3N0aHJvdWdoIGRv Y3VtZW50YXRpb24gaXMgbWlzc2luZywgZGlkIHlvdSBmb3JnZXQgdG8gZG8KJ2dpdCBhZGQnPwoK UmVnYXJkcywKCglIYW5zCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fCmRyaS1kZXZlbCBtYWlsaW5nIGxpc3QKZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9w Lm9yZwpodHRwOi8vbGlzdHMuZnJlZWRlc2t0b3Aub3JnL21haWxtYW4vbGlzdGluZm8vZHJpLWRl dmVsCg== From mboxrd@z Thu Jan 1 00:00:00 1970 Return-path: Received: from lb2-smtp-cloud6.xs4all.net ([194.109.24.28]:35608 "EHLO lb2-smtp-cloud6.xs4all.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752201AbbECK70 (ORCPT ); Sun, 3 May 2015 06:59:26 -0400 Message-ID: <5545FF85.2050508@xs4all.nl> Date: Sun, 03 May 2015 12:59:17 +0200 From: Hans Verkuil MIME-Version: 1.0 To: Kamil Debski , dri-devel@lists.freedesktop.org, linux-media@vger.kernel.org CC: m.szyprowski@samsung.com, mchehab@osg.samsung.com, kyungmin.park@samsung.com, thomas@tommie-lie.de, sean@mess.org, dmitry.torokhov@gmail.com, linux-input@vger.kernel.org, linux-samsung-soc@vger.kernel.org, lars@opdenkamp.eu, Hans Verkuil Subject: Re: [PATCH v5 11/11] DocBook/media: add CEC documentation References: <1430301765-22202-1-git-send-email-k.debski@samsung.com> <1430301765-22202-12-git-send-email-k.debski@samsung.com> In-Reply-To: <1430301765-22202-12-git-send-email-k.debski@samsung.com> Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit Sender: linux-media-owner@vger.kernel.org List-ID: Some comments: On 04/29/2015 12:02 PM, Kamil Debski wrote: > From: Hans Verkuil > > Add DocBook documentation for the CEC API. > > Signed-off-by: Hans Verkuil > [k.debski@samsung.com: add documentation for passthrough mode] > [k.debski@samsung.com: minor fixes and change of reserved field sizes] > Signed-off-by: Kamil Debski > --- > Documentation/DocBook/media/Makefile | 4 +- > Documentation/DocBook/media/v4l/biblio.xml | 10 + > Documentation/DocBook/media/v4l/cec-api.xml | 74 ++++++ > Documentation/DocBook/media/v4l/cec-func-close.xml | 59 +++++ > Documentation/DocBook/media/v4l/cec-func-ioctl.xml | 73 ++++++ > Documentation/DocBook/media/v4l/cec-func-open.xml | 94 +++++++ > Documentation/DocBook/media/v4l/cec-func-poll.xml | 89 +++++++ > .../DocBook/media/v4l/cec-ioc-g-adap-log-addrs.xml | 275 ++++++++++++++++++++ > .../DocBook/media/v4l/cec-ioc-g-adap-phys-addr.xml | 78 ++++++ > .../DocBook/media/v4l/cec-ioc-g-adap-state.xml | 87 +++++++ > Documentation/DocBook/media/v4l/cec-ioc-g-caps.xml | 167 ++++++++++++ > .../DocBook/media/v4l/cec-ioc-g-event.xml | 142 ++++++++++ > .../DocBook/media/v4l/cec-ioc-g-vendor-id.xml | 70 +++++ > .../DocBook/media/v4l/cec-ioc-receive.xml | 185 +++++++++++++ > Documentation/DocBook/media_api.tmpl | 6 +- > 15 files changed, 1410 insertions(+), 3 deletions(-) > create mode 100644 Documentation/DocBook/media/v4l/cec-api.xml > create mode 100644 Documentation/DocBook/media/v4l/cec-func-close.xml > create mode 100644 Documentation/DocBook/media/v4l/cec-func-ioctl.xml > create mode 100644 Documentation/DocBook/media/v4l/cec-func-open.xml > create mode 100644 Documentation/DocBook/media/v4l/cec-func-poll.xml > create mode 100644 Documentation/DocBook/media/v4l/cec-ioc-g-adap-log-addrs.xml > create mode 100644 Documentation/DocBook/media/v4l/cec-ioc-g-adap-phys-addr.xml > create mode 100644 Documentation/DocBook/media/v4l/cec-ioc-g-adap-state.xml > create mode 100644 Documentation/DocBook/media/v4l/cec-ioc-g-caps.xml > create mode 100644 Documentation/DocBook/media/v4l/cec-ioc-g-event.xml > create mode 100644 Documentation/DocBook/media/v4l/cec-ioc-g-vendor-id.xml > create mode 100644 Documentation/DocBook/media/v4l/cec-ioc-receive.xml > > diff --git a/Documentation/DocBook/media/v4l/cec-ioc-g-caps.xml b/Documentation/DocBook/media/v4l/cec-ioc-g-caps.xml > + > + CEC Capabilities Flags > + > + &cs-def; > + > + > + CEC_CAP_STATE > + 0x00000001 > + Userspace has to configure the adapter state (enable or disable it) by > + calling &CEC-S-ADAP-STATE;. > + > + > + CEC_CAP_PHYS_ADDR > + 0x00000002 > + Userspace has to configure the physical address by > + calling &CEC-S-ADAP-PHYS-ADDR;. > + > + > + CEC_CAP_LOG_ADDRS > + 0x00000004 > + Userspace has to configure the logical addresses by > + calling &CEC-S-ADAP-LOG-ADDRS;. > + > + > + CEC_CAP_TRANSMIT > + 0x00000008 > + Userspace can transmit messages by calling &CEC-TRANSMIT;. > + > + > + CEC_CAP_RECEIVE > + 0x00000010 > + Userspace can receive messages by calling &CEC-RECEIVE;. > + > + > + CEC_CAP_VENDOR_ID > + 0x00000020 > + Userspace has to configure the vendor ID by > + calling &CEC-S-VENDOR-ID;. > + CAP_PASSTHROUGH is missing here. > + > + > +
> + > + > + > + &return-value; > + > + > diff --git a/Documentation/DocBook/media/v4l/cec-ioc-g-event.xml b/Documentation/DocBook/media/v4l/cec-ioc-g-event.xml > new file mode 100644 > index 0000000..2b7e8e9 > --- /dev/null > +++ b/Documentation/DocBook/media/v4l/cec-ioc-g-event.xml > + > + Description > + > + CEC devices can send asynchronous events. These can be retrieved by calling > + the CEC_G_EVENT ioctl. If the file descriptor is in non-blocking > + mode and no event is pending, then it will return -1 and set errno to the &EAGAIN;. We should add something like this: There can be up to 16 events queued up. If more events are added, then the oldest event will be discarded. I think we should increase the number of events to 40: given the speed of the bus (or lack thereof) this should be more than sufficient provided the application will check events at least once per second. The alternative would be to use a framework like v4l2_event, but that is IMHO overkill for a bus like this. > + > + CEC Events > + > + &cs-def; > + > + > + CEC_EVENT_CONNECT > + 1 > + Generated when the HDMI cable is connected. > + > + > + CEC_EVENT_READY > + 2 > + Generated when all logical addresses are claimed. > + > + > + CEC_EVENT_DISCONNECT > + 3 > + Generated when the HDMI cable is disconnected. > + > + > + CEC_EVENT_GOT_REPLY > + 4 > + Generated when a prely is received for a previously sent prely -> reply > + message. Generated only if a reply was requested and only if the > + message was sent in non-blocking mode. Looking at the code in cec.c, cec_received_msg(): if (!is_reply || (is_reply && !dst_data->blocking)) adap->recv_notifier(adap, msg); if (is_reply) cec_post_event(adap, CEC_EVENT_GOT_REPLY, msg->sequence); } it seems that the event is posted also if dst_data->blocking is true. That conflicts with the documentation. I think the code should follow the documentation. Finally, the passthrough documentation is missing, did you forget to do 'git add'? Regards, Hans