Commit | Line | Data |
---|---|---|
c8cf2465 DV |
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 | ||
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 | ||
52 | What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_chid | |
53 | Date: August 2008 | |
54 | KernelVersion: 2.6.27 | |
55 | Contact: David Vrabel <david.vrabel@csr.com> | |
56 | Description: | |
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 | ||
63 | What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_host_name | |
64 | Date: August 2008 | |
65 | KernelVersion: 2.6.27 | |
66 | Contact: David Vrabel <david.vrabel@csr.com> | |
67 | Description: | |
68 | A friendly name for the host as a UTF-8 encoded string. | |
69 | ||
70 | What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_host_band_groups | |
71 | Date: August 2008 | |
72 | KernelVersion: 2.6.27 | |
73 | Contact: David Vrabel <david.vrabel@csr.com> | |
74 | Description: | |
75 | The band groups supported by the host, in the format | |
76 | defined in [WUSB-AM]. | |
77 | ||
78 | What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_device_band_groups | |
79 | Date: August 2008 | |
80 | KernelVersion: 2.6.27 | |
81 | Contact: David Vrabel <david.vrabel@csr.com> | |
82 | Description: | |
83 | The band groups supported by the device, in the format | |
84 | defined in [WUSB-AM]. | |
85 | ||
86 | What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_cdid | |
87 | Date: August 2008 | |
88 | KernelVersion: 2.6.27 | |
89 | Contact: David Vrabel <david.vrabel@csr.com> | |
90 | Description: | |
91 | The device's CDID formatted as 16 space-separated hex | |
92 | octets. | |
93 | ||
94 | What: /sys/bus/usb/drivers/wusb_cbaf/.../wusb_ck | |
95 | Date: August 2008 | |
96 | KernelVersion: 2.6.27 | |
97 | Contact: David Vrabel <david.vrabel@csr.com> | |
98 | Description: | |
99 | Write 16 space-separated random, hex octets to | |
100 | associate with the device. |