VL670 Development Board - USB 2.0 to 3.0 Transaction Translator.

Yifeng Li 0d519fcce0 README.md: update links to usb-b branch. 2 years ago
bom bb10062cb4 bom: update BOM 2 years ago
gerber 480b1627d9 gerber: regenerate gerber 2 years ago
library e01bd3fff8 library: add missing USB-C connector footprint 2 years ago
photos c1a164cc16 photos: add a photo, delete outdated render. 2 years ago
schematics 3451667bac vl670-layout.pdf: update layout. 2 years ago
.gitignore 5a17411204 initial commit. 3 years ago
COPYING 1487e464c0 COPYING: add CC0 license. 2 years ago
README.md 0d519fcce0 README.md: update links to usb-b branch. 2 years ago
eeprom.sch 303d35c8bb change revision number to 0.02b 2 years ago
fp-info-cache e36b2d358f usb-b edition 2 years ago
fp-lib-table 5fb0019790 First private release. 2 years ago
layout.sch 303d35c8bb change revision number to 0.02b 2 years ago
prog.sch 5a17411204 initial commit. 3 years ago
sym-lib-table 5fb0019790 First private release. 2 years ago
usb-c.sch e36b2d358f usb-b edition 2 years ago
vl670-cache.lib f54bf92b06 fix incorrect RX/TX pairs 2 years ago
vl670.bck 5fb0019790 First private release. 2 years ago
vl670.dcm f54bf92b06 fix incorrect RX/TX pairs 2 years ago
vl670.kicad_pcb ff6ca6a422 vl670.kicad_pcb: update fab layers 2 years ago
vl670.lib f54bf92b06 fix incorrect RX/TX pairs 2 years ago
vl670.net f54bf92b06 fix incorrect RX/TX pairs 2 years ago
vl670.pro c674b919d1 v0.02. 2 years ago
vl670.sch 303d35c8bb change revision number to 0.02b 2 years ago

README.md

VL670/VL671 Development Board - USB 2.0 to 3.0 Transaction Translator

Revision

This is version v0.02b (git branch usb-b), which removes the USB Type-C connector due to chip shortage.

The v0.02 design with the original USB Type-C connector is here

The original v0.01 design is obsolete, but it's still available here.

Introduction

The Problem

From a technical standpoint, USB 3.0 SuperSpeed (5 Gbps) is not an upgrade to the existing USB 2.0 High-Speed (480 Mbps) standard, instead, USB 3.0 is a completely new system of its own, which operates independently from USB 2.0. Both the physical and protocol layer have major differences. Backward compatibility is only maintained by mandating all USB 3.0 devices to include a separate set of legacy USB 2.0 controllers, transceivers, and wirings.

Because a USB 3.0 port is really a USB 3.0 and USB 2.0 port slapped together, it creates some limitations.

  • Bandwidth: You may want to simutaneously access multiple USB 2.0 devices, such as many USB flash drives, video cameras, or Software Defined Radios (SDR) over a single USB 3.0 port using a USB hub, since it has 5 Gbps bandwidth. However, you cannot do this - the total bandwidth of all USB 2.0 devices is still limited to 480 Mbps, just like a regular USB 2.0 port.

  • Signal Extension and Isolation: Counter-intuitively, it's easier to transmit USB 3.0 signals (not USB 2.0 High-Speed) over long distances, or to galvanically isolate them. Its physical layer is actually simpler than USB 2.0 - it uses two pairs of unidirectional, 8b/10b encoded, differential signals. This type of signal is commonly found in almost all high-speed digital systems, many standard hardware interfaces and transceivers exist. On the other hand, USB 2.0 signaling is its own design, its half-duplex nature further complicates the implementation. Thus, in some non-standard custom systems, only a USB 3.0 link is physically available.

For home and office users, both limitations may not be a problem, but for hardware developers and experimenters who work with custom systems, this can be problematic.

VL670/VL671 Transaction Translator

The VL670/671 is a specialized ASIC developed by VIA Labs, Inc., it's a USB 2.0 to USB 3.0 transaction translator, in other words, it translates the legacy USB 2.0 traffic and transparently upgrades the device to an USB 3.0 SuperSpeed device by emulation, enabling a legacy USB 2.0 device to make use of USB 3.0. By transparently upgrading a legacy USB 2.0 device to an emulated USB 3.0 device, both problems are eliminated.

This is not a perfect solution, first, it's technically a violation of the USB standards, also device compatibility is limited. Nevertheless, it's still helpful to hardware developers and can solve many practical problems in hardware Research and Development.

This technology is marketed as "SuperTT" (Super Transaction Translator) by some OEM vendors.

My Project

Due to the specialized nature of the VL670/VL671 ASIC, it's almost unheard of by most developers.

This project is an effort to create a free and open source hardware design of a development board for the VL670/VL671 ASIC, to facilitate hardware evaluation and experiments by other community developers, hopefully to help solving your USB problems in your custom systems.

This development board is intended solely for hardware or software developers for use in a research and development setting to facilitate evaluation, experimentation, or technical analysis. It's not designed for consumer use, and it also should not be used as a part or subassembly in any finished product.

Generations

VL670 is already obsolete. The second generation is VL671. This development board supports both VL670 and VL671, and the use of VL671 is strongly recommended (though not without its own problems).

Both chips are highly compatibile, the only modification needed is a single LED output. If VL670 is used, solder resistor R9, otherwise, solder resistor R13.

Usage

LED Status

D2
  • On: A USB 2.0 device has just connected and its traffic is being translated to USB 3.0 traffic by VL67x (VL670 only, not on VL671: or the processor is being held in reset by the SPI header).

  • Off: A USB 3.0 or 2.0 device is connected and its traffic is passing through VL670 as-is without any translation.

  • Blink: Initial power-on reset, or a USB 2.0 device has just connected (VL670 only, not on VL671).

D20
  • On: The power rail +5V_SW for downstream USB-A port is switched on. Normally, this LED should be always on.

  • Off: The power rail +5V_SW for downstream USB-A port is switched off. This indicates the power supply circuit is malfunctional. First, check the 5V input, and whether the downstream USB port has a short circuit. Then, check the USB power switch chip U4 and pull-down resistor R15.

Voltage Level

All I/O are 3.3 V LVCMOS. Applying 5 V TTL level can damage the VL670, its SPI flash, or both.

Before reading or writing to the Flash via SPI, the 5V power must also be applied via the USB cable or the pin header. Attempting to program the SPI Flash with an external programming without applying 5V power can damage components.

SPI header

An SPI pin header is located at the top right of the board. By default, it's connected directly to both the VL670 controller and its SPI Flash, allowing one to probe the SPI bus while the controller is running. In this default mode, applying voltages to the SPI header is prohibited, otherwise damage may occur.

To read or write the Flash via SPI, the /EN (a.k.a ISP_ENABLE) pin of the pin header is grounded (by bridging pin 6 and 7 on the pin header), the processor is cut off from the SPI bus and held in reset, giving the SPI pin header exclusive access to the Flash.

For more information, see Theory of Operation, section SPI Debugging and Programming and schematics.

GPIO header

All GPIO pin header is located at the top left of the board, exposing all GPIOs of VL67x. Nevertheless, their functionality is unclear and it's only useful for reverse engineering.

For more information, see Theory of Operation, section Oddities and schematics.

Known Issues

Limitations

  1. If the USB-C cable is inserted very slowly, USB 3.0 fails, only USB 2.0 is detected, thus forcing the chip to enter USB 2.0 passthrough mode. This is working by design and it's not a bug, however, it may cause misleading or confusing behaviors, thus, R1 and R2 are removed by default, forcing VL67x to always work in transaction translator mode.

  2. In VL670, USB 3.0 passthrough is not reliable and it's not compatible with some devices, this is a VL670 limitation. In VL671, USB 3.0 passthrough is almost completely broken due to firmware limitation, the only compatible device is a USB 3 Hub, direct attachment of a USB 3 device is not compatible. Also, because the USB 3 signal path is doubled in passthrough mode, any cable longer than 50 centimeters may cause enumeration failures. Thus, USB 3.0 passthrough mode should be avoided. If you want to test a combo USB 2/3 device, I recommend using a pure USB 2.0 hub to completely isolate the USB 3 signals.

    • If you ever need to test USB 3.0 passthrough mode, you should always use a short USB-C cable, no longer than 50 centimeters to minimize signal loss. The ideal setup for USB 3 passthrough testing is: Host, 50 centimeter USB cable, VL671, very short USB cable, USB 3 Hub, device. Failure to follow it to cause enumeration and other failures. For USB 2 transaction mode, no special precaution is needed.

    • A hybrid VL670 w/ USB hub topology can be used to work around the problem, it's briefly in the next section of the document. USB redrivers and retimers can also solve the hardware problem (but not the firmware bug). Since USB 3 passthrough is already broken enough and adding either solution makes the project more complicated, I choose not to do it.

  3. The upstream and downstream USB ports have no common-mode chokes for the signals. Electromagnetic compatibility performance is limited. This is an intentional decision, since adding them reduces the USB 3 link budget needed for the already problematic USB 3 passthrough mode.

  4. Not all devices are supported by the transaction translator. Sometimes the incompatibility is a hardware or protocol limitation, other times it can be a driver problem - many drivers make certain assumptions of the USB device, which may no longer be true after the device is emulated by VL670 as a SuperSpeed device.

    • USB Attached SCSI (UAS) doesn't work in transaction translator mode. But it can be disabled at the device driver of the operating system.

Photos

Front and Back of the PCB

Front and Back of the PCB

Schematics

BOM

Datasheets

Datasheets for all components on the development board can be found at GitLab.

It contains the following documents.

Firmware

The firmware for the SPI Flash can be found at GitLab. Both VL670 and VL671 firmware files are included.

Non-Free

Unfortunately, VL670/671 is driven by a microcontroller and requires a proprietary firmware to operate.

Nevertheless, the firmware is burned into the Flash memory only once after the device is assembled, and it's fetched by the VL670 ASIC itself, not uploaded from a user's host computer, nor it executes any code on a user's host computer or operating system. If we make the firmware read-only and unmodifiable by pure software, the firmware effectively "vanishes" from the software domain and becomes a part of the hardware itself, making the hardware qualifies as free device, just like how OpenMoko did it. Another benefit is improved security, as malicious software is unable to reprogram the firmware via USB to launch a BadUSB attack.

This is implemented as jumper JP1, once the jumper is hardwired on the board, the Flash is read-only and cannot be modified by software without hardware modifications.

That being said, this is a somewhat "underhanded" way to bypass the free software and hardware requirements and this behavior stays exactly at the borderline of the definition of "free", just moving one more nanometer away makes it non-free. This is hardly satisfactory! But this is all we have at the current moment.

Reverse Engineering

The long term solution is reverse engineering the firmware and writing a free and open reimplementation. This also enables us to customize the firmware for our needs, fixing bugs in the firmware, and understanding the behavior of the hardware better.

But before you start, note that VL670 is already obsolete, its internal microcontroller uses an Xtensa core. Its replacement, VL671, uses a different core (ARM Cortex M3) and a different firmware.

I suggest leaving the proprietary VL670 firmware as-is since its architecture is less known and the chip is already obsolete. Instead, work on the VL671 firmware instead.

Theory of Operation

Overview

The heart of the development board is the VL67x controller (U2). It has two USB interfaces on both sides of the chip. The left side is the host side, connnected to a computer via a USB 3.0 Type-B port (J2), the right side is connected to the device side, via a USB 3.0 Type-A port. All the transaction translation magic is performed internally by VL67x.

When a USB Type-B cable is plugged into the development board, 5 V power is applied to the board by the host, the decoupling capacitors on the 5 V rail starts charging up. Shortly after the 5 V rail settles, the internal power converters inside the VL67x controller (U2) are activated. They are a 3.3 V LDO, a 1.5 V DC/DC, and a 1.2 V LDO converter, generating the three power rails for VL670 (on VL671, the 1.5 V & 1.2 V is merged into a single 1.2 V DC/DC converter), the SPI Flash (U6), and the SPI multiplexers (U3 and U5).

When 3.3 V is ready, the VL67x controller (U2) leaves the power-on reset state, timed by the RC circuit R4 and C13, and the processor core inside VL67x starts operating. VL67x fetches firmware code from the Flash chip GD25D05 (U6) via the SPI bus.

At this point, VL67x gains access to both USB 3.0 and USB 2.0 signals at the host side, from the USB Type-B connector.

Strictly speaking, only the USB 3.0 signals are required since VL67x is a transaction translator that converts all USB 2.0 traffic to USB 3.0 transparently. The USB 2.0 differential pair at the host side is only for compatibility - if one plugs the board into a USB 2.0 port, VL67x disables transaction and enters USB 2.0 passthrough mode. Because this fallback behavior can confuse the developer (e.g. for example, if the USB 3.0 cable is defective and the chip always enters USB 2.0 passthrough mode), optional jumpers, R1 and R2, are installed on the the USB 2.0 signal lines. USB 2.0 is disconnected completely when the resistors are removed to simulate a nonstandard, pure USB 3.0 host port without USB 2.0 connection.

Once the firmware in VL67x decides that it's ready, /DN_PWREN (pin 37) outputs a logical 0, enabling power switch TPS2061C (U4) to provide 5 V power (called +5V_SW, for "switched 5 V") to the downstream, device-side USB port (J4). TPS2061C also provides soft-start and short-circuit protection. At this point, VL67x is ready to accept a USB device.

At the device side, DN_D-, DN_D+, DN_USB3RX-, DN_USB3RX+, DN_USB3TX-, DN_USB3TX+ are connected to a USB Type-A port.

When a USB device is plugged in to the USB-A connector (J4)...

  • If it's a USB 2.0 device and if USB 3.0 is available at the host side, the USB 2.0 traffic is translated to USB 3.0 traffic by VL67x. The host should detect a USB 3.0 SuperSpeed device. The translation is transparent, VL67x itself is invisible to the host, only the device is.

  • If only USB 2.0 is available at the host, VL67x enters USB 2.0 passthrough mode for all USB 2.0 or USB 3.0 devices, without translation. The host should detect a USB 2.0 device. This mode is also entered if the USB 3.0 at the host side has failed. A defective cable is a common cause, but inserting the USB cable extremely slowly has the same effect. Removing R1 and R2 to disable USB 2.0 at the host completely can avoid this confusing situation.

  • If both the host and device support USB 3.0, VL67x enters passthrough mode without translation.

SPI Debugging and Programming

An SPI pin header (J3) is provided at the top right of the board. The header is directly connected to the signal lines between the VL67x controller and the GD25D05 (U6) SPI Flash, allowing one to attach a logic analyzer to monitor the bus while the controller is running.

To allow a developer to read or write the Flash via SPI directly without a potentially destructive bus contention, VL67x's SPI bus is gated by two 74LVC2G66 CMOS analog switches (U3 and U5). When the /EN (a.k.a ISP_ENABLE) pin of the pin header is grounded (by bridging pin 6 and 7 on the pin header), the processor is cut off from the SPI bus, giving the SPI pin header exclusive access to the Flash. The /EN signal is also directly connected to the /RESET signal of VL67x to halt the processor.

External Power

A power pin header (J5) is provided. However, it should never be used to power the development board when the USB Type-B port is plugged in, otherwise a short circuit may occur. If debugging the board with external power is desirable, cut the trace at PCB jumper JP2 with a knife.

The jumper is located at the back side of the board. There are two jumpers, so make sure you're cutting JP2. Use a multimeter to confirm the connection is truly broken.

Once JP2 is cut, the USB Type-B port no longer provides power to the development board. Signals and ground connections remain.

Oddities

Due to OEM firmware differences, some pins do different things than what they were intended to do. These differences were obtained via hardware reverse engineering.

GPIO
  • GPIO1_3 / DN_PWREN is meant to be an /ENABLE signal to the downstream USB port, but it seems to be high-impedance and unused by the firmware. Thus, the USB power switch U2 is optional and can be removed. Its only purpose is short circuit protection.
USB 3 Passthrough

The reverse-engineered hardware uses a slightly different topology - VL67x is attached to an upstream USB 3.0 hub as a subdevice, and only USB 2.0 signals are wired to the downstream VL670, the USB 3.0 signals are directly wired to the upstream hub. This can be understood as an attempt to improve compatibility. In my tests, I found the USB 3.0 passthrough offered by VL670 is not always reliable and some devices cannot be used, and on VL671 it's essentially broken due to firmware limitations. Furthur, because the USB 3 signal path is doubled in passthrough mode, it completely breaks the USB link budget, any cable longer than 50 centimeters may cause enumeration failures.

Thus, passthrough mode should be avoided. Wiring the USB 3.0 signal directly to the host via a USB 3.0 hub is beneficial.

For simplicity, this is not implemented on this development board. But it's necessary for a finished product.

VL670 GPIO
  • GPIO1_2 / GPIO_TP3 is officially unused, but the OEM firmware uses it as an input for deciding whether to enable VL670. On this development board, this pin is pulled down by a resistor, otherwise the USB connection would reset randomly.

On the reverse-engineered hardware, the downstream hub /ENABLE seems to be Wired-Or together with DN_PWREN output, the ENABLE pin output from the upstream USB Hub (to allow both chips to make a ENABLE decision?), and the input GPIO1_2. It appears to be a workaround to allow the use of aforementioned hybrid topology.

  • GPIO1_0 / GPIO_TP1 is officially unused, but the OEM hardware connects it to the USB hub's (not VL670's own) private SPI bus, between the hub and its SPI firmware Flash, monitoring the MISO signal. On this development board, this pin is pulled down by a resistor. Although it seems to work without one, but leaving the input in a known state is still desirable as we don't really understand its purpose.

Again, a odd design, and I suspect the firmware is using it as an interrupt signal to detect whether the USB hub is active for logic sequencing or synchronization in this hybrid VL670 w/ hub topology.

  • GPIO3_0 / STATUS is meant to be the LED indicator output, but the firmware uses GPIO1_1/GPIO_TP2 instead.

  • UART_RX and UART_TX - no traffic observed. More hacking required.

Power Distribution Network

Overview

The Power Distribution Network is decoupled using the standard method of "one capacitor per pin, all capacitors have the same value."

The 1.5 V rail and 1.2 V rail are decoupled using 1 uF capacitors, all 0603-sized, nothing unusual (but do note C44 is the output capacitor of the DC/DC converter).

The 3.3 V rail uses multiple (20+) 470 nF capacitors and deserves more attention: C31-C35 are meant for power supply decoupling, and are 0603-sized. C71-C82 however, serve double duties, they are placed near vias to provide a continuous AC return path for signals travelling between layers ("plane stitching"), thus are 0402-sized to fit in the tight space near vias. Due to the higher number of capacitors for plane stitching, smaller 470 nF capacitors are used to keep the total capacitance per rail under 10 uF to prevent inrush current.

USB Inrush Current

The 5 V rail requires special care, it's directly attached to the USB power input, thus will produce a huge inrush current, which should stay within the USB spec limits. Basically, the rules of the USB spec is:

  1. Inrush current less than 100 mA is always acceptable, it's only considered as an inrush event when 100 mA is exceeded.

  2. If an inrush event occurs, the maximal charge transfered, calculating by area under the current curve, should be less than 50 uC. For 5 V, it means the equivalent capacitance should be less than 10 uF. Only charge is limited, not inrush current itself, because the goal is to avoid draining the output capacitance at the upstream by too much, the absolute current is irrelevant (of course, unless it's low enough to apply rule No.1).

  3. If two inrush events are separated by 100+ us, they are considered as two separate events. Only the "biggest" inrush event is considered, all other events are ignored. Thus, it's possible to get more capacitance allowance by delayed startup.

Measurements showed that the only significant inrush current of this development board is caused by capacitors at 5 V rail, other power rails produces almost no inrush current, presumably, the LDO and DC/DC's startup is "soft" enough. Moreover, the current capacitance on 5 V rail is rather conservative, only 5 uF, due to the delayed (100 us+) startup of +5V_SW rail, the total capacitance allowed on the +5 V rail is effectively doubled, up to 20 uF (effectively 10 uF due to ceramic capacitance loss under DC bias, giving us some extra headroom).

Ferrite Resonance and Damping

A ferrite choke, FB1, is used in series of the 5 V input at the USB port to filter high-frequency noise. However, its series inductance, when combined with parallel capacitance, forms a parallel LC circuit on the 5V rail. This creates a huge impedance spike at the resonance frequency. If this frequency is excited by noise, it create a huge noise voltage. To reduce its impact, two small 0.5-ohm resistors are connected in series with the ceramic capacitors, C19 and C20.

Capacitor Value Selection

Finally, it should be noted that a 0.1 uF capacitor is traditionally seen as a "high-frequency capacitor" and is the prefered choice for power decoupling, and is often blindly combined with 1 uF capacitors to "cover both high and low frequencies." However, many recent books by domain experts have pointed out that this practice is counterproductive. First, blindly mixing capacitor values can create anti-resonance impedance peaks and actually make the decoupling worse at some frequencies. Second, considering that this rule of thumb originated from the through-hole era, meanwhile the parasitic inductance of modern SMD ceramic capacitors is so low, they all have fairly good high-frequency performance regardless of their values, their effectiveness is mainly limited by package size and PCB inductance. Thus, the modern, updated guideline is to use the same capacitance everythere. That being said, there are still important uses and benefits for mixing different capacitance, but only if careful calculation and simulation is performed to predict and control the anti-resonance peaks - which is overkill for this board.

For the argument against multiple capacitor values, see Electromagnetic Compatibility Engineering by Henry Ott, Chapter 11 Digital Circuit Power Distribution, Section 11.4.1 Multiple Decoupling Capacitors. And for the argument for multiple capacitor values, but with careful design and simulation, see Principles of Power Integrity for PDN Design by Larry D. Smith and Eric Bogatin, Chapter 8 The PDN Ecology, Section 8.17 Using Three Different Values of MLCC Capacitors on the Board.

P.S: Smith & Bogatin's conclusions are terrifying, I'll just pretend that I don't know that...

PCB Stack-up

This is a 4-layer PCB, using the Signal-Ground-Power-Signal stack-up with impedance controlled traces, and fabricated by JLCPCB's JLC2313 stack-up. The dielectric constant of the board is 4.05, the distance between the signal and its reference plane is 0.1 mm.

JLC2313 is selected for its closer distance between the signal and its reference plane in comparison to JLC7628, which allows thinner traces and reduced crosstalk.

License

Copyright (C) 2021 Tom Li (niconiconi) "No Rights Reserved"

This is a free hardware design: to the extent possible under law, the designer has waived all copyright and related or neighboring rights, you can reuse, modify, redistribute this design, as freely as possible in any form whatsoever and for any purposes, including commercial purposes, under the terms of the CC0 1.0 Universal License.

This hardware design is offered as-is and the designer makes no representations or warranties of any kind concerning the design, express, implied, statutory or otherwise, including without limitation warranties of title, merchantability, fitness for a particular purpose, non infringement, or the absence of latent or other defects, accuracy, or the present or absence of errors, whether or not discoverable, all to the greatest extent permissible under applicable law.

See the CC0 1.0 Universal License for more details.

You should have received a copy of the CC0 1.0 Universal License along with this hardware design. If not, see https://creativecommons.org/publicdomain/zero/1.0/legalcode