greybus: svc: remove deprecated hotplug operations
[cascardo/linux.git] / drivers / staging / greybus / greybus_protocols.h
1 /*
2  * This file is provided under a dual BSD/GPLv2 license.  When using or
3  * redistributing this file, you may do so under either license.
4  *
5  * GPL LICENSE SUMMARY
6  *
7  * Copyright(c) 2014 - 2015 Google Inc. All rights reserved.
8  * Copyright(c) 2014 - 2015 Linaro Ltd. All rights reserved.
9  *
10  * This program is free software; you can redistribute it and/or modify
11  * it under the terms of version 2 of the GNU General Public License as
12  * published by the Free Software Foundation.
13  *
14  * This program is distributed in the hope that it will be useful, but
15  * WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
17  * General Public License version 2 for more details.
18  *
19  * BSD LICENSE
20  *
21  * Copyright(c) 2014 - 2015 Google Inc. All rights reserved.
22  * Copyright(c) 2014 - 2015 Linaro Ltd. All rights reserved.
23  *
24  * Redistribution and use in source and binary forms, with or without
25  * modification, are permitted provided that the following conditions
26  * are met:
27  *
28  *  * Redistributions of source code must retain the above copyright
29  *    notice, this list of conditions and the following disclaimer.
30  *  * Redistributions in binary form must reproduce the above copyright
31  *    notice, this list of conditions and the following disclaimer in
32  *    the documentation and/or other materials provided with the
33  *    distribution.
34  *  * Neither the name of Google Inc. or Linaro Ltd. nor the names of
35  *    its contributors may be used to endorse or promote products
36  *    derived from this software without specific prior written
37  *    permission.
38  *
39  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
40  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
41  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
42  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GOOGLE INC. OR
43  * LINARO LTD. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
44  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
45  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
46  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
47  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
48  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
49  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
50  */
51
52 #ifndef __GREYBUS_PROTOCOLS_H
53 #define __GREYBUS_PROTOCOLS_H
54
55 /* Fixed IDs for control/svc protocols */
56
57 /* SVC switch-port device ids */
58 #define GB_SVC_DEVICE_ID_SVC                    0
59 #define GB_SVC_DEVICE_ID_AP                     1
60 #define GB_SVC_DEVICE_ID_MIN                    2
61 #define GB_SVC_DEVICE_ID_MAX                    31
62
63 #define GB_SVC_CPORT_ID                         0
64 #define GB_CONTROL_BUNDLE_ID                    0
65 #define GB_CONTROL_CPORT_ID                     0
66
67
68 /*
69  * All operation messages (both requests and responses) begin with
70  * a header that encodes the size of the message (header included).
71  * This header also contains a unique identifier, that associates a
72  * response message with its operation.  The header contains an
73  * operation type field, whose interpretation is dependent on what
74  * type of protocol is used over the connection.  The high bit
75  * (0x80) of the operation type field is used to indicate whether
76  * the message is a request (clear) or a response (set).
77  *
78  * Response messages include an additional result byte, which
79  * communicates the result of the corresponding request.  A zero
80  * result value means the operation completed successfully.  Any
81  * other value indicates an error; in this case, the payload of the
82  * response message (if any) is ignored.  The result byte must be
83  * zero in the header for a request message.
84  *
85  * The wire format for all numeric fields in the header is little
86  * endian.  Any operation-specific data begins immediately after the
87  * header.
88  */
89 struct gb_operation_msg_hdr {
90         __le16  size;           /* Size in bytes of header + payload */
91         __le16  operation_id;   /* Operation unique id */
92         __u8    type;           /* E.g GB_I2C_TYPE_* or GB_GPIO_TYPE_* */
93         __u8    result;         /* Result of request (in responses only) */
94         __u8    pad[2];         /* must be zero (ignore when read) */
95 } __packed;
96
97
98 /* Generic request types */
99 #define GB_REQUEST_TYPE_PING                    0x00
100 #define GB_REQUEST_TYPE_PROTOCOL_VERSION        0x01
101 #define GB_REQUEST_TYPE_INVALID                 0x7f
102
103 struct gb_protocol_version_request {
104         __u8    major;
105         __u8    minor;
106 } __packed;
107
108 struct gb_protocol_version_response {
109         __u8    major;
110         __u8    minor;
111 } __packed;
112
113 /* Control Protocol */
114
115 /* Greybus control request types */
116 #define GB_CONTROL_TYPE_VERSION                 0x01
117 #define GB_CONTROL_TYPE_PROBE_AP                0x02
118 #define GB_CONTROL_TYPE_GET_MANIFEST_SIZE       0x03
119 #define GB_CONTROL_TYPE_GET_MANIFEST            0x04
120 #define GB_CONTROL_TYPE_CONNECTED               0x05
121 #define GB_CONTROL_TYPE_DISCONNECTED            0x06
122 #define GB_CONTROL_TYPE_TIMESYNC_ENABLE         0x07
123 #define GB_CONTROL_TYPE_TIMESYNC_DISABLE        0x08
124 #define GB_CONTROL_TYPE_TIMESYNC_AUTHORITATIVE  0x09
125 /*      Unused                                  0x0a */
126 #define GB_CONTROL_TYPE_BUNDLE_VERSION          0x0b
127 #define GB_CONTROL_TYPE_DISCONNECTING           0x0c
128 #define GB_CONTROL_TYPE_TIMESYNC_GET_LAST_EVENT 0x0d
129 #define GB_CONTROL_TYPE_MODE_SWITCH             0x0e
130
131 struct gb_control_version_request {
132         __u8    major;
133         __u8    minor;
134 } __packed;
135
136 struct gb_control_version_response {
137         __u8    major;
138         __u8    minor;
139 } __packed;
140
141 struct gb_control_bundle_version_request {
142         __u8    bundle_id;
143 } __packed;
144
145 struct gb_control_bundle_version_response {
146         __u8    major;
147         __u8    minor;
148 } __packed;
149
150 /* Control protocol manifest get size request has no payload*/
151 struct gb_control_get_manifest_size_response {
152         __le16                  size;
153 } __packed;
154
155 /* Control protocol manifest get request has no payload */
156 struct gb_control_get_manifest_response {
157         __u8                    data[0];
158 } __packed;
159
160 /* Control protocol [dis]connected request */
161 struct gb_control_connected_request {
162         __le16                  cport_id;
163 } __packed;
164
165 struct gb_control_disconnecting_request {
166         __le16                  cport_id;
167 } __packed;
168 /* disconnecting response has no payload */
169
170 struct gb_control_disconnected_request {
171         __le16                  cport_id;
172 } __packed;
173 /* Control protocol [dis]connected response has no payload */
174
175 #define GB_TIMESYNC_MAX_STROBES                 0x04
176
177 struct gb_control_timesync_enable_request {
178         __u8    count;
179         __le64  frame_time;
180         __le32  strobe_delay;
181         __le32  refclk;
182 } __packed;
183 /* timesync enable response has no payload */
184
185 struct gb_control_timesync_authoritative_request {
186         __le64  frame_time[GB_TIMESYNC_MAX_STROBES];
187 } __packed;
188 /* timesync authoritative response has no payload */
189
190 /* timesync get_last_event_request has no payload */
191 struct gb_control_timesync_get_last_event_response {
192         __le64  frame_time;
193 } __packed;
194
195 /* APBridge protocol */
196
197 /* request APB1 log */
198 #define GB_APB_REQUEST_LOG                      0x02
199
200 /* request to map a cport to bulk in and bulk out endpoints */
201 #define GB_APB_REQUEST_EP_MAPPING               0x03
202
203 /* request to get the number of cports available */
204 #define GB_APB_REQUEST_CPORT_COUNT              0x04
205
206 /* request to reset a cport state */
207 #define GB_APB_REQUEST_RESET_CPORT              0x05
208
209 /* request to time the latency of messages on a given cport */
210 #define GB_APB_REQUEST_LATENCY_TAG_EN           0x06
211 #define GB_APB_REQUEST_LATENCY_TAG_DIS          0x07
212
213 /* request to control the CSI transmitter */
214 #define GB_APB_REQUEST_CSI_TX_CONTROL           0x08
215
216 /* request to control the CSI transmitter */
217 #define GB_APB_REQUEST_AUDIO_CONTROL            0x09
218
219 /* vendor requests to enable/disable CPort features */
220 #define GB_APB_REQUEST_CPORT_FEAT_EN            0x0b
221 #define GB_APB_REQUEST_CPORT_FEAT_DIS           0x0c
222
223 /* TimeSync commands */
224 #define REQUEST_TIMESYNC_ENABLE                 0x0d
225 #define REQUEST_TIMESYNC_DISABLE                0x0e
226 #define REQUEST_TIMESYNC_AUTHORITATIVE          0x0f
227 #define REQUEST_TIMESYNC_GET_LAST_EVENT         0x10
228
229 /* Firmware Download Protocol */
230
231 /* Request Types */
232 #define GB_FW_DOWNLOAD_TYPE_FIND_FIRMWARE       0x01
233 #define GB_FW_DOWNLOAD_TYPE_FETCH_FIRMWARE      0x02
234 #define GB_FW_DOWNLOAD_TYPE_RELEASE_FIRMWARE    0x03
235
236 #define GB_FIRMWARE_TAG_MAX_LEN                 10
237
238 /* firmware download find firmware request/response */
239 struct gb_fw_download_find_firmware_request {
240         __u8                    firmware_tag[GB_FIRMWARE_TAG_MAX_LEN];
241 } __packed;
242
243 struct gb_fw_download_find_firmware_response {
244         __u8                    firmware_id;
245         __le32                  size;
246 } __packed;
247
248 /* firmware download fetch firmware request/response */
249 struct gb_fw_download_fetch_firmware_request {
250         __u8                    firmware_id;
251         __le32                  offset;
252         __le32                  size;
253 } __packed;
254
255 struct gb_fw_download_fetch_firmware_response {
256         __u8                    data[0];
257 } __packed;
258
259 /* firmware download release firmware request */
260 struct gb_fw_download_release_firmware_request {
261         __u8                    firmware_id;
262 } __packed;
263 /* firmware download release firmware response has no payload */
264
265
266 /* Firmware Management Protocol */
267
268 /* Request Types */
269 #define GB_FW_MGMT_TYPE_INTERFACE_FW_VERSION    0x01
270 #define GB_FW_MGMT_TYPE_LOAD_AND_VALIDATE_FW    0x02
271 #define GB_FW_MGMT_TYPE_LOADED_FW               0x03
272 #define GB_FW_MGMT_TYPE_BACKEND_FW_VERSION      0x04
273 #define GB_FW_MGMT_TYPE_BACKEND_FW_UPDATE       0x05
274 #define GB_FW_MGMT_TYPE_BACKEND_FW_UPDATED      0x06
275
276 #define GB_FW_LOAD_METHOD_UNIPRO                0x01
277 #define GB_FW_LOAD_METHOD_INTERNAL              0x02
278
279 #define GB_FW_LOAD_STATUS_FAILED                0x00
280 #define GB_FW_LOAD_STATUS_UNVALIDATED           0x01
281 #define GB_FW_LOAD_STATUS_VALIDATED             0x02
282 #define GB_FW_LOAD_STATUS_VALIDATION_FAILED     0x03
283
284 #define GB_FW_BACKEND_FW_STATUS_SUCCESS         0x01
285 #define GB_FW_BACKEND_FW_STATUS_FAIL_FIND       0x02
286 #define GB_FW_BACKEND_FW_STATUS_FAIL_FETCH      0x03
287 #define GB_FW_BACKEND_FW_STATUS_FAIL_WRITE      0x04
288 #define GB_FW_BACKEND_FW_STATUS_INT             0x05
289
290 /* firmware management interface firmware version request has no payload */
291 struct gb_fw_mgmt_interface_fw_version_response {
292         __u8                    firmware_tag[GB_FIRMWARE_TAG_MAX_LEN];
293         __le16                  major;
294         __le16                  minor;
295 } __packed;
296
297 /* firmware management load and validate firmware request/response */
298 struct gb_fw_mgmt_load_and_validate_fw_request {
299         __u8                    request_id;
300         __u8                    load_method;
301         __u8                    firmware_tag[GB_FIRMWARE_TAG_MAX_LEN];
302 } __packed;
303 /* firmware management load and validate firmware response has no payload*/
304
305 /* firmware management loaded firmware request */
306 struct gb_fw_mgmt_loaded_fw_request {
307         __u8                    request_id;
308         __u8                    status;
309         __le16                  major;
310         __le16                  minor;
311 } __packed;
312 /* firmware management loaded firmware response has no payload */
313
314 /* firmware management backend firmware version request/response */
315 struct gb_fw_mgmt_backend_fw_version_request {
316         __u8                    firmware_tag[GB_FIRMWARE_TAG_MAX_LEN];
317 } __packed;
318
319 struct gb_fw_mgmt_backend_fw_version_response {
320         __le16                  major;
321         __le16                  minor;
322 } __packed;
323
324 /* firmware management backend firmware update request */
325 struct gb_fw_mgmt_backend_fw_update_request {
326         __u8                    request_id;
327         __u8                    firmware_tag[GB_FIRMWARE_TAG_MAX_LEN];
328 } __packed;
329 /* firmware management backend firmware update response has no payload */
330
331 /* firmware management backend firmware updated request */
332 struct gb_fw_mgmt_backend_fw_updated_request {
333         __u8                    request_id;
334         __u8                    status;
335 } __packed;
336 /* firmware management backend firmware updated response has no payload */
337
338
339 /* Bootrom Protocol */
340
341 /* Version of the Greybus bootrom protocol we support */
342 #define GB_BOOTROM_VERSION_MAJOR                0x00
343 #define GB_BOOTROM_VERSION_MINOR                0x01
344
345 /* Greybus bootrom request types */
346 #define GB_BOOTROM_TYPE_VERSION                 0x01
347 #define GB_BOOTROM_TYPE_FIRMWARE_SIZE           0x02
348 #define GB_BOOTROM_TYPE_GET_FIRMWARE            0x03
349 #define GB_BOOTROM_TYPE_READY_TO_BOOT           0x04
350 #define GB_BOOTROM_TYPE_AP_READY                0x05    /* Request with no-payload */
351 #define GB_BOOTROM_TYPE_GET_VID_PID             0x06    /* Request with no-payload */
352
353 /* Greybus bootrom boot stages */
354 #define GB_BOOTROM_BOOT_STAGE_ONE               0x01 /* Reserved for the boot ROM */
355 #define GB_BOOTROM_BOOT_STAGE_TWO               0x02 /* Bootrom package to be loaded by the boot ROM */
356 #define GB_BOOTROM_BOOT_STAGE_THREE             0x03 /* Module personality package loaded by Stage 2 firmware */
357
358 /* Greybus bootrom ready to boot status */
359 #define GB_BOOTROM_BOOT_STATUS_INVALID          0x00 /* Firmware blob could not be validated */
360 #define GB_BOOTROM_BOOT_STATUS_INSECURE         0x01 /* Firmware blob is valid but insecure */
361 #define GB_BOOTROM_BOOT_STATUS_SECURE           0x02 /* Firmware blob is valid and secure */
362
363 /* Max bootrom data fetch size in bytes */
364 #define GB_BOOTROM_FETCH_MAX                    2000
365
366 struct gb_bootrom_version_request {
367         __u8    major;
368         __u8    minor;
369 } __packed;
370
371 struct gb_bootrom_version_response {
372         __u8    major;
373         __u8    minor;
374 } __packed;
375
376 /* Bootrom protocol firmware size request/response */
377 struct gb_bootrom_firmware_size_request {
378         __u8                    stage;
379 } __packed;
380
381 struct gb_bootrom_firmware_size_response {
382         __le32                  size;
383 } __packed;
384
385 /* Bootrom protocol get firmware request/response */
386 struct gb_bootrom_get_firmware_request {
387         __le32                  offset;
388         __le32                  size;
389 } __packed;
390
391 struct gb_bootrom_get_firmware_response {
392         __u8                    data[0];
393 } __packed;
394
395 /* Bootrom protocol Ready to boot request */
396 struct gb_bootrom_ready_to_boot_request {
397         __u8                    status;
398 } __packed;
399 /* Bootrom protocol Ready to boot response has no payload */
400
401 /* Bootrom protocol get VID/PID request has no payload */
402 struct gb_bootrom_get_vid_pid_response {
403         __le32                  vendor_id;
404         __le32                  product_id;
405 } __packed;
406
407
408 /* Power Supply */
409
410 /* Version of the Greybus power supply protocol we support */
411 #define GB_POWER_SUPPLY_VERSION_MAJOR           0x00
412 #define GB_POWER_SUPPLY_VERSION_MINOR           0x01
413
414 /* Greybus power supply request types */
415 #define GB_POWER_SUPPLY_TYPE_GET_SUPPLIES               0x02
416 #define GB_POWER_SUPPLY_TYPE_GET_DESCRIPTION            0x03
417 #define GB_POWER_SUPPLY_TYPE_GET_PROP_DESCRIPTORS       0x04
418 #define GB_POWER_SUPPLY_TYPE_GET_PROPERTY               0x05
419 #define GB_POWER_SUPPLY_TYPE_SET_PROPERTY               0x06
420 #define GB_POWER_SUPPLY_TYPE_EVENT                      0x07
421
422 /* Should match up with battery technologies in linux/power_supply.h */
423 #define GB_POWER_SUPPLY_TECH_UNKNOWN                    0x0000
424 #define GB_POWER_SUPPLY_TECH_NiMH                       0x0001
425 #define GB_POWER_SUPPLY_TECH_LION                       0x0002
426 #define GB_POWER_SUPPLY_TECH_LIPO                       0x0003
427 #define GB_POWER_SUPPLY_TECH_LiFe                       0x0004
428 #define GB_POWER_SUPPLY_TECH_NiCd                       0x0005
429 #define GB_POWER_SUPPLY_TECH_LiMn                       0x0006
430
431 /* Should match up with power supply types in linux/power_supply.h */
432 #define GB_POWER_SUPPLY_UNKNOWN_TYPE                    0x0000
433 #define GB_POWER_SUPPLY_BATTERY_TYPE                    0x0001
434 #define GB_POWER_SUPPLY_UPS_TYPE                        0x0002
435 #define GB_POWER_SUPPLY_MAINS_TYPE                      0x0003
436 #define GB_POWER_SUPPLY_USB_TYPE                        0x0004
437 #define GB_POWER_SUPPLY_USB_DCP_TYPE                    0x0005
438 #define GB_POWER_SUPPLY_USB_CDP_TYPE                    0x0006
439 #define GB_POWER_SUPPLY_USB_ACA_TYPE                    0x0007
440
441 /* Should match up with power supply health in linux/power_supply.h */
442 #define GB_POWER_SUPPLY_HEALTH_UNKNOWN                  0x0000
443 #define GB_POWER_SUPPLY_HEALTH_GOOD                     0x0001
444 #define GB_POWER_SUPPLY_HEALTH_OVERHEAT                 0x0002
445 #define GB_POWER_SUPPLY_HEALTH_DEAD                     0x0003
446 #define GB_POWER_SUPPLY_HEALTH_OVERVOLTAGE              0x0004
447 #define GB_POWER_SUPPLY_HEALTH_UNSPEC_FAILURE           0x0005
448 #define GB_POWER_SUPPLY_HEALTH_COLD                     0x0006
449 #define GB_POWER_SUPPLY_HEALTH_WATCHDOG_TIMER_EXPIRE    0x0007
450 #define GB_POWER_SUPPLY_HEALTH_SAFETY_TIMER_EXPIRE      0x0008
451
452 /* Should match up with battery status in linux/power_supply.h */
453 #define GB_POWER_SUPPLY_STATUS_UNKNOWN          0x0000
454 #define GB_POWER_SUPPLY_STATUS_CHARGING         0x0001
455 #define GB_POWER_SUPPLY_STATUS_DISCHARGING      0x0002
456 #define GB_POWER_SUPPLY_STATUS_NOT_CHARGING     0x0003
457 #define GB_POWER_SUPPLY_STATUS_FULL             0x0004
458
459 struct gb_power_supply_get_supplies_response {
460         __u8    supplies_count;
461 } __packed;
462
463 struct gb_power_supply_get_description_request {
464         __u8    psy_id;
465 } __packed;
466
467 struct gb_power_supply_get_description_response {
468         __u8    manufacturer[32];
469         __u8    model[32];
470         __u8    serial_number[32];
471         __le16  type;
472         __u8    properties_count;
473 } __packed;
474
475 struct gb_power_supply_props_desc {
476         __u8    property;
477 #define GB_POWER_SUPPLY_PROP_STATUS                             0x00
478 #define GB_POWER_SUPPLY_PROP_CHARGE_TYPE                        0x01
479 #define GB_POWER_SUPPLY_PROP_HEALTH                             0x02
480 #define GB_POWER_SUPPLY_PROP_PRESENT                            0x03
481 #define GB_POWER_SUPPLY_PROP_ONLINE                             0x04
482 #define GB_POWER_SUPPLY_PROP_AUTHENTIC                          0x05
483 #define GB_POWER_SUPPLY_PROP_TECHNOLOGY                         0x06
484 #define GB_POWER_SUPPLY_PROP_CYCLE_COUNT                        0x07
485 #define GB_POWER_SUPPLY_PROP_VOLTAGE_MAX                        0x08
486 #define GB_POWER_SUPPLY_PROP_VOLTAGE_MIN                        0x09
487 #define GB_POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN                 0x0A
488 #define GB_POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN                 0x0B
489 #define GB_POWER_SUPPLY_PROP_VOLTAGE_NOW                        0x0C
490 #define GB_POWER_SUPPLY_PROP_VOLTAGE_AVG                        0x0D
491 #define GB_POWER_SUPPLY_PROP_VOLTAGE_OCV                        0x0E
492 #define GB_POWER_SUPPLY_PROP_VOLTAGE_BOOT                       0x0F
493 #define GB_POWER_SUPPLY_PROP_CURRENT_MAX                        0x10
494 #define GB_POWER_SUPPLY_PROP_CURRENT_NOW                        0x11
495 #define GB_POWER_SUPPLY_PROP_CURRENT_AVG                        0x12
496 #define GB_POWER_SUPPLY_PROP_CURRENT_BOOT                       0x13
497 #define GB_POWER_SUPPLY_PROP_POWER_NOW                          0x14
498 #define GB_POWER_SUPPLY_PROP_POWER_AVG                          0x15
499 #define GB_POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN                 0x16
500 #define GB_POWER_SUPPLY_PROP_CHARGE_EMPTY_DESIGN                0x17
501 #define GB_POWER_SUPPLY_PROP_CHARGE_FULL                        0x18
502 #define GB_POWER_SUPPLY_PROP_CHARGE_EMPTY                       0x19
503 #define GB_POWER_SUPPLY_PROP_CHARGE_NOW                         0x1A
504 #define GB_POWER_SUPPLY_PROP_CHARGE_AVG                         0x1B
505 #define GB_POWER_SUPPLY_PROP_CHARGE_COUNTER                     0x1C
506 #define GB_POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT            0x1D
507 #define GB_POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT_MAX        0x1E
508 #define GB_POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE            0x1F
509 #define GB_POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE_MAX        0x20
510 #define GB_POWER_SUPPLY_PROP_CHARGE_CONTROL_LIMIT               0x21
511 #define GB_POWER_SUPPLY_PROP_CHARGE_CONTROL_LIMIT_MAX           0x22
512 #define GB_POWER_SUPPLY_PROP_INPUT_CURRENT_LIMIT                0x23
513 #define GB_POWER_SUPPLY_PROP_ENERGY_FULL_DESIGN                 0x24
514 #define GB_POWER_SUPPLY_PROP_ENERGY_EMPTY_DESIGN                0x25
515 #define GB_POWER_SUPPLY_PROP_ENERGY_FULL                        0x26
516 #define GB_POWER_SUPPLY_PROP_ENERGY_EMPTY                       0x27
517 #define GB_POWER_SUPPLY_PROP_ENERGY_NOW                         0x28
518 #define GB_POWER_SUPPLY_PROP_ENERGY_AVG                         0x29
519 #define GB_POWER_SUPPLY_PROP_CAPACITY                           0x2A
520 #define GB_POWER_SUPPLY_PROP_CAPACITY_ALERT_MIN                 0x2B
521 #define GB_POWER_SUPPLY_PROP_CAPACITY_ALERT_MAX                 0x2C
522 #define GB_POWER_SUPPLY_PROP_CAPACITY_LEVEL                     0x2D
523 #define GB_POWER_SUPPLY_PROP_TEMP                               0x2E
524 #define GB_POWER_SUPPLY_PROP_TEMP_MAX                           0x2F
525 #define GB_POWER_SUPPLY_PROP_TEMP_MIN                           0x30
526 #define GB_POWER_SUPPLY_PROP_TEMP_ALERT_MIN                     0x31
527 #define GB_POWER_SUPPLY_PROP_TEMP_ALERT_MAX                     0x32
528 #define GB_POWER_SUPPLY_PROP_TEMP_AMBIENT                       0x33
529 #define GB_POWER_SUPPLY_PROP_TEMP_AMBIENT_ALERT_MIN             0x34
530 #define GB_POWER_SUPPLY_PROP_TEMP_AMBIENT_ALERT_MAX             0x35
531 #define GB_POWER_SUPPLY_PROP_TIME_TO_EMPTY_NOW                  0x36
532 #define GB_POWER_SUPPLY_PROP_TIME_TO_EMPTY_AVG                  0x37
533 #define GB_POWER_SUPPLY_PROP_TIME_TO_FULL_NOW                   0x38
534 #define GB_POWER_SUPPLY_PROP_TIME_TO_FULL_AVG                   0x39
535 #define GB_POWER_SUPPLY_PROP_TYPE                               0x3A
536 #define GB_POWER_SUPPLY_PROP_SCOPE                              0x3B
537 #define GB_POWER_SUPPLY_PROP_CHARGE_TERM_CURRENT                0x3C
538 #define GB_POWER_SUPPLY_PROP_CALIBRATE                          0x3D
539         __u8    is_writeable;
540 } __packed;
541
542 struct gb_power_supply_get_property_descriptors_request {
543         __u8    psy_id;
544 } __packed;
545
546 struct gb_power_supply_get_property_descriptors_response {
547         __u8    properties_count;
548         struct gb_power_supply_props_desc props[];
549 } __packed;
550
551 struct gb_power_supply_get_property_request {
552         __u8    psy_id;
553         __u8    property;
554 } __packed;
555
556 struct gb_power_supply_get_property_response {
557         __le32  prop_val;
558 };
559
560 struct gb_power_supply_set_property_request {
561         __u8    psy_id;
562         __u8    property;
563         __le32  prop_val;
564 } __packed;
565
566 struct gb_power_supply_event_request {
567         __u8    psy_id;
568         __u8    event;
569 #define GB_POWER_SUPPLY_UPDATE          0x01
570 } __packed;
571
572
573 /* HID */
574
575 /* Version of the Greybus hid protocol we support */
576 #define GB_HID_VERSION_MAJOR            0x00
577 #define GB_HID_VERSION_MINOR            0x01
578
579 /* Greybus HID operation types */
580 #define GB_HID_TYPE_GET_DESC            0x02
581 #define GB_HID_TYPE_GET_REPORT_DESC     0x03
582 #define GB_HID_TYPE_PWR_ON              0x04
583 #define GB_HID_TYPE_PWR_OFF             0x05
584 #define GB_HID_TYPE_GET_REPORT          0x06
585 #define GB_HID_TYPE_SET_REPORT          0x07
586 #define GB_HID_TYPE_IRQ_EVENT           0x08
587
588 /* Report type */
589 #define GB_HID_INPUT_REPORT             0
590 #define GB_HID_OUTPUT_REPORT            1
591 #define GB_HID_FEATURE_REPORT           2
592
593 /* Different request/response structures */
594 /* HID get descriptor response */
595 struct gb_hid_desc_response {
596         __u8                            bLength;
597         __le16                          wReportDescLength;
598         __le16                          bcdHID;
599         __le16                          wProductID;
600         __le16                          wVendorID;
601         __u8                            bCountryCode;
602 } __packed;
603
604 /* HID get report request/response */
605 struct gb_hid_get_report_request {
606         __u8                            report_type;
607         __u8                            report_id;
608 } __packed;
609
610 /* HID set report request */
611 struct gb_hid_set_report_request {
612         __u8                            report_type;
613         __u8                            report_id;
614         __u8                            report[0];
615 } __packed;
616
617 /* HID input report request, via interrupt pipe */
618 struct gb_hid_input_report_request {
619         __u8                            report[0];
620 } __packed;
621
622
623 /* I2C */
624
625 /* Version of the Greybus i2c protocol we support */
626 #define GB_I2C_VERSION_MAJOR            0x00
627 #define GB_I2C_VERSION_MINOR            0x01
628
629 /* Greybus i2c request types */
630 #define GB_I2C_TYPE_FUNCTIONALITY       0x02
631 #define GB_I2C_TYPE_TRANSFER            0x05
632
633 /* functionality request has no payload */
634 struct gb_i2c_functionality_response {
635         __le32  functionality;
636 } __packed;
637
638 /*
639  * Outgoing data immediately follows the op count and ops array.
640  * The data for each write (master -> slave) op in the array is sent
641  * in order, with no (e.g. pad) bytes separating them.
642  *
643  * Short reads cause the entire transfer request to fail So response
644  * payload consists only of bytes read, and the number of bytes is
645  * exactly what was specified in the corresponding op.  Like
646  * outgoing data, the incoming data is in order and contiguous.
647  */
648 struct gb_i2c_transfer_op {
649         __le16  addr;
650         __le16  flags;
651         __le16  size;
652 } __packed;
653
654 struct gb_i2c_transfer_request {
655         __le16                          op_count;
656         struct gb_i2c_transfer_op       ops[0];         /* op_count of these */
657 } __packed;
658 struct gb_i2c_transfer_response {
659         __u8                            data[0];        /* inbound data */
660 } __packed;
661
662
663 /* GPIO */
664
665 /* Version of the Greybus GPIO protocol we support */
666 #define GB_GPIO_VERSION_MAJOR           0x00
667 #define GB_GPIO_VERSION_MINOR           0x01
668
669 /* Greybus GPIO request types */
670 #define GB_GPIO_TYPE_LINE_COUNT         0x02
671 #define GB_GPIO_TYPE_ACTIVATE           0x03
672 #define GB_GPIO_TYPE_DEACTIVATE         0x04
673 #define GB_GPIO_TYPE_GET_DIRECTION      0x05
674 #define GB_GPIO_TYPE_DIRECTION_IN       0x06
675 #define GB_GPIO_TYPE_DIRECTION_OUT      0x07
676 #define GB_GPIO_TYPE_GET_VALUE          0x08
677 #define GB_GPIO_TYPE_SET_VALUE          0x09
678 #define GB_GPIO_TYPE_SET_DEBOUNCE       0x0a
679 #define GB_GPIO_TYPE_IRQ_TYPE           0x0b
680 #define GB_GPIO_TYPE_IRQ_MASK           0x0c
681 #define GB_GPIO_TYPE_IRQ_UNMASK         0x0d
682 #define GB_GPIO_TYPE_IRQ_EVENT          0x0e
683
684 #define GB_GPIO_IRQ_TYPE_NONE           0x00
685 #define GB_GPIO_IRQ_TYPE_EDGE_RISING    0x01
686 #define GB_GPIO_IRQ_TYPE_EDGE_FALLING   0x02
687 #define GB_GPIO_IRQ_TYPE_EDGE_BOTH      0x03
688 #define GB_GPIO_IRQ_TYPE_LEVEL_HIGH     0x04
689 #define GB_GPIO_IRQ_TYPE_LEVEL_LOW      0x08
690
691 /* line count request has no payload */
692 struct gb_gpio_line_count_response {
693         __u8    count;
694 } __packed;
695
696 struct gb_gpio_activate_request {
697         __u8    which;
698 } __packed;
699 /* activate response has no payload */
700
701 struct gb_gpio_deactivate_request {
702         __u8    which;
703 } __packed;
704 /* deactivate response has no payload */
705
706 struct gb_gpio_get_direction_request {
707         __u8    which;
708 } __packed;
709 struct gb_gpio_get_direction_response {
710         __u8    direction;
711 } __packed;
712
713 struct gb_gpio_direction_in_request {
714         __u8    which;
715 } __packed;
716 /* direction in response has no payload */
717
718 struct gb_gpio_direction_out_request {
719         __u8    which;
720         __u8    value;
721 } __packed;
722 /* direction out response has no payload */
723
724 struct gb_gpio_get_value_request {
725         __u8    which;
726 } __packed;
727 struct gb_gpio_get_value_response {
728         __u8    value;
729 } __packed;
730
731 struct gb_gpio_set_value_request {
732         __u8    which;
733         __u8    value;
734 } __packed;
735 /* set value response has no payload */
736
737 struct gb_gpio_set_debounce_request {
738         __u8    which;
739         __le16  usec;
740 } __packed;
741 /* debounce response has no payload */
742
743 struct gb_gpio_irq_type_request {
744         __u8    which;
745         __u8    type;
746 } __packed;
747 /* irq type response has no payload */
748
749 struct gb_gpio_irq_mask_request {
750         __u8    which;
751 } __packed;
752 /* irq mask response has no payload */
753
754 struct gb_gpio_irq_unmask_request {
755         __u8    which;
756 } __packed;
757 /* irq unmask response has no payload */
758
759 /* irq event requests originate on another module and are handled on the AP */
760 struct gb_gpio_irq_event_request {
761         __u8    which;
762 } __packed;
763 /* irq event has no response */
764
765
766 /* PWM */
767
768 /* Version of the Greybus PWM protocol we support */
769 #define GB_PWM_VERSION_MAJOR            0x00
770 #define GB_PWM_VERSION_MINOR            0x01
771
772 /* Greybus PWM operation types */
773 #define GB_PWM_TYPE_PWM_COUNT           0x02
774 #define GB_PWM_TYPE_ACTIVATE            0x03
775 #define GB_PWM_TYPE_DEACTIVATE          0x04
776 #define GB_PWM_TYPE_CONFIG              0x05
777 #define GB_PWM_TYPE_POLARITY            0x06
778 #define GB_PWM_TYPE_ENABLE              0x07
779 #define GB_PWM_TYPE_DISABLE             0x08
780
781 /* pwm count request has no payload */
782 struct gb_pwm_count_response {
783         __u8    count;
784 } __packed;
785
786 struct gb_pwm_activate_request {
787         __u8    which;
788 } __packed;
789
790 struct gb_pwm_deactivate_request {
791         __u8    which;
792 } __packed;
793
794 struct gb_pwm_config_request {
795         __u8    which;
796         __le32  duty;
797         __le32  period;
798 } __packed;
799
800 struct gb_pwm_polarity_request {
801         __u8    which;
802         __u8    polarity;
803 } __packed;
804
805 struct gb_pwm_enable_request {
806         __u8    which;
807 } __packed;
808
809 struct gb_pwm_disable_request {
810         __u8    which;
811 } __packed;
812
813 /* SPI */
814
815 /* Version of the Greybus spi protocol we support */
816 #define GB_SPI_VERSION_MAJOR            0x00
817 #define GB_SPI_VERSION_MINOR            0x01
818
819 /* Should match up with modes in linux/spi/spi.h */
820 #define GB_SPI_MODE_CPHA                0x01            /* clock phase */
821 #define GB_SPI_MODE_CPOL                0x02            /* clock polarity */
822 #define GB_SPI_MODE_MODE_0              (0|0)           /* (original MicroWire) */
823 #define GB_SPI_MODE_MODE_1              (0|GB_SPI_MODE_CPHA)
824 #define GB_SPI_MODE_MODE_2              (GB_SPI_MODE_CPOL|0)
825 #define GB_SPI_MODE_MODE_3              (GB_SPI_MODE_CPOL|GB_SPI_MODE_CPHA)
826 #define GB_SPI_MODE_CS_HIGH             0x04            /* chipselect active high? */
827 #define GB_SPI_MODE_LSB_FIRST           0x08            /* per-word bits-on-wire */
828 #define GB_SPI_MODE_3WIRE               0x10            /* SI/SO signals shared */
829 #define GB_SPI_MODE_LOOP                0x20            /* loopback mode */
830 #define GB_SPI_MODE_NO_CS               0x40            /* 1 dev/bus, no chipselect */
831 #define GB_SPI_MODE_READY               0x80            /* slave pulls low to pause */
832
833 /* Should match up with flags in linux/spi/spi.h */
834 #define GB_SPI_FLAG_HALF_DUPLEX         BIT(0)          /* can't do full duplex */
835 #define GB_SPI_FLAG_NO_RX               BIT(1)          /* can't do buffer read */
836 #define GB_SPI_FLAG_NO_TX               BIT(2)          /* can't do buffer write */
837
838 /* Greybus spi operation types */
839 #define GB_SPI_TYPE_MASTER_CONFIG       0x02
840 #define GB_SPI_TYPE_DEVICE_CONFIG       0x03
841 #define GB_SPI_TYPE_TRANSFER            0x04
842
843 /* mode request has no payload */
844 struct gb_spi_master_config_response {
845         __le32  bits_per_word_mask;
846         __le32  min_speed_hz;
847         __le32  max_speed_hz;
848         __le16  mode;
849         __le16  flags;
850         __u8    num_chipselect;
851 } __packed;
852
853 struct gb_spi_device_config_request {
854         __u8    chip_select;
855 } __packed;
856
857 struct gb_spi_device_config_response {
858         __le16  mode;
859         __u8    bits_per_word;
860         __le32  max_speed_hz;
861         __u8    device_type;
862 #define GB_SPI_SPI_DEV          0x00
863 #define GB_SPI_SPI_NOR          0x01
864 #define GB_SPI_SPI_MODALIAS     0x02
865         __u8    name[32];
866 } __packed;
867
868 /**
869  * struct gb_spi_transfer - a read/write buffer pair
870  * @speed_hz: Select a speed other than the device default for this transfer. If
871  *      0 the default (from @spi_device) is used.
872  * @len: size of rx and tx buffers (in bytes)
873  * @delay_usecs: microseconds to delay after this transfer before (optionally)
874  *      changing the chipselect status, then starting the next transfer or
875  *      completing this spi_message.
876  * @cs_change: affects chipselect after this transfer completes
877  * @bits_per_word: select a bits_per_word other than the device default for this
878  *      transfer. If 0 the default (from @spi_device) is used.
879  */
880 struct gb_spi_transfer {
881         __le32          speed_hz;
882         __le32          len;
883         __le16          delay_usecs;
884         __u8            cs_change;
885         __u8            bits_per_word;
886         __u8            xfer_flags;
887 #define GB_SPI_XFER_READ        0x01
888 #define GB_SPI_XFER_WRITE       0x02
889 #define GB_SPI_XFER_INPROGRESS  0x04
890 } __packed;
891
892 struct gb_spi_transfer_request {
893         __u8                    chip_select;    /* of the spi device */
894         __u8                    mode;           /* of the spi device */
895         __le16                  count;
896         struct gb_spi_transfer  transfers[0];   /* count of these */
897 } __packed;
898
899 struct gb_spi_transfer_response {
900         __u8                    data[0];        /* inbound data */
901 } __packed;
902
903 /* Version of the Greybus SVC protocol we support */
904 #define GB_SVC_VERSION_MAJOR            0x00
905 #define GB_SVC_VERSION_MINOR            0x01
906
907 /* Greybus SVC request types */
908 #define GB_SVC_TYPE_PROTOCOL_VERSION            0x01
909 #define GB_SVC_TYPE_SVC_HELLO                   0x02
910 #define GB_SVC_TYPE_INTF_DEVICE_ID              0x03
911 #define GB_SVC_TYPE_INTF_RESET                  0x06
912 #define GB_SVC_TYPE_CONN_CREATE                 0x07
913 #define GB_SVC_TYPE_CONN_DESTROY                0x08
914 #define GB_SVC_TYPE_DME_PEER_GET                0x09
915 #define GB_SVC_TYPE_DME_PEER_SET                0x0a
916 #define GB_SVC_TYPE_ROUTE_CREATE                0x0b
917 #define GB_SVC_TYPE_ROUTE_DESTROY               0x0c
918 #define GB_SVC_TYPE_TIMESYNC_ENABLE             0x0d
919 #define GB_SVC_TYPE_TIMESYNC_DISABLE            0x0e
920 #define GB_SVC_TYPE_TIMESYNC_AUTHORITATIVE      0x0f
921 #define GB_SVC_TYPE_INTF_SET_PWRM               0x10
922 #define GB_SVC_TYPE_INTF_EJECT                  0x11
923 #define GB_SVC_TYPE_KEY_EVENT                   0x12
924 #define GB_SVC_TYPE_PING                        0x13
925 #define GB_SVC_TYPE_PWRMON_RAIL_COUNT_GET       0x14
926 #define GB_SVC_TYPE_PWRMON_RAIL_NAMES_GET       0x15
927 #define GB_SVC_TYPE_PWRMON_SAMPLE_GET           0x16
928 #define GB_SVC_TYPE_PWRMON_INTF_SAMPLE_GET      0x17
929 #define GB_SVC_TYPE_TIMESYNC_WAKE_PINS_ACQUIRE  0x18
930 #define GB_SVC_TYPE_TIMESYNC_WAKE_PINS_RELEASE  0x19
931 #define GB_SVC_TYPE_TIMESYNC_PING               0x1a
932 #define GB_SVC_TYPE_MODULE_INSERTED             0x1f
933 #define GB_SVC_TYPE_MODULE_REMOVED              0x20
934 #define GB_SVC_TYPE_INTF_VSYS_ENABLE            0x21
935 #define GB_SVC_TYPE_INTF_VSYS_DISABLE           0x22
936 #define GB_SVC_TYPE_INTF_REFCLK_ENABLE          0x23
937 #define GB_SVC_TYPE_INTF_REFCLK_DISABLE         0x24
938 #define GB_SVC_TYPE_INTF_UNIPRO_ENABLE          0x25
939 #define GB_SVC_TYPE_INTF_UNIPRO_DISABLE         0x26
940 #define GB_SVC_TYPE_INTF_ACTIVATE               0x27
941 #define GB_SVC_TYPE_INTF_MAILBOX_EVENT          0x29
942
943 /* Greybus SVC protocol status values */
944 #define GB_SVC_OP_SUCCESS                       0x00
945 #define GB_SVC_OP_UNKNOWN_ERROR                 0x01
946 #define GB_SVC_INTF_NOT_DETECTED                0x02
947 #define GB_SVC_INTF_NO_UPRO_LINK                0x03
948 #define GB_SVC_INTF_UPRO_NOT_DOWN               0x04
949 #define GB_SVC_INTF_UPRO_NOT_HIBERNATED         0x05
950 #define GB_SVC_INTF_NO_V_SYS                    0x06
951 #define GB_SVC_INTF_V_CHG                       0x07
952 #define GB_SVC_INTF_WAKE_BUSY                   0x08
953 #define GB_SVC_INTF_NO_REFCLK                   0x09
954 #define GB_SVC_INTF_RELEASING                   0x0a
955 #define GB_SVC_INTF_NO_ORDER                    0x0b
956 #define GB_SVC_INTF_MBOX_SET                    0x0c
957 #define GB_SVC_INTF_BAD_MBOX                    0x0d
958 #define GB_SVC_INTF_OP_TIMEOUT                  0x0e
959 #define GB_SVC_PWRMON_OP_NOT_PRESENT            0x0f
960
961 struct gb_svc_version_request {
962         __u8    major;
963         __u8    minor;
964 } __packed;
965
966 struct gb_svc_version_response {
967         __u8    major;
968         __u8    minor;
969 } __packed;
970
971 /* SVC protocol hello request */
972 struct gb_svc_hello_request {
973         __le16                  endo_id;
974         __u8                    interface_id;
975 } __packed;
976 /* hello response has no payload */
977
978 struct gb_svc_intf_device_id_request {
979         __u8    intf_id;
980         __u8    device_id;
981 } __packed;
982 /* device id response has no payload */
983
984 struct gb_svc_intf_reset_request {
985         __u8    intf_id;
986 } __packed;
987 /* interface reset response has no payload */
988
989 struct gb_svc_intf_eject_request {
990         __u8    intf_id;
991 } __packed;
992 /* interface eject response has no payload */
993
994 struct gb_svc_conn_create_request {
995         __u8    intf1_id;
996         __le16  cport1_id;
997         __u8    intf2_id;
998         __le16  cport2_id;
999         __u8    tc;
1000         __u8    flags;
1001 } __packed;
1002 /* connection create response has no payload */
1003
1004 struct gb_svc_conn_destroy_request {
1005         __u8    intf1_id;
1006         __le16  cport1_id;
1007         __u8    intf2_id;
1008         __le16  cport2_id;
1009 } __packed;
1010 /* connection destroy response has no payload */
1011
1012 struct gb_svc_dme_peer_get_request {
1013         __u8    intf_id;
1014         __le16  attr;
1015         __le16  selector;
1016 } __packed;
1017
1018 struct gb_svc_dme_peer_get_response {
1019         __le16  result_code;
1020         __le32  attr_value;
1021 } __packed;
1022
1023 struct gb_svc_dme_peer_set_request {
1024         __u8    intf_id;
1025         __le16  attr;
1026         __le16  selector;
1027         __le32  value;
1028 } __packed;
1029
1030 struct gb_svc_dme_peer_set_response {
1031         __le16  result_code;
1032 } __packed;
1033
1034 /* Greybus init-status values, currently retrieved using DME peer gets. */
1035 #define GB_INIT_SPI_BOOT_STARTED                        0x02
1036 #define GB_INIT_TRUSTED_SPI_BOOT_FINISHED               0x03
1037 #define GB_INIT_UNTRUSTED_SPI_BOOT_FINISHED             0x04
1038 #define GB_INIT_BOOTROM_UNIPRO_BOOT_STARTED             0x06
1039 #define GB_INIT_BOOTROM_FALLBACK_UNIPRO_BOOT_STARTED    0x09
1040
1041 struct gb_svc_route_create_request {
1042         __u8    intf1_id;
1043         __u8    dev1_id;
1044         __u8    intf2_id;
1045         __u8    dev2_id;
1046 } __packed;
1047 /* route create response has no payload */
1048
1049 struct gb_svc_route_destroy_request {
1050         __u8    intf1_id;
1051         __u8    intf2_id;
1052 } __packed;
1053 /* route destroy response has no payload */
1054
1055 /* used for svc_intf_vsys_{enable,disable} */
1056 struct gb_svc_intf_vsys_request {
1057         __u8    intf_id;
1058 } __packed;
1059
1060 struct gb_svc_intf_vsys_response {
1061         __u8    result_code;
1062 #define GB_SVC_INTF_VSYS_OK                             0x00
1063 #define GB_SVC_INTF_VSYS_BUSY                           0x01
1064 #define GB_SVC_INTF_VSYS_FAIL                           0x02
1065 } __packed;
1066
1067 /* used for svc_intf_refclk_{enable,disable} */
1068 struct gb_svc_intf_refclk_request {
1069         __u8    intf_id;
1070 } __packed;
1071
1072 struct gb_svc_intf_refclk_response {
1073         __u8    result_code;
1074 #define GB_SVC_INTF_REFCLK_OK                           0x00
1075 #define GB_SVC_INTF_REFCLK_BUSY                         0x01
1076 #define GB_SVC_INTF_REFCLK_FAIL                         0x02
1077 } __packed;
1078
1079 /* used for svc_intf_unipro_{enable,disable} */
1080 struct gb_svc_intf_unipro_request {
1081         __u8    intf_id;
1082 } __packed;
1083
1084 struct gb_svc_intf_unipro_response {
1085         __u8    result_code;
1086 #define GB_SVC_INTF_UNIPRO_OK                           0x00
1087 #define GB_SVC_INTF_UNIPRO_BUSY                         0x01
1088 #define GB_SVC_INTF_UNIPRO_FAIL                         0x02
1089 #define GB_SVC_INTF_UNIPRO_NOT_OFF                      0x03
1090 } __packed;
1091
1092 struct gb_svc_timesync_enable_request {
1093         __u8    count;
1094         __le64  frame_time;
1095         __le32  strobe_delay;
1096         __le32  refclk;
1097 } __packed;
1098 /* timesync enable response has no payload */
1099
1100 /* timesync authoritative request has no payload */
1101 struct gb_svc_timesync_authoritative_response {
1102         __le64  frame_time[GB_TIMESYNC_MAX_STROBES];
1103 };
1104
1105 struct gb_svc_timesync_wake_pins_acquire_request {
1106         __le32  strobe_mask;
1107 };
1108
1109 /* timesync wake pins acquire response has no payload */
1110
1111 /* timesync wake pins release request has no payload */
1112 /* timesync wake pins release response has no payload */
1113
1114 /* timesync svc ping request has no payload */
1115 struct gb_svc_timesync_ping_response {
1116         __le64  frame_time;
1117 } __packed;
1118
1119 #define GB_SVC_UNIPRO_FAST_MODE                 0x01
1120 #define GB_SVC_UNIPRO_SLOW_MODE                 0x02
1121 #define GB_SVC_UNIPRO_FAST_AUTO_MODE            0x04
1122 #define GB_SVC_UNIPRO_SLOW_AUTO_MODE            0x05
1123 #define GB_SVC_UNIPRO_MODE_UNCHANGED            0x07
1124 #define GB_SVC_UNIPRO_HIBERNATE_MODE            0x11
1125 #define GB_SVC_UNIPRO_OFF_MODE                  0x12
1126
1127 #define GB_SVC_PWRM_RXTERMINATION               0x01
1128 #define GB_SVC_PWRM_TXTERMINATION               0x02
1129 #define GB_SVC_PWRM_LINE_RESET                  0x04
1130 #define GB_SVC_PWRM_SCRAMBLING                  0x20
1131
1132 #define GB_SVC_PWRM_QUIRK_HSSER                 0x00000001
1133
1134 #define GB_SVC_UNIPRO_HS_SERIES_A               0x01
1135 #define GB_SVC_UNIPRO_HS_SERIES_B               0x02
1136
1137 struct gb_svc_intf_set_pwrm_request {
1138         __u8    intf_id;
1139         __u8    hs_series;
1140         __u8    tx_mode;
1141         __u8    tx_gear;
1142         __u8    tx_nlanes;
1143         __u8    rx_mode;
1144         __u8    rx_gear;
1145         __u8    rx_nlanes;
1146         __u8    flags;
1147         __le32  quirks;
1148 } __packed;
1149
1150 struct gb_svc_intf_set_pwrm_response {
1151         __le16  result_code;
1152 } __packed;
1153
1154 struct gb_svc_key_event_request {
1155         __le16  key_code;
1156 #define GB_KEYCODE_ARA         0x00
1157
1158         __u8    key_event;
1159 #define GB_SVC_KEY_RELEASED    0x00
1160 #define GB_SVC_KEY_PRESSED     0x01
1161 } __packed;
1162
1163 #define GB_SVC_PWRMON_MAX_RAIL_COUNT            254
1164
1165 struct gb_svc_pwrmon_rail_count_get_response {
1166         __u8    rail_count;
1167 } __packed;
1168
1169 #define GB_SVC_PWRMON_RAIL_NAME_BUFSIZE         32
1170
1171 struct gb_svc_pwrmon_rail_names_get_response {
1172         __u8    name[0][GB_SVC_PWRMON_RAIL_NAME_BUFSIZE];
1173 } __packed;
1174
1175 #define GB_SVC_PWRMON_TYPE_CURR                 0x01
1176 #define GB_SVC_PWRMON_TYPE_VOL                  0x02
1177 #define GB_SVC_PWRMON_TYPE_PWR                  0x03
1178
1179 #define GB_SVC_PWRMON_GET_SAMPLE_OK             0x00
1180 #define GB_SVC_PWRMON_GET_SAMPLE_INVAL          0x01
1181 #define GB_SVC_PWRMON_GET_SAMPLE_NOSUPP         0x02
1182 #define GB_SVC_PWRMON_GET_SAMPLE_HWERR          0x03
1183
1184 struct gb_svc_pwrmon_sample_get_request {
1185         __u8    rail_id;
1186         __u8    measurement_type;
1187 } __packed;
1188
1189 struct gb_svc_pwrmon_sample_get_response {
1190         __u8    result;
1191         __le32  measurement;
1192 } __packed;
1193
1194 struct gb_svc_pwrmon_intf_sample_get_request {
1195         __u8    intf_id;
1196         __u8    measurement_type;
1197 } __packed;
1198
1199 struct gb_svc_pwrmon_intf_sample_get_response {
1200         __u8    result;
1201         __le32  measurement;
1202 } __packed;
1203
1204 #define GB_SVC_MODULE_INSERTED_FLAG_NO_PRIMARY  0x0001
1205
1206 struct gb_svc_module_inserted_request {
1207         __u8    primary_intf_id;
1208         __u8    intf_count;
1209         __le16  flags;
1210 } __packed;
1211 /* module_inserted response has no payload */
1212
1213 struct gb_svc_module_removed_request {
1214         __u8    primary_intf_id;
1215 } __packed;
1216 /* module_removed response has no payload */
1217
1218 struct gb_svc_intf_activate_request {
1219         __u8    intf_id;
1220 } __packed;
1221
1222 #define GB_SVC_INTF_TYPE_UNKNOWN                0x00
1223 #define GB_SVC_INTF_TYPE_DUMMY                  0x01
1224 #define GB_SVC_INTF_TYPE_UNIPRO                 0x02
1225 #define GB_SVC_INTF_TYPE_GREYBUS                0x03
1226
1227 struct gb_svc_intf_activate_response {
1228         __u8    status;
1229         __u8    intf_type;
1230 } __packed;
1231
1232 #define GB_SVC_INTF_MAILBOX_NONE                0x00
1233 #define GB_SVC_INTF_MAILBOX_AP                  0x01
1234 #define GB_SVC_INTF_MAILBOX_GREYBUS             0x02
1235
1236 struct gb_svc_intf_mailbox_event_request {
1237         __u8    intf_id;
1238         __le16  result_code;
1239         __le32  mailbox;
1240 } __packed;
1241 /* intf_mailbox_event response has no payload */
1242
1243
1244 /* RAW */
1245
1246 /* Version of the Greybus raw protocol we support */
1247 #define GB_RAW_VERSION_MAJOR                    0x00
1248 #define GB_RAW_VERSION_MINOR                    0x01
1249
1250 /* Greybus raw request types */
1251 #define GB_RAW_TYPE_SEND                        0x02
1252
1253 struct gb_raw_send_request {
1254         __le32  len;
1255         __u8    data[0];
1256 } __packed;
1257
1258
1259 /* UART */
1260
1261 /* Version of the Greybus UART protocol we support */
1262 #define GB_UART_VERSION_MAJOR           0x00
1263 #define GB_UART_VERSION_MINOR           0x01
1264
1265 /* Greybus UART operation types */
1266 #define GB_UART_TYPE_SEND_DATA                  0x02
1267 #define GB_UART_TYPE_RECEIVE_DATA               0x03    /* Unsolicited data */
1268 #define GB_UART_TYPE_SET_LINE_CODING            0x04
1269 #define GB_UART_TYPE_SET_CONTROL_LINE_STATE     0x05
1270 #define GB_UART_TYPE_SEND_BREAK                 0x06
1271 #define GB_UART_TYPE_SERIAL_STATE               0x07    /* Unsolicited data */
1272
1273 /* Represents data from AP -> Module */
1274 struct gb_uart_send_data_request {
1275         __le16  size;
1276         __u8    data[0];
1277 } __packed;
1278
1279 /* recv-data-request flags */
1280 #define GB_UART_RECV_FLAG_FRAMING               0x01    /* Framing error */
1281 #define GB_UART_RECV_FLAG_PARITY                0x02    /* Parity error */
1282 #define GB_UART_RECV_FLAG_OVERRUN               0x04    /* Overrun error */
1283 #define GB_UART_RECV_FLAG_BREAK                 0x08    /* Break */
1284
1285 /* Represents data from Module -> AP */
1286 struct gb_uart_recv_data_request {
1287         __le16  size;
1288         __u8    flags;
1289         __u8    data[0];
1290 } __packed;
1291
1292 struct gb_uart_set_line_coding_request {
1293         __le32  rate;
1294         __u8    format;
1295 #define GB_SERIAL_1_STOP_BITS                   0
1296 #define GB_SERIAL_1_5_STOP_BITS                 1
1297 #define GB_SERIAL_2_STOP_BITS                   2
1298
1299         __u8    parity;
1300 #define GB_SERIAL_NO_PARITY                     0
1301 #define GB_SERIAL_ODD_PARITY                    1
1302 #define GB_SERIAL_EVEN_PARITY                   2
1303 #define GB_SERIAL_MARK_PARITY                   3
1304 #define GB_SERIAL_SPACE_PARITY                  4
1305
1306         __u8    data_bits;
1307 } __packed;
1308
1309 /* output control lines */
1310 #define GB_UART_CTRL_DTR                        0x01
1311 #define GB_UART_CTRL_RTS                        0x02
1312
1313 struct gb_uart_set_control_line_state_request {
1314         __u8    control;
1315 } __packed;
1316
1317 struct gb_uart_set_break_request {
1318         __u8    state;
1319 } __packed;
1320
1321 /* input control lines and line errors */
1322 #define GB_UART_CTRL_DCD                        0x01
1323 #define GB_UART_CTRL_DSR                        0x02
1324 #define GB_UART_CTRL_RI                         0x04
1325
1326 struct gb_uart_serial_state_request {
1327         __u8    control;
1328 } __packed;
1329
1330 /* Loopback */
1331
1332 /* Version of the Greybus loopback protocol we support */
1333 #define GB_LOOPBACK_VERSION_MAJOR               0x00
1334 #define GB_LOOPBACK_VERSION_MINOR               0x01
1335
1336 /* Greybus loopback request types */
1337 #define GB_LOOPBACK_TYPE_PING                   0x02
1338 #define GB_LOOPBACK_TYPE_TRANSFER               0x03
1339 #define GB_LOOPBACK_TYPE_SINK                   0x04
1340
1341 /*
1342  * Loopback request/response header format should be identical
1343  * to simplify bandwidth and data movement analysis.
1344  */
1345 struct gb_loopback_transfer_request {
1346         __le32  len;
1347         __le32  reserved0;
1348         __le32  reserved1;
1349         __u8    data[0];
1350 } __packed;
1351
1352 struct gb_loopback_transfer_response {
1353         __le32  len;
1354         __le32  reserved0;
1355         __le32  reserved1;
1356         __u8    data[0];
1357 } __packed;
1358
1359 /* SDIO */
1360 /* Version of the Greybus sdio protocol we support */
1361 #define GB_SDIO_VERSION_MAJOR           0x00
1362 #define GB_SDIO_VERSION_MINOR           0x01
1363
1364 /* Greybus SDIO operation types */
1365 #define GB_SDIO_TYPE_GET_CAPABILITIES           0x02
1366 #define GB_SDIO_TYPE_SET_IOS                    0x03
1367 #define GB_SDIO_TYPE_COMMAND                    0x04
1368 #define GB_SDIO_TYPE_TRANSFER                   0x05
1369 #define GB_SDIO_TYPE_EVENT                      0x06
1370
1371 /* get caps response: request has no payload */
1372 struct gb_sdio_get_caps_response {
1373         __le32  caps;
1374 #define GB_SDIO_CAP_NONREMOVABLE        0x00000001
1375 #define GB_SDIO_CAP_4_BIT_DATA          0x00000002
1376 #define GB_SDIO_CAP_8_BIT_DATA          0x00000004
1377 #define GB_SDIO_CAP_MMC_HS              0x00000008
1378 #define GB_SDIO_CAP_SD_HS               0x00000010
1379 #define GB_SDIO_CAP_ERASE               0x00000020
1380 #define GB_SDIO_CAP_1_2V_DDR            0x00000040
1381 #define GB_SDIO_CAP_1_8V_DDR            0x00000080
1382 #define GB_SDIO_CAP_POWER_OFF_CARD      0x00000100
1383 #define GB_SDIO_CAP_UHS_SDR12           0x00000200
1384 #define GB_SDIO_CAP_UHS_SDR25           0x00000400
1385 #define GB_SDIO_CAP_UHS_SDR50           0x00000800
1386 #define GB_SDIO_CAP_UHS_SDR104          0x00001000
1387 #define GB_SDIO_CAP_UHS_DDR50           0x00002000
1388 #define GB_SDIO_CAP_DRIVER_TYPE_A       0x00004000
1389 #define GB_SDIO_CAP_DRIVER_TYPE_C       0x00008000
1390 #define GB_SDIO_CAP_DRIVER_TYPE_D       0x00010000
1391 #define GB_SDIO_CAP_HS200_1_2V          0x00020000
1392 #define GB_SDIO_CAP_HS200_1_8V          0x00040000
1393 #define GB_SDIO_CAP_HS400_1_2V          0x00080000
1394 #define GB_SDIO_CAP_HS400_1_8V          0x00100000
1395
1396         /* see possible values below at vdd */
1397         __le32 ocr;
1398         __le16 max_blk_count;
1399         __le16 max_blk_size;
1400         __le32 f_min;
1401         __le32 f_max;
1402 } __packed;
1403
1404 /* set ios request: response has no payload */
1405 struct gb_sdio_set_ios_request {
1406         __le32  clock;
1407         __le32  vdd;
1408 #define GB_SDIO_VDD_165_195     0x00000001
1409 #define GB_SDIO_VDD_20_21       0x00000002
1410 #define GB_SDIO_VDD_21_22       0x00000004
1411 #define GB_SDIO_VDD_22_23       0x00000008
1412 #define GB_SDIO_VDD_23_24       0x00000010
1413 #define GB_SDIO_VDD_24_25       0x00000020
1414 #define GB_SDIO_VDD_25_26       0x00000040
1415 #define GB_SDIO_VDD_26_27       0x00000080
1416 #define GB_SDIO_VDD_27_28       0x00000100
1417 #define GB_SDIO_VDD_28_29       0x00000200
1418 #define GB_SDIO_VDD_29_30       0x00000400
1419 #define GB_SDIO_VDD_30_31       0x00000800
1420 #define GB_SDIO_VDD_31_32       0x00001000
1421 #define GB_SDIO_VDD_32_33       0x00002000
1422 #define GB_SDIO_VDD_33_34       0x00004000
1423 #define GB_SDIO_VDD_34_35       0x00008000
1424 #define GB_SDIO_VDD_35_36       0x00010000
1425
1426         __u8    bus_mode;
1427 #define GB_SDIO_BUSMODE_OPENDRAIN       0x00
1428 #define GB_SDIO_BUSMODE_PUSHPULL        0x01
1429
1430         __u8    power_mode;
1431 #define GB_SDIO_POWER_OFF       0x00
1432 #define GB_SDIO_POWER_UP        0x01
1433 #define GB_SDIO_POWER_ON        0x02
1434 #define GB_SDIO_POWER_UNDEFINED 0x03
1435
1436         __u8    bus_width;
1437 #define GB_SDIO_BUS_WIDTH_1     0x00
1438 #define GB_SDIO_BUS_WIDTH_4     0x02
1439 #define GB_SDIO_BUS_WIDTH_8     0x03
1440
1441         __u8    timing;
1442 #define GB_SDIO_TIMING_LEGACY           0x00
1443 #define GB_SDIO_TIMING_MMC_HS           0x01
1444 #define GB_SDIO_TIMING_SD_HS            0x02
1445 #define GB_SDIO_TIMING_UHS_SDR12        0x03
1446 #define GB_SDIO_TIMING_UHS_SDR25        0x04
1447 #define GB_SDIO_TIMING_UHS_SDR50        0x05
1448 #define GB_SDIO_TIMING_UHS_SDR104       0x06
1449 #define GB_SDIO_TIMING_UHS_DDR50        0x07
1450 #define GB_SDIO_TIMING_MMC_DDR52        0x08
1451 #define GB_SDIO_TIMING_MMC_HS200        0x09
1452 #define GB_SDIO_TIMING_MMC_HS400        0x0A
1453
1454         __u8    signal_voltage;
1455 #define GB_SDIO_SIGNAL_VOLTAGE_330      0x00
1456 #define GB_SDIO_SIGNAL_VOLTAGE_180      0x01
1457 #define GB_SDIO_SIGNAL_VOLTAGE_120      0x02
1458
1459         __u8    drv_type;
1460 #define GB_SDIO_SET_DRIVER_TYPE_B       0x00
1461 #define GB_SDIO_SET_DRIVER_TYPE_A       0x01
1462 #define GB_SDIO_SET_DRIVER_TYPE_C       0x02
1463 #define GB_SDIO_SET_DRIVER_TYPE_D       0x03
1464 } __packed;
1465
1466 /* command request */
1467 struct gb_sdio_command_request {
1468         __u8    cmd;
1469         __u8    cmd_flags;
1470 #define GB_SDIO_RSP_NONE                0x00
1471 #define GB_SDIO_RSP_PRESENT             0x01
1472 #define GB_SDIO_RSP_136                 0x02
1473 #define GB_SDIO_RSP_CRC                 0x04
1474 #define GB_SDIO_RSP_BUSY                0x08
1475 #define GB_SDIO_RSP_OPCODE              0x10
1476
1477         __u8    cmd_type;
1478 #define GB_SDIO_CMD_AC          0x00
1479 #define GB_SDIO_CMD_ADTC        0x01
1480 #define GB_SDIO_CMD_BC          0x02
1481 #define GB_SDIO_CMD_BCR         0x03
1482
1483         __le32  cmd_arg;
1484         __le16  data_blocks;
1485         __le16  data_blksz;
1486 } __packed;
1487
1488 struct gb_sdio_command_response {
1489         __le32  resp[4];
1490 } __packed;
1491
1492 /* transfer request */
1493 struct gb_sdio_transfer_request {
1494         __u8    data_flags;
1495 #define GB_SDIO_DATA_WRITE      0x01
1496 #define GB_SDIO_DATA_READ       0x02
1497 #define GB_SDIO_DATA_STREAM     0x04
1498
1499         __le16  data_blocks;
1500         __le16  data_blksz;
1501         __u8    data[0];
1502 } __packed;
1503
1504 struct gb_sdio_transfer_response {
1505         __le16  data_blocks;
1506         __le16  data_blksz;
1507         __u8    data[0];
1508 } __packed;
1509
1510 /* event request: generated by module and is defined as unidirectional */
1511 struct gb_sdio_event_request {
1512         __u8    event;
1513 #define GB_SDIO_CARD_INSERTED   0x01
1514 #define GB_SDIO_CARD_REMOVED    0x02
1515 #define GB_SDIO_WP              0x04
1516 } __packed;
1517
1518 /* Camera */
1519
1520 #define GB_CAMERA_VERSION_MAJOR                 0x00
1521 #define GB_CAMERA_VERSION_MINOR                 0x01
1522
1523 /* Greybus Camera request types */
1524 #define GB_CAMERA_TYPE_CAPABILITIES             0x02
1525 #define GB_CAMERA_TYPE_CONFIGURE_STREAMS        0x03
1526 #define GB_CAMERA_TYPE_CAPTURE                  0x04
1527 #define GB_CAMERA_TYPE_FLUSH                    0x05
1528 #define GB_CAMERA_TYPE_METADATA                 0x06
1529
1530 #define GB_CAMERA_MAX_STREAMS                   4
1531 #define GB_CAMERA_MAX_SETTINGS_SIZE             8192
1532
1533 /* Greybus Camera Configure Streams request payload */
1534 struct gb_camera_stream_config_request {
1535         __le16 width;
1536         __le16 height;
1537         __le16 format;
1538         __le16 padding;
1539 } __packed;
1540
1541 struct gb_camera_configure_streams_request {
1542         __u8 num_streams;
1543         __u8 flags;
1544 #define GB_CAMERA_CONFIGURE_STREAMS_TEST_ONLY   0x01
1545         __le16 padding;
1546         struct gb_camera_stream_config_request config[0];
1547 } __packed;
1548
1549 /* Greybus Camera Configure Streams response payload */
1550 struct gb_camera_stream_config_response {
1551         __le16 width;
1552         __le16 height;
1553         __le16 format;
1554         __u8 virtual_channel;
1555         __u8 data_type[2];
1556         __u8 padding[3];
1557         __le32 max_size;
1558 } __packed;
1559
1560 struct gb_camera_configure_streams_response {
1561         __u8 num_streams;
1562         __u8 flags;
1563 #define GB_CAMERA_CONFIGURE_STREAMS_ADJUSTED    0x01
1564         __u8 num_lanes;
1565         __u8 padding;
1566         __le32 bus_freq;
1567         __le32 lines_per_second;
1568         struct gb_camera_stream_config_response config[0];
1569 } __packed;
1570
1571 /* Greybus Camera Capture request payload - response has no payload */
1572 struct gb_camera_capture_request {
1573         __le32 request_id;
1574         __u8 streams;
1575         __u8 padding;
1576         __le16 num_frames;
1577         __u8 settings[0];
1578 } __packed;
1579
1580 /* Greybus Camera Flush response payload - request has no payload */
1581 struct gb_camera_flush_response {
1582         __le32 request_id;
1583 } __packed;
1584
1585 /* Greybus Camera Metadata request payload - operation has no response */
1586 struct gb_camera_metadata_request {
1587         __le32 request_id;
1588         __le16 frame_number;
1589         __u8 stream;
1590         __u8 padding;
1591         __u8 metadata[0];
1592 } __packed;
1593
1594 /* Lights */
1595
1596 #define GB_LIGHTS_VERSION_MAJOR 0x00
1597 #define GB_LIGHTS_VERSION_MINOR 0x01
1598
1599 /* Greybus Lights request types */
1600 #define GB_LIGHTS_TYPE_GET_LIGHTS               0x02
1601 #define GB_LIGHTS_TYPE_GET_LIGHT_CONFIG         0x03
1602 #define GB_LIGHTS_TYPE_GET_CHANNEL_CONFIG       0x04
1603 #define GB_LIGHTS_TYPE_GET_CHANNEL_FLASH_CONFIG 0x05
1604 #define GB_LIGHTS_TYPE_SET_BRIGHTNESS           0x06
1605 #define GB_LIGHTS_TYPE_SET_BLINK                0x07
1606 #define GB_LIGHTS_TYPE_SET_COLOR                0x08
1607 #define GB_LIGHTS_TYPE_SET_FADE                 0x09
1608 #define GB_LIGHTS_TYPE_EVENT                    0x0A
1609 #define GB_LIGHTS_TYPE_SET_FLASH_INTENSITY      0x0B
1610 #define GB_LIGHTS_TYPE_SET_FLASH_STROBE         0x0C
1611 #define GB_LIGHTS_TYPE_SET_FLASH_TIMEOUT        0x0D
1612 #define GB_LIGHTS_TYPE_GET_FLASH_FAULT          0x0E
1613
1614 /* Greybus Light modes */
1615
1616 /*
1617  * if you add any specific mode below, update also the
1618  * GB_CHANNEL_MODE_DEFINED_RANGE value accordingly
1619  */
1620 #define GB_CHANNEL_MODE_NONE            0x00000000
1621 #define GB_CHANNEL_MODE_BATTERY         0x00000001
1622 #define GB_CHANNEL_MODE_POWER           0x00000002
1623 #define GB_CHANNEL_MODE_WIRELESS        0x00000004
1624 #define GB_CHANNEL_MODE_BLUETOOTH       0x00000008
1625 #define GB_CHANNEL_MODE_KEYBOARD        0x00000010
1626 #define GB_CHANNEL_MODE_BUTTONS         0x00000020
1627 #define GB_CHANNEL_MODE_NOTIFICATION    0x00000040
1628 #define GB_CHANNEL_MODE_ATTENTION       0x00000080
1629 #define GB_CHANNEL_MODE_FLASH           0x00000100
1630 #define GB_CHANNEL_MODE_TORCH           0x00000200
1631 #define GB_CHANNEL_MODE_INDICATOR       0x00000400
1632
1633 /* Lights Mode valid bit values */
1634 #define GB_CHANNEL_MODE_DEFINED_RANGE   0x000004FF
1635 #define GB_CHANNEL_MODE_VENDOR_RANGE    0x00F00000
1636
1637 /* Greybus Light Channels Flags */
1638 #define GB_LIGHT_CHANNEL_MULTICOLOR     0x00000001
1639 #define GB_LIGHT_CHANNEL_FADER          0x00000002
1640 #define GB_LIGHT_CHANNEL_BLINK          0x00000004
1641
1642 /* get count of lights in module */
1643 struct gb_lights_get_lights_response {
1644         __u8    lights_count;
1645 } __packed;
1646
1647 /* light config request payload */
1648 struct gb_lights_get_light_config_request {
1649         __u8    id;
1650 } __packed;
1651
1652 /* light config response payload */
1653 struct gb_lights_get_light_config_response {
1654         __u8    channel_count;
1655         __u8    name[32];
1656 } __packed;
1657
1658 /* channel config request payload */
1659 struct gb_lights_get_channel_config_request {
1660         __u8    light_id;
1661         __u8    channel_id;
1662 } __packed;
1663
1664 /* channel flash config request payload */
1665 struct gb_lights_get_channel_flash_config_request {
1666         __u8    light_id;
1667         __u8    channel_id;
1668 } __packed;
1669
1670 /* channel config response payload */
1671 struct gb_lights_get_channel_config_response {
1672         __u8    max_brightness;
1673         __le32  flags;
1674         __le32  color;
1675         __u8    color_name[32];
1676         __le32  mode;
1677         __u8    mode_name[32];
1678 } __packed;
1679
1680 /* channel flash config response payload */
1681 struct gb_lights_get_channel_flash_config_response {
1682         __le32  intensity_min_uA;
1683         __le32  intensity_max_uA;
1684         __le32  intensity_step_uA;
1685         __le32  timeout_min_us;
1686         __le32  timeout_max_us;
1687         __le32  timeout_step_us;
1688 } __packed;
1689
1690 /* blink request payload: response have no payload */
1691 struct gb_lights_blink_request {
1692         __u8    light_id;
1693         __u8    channel_id;
1694         __le16  time_on_ms;
1695         __le16  time_off_ms;
1696 } __packed;
1697
1698 /* set brightness request payload: response have no payload */
1699 struct gb_lights_set_brightness_request {
1700         __u8    light_id;
1701         __u8    channel_id;
1702         __u8    brightness;
1703 } __packed;
1704
1705 /* set color request payload: response have no payload */
1706 struct gb_lights_set_color_request {
1707         __u8    light_id;
1708         __u8    channel_id;
1709         __le32  color;
1710 } __packed;
1711
1712 /* set fade request payload: response have no payload */
1713 struct gb_lights_set_fade_request {
1714         __u8    light_id;
1715         __u8    channel_id;
1716         __u8    fade_in;
1717         __u8    fade_out;
1718 } __packed;
1719
1720 /* event request: generated by module */
1721 struct gb_lights_event_request {
1722         __u8    light_id;
1723         __u8    event;
1724 #define GB_LIGHTS_LIGHT_CONFIG          0x01
1725 } __packed;
1726
1727 /* set flash intensity request payload: response have no payload */
1728 struct gb_lights_set_flash_intensity_request {
1729         __u8    light_id;
1730         __u8    channel_id;
1731         __le32  intensity_uA;
1732 } __packed;
1733
1734 /* set flash strobe state request payload: response have no payload */
1735 struct gb_lights_set_flash_strobe_request {
1736         __u8    light_id;
1737         __u8    channel_id;
1738         __u8    state;
1739 } __packed;
1740
1741 /* set flash timeout request payload: response have no payload */
1742 struct gb_lights_set_flash_timeout_request {
1743         __u8    light_id;
1744         __u8    channel_id;
1745         __le32  timeout_us;
1746 } __packed;
1747
1748 /* get flash fault request payload */
1749 struct gb_lights_get_flash_fault_request {
1750         __u8    light_id;
1751         __u8    channel_id;
1752 } __packed;
1753
1754 /* get flash fault response payload */
1755 struct gb_lights_get_flash_fault_response {
1756         __le32  fault;
1757 #define GB_LIGHTS_FLASH_FAULT_OVER_VOLTAGE              0x00000000
1758 #define GB_LIGHTS_FLASH_FAULT_TIMEOUT                   0x00000001
1759 #define GB_LIGHTS_FLASH_FAULT_OVER_TEMPERATURE          0x00000002
1760 #define GB_LIGHTS_FLASH_FAULT_SHORT_CIRCUIT             0x00000004
1761 #define GB_LIGHTS_FLASH_FAULT_OVER_CURRENT              0x00000008
1762 #define GB_LIGHTS_FLASH_FAULT_INDICATOR                 0x00000010
1763 #define GB_LIGHTS_FLASH_FAULT_UNDER_VOLTAGE             0x00000020
1764 #define GB_LIGHTS_FLASH_FAULT_INPUT_VOLTAGE             0x00000040
1765 #define GB_LIGHTS_FLASH_FAULT_LED_OVER_TEMPERATURE      0x00000080
1766 } __packed;
1767
1768 /* Audio */
1769
1770 /* Version of the Greybus audio protocol we support */
1771 #define GB_AUDIO_VERSION_MAJOR                  0x00
1772 #define GB_AUDIO_VERSION_MINOR                  0x01
1773
1774 #define GB_AUDIO_TYPE_PROTOCOL_VERSION          0x01
1775 #define GB_AUDIO_TYPE_GET_TOPOLOGY_SIZE         0x02
1776 #define GB_AUDIO_TYPE_GET_TOPOLOGY              0x03
1777 #define GB_AUDIO_TYPE_GET_CONTROL               0x04
1778 #define GB_AUDIO_TYPE_SET_CONTROL               0x05
1779 #define GB_AUDIO_TYPE_ENABLE_WIDGET             0x06
1780 #define GB_AUDIO_TYPE_DISABLE_WIDGET            0x07
1781 #define GB_AUDIO_TYPE_GET_PCM                   0x08
1782 #define GB_AUDIO_TYPE_SET_PCM                   0x09
1783 #define GB_AUDIO_TYPE_SET_TX_DATA_SIZE          0x0a
1784 #define GB_AUDIO_TYPE_GET_TX_DELAY              0x0b
1785 #define GB_AUDIO_TYPE_ACTIVATE_TX               0x0c
1786 #define GB_AUDIO_TYPE_DEACTIVATE_TX             0x0d
1787 #define GB_AUDIO_TYPE_SET_RX_DATA_SIZE          0x0e
1788 #define GB_AUDIO_TYPE_GET_RX_DELAY              0x0f
1789 #define GB_AUDIO_TYPE_ACTIVATE_RX               0x10
1790 #define GB_AUDIO_TYPE_DEACTIVATE_RX             0x11
1791 #define GB_AUDIO_TYPE_JACK_EVENT                0x12
1792 #define GB_AUDIO_TYPE_BUTTON_EVENT              0x13
1793 #define GB_AUDIO_TYPE_STREAMING_EVENT           0x14
1794 #define GB_AUDIO_TYPE_SEND_DATA                 0x15
1795
1796 /* Module must be able to buffer 10ms of audio data, minimum */
1797 #define GB_AUDIO_SAMPLE_BUFFER_MIN_US           10000
1798
1799 #define GB_AUDIO_PCM_NAME_MAX                   32
1800 #define AUDIO_DAI_NAME_MAX                      32
1801 #define AUDIO_CONTROL_NAME_MAX                  32
1802 #define AUDIO_CTL_ELEM_NAME_MAX                 44
1803 #define AUDIO_ENUM_NAME_MAX                     64
1804 #define AUDIO_WIDGET_NAME_MAX                   32
1805
1806 /* See SNDRV_PCM_FMTBIT_* in Linux source */
1807 #define GB_AUDIO_PCM_FMT_S8                     BIT(0)
1808 #define GB_AUDIO_PCM_FMT_U8                     BIT(1)
1809 #define GB_AUDIO_PCM_FMT_S16_LE                 BIT(2)
1810 #define GB_AUDIO_PCM_FMT_S16_BE                 BIT(3)
1811 #define GB_AUDIO_PCM_FMT_U16_LE                 BIT(4)
1812 #define GB_AUDIO_PCM_FMT_U16_BE                 BIT(5)
1813 #define GB_AUDIO_PCM_FMT_S24_LE                 BIT(6)
1814 #define GB_AUDIO_PCM_FMT_S24_BE                 BIT(7)
1815 #define GB_AUDIO_PCM_FMT_U24_LE                 BIT(8)
1816 #define GB_AUDIO_PCM_FMT_U24_BE                 BIT(9)
1817 #define GB_AUDIO_PCM_FMT_S32_LE                 BIT(10)
1818 #define GB_AUDIO_PCM_FMT_S32_BE                 BIT(11)
1819 #define GB_AUDIO_PCM_FMT_U32_LE                 BIT(12)
1820 #define GB_AUDIO_PCM_FMT_U32_BE                 BIT(13)
1821
1822 /* See SNDRV_PCM_RATE_* in Linux source */
1823 #define GB_AUDIO_PCM_RATE_5512                  BIT(0)
1824 #define GB_AUDIO_PCM_RATE_8000                  BIT(1)
1825 #define GB_AUDIO_PCM_RATE_11025                 BIT(2)
1826 #define GB_AUDIO_PCM_RATE_16000                 BIT(3)
1827 #define GB_AUDIO_PCM_RATE_22050                 BIT(4)
1828 #define GB_AUDIO_PCM_RATE_32000                 BIT(5)
1829 #define GB_AUDIO_PCM_RATE_44100                 BIT(6)
1830 #define GB_AUDIO_PCM_RATE_48000                 BIT(7)
1831 #define GB_AUDIO_PCM_RATE_64000                 BIT(8)
1832 #define GB_AUDIO_PCM_RATE_88200                 BIT(9)
1833 #define GB_AUDIO_PCM_RATE_96000                 BIT(10)
1834 #define GB_AUDIO_PCM_RATE_176400                BIT(11)
1835 #define GB_AUDIO_PCM_RATE_192000                BIT(12)
1836
1837 #define GB_AUDIO_STREAM_TYPE_CAPTURE            0x1
1838 #define GB_AUDIO_STREAM_TYPE_PLAYBACK           0x2
1839
1840 #define GB_AUDIO_CTL_ELEM_ACCESS_READ           BIT(0)
1841 #define GB_AUDIO_CTL_ELEM_ACCESS_WRITE          BIT(1)
1842
1843 /* See SNDRV_CTL_ELEM_TYPE_* in Linux source */
1844 #define GB_AUDIO_CTL_ELEM_TYPE_BOOLEAN          0x01
1845 #define GB_AUDIO_CTL_ELEM_TYPE_INTEGER          0x02
1846 #define GB_AUDIO_CTL_ELEM_TYPE_ENUMERATED       0x03
1847 #define GB_AUDIO_CTL_ELEM_TYPE_INTEGER64        0x06
1848
1849 /* See SNDRV_CTL_ELEM_IFACE_* in Linux source */
1850 #define GB_AUDIO_CTL_ELEM_IFACE_CARD            0x00
1851 #define GB_AUDIO_CTL_ELEM_IFACE_HWDEP           0x01
1852 #define GB_AUDIO_CTL_ELEM_IFACE_MIXER           0x02
1853 #define GB_AUDIO_CTL_ELEM_IFACE_PCM             0x03
1854 #define GB_AUDIO_CTL_ELEM_IFACE_RAWMIDI         0x04
1855 #define GB_AUDIO_CTL_ELEM_IFACE_TIMER           0x05
1856 #define GB_AUDIO_CTL_ELEM_IFACE_SEQUENCER       0x06
1857
1858 /* SNDRV_CTL_ELEM_ACCESS_* in Linux source */
1859 #define GB_AUDIO_ACCESS_READ                    BIT(0)
1860 #define GB_AUDIO_ACCESS_WRITE                   BIT(1)
1861 #define GB_AUDIO_ACCESS_VOLATILE                BIT(2)
1862 #define GB_AUDIO_ACCESS_TIMESTAMP               BIT(3)
1863 #define GB_AUDIO_ACCESS_TLV_READ                BIT(4)
1864 #define GB_AUDIO_ACCESS_TLV_WRITE               BIT(5)
1865 #define GB_AUDIO_ACCESS_TLV_COMMAND             BIT(6)
1866 #define GB_AUDIO_ACCESS_INACTIVE                BIT(7)
1867 #define GB_AUDIO_ACCESS_LOCK                    BIT(8)
1868 #define GB_AUDIO_ACCESS_OWNER                   BIT(9)
1869
1870 /* enum snd_soc_dapm_type */
1871 #define GB_AUDIO_WIDGET_TYPE_INPUT              0x0
1872 #define GB_AUDIO_WIDGET_TYPE_OUTPUT             0x1
1873 #define GB_AUDIO_WIDGET_TYPE_MUX                0x2
1874 #define GB_AUDIO_WIDGET_TYPE_VIRT_MUX           0x3
1875 #define GB_AUDIO_WIDGET_TYPE_VALUE_MUX          0x4
1876 #define GB_AUDIO_WIDGET_TYPE_MIXER              0x5
1877 #define GB_AUDIO_WIDGET_TYPE_MIXER_NAMED_CTL    0x6
1878 #define GB_AUDIO_WIDGET_TYPE_PGA                0x7
1879 #define GB_AUDIO_WIDGET_TYPE_OUT_DRV            0x8
1880 #define GB_AUDIO_WIDGET_TYPE_ADC                0x9
1881 #define GB_AUDIO_WIDGET_TYPE_DAC                0xa
1882 #define GB_AUDIO_WIDGET_TYPE_MICBIAS            0xb
1883 #define GB_AUDIO_WIDGET_TYPE_MIC                0xc
1884 #define GB_AUDIO_WIDGET_TYPE_HP                 0xd
1885 #define GB_AUDIO_WIDGET_TYPE_SPK                0xe
1886 #define GB_AUDIO_WIDGET_TYPE_LINE               0xf
1887 #define GB_AUDIO_WIDGET_TYPE_SWITCH             0x10
1888 #define GB_AUDIO_WIDGET_TYPE_VMID               0x11
1889 #define GB_AUDIO_WIDGET_TYPE_PRE                0x12
1890 #define GB_AUDIO_WIDGET_TYPE_POST               0x13
1891 #define GB_AUDIO_WIDGET_TYPE_SUPPLY             0x14
1892 #define GB_AUDIO_WIDGET_TYPE_REGULATOR_SUPPLY   0x15
1893 #define GB_AUDIO_WIDGET_TYPE_CLOCK_SUPPLY       0x16
1894 #define GB_AUDIO_WIDGET_TYPE_AIF_IN             0x17
1895 #define GB_AUDIO_WIDGET_TYPE_AIF_OUT            0x18
1896 #define GB_AUDIO_WIDGET_TYPE_SIGGEN             0x19
1897 #define GB_AUDIO_WIDGET_TYPE_DAI_IN             0x1a
1898 #define GB_AUDIO_WIDGET_TYPE_DAI_OUT            0x1b
1899 #define GB_AUDIO_WIDGET_TYPE_DAI_LINK           0x1c
1900
1901 #define GB_AUDIO_WIDGET_STATE_DISABLED          0x01
1902 #define GB_AUDIO_WIDGET_STATE_ENAABLED          0x02
1903
1904 #define GB_AUDIO_JACK_EVENT_INSERTION           0x1
1905 #define GB_AUDIO_JACK_EVENT_REMOVAL             0x2
1906
1907 #define GB_AUDIO_BUTTON_EVENT_PRESS             0x1
1908 #define GB_AUDIO_BUTTON_EVENT_RELEASE           0x2
1909
1910 #define GB_AUDIO_STREAMING_EVENT_UNSPECIFIED    0x1
1911 #define GB_AUDIO_STREAMING_EVENT_HALT           0x2
1912 #define GB_AUDIO_STREAMING_EVENT_INTERNAL_ERROR 0x3
1913 #define GB_AUDIO_STREAMING_EVENT_PROTOCOL_ERROR 0x4
1914 #define GB_AUDIO_STREAMING_EVENT_FAILURE        0x5
1915 #define GB_AUDIO_STREAMING_EVENT_UNDERRUN       0x6
1916 #define GB_AUDIO_STREAMING_EVENT_OVERRUN        0x7
1917 #define GB_AUDIO_STREAMING_EVENT_CLOCKING       0x8
1918 #define GB_AUDIO_STREAMING_EVENT_DATA_LEN       0x9
1919
1920 #define GB_AUDIO_INVALID_INDEX                  0xff
1921
1922 struct gb_audio_pcm {
1923         __u8    stream_name[GB_AUDIO_PCM_NAME_MAX];
1924         __le32  formats;        /* GB_AUDIO_PCM_FMT_* */
1925         __le32  rates;          /* GB_AUDIO_PCM_RATE_* */
1926         __u8    chan_min;
1927         __u8    chan_max;
1928         __u8    sig_bits;       /* number of bits of content */
1929 } __packed;
1930
1931 struct gb_audio_dai {
1932         __u8                    name[AUDIO_DAI_NAME_MAX];
1933         __le16                  data_cport;
1934         struct gb_audio_pcm     capture;
1935         struct gb_audio_pcm     playback;
1936 } __packed;
1937
1938 struct gb_audio_integer {
1939         __le32  min;
1940         __le32  max;
1941         __le32  step;
1942 } __packed;
1943
1944 struct gb_audio_integer64 {
1945         __le64  min;
1946         __le64  max;
1947         __le64  step;
1948 } __packed;
1949
1950 struct gb_audio_enumerated {
1951         __le32  items;
1952         __le16  names_length;
1953         __u8    names[0];
1954 } __packed;
1955
1956 struct gb_audio_ctl_elem_info { /* See snd_ctl_elem_info in Linux source */
1957         __u8            type;           /* GB_AUDIO_CTL_ELEM_TYPE_* */
1958         __le16          dimen[4];
1959         union {
1960                 struct gb_audio_integer         integer;
1961                 struct gb_audio_integer64       integer64;
1962                 struct gb_audio_enumerated      enumerated;
1963         } value;
1964 } __packed;
1965
1966 struct gb_audio_ctl_elem_value { /* See snd_ctl_elem_value in Linux source */
1967         __le64                          timestamp; /* XXX needed? */
1968         union {
1969                 __le32  integer_value[2];       /* consider CTL_DOUBLE_xxx */
1970                 __le64  integer64_value[2];
1971                 __le32  enumerated_item[2];
1972         } value;
1973 } __packed;
1974
1975 struct gb_audio_control {
1976         __u8    name[AUDIO_CONTROL_NAME_MAX];
1977         __u8    id;             /* 0-63 */
1978         __u8    iface;          /* GB_AUDIO_IFACE_* */
1979         __le16  data_cport;
1980         __le32  access;         /* GB_AUDIO_ACCESS_* */
1981         __u8    count;          /* count of same elements */
1982         __u8    count_values;   /* count of values, max=2 for CTL_DOUBLE_xxx */
1983         struct gb_audio_ctl_elem_info   info;
1984 } __packed;
1985
1986 struct gb_audio_widget {
1987         __u8    name[AUDIO_WIDGET_NAME_MAX];
1988         __u8    sname[AUDIO_WIDGET_NAME_MAX];
1989         __u8    id;
1990         __u8    type;           /* GB_AUDIO_WIDGET_TYPE_* */
1991         __u8    state;          /* GB_AUDIO_WIDGET_STATE_* */
1992         __u8    ncontrols;
1993         struct gb_audio_control ctl[0]; /* 'ncontrols' entries */
1994 } __packed;
1995
1996 struct gb_audio_route {
1997         __u8    source_id;      /* widget id */
1998         __u8    destination_id; /* widget id */
1999         __u8    control_id;     /* 0-63 */
2000         __u8    index;          /* Selection within the control */
2001 } __packed;
2002
2003 struct gb_audio_topology {
2004         __u8    num_dais;
2005         __u8    num_controls;
2006         __u8    num_widgets;
2007         __u8    num_routes;
2008         __u32   size_dais;
2009         __u32   size_controls;
2010         __u32   size_widgets;
2011         __u32   size_routes;
2012         /*
2013          * struct gb_audio_dai          dai[num_dais];
2014          * struct gb_audio_control      controls[num_controls];
2015          * struct gb_audio_widget       widgets[num_widgets];
2016          * struct gb_audio_route        routes[num_routes];
2017          */
2018         __u8    data[0];
2019 } __packed;
2020
2021 struct gb_audio_get_topology_size_response {
2022         __le16  size;
2023 } __packed;
2024
2025 struct gb_audio_get_topology_response {
2026         struct gb_audio_topology        topology;
2027 } __packed;
2028
2029 struct gb_audio_get_control_request {
2030         __u8    control_id;
2031         __u8    index;
2032 } __packed;
2033
2034 struct gb_audio_get_control_response {
2035         struct gb_audio_ctl_elem_value  value;
2036 } __packed;
2037
2038 struct gb_audio_set_control_request {
2039         __u8    control_id;
2040         __u8    index;
2041         struct gb_audio_ctl_elem_value  value;
2042 } __packed;
2043
2044 struct gb_audio_enable_widget_request {
2045         __u8    widget_id;
2046 } __packed;
2047
2048 struct gb_audio_disable_widget_request {
2049         __u8    widget_id;
2050 } __packed;
2051
2052 struct gb_audio_get_pcm_request {
2053         __le16  data_cport;
2054 } __packed;
2055
2056 struct gb_audio_get_pcm_response {
2057         __le32  format;
2058         __le32  rate;
2059         __u8    channels;
2060         __u8    sig_bits;
2061 } __packed;
2062
2063 struct gb_audio_set_pcm_request {
2064         __le16  data_cport;
2065         __le32  format;
2066         __le32  rate;
2067         __u8    channels;
2068         __u8    sig_bits;
2069 } __packed;
2070
2071 struct gb_audio_set_tx_data_size_request {
2072         __le16  data_cport;
2073         __le16  size;
2074 } __packed;
2075
2076 struct gb_audio_get_tx_delay_request {
2077         __le16  data_cport;
2078 } __packed;
2079
2080 struct gb_audio_get_tx_delay_response {
2081         __le32  delay;
2082 } __packed;
2083
2084 struct gb_audio_activate_tx_request {
2085         __le16  data_cport;
2086 } __packed;
2087
2088 struct gb_audio_deactivate_tx_request {
2089         __le16  data_cport;
2090 } __packed;
2091
2092 struct gb_audio_set_rx_data_size_request {
2093         __le16  data_cport;
2094         __le16  size;
2095 } __packed;
2096
2097 struct gb_audio_get_rx_delay_request {
2098         __le16  data_cport;
2099 } __packed;
2100
2101 struct gb_audio_get_rx_delay_response {
2102         __le32  delay;
2103 } __packed;
2104
2105 struct gb_audio_activate_rx_request {
2106         __le16  data_cport;
2107 } __packed;
2108
2109 struct gb_audio_deactivate_rx_request {
2110         __le16  data_cport;
2111 } __packed;
2112
2113 struct gb_audio_jack_event_request {
2114         __u8    widget_id;
2115         __u8    jack_attribute;
2116         __u8    event;
2117 } __packed;
2118
2119 struct gb_audio_button_event_request {
2120         __u8    widget_id;
2121         __u8    button_id;
2122         __u8    event;
2123 } __packed;
2124
2125 struct gb_audio_streaming_event_request {
2126         __le16  data_cport;
2127         __u8    event;
2128 } __packed;
2129
2130 struct gb_audio_send_data_request {
2131         __le64  timestamp;
2132         __u8    data[0];
2133 } __packed;
2134
2135 #endif /* __GREYBUS_PROTOCOLS_H */
2136