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