0001 What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_*
0002 Date: August 2008
0003 KernelVersion: 2.6.27
0004 Contact: David Vrabel <david.vrabel@csr.com>
0005 Description:
0006 Various files for managing Cable Based Association of
0007 (wireless) USB devices.
0008
0009 The sequence of operations should be:
0010
0011 1. Device is plugged in.
0012
0013 2. The connection manager (CM) sees a device with CBA capability.
0014 (the wusb_chid etc. files in /sys/devices/blah/OURDEVICE).
0015
0016 3. The CM writes the host name, supported band groups,
0017 and the CHID (host ID) into the wusb_host_name,
0018 wusb_host_band_groups and wusb_chid files. These
0019 get sent to the device and the CDID (if any) for
0020 this host is requested.
0021
0022 4. The CM can verify that the device's supported band
0023 groups (wusb_device_band_groups) are compatible
0024 with the host.
0025
0026 5. The CM reads the wusb_cdid file.
0027
0028 6. The CM looks it up its database.
0029
0030 - If it has a matching CHID,CDID entry, the device
0031 has been authorized before and nothing further
0032 needs to be done.
0033
0034 - If the CDID is zero (or the CM doesn't find a
0035 matching CDID in its database), the device is
0036 assumed to be not known. The CM may associate
0037 the host with device by: writing a randomly
0038 generated CDID to wusb_cdid and then a random CK
0039 to wusb_ck (this uploads the new CC to the
0040 device).
0041
0042 CMD may choose to prompt the user before
0043 associating with a new device.
0044
0045 7. Device is unplugged.
0046
0047 References:
0048 [WUSB-AM]
0049 Association Models Supplement to the
0050 Certified Wireless Universal Serial Bus
0051 Specification, version 1.0.
0052
0053 What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_chid
0054 Date: August 2008
0055 KernelVersion: 2.6.27
0056 Contact: David Vrabel <david.vrabel@csr.com>
0057 Description:
0058 The CHID of the host formatted as 16 space-separated
0059 hex octets.
0060
0061 Writes fetches device's supported band groups and the
0062 the CDID for any existing association with this host.
0063
0064 What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_host_name
0065 Date: August 2008
0066 KernelVersion: 2.6.27
0067 Contact: David Vrabel <david.vrabel@csr.com>
0068 Description:
0069 A friendly name for the host as a UTF-8 encoded string.
0070
0071 What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_host_band_groups
0072 Date: August 2008
0073 KernelVersion: 2.6.27
0074 Contact: David Vrabel <david.vrabel@csr.com>
0075 Description:
0076 The band groups supported by the host, in the format
0077 defined in [WUSB-AM].
0078
0079 What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_device_band_groups
0080 Date: August 2008
0081 KernelVersion: 2.6.27
0082 Contact: David Vrabel <david.vrabel@csr.com>
0083 Description:
0084 The band groups supported by the device, in the format
0085 defined in [WUSB-AM].
0086
0087 What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_cdid
0088 Date: August 2008
0089 KernelVersion: 2.6.27
0090 Contact: David Vrabel <david.vrabel@csr.com>
0091 Description:
0092 The device's CDID formatted as 16 space-separated hex
0093 octets.
0094
0095 What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_ck
0096 Date: August 2008
0097 KernelVersion: 2.6.27
0098 Contact: David Vrabel <david.vrabel@csr.com>
0099 Description:
0100 Write 16 space-separated random, hex octets to
0101 associate with the device.
