cobalt-rdk-deploy

name	cobalt-rdk-deploy
description	Builds, deploys, runs, resets, and inspects logs for Cobalt on RDK devices using deploy_rdk.py. Use when compiling or launching Cobalt, running GTest suites, resetting active display sessions, or fetching journalctl logs from the target RDK box. Don't use for generic Linux, Android, or Raspberry Pi builds.

Cobalt RDK Deploy Skill

A skill for building, deploying, running, and debugging Cobalt on RDK devices using the deploy_rdk.py CLI script.

Quick Start

Create an alias for the deployment script:

alias deploy_rdk='python3 starboard/contrib/rdk/src/third_party/starboard/rdk/arm/scripts/deploy_rdk.py'

Execution Protocol

1. Always query --help first to inspect the available arguments and execution modes of the script:

   deploy_rdk --help
   

2. Formulate and run the command directly based on the self-documenting options. Do not guess flags or hardcode command paths.

3. Avoid manual device interaction: Do NOT run raw shell commands (via adb shell or ssh) directly on the target device to perform pre-flight checks (such as verifying device properties, OS versions, symlinks, or config status). The deploy_rdk.py script automatically manages all version checks, configuration switches, display resets, and reboots internally. Trust the script and execute your formulated command directly.

4. Identify the connection method:

   • ADB (Default): The script defaults to ADB for device interaction.
   • SSH/SCP: If you need to target a remote device over SSH, check --help for the IP-based configuration flags (e.g., --device-ip).

5. Do NOT use --no-rbe by default: Remote Build Execution (RBE) is enabled by default and must be used for compilation. Only pass the --no-rbe flag if RBE build commands fail.

6. Assume the toolchain is present: Do NOT pre-emptively check for the cross-compilation toolchain (do not run echo $RDK_HOME or list directories to verify sysroots). Assume it is fully configured and present by default. Only troubleshoot the toolchain or run --setup-toolchain if the compilation step (autoninja) fails with compiler/toolchain errors, or if the user explicitly requests it.