Deployment tutorial¶

Setting up your laptop¶

Titan-Processing¶

Boot into Linux, and download Titan-Processing if you haven’t already.

mkdir -p ~/Projects; cd ~/Projects
git clone https://github.com/titan2022/Titan-Processing
cd Titan-Processing

If you already downloaded Titan-Processing, make sure to switch to the wpimath branch and pull the changes.

git fetch
git checkout wpimath
git pull

In scripts/host-orangepi/credentials.sh put the credentials for the Orange Pi you’re deploying to in the file. Ignore the IP address for now. (If you’re on FRC#2022, ping @ethanc8 for the credentials.)

SSH, sshpass¶

On Debian, Ubuntu and Debian derivatives, these can be installed with:

sudo apt install openssh-client sshpass

On openSUSE and openSUSE derivatives, these can be installed with:

sudo zypper in openssh-clients sshpass

Angry IP Scanner¶

Download Angry IP Scanner.

Wiring and networking¶

There are two options:

Network sharing (tethering) - if you need to do first-time setup or update the packages on the Orange Pi
Robot network - when the Orange Pi is already on the robot, and you don’t need to do first-time setup or update packages

Robot network¶

Connect to the radio via Ethernet or WiFi (do not connect directly to the Orange Pi or to the roboRIO).

Use Angry IP Scanner (or another tool like nmap) to scan the address range 10.TE.AM.0 to 10.TE.AM.255 (for FRC#2022 this is 10.20.22.0 to 10.20.22.255). Find the Orange Pi in the list of devices in the range (its hostname should show up in another column; usually its IP is 10.20.22.200-10.20.22.210 but it can vary).

Next steps¶

Put the IP address you find into scripts/host-orangepi/credentials.sh.
SSH into the Orange Pi: (use the correct username and hostname)
```
ssh [email protected]
```
Make sure to accept the Orange Pi’s key fingerprint.
Ensure that you can use the Titan-Processing scripts to SSH:
```
scripts/host-orangepi/ssh.sh
```

First-time setup¶

You can skip this step if the Orange Pi was already set up with an older version of Titan-Processing.

Create an empty repo on the Orange Pi:
```
scripts/host-orangepi/create-remote-repo.sh
```
Alternately, you can clone Titan-Processing into ~/Projects/Titan-Processing.
Set up pushes to the Orange Pi:
```
scripts/host-orangepi/set-up-push.sh
```
Push the code to the Orange Pi:
```
scripts/host-orangepi/push.sh
```

Install the dependencies on the Orange Pi:

scripts/host-orangepi/rebuild-environment.sh

Continue into normal usage.

Normal usage¶

If this is the first time you connect to this Orange Pi from this laptop, set up pushes:
```
scripts/host-orangepi/set-up-push.sh
```
If this isn’t the first time, but the IP address of the Pi has changed since the last time you pushed, reset the IP address:
```
scripts/host-orangepi/reset-push-ip.sh
```
Otherwise, you should be ready for the next step.
Push the code to the Orange Pi and build it:
```
scripts/host-orangepi/push-build.sh
```
If you’ve already built the code and haven’t cleaned it, you can just build the changes instead of rebuilding the whole thing:
```
scripts/host-orangepi/push-fastbuild.sh
```
Note that this sometimes results in issues.

Updating the dependencies¶

Sometimes you might add more dependencies. In that case, you can add those dependencies to the Orange Pi using

scripts/host-orangepi/update-environment.sh

Sometimes the environment might get into an inconsistent state or use really outdated packages. In that case you can rebuild it using

scripts/host-orangepi/rebuild-environment.sh

Autostarting¶

Enable autostart and reboot:

scripts/host-orangepi/autostart.sh
scripts/host-orangepi/reboot.sh

Disable autostart and reboot:

scripts/host-orangepi/no-autostart.sh
scripts/host-orangepi/reboot.sh