sysfs-wusb_cbaf 3.9 KB

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