# Getting Started

## 1) Load Software onto the Teensy

1. Download the .hex file containing the vocalizer software:
   * R2-D2: <https://humancyborgrelations.com/r2d2/>
   * Astromech: <https://humancyborgrelations.com/astromech/>
2. Download the Teensy Loader:
   * Mac: <https://www.pjrc.com/teensy/teensy.dmg>
   * Windows: <https://www.pjrc.com/teensy/teensy.exe>
   * Linux 32 bit: <https://www.pjrc.com/teensy/teensy_linux32.tar.gz>
   * Linux 64 bit:  <https://www.pjrc.com/teensy/teensy_linux64.tar.gz>
3. Connect the Teensy to your computer via USB.
   * *Be sure to use a USB Micro B cable that is rated for data transmission. Many Micro B cables are only capable of charging. If you are having connectivity issues with your Teensy, try purchasing a data-rated cable such as* [*this one*](https://www.amazon.com/gp/product/B0711PVX6Z)*.*
4. Open the Teensy Loader application.
5. From the "File" menu, choose "Open HEX File" and select the .hex file.
6. Press the white button on the Teensy next to the SD card slot. A red light should turn on.
7. From the "File" menu, choose "Program." Wait for the progress bar to complete.

## 2) Teensy -> Audio Adapter

Connect the Teensy to the Teensy Audio Adapter. The Teensy stacks directly on top of the Audio Adapter. The two must be soldered. Reference the [Teensy page](https://www.pjrc.com/store/teensy41.html) for pin information.

<figure><img src="/files/vURYaAY1AIF7kCnAqaNk" alt=""><figcaption></figcaption></figure>

## 3) Command System -> Teensy

Connect your command system of choice to the Teensy via Serial or I2C. Reference the [Teensy page](https://www.pjrc.com/store/teensy41.html) for pin information.

If necessary, edit [Config.txt](https://docs.humancyborgrelations.com/r2d2/platforms/embedded/pages/rfg5HhTVqZyCh4eP5KJQ#api.txt) to support your particular command system.

## 4) Teensy Audio Out -> Amplifier

Connect the Audio Adapter's line-level outut pins to your amplifier. Reference the [Audio Adapter page](https://www.pjrc.com/store/teensy3_audio.html) for pin information.

## 5) Amplifier -> Speakers

Connect your amplifier to your speakers. Follow the instructions for your particular hardware.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.humancyborgrelations.com/r2d2/platforms/embedded/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.