Gitiles
Code Review Sign In
gerrit-public.fairphone.software / device / google / cuttlefish / f6e6995d7ee8b4d6a7d03414aa85a7b3592eceba
commitf6e6995d7ee8b4d6a7d03414aa85a7b3592eceba[log] [tgz]
authorA. Cody Schuffelen <schuffelen@google.com>Thu Oct 08 13:03:38 2020 -0700
committerA. Cody Schuffelen <schuffelen@google.com>Thu Oct 08 18:23:44 2020 -0700
tree49362ca531b6e6e0d9d9c3a52651db59e19e908f
parentc7133888c76a7473923432976e3ed7911c385842 [diff]
Add a switch to use the host TPM.

Host TPM mode does not work yet, this still needs to be debugged.

Converts InProcessTpm to use the pimpl design so it can extend the Tpm
virtual class but still use offsetof in its implementation, which needs
a simple class with no vtable.

Test: Normal launch_cvd still works. -tpm_impl=host_device is broken.
Bug: 155697375
Bug: 155697615
Change-Id: I61453abdf72de6fd50546c706102b7975b8e2701
7 files changed
tree: 49362ca531b6e6e0d9d9c3a52651db59e19e908f
  1. common/
  2. guest/
  3. host/
  4. recovery/
  5. shared/
  6. tests/
  7. tools/
  8. vsoc_arm64/
  9. vsoc_arm64_only/
  10. vsoc_x86/
  11. vsoc_x86_64/
  12. vsoc_x86_64_only/
  13. vsoc_x86_noapex/
  14. vsoc_x86_only/
  15. Android.bp
  16. Android.mk
  17. AndroidProducts.mk
  18. CleanSpec.mk
  19. default-permissions.xml
  20. dtb.img
  21. fetcher.mk
  22. host_package.mk
  23. METADATA
  24. OWNERS
  25. README.md
  26. required_images
  27. TEST_MAPPING
README.md

Cuttlefish Getting Started

Try Cuttlefish

  1. Make sure virtualization with KVM is available.

     grep -c -w "vmx\|svm" /proc/cpuinfo

    This should return a non-zero value. If running on a cloud machine, this may take cloud-vendor-specific steps to enable. For Google Compute Engine specifically, see the GCE guide.

  2. Download, build, and install the host debian package:

    git clone https://github.com/google/android-cuttlefish
cd android-cuttlefish
debuild -i -us -uc -b
sudo dpkg -i ../cuttlefish-common_*_amd64.deb || sudo apt-get install -f
sudo reboot

    The reboot will trigger installing additional kernel modules and applying udev rules.

  3. Go to http://ci.android.com/

  4. Enter a branch name. Start with aosp-master if you don't know what you're looking for

  5. Navigate to aosp_cf_x86_phone and click on userdebug for the latest build

  6. Click on Artifacts

  7. Scroll down to the OTA images. These packages look like aosp_cf_x86_phone-img-xxxxxx.zip -- it will always have img in the name. Download this file

  8. Scroll down to cvd-host_package.tar.gz. You should always download a host package from the same build as your images.

  9. On your local system, combine the packages:

    mkdir cf
cd cf
tar xvf /path/to/cvd-host_package.tar.gz
unzip /path/to/aosp_cf_x86_phone-img-xxxxxx.zip

  10. Launch cuttlefish with:

$ HOME=$PWD ./bin/launch_cvd

  1. Stop cuttlefish with:

$ HOME=$PWD ./bin/stop_cvd

Debug Cuttlefish

You can use adb to debug it, just like a physical device:

$ ./bin/adb -e shell

Launch Viewer

You can use the TightVNC JViewer. Once you have downloaded the TightVNC Java Viewer JAR in a ZIP archive, run it with

$ java -jar tightvnc-jviewer.jar -ScalingFactor=50 -Tunneling=no -host=localhost -port=6444

Click "Connect" and you should see a lock screen!