Servo v4 is a debug device in the Servo family.
Servo v4 functions as a configurable USB hub to support developer and lab recovery features. However, it doesn‘t have any hardware debug features on its own. It must be paired with CCD (GSC’s on-board servo implementation) or Servo Micro.
Servo v4 combines the functionality of the following devices into one:
Details:
Your contact at Google should be able to provide you with Servo v4.
Stop by your local Chromestop.
The plastic case has labels HOST, DUT POWER, and uSERVO.
HOST: Servo v4 can be plugged into a host machine using a micro-B USB cable via the micro-B USB port marked HOST. This will power Servo v4 while allowing the user to control Servo v4 using servod.
DUT POWER: USB-C port labeled DUT POWER is for powering the DUT through the Servo. Servo v4 can be used to power the DUT which becomes useful for devices that use USB-C as their only charge port (tablets, phones etc.). The Type-C port can be used to plug in any Type-C charger to provide full charging capabilities as a charge through hub. If no charger is plugged, Servo v4 will act as a passive hub.
uSERVO: On the side labeled uSERVO there are two connectors.
The DUT connector (which is a captive cable: servo side is permanently connected) can be plugged into a DUT, providing the DUT access to the ethernet and blue USB port. The Type-C captive cable enables debugging of devices that have a GSC (recent Chromebooks) through CCD.
The “uServo” USB port can be used to plug a servo micro to debug DUT over the Yoshi debug header.
The following ports on the unlabeled side can be used to download data to a device:
Servo v4 has an embedded keyboard so keystrokes can be emulated on the DUT.
The servod server must be running for Servo v4 to work. Details can be found on the Servo page.
There are two variants of Servo V4: Type-A and Type-C.
Both versions use the same board and case, but have a different captive cable stuffed.
The Type-C version acts as both a USB hub and PD charger. Servo v4 can also control both CC terminations which allows it to act as a debug accessory. It should be used on systems with CCD.
The Type-A version is used with a uServo and serves as the DUT USB hub, with the uServo providing SPI and UART support.
Servo v4 had several revisions, indicated by board color. The mass production (MP) version is available from Chromestop.
Final version, has full functionality.
The DVT version is completely functional except for the one bug affecting only Type-C variant. There are about one thousand of these, so you may encounter them.
The EVT version is a mostly functioning version with a few bugs. There are around three hundred of these total.
Servo v4 runs more or less equivalently to Servo v2, through servod. It's intended to be mostly transparent, but there are some differences.
Most functionality is exported through dut-control.
(chroot) $ sudo servod -b <board> -s <serial>
To use with a specific board, you can connect a servo_micro to the “uServo” labeled port (or use the Type-C cable to connect to CCD) and run servod, which will load the board config and control both Servo v4 and Servo Micro (or GSC).
(chroot) $ sudo servod -b [board] -s [serialno printed on servo v4 sticker]
Connect to Servo v4 Console:
(chroot) $ usb_console -d 18d1:501b
Connect to Servo Micro Console:
(chroot) $ usb_console -d 18d1:501a -i 3
Connect to GSC Console:
#H1/Cr50 (chroot) $ usb_console -d 18d1:5014 # D2/Ti50 (chroot) $ watch -n 1 "lsusb | grep 18d1:504A"
(chroot) $ dut-control sd_en:on sd_pwr_en:on sd_mux_sel:servo_sees_usbkey host_sd_usb_mux_en:on host_sd_usb_mux_sel:sd
(chroot) $ dut-control sd_en:on sd_pwr_en:on sd_mux_sel:dut_sees_usbkey
(chroot) $ dut-control sd_en:off sd_pwr_en:off
(chroot) $ dut-control usb3_mux_en:on usb3_mux_sel:servo_sees_usbkey usb3_pwr_en:on host_sd_usb_mux_en:on host_sd_usb_mux_sel:usb
(chroot) $ dut-control usb3_mux_en:on usb3_mux_sel:dut_sees_usbkey usb3_pwr_en:on
(chroot) $ dut-control servo_v4_dts_mode:off [on]
$ dut-control --host XXX --port YYY
(chroot) $ dut-control servo_v4_role:snk [src]
FlashAP capability is enabled in GSC.Read and flash AP firmware (BIOS) with CCD or any other servo debug connection:
(chroot) $ sudo futility read --servo -v "$OUTFILE" (chroot) $ sudo futility update --servo -v -i "$INFILE"
The latest firmware is available in the chroot at /usr/share/servo_updater/firmware/.
If the green LED on the servo does not light up when DUT POWER is connected to a USB charger, you probably don’t have the latest firmware and should update.
servod must not be running.Sync the latest source:
(chroot) repo sync
Update sys-firmware/servo-firmware to the latest version:
(chroot) update_chroot
Update to latest stable firmware:
(chroot) $ sudo servo_updater -b servo_v4
Update to specific version:
(chroot) $ sudo servo_updater -b servo_v4 -f <filename>
See CCD for complete details.
Connect to GSC console:
(chroot) $ usb_console -d 18d1:5014
Check the GSC FW version in the GSC console:
> version Build: 0.4.10/cr50_v1.9308_B.269-754117a
CCD requires Cr50 version 0.3.9+ / 0.4.9+
Open CCD in the GSC console:
> ccd open
Press power button when prompted. It should take around 5 minutes.
ccd open, you likely do not have developer mode enabled.Enable testlab mode in the GSC console:
> ccd testlab enable
Press power button some more. CTRL+C to exit.
Run servod as normal, CCD should be enabled now.
See http://b/112187276.
Your network switch port will get hosed (some TX buffer fills up and starts dropping things) if you have Servo v4 connected to most switches and unplug the servo‘s USB connection, or power off the DUT fully, after the servo’s NIC has an IP. This behavior is not reproducible with a GS108Tv2, so the workaround is to use a GS108Tv2.
File bug or feature requests here.
Servo v4 code lives in the EC and hdctools codebase. It can be built as follows:
(chroot) $ cd ~/chromiumos/src/platform/ec (chroot) $ make BOARD=servo_v4 -j8
To raw flash a Servo v4, BOOT0 select pin is indicated by the OTG cable:
(chroot) $ ./util/flash_ec --board=servo_v4
To set the Servo v4 serial number on the Servo console:
> serialno set 012345