Skip to main content

Setting up Pleos Connect Emulator

Pleos Connect Emulator​

The Pleos Connect Emulator allows developers to build and validate applications within a dedicated environment for Android Studio and Android IDE. It supports full-scale testing at both the Android and Pleos Connect API levels, providing the same depth of vehicle control and contextual data as the production system.

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. For earlier versions of Android Studio, select Menu > Tools > AVD Manager.

  4. Click Create device. For earlier versions of Android Studio, click Create Virtual Device.

  5. Select Automotive from the left menu.

  6. Select Pleos Connect v2.0.

  7. Click the Next button.

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

  9. Click Show Advanced Settings.

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

  11. To use the 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.
note

To change the language of the emulator, please refer to the language settings procedure.

Testing with the emulator​

[CRN injection is required]

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

  1. If you build the app without injecting the CRN, the screen CRN is not registered on the target board will appear.
  2. Create a My Project in Pleos Playground.
  3. Copy the CRN from My Project > Project Info > Test Info.
  4. Inject the CRN into the Emulator using ADB shell 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. After restarting the Emulator, you can build and run your app on the Emulator.

Troubleshooting​

The Android Emulator has several known issues, please refer to the link below. Troubleshooting Known Issues with 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