diff options
author | Johan Hovold | 2015-11-22 10:24:08 +0100 |
---|---|---|
committer | Greg Kroah-Hartman | 2015-11-24 04:24:27 +0100 |
commit | f6f8aeaa35899de2180b93a0efc27a7d5b0c4ec5 (patch) | |
tree | fc6a3907f225097900f1d517012714743bc293ce /drivers/staging/greybus/Documentation | |
parent | greybus: manifest: simplify descriptor address calculation (diff) | |
download | kernel-qcow2-linux-f6f8aeaa35899de2180b93a0efc27a7d5b0c4ec5.tar.gz kernel-qcow2-linux-f6f8aeaa35899de2180b93a0efc27a7d5b0c4ec5.tar.xz kernel-qcow2-linux-f6f8aeaa35899de2180b93a0efc27a7d5b0c4ec5.zip |
greybus: Documentation/sysfs: update the example sysfs tree
Update the example sysfs-tree layout under Documentation.
The new layout reflects changes to the kernel device-model that are
needed to eventually be able to handle multiple AP-bridges.
The example tree has two AP-bridges, each with its own view of the
UniPro network, the bus.
.
├── greybus1
│ ├── 1-2
│ │ ├── 1-2.1
│ │ │ ├── class
│ │ │ ├── id
│ │ │ └── state
│ │ ├── 1-2.2
│ │ │ ├── class
│ │ │ ├── id
│ │ │ └── state
│ │ ├── id
│ │ ├── product_id
│ │ ├── unique_id
│ │ └── vendor_id
│ ├── 1-4
│ │ ├── 1-4.2
│ │ │ ├── class
│ │ │ ├── gpbridge0
│ │ │ │ ├── gpio
│ │ │ │ │ └── gpiochip490
│ │ │ │ └── i2c-4
│ │ │ ├── id
│ │ │ └── state
│ │ ├── id
│ │ ├── product_id
│ │ ├── unique_id
│ │ └── vendor_id
│ └── 1-svc
│ ├── ap_intf_id
│ ├── eject
│ ├── endo_id
│ └── unique_id
└── greybus2
├── 2-3
│ ├── 2-3.1
│ │ ├── class
│ │ ├── id
│ │ └── state
│ ├── id
│ ├── product_id
│ ├── unique_id
│ └── vendor_id
└── 2-svc
├── ap_intf_id
├── eject
├── endo_id
└── unique_id
Every bus has exactly one svc device (1-svc and 2-svc). For our system,
the svc device of each bus will be a representation of the same
network-unique SVC device (e.g. endo_id and unique_id will be
identical).
The first bus has two registered interfaces (1-2 and 1-4), while the
second bus has a single interface (2-3). Note that the interface ids (2,
4, and 3) are necessarily unique as these are interfaces on the same
network.
Interface 1-2 has two bundles (1-2.1 and 1-2.2) and interface 1-4 has
a single bundle (1-4.2). The bundle ids are interface-unique and reflect
the ids found in each manifest.
In the example, bundle 1-4.2 has a gbbridge-device, which is the parent
device for a gpiochip device and an i2c bus.
Signed-off-by: Johan Hovold <johan@hovoldconsulting.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@google.com>
Diffstat (limited to 'drivers/staging/greybus/Documentation')
36 files changed, 7 insertions, 2 deletions
diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/01/01/gpbridge00/usb/.gitignore b/drivers/staging/greybus/Documentation/sysfs/endo/01/01/01/01/gpbridge00/usb/.gitignore deleted file mode 100644 index f935021a8f8a..000000000000 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/01/01/gpbridge00/usb/.gitignore +++ /dev/null @@ -1 +0,0 @@ -!.gitignore diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/02/02/.gitignore b/drivers/staging/greybus/Documentation/sysfs/endo/02/02/.gitignore deleted file mode 100644 index f935021a8f8a..000000000000 --- a/drivers/staging/greybus/Documentation/sysfs/endo/02/02/.gitignore +++ /dev/null @@ -1 +0,0 @@ -!.gitignore diff --git a/drivers/staging/greybus/Documentation/sysfs/endo-TYPE/01/01/vendor_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/class index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo-TYPE/01/01/vendor_id +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/class diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/id new file mode 100644 index 000000000000..d00491fd7e5b --- /dev/null +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/id @@ -0,0 +1 @@ +1 diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/state b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/state index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/state +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/state diff --git a/drivers/staging/greybus/Documentation/sysfs/endo-TYPE/01/01/vendor_name b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/class index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo-TYPE/01/01/vendor_name +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/class diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/id new file mode 100644 index 000000000000..0cfbf08886fc --- /dev/null +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/id @@ -0,0 +1 @@ +2 diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/firmware b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/state index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/firmware +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/state diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/id new file mode 100644 index 000000000000..0cfbf08886fc --- /dev/null +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/id @@ -0,0 +1 @@ +2 diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/product_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/product_id index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/product_id +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/product_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/manifest b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/unique_id index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/manifest +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/unique_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/product_name b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/vendor_id index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/product_name +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/vendor_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/uid b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/class index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/uid +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/class diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/01/01/gpbridge00/gpio/.gitignore b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/gpbridge0/gpio/gpiochip490/.gitignore index f935021a8f8a..f935021a8f8a 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/01/01/gpbridge00/gpio/.gitignore +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/gpbridge0/gpio/gpiochip490/.gitignore diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/01/01/gpbridge00/i2c/.gitignore b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/gpbridge0/i2c-4/.gitignore index f935021a8f8a..f935021a8f8a 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/01/01/gpbridge00/i2c/.gitignore +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/gpbridge0/i2c-4/.gitignore diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/id new file mode 100644 index 000000000000..0cfbf08886fc --- /dev/null +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/id @@ -0,0 +1 @@ +2 diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/version_major b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/state index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/version_major +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/state diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/id new file mode 100644 index 000000000000..b8626c4cff28 --- /dev/null +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/id @@ -0,0 +1 @@ +4 diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/version_minor b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/product_id index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/version_minor +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/product_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/epm b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/unique_id index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/epm +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/unique_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/power b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/vendor_id index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/power +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/vendor_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/ap_intf_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/ap_intf_id index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/ap_intf_id +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/ap_intf_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/present b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/eject index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/present +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/eject diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/endo_id index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/id +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/endo_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/svc/svc/firmware b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/unique_id index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/svc/svc/firmware +++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/unique_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/svc/svc/serial_number b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/class index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/svc/svc/serial_number +++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/class diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/id new file mode 100644 index 000000000000..d00491fd7e5b --- /dev/null +++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/id @@ -0,0 +1 @@ +1 diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/svc/svc/version b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/state index e69de29bb2d1..e69de29bb2d1 100644 --- a/drivers/staging/greybus/Documentation/sysfs/endo/svc/svc/version +++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/state diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/id new file mode 100644 index 000000000000..00750edc07d6 --- /dev/null +++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/id @@ -0,0 +1 @@ +3 diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/product_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/product_id new file mode 100644 index 000000000000..e69de29bb2d1 --- /dev/null +++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/product_id diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/unique_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/unique_id new file mode 100644 index 000000000000..e69de29bb2d1 --- /dev/null +++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/unique_id diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/vendor_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/vendor_id new file mode 100644 index 000000000000..e69de29bb2d1 --- /dev/null +++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/vendor_id diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-svc/ap_intf_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-svc/ap_intf_id new file mode 100644 index 000000000000..e69de29bb2d1 --- /dev/null +++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-svc/ap_intf_id diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-svc/eject b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-svc/eject new file mode 100644 index 000000000000..e69de29bb2d1 --- /dev/null +++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-svc/eject diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-svc/endo_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-svc/endo_id new file mode 100644 index 000000000000..e69de29bb2d1 --- /dev/null +++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-svc/endo_id diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-svc/unique_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-svc/unique_id new file mode 100644 index 000000000000..e69de29bb2d1 --- /dev/null +++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-svc/unique_id |