Skip to main content

Setup Pleos Connect Emulator

Pleos Connect Emulator​

The Pleos Connect Emulator for Android Studio and Android IDE provides an environment to build and test user apps based on Pleos Vehicle OS. Users can test apps at both the Android and Pleos Connect API levels. The emulator provides vehicle control and context from Pleos Connect at the same level.

Installing the Pleos Connect Emulator​

Prerequisite​

  1. Install the latest version of Android Studio.
  2. Android Studio can be downloaded here.
  3. Check if you meet the system requirements to run the Android Emulator.

Adding the Emulator to Android Studio​

  1. In Android Studio, select Menu > Tools > SDK Manager.
  2. Click on the SDK Update Sites tab.
  3. Click the Add button.
  1. Enter the following information to add the Pleos Connect SDK site.
    • Name: Pleos Connect System Image
    • URL for arm64 : https://nexus-playground.pleos.ai/repository/raw-releases/release/connect.v2.0.5/connect.v2.0.5_avd_arm64/crp-arm64-sys-img.xml
    • URL for x86_64 : https://nexus-playground.pleos.ai/repository/raw-releases/release/connect.v2.0.5/connect.v2.0.5_avd_x86_64/crp-sys-img.xml

  1. Click the OK button.

  2. Click on the SDK Platforms tab.

  3. Check the Pleos Connect system Image for Android API Level 34.

  4. Also enable the checkbox for Show Package Details at the bottom.

  5. Clicking the OK button will start the download of the Pleos Connect Emulator image as shown below.

  6. Once the download is complete, press the Finish button and restart Android Studio.

Setting up the emulator​

  1. Start Android Studio. (If you did not restart Android Studio in the previous step, please restart it first.)

  2. Create an Android Virtual Device (AVD) using the Pleos Connect Emulator.

  3. In Android Studio, select Menu > Tools > Device Manager.

  4. If using an earlier version of Android Studio, select Menu > Tools > AVD Manager.

  5. Create device to click. If using an earlier version of Android Studio, click Create Virtual Device.

  6. Select Automotive from the left menu.

  7. Select Pleos Connect v2.0.

  8. Click the Next button.

  9. Select Pleos Connect v2.0 and click the Next button.

  10. Show Advanced Settings to click.

  11. In the Emulated Performance section, set the Graphics option to Hardware and select Cold boot for the Boot option.

  12. To use the on-device LLM service, set the RAM Size as follows.

Running on the emulator​

  • Run the AVD you created from Menu > Tools > Device Manager in Android Studio.

Testing with the Emulator​

[CRN Injection Required]

To run your app on the emulator, you must inject a Connected Resource Name (CRN) into the emulator.
The CRN can be obtained by creating a My Project in Pleos Playground.

  1. If you build and run the app without injecting the CRN, the following screen will appear.
  2. Go to Pleos Playground and create a My Project.
  3. In My Project > Project Info > Test Info, copy the CRN.
  4. Inject the CRN into the emulator. In the Android Studio terminal, run the following commands. Replace {CRN} with the CRN copied in step 3: 
    adb root on
    adb shell su 0 "echo 'propId: 554696961 areaId: 0 values: {CRN}' > /data/vendor/vsomeip/vhal_fifo"
    adb reboot
  5. After injecting the CRN, restart the emulator.
  6. Once the emulator restarts, you can build and run your app on it.

How to recover from infinite booting​

The Android Emulator has several known issues, please refer to the link below. Known issues in Android Emulator

There are also several known issues with Android Studio and the Gradle plugin, please refer to the link below. Known issues in Android Studio and Android Gradle plugin