/riscv-android

Apache License 2.0Apache-2.0

RISC-V Android

This is the RISC-V Android collaborative source code repo. It contains all the modified AOSP(Android open source project) repositories with RISC-V support, while other non-architecture related repositories can be directly downloaded from the official AOSP repo.

Currently, the Android support for RISC-V has been merged upstream, and this repository is only used for archiving. If you need to obtain the new version AOSP on RISC-V support, please visit https://github.com/google/android-riscv64.

Getting started

Before downloading RISC-V Android source code please check you work environment, it is recommended to install a Linux system(Ubuntu 18.04 is preferred) with at least 250G disk space, 16 GB+ of RAM and more than 6 CPU cores.

To download the RISC-V Android source tree to your working directory:

mkdir ~/riscv-android-src && cd ~/riscv-android-src
repo init -u git@github.com:riscv-android-src/manifest.git -b riscv64-android-10.0.0_dev
repo sync

If you are not able to access the official AOSP repo, you may replace the download url with a mirror site:

export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo'
# Modify the .repo/manifests/default.xml
-  <!--- use tsinghua android repo as code base
   <remote  name="tsinghua"
            fetch="https://mirrors.tuna.tsinghua.edu.cn/git/AOSP"
            review="https://android-review.googlesource.com/" />
   <default revision="refs/tags/android-10.0.0_r11"
            remote="tsinghua"
            sync-j="4" />
-  -->

   <default revision="refs/tags/android-10.0.0_r11"
-           remote="aosp"
+           remote="tsinghua"
            sync-j="4" />

To see the full list of available commands, run:

hmm

Build full emulator image with command:

source build/envsetup.sh
lunch aosp_riscv64-eng
m -j

Run the RISC-V 64 AVD system image in the Android Emulator:

emulator -selinux permissive -qemu -m 3800M -bios prebuilts/qemu-kernel/riscv64/ranchu/fw_jump.bin
The options before -qemu are handled by emulator:
-debug                 enable/disable debug messages
-show-kernel           display kernel messages
-no-snapshot           perform a full boot and do not auto-save
-ports 7099,7100       TCP ports used for the console and adb bridge
The options after -qemu are handled by qemu:
-smp 2                 use multi cpu cores
-gdb tcp::2345         wait for gdb connection on tcp port 2345
Other options can refer to:
emulator -help or emulator -qemu -help

Usage of other branch may refer to: Branches and configurations

If you want to rebuild the prebuild projects，please check：Prebuilt projects

If you want to develop Android 12 on RISC-V，please check：Android 12 RISC-V guide

If you want to run the compatibility test suit, please check：CTS build guide

If you want to build applicaion for RISC-V, please check：App build guide

If you have encountered any problem with the environment setup，please check：Common faults and treatment methods

Contribute

The Github projects and pull requests are used to manage development and code review.

If you are looking for some project to start with:

  1. Check the TODO list to find if there is any submodule you are interested in.
  2. If the submodule doesn't have an owner，you can volunteer to maintain this submodule.
  3. If the submodule does have an owner, you can check the projects card board of this submodule(For example, issues for RISC-V Android for general issues).

To contribute patches:

  1. Fork the modified repository into a personal account.

  2. Create a development branch named suitably for your work.

  3. Replace the project remote and revision with your own repository:

    - <project path="bionic" name="platform-bionic" groups="pdk" remote="riscv-android" revision="riscv64-android-10.0.0_dev" />
+ <project path="bionic" name="platform-bionic" groups="pdk" remote="your_personal_remote" revision="riscv64-android-10.0.0_dev_xxx_support" />

  4. All the new work should base on the corresponding development branch.

  5. Create commits making incremental, distinct, logically complete changes with appropriate commit messages.

  6. It is better to include unit test result while add a new submodule support.

  7. Push the development branch to your personal repository fork on Github.

  8. Create a Github Pull Request targeting the the corresponding development branch. Associate the Pull Request with issue if it is an bug fix.

Recent Updates

2022/11/04

  • Support build GKI kernel/ko for andorid emulator

    • kernel-manifest: diff b25f5e46 c6e2caa9
    • kernel-common: diff 452781c1 b441c0ba
    • kernel-common-modules-virtual-device: diff aaae95d2 049223f1
    • kernel-prebuilts-5.10-riscv64: diff 55075b59 d8ff2937
    • kernel-prebuilts-common-modules-virtual-device-5.10-riscv64: new created, f0e2dfd4
    • manifest: diff 382ae35f b9486427
    • riscv-android: diff e8ba76eb 3fb76b1b

2022/10/01

  • Updated platform/manifest: diff e07293e3 382ae35f new some repos:

    • path="test/vts" name="platform-test-vts": 95fe3380
    • path="test/vts-testcase/vndk" name="platform-test-vts-testcase-vndk": 61d0146a
    • path="prebuilts/abi-dumps/ndk" name="platform-prebuilts-abi-dumps-ndk": 39a11fa4
    • path="prebuilts/abi-dumps/platform" name="platform-prebuilts-abi-dumps-platform": 0949c9a8

  • Updated after some CTS/VTS passed.

    • platform-system-extras: diff 9c319627 8b382ab4
    • platform-system-unwinding: diff 6d89de81 3533eaca
    • platform-system-core: diff 832f227e c529b5e6
    • platform-prebuilts-ndk: diff f79624980 a978e304
    • platform-frameworks-native: diff 4c6fc31e c36761ca
    • platform-frameworks-base: diff 5233a2f9 348f722a
    • platform-cts: diff bfd55aae 0c258196
    • platform-bionic: diff 1b007fc7 571ed8a0

  • Updated some prebuilt binaries

    • platform-prebuilts-clang-host-linux-x86: 967c2732
    • platform-prebuilts-android-emulator: 1a23e948
    • kernel-prebuilts-5.10-riscv64: 0fc416bd
    • platform-prebuilts-abi-dumps-vndk: fff63c58

  • Updated build system:

    • platform-build: diff fe1a0ce6 5b09e53b

  • Big update for ART:

    • platform-art: diff 925801f3 33357a36

  • Other misc:

    • platform-development: diff a6376671e 460e9483
    • platform-external-angle: diff 81253338 e4428723, add riscv64 support but has not been included in platform manifest

2022/06/23

  • Update ART support for RISC-V: Including the compiler, dex2oat, disassembler, linker, runtime support
  • Add manifest for Clang & NDK generation
  • Add basic CTS & VTS build support for RISC-V
  • Update the prebuilt clang toolchain: Fix lto, thin-lto, tidy and cfi
  • Update the multimedia support for RISC-V. Fix omx service build and sepolicy
  • Fix goldfish_address_space pci support in emulator

2022/01/18

  • Upload the riscv64-android-12.0.0_dev branch to this repo

2022/01/14

  • Add RISC-V support for Android emulator build

2021/11/03

  • Add RISC-V support for Android rust toolchain

2021/10/20

  • Upload the riscv64-android-10.0.0_dev branch to this repo

Further reading

Articles

Slides

Videos

Related links

RISC-V Android Source main page: https://github.com/riscv-android-src

RISC-V Android SIG: https://lists.riscv.org/g/sig-android

RISC-V Android SIG administrative repository: https://github.com/riscv-admin/android

Official AOSP repo: https://android.googlesource.com/

AOSP website: https://source.android.com/

RISC-V international tech wiki: https://wiki.riscv.org/display/TECH

License

We do not require any formal copyright assignment or contributor license agreement. Any contributions intentionally sent upstream are presumed to be offered under terms of the OSI-approved Apache License 2.0. See LICENSE file for details.

About Us

This repo is maintained by Android SIG(special interest group) under RISC-V international software HC.

The Android SIG(CHARTER) is aimed to coordinate efforts of developers working on the RISC-V architecture support of Android and help upstream the RISC-V support to official AOSP repo.

Please hop in and join us to the discussions. You can subscribe the mailing lists here.