OverviewThis page describes a USB-PD sniffing dongle with Type-C connectors. The dongle can be supported by Chrome devices as part of a USB-Type C implementation.
Hardware Capabilities
Complete schematics, layout, and enclosure are attached at the bottom of this page. Firmware Source CodeThe firmware is located In the Chromium Embedded Controller repository under board/twinkie/, the release version is on the firmware-twinkie-9628.B branch :
Building FirmwareWithin your Chromium OS chroot, the syntax is:
For the impatient, here is a very cut-down version of the detailed instructions. If anything here gives you trouble, refer to the official documentation instead. Install the prerequisite toolsgoobuntu$ sudo apt-get install git-core gitk git-gui subversion curl goobuntu$ git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git goobuntu$ export PATH=$(pwd)/depot_tools:$PATH Check out the sourcesgoobuntu$ mkdir chromiumos && cd chromiumos goobuntu$ repo init -u https://chromium.googlesource.com/chromiumos/manifest.git \ --repo-url https://chromium.googlesource.com/external/repo.git \ -g minilayout -b firmware-twinkie-9628.B goobuntu$ repo sync Enter the chrootgoobuntu$ cros_sdk Install the board-specific compiler toolchainchroot$ ./setup_board --board=falco Check out the EC sourceschroot$ cros_workon-falco start chromeos-ec chroot$ repo sync ../platform/ec Build thingschroot$ cd ../platform/ec chroot$ make BOARD=twinkie -j Alternately, you can use the pre-built firmware twinkie_v1.11.19-9e81762f2.bin attached at the bottom of this page.
Flashing FirmwareThe USB-PD dongle behaves as a USB DFU device when the ID pin is grounded on the USB micro-B connector.
This is done either by plugging an A-A USB cable into an A-to-microB OTG adapter as shown in the photo below or by typing the
dfu command on the USB console (if you already have a recent firmware, e.g. v1.11.19+).Within your Chromium OS chroot:
./util/flash_ec --board=twinkieor on Ubuntu Linux:
sudo dfu-util -a 0 -s 0x08000000 -D twinkie_v1.11.19-9e81762f2.bin if you have entered the DFU mode by using the dfu console command, you need to use the following command to exit it : sudo dfu-util -a 0 -s 0x08000000:force:unprotect -D twinkie_v1.11.19-9e81762f2.bin else plugging the regular USB cable will do it automatically.
Using the Integrated Command Line over USBThe USB-PD dongle exports its internal command-line console as a pair of USB bulk endpoints. On a Linux system, you get the console as a /dev/ttyUSBn device. On recent systems (kernel v3.19+), this ttyUSB device should be instantiated automatically, or other systems you can try using the usbserial kernel module :
echo '18d1 500A' | sudo tee /sys/bus/usb-serial/drivers/generic/new_idIf this fails, you might need to run
sudo modprobe usbserial first.Using as a PD Packet SnifferYou can use the opensource Sigrok framework to acquire and decode USB Power Delivery traces with the USB-PD dongle. You can then use Pulseview to display them. The patches for the Sigrok hardware driver for the dongle is not in the upstream packages yet. If your machine has an x86_64 processor, you can try the following experimental pre-built packages: - for Ubuntu Xenial (16.04 LTS) cd $(mktemp -d)wget https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/ubuntu-xenial/libsigrok4_0.5.0-3twinkie1_amd64.deb \ https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/ubuntu-xenial/libsigrokcxx4_0.5.0-3twinkie1_amd64.deb \ https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/ubuntu-xenial/libsigrokdecode4_0.5.0-4twinkie1_amd64.deb \ https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/ubuntu-xenial/sigrok-cli_0.7.0-2twinkie1_amd64.deb \ https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/ubuntu-xenial/pulseview_0.4.0-2twinkie1_amd64.debsudo dpkg -i *.debsudo apt-get install -f- for Debian Buster (testing) cd $(mktemp -d)wget https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/debian-buster/libsigrok4_0.5.0-3twinkie1_amd64.deb \ https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/debian-buster/libsigrokcxx4_0.5.0-3twinkie1_amd64.deb \ https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/debian-buster/libsigrokdecode4_0.5.0-4twinkie1_amd64.deb \ https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/debian-buster/sigrok-cli_0.7.0-2twinkie1_amd64.deb \ https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/debian-buster/pulseview_0.4.0-2twinkie1_amd64.debsudo dpkg -i *.debsudo apt-get install -f- for Debian Stretch (stable) cd $(mktemp -d)wget https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/debian-stretch/libsigrok4_0.5.0-3twinkie1_amd64.deb \ https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/debian-stretch/libsigrokcxx4_0.5.0-3twinkie1_amd64.deb \ https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/debian-stretch/libsigrokdecode4_0.5.0-4twinkie1_amd64.deb \ https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/debian-stretch/sigrok-cli_0.7.0-2twinkie1_amd64.deb \ https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/debian-stretch/pulseview_0.4.0-2twinkie1_amd64.deb sudo dpkg -i *.debsudo apt-get install -f- for Ubuntu Trusty (14.04 LTS), you can unpack the following binaries at the desired location on your computer and install the dependencies, e.g: wget -qO- https://storage.googleapis.com/chromeos-vpa/twinkie-20171122/ubuntu-trusty/sigrok-twinkie-0.5.0.tar.gz | tar xvzsudo apt-get install libqt5core5a libqt5widgets5 libqt5gui5 libboost-system1.55.0 libboost-filesystem1.55.0 libboost-serialization1.55.0 libglibmm-2.4 libglib2.0/path/to/your/sigrok-twinkie-0.5.0/bin/pulseview or /path/to/your/sigrok-twinkie-0.5.0/bin/sigrok-cli -d chromium-twinkie --continuous -o test.sror add them to your path, e.g export PATH="$PATH:/path/to/your/sigrok-twinkie-0.5.0/bin"If you want to do a full build from sources of sigrok and pulseview with Twinkie support, now the USB PD protocol decoder is now upstreamed in libsigrokdecode (and sigrok-cli / pulseview are working out-of-the-box). You only need to add the Chromium Twinkie hardware driver in libsigrok : last version of the patch applying on libsigrok-0.5.0 Capturing traces with the Sigrok toolsigrok-cli -d chromium-twinkie --continuous -o test.srReal-time decoding of USB PD packets while capturingsigrok-cli -d chromium-twinkie --continuous -P usb_power_delivery:cc=CC1:fulltext=yes -P usb_power_delivery:cc=CC2:fulltext=yes -A usb_power_delivery=textAdd the USB PD decoder from the Decoders menu, then edit the instantiated decoder to select the appropriate CC line.     Experimental VBUS analog tracesAs shown on the pictures above, you can try to capture the VBUS analog voltage and current along with the CCx lines traffic. This feature is still experimental and might have negative side effects on your PD packets capture ! Capturing VBUS voltage only and CCx traffic: sigrok-cli -d chromium-twinkie:analog_channels=1 --continuous -o testvbusV.srCapturing VBUS voltage and current and CCx traffic: sigrok-cli -d chromium-twinkie:analog_channels=2 --continuous -o testvbusVA.srthen you can display the .sr files in Pulseview.
Using as a Power Sink
|
Chromium OS >
