1What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_* 2Date: August 2008 3KernelVersion: 2.6.27 4Contact: David Vrabel <david.vrabel@csr.com> 5Description: 6 Various files for managing Cable Based Association of 7 (wireless) USB devices. 8 9 The sequence of operations should be: 10 11 1. Device is plugged in. 12 13 2. The connection manager (CM) sees a device with CBA capability. 14 (the wusb_chid etc. files in /sys/devices/blah/OURDEVICE). 15 16 3. The CM writes the host name, supported band groups, 17 and the CHID (host ID) into the wusb_host_name, 18 wusb_host_band_groups and wusb_chid files. These 19 get sent to the device and the CDID (if any) for 20 this host is requested. 21 22 4. The CM can verify that the device's supported band 23 groups (wusb_device_band_groups) are compatible 24 with the host. 25 26 5. The CM reads the wusb_cdid file. 27 28 6. The CM looks it up its database. 29 30 - If it has a matching CHID,CDID entry, the device 31 has been authorized before and nothing further 32 needs to be done. 33 34 - If the CDID is zero (or the CM doesn't find a 35 matching CDID in its database), the device is 36 assumed to be not known. The CM may associate 37 the host with device by: writing a randomly 38 generated CDID to wusb_cdid and then a random CK 39 to wusb_ck (this uploads the new CC to the 40 device). 41 42 CMD may choose to prompt the user before 43 associating with a new device. 44 45 7. Device is unplugged. 46 47 References: 48 [WUSB-AM] Association Models Supplement to the 49 Certified Wireless Universal Serial Bus 50 Specification, version 1.0. 51 52What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_chid 53Date: August 2008 54KernelVersion: 2.6.27 55Contact: David Vrabel <david.vrabel@csr.com> 56Description: 57 The CHID of the host formatted as 16 space-separated 58 hex octets. 59 60 Writes fetches device's supported band groups and the 61 the CDID for any existing association with this host. 62 63What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_host_name 64Date: August 2008 65KernelVersion: 2.6.27 66Contact: David Vrabel <david.vrabel@csr.com> 67Description: 68 A friendly name for the host as a UTF-8 encoded string. 69 70What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_host_band_groups 71Date: August 2008 72KernelVersion: 2.6.27 73Contact: David Vrabel <david.vrabel@csr.com> 74Description: 75 The band groups supported by the host, in the format 76 defined in [WUSB-AM]. 77 78What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_device_band_groups 79Date: August 2008 80KernelVersion: 2.6.27 81Contact: David Vrabel <david.vrabel@csr.com> 82Description: 83 The band groups supported by the device, in the format 84 defined in [WUSB-AM]. 85 86What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_cdid 87Date: August 2008 88KernelVersion: 2.6.27 89Contact: David Vrabel <david.vrabel@csr.com> 90Description: 91 The device's CDID formatted as 16 space-separated hex 92 octets. 93 94What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_ck 95Date: August 2008 96KernelVersion: 2.6.27 97Contact: David Vrabel <david.vrabel@csr.com> 98Description: 99 Write 16 space-separated random, hex octets to 100 associate with the device. 101