Skip to content

README.md

Latest commit

 

History

History
57 lines (42 loc) · 1.88 KB

README.md

File metadata and controls

57 lines (42 loc) · 1.88 KB

Audio Visual Behaviors Example

This example shows how to add, run, and optionally delete custom audio/visual behaviors on Spot using the Boston Dynamics Python SDK. Behaviors can control the robot's LEDs and buzzer, including color, sequence type, and musical notes.

Features

  • Add or modify a custom behavior with configurable LED patterns and buzzer sequences.
  • Run an existing or custom behavior for a set duration.
  • Set system parameters like brightness and volume.
  • Supports LED sequence types: blink, pulse, solid.
  • Supports color presets (normal, warning, danger) and custom RGB values.
  • Supports musical notes, rest, and peak SPL for the buzzer.

Usage

Install dependencies:

python3 -m pip install -r requirements.txt

Run a custom behavior:

python3 audio_visual_behaviors.py ROBOT_IP

With options:

python3 audio_visual_behaviors.py \
    --max-brightness 0.8 \
    --max-buzzer-volume 0.1 \
    --led-sequence-type blink \
    --color 128,64,255 \
    --run-time 10 \
    --behavior-name custom \
    --delete \
    192.168.80.3
  • --color accepts normal, warning, danger, or a comma-separated RGB tuple.
  • --led-sequence-type accepts blink, pulse, or solid.
  • --delete removes the custom behavior after running.

Notes

  • Client-side restrictions have been implemented for the duty_cycle and intensity (via Euclidean norm of color tuple). Disrespecting these restrictions may result in damage to the robot's LEDs and damage will not be covered under warranty.
  • The example does attempt to warn the user if these conditions have been violated, prompting the user for confirmation.