aboutsummaryrefslogtreecommitdiffstats
path: root/drivers/staging/greybus/Documentation/sysfs-bus-greybus
blob: 2e998966cbe1f36cd6f741624203b59071375bf5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
What:		/sys/bus/greybus/devices/greybusN
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The "root" greybus device for the Greybus device tree, or bus,
		where N is a dynamically assigned 1-based id.

What:		/sys/bus/greybus/devices/greybusN/bus_id
Date:		April 2016
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The ID of the "root" greybus device, or bus.

What:		/sys/bus/greybus/devices/N-M
Date:		March 2016
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		A Module M on the bus N, where M is the 1-byte interface
		ID of the module's primary interface.

What:		/sys/bus/greybus/devices/N-M/eject
Date:		March 2016
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Writing a non-zero argument to this attibute disables the
		module's interfaces before physically ejecting it.

What:		/sys/bus/greybus/devices/N-M/module_id
Date:		March 2016
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The ID of a Greybus module, corresponding to the ID of its
		primary interface.

What:		/sys/bus/greybus/devices/N-M/num_interfaces
Date:		March 2016
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The number of interfaces of a module.

What:		/sys/bus/greybus/devices/N-M.I
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		An Interface I on the bus N and module N-M, where I is the
		1-byte interface ID.

What:		/sys/bus/greybus/devices/N-M.I/current_now
Date:		March 2016
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Current measurement of the interface in microamps (uA)

What:		/sys/bus/greybus/devices/N-M.I/ddbl1_manufacturer_id
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Unipro Device Descriptor Block Level 1 manufacturer ID for the
		greybus Interface.

What:		/sys/bus/greybus/devices/N-M.I/ddbl1_product_id
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Unipro Device Descriptor Block Level 1 product ID for the
		greybus Interface.

What:		/sys/bus/greybus/devices/N-M.I/interface_id
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The ID of a Greybus interface.

What:		/sys/bus/greybus/devices/N-M.I/interface_type
Date:		June 2016
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The type of a Greybus interface; "dummy", "unipro", "greybus",
		or "unknown".

What:		/sys/bus/greybus/devices/N-M.I/power_now
Date:		March 2016
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Power measurement of the interface in microwatts (uW)

What:		/sys/bus/greybus/devices/N-M.I/power_state
Date:		March 2016
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		This file reflects the power state of a Greybus interface. If
		the value read from it is "on", then power is currently
		supplied to the interface. Otherwise it will read "off" and
		power is currently not supplied to the interface.

		If the value read is "off", then writing "on" (or '1', 'y',
		'Y') to this file will enable power to the interface and an
		attempt to boot and possibly enumerate it will be made. Note
		that on errors, the interface will again be powered down.

		If the value read is "on", then writing "off" (or '0', 'n',
		'N') to this file will power down the interface.

What:		/sys/bus/greybus/devices/N-M.I/product_id
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Product ID of a Greybus interface.

What:		/sys/bus/greybus/devices/N-M.I/serial_number
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Serial Number of the Greybus interface, represented by a 64 bit
		hexadecimal number.

What:		/sys/bus/greybus/devices/N-M.I/vendor_id
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Vendor ID of a Greybus interface.

What:		/sys/bus/greybus/devices/N-M.I/voltage_now
Date:		March 2016
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Voltage measurement of the interface in microvolts (uV)

What:		/sys/bus/greybus/devices/N-M.I.ctrl
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Abstract control device for interface I that represents the
		current mode of an enumerated Greybus interface.

What:		/sys/bus/greybus/devices/N-M.I.ctrl/product_string
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Product ID string of a Greybus interface.

What:		/sys/bus/greybus/devices/N-M.I.ctrl/vendor_string
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Vendor ID string of a Greybus interface.

What:		/sys/bus/greybus/devices/N-M.I.B
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		A bundle B on the Interface I, B is replaced by a 1-byte
		number representing the bundle.

What:		/sys/bus/greybus/devices/N-M.I.B/bundle_class
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The greybus class of the bundle B.

What:		/sys/bus/greybus/devices/N-M.I.B/bundle_id
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The interface-unique id of the bundle B.

What:		/sys/bus/greybus/devices/N-M.I.B/gpbX
Date:		April 2016
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The General Purpose Bridged PHY device of the bundle B,
		where X is a dynamically assigned 0-based id.

What:		/sys/bus/greybus/devices/N-M.I.B/state
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		A bundle has a state that is managed by the userspace
		Endo process.  This file allows that Endo to signal
		other Android HALs that the state of the bundle has
		changed to a specific value.  When written to, any
		process watching the file will be woken up, and the new
		value can be read. It's a "poor-man's IPC", yes, but
		simplifies the Android userspace code immensely.

What:		/sys/bus/greybus/devices/N-svc
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The singleton SVC device of bus N.

What:		/sys/bus/greybus/devices/N-svc/ap_intf_id
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The AP interface ID, a 1-byte non-zero integer which
		defines the position of the AP module on the frame.
		The interface positions are defined in the GMP
		Module Developer Kit.

What:		/sys/bus/greybus/devices/N-svc/endo_id
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The Endo ID, which is a 2-byte hexadecimal value
		defined by the Endo layout scheme, documented in
		the GMP Module Developer Kit.

What:		/sys/bus/greybus/devices/N-svc/intf_eject
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Write the number of the interface that you wish to
		forcibly eject from the system.

What:		/sys/bus/greybus/devices/N-svc/version
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The version number of the firmware in the SVC device.

What:		/sys/bus/greybus/devices/N-svc/watchdog
Date:		October 2016
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		If the SVC watchdog is enabled or not.  Writing 0 to this
		file will disable the watchdog, writing 1 will enable it.

What:		/sys/bus/greybus/devices/N-svc/watchdog_action
Date:		July 2016
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		This attribute indicates the action to be performed upon SVC
		watchdog bite.

		The action can be one of the "reset" or "panic". Writing either
		one of the "reset" or "panic" will change the behavior of SVC
		watchdog bite. Default value is "reset".

		"reset" means the UniPro subsystem is to be reset.

		"panic" means SVC watchdog bite will cause kernel to panic.