From: Johan Hovold Date: Sun, 22 Nov 2015 09:24:08 +0000 (+0100) Subject: greybus: Documentation/sysfs: update the example sysfs tree X-Git-Tag: v4.9.8~1233^2~378^2~21^2~1019 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=f6f8aeaa35899de2180b93a0efc27a7d5b0c4ec5;p=platform%2Fkernel%2Flinux-rpi3.git 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 Signed-off-by: Greg Kroah-Hartman --- diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/01/01/gpbridge00/gpio/.gitignore b/drivers/staging/greybus/Documentation/sysfs/endo/01/01/01/01/gpbridge00/gpio/.gitignore deleted file mode 100644 index f935021..0000000 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/01/01/gpbridge00/gpio/.gitignore +++ /dev/null @@ -1 +0,0 @@ -!.gitignore diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/01/01/gpbridge00/i2c/.gitignore b/drivers/staging/greybus/Documentation/sysfs/endo/01/01/01/01/gpbridge00/i2c/.gitignore deleted file mode 100644 index f935021..0000000 --- a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/01/01/gpbridge00/i2c/.gitignore +++ /dev/null @@ -1 +0,0 @@ -!.gitignore diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/svc/svc/version b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/class similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/svc/svc/version rename to 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 0000000..d00491f --- /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 similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/01/01/state rename to drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/state diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/svc/svc/serial_number b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/class similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/svc/svc/serial_number rename to 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 0000000..0cfbf08 --- /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/svc/svc/firmware b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/state similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/svc/svc/firmware rename to 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 0000000..0cfbf08 --- /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 similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/01/01/product_id rename to drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/product_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/unique_id similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/id rename to drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/unique_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo-TYPE/01/01/vendor_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/vendor_id similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo-TYPE/01/01/vendor_id rename to drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/vendor_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/ap_intf_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/class similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/ap_intf_id rename to drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/class diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/02/02/.gitignore b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/gpbridge0/gpio/gpiochip490/.gitignore similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/02/02/.gitignore rename to 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/usb/.gitignore b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/gpbridge0/i2c-4/.gitignore similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/01/01/01/01/gpbridge00/usb/.gitignore rename to 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 0000000..0cfbf08 --- /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/present b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/state similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/01/present rename to 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 0000000..b8626c4 --- /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/power b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/product_id similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/01/power rename to 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 similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/01/epm rename to drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/unique_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/version_minor b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/vendor_id similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/01/01/version_minor rename to drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/vendor_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/version_major b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/ap_intf_id similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/01/01/version_major rename to drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/ap_intf_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/uid b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/eject similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/01/01/uid rename to drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/eject diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/product_name b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/endo_id similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/01/01/product_name rename to drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/endo_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/manifest b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/unique_id similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/01/01/manifest rename to drivers/staging/greybus/Documentation/sysfs/greybus1/1-svc/unique_id diff --git a/drivers/staging/greybus/Documentation/sysfs/endo/01/01/firmware b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/class similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo/01/01/firmware rename to 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 0000000..d00491f --- /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-TYPE/01/01/vendor_name b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/state similarity index 100% rename from drivers/staging/greybus/Documentation/sysfs/endo-TYPE/01/01/vendor_name rename to 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 0000000..00750ed --- /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 0000000..e69de29 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 0000000..e69de29 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 0000000..e69de29 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 0000000..e69de29 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 0000000..e69de29 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 0000000..e69de29 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 0000000..e69de29