Re: [PATCH v7 22/23] [RFC] Documentation: Add SCMI System Telemetry documentation
Fayssal Benmlih <[email protected]> Mon, 3 Aug 2026 22:36:25 +0000
| Newsgroups | org.kernel.vger.arm-scmi,org.infradead.lists.linux-arm-kernel,org.kernel.vger.linux-doc,org.kernel.vger.linux-kernel |
|---|---|
| Message-ID | <[email protected]> |
SGkgQ3Jpc3RpYW4sDQoNCkEgZmV3IGRvY3VtZW50YXRpb24gaXNzdWVzIHJlbWFpbiBpbmxpbmUu DQoNCj4gIC0gU0NNSV9UTE1fR0VUX0FCSV9JTkZPOiBHYXRoZXIgQUJJIHZlcnNpb25pbmcgZGV0 YWlsIGFuZCBiYXNpYyBTQ01JDQo+ICAgIFRlbGVtZXRyeSBmZWF0dXJlcyBsaWtlIG51bWJlciBv ZiByZXNvdXJjZXMgYW5kIHN1cHBvcnRlZCBmZWF0dXJlcy4NCg0KUGxlYXNlIGV4cGxhaW4gdGhl IGRpc3RpbmN0aW9uIGJldHdlZW4gYWJpX2ZlYXR1cmVzIGFuZCB0aGUgU0NNSSBpbnN0YW5jZQ0K ZmVhdHVyZXMuIEluIHBhcnRpY3VsYXIsIHJlc2V0IGlzIHVzYWJsZSBvbmx5IHdoZW4gYm90aCB0 aGUgQUJJIGFuZCB0aGUNCmZpcm13YXJlIGluc3RhbmNlIGFkdmVydGlzZSBzdXBwb3J0Lg0KDQo+ ICAtIFNDTUlfVExNX0dFVF9DRkcgLyBTQ01JX1RMTV9TRVRfQ0ZHOiBHZXQgb3Igc2V0IHRoZSB3 aG9sZSBpbnN0YW5jZSwNCj4gICAgb3IgYSBzcGVjaWZpYyBncm91cCwgY29uZmlndXJhdGlvbi4N Cj4NCj4gIC0gU0NNSV9UTE1fR0VUX0RFX0NGRyAvIFNDTUlfVExNX1NFVF9ERV9DRkc6IEdldCBv ciBzZXQgdGhlDQo+ICAgIGNvbmZpZ3VyYXRpb24gb2YgYSBzcGVjaWZpYyBEYXRhRXZlbnQuDQo+ DQo+ICAtIFNDTUlfVExNX0dFVF9BTExfQ0ZHIC8gU0NNSV9UTE1fU0VUX0FMTF9DRkc6IEdldCBv ciBzZXQgdGhlDQo+ICAgIGN1bXVsYXRpdmUgY29uZmlndXJhdGlvbiBvZiBBTEwgdGhlIERhdGFF dmVudHMgZGVmaW5lZCBvbiB0aGUNCj4gICAgcGxhdGZvcm0uDQoNClBsZWFzZSBzdGF0ZSB0aGF0 IHRoaXMgY29uZmlndXJhdGlvbiBpcyBnbG9iYWwgdG8gdGhlIFNDTUkgaW5zdGFuY2UsIG5vdA0K cGVyLW9wZW4tZmlsZSBzdGF0ZS4NCg0KVGhlIGRvY3VtZW50YXRpb24gc2hvdWxkIGFsc28gZGVm aW5lIGNvbmN1cnJlbnQtY2FsbGVyIGJlaGF2aW9yLCB3aGV0aGVyDQptdWx0aS1jb21tYW5kIG9w ZXJhdGlvbnMgY2FuIGludGVybGVhdmUsIHBhcnRpYWwgZmFpbHVyZSBvZiBTRVRfQUxMX0NGRw0K YW5kIGJhdGNoIG9wZXJhdGlvbnMsIGFuZCB3aGljaCBjb21tYW5kcyByZXF1aXJlIHdyaXRlIGFj Y2VzcyBvcg0KcHJpdmlsZWdlLg0KDQo+ICAtIFNDTUlfVExNX0VWRU5UX1JFR0lTVEVSOiBTdWJz Y3JpYmUvdW5zdWJzY3JpYmUgdG8gYSBUZWxlbWV0cnkgZXZlbnQuDQoNClRoaXMgaW9jdGwgbmFt ZSBkb2VzIG5vdCBleGlzdCBpbiB0aGUgVjcgVUFQSS4gVGhlIGRlZmluZWQgY29tbWFuZCBpcw0K U0NNSV9UTE1fRVZFTlRfU1VCU0NSSUJFLg0KDQpQbGVhc2UgYWxzbyBkb2N1bWVudCBzdWJzY3Jp cHRpb24gb3duZXJzaGlwIGFuZCBsaWZldGltZSwgaW5jbHVkaW5nIHdoYXQNCmhhcHBlbnMgd2hl biB0aGUgdGVsZW1ldHJ5IGZkIG9yIGV2ZW50ZmQgaXMgY2xvc2VkIHdpdGhvdXQgYW4gZXhwbGlj aXQNCnVuc3Vic2NyaWJlLg0KDQo+ICAtIFNDTUlfVExNX0JBVENIX1JFQUQ6IFJlcG9ydCB0aGUg bGFzdCBzYW1wbGVzIGZvciB0aGUgRGF0YUV2ZW50cyBJRHMNCj4gICAgc3BlY2lmaWVkIHdpdGhp biB0aGUgc2FtcGxlcyBpbnB1dCBwYXJhbXMuDQoNClBsZWFzZSBkb2N1bWVudCB0aGUgcGVyLWVu dHJ5IHN0YXR1cyByZXByZXNlbnRhdGlvbiwgd2hldGhlciB0aGUgc3RhdHVzDQphcnJheSBpcyBv cHRpb25hbCwgd2hhdCBoYXBwZW5zIHRvIHN1Y2Nlc3NmdWwgZW50cmllcyB3aGVuIGEgbGF0ZXIg aXRlbQ0KZmFpbHMgd2l0aG91dCBzdGF0dXNlcywgYW5kIHRoZSBtYXhpbXVtIHBlcm1pdHRlZCBi YXRjaCBjb3VudC4NCg0KPiAgLSBTQ01JX1RMTV9HRVRfU0hNVElfTElTVDogR2F0aGVyIGEgbGlz dCBvZiBvcGVuIGZpbGUgZGVzY3JpcHRvcnMsIG9uZQ0KPiAgICBmb3IgZWFjaCBTSE1USSBtZW1v cnkgYXJlYSBkZWZpbmVkIGZvciB0aGlzIGluc3RhbmNlLCB0aGF0IGNhbiBiZSB1c2VkDQo+ICAg IHRvIG1lbW9yeS1tYXAgc3VjaCBhcmVhcyBpbiB0aGUgY2FsbGluZyBwcm9jZXNzIGFkZHJlc3Mg c3BhY2UgWy4uLl0NCg0KVGhlIG1tYXAgQUJJIHN0aWxsIG5lZWRzIHRvIHNwZWNpZnk6DQoNCi0g dGhlIGV4YWN0IFBBR0VfQUxJR04ob2Zmc2V0ICsgbGVuKSBtYXBwaW5nIGxlbmd0aDsNCi0gcGVy bWl0dGVkIHZtX3Bnb2ZmLCBwcm90ZWN0aW9uIGFuZCBzaGFyaW5nIGZsYWdzOw0KLSB0aGF0IHJl dHVybmVkIGZkcyBhcmUgcmVhZC1vbmx5IGFuZCBjbG9zZS1vbi1leGVjOw0KLSBjYWNoZWFiaWxp dHkgYW5kIGNvaGVyZW5jeSBleHBlY3RhdGlvbnM7DQotIGZkIGFuZCBWTUEgbGlmZXRpbWUgYWNy b3NzIHJlbW92YWwsIHJlc2V0IGFuZCByZWNvbmZpZ3VyYXRpb247DQotIGNsZWFudXAgdXNpbmcg bXVubWFwKCkgYW5kIGNsb3NlKCk7DQotIHNlY3VyaXR5IHJlcXVpcmVtZW50cyBmb3IgYnl0ZXMg c3Vycm91bmRpbmcgYW4gdW5hbGlnbmVkIFNITVRJLg0KDQo+IAkJLyogRW5hYmxlIFRlbGVtZXRy eSBhcyBhIHdob2xlLCBzZXQgYSA0MDBtcyB1cGRhdGUgaW50ZXJ2YWwgKi8NCj4gCQljZmcuZW5h YmxlID0gMTsNCj4gCQljZmcuYWN0aXZlLnNlY3MgPSA0MDA7DQo+IAkJY2ZnLmFjdGl2ZS5leHAg PSAtMzsNCg0KUGxlYXNlIGRvY3VtZW50IHRoZSBwZXJtaXR0ZWQgc2Vjcy9leHAgcmFuZ2VzIGFu ZCBob3cgYSByZXF1ZXN0ZWQgdmFsdWUgaXMNCm1hdGNoZWQgYWdhaW5zdCBkaXNjcmV0ZSBvciBz ZWdtZW50ZWQgYWR2ZXJ0aXNlZCBpbnRlcnZhbHMuDQoNCj4gCQlzdHJ1Y3Qgc2NtaV90bG1fZGVf c2FtcGxlIHNhbXBsZXNbM10gPSB7fTsNCj4gCQlzdHJ1Y3Qgc2NtaV90bG1fZGF0YV9yZWFkIGRh dGEgPSB7fTsNCj4gWy4uLl0NCj4gCQlkYXRhLm51bV9zYW1wbGVzID0gMzsNCj4gCQlkYXRhLnNh bXBsZXMgPSAodW5zaWduZWQgbG9uZylzYW1wbGVzOw0KPg0KPiAJCXJldCA9IGlvY3RsKGZkLCBT Q01JX1RMTV9CQVRDSF9SRUFELCAmZGF0YSk7DQoNClY3J3MgYmF0Y2ggaGFuZGxlciBleHBlY3Rz IHN0cnVjdCBzY21pX3RsbV9iYXRjaCwgaW5jbHVkaW5nIGl0ZW1fc3osDQppdGVtcywgYW5kIG9w dGlvbmFsIHN0YXRlcy4gVGhpcyBleGFtcGxlIHN0aWxsIHBhc3NlcyBzdHJ1Y3QNCnNjbWlfdGxt X2RhdGFfcmVhZCwgc28gaXQgZmFpbHMgaXRlbV9zeiB2YWxpZGF0aW9uIGFuZCBpcyBzbWFsbGVy IHRoYW4gdGhlDQpzdHJ1Y3R1cmUgY29waWVkIGJ5IHRoZSBoYW5kbGVyLg0KDQpQbGVhc2UgdXBk YXRlIHRoZSBleGFtcGxlIHRvIHVzZSB0aGUgVjcgYmF0Y2ggQUJJLg0KDQo+IAkJZm9yIChpbnQg aSA9IDA7IGkgPCAzOyBpKyspDQo+IAkJCWZwcmludGYoc3Rkb3V0LCAiJWxsdTogMHglMDhYIC0+ ICVsbHVcbiIsDQo+IAkJCQkJc2FtcGxlc1tpXS50c3RhbXAsIHNhbXBsZXNbaV0uaWQsDQo+IAkJ CQkJc2FtcGxlc1tpXS52YWwpOw0KDQpQbGVhc2UgZG9jdW1lbnQgdGhlIHRpbWVzdGFtcCBkb21h aW4sIGNsb2NrLXJhdGUgY29udmVyc2lvbiwgd3JhcA0KYmVoYXZpb3IsIGFuZCB3aGV0aGVyIGl0 IGNhbiBiZSBjb3JyZWxhdGVkIHdpdGggYSBMaW51eCBjbG9jay4NCg0KPiAJCWlmIChyZXQpDQo+ IAkJCXJldHVybiByZXQ7DQo+IFsuLi5dDQo+IAkJcmV0dXJuIDA7DQoNClRoZSBleGFtcGxlIHN0 aWxsIGxlYWtzIGZkIG9uIGFsbCBzdWNjZXNzZnVsIGFuZCBtb3N0IGVycm9yIGV4aXRzLiBQbGVh c2UNCnVzZSBvbmUgY2xlYW51cCBwYXRoIGFuZCBjbG9zZSBmZCBiZWZvcmUgcmV0dXJuaW5nLiBF eGFtcGxlcyBpbnZvbHZpbmcNClNITVRJcyBvciBiYXRjaGVzIHNob3VsZCBzaW1pbGFybHkgZGVt b25zdHJhdGUgZnJlZWluZyBhcnJheXMsIGNsb3NpbmcNCnJldHVybmVkIGFub255bW91cyBmZHMg YW5kIHVubWFwcGluZyBtYXBwaW5ncy4NCg0KVGhhbmtzLA0KRmF5w6dhbA0KDQoNCg==