> **RAE Deprecated**
> RAE is now deprecated. You can still use the device in local mode, but we don't actively support it anymore.

# Get Started with RAE

RAE (short for “Robotics Access for Everyone”) is a small desktop robot developed for evaluation of the Luxonis ecosystem and
rapid prototyping of robotics applications. It is designed to be a low-cost, easy-to-use, and extensible platform.

It’s built on top of the RVC3, which along with AI, CV, video encoding, and stereo depth features, also supports on-chip VIO and
Sparse SLAM. rae is running ROS2 which handles path planning and navigation.

This section is created as a guide for first-time users of [RAE](https://shop.luxonis.com/collections/early-access/products/rae).

## Connect to RAE

Now you have to switch RAEs internal WiFi for your local network.

You can do this in two ways:

a) WiFi

 * RAE will create a WiFi access point with the following credentials:

```text
SSID: RAE-<ID>
Password: wifiwifi@
RAEs IP: 192.168.11.1
```

 * Open the WiFi settings on the device you are currently using and log into the AP with the provided credentials

 * You use SSH to directly access everything except the system which is write protected

 * Follow this [guide](https://www.linuxfordevices.com/tutorials/ubuntu/connect-wifi-terminal-command-line) on how to connect a
   linux system to wifi via the command line

b) USB-C

 * Plug RAE to your computer with the provided USB-C cable

 * Open your command line and connect to RAE through SSH with the provided credentials

```text
root@192.168.197.55 (no password is required)
RAEs IP: 192.168.197.55
```

 * You can use SSH to directly access everything except the system which is write protected

## Connect RAE to WiFi

Now that you are successfully connected to RAE it is time to make RAE connect to the local network.

 * Run the following command in your terminal to generate a passphrase for your network
 * When prompted enter your WiFi password

```bash
wpa_passphrase <WIFI_SSID>
```

 * The output should look similar to this:

```bash
network={
  ssid="<WIFI_SSID>"
  #psk="<WIFI_PASSWORD>"
  psk=<PASSPHRASE>
}
```

 * Edit the content of /etc/wpa_supplicant.conf so that its credentials match your WiFi settings

```bash
ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=root
network={
    ssid="<WIFI_SSID>"
    psk=<PASSPHRASE>
}
```

 * It is also necessary to edit /etc/systemd/network/20-wifi.network so it contains the correct information

```bash
[Match]
Name=wlp1s0

[Network]
DHCP=ipv4

[DHCP]
UseDomains=true
```

## Reboot RAE

After editing all the settings it is time to apply them and reboot RAE

 * Run the following commands on RAE

```bash
systemctl stop hostapd
wpa_supplicant -B -i wlp1s0 -c /etc/wpa_supplicant.conf
systemctl restart systemd-networkd
```

 * If the connection to Luxonis Hub won't be necessary it is also recommended to disable Agent

```bash
robothub-ctl stop
robothub-ctl startup disable
```

## Finishing up

Now your RAE is successfully setup.

> If you want to later reset RAE to its factory settings. This can be done by pressing a button at the bottom of RAE with a
needle.

RAE also has a local website for direct control. To access to it:

 * Find the IP address of RAE, this can be done for example with
   [WiFiman](https://play.google.com/store/apps/details?id=com.ubnt.usurvey&pli=1)

 * Copy and paste the https://<IP of RAE>:9010 into your preferred browser

 * Click on Control

## Next steps

For more information on how to develop with the robot you can check out the
[Develop](https://docs.luxonis.com/hardware/rae/rae-sdk.md) section.