greybus: Documentation/sysfs: add module devices

Introduce module devices and rename interface and bundle devices.

Greybus module devices correspond to physical modules and have one or
more interfaces. Modules have an id that is identical to the id of their
primary interface, which in turn is the interface with lowest numbered
id. The module name is constructed from the bus and module id:

	<bus_id>-<module_id>

Interfaces and bundles are consequently renamed as

	<bus_id>-<module_id>.<interface_id>

and

	<bus_id>-<module_id>.<interface_id>.<bundle_id>

respectively.

As before, interface ids (and therefore in a sense now also module ids)
correspond to physical interface positions on the frame.

Modules have the following attributes:

	eject
	module_id
	num_interfaces

where module_id is the id of the module and num_interface the number of
interfaces the module has.

Note that the interface ids of a module's interfaces are expected to be
<module_id>, <module_id + 1>, ..., <module_id + num_interfaces - 1>.

Writing a non-zero argument to eject cleanly shuts down and unregisters
all of the module interfaces before ejecting the module.

The example sysfs tree now looks as follows with the second bus
(APBridgeA) left out:

greybus1/
├── 1-2
│   ├── 1-2.2
│   │   ├── 1-2.2.1
│   │   │   ├── bundle_class
│   │   │   ├── bundle_id
│   │   │   └── state
│   │   ├── 1-2.2.2
│   │   │   ├── bundle_class
│   │   │   ├── bundle_id
│   │   │   └── state
│   │   ├── ddbl1_manufacturer_id
│   │   ├── ddbl1_product_id
│   │   ├── interface_id
│   │   ├── product_id
│   │   ├── serial_number
│   │   ├── unique_id
│   │   └── vendor_id
│   ├── eject
│   ├── module_id
│   └── num_interfaces
├── 1-4
│   ├── 1-4.4
│   │   ├── 1-4.4.2
│   │   │   ├── bundle_class
│   │   │   ├── bundle_id
│   │   │   ├── gpbridge0
│   │   │   │   ├── gpio
│   │   │   │   │   └── gpiochip490
│   │   │   │   └── i2c-4
│   │   │   └── state
│   │   ├── ddbl1_manufacturer_id
│   │   ├── ddbl1_product_id
│   │   ├── interface_id
│   │   ├── product_id
│   │   ├── serial_number
│   │   ├── unique_id
│   │   └── vendor_id
│   ├── eject
│   ├── module_id
│   └── num_interfaces
└── 1-svc
    ├── ap_intf_id
    ├── eject
    └── endo_id

where greybus1 is a bus; 1-svc the svc; 1-2, and 1-4 are modules; 1-2.2
and 1-4.4 are (primary) interfaces; and 1-2.2.1, 1-2.2.2, and 1-4.4.2
are bundles.

Note that the svc eject attribute may eventually be renamed force_eject.

Signed-off-by: Johan Hovold <johan@hovoldconsulting.com>
Reviewed-by: Viresh Kumar <viresh.kumar@linaro.org>
Signed-off-by: Greg Kroah-Hartman <gregkh@google.com>

44 files changed, 6 insertions, 0 deletions

diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/bundle_class b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/1-2.2.1/bundle_class
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/bundle_class
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/1-2.2.1/bundle_class
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/bundle_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/1-2.2.1/bundle_id
index d00491fd7e5b..d00491fd7e5b 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/bundle_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/1-2.2.1/bundle_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/state b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/1-2.2.1/state
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.1/state
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/1-2.2.1/state
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/bundle_class b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/1-2.2.2/bundle_class
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/bundle_class
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/1-2.2.2/bundle_class
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/bundle_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/1-2.2.2/bundle_id
index 0cfbf08886fc..0cfbf08886fc 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/bundle_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/1-2.2.2/bundle_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/state b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/1-2.2.2/state
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/state
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/1-2.2.2/state
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/ddbl1_manufacturer_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/ddbl1_manufacturer_id
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/ddbl1_manufacturer_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/ddbl1_manufacturer_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/ddbl1_product_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/ddbl1_product_id
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/ddbl1_product_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/ddbl1_product_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/interface_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/interface_id
index 0cfbf08886fc..0cfbf08886fc 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/interface_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/interface_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/product_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/product_id
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/product_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/product_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/serial_number b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/serial_number
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/serial_number
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/serial_number
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/unique_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/unique_id
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/unique_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/unique_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/vendor_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/vendor_id
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/vendor_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/1-2.2/vendor_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/bundle_class b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/eject
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/bundle_class
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/eject
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/bundle_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/module_id
index 0cfbf08886fc..0cfbf08886fc 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/bundle_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/module_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/bundle_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/num_interfaces
index d00491fd7e5b..d00491fd7e5b 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/bundle_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-2/num_interfaces
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/bundle_class b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/1-4.4.2/bundle_class
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/bundle_class
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/1-4.4.2/bundle_class
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/1-4.4.2/bundle_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/1-4.4.2/bundle_id
new file mode 100644
index 000000000000..0cfbf08886fc
--- /dev/null
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/1-4.4.2/bundle_id
@@ -0,0 +1 @@
+2
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/gpbridge0/gpio/gpiochip490/.gitignore b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/1-4.4.2/gpbridge0/gpio/gpiochip490/.gitignore
index f935021a8f8a..f935021a8f8a 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/gpbridge0/gpio/gpiochip490/.gitignore
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/1-4.4.2/gpbridge0/gpio/gpiochip490/.gitignore
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/gpbridge0/i2c-4/.gitignore b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/1-4.4.2/gpbridge0/i2c-4/.gitignore
index f935021a8f8a..f935021a8f8a 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/gpbridge0/i2c-4/.gitignore
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/1-4.4.2/gpbridge0/i2c-4/.gitignore
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/state b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/1-4.4.2/state
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.2/state
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/1-4.4.2/state
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/ddbl1_manufacturer_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/ddbl1_manufacturer_id
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/ddbl1_manufacturer_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/ddbl1_manufacturer_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/ddbl1_product_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/ddbl1_product_id
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/ddbl1_product_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/ddbl1_product_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/interface_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/interface_id
index b8626c4cff28..b8626c4cff28 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/interface_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/interface_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/product_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/product_id
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/product_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/product_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/serial_number b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/serial_number
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/serial_number
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/serial_number
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/unique_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/unique_id
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/unique_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/unique_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/vendor_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/vendor_id
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/vendor_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/1-4.4/vendor_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/state b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/eject
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.1/state
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/eject
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/module_id b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/module_id
new file mode 100644
index 000000000000..b8626c4cff28
--- /dev/null
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/module_id
@@ -0,0 +1 @@
+4
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/num_interfaces b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/num_interfaces
new file mode 100644
index 000000000000..d00491fd7e5b
--- /dev/null
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus1/1-4/num_interfaces
@@ -0,0 +1 @@
+1
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/ddbl1_manufacturer_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/2-3.3.1/bundle_class
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/ddbl1_manufacturer_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/2-3.3.1/bundle_class
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/2-3.3.1/bundle_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/2-3.3.1/bundle_id
new file mode 100644
index 000000000000..d00491fd7e5b
--- /dev/null
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/2-3.3.1/bundle_id
@@ -0,0 +1 @@
+1
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/ddbl1_product_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/2-3.3.1/state
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/ddbl1_product_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/2-3.3.1/state
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/product_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/ddbl1_manufacturer_id
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/product_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/ddbl1_manufacturer_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/serial_number b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/ddbl1_product_id
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/serial_number
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/ddbl1_product_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/interface_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/interface_id
index 00750edc07d6..00750edc07d6 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/interface_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/interface_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/unique_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/product_id
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/unique_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/product_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/vendor_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/serial_number
index e69de29bb2d1..e69de29bb2d1 100644
--- a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/vendor_id
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/serial_number
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/unique_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/unique_id
new file mode 100644
index 000000000000..e69de29bb2d1
--- /dev/null
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/unique_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/vendor_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/vendor_id
new file mode 100644
index 000000000000..e69de29bb2d1
--- /dev/null
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/2-3.3/vendor_id
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/eject b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/eject
new file mode 100644
index 000000000000..e69de29bb2d1
--- /dev/null
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/eject
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/module_id b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/module_id
new file mode 100644
index 000000000000..00750edc07d6
--- /dev/null
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/module_id
@@ -0,0 +1 @@
+3
diff --git a/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/num_interfaces b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/num_interfaces
new file mode 100644
index 000000000000..d00491fd7e5b
--- /dev/null
+++ b/drivers/staging/greybus/Documentation/sysfs/greybus2/2-3/num_interfaces
@@ -0,0 +1 @@
+1