1 What: /sys/kernel/debug/scmi/<n>/raw 1 What: /sys/kernel/debug/scmi/<n>/raw/message
2 Date: March 2023 2 Date: March 2023
3 KernelVersion: 6.3 3 KernelVersion: 6.3
4 Contact: cristian.marussi@arm.com 4 Contact: cristian.marussi@arm.com
5 Description: SCMI Raw synchronous message i 5 Description: SCMI Raw synchronous message injection/snooping facility; write
6 a complete SCMI synchronous co 6 a complete SCMI synchronous command message (header included)
7 in little-endian binary format 7 in little-endian binary format to have it sent to the configured
8 backend SCMI server for instan 8 backend SCMI server for instance <n>.
9 Any subsequently received resp 9 Any subsequently received response can be read from this same
10 entry if it arrived within the 10 entry if it arrived within the configured timeout.
11 Each write to the entry causes 11 Each write to the entry causes one command request to be built
12 and sent while the replies are 12 and sent while the replies are read back one message at time
13 (receiving an EOF at each mess 13 (receiving an EOF at each message boundary).
14 Users: Debugging, any userspace test 14 Users: Debugging, any userspace test suite
15 15
16 What: /sys/kernel/debug/scmi/<n>/raw 16 What: /sys/kernel/debug/scmi/<n>/raw/message_async
17 Date: March 2023 17 Date: March 2023
18 KernelVersion: 6.3 18 KernelVersion: 6.3
19 Contact: cristian.marussi@arm.com 19 Contact: cristian.marussi@arm.com
20 Description: SCMI Raw asynchronous message 20 Description: SCMI Raw asynchronous message injection/snooping facility; write
21 a complete SCMI asynchronous c 21 a complete SCMI asynchronous command message (header included)
22 in little-endian binary format 22 in little-endian binary format to have it sent to the configured
23 backend SCMI server for instan 23 backend SCMI server for instance <n>.
24 Any subsequently received resp 24 Any subsequently received response can be read from this same
25 entry if it arrived within the 25 entry if it arrived within the configured timeout.
26 Any additional delayed respons 26 Any additional delayed response received afterwards can be read
27 from this same entry too if it 27 from this same entry too if it arrived within the configured
28 timeout. 28 timeout.
29 Each write to the entry causes 29 Each write to the entry causes one command request to be built
30 and sent while the replies are 30 and sent while the replies are read back one message at time
31 (receiving an EOF at each mess 31 (receiving an EOF at each message boundary).
32 Users: Debugging, any userspace test 32 Users: Debugging, any userspace test suite
33 33
34 What: /sys/kernel/debug/scmi/<n>/raw 34 What: /sys/kernel/debug/scmi/<n>/raw/errors
35 Date: March 2023 35 Date: March 2023
36 KernelVersion: 6.3 36 KernelVersion: 6.3
37 Contact: cristian.marussi@arm.com 37 Contact: cristian.marussi@arm.com
38 Description: SCMI Raw message errors facili 38 Description: SCMI Raw message errors facility; any kind of timed-out or
39 generally unexpectedly receive 39 generally unexpectedly received SCMI message, for instance <n>,
40 can be read from this entry. 40 can be read from this entry.
41 Each read gives back one messa 41 Each read gives back one message at time (receiving an EOF at
42 each message boundary). 42 each message boundary).
43 Users: Debugging, any userspace test 43 Users: Debugging, any userspace test suite
44 44
45 What: /sys/kernel/debug/scmi/<n>/raw 45 What: /sys/kernel/debug/scmi/<n>/raw/notification
46 Date: March 2023 46 Date: March 2023
47 KernelVersion: 6.3 47 KernelVersion: 6.3
48 Contact: cristian.marussi@arm.com 48 Contact: cristian.marussi@arm.com
49 Description: SCMI Raw notification snooping 49 Description: SCMI Raw notification snooping facility; any notification
50 emitted by the backend SCMI se 50 emitted by the backend SCMI server, for instance <n>, can be
51 read from this entry. 51 read from this entry.
52 Each read gives back one messa 52 Each read gives back one message at time (receiving an EOF at
53 each message boundary). 53 each message boundary).
54 Users: Debugging, any userspace test 54 Users: Debugging, any userspace test suite
55 55
56 What: /sys/kernel/debug/scmi/<n>/raw 56 What: /sys/kernel/debug/scmi/<n>/raw/reset
57 Date: March 2023 57 Date: March 2023
58 KernelVersion: 6.3 58 KernelVersion: 6.3
59 Contact: cristian.marussi@arm.com 59 Contact: cristian.marussi@arm.com
60 Description: SCMI Raw stack reset facility; 60 Description: SCMI Raw stack reset facility; writing a value to this entry
61 causes the internal queues of 61 causes the internal queues of any kind of received message,
62 still pending to be read out f 62 still pending to be read out for instance <n>, to be immediately
63 flushed. 63 flushed.
64 Can be used to reset and clean 64 Can be used to reset and clean the SCMI Raw stack between to
65 different test-run. 65 different test-run.
66 Users: Debugging, any userspace test 66 Users: Debugging, any userspace test suite
67 67
68 What: /sys/kernel/debug/scmi/<n>/raw 68 What: /sys/kernel/debug/scmi/<n>/raw/channels/<m>/message
69 Date: March 2023 69 Date: March 2023
70 KernelVersion: 6.3 70 KernelVersion: 6.3
71 Contact: cristian.marussi@arm.com 71 Contact: cristian.marussi@arm.com
72 Description: SCMI Raw synchronous message i 72 Description: SCMI Raw synchronous message injection/snooping facility; write
73 a complete SCMI synchronous co 73 a complete SCMI synchronous command message (header included)
74 in little-endian binary format 74 in little-endian binary format to have it sent to the configured
75 backend SCMI server for instan 75 backend SCMI server for instance <n> through the <m> transport
76 channel. 76 channel.
77 Any subsequently received resp 77 Any subsequently received response can be read from this same
78 entry if it arrived on channel 78 entry if it arrived on channel <m> within the configured
79 timeout. 79 timeout.
80 Each write to the entry causes 80 Each write to the entry causes one command request to be built
81 and sent while the replies are 81 and sent while the replies are read back one message at time
82 (receiving an EOF at each mess 82 (receiving an EOF at each message boundary).
83 Channel identifier <m> matches 83 Channel identifier <m> matches the SCMI protocol number which
84 has been associated with this 84 has been associated with this transport channel in the DT
85 description, with base protoco 85 description, with base protocol number 0x10 being the default
86 channel for this instance. 86 channel for this instance.
87 Note that these per-channel en 87 Note that these per-channel entries rooted at <..>/channels
88 exist only if the transport is 88 exist only if the transport is configured to have more than
89 one default channel. 89 one default channel.
90 Users: Debugging, any userspace test 90 Users: Debugging, any userspace test suite
91 91
92 What: /sys/kernel/debug/scmi/<n>/raw 92 What: /sys/kernel/debug/scmi/<n>/raw/channels/<m>/message_async
93 Date: March 2023 93 Date: March 2023
94 KernelVersion: 6.3 94 KernelVersion: 6.3
95 Contact: cristian.marussi@arm.com 95 Contact: cristian.marussi@arm.com
96 Description: SCMI Raw asynchronous message 96 Description: SCMI Raw asynchronous message injection/snooping facility; write
97 a complete SCMI asynchronous c 97 a complete SCMI asynchronous command message (header included)
98 in little-endian binary format 98 in little-endian binary format to have it sent to the configured
99 backend SCMI server for instan 99 backend SCMI server for instance <n> through the <m> transport
100 channel. 100 channel.
101 Any subsequently received resp 101 Any subsequently received response can be read from this same
102 entry if it arrived on channel 102 entry if it arrived on channel <m> within the configured
103 timeout. 103 timeout.
104 Any additional delayed respons 104 Any additional delayed response received afterwards can be read
105 from this same entry too if it 105 from this same entry too if it arrived within the configured
106 timeout. 106 timeout.
107 Each write to the entry causes 107 Each write to the entry causes one command request to be built
108 and sent while the replies are 108 and sent while the replies are read back one message at time
109 (receiving an EOF at each mess 109 (receiving an EOF at each message boundary).
110 Channel identifier <m> matches 110 Channel identifier <m> matches the SCMI protocol number which
111 has been associated with this 111 has been associated with this transport channel in the DT
112 description, with base protoco 112 description, with base protocol number 0x10 being the default
113 channel for this instance. 113 channel for this instance.
114 Note that these per-channel en 114 Note that these per-channel entries rooted at <..>/channels
115 exist only if the transport is 115 exist only if the transport is configured to have more than
116 one default channel. 116 one default channel.
117 Users: Debugging, any userspace test 117 Users: Debugging, any userspace test suite
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.