From: Stefan Brüns Date: Tue, 13 Oct 2015 00:29:43 +0000 (+0200) Subject: usb_reset_and_setup_lowspeed: USB lowspeed mouse plugin and setup X-Git-Url: https://sigrok.org/gitaction?a=commitdiff_plain;h=d3d48bb0945eeeebe23e4b167277007f75df442b;p=sigrok-dumps.git usb_reset_and_setup_lowspeed: USB lowspeed mouse plugin and setup Signed-off-by: Stefan Brüns --- diff --git a/usb/setup/README b/usb/setup/README new file mode 100644 index 0000000..321968d --- /dev/null +++ b/usb/setup/README @@ -0,0 +1,83 @@ +------------------------------------------------------------------------------- +USB device setup (low-speed signalling) +------------------------------------------------------------------------------- + +This is an example capture of USB a plugin and setup sequence. + +Plugin and reset signaling (trace walktrough) +--------------------------------------------- + +The logic analyzer is connected to the D+ and D- signals of the device. As the +device ground is not connected to the LA ground, the signal level at the start +of the trace is arbitrary. + +When the cable is plugged in, DM and DP are pulled down by the host side 15k +pull-down resistors. Next, the power supply level of the device rises and +the 1.5k pull-up resistor signals the connection of a low speed device. + +The host waits for 100ms, according to the attach debounce interval [USB 2.0 +spec, Table 7-14, T_ATTDB] for the connection and device power to become +stable. At 240ms the host signals a reset (SE) condition for 50ms [USB 2.0 +spec, 7.1.7.5, T_DRSTR]. + +After the reset, the host issues keep-alives every 1ms (SE0 for 2 bit times), +to allow the device to recover. 10ms are required, but the Linux kernel waits +at least 100ms. + +At this time, the host knows the port is enabled and the device is in the +DEFAULT state, e.g. it responds to control requests at address 0. It is now +possible to request the Device Descriptor. + +At 398ms, the GET_DEVICE_DESCRIPTOR request is the first condition decoded by +the usb_signalling and stacked protocol decoders. After this request, the +max packet size for the control endpoint is known. + +After the request, some buggy devices may be in a bad state (1), thus there +is a second reset/device recovery cycle. + +There follows a sequence of SET_ADDRESS(13) and more GET_DESCRIPTOR requests. +After the setup, the polling of the INTERRUPT endpoint (EP1) starts. + +--- +(1) The stack requests 64 bytes of device descriptor because otherwise some +devices may return more than requested. Other devices can not cope with this +request, and thus a reset is needed. If all devices where compliant, a request +of just 8 bytes should return the wanted bMaxPacketSize of the device. + + +Decoding in PulseView +--------------------- + +Add a usb_signalling decoder. Set the signalling to "low-speed", next assign +DP to "D+" and DM to "D-". The usb_packet and usb_request PDs can be stacked +on top. + +Creating a PCAP (Wireshark) capture +----------------------------------- + +1. Convert the trace with sigrok-cli. + + $ sigrok-cli -i usb_reset_and_setup_lowspeed.sr \ + -P usb_signalling:dp=DP:dm=DM:signalling=low-speed,usb_packet,usb_request \ + -B usb_request > usb_reset_and_setup_lowspeed.pcap + +2. View with tshark (wireshark command line tool). + + $ tshark -r usb_reset_and_setup_lowspeed.pcap + 1 0.000000 host -> 0.0 USB 64 GET DESCRIPTOR Request DEVICE + 2 0.002258 0.0 -> host USB 82 GET DESCRIPTOR Response DEVICE + 3 0.154975 host -> 0.0 USB 64 SET ADDRESS Request + 4 0.155441 0.0 -> host USB 64 SET ADDRESS Response + 5 0.165960 host -> 13.0 USB 64 GET DESCRIPTOR Request DEVICE + 6 0.168258 13.0 -> host USB 82 GET DESCRIPTOR Response DEVICE + 7 0.168287 host -> 13.0 USB 64 GET DESCRIPTOR Request CONFIGURATION + 8 0.169757 13.0 -> host USB 73 GET DESCRIPTOR Response CONFIGURATION + 9 0.169781 host -> 13.0 USB 64 GET DESCRIPTOR Request CONFIGURATION + 10 0.173834 13.0 -> host USB 98 GET DESCRIPTOR Response CONFIGURATION + 11 0.174505 host -> 13.0 USB 64 SET CONFIGURATION Request + 12 0.175061 13.0 -> host USB 64 SET CONFIGURATION Response + 13 0.175116 host -> 13.0 USBHID 64 SET_IDLE Request + 14 0.175506 13.0 -> host USB 64 URB_CONTROL out + 15 0.175694 host -> 13.0 USB 64 GET DESCRIPTOR Request Unknown type 34 + 16 0.181389 13.0 -> host USB 116 GET DESCRIPTOR Response Unknown type 34 + 17 0.200694 host -> 13.1 USB 64 URB_BULK in diff --git a/usb/setup/usb_reset_and_setup_lowspeed.pcap b/usb/setup/usb_reset_and_setup_lowspeed.pcap new file mode 100644 index 0000000..16089a9 Binary files /dev/null and b/usb/setup/usb_reset_and_setup_lowspeed.pcap differ diff --git a/usb/setup/usb_reset_and_setup_lowspeed.sr b/usb/setup/usb_reset_and_setup_lowspeed.sr new file mode 100644 index 0000000..a185731 Binary files /dev/null and b/usb/setup/usb_reset_and_setup_lowspeed.sr differ