A Remote Procedure Call (RPC) allows a computer program calling a procedure to execute in another remote processor, while hiding the details of the remote interaction. FastRPC is the RPC mechanism used to enable remote function calls between the CPU and DSP.
Customers with algorithms that benefit from being executed on the DSP can use the FastRPC framework to offload large processing tasks onto the DSP. The DSP can then leverage its internal processing resources, such as HVX, to execute the tasks in a more compute- and power-efficient way than the CPU.
FastRPC interfaces are defined in an IDL file, and they are compiled using the QAIC compiler to generate header files and stub and skel code. The header files and stub should be built and linked into the CPU executable while the header files and skel should be built and linked into the DSP library.
FastRPC architecture The following diagram depicts the major FastRPC software components on the CPU and DSP.
Stub and skel are generated by IDL compiler. Other modules are part of the software stack on device.
Definition of the terms in the diagram:
The FastRPC framework consists of the following components.
Except fastRPC framework, user is responsible for other modules.
Workflow:
- The CPU process calls the stub version of the function. The stub code converts the function call to an RPC message.
- The stub code internally invokes the FastRPC framework on the CPU to queue the converted message.
- The FastRPC framework on the CPU sends the queued message to the FastRPC DSP framework on the DSP.
- The FastRPC DSP framework on the DSP dispatches the call to the relevant skeleton code.
- The skeleton code un-marshals the parameters and calls the method implementation.
- The skeleton code waits for the implementation to finish processing, and, in turn, marshals the return value and any other output arguments into the return message.
- The skeleton code calls the FastRPC DSP framework to queue the return message to be transmitted to the CPU.
- The FastRPC DSP framework on the DSP sends the return message back to the FastRPC framework on the CPU.
- The FastRPC framework identifies the waiting stub code and dispatches the return value.
- The stub code un-marshals the return message and sends it to the calling User mode process.
Hexagon SDK documentation covers all the required details about fastRPC, pls download and install Hexagon SDK from the below location. https://developer.qualcomm.com/software/hexagon-dsp-sdk
###Steps to generate native binaries on device
git clone https://github.com/quic/fastrpc
cd fastrpc
./gitcompile
sudo make install
###Steps to generate ARM binaries using Linaro toolchain on Ubuntu build machine
Install Linaro tools and add the tools bin location to the path.
wget -c https://releases.linaro.org/components/toolchain/binaries/latest-7/aarch64-linux-gnu/gcc-linaro-7.5.0-2019.12-i686_aarch64-linux-gnu.tar.xz
tar xf gcc-linaro-7.5.0-2019.12-i686_aarch64-linux-gnu.tar.xz
export PATH="$PATH:<linaro tools path>/toolchain/bin"
Create softlink files for the compiler, linker and other tools. Create environment variables as below for the auto tools.
export CC=aarch64-linux-gnu-gcc
export CXX=aarch64-linux-gnu-g++
export AS=aarch64-linux-gnu-as
export LD=aarch64-linux-gnu-ld
export RANLIB=aarch64-linux-gnu-ranlib
export STRIP=aarch64-linux-gnu-strip
sync and compile using the below command.
git clone https://github.com/quic/fastrpc
cd fastrpc
./gitcompile --host=aarch64-linux-gnu
###Steps to generate Android binaries on Ubuntu build machine
Download Android NDK from https://developer.android.com/ndk/downloads/index.html, and setup the ANDROID_NDK_HOME environment variable as mentioned. Add the tools bin location to the path.
export ANDROID_NDK_HOME="/usr/home/android_ndk"
export PATH="$PATH:$ANDROID_NDK_HOME/toolchain/bin"
Create softlink files for the compiler, linker and other tools. Create environment variables as below for the auto tools.
export CC=aarch64-linux-android34-clang
export CXX=aarch64-linux-android34-clang++
export AS=llvm-as
export LD=ld
export RANLIB=llvm-ranlib
export STRIP=llvm-strip
sync and compile using the below command.
git clone https://github.com/quic/fastrpc
cd fastrpc
./gitcompile --host=aarch64-linux-android
Use Hexagon SDK examples to verify. for eg: run calculator_walkthrough.py for validating the basic functionality of fastRPC.
Hexagon SDK documentation @ https://developer.qualcomm.com/software/hexagon-dsp-sdk. Linaro documentation @ https://git.codelinaro.org/linaro/qcomlt/fastrpc/-/wikis/Testing-FastRPC.
Thanks for your interest in contributing to FastRPC! Please read our Contributions Page for more information on contributing features or bug fixes. We look forward to your participation!
fastRPC is licensed under the BSD 3-clause "New" or "Revised" License. Check out the LICENSE for more details.
