Rigol VS5202D
The Rigol VS5202D is a 2 channel analog and 16 channel digital, 200 MHz, USB-based oscilloscope/logic analyzer.
The device is discontinued by Rigol, but you can find the basic specs e.g. here.
See Rigol VS5202D/Info for some more details (such as lsusb -vvv output) on the device.
More information will come in due time.
Components
TODO.
Protocol
Work in progress.
The Rigol communication protocol only uses the USB control and bulk transfer. Control is for sending setup and request smaller amounts of data. Bulk transfers is returned by the Rigol box with setup and image data.
All control transfers interesting for us has request type set to 0xc0. The request field in the control packets is what tells us which command is actually sent.
All descriptions below should have both request type and request set to proper values, obvious from the headlines what it should be.
Packet types
This information is completely reverse engineered by hand.
Read answer (request = 0x00)
Commands ending with a question mark ('?' ASCII 0x3f) returns answer in two control transfers.
First control transfer is to query the size of the data to be returned. That is done by value set to 0. One byte of data is returned in the data field by this operation which is the size of the string the Rigol box wants to return.
Second control transfer has value set to 1. The buffer, allocated to the size just read, is also sent along the command to be filled with the data. The returned data is an ASCII string.
Write command (request = 0x01)
Commands from the PC program to the Rigol box is sent as text strings. Which commands that are available are listed in the Programming Guide from Rigol.
Each character is sent in a control message with the value set to the ASCII character to be sent. Each ASCII string is terminated with a carriage return (0x0d, '\r'), which terminates the transmission.
Request waveform data (Request = 0x04)
When waveform data is requested to be retrived a control message is sent. The index field of the setup data is a bitmask on which channels to be requested. It is encoded as bit 0 meaning Channel 1, bit 1 meaning Channel 2, bit 2 meaning Logic Channel 0, bit 3 meaning Logic Channel 1 etc.
The 4 byte data field of the control packet sent back as an ack contains number of bytes to be returned by bulk messages. It is encoded LSB first.
After that a series of bulk transfers occurs, with up to 4096 bytes in each transfer, until number of bytes given before is transferred.
Unknown control packet (Request = 0x05)
This control transfer is unknown, but it occurs when stop ha been pressed and streaming of big bulk blocks is terminated. All encoding in the control transfers are as described by request 0x04 above. The index field is always zero. Seems like some kind of 'flush buffers' command.
Request 780 byte data (Request = 0x06)
After this control transfer a bulk transfers occurs with 780 bytes of data. What each byte means is still to be determined, but will occur in a separate description.
Request 260 byte data (Request = 0x0c)
After this control transfer a bulk transfers occurs with 260 bytes of data. What each byte means is still to be determined, but will occur in a separate description.
Request 396 byte data (Request = 0x0d)
After this control transfer a bulk transfers occurs with 396 bytes of data. What each byte means is still to be determined, but will occur in a separate description.
Transfer sequences
Turn-on sequence
Turn-off sequence
Start reading waveform data
Stop reading waveform data
Command sequences
Data blocks
260 bytes block
396 bytes block
780 bytes block
The image information bulk transfer
TODO,
Note: This wiki page is licensed under the terms of the CC-BY-SA 3.0 license.