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.linux-doc,org.infradead.lists.linux-arm-kernel,org.kernel.vger.arm-scmi,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==