Skip to content

RPC Library

On the managed device, a Remote Provisioning Client (RPC) communicates with the Remote Provision Server (RPS) in the process of activating or deactivating the device. In addition to activation and deactivation, the RPC provides informational and maintenance commands.

Find all RPC commands here.

Prerequisites

A GCC toolchain is required to compile RPC as a library.

Run the following command to install: 

sudo apt install build-essential

Download and Install tdm-gcc.

Build Library

go build -buildmode=c-shared -o librpc.so ./cmd 

go build -buildmode=c-shared -o rpc.dll ./cmd

Library Functions

The library contains two functions:

Function Description Usage
checkAccess Determines if RPC is being run as admin, the ME driver is installed, and AMT is available. Use this function to check for basic AMT availability conditions.
rpcExec Executes RPC commands. Use this function as you would the RPC executable, passing in arguments to activate, deactivate, perform maintenance, etc.

Sample Client in C#

Find a simple sample client in the RPC-go's dotnet folder.

Include in C#

This sample code demonstrates how to import the DLL's functions:

    //Linux-style example (.so extenstion)
    [DllImport("rpc")]
    static extern int rpcCheckAccess();

Call a Function

This sample provides an example of calling the rpcExec function to activate a device:

    //Import
    [DllImport("rpc")]
    static extern int rpcExec([In] byte[] rpccmd, ref IntPtr output);

    int returnCode;

    Console.WriteLine("... CALLING rpcCheckAccess ...");
    returnCode = rpcCheckAccess();
    Console.WriteLine("... rpcCheckAccess completed: return code[" + returnCode + "] ");
    Console.WriteLine();

    var res = "";
    foreach (var arg in args)
    {
        res += $"{arg} ";
    }

    // Example commands to be passed in
    // string res = "activate -u wss://192.168.1.96/activate -n -profile Test_Profile";
    // string res = "amtinfo";

    IntPtr output = IntPtr.Zero;
    Console.WriteLine("... CALLING rpcExec with argument string: " + res);
    returnCode = rpcExec(Encoding.ASCII.GetBytes(res), ref output);
    Console.WriteLine("... rpcExec completed: return code[" + returnCode + "] " + Marshal.PtrToStringAnsi(output));