Edit

Base Remote Control service API

The base remote control service API allows you to get a list of inputs from the controller that are being monitored for that control mode.

The SLAM service supports the following methods:

Method Name	Description
`ControllerInputs`	Get a list of inputs from the controller that are being monitored for that control mode.
`Reconfigure`	Reconfigure this resource.
`DoCommand`	Execute model-specific commands that are not otherwise defined by the service API.
`Close`	Close out of all remote control related systems.

Establish a connection

To get started using Viam’s SDKs to connect to and control your machine, go to your machine’s page on the Viam app, navigate to the CONNECT tab’s Code sample page, select your preferred programming language, and copy the sample code.

To show your machine’s API key in the sample code, toggle Include API key.

Caution: Keep your API key and machine address safe

We strongly recommend that you add your API key and machine address as an environment variable. Anyone with these secrets can access your machine, and the computer running your machine.

When executed, this sample code creates a connection to your machine as a client.

import (
  "go.viam.com/rdk/services/baseremotecontrol"
)

API

ControllerInputs

Get a list of inputs from the controller that are being monitored for that control mode.

Parameters:

None.

Returns:

([]input.Control): A list of inputs from the controller that are being monitored for that control mode.

Example:

// Get the list of inputs from the controller that are being monitored for that control mode.
inputs := baseRCService.ControllerInputs()

For more information, see the Go SDK Docs.

Reconfigure

Reconfigure this resource. Reconfigure must reconfigure the resource atomically and in place.

Parameters:

ctx (Context): A Context carries a deadline, a cancellation signal, and other values across API boundaries.
deps (Dependencies): The resource dependencies.
conf (Config): The resource configuration.

Returns:

(error): An error, if one occurred.

For more information, see the Go SDK Docs.

DoCommand

Execute model-specific commands that are not otherwise defined by the service API. For built-in service models, any model-specific commands available are covered with each model’s documentation. If you are implementing your own base remote control service and add features that have no built-in API method, you can access them with DoCommand.

Parameters:

ctx (Context): A Context carries a deadline, a cancellation signal, and other values across API boundaries.
cmd (map[string]interface{}): The command to execute.

Returns:

(map[string]interface{}): The command response.
(error): An error, if one occurred.

Example:

myBaseRemoteControlSvc, err := baseremotecontrol.FromRobot(machine, "my_base_remote_control_svc")

command := map[string]interface{}{"cmd": "test", "data1": 500}
result, err := myBaseRemoteControlSvc.DoCommand(context.Background(), command)

For more information, see the Go SDK Docs.

Close

Close out of all remote control related systems.

Parameters:

ctx (Context): A Context carries a deadline, a cancellation signal, and other values across API boundaries.

Returns:

(error): An error, if one occurred.

Example:

baseRCService, err := baseremotecontrol.FromRobot(machine, "my_baseRCService_svc")

err := baseRCService.Close(context.Background())

For more information, see the Go SDK Docs.

Was this page helpful?

Glad to hear it! If you have any other feedback please let us know:

We're sorry about that. To help us improve, please tell us what we can do better:

Thank you!