Greg Kroah-Hartman | 7baa184 | 2015-04-07 20:27:53 +0200 | [diff] [blame] | 1 | What: /sys/bus/greybus/device/endo-XXXX |
| 2 | Date: October 2015 |
| 3 | KernelVersion: 4.XX |
| 4 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 5 | Description: |
| 6 | The "root" endo for the Greybus device tree. XXX is |
| 7 | replaced with the numeric value of the endo layout |
| 8 | scheme as documented in the ARA Module Developer Kit. |
| 9 | |
Alex Elder | b4dbf1e | 2015-05-27 11:17:50 -0500 | [diff] [blame^] | 10 | What: /sys/bus/greybus/device/endo-XXXX/Endo/id |
| 11 | Date: October 2015 |
| 12 | KernelVersion: 4.XX |
| 13 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 14 | Description: |
| 15 | The Endo ID, which is a 2-byte hexadecimal value |
| 16 | defined by the the Endo layout scheme, documented in |
| 17 | the ARA Module Developer Kit. |
| 18 | |
| 19 | What: /sys/bus/greybus/device/endo-XXXX/Endo/ap_intf_id |
| 20 | Date: October 2015 |
| 21 | KernelVersion: 4.XX |
| 22 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 23 | Description: |
| 24 | The AP interface ID, a small non-zero integer which |
| 25 | defines the position of the AP module on the Endo. |
| 26 | The interface positions are defined in the ARA |
| 27 | Module Developer Kit. |
| 28 | |
Greg Kroah-Hartman | 7baa184 | 2015-04-07 20:27:53 +0200 | [diff] [blame] | 29 | What: /sys/bus/greybus/device/endo-XXXX/SVC/serial_number |
| 30 | Date: October 2015 |
| 31 | KernelVersion: 4.XX |
| 32 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 33 | Description: |
| 34 | The serial number of the SVC device |
| 35 | |
| 36 | What: /sys/bus/greybus/device/endo-XXXX/SVC/version |
| 37 | Date: October 2015 |
| 38 | KernelVersion: 4.XX |
| 39 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 40 | Description: |
| 41 | The version number of the firmware in the SVC device. |
| 42 | |
Greg Kroah-Hartman | b0235b2 | 2015-04-07 20:28:13 +0200 | [diff] [blame] | 43 | What: /sys/bus/greybus/device/endo-XXXX/../epm |
| 44 | Date: October 2015 |
| 45 | KernelVersion: 4.XX |
| 46 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 47 | Description: |
| 48 | The EPM (Electropermanent Magnet) control file for |
| 49 | the specific module slot the file is present in. |
| 50 | Writing 1 to it turns it on, writing 0 to it turns it |
| 51 | off. Reading the value returns if it is on or off. |
| 52 | |
| 53 | What: /sys/bus/greybus/device/endo-XXXX/../power_control |
| 54 | Date: October 2015 |
| 55 | KernelVersion: 4.XX |
| 56 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 57 | Description: |
| 58 | The power control file for the specific module slot that |
| 59 | the file is present in. Writing 1 to it turns power on |
| 60 | to the module, writing 0 to it turns power off to the |
| 61 | module. Reading the value returns if it is on or off. |
| 62 | |
| 63 | What: /sys/bus/greybus/device/endo-XXXX/../present |
| 64 | Date: October 2015 |
| 65 | KernelVersion: 4.XX |
| 66 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 67 | Description: |
| 68 | The "is a module present in the slot" file for the |
| 69 | specific module slot that the file is present in. |
| 70 | This is read-only, 1 means a module is present, 0 means |
| 71 | no module is present. |
| 72 | |
Greg Kroah-Hartman | fc2a8fb | 2014-12-11 17:10:58 -0500 | [diff] [blame] | 73 | What: /sys/bus/greybus/device/.../product |
Greg Kroah-Hartman | f0b6787 | 2015-04-07 20:27:36 +0200 | [diff] [blame] | 74 | Date: October 2015 |
| 75 | KernelVersion: 4.XX |
Greg Kroah-Hartman | fc2a8fb | 2014-12-11 17:10:58 -0500 | [diff] [blame] | 76 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 77 | Description: |
| 78 | Product ID of a Greybus interface block. |
| 79 | |
| 80 | What: /sys/bus/greybus/device/.../product_string |
Greg Kroah-Hartman | f0b6787 | 2015-04-07 20:27:36 +0200 | [diff] [blame] | 81 | Date: October 2015 |
| 82 | KernelVersion: 4.XX |
Greg Kroah-Hartman | fc2a8fb | 2014-12-11 17:10:58 -0500 | [diff] [blame] | 83 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 84 | Description: |
| 85 | Product ID string of a Greybus interface block. |
| 86 | |
| 87 | What: /sys/bus/greybus/device/.../unique_id |
Greg Kroah-Hartman | f0b6787 | 2015-04-07 20:27:36 +0200 | [diff] [blame] | 88 | Date: October 2015 |
| 89 | KernelVersion: 4.XX |
Greg Kroah-Hartman | fc2a8fb | 2014-12-11 17:10:58 -0500 | [diff] [blame] | 90 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 91 | Description: |
| 92 | Unique ID of a Greybus interface block. |
| 93 | |
| 94 | What: /sys/bus/greybus/device/.../vendor |
Greg Kroah-Hartman | f0b6787 | 2015-04-07 20:27:36 +0200 | [diff] [blame] | 95 | Date: October 2015 |
| 96 | KernelVersion: 4.XX |
Greg Kroah-Hartman | fc2a8fb | 2014-12-11 17:10:58 -0500 | [diff] [blame] | 97 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 98 | Description: |
| 99 | Vendor ID of a Greybus interface block. |
| 100 | |
| 101 | What: /sys/bus/greybus/device/.../vendor_string |
Greg Kroah-Hartman | f0b6787 | 2015-04-07 20:27:36 +0200 | [diff] [blame] | 102 | Date: October 2015 |
| 103 | KernelVersion: 4.XX |
Greg Kroah-Hartman | fc2a8fb | 2014-12-11 17:10:58 -0500 | [diff] [blame] | 104 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 105 | Description: |
| 106 | Vendor ID string of a Greybus interface block. |
| 107 | |
Greg Kroah-Hartman | a500a8a | 2014-12-11 17:11:00 -0500 | [diff] [blame] | 108 | What: /sys/bus/greybus/device/.../state |
Greg Kroah-Hartman | f0b6787 | 2015-04-07 20:27:36 +0200 | [diff] [blame] | 109 | Date: October 2015 |
| 110 | KernelVersion: 4.XX |
Greg Kroah-Hartman | a500a8a | 2014-12-11 17:11:00 -0500 | [diff] [blame] | 111 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 112 | Description: |
| 113 | The current state of a Greybus connection. |
| 114 | |
| 115 | It will be one of the following values: |
| 116 | 0 - invalid |
| 117 | 1 - disabled |
| 118 | 2 - enabled |
| 119 | 3 - error |
| 120 | 4 - destroying |
| 121 | |
| 122 | What: /sys/bus/greybus/device/.../protocol_id |
Greg Kroah-Hartman | f0b6787 | 2015-04-07 20:27:36 +0200 | [diff] [blame] | 123 | Date: October 2015 |
| 124 | KernelVersion: 4.XX |
Greg Kroah-Hartman | a500a8a | 2014-12-11 17:11:00 -0500 | [diff] [blame] | 125 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 126 | Description: |
| 127 | The protocol id of a Greybus connection. |
Greg Kroah-Hartman | 640f13e | 2014-12-11 17:11:01 -0500 | [diff] [blame] | 128 | |
| 129 | What: /sys/bus/greybus/device/.../device_id |
Greg Kroah-Hartman | f0b6787 | 2015-04-07 20:27:36 +0200 | [diff] [blame] | 130 | Date: October 2015 |
| 131 | KernelVersion: 4.XX |
Greg Kroah-Hartman | 640f13e | 2014-12-11 17:11:01 -0500 | [diff] [blame] | 132 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 133 | Description: |
Greg Kroah-Hartman | 1db0a5f | 2014-12-12 17:10:17 -0500 | [diff] [blame] | 134 | The device id of a Greybus bundle. |
Greg Kroah-Hartman | 75052a5 | 2015-04-13 19:48:37 +0200 | [diff] [blame] | 135 | |
| 136 | What: /sys/bus/greybus/device/.../state |
| 137 | Date: October 2015 |
| 138 | KernelVersion: 4.XX |
| 139 | Contact: Greg Kroah-Hartman <greg@kroah.com> |
| 140 | Description: |
| 141 | A bundle has a state that is managed by the userspace |
| 142 | Endo process. This file allows that Endo to signal |
| 143 | other Android HALs that the state of the bundle has |
| 144 | changed to a specific value. When written to, any |
| 145 | process watching the file will be woken up, and the new |
| 146 | value can be read. It's a "poor-man's IPC", yes, but |
| 147 | simplifies the Android userspace code immensely. |