18c2ecf20Sopenharmony_ciWhat:           /sys/bus/usb/drivers/wusb_cbaf/.../wusb_*
28c2ecf20Sopenharmony_ciDate:           August 2008
38c2ecf20Sopenharmony_ciKernelVersion:  2.6.27
48c2ecf20Sopenharmony_ciContact:        David Vrabel <david.vrabel@csr.com>
58c2ecf20Sopenharmony_ciDescription:
68c2ecf20Sopenharmony_ci                Various files for managing Cable Based Association of
78c2ecf20Sopenharmony_ci                (wireless) USB devices.
88c2ecf20Sopenharmony_ci
98c2ecf20Sopenharmony_ci                The sequence of operations should be:
108c2ecf20Sopenharmony_ci
118c2ecf20Sopenharmony_ci                1. Device is plugged in.
128c2ecf20Sopenharmony_ci
138c2ecf20Sopenharmony_ci                2. The connection manager (CM) sees a device with CBA capability.
148c2ecf20Sopenharmony_ci                   (the wusb_chid etc. files in /sys/devices/blah/OURDEVICE).
158c2ecf20Sopenharmony_ci
168c2ecf20Sopenharmony_ci                3. The CM writes the host name, supported band groups,
178c2ecf20Sopenharmony_ci                   and the CHID (host ID) into the wusb_host_name,
188c2ecf20Sopenharmony_ci                   wusb_host_band_groups and wusb_chid files. These
198c2ecf20Sopenharmony_ci                   get sent to the device and the CDID (if any) for
208c2ecf20Sopenharmony_ci                   this host is requested.
218c2ecf20Sopenharmony_ci
228c2ecf20Sopenharmony_ci                4. The CM can verify that the device's supported band
238c2ecf20Sopenharmony_ci                   groups (wusb_device_band_groups) are compatible
248c2ecf20Sopenharmony_ci                   with the host.
258c2ecf20Sopenharmony_ci
268c2ecf20Sopenharmony_ci                5. The CM reads the wusb_cdid file.
278c2ecf20Sopenharmony_ci
288c2ecf20Sopenharmony_ci                6. The CM looks it up its database.
298c2ecf20Sopenharmony_ci
308c2ecf20Sopenharmony_ci                   - If it has a matching CHID,CDID entry, the device
318c2ecf20Sopenharmony_ci                     has been authorized before and nothing further
328c2ecf20Sopenharmony_ci                     needs to be done.
338c2ecf20Sopenharmony_ci
348c2ecf20Sopenharmony_ci                   - If the CDID is zero (or the CM doesn't find a
358c2ecf20Sopenharmony_ci                     matching CDID in its database), the device is
368c2ecf20Sopenharmony_ci                     assumed to be not known.  The CM may associate
378c2ecf20Sopenharmony_ci                     the host with device by: writing a randomly
388c2ecf20Sopenharmony_ci                     generated CDID to wusb_cdid and then a random CK
398c2ecf20Sopenharmony_ci                     to wusb_ck (this uploads the new CC to the
408c2ecf20Sopenharmony_ci                     device).
418c2ecf20Sopenharmony_ci
428c2ecf20Sopenharmony_ci                     CMD may choose to prompt the user before
438c2ecf20Sopenharmony_ci                     associating with a new device.
448c2ecf20Sopenharmony_ci
458c2ecf20Sopenharmony_ci                7. Device is unplugged.
468c2ecf20Sopenharmony_ci
478c2ecf20Sopenharmony_ci                References:
488c2ecf20Sopenharmony_ci                  [WUSB-AM]
498c2ecf20Sopenharmony_ci			    Association Models Supplement to the
508c2ecf20Sopenharmony_ci                            Certified Wireless Universal Serial Bus
518c2ecf20Sopenharmony_ci                            Specification, version 1.0.
528c2ecf20Sopenharmony_ci
538c2ecf20Sopenharmony_ciWhat:           /sys/bus/usb/drivers/wusb_cbaf/.../wusb_chid
548c2ecf20Sopenharmony_ciDate:           August 2008
558c2ecf20Sopenharmony_ciKernelVersion:  2.6.27
568c2ecf20Sopenharmony_ciContact:        David Vrabel <david.vrabel@csr.com>
578c2ecf20Sopenharmony_ciDescription:
588c2ecf20Sopenharmony_ci                The CHID of the host formatted as 16 space-separated
598c2ecf20Sopenharmony_ci                hex octets.
608c2ecf20Sopenharmony_ci
618c2ecf20Sopenharmony_ci                Writes fetches device's supported band groups and the
628c2ecf20Sopenharmony_ci                the CDID for any existing association with this host.
638c2ecf20Sopenharmony_ci
648c2ecf20Sopenharmony_ciWhat:           /sys/bus/usb/drivers/wusb_cbaf/.../wusb_host_name
658c2ecf20Sopenharmony_ciDate:           August 2008
668c2ecf20Sopenharmony_ciKernelVersion:  2.6.27
678c2ecf20Sopenharmony_ciContact:        David Vrabel <david.vrabel@csr.com>
688c2ecf20Sopenharmony_ciDescription:
698c2ecf20Sopenharmony_ci                A friendly name for the host as a UTF-8 encoded string.
708c2ecf20Sopenharmony_ci
718c2ecf20Sopenharmony_ciWhat:           /sys/bus/usb/drivers/wusb_cbaf/.../wusb_host_band_groups
728c2ecf20Sopenharmony_ciDate:           August 2008
738c2ecf20Sopenharmony_ciKernelVersion:  2.6.27
748c2ecf20Sopenharmony_ciContact:        David Vrabel <david.vrabel@csr.com>
758c2ecf20Sopenharmony_ciDescription:
768c2ecf20Sopenharmony_ci                The band groups supported by the host, in the format
778c2ecf20Sopenharmony_ci                defined in [WUSB-AM].
788c2ecf20Sopenharmony_ci
798c2ecf20Sopenharmony_ciWhat:           /sys/bus/usb/drivers/wusb_cbaf/.../wusb_device_band_groups
808c2ecf20Sopenharmony_ciDate:           August 2008
818c2ecf20Sopenharmony_ciKernelVersion:  2.6.27
828c2ecf20Sopenharmony_ciContact:        David Vrabel <david.vrabel@csr.com>
838c2ecf20Sopenharmony_ciDescription:
848c2ecf20Sopenharmony_ci                The band groups supported by the device, in the format
858c2ecf20Sopenharmony_ci                defined in [WUSB-AM].
868c2ecf20Sopenharmony_ci
878c2ecf20Sopenharmony_ciWhat:           /sys/bus/usb/drivers/wusb_cbaf/.../wusb_cdid
888c2ecf20Sopenharmony_ciDate:           August 2008
898c2ecf20Sopenharmony_ciKernelVersion:  2.6.27
908c2ecf20Sopenharmony_ciContact:        David Vrabel <david.vrabel@csr.com>
918c2ecf20Sopenharmony_ciDescription:
928c2ecf20Sopenharmony_ci                The device's CDID formatted as 16 space-separated hex
938c2ecf20Sopenharmony_ci                octets.
948c2ecf20Sopenharmony_ci
958c2ecf20Sopenharmony_ciWhat:           /sys/bus/usb/drivers/wusb_cbaf/.../wusb_ck
968c2ecf20Sopenharmony_ciDate:           August 2008
978c2ecf20Sopenharmony_ciKernelVersion:  2.6.27
988c2ecf20Sopenharmony_ciContact:        David Vrabel <david.vrabel@csr.com>
998c2ecf20Sopenharmony_ciDescription:
1008c2ecf20Sopenharmony_ci                Write 16 space-separated random, hex octets to
1018c2ecf20Sopenharmony_ci                associate with the device.
102